@researchcomputer/agents-sdk 0.1.0

package/dist/observability/cost-tracker.js

@@ -0,0 +1,26 @@
+export function createCostTracker() {
+    let totalTokens = 0;
+    let totalCost = 0;
+    const models = new Map();
+    return {
+        record(usage, modelId) {
+            totalTokens += usage.totalTokens;
+            totalCost += usage.cost.total;
+            if (modelId) {
+                const existing = models.get(modelId) ?? { tokens: 0, cost: 0 };
+                existing.tokens += usage.totalTokens;
+                existing.cost += usage.cost.total;
+                models.set(modelId, existing);
+            }
+        },
+        total() { return { tokens: totalTokens, cost: totalCost }; },
+        perModel() {
+            const copy = new Map();
+            for (const [key, value] of models) {
+                copy.set(key, { ...value });
+            }
+            return copy;
+        },
+    };
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/observability/cost-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.js","sourceRoot":"","sources":["../../src/observability/cost-tracker.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,iBAAiB;IAC/B,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4C,CAAC;IACnE,OAAO;QACL,MAAM,CAAC,KAAY,EAAE,OAAgB;YACnC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC;YACjC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YAC9B,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC/D,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC;gBACrC,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;gBAClC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,KAAK,KAAK,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC5D,QAAQ;YACN,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4C,CAAC;YACjE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;gBAClC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/observability/cost-tracker.test.d.ts

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

package/dist/observability/cost-tracker.test.d.ts.map

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

package/dist/observability/cost-tracker.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect } from 'vitest';
+import { createCostTracker } from './cost-tracker.js';
+function makeUsage(totalTokens, totalCost) {
+    return {
+        input: totalTokens * 0.5,
+        output: totalTokens * 0.5,
+        cacheRead: 0,
+        cacheWrite: 0,
+        totalTokens,
+        cost: { input: totalCost * 0.5, output: totalCost * 0.5, cacheRead: 0, cacheWrite: 0, total: totalCost },
+    };
+}
+describe('createCostTracker', () => {
+    it('starts with zero totals', () => {
+        const tracker = createCostTracker();
+        expect(tracker.total()).toEqual({ tokens: 0, cost: 0 });
+    });
+    it('records usage and accumulates totals', () => {
+        const tracker = createCostTracker();
+        tracker.record(makeUsage(100, 0.01));
+        tracker.record(makeUsage(200, 0.02));
+        expect(tracker.total()).toEqual({ tokens: 300, cost: 0.03 });
+    });
+    it('tracks per-model usage when modelId is provided', () => {
+        const tracker = createCostTracker();
+        tracker.record(makeUsage(100, 0.01), 'gpt-4');
+        tracker.record(makeUsage(50, 0.005), 'gpt-4');
+        tracker.record(makeUsage(200, 0.02), 'claude-3');
+        const perModel = tracker.perModel();
+        expect(perModel.get('gpt-4')).toEqual({ tokens: 150, cost: 0.015 });
+        expect(perModel.get('claude-3')).toEqual({ tokens: 200, cost: 0.02 });
+    });
+    it('does not track model when modelId is omitted', () => {
+        const tracker = createCostTracker();
+        tracker.record(makeUsage(100, 0.01));
+        expect(tracker.perModel().size).toBe(0);
+        expect(tracker.total().tokens).toBe(100);
+    });
+    it('perModel returns a copy', () => {
+        const tracker = createCostTracker();
+        tracker.record(makeUsage(100, 0.01), 'gpt-4');
+        const map1 = tracker.perModel();
+        tracker.record(makeUsage(50, 0.005), 'gpt-4');
+        const map2 = tracker.perModel();
+        expect(map1.get('gpt-4').tokens).toBe(100);
+        expect(map2.get('gpt-4').tokens).toBe(150);
+    });
+});
+//# sourceMappingURL=cost-tracker.test.js.map

package/dist/observability/cost-tracker.test.js.map

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

package/dist/observability/trace.d.ts

@@ -0,0 +1,2 @@
+export declare function generateTraceId(): string;
+//# sourceMappingURL=trace.d.ts.map

package/dist/observability/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/observability/trace.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/observability/trace.js

@@ -0,0 +1,5 @@
+import { randomUUID } from 'node:crypto';
+export function generateTraceId() {
+    return randomUUID();
+}
+//# sourceMappingURL=trace.js.map

package/dist/observability/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/observability/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC"}

package/dist/session/session.d.ts

@@ -0,0 +1,3 @@
+import type { SessionManager } from '../types.js';
+export declare function createSessionManager(dir: string): SessionManager;
+//# sourceMappingURL=session.d.ts.map

package/dist/session/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAGnE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CA0DhE"}

package/dist/session/session.js

@@ -0,0 +1,62 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { SessionLoadError } from '../errors.js';
+export function createSessionManager(dir) {
+    return {
+        async save(snapshot) {
+            await fs.mkdir(dir, { recursive: true });
+            const safeId = snapshot.id.replace(/[^a-zA-Z0-9_-]/g, '_');
+            const filePath = path.join(dir, `${safeId}.json`);
+            await fs.writeFile(filePath, JSON.stringify(snapshot, null, 2), 'utf-8');
+        },
+        async load(id) {
+            const safeId = id.replace(/[^a-zA-Z0-9_-]/g, '_');
+            const filePath = path.join(dir, `${safeId}.json`);
+            let content;
+            try {
+                content = await fs.readFile(filePath, 'utf-8');
+            }
+            catch (err) {
+                if (err.code === 'ENOENT')
+                    return null;
+                throw err;
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(content);
+            }
+            catch {
+                throw new SessionLoadError(`Corrupt session file: ${id}.json`);
+            }
+            if (parsed.version !== 1) {
+                throw new SessionLoadError(`Unsupported session version: ${parsed.version}`);
+            }
+            return parsed;
+        },
+        async list() {
+            let entries;
+            try {
+                entries = await fs.readdir(dir);
+            }
+            catch {
+                return [];
+            }
+            const sessions = [];
+            for (const entry of entries) {
+                if (!entry.endsWith('.json'))
+                    continue;
+                try {
+                    const content = await fs.readFile(path.join(dir, entry), 'utf-8');
+                    const parsed = JSON.parse(content);
+                    sessions.push({ id: parsed.id, updatedAt: parsed.updatedAt });
+                }
+                catch {
+                    // skip corrupt files
+                }
+            }
+            sessions.sort((a, b) => b.updatedAt - a.updatedAt);
+            return sessions;
+        },
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/session/session.js.map

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

package/dist/session/session.test.d.ts

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

package/dist/session/session.test.d.ts.map

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

package/dist/session/session.test.js

@@ -0,0 +1,84 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { createSessionManager } from './session.js';
+import { SessionLoadError } from '../errors.js';
+function makeSnapshot(overrides = {}) {
+    return {
+        version: 1,
+        id: 'session-1',
+        messages: [],
+        modelId: 'test-model',
+        providerName: 'test-provider',
+        systemPromptHash: 'abc123',
+        memoryRefs: [],
+        createdAt: 1000,
+        updatedAt: 2000,
+        ...overrides,
+    };
+}
+describe('SessionManager', () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'session-test-'));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    describe('save and load roundtrip', () => {
+        it('saves and loads a session snapshot', async () => {
+            const manager = createSessionManager(tmpDir);
+            const snapshot = makeSnapshot();
+            await manager.save(snapshot);
+            const loaded = await manager.load('session-1');
+            expect(loaded).toEqual(snapshot);
+        });
+        it('creates directory if needed', async () => {
+            const subdir = path.join(tmpDir, 'nested', 'sessions');
+            const manager = createSessionManager(subdir);
+            const snapshot = makeSnapshot();
+            await manager.save(snapshot);
+            const loaded = await manager.load('session-1');
+            expect(loaded).toEqual(snapshot);
+        });
+    });
+    describe('load', () => {
+        it('returns null for missing session', async () => {
+            const manager = createSessionManager(tmpDir);
+            const result = await manager.load('nonexistent');
+            expect(result).toBeNull();
+        });
+        it('throws SessionLoadError for corrupt JSON', async () => {
+            await fs.writeFile(path.join(tmpDir, 'bad.json'), 'not json', 'utf-8');
+            const manager = createSessionManager(tmpDir);
+            await expect(manager.load('bad')).rejects.toThrow(SessionLoadError);
+        });
+        it('throws SessionLoadError for wrong version', async () => {
+            const bad = { ...makeSnapshot(), version: 99 };
+            await fs.writeFile(path.join(tmpDir, 'v99.json'), JSON.stringify(bad), 'utf-8');
+            const manager = createSessionManager(tmpDir);
+            await expect(manager.load('v99')).rejects.toThrow(SessionLoadError);
+        });
+    });
+    describe('list', () => {
+        it('lists sessions sorted by updatedAt desc', async () => {
+            const manager = createSessionManager(tmpDir);
+            await manager.save(makeSnapshot({ id: 'old', updatedAt: 1000 }));
+            await manager.save(makeSnapshot({ id: 'new', updatedAt: 3000 }));
+            await manager.save(makeSnapshot({ id: 'mid', updatedAt: 2000 }));
+            const list = await manager.list();
+            expect(list).toEqual([
+                { id: 'new', updatedAt: 3000 },
+                { id: 'mid', updatedAt: 2000 },
+                { id: 'old', updatedAt: 1000 },
+            ]);
+        });
+        it('returns empty array for non-existent directory', async () => {
+            const manager = createSessionManager(path.join(tmpDir, 'nope'));
+            const list = await manager.list();
+            expect(list).toEqual([]);
+        });
+    });
+});
+//# sourceMappingURL=session.test.js.map

package/dist/session/session.test.js.map

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

package/dist/skills.d.ts

@@ -0,0 +1,14 @@
+import type { HookHandler, McpServerConfig, PermissionRule, ResolvedSkill, SdkTool } from './types.js';
+import type { CodingAgentConfig } from './factory.js';
+export interface ComposeCodingAgentConfigOptions {
+    defaultTools?: SdkTool<any, any>[];
+}
+export interface ComposedCodingAgentConfig extends CodingAgentConfig {
+    hooks: HookHandler[];
+    mcpServers: McpServerConfig[];
+    permissionRules: PermissionRule[];
+    skills: ResolvedSkill[];
+    tools: SdkTool<any, any>[];
+}
+export declare function composeCodingAgentConfig(config: CodingAgentConfig, options?: ComposeCodingAgentConfigOptions): ComposedCodingAgentConfig;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,+BAA+B;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;CAC5B;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,+BAAoC,GAC5C,yBAAyB,CAmB3B"}

package/dist/skills.js

@@ -0,0 +1,31 @@
+export function composeCodingAgentConfig(config, options = {}) {
+    const skills = config.skills ?? [];
+    const skillTools = skills.flatMap((skill) => skill.tools ?? []);
+    const skillHooks = skills.flatMap((skill) => skill.hooks ?? []);
+    const skillMcpServers = skills.flatMap((skill) => skill.mcpServers ?? []);
+    const skillPermissionRules = skills.flatMap((skill) => skill.permissionRules ?? []);
+    const tools = config.tools
+        ? mergeByKey([...skillTools, ...config.tools], (tool) => tool.name)
+        : mergeByKey([...(options.defaultTools ?? []), ...skillTools], (tool) => tool.name);
+    return {
+        ...config,
+        hooks: [...skillHooks, ...(config.hooks ?? [])],
+        mcpServers: mergeByKey([...skillMcpServers, ...(config.mcpServers ?? [])], (server) => server.name),
+        permissionRules: [...skillPermissionRules, ...(config.permissionRules ?? [])],
+        skills,
+        tools,
+    };
+}
+function mergeByKey(items, getKey) {
+    const orderedKeys = [];
+    const merged = new Map();
+    for (const item of items) {
+        const key = getKey(item);
+        if (!merged.has(key)) {
+            orderedKeys.push(key);
+        }
+        merged.set(key, item);
+    }
+    return orderedKeys.map((key) => merged.get(key));
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,wBAAwB,CACtC,MAAyB,EACzB,UAA2C,EAAE;IAE7C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IAEpF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK;QACxB,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QACnE,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtF,OAAO;QACL,GAAG,MAAM;QACT,KAAK,EAAE,CAAC,GAAG,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC/C,UAAU,EAAE,UAAU,CAAC,CAAC,GAAG,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QACnG,eAAe,EAAE,CAAC,GAAG,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM;QACN,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAI,KAAU,EAAE,MAA2B;IAC5D,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAa,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/skills.test.d.ts

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

package/dist/skills.test.d.ts.map

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

package/dist/skills.test.js

@@ -0,0 +1,61 @@
+import { describe, expect, it } from 'vitest';
+import { Type } from '@sinclair/typebox';
+import { composeCodingAgentConfig } from './skills.js';
+import { getModel } from '@mariozechner/pi-ai';
+function createTool(name, description) {
+    return {
+        name,
+        label: name,
+        description,
+        capabilities: [],
+        parameters: Type.Object({}),
+        async execute() {
+            return { content: [{ type: 'text', text: name }], details: { name } };
+        },
+    };
+}
+describe('composeCodingAgentConfig', () => {
+    it('merges skill prompt, tools, hooks, MCP servers, and permission rules', () => {
+        const hook = {
+            event: 'SessionStart',
+            async handler() { },
+        };
+        const rule = {
+            target: { type: 'tool', name: 'Read' },
+            behavior: 'allow',
+            source: 'project',
+        };
+        const skill = {
+            id: 'typescript',
+            promptSections: ['Prefer TypeScript.'],
+            tools: [createTool('SkillTool', 'Provided by skill')],
+            hooks: [hook],
+            mcpServers: [{ name: 'skill-mcp', transport: 'sse', url: 'https://example.invalid/sse' }],
+            permissionRules: [rule],
+        };
+        const composed = composeCodingAgentConfig({
+            model: getModel('openai', 'gpt-4o-mini'),
+            skills: [skill],
+        }, {
+            defaultTools: [createTool('Read', 'Default read tool')],
+        });
+        expect(composed.skills).toEqual([skill]);
+        expect(composed.tools.map((tool) => tool.name)).toEqual(['Read', 'SkillTool']);
+        expect(composed.hooks).toEqual([hook]);
+        expect(composed.mcpServers.map((server) => server.name)).toEqual(['skill-mcp']);
+        expect(composed.permissionRules).toEqual([rule]);
+    });
+    it('lets explicit tools override skill tools with the same name', () => {
+        const composed = composeCodingAgentConfig({
+            model: getModel('openai', 'gpt-4o-mini'),
+            skills: [{
+                    id: 'formatter',
+                    tools: [createTool('Format', 'Skill formatter')],
+                }],
+            tools: [createTool('Format', 'Explicit formatter')],
+        });
+        expect(composed.tools).toHaveLength(1);
+        expect(composed.tools[0]?.description).toBe('Explicit formatter');
+    });
+});
+//# sourceMappingURL=skills.test.js.map

package/dist/skills.test.js.map

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

package/dist/tools/ask-user.d.ts

@@ -0,0 +1,10 @@
+import type { SdkTool } from '../types.js';
+declare const AskUserParams: import("@sinclair/typebox").TObject<{
+    question: import("@sinclair/typebox").TString;
+}>;
+export interface AskUserToolOptions {
+    onQuestion?: (question: string) => Promise<string>;
+}
+export declare function createAskUserTool(options?: AskUserToolOptions): SdkTool<typeof AskUserParams>;
+export {};
+//# sourceMappingURL=ask-user.d.ts.map

package/dist/tools/ask-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,aAAa;;EAEjB,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,aAAa,CAAC,CAqB7F"}

package/dist/tools/ask-user.js

@@ -0,0 +1,27 @@
+import { Type } from '@sinclair/typebox';
+const AskUserParams = Type.Object({
+    question: Type.String(),
+});
+export function createAskUserTool(options) {
+    return {
+        name: 'AskUser',
+        label: 'Ask user a question',
+        description: 'Asks the user a question and returns their response.',
+        parameters: AskUserParams,
+        capabilities: [],
+        async execute(_toolCallId, params) {
+            if (options?.onQuestion) {
+                const answer = await options.onQuestion(params.question);
+                return {
+                    content: [{ type: 'text', text: answer }],
+                    details: { question: params.question },
+                };
+            }
+            return {
+                content: [{ type: 'text', text: 'User interaction is not available.' }],
+                details: { question: params.question, available: false },
+            };
+        },
+    };
+}
+//# sourceMappingURL=ask-user.js.map

package/dist/tools/ask-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IAChC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAMH,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,sDAAsD;QACnE,UAAU,EAAE,aAAa;QACzB,YAAY,EAAE,EAAE;QAChB,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;YAC/B,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACzD,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBACzC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;iBACvC,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oCAAoC,EAAE,CAAC;gBACvE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;aACzD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/bash.d.ts

@@ -0,0 +1,11 @@
+import type { SdkTool, ToolOptions } from '../types.js';
+declare const BashParams: import("@sinclair/typebox").TObject<{
+    command: import("@sinclair/typebox").TString;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export interface BashToolOptions extends ToolOptions {
+    timeout?: number;
+}
+export declare function createBashTool(options?: BashToolOptions): SdkTool<typeof BashParams>;
+export {};
+//# sourceMappingURL=bash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOxD,QAAA,MAAM,UAAU;;;EAGd,CAAC;AAEH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,UAAU,CAAC,CAqDpF"}

package/dist/tools/bash.js

@@ -0,0 +1,54 @@
+import { Type } from '@sinclair/typebox';
+import { execFile } from 'node:child_process';
+import { ToolExecutionError } from '../errors.js';
+import { truncateOutput } from './util.js';
+const MAX_OUTPUT = 100 * 1024; // 100KB
+const DEFAULT_TIMEOUT = 120 * 1000; // 120 seconds
+const BashParams = Type.Object({
+    command: Type.String(),
+    timeout: Type.Optional(Type.Number()),
+});
+export function createBashTool(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const defaultTimeout = options?.timeout ? options.timeout * 1000 : DEFAULT_TIMEOUT;
+    return {
+        name: 'Bash',
+        label: 'Execute bash command',
+        description: 'Executes a bash command and returns its output.',
+        parameters: BashParams,
+        capabilities: ['process:spawn', 'fs:write', 'network:egress'],
+        async execute(_toolCallId, params, signal) {
+            const timeoutMs = params.timeout ? params.timeout * 1000 : defaultTimeout;
+            return new Promise((resolve, reject) => {
+                const child = execFile('bash', ['-c', params.command], {
+                    cwd,
+                    timeout: timeoutMs,
+                    maxBuffer: MAX_OUTPUT * 2, // allow some room, we truncate later
+                    signal: signal,
+                }, (error, stdout, stderr) => {
+                    if (error) {
+                        const exitCode = error.status ?? error.code;
+                        if (error.killed || error.message?.includes('ETIMEDOUT') || error.signal === 'SIGTERM') {
+                            reject(new ToolExecutionError(`Command timed out after ${timeoutMs / 1000}s`));
+                            return;
+                        }
+                        if (error.name === 'AbortError' || error.code === 'ABORT_ERR') {
+                            reject(new ToolExecutionError('Command aborted'));
+                            return;
+                        }
+                        const output = truncateOutput((stdout || '') + (stderr ? '\n' + stderr : ''), MAX_OUTPUT);
+                        reject(new ToolExecutionError(`Command exited with code ${exitCode}\n${output}`));
+                        return;
+                    }
+                    const combined = stdout + (stderr ? '\n' + stderr : '');
+                    const output = truncateOutput(combined, MAX_OUTPUT);
+                    resolve({
+                        content: [{ type: 'text', text: output }],
+                        details: { exitCode: 0 },
+                    });
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

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

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

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

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

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

package/dist/tools/bash.test.js

@@ -0,0 +1,63 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { createBashTool } from './bash.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+describe('createBashTool', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'bash-test-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('returns a tool with correct name and capabilities', () => {
+        const tool = createBashTool({ cwd: tmpDir });
+        expect(tool.name).toBe('Bash');
+        expect(tool.capabilities).toEqual(['process:spawn', 'fs:write', 'network:egress']);
+    });
+    it('executes a command and returns stdout', async () => {
+        const tool = createBashTool({ cwd: tmpDir });
+        const result = await tool.execute('call1', { command: 'echo hello' });
+        const text = result.content[0].text;
+        expect(text).toContain('hello');
+    });
+    it('throws on non-zero exit code', async () => {
+        const tool = createBashTool({ cwd: tmpDir });
+        await expect(tool.execute('call1', { command: 'exit 1' }))
+            .rejects.toThrow();
+    });
+    it('runs in the specified cwd', async () => {
+        const tool = createBashTool({ cwd: tmpDir });
+        const result = await tool.execute('call1', { command: 'pwd' });
+        const text = result.content[0].text;
+        expect(text.trim()).toBe(fs.realpathSync(tmpDir));
+    });
+    it('truncates output over 100KB', async () => {
+        const tool = createBashTool({ cwd: tmpDir });
+        // Generate output > 100KB
+        const result = await tool.execute('call1', { command: 'python3 -c "print(\'x\' * 200000)"' });
+        const text = result.content[0].text;
+        expect(text).toContain('[truncated]');
+    });
+    it('times out with custom timeout', async () => {
+        const tool = createBashTool({ cwd: tmpDir, timeout: 1 }); // 1 second default
+        await expect(tool.execute('call1', { command: 'sleep 10', timeout: 1 }))
+            .rejects.toThrow();
+    });
+    it('respects AbortSignal', async () => {
+        const tool = createBashTool({ cwd: tmpDir });
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(), 100);
+        await expect(tool.execute('call1', { command: 'sleep 10' }, controller.signal))
+            .rejects.toThrow();
+    });
+    it('includes stderr in output on success', async () => {
+        const tool = createBashTool({ cwd: tmpDir });
+        const result = await tool.execute('call1', { command: 'echo out; echo err >&2' });
+        const text = result.content[0].text;
+        expect(text).toContain('out');
+        // stderr may or may not be included depending on impl; just check no throw
+    });
+});
+//# sourceMappingURL=bash.test.js.map