@researchcomputer/agents-sdk 0.1.0

package/README.md

@@ -0,0 +1,60 @@
+# @researchcomputer/agents-sdk
+
+A TypeScript SDK for building coding agents powered by large language models. Built on `@mariozechner/pi-agent-core`, it provides a high-level framework for creating agents with file operations, shell execution, web access, permission controls, memory, sessions, MCP servers, and multi-agent swarms.
+
+## Documentation
+
+| Document | Description |
+|---|---|
+| [Getting Started](./docs/getting-started.md) | Installation, quick start, and first agent |
+| [Concepts](./docs/concepts.md) | Core abstractions: tools, permissions, memory, context |
+| [API Reference](./docs/api-reference.md) | Full API: types, factory, all modules |
+| [Examples](./docs/examples.md) | Practical usage patterns and recipes |
+
+## Overview
+
+```
+@researchcomputer/agents-sdk
+├── Factory            createCodingAgent() — main entry point
+├── Tools              Built-in: Read, Write, Edit, Bash, Glob, Grep, WebFetch, ...
+├── Permissions        Capability-based access control with multiple modes
+├── Memory             Persistent, queryable per-agent memories
+├── Sessions           Snapshot-based conversation persistence
+├── MCP                Connect external tool servers via Model Context Protocol
+├── Swarm              Multi-agent coordination with mailbox messaging
+├── Middleware          Hooks, permission gates, and pipeline composition
+├── Context            Message conversion, system prompt construction, compression
+└── Observability      Token/cost tracking and trace IDs
+```
+
+## Quick Example
+
+```typescript
+import { createCodingAgent } from '@researchcomputer/agents-sdk';
+import { getModel } from '@mariozechner/pi-ai';
+
+const agent = await createCodingAgent({
+  model: getModel('openai', 'gpt-4o'),
+  cwd: process.cwd(),
+});
+
+await agent.prompt('List all TypeScript files and summarize what they do');
+await agent.dispose();
+```
+
+## Bridge Server
+
+The bridge server now lives inside the main package under [`src/bridge/`](./src/bridge) and builds with the rest of the SDK.
+
+Build and run it from the root package:
+
+```bash
+npm run build
+npm run bridge:start
+```
+
+Python example clients live under [`examples/bridge/`](./examples/bridge).
+
+## Example CLI
+
+A runnable Ink-based terminal UI example lives in [cli/README.md](./cli/README.md). It wraps `createCodingAgent()` in an interactive agent shell with a configurable cute agent name, slash commands, model pickers, live streaming, permission prompts, and support for arbitrary OpenAI-compatible endpoints.

package/dist/agents/messages.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A simple async queue for swarm agent communication (mailbox pattern).
+ */
+export declare class AsyncQueue<T> {
+    private items;
+    private waiters;
+    /**
+     * Add an item to the queue. If a waiter exists, resolve it immediately.
+     */
+    enqueue(item: T): void;
+    /**
+     * Non-blocking dequeue. Returns undefined if queue is empty.
+     */
+    tryDequeue(): T | undefined;
+    /**
+     * Async dequeue. Resolves when an item is available.
+     * Rejects if the queue is cleared while waiting.
+     */
+    dequeue(): Promise<T>;
+    /**
+     * Returns true if the queue has no items.
+     */
+    isEmpty(): boolean;
+    /**
+     * Clear all items and reject pending waiters.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/agents/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/agents/messages.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,OAAO,CAA2E;IAE1F;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAStB;;OAEG;IACH,UAAU,IAAI,CAAC,GAAG,SAAS;IAI3B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAUrB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}

package/dist/agents/messages.js

@@ -0,0 +1,56 @@
+/**
+ * A simple async queue for swarm agent communication (mailbox pattern).
+ */
+export class AsyncQueue {
+    items = [];
+    waiters = [];
+    /**
+     * Add an item to the queue. If a waiter exists, resolve it immediately.
+     */
+    enqueue(item) {
+        const waiter = this.waiters.shift();
+        if (waiter) {
+            waiter.resolve(item);
+        }
+        else {
+            this.items.push(item);
+        }
+    }
+    /**
+     * Non-blocking dequeue. Returns undefined if queue is empty.
+     */
+    tryDequeue() {
+        return this.items.shift();
+    }
+    /**
+     * Async dequeue. Resolves when an item is available.
+     * Rejects if the queue is cleared while waiting.
+     */
+    dequeue() {
+        const item = this.items.shift();
+        if (item !== undefined) {
+            return Promise.resolve(item);
+        }
+        return new Promise((resolve, reject) => {
+            this.waiters.push({ resolve, reject });
+        });
+    }
+    /**
+     * Returns true if the queue has no items.
+     */
+    isEmpty() {
+        return this.items.length === 0;
+    }
+    /**
+     * Clear all items and reject pending waiters.
+     */
+    clear() {
+        this.items = [];
+        const waiters = this.waiters;
+        this.waiters = [];
+        for (const waiter of waiters) {
+            waiter.reject(new Error('Queue cleared'));
+        }
+    }
+}
+//# sourceMappingURL=messages.js.map

package/dist/agents/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/agents/messages.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,UAAU;IACb,KAAK,GAAQ,EAAE,CAAC;IAChB,OAAO,GAAwE,EAAE,CAAC;IAE1F;;OAEG;IACH,OAAO,CAAC,IAAO;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;CACF"}

package/dist/agents/messages.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messages.test.d.ts.map

package/dist/agents/messages.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.test.d.ts","sourceRoot":"","sources":["../../src/agents/messages.test.ts"],"names":[],"mappings":""}

package/dist/agents/messages.test.js

@@ -0,0 +1,80 @@
+import { describe, it, expect } from 'vitest';
+import { AsyncQueue } from './messages.js';
+describe('AsyncQueue', () => {
+    it('enqueue and tryDequeue work synchronously', () => {
+        const q = new AsyncQueue();
+        q.enqueue(1);
+        q.enqueue(2);
+        expect(q.tryDequeue()).toBe(1);
+        expect(q.tryDequeue()).toBe(2);
+        expect(q.tryDequeue()).toBeUndefined();
+    });
+    it('tryDequeue returns undefined when empty', () => {
+        const q = new AsyncQueue();
+        expect(q.tryDequeue()).toBeUndefined();
+    });
+    it('dequeue resolves immediately if item available', async () => {
+        const q = new AsyncQueue();
+        q.enqueue('hello');
+        const result = await q.dequeue();
+        expect(result).toBe('hello');
+    });
+    it('dequeue waits for enqueue', async () => {
+        const q = new AsyncQueue();
+        // Start dequeue before any item is enqueued
+        const promise = q.dequeue();
+        // Enqueue after a microtask
+        setTimeout(() => q.enqueue(42), 10);
+        const result = await promise;
+        expect(result).toBe(42);
+    });
+    it('multiple waiters are resolved in order', async () => {
+        const q = new AsyncQueue();
+        const p1 = q.dequeue();
+        const p2 = q.dequeue();
+        q.enqueue(1);
+        q.enqueue(2);
+        expect(await p1).toBe(1);
+        expect(await p2).toBe(2);
+    });
+    it('enqueue resolves waiter immediately instead of queueing', async () => {
+        const q = new AsyncQueue();
+        const promise = q.dequeue();
+        q.enqueue('direct');
+        // The item should have gone directly to the waiter, not the queue
+        expect(q.isEmpty()).toBe(true);
+        expect(await promise).toBe('direct');
+    });
+    it('isEmpty returns true when empty', () => {
+        const q = new AsyncQueue();
+        expect(q.isEmpty()).toBe(true);
+    });
+    it('isEmpty returns false when items exist', () => {
+        const q = new AsyncQueue();
+        q.enqueue(1);
+        expect(q.isEmpty()).toBe(false);
+    });
+    it('clear removes all items', () => {
+        const q = new AsyncQueue();
+        q.enqueue(1);
+        q.enqueue(2);
+        q.enqueue(3);
+        q.clear();
+        expect(q.isEmpty()).toBe(true);
+        expect(q.tryDequeue()).toBeUndefined();
+    });
+    it('clear rejects pending waiters', async () => {
+        const q = new AsyncQueue();
+        // Create waiters that will be rejected on clear
+        const p1 = q.dequeue().catch((e) => e.message);
+        const p2 = q.dequeue().catch((e) => e.message);
+        q.clear();
+        // Pending waiters should be rejected
+        expect(await p1).toBe('Queue cleared');
+        expect(await p2).toBe('Queue cleared');
+        // After clear, new enqueue should go to the queue, not old waiters
+        q.enqueue(99);
+        expect(q.tryDequeue()).toBe(99);
+    });
+});
+//# sourceMappingURL=messages.test.js.map

package/dist/agents/messages.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.test.js","sourceRoot":"","sources":["../../src/agents/messages.test.ts"],"names":[],"mappings":"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"}

package/dist/agents/subagent.d.ts

@@ -0,0 +1,16 @@
+import type { AgentMessage } from '@mariozechner/pi-agent-core';
+import type { Message, Model } from '@mariozechner/pi-ai';
+import type { SdkTool } from '../types.js';
+export interface SubAgentConfig {
+    model: Model<any>;
+    systemPrompt?: string;
+    tools?: SdkTool<any, any>[];
+    convertToLlm?: (messages: AgentMessage[]) => Message[] | Promise<Message[]>;
+    getApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;
+}
+/**
+ * Runs a sub-agent with the given prompt, waits for it to finish,
+ * and extracts the last assistant text response.
+ */
+export declare function runSubAgent(prompt: string, config: SubAgentConfig): Promise<string>;
+//# sourceMappingURL=subagent.d.ts.map

package/dist/agents/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../src/agents/subagent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;CACpF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAoCzF"}

package/dist/agents/subagent.js

@@ -0,0 +1,46 @@
+import { Agent } from '@mariozechner/pi-agent-core';
+/**
+ * Runs a sub-agent with the given prompt, waits for it to finish,
+ * and extracts the last assistant text response.
+ */
+export async function runSubAgent(prompt, config) {
+    const agent = new Agent({
+        initialState: {
+            systemPrompt: config.systemPrompt ?? 'You are a helpful assistant.',
+            model: config.model,
+            tools: config.tools ?? [],
+            thinkingLevel: 'off',
+        },
+        convertToLlm: config.convertToLlm ?? defaultConvertToLlm,
+        getApiKey: config.getApiKey,
+        toolExecution: 'parallel',
+    });
+    await agent.prompt(prompt);
+    await agent.waitForIdle();
+    // Extract last assistant text response
+    const messages = agent.state.messages;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role === 'assistant') {
+            if (typeof msg.content === 'string') {
+                return msg.content;
+            }
+            if (Array.isArray(msg.content)) {
+                const texts = msg.content
+                    .filter((c) => c.type === 'text')
+                    .map((c) => c.text);
+                if (texts.length > 0) {
+                    return texts.join('\n');
+                }
+            }
+        }
+    }
+    return '';
+}
+function defaultConvertToLlm(messages) {
+    return messages.filter((m) => {
+        const role = m.role;
+        return role === 'user' || role === 'assistant' || role === 'toolResult';
+    });
+}
+//# sourceMappingURL=subagent.js.map

package/dist/agents/subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../../src/agents/subagent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAapD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,MAAsB;IACtE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,YAAY,EAAE;YACZ,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,8BAA8B;YACnE,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;YACzB,aAAa,EAAE,KAAsB;SACtC;QACD,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,mBAAmB;QACxD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,aAAa,EAAE,UAAU;KAC1B,CAAC,CAAC;IAEH,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;IAE1B,uCAAuC;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;IACtC,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAuC,CAAC;QAC9D,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7B,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,GAAG,CAAC,OAAO,CAAC;YACrB,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO;qBACtB,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;qBACrC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAwB;IACnD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAI,CAAsB,CAAC,IAAI,CAAC;QAC1C,OAAO,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,YAAY,CAAC;IAC1E,CAAC,CAAc,CAAC;AAClB,CAAC"}

package/dist/agents/swarm.d.ts

@@ -0,0 +1,22 @@
+import { Agent } from '@mariozechner/pi-agent-core';
+import type { AgentMessage } from '@mariozechner/pi-agent-core';
+import type { Model } from '@mariozechner/pi-ai';
+import type { SdkTool, SwarmManager } from '../types.js';
+export interface SwarmManagerDefaults {
+    model: Model<any>;
+    tools?: SdkTool<any, any>[];
+    convertToLlm: (messages: AgentMessage[]) => import('@mariozechner/pi-ai').Message[] | Promise<import('@mariozechner/pi-ai').Message[]>;
+    getApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;
+    beforeToolCall?: ConstructorParameters<typeof Agent>[0] extends infer O ? O extends {
+        beforeToolCall?: infer B;
+    } ? B : never : never;
+    afterToolCall?: ConstructorParameters<typeof Agent>[0] extends infer O ? O extends {
+        afterToolCall?: infer A;
+    } ? A : never : never;
+    transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;
+}
+/**
+ * Creates a SwarmManager for coordinating teams of agents.
+ */
+export declare function createSwarmManager(defaults: SwarmManagerDefaults): SwarmManager;
+//# sourceMappingURL=swarm.d.ts.map

package/dist/agents/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/agents/swarm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EAKb,MAAM,aAAa,CAAC;AAkBrB,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAC5B,YAAY,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,qBAAqB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,qBAAqB,EAAE,OAAO,EAAE,CAAC,CAAC;IACvI,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;IACnF,cAAc,CAAC,EAAE,qBAAqB,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,SAAS;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC;IACrI,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,SAAS;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC;IACnI,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAChG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,YAAY,CAoK/E"}

package/dist/agents/swarm.js

@@ -0,0 +1,140 @@
+import { Agent } from '@mariozechner/pi-agent-core';
+import { SdkError } from '../errors.js';
+import { AsyncQueue } from './messages.js';
+/**
+ * Creates a SwarmManager for coordinating teams of agents.
+ */
+export function createSwarmManager(defaults) {
+    const teams = new Map();
+    function createInternalAgent(systemPrompt, model, tools, abortSignal) {
+        const agentModel = model ?? defaults.model;
+        const agentTools = tools ?? defaults.tools ?? [];
+        const agent = new Agent({
+            initialState: {
+                systemPrompt,
+                model: agentModel,
+                tools: agentTools,
+                thinkingLevel: 'off',
+            },
+            convertToLlm: defaults.convertToLlm,
+            beforeToolCall: defaults.beforeToolCall,
+            afterToolCall: defaults.afterToolCall,
+            transformContext: defaults.transformContext,
+            getApiKey: defaults.getApiKey,
+            toolExecution: 'parallel',
+        });
+        return agent;
+    }
+    return {
+        createTeam(config) {
+            const abortController = new AbortController();
+            const leaderSystemPrompt = config.leaderSystemPrompt ?? 'You are a team leader coordinating tasks.';
+            const agent = createInternalAgent(leaderSystemPrompt, config.model);
+            const leader = {
+                name: 'leader',
+                taskId: `team-${config.name}-leader`,
+                status: 'idle',
+                budget: { maxTurns: Infinity },
+                agent,
+                mailbox: new AsyncQueue(),
+                abortController,
+            };
+            const team = {
+                name: config.name,
+                leader,
+                teammates: new Map(),
+            };
+            teams.set(config.name, team);
+            return team;
+        },
+        async spawnTeammate(teamName, config) {
+            const team = teams.get(teamName);
+            if (!team) {
+                throw new SdkError(`Team not found: ${teamName}`, 'TEAM_NOT_FOUND', false);
+            }
+            const abortController = new AbortController();
+            const systemPrompt = config.systemPrompt ?? 'You are a team member working on assigned tasks.';
+            const agent = createInternalAgent(systemPrompt, config.model, config.tools);
+            // Budget enforcement: if timeoutMs is set, use AbortSignal.timeout
+            if (config.budget.timeoutMs) {
+                const timeoutSignal = AbortSignal.timeout(config.budget.timeoutMs);
+                timeoutSignal.addEventListener('abort', () => {
+                    abortController.abort();
+                    agent.abort();
+                });
+            }
+            const teammate = {
+                name: config.name,
+                taskId: config.taskId,
+                status: 'running',
+                budget: config.budget,
+                agent,
+                mailbox: new AsyncQueue(),
+                abortController,
+            };
+            team.teammates.set(config.name, teammate);
+            // Start agent.prompt non-blocking
+            agent.prompt(config.prompt).then(() => {
+                teammate.status = 'idle';
+                teammate.terminationReason = 'taskComplete';
+            }, (err) => {
+                teammate.status = 'stopped';
+                if (err instanceof Error && (err.name === 'AbortError' || err.message.includes('aborted'))) {
+                    teammate.terminationReason = 'budgetExhausted';
+                }
+                else {
+                    teammate.terminationReason = 'error';
+                    teammate.error = err instanceof Error ? err.message : String(err);
+                }
+            });
+            return teammate;
+        },
+        sendMessage(from, to, message) {
+            // Search across all teams for the recipient
+            for (const team of teams.values()) {
+                if (team.leader.name === to) {
+                    team.leader.agent.followUp(message);
+                    return;
+                }
+                const teammate = team.teammates.get(to);
+                if (teammate) {
+                    teammate.agent.followUp(message);
+                    return;
+                }
+            }
+            throw new SdkError(`Teammate not found: ${to}`, 'TEAMMATE_NOT_FOUND', false);
+        },
+        async removeTeammate(teamName, name) {
+            const team = teams.get(teamName);
+            if (!team)
+                return;
+            const teammate = team.teammates.get(name);
+            if (!teammate)
+                return;
+            teammate.abortController.abort();
+            teammate.agent.abort();
+            teammate.status = 'stopped';
+            teammate.mailbox.clear();
+            team.teammates.delete(name);
+        },
+        async destroyTeam(teamName) {
+            const team = teams.get(teamName);
+            if (!team)
+                return;
+            // Remove all teammates
+            for (const name of Array.from(team.teammates.keys())) {
+                await this.removeTeammate(teamName, name);
+            }
+            // Abort leader
+            team.leader.abortController.abort();
+            team.leader.agent.abort();
+            team.leader.status = 'stopped';
+            team.leader.mailbox.clear();
+            teams.delete(teamName);
+        },
+        getTeam(name) {
+            return teams.get(name);
+        },
+    };
+}
+//# sourceMappingURL=swarm.js.map

package/dist/agents/swarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../../src/agents/swarm.ts"],"names":[],"mappings":"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"}

package/dist/agents/tools.d.ts

@@ -0,0 +1,6 @@
+import type { SdkTool, SwarmManager } from '../types.js';
+/**
+ * Creates swarm management tools for a team leader.
+ */
+export declare function createSwarmTools(teamName: string, swarm: SwarmManager): SdkTool<any, any>[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/agents/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAmE3F"}

package/dist/agents/tools.js

@@ -0,0 +1,71 @@
+import { Type } from '@sinclair/typebox';
+import { randomUUID } from 'node:crypto';
+/**
+ * Creates swarm management tools for a team leader.
+ */
+export function createSwarmTools(teamName, swarm) {
+    const spawnTool = {
+        name: 'SpawnTeammate',
+        label: 'Spawn Teammate',
+        description: 'Spawn a new teammate agent to work on a task',
+        parameters: Type.Object({
+            name: Type.String({ description: 'Name for the teammate' }),
+            prompt: Type.String({ description: 'Task prompt for the teammate' }),
+            systemPrompt: Type.Optional(Type.String({ description: 'Optional system prompt override' })),
+        }),
+        capabilities: [],
+        async execute(_toolCallId, params) {
+            const teammate = await swarm.spawnTeammate(teamName, {
+                name: params.name,
+                prompt: params.prompt,
+                taskId: randomUUID(),
+                budget: { maxTurns: 20 },
+                systemPrompt: params.systemPrompt,
+            });
+            return {
+                content: [{ type: 'text', text: `Spawned teammate "${teammate.name}" (task: ${teammate.taskId})` }],
+                details: { name: teammate.name, taskId: teammate.taskId },
+            };
+        },
+    };
+    const sendTool = {
+        name: 'SendMessage',
+        label: 'Send Message',
+        description: 'Send a message to a teammate',
+        parameters: Type.Object({
+            to: Type.String({ description: 'Name of the recipient teammate' }),
+            message: Type.String({ description: 'Message content to send' }),
+        }),
+        capabilities: [],
+        async execute(_toolCallId, params) {
+            const agentMessage = {
+                role: 'user',
+                content: params.message,
+                timestamp: Date.now(),
+            };
+            swarm.sendMessage(teamName, params.to, agentMessage);
+            return {
+                content: [{ type: 'text', text: `Message sent to "${params.to}"` }],
+                details: { to: params.to },
+            };
+        },
+    };
+    const dismissTool = {
+        name: 'DismissTeammate',
+        label: 'Dismiss Teammate',
+        description: 'Remove a teammate from the team',
+        parameters: Type.Object({
+            name: Type.String({ description: 'Name of the teammate to dismiss' }),
+        }),
+        capabilities: [],
+        async execute(_toolCallId, params) {
+            await swarm.removeTeammate(teamName, params.name);
+            return {
+                content: [{ type: 'text', text: `Dismissed teammate "${params.name}"` }],
+                details: { name: params.name },
+            };
+        },
+    };
+    return [spawnTool, sendTool, dismissTool];
+}
+//# sourceMappingURL=tools.js.map

package/dist/agents/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"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"}

package/dist/agents/tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.test.d.ts.map

package/dist/agents/tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.test.d.ts","sourceRoot":"","sources":["../../src/agents/tools.test.ts"],"names":[],"mappings":""}