Not everyone builds AI agents with a visual editor. Some developers prefer code—their IDE, their version control, their CI pipeline. For them, we built the AACFlow TypeScript SDK.
The visual editor is brilliant for exploration, prototyping, and collaboration. But production-grade agent deployment often demands programmatic control: define workflows as code, version them in Git, trigger them from CI/CD, embed them into existing Node.js applications. The SDK makes this possible.
What the SDK Does
The AACFlow TypeScript SDK is an npm package that lets you:
- Define workflows programmatically — blocks, connections, configurations, everything you can do in the visual editor, expressed in TypeScript
- Trigger executions — run workflows with input data and get results back
- Handle results — stream execution events, collect outputs, handle errors
- Manage workflows — list, get, update, delete workflows in your workspace via API
It's built on top of our public REST API with full type safety. Every input and output is validated with Zod schemas. Autocomplete in your IDE. Compile-time errors instead of runtime surprises.
1
import { AACFlow } from '@aacflow/ts-sdk'
2
3
const aacflow = new AACFlow({
4
apiKey: process.env.AACFLOW_API_KEY,
5
workspaceId: process.env.AACFLOW_WORKSPACE_ID,
6
})
7
8
// Define a workflow9
const workflow = await aacflow.workflows.create({
10
name: 'Lead Qualification Pipeline',
11
blocks: [
12
{13
id: 'webhook_input',
14
type: 'input.webhook',
15
position: { x: 100, y: 100 },
16
config: {
17
triggerId: 'amocrm_new_lead',
18
},
19
},
20
{21
id: 'enrich_lead',
22
type: 'connector.dadata',
23
position: { x: 300, y: 100 },
24
config: {
25
query: '{{webhook_input.leadName}}',
26
},
27
},
28
{29
id: 'score_lead',
30
type: 'llm.chat',
31
position: { x: 500, y: 100 },
32
config: {
33
model: 'gpt-4o',
34
systemPrompt: 'You are a lead scoring specialist...',
35
userPrompt: 'Score this lead: {{enrich_lead.company}}...',
36
},
37
},
38
{39
id: 'route_lead',
40
type: 'logic.condition',
41
position: { x: 700, y: 100 },
42
config: {
43
condition: '{{score_lead.score}} > 80',
44
trueBranch: 'send_to_sales',
45
falseBranch: 'send_to_nurture',
46
},
47
},
48
],
49
connections: [
50
{ source: 'webhook_input', target: 'enrich_lead' },
51
{ source: 'enrich_lead', target: 'score_lead' },
52
{ source: 'score_lead', target: 'route_lead' },
53
],
54
})
55
56
// Trigger an execution57
const execution = await aacflow.executions.run({
58
workflowId: workflow.id,
59
input: {
60
leadName: 'Иванов Иван',
61
leadPhone: '+7 (999) 123-45-67',
62
leadSource: 'website_form',
63
},
64
})
65
66
// Stream results in real-time67
for await (const event of execution.stream()) {
68
console.log(`[${event.blockId}] ${event.type}: ${event.status}`)
69
}70
71
// Get final result72
const result = await execution.result()
73
console.log('Lead score:', result.outputs.score_lead.score)
74
console.log('Route:', result.outputs.route_lead.branch)
