Synstack

A collection of packages for fast iterations on LLM scripts, workflows, and applications. Synstack provides strongly-typed, chainable, and immutable APIs for common operations needed when building AI/LLM integrations.

Want an example?

Check out the reforge folder to see how we use synstack to build itself.

Quick Start

# Install the all-in-one package (recommended)
npm install @synstack/synscript
# or
yarn add @synstack/synscript
# or
pnpm add @synstack/synscript

Packages

Bundle Package (Recommended)

• @synstack/synscript - The all-in-one package that includes bundled exports from all other packages. Provides a complete stack for AI scripting and workflow automation.

Core Packages

AI/LLM Operations

• @synstack/llm - Immutable, chainable, and type-safe wrapper of Vercel's AI SDK
  • Template-based message builders for different roles (system, user, assistant)
  • Support for text, images, and file handling in messages
  • Automatic MIME type detection and file processing

File System Operations

• @synstack/fs - Strongly-typed, chainable file system operations

  • Support for multiple formats (JSON, YAML, XML)
  • Advanced path manipulation
  • Type-safe file operations with schema validation
  • Directory operations and file finding utilities

• @synstack/fs-cache - Human-friendly file system caching

  • Cache expensive function results between program runs
  • Type-safe disk caching with clean file system management
  • Readable cache entries

• @synstack/git - Git utilities for AI prompting and automation

  • List git-tracked files
  • View specific commit changes
  • Integration with fs package

System Utilities

• @synstack/enhance - Proxy-based utilities to enhance objects and functions

• @synstack/glob - Type-safe glob pattern matching and file filtering

  • File finding with exclusion support
  • Pattern matching and capturing
  • Reusable filters

• @synstack/path - Advanced path manipulation utilities

  • Type-safe path resolution
  • Path relationships and manipulation
  • Extension handling and MIME type detection

Content Processing

Web and Data Fetching

• @synstack/web - Web utilities for content processing
  • Fetch and validate JSON data with schema validation
  • Extract article content using Mozilla's Readability
  • Error handling for article extraction
  • Plain text content retrieval

Data Formats

• @synstack/json - Type-safe JSON operations with schema validation

  • Serialization with pretty printing
  • Type-safe deserialization
  • Zod schema validation

• @synstack/yaml - Type-safe YAML processing

• @synstack/xml - Non-ISO XML parser with text preservation

  • Handles invalid XML gracefully
  • Preserves original text structure
  • Simple node-based API

• @synstack/markdown - Type-safe markdown processing

  • HTML to markdown conversion
  • YAML frontmatter handling
  • Type-safe document management

Text Processing

• @synstack/text - Advanced string templating with async support
  • Parallel resolution of promises and arrays
  • Automatic indentation preservation and formatting
  • Support for callable values and non-string objects
  • Type-safe handling of embedded content blocks
• @synstack/str - Advanced chainable string manipulation

Functional Programming

• @synstack/pipe - Simple type-safe pipe utility
• @synstack/resolved - Piping utility preserving sync/async state

Dependency Graph

graph TD
  %% Packages
  synscript["@synstack/synscript"]
  enhance["@synstack/enhance"]
  fs["@synstack/fs"]
  fs_cache["@synstack/fs-cache"]
  git["@synstack/git"]
  glob["@synstack/glob"]
  json["@synstack/json"]
  llm["@synstack/llm"]
  markdown["@synstack/markdown"]
  path["@synstack/path"]
  pipe["@synstack/pipe"]
  reforge["@synstack/reforge"]
  resolved["@synstack/resolved"]
  str["@synstack/str"]
  text["@synstack/text"]
  web["@synstack/web"]
  xml["@synstack/xml"]
  yaml["@synstack/yaml"]

  %% Internal Dependencies
  synscript --> enhance
  synscript --> fs
  synscript --> fs_cache
  synscript --> git
  synscript --> glob
  synscript --> json
  synscript --> llm
  synscript --> markdown
  synscript --> path
  synscript --> pipe
  synscript --> reforge
  synscript --> resolved
  synscript --> str
  synscript --> text
  synscript --> web
  synscript --> xml
  synscript --> yaml

  fs --> enhance
  fs --> git
  fs --> glob
  fs --> json
  fs --> path
  fs --> pipe
  fs --> str
  fs --> xml
  fs --> yaml

  fs_cache --> fs
  git --> enhance
  glob --> path
  llm --> resolved
  llm --> text
  llm --> fs_cache
  markdown --> yaml
  path --> pipe
  pipe --> enhance
  str --> pipe
  text --> json
  text --> resolved
  text --> str
  reforge --> json

  %% External Dependencies
  web --> readability["@mozilla/readability"]
  web --> linkedom
  xml --> immer
  yaml --> yaml_pkg["yaml"]
  llm --> zod_json["zod-to-json-schema"]
  str --> change_case["change-case"]
  glob --> minimatch["minimatch"]
  glob --> glob_pkg["glob"]

  %% Styling
  classDef default fill:#f9f,stroke:#333,stroke-width:2px,color:#000;
  classDef external fill:#bbf,stroke:#333,stroke-width:1px,color:#000;
  class readability,linkedom,immer,yaml_pkg,zod_json,change_case,minimatch,glob_pkg external

Loading