@swirls/sdk 0.0.10 → 0.0.12

package/README.md

@@ -14,7 +14,7 @@ The [`@swirls/sdk/client`](src/client/README.md) subpackage provides a type-safe
 import { Swirls } from '@swirls/sdk/client'
 
 const swirls = new Swirls({ apiKey: process.env.SWIRLS_API_KEY! })
-const graphs = await swirls.graphs.listGraphs({ projectId })
+const graphs = await swirls.client.graphs.listGraphs({ input: { projectId } })
 // With React: useQuery(swirls.query.graphs.listGraphs.queryOptions({ input: { projectId } }))
 ```
 
@@ -34,6 +34,36 @@ The [`@swirls/sdk/form`](src/form/README.md) subpackage provides a form library
 import { useSwirlsFormAdapter } from '@swirls/sdk/form'
 ```
 
+### Graph Builder
+
+The [`@swirls/sdk/graph`](src/graph/README.md) subpackage lets you build and manipulate workflow graphs in code. Use a fluent API to add nodes and edges by name, then validate (DAG, single root), persist via the API with `save()`, or serialize with `toJSON()` for storage or version control. Dynamic values (e.g. LLM prompts, code transforms) use TypeScript function bodies with a `context` object; when you set `inputSchema` and `outputSchema` on nodes, `context.inputs` is typed for intellisense.
+
+```typescript
+import { Swirls } from '@swirls/sdk/client'
+import { GraphBuilder } from '@swirls/sdk/graph'
+
+const swirls = new Swirls({ apiKey: process.env.SWIRLS_API_KEY! })
+const graph = new GraphBuilder({ client: swirls.client })
+  .setName('my_workflow')
+  .setLabel('My Workflow')
+  .addNode('fetch', {
+    type: 'http',
+    label: 'Fetch',
+    config: { type: 'http', url: 'https://api.example.com/data', method: 'GET' },
+  })
+  .addNode('summarize', {
+    type: 'llm',
+    label: 'Summarize',
+    config: {
+      type: 'llm',
+      model: 'gpt-4o',
+      prompt: 'return `Summarize the following: ${context.inputs.fetch.output}`',
+    },
+  })
+  .addEdge({ source: 'fetch', target: 'summarize' })
+await graph.save({ projectId: '...' })
+```
+
 ## Installation
 
 ```sh
@@ -52,3 +82,4 @@ bun add @tanstack/react-query
 - [Client Documentation](src/client/README.md): API client and TanStack Query utils
 - [Config Documentation](src/config/README.md): Configuration reference
 - [Form Documentation](src/form/README.md): Complete guide to forms
+- [Graph Documentation](src/graph/README.md): Build and manipulate workflow graphs