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 these recommended packages:

1npm install @synstack/llm @synstack/fs @synstack/text @synstack/fs-cache @synstack/xml
2
3yarn add @synstack/llm @synstack/fs @synstack/text @synstack/fs-cache @synstack/xml
4
5pnpm add @synstack/llm @synstack/fs @synstack/text @synstack/fs-cache @synstack/xml

Packages

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

1graph TD
2  %% Packages
3  enhance["@synstack/enhance"]
4  fs["@synstack/fs"]
5  fs_cache["@synstack/fs-cache"]
6  git["@synstack/git"]
7  glob["@synstack/glob"]
8  json["@synstack/json"]
9  llm["@synstack/llm"]
10  markdown["@synstack/markdown"]
11  path["@synstack/path"]
12  pipe["@synstack/pipe"]
13  reforge["@synstack/reforge"]
14  resolved["@synstack/resolved"]
15  str["@synstack/str"]
16  text["@synstack/text"]
17  web["@synstack/web"]
18  xml["@synstack/xml"]
19  yaml["@synstack/yaml"]
20
21  fs --> enhance
22  fs --> git
23  fs --> glob
24  fs --> json
25  fs --> path
26  fs --> pipe
27  fs --> str
28  fs --> xml
29  fs --> yaml
30
31  fs_cache --> fs
32  git --> enhance
33  glob --> path
34  llm --> resolved
35  llm --> text
36  llm --> fs_cache
37  markdown --> yaml
38  path --> pipe
39  pipe --> enhance
40  str --> pipe
41  text --> json
42  text --> resolved
43  text --> str
44  reforge --> json
45
46  %% External Dependencies
47  web --> readability["@mozilla/readability"]
48  web --> linkedom
49  xml --> immer
50  yaml --> yaml_pkg["yaml"]
51  llm --> zod_json["zod-to-json-schema"]
52  str --> change_case["change-case"]
53  glob --> minimatch["minimatch"]
54  glob --> glob_pkg["glob"]
55
56  %% Styling
57  classDef default fill:#f9f,stroke:#333,stroke-width:2px,color:#000;
58  classDef external fill:#bbf,stroke:#333,stroke-width:1px,color:#000;
59  class readability,linkedom,immer,yaml_pkg,zod_json,change_case,minimatch,glob_pkg external