Swirls Language

Comprehensive guide for authoring .swirls workflow files. Covers the full DSL: file structure, graph declarations, all 13 node types, TypeScript / JSON / SQL embedded blocks, the context object, resources, triggers, top-level stream blocks, reviews, failure policies, and known parser pitfalls.

When to Apply

• Writing new .swirls files from scratch.
• Adding nodes, graphs, streams, or triggers to existing .swirls files.
• Debugging parse errors or validation failures from swirls doctor.
• Writing @ts blocks (TypeScript code in nodes).
• Defining JSON Schemas for inputs, outputs, forms, and webhooks.
• Connecting graphs to forms, webhooks, or schedules via triggers.
• Persisting graph output with top-level stream { } blocks and reading it with type: stream nodes.
• Configuring human-in-the-loop review blocks.
• Declaring external Postgres databases and writing parameterized SQL nodes.

Priority