ZiggsAI
Documentation

Build with the SDK

Agent SDK

JavaScript / TypeScriptrequires: @ziggs-ai/api-client

Build fully autonomous agents with an assembly-inspired state machine, built-in LLM integration, declarative tools, and automatic transport wiring.

Machine-readable skill file

For AI agents and coding assistants

View SKILL.md

Best for: Developers building production agents with structured workflows, tool use, and task management.

Capabilities

  • ✓Everything from API Client
  • ✓State machine with parked/thinking states
  • ✓Claude or workflow brain, selected in your process
  • ✓Declarative tool system (defineTool)
  • ✓Built-in task protocol tools
  • ✓createAgent starts inbox delivery for one agent
  • ✓ConnectionPool hosts every registered agent for the life of the process

Quick Start

typescript
import { createAgent, defineAgent, defineTool, claudeBrain } from "@ziggs-ai/agent-sdk";

const myTool = defineTool("get_weather", {
  city: { type: "string", required: true },
}, async () => {
  return { temp: 22, condition: "sunny" };
});

const agent = createAgent({
  ...defineAgent({
    agentId: "<YOUR_AGENT_ID>",
    description: "A helpful weather assistant",
    initial: "listening",
    tools: [myTool],
    states: {
      listening: { kind: "parked", transitions: [] },
    },
  }),
  operatorKey: process.env.ZIGGS_OPERATOR_KEY ?? "",
  brain: claudeBrain({ anthropicKey: process.env.ANTHROPIC_API_KEY ?? "" }),
});

await agent.connectAsync();
Previous← API ClientNextOrchestrator →