@researchcomputer/agents-sdk 0.1.0

package/dist/context/compression.js

@@ -0,0 +1,117 @@
+/**
+ * Estimates token count as ceil(text.length / 4).
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Extracts text content from an AgentMessage.
+ * Handles string content, array of TextContent, or falls back to JSON.stringify.
+ */
+export function messageText(msg) {
+    const m = msg;
+    const content = m.content;
+    if (typeof content === 'string') {
+        return content;
+    }
+    if (Array.isArray(content)) {
+        const texts = content
+            .filter((c) => c.type === 'text')
+            .map((c) => c.text);
+        if (texts.length > 0) {
+            return texts.join('\n');
+        }
+    }
+    return JSON.stringify(m);
+}
+function roleToSegmentType(role) {
+    switch (role) {
+        case 'user': return 'user';
+        case 'assistant': return 'assistant';
+        case 'toolResult': return 'toolIO';
+        case 'memory': return 'memory';
+        case 'summary': return 'summary';
+        default: return 'user'; // fallback
+    }
+}
+/**
+ * Groups messages into TranscriptSegments by consecutive role type.
+ */
+export function segmentMessages(messages) {
+    if (messages.length === 0)
+        return [];
+    const segments = [];
+    let currentType = null;
+    let currentMessages = [];
+    for (const msg of messages) {
+        const m = msg;
+        const type = roleToSegmentType(m.role);
+        if (type === currentType) {
+            currentMessages.push(msg);
+        }
+        else {
+            if (currentType !== null) {
+                segments.push({ type: currentType, protected: false, messages: currentMessages });
+            }
+            currentType = type;
+            currentMessages = [msg];
+        }
+    }
+    if (currentType !== null) {
+        segments.push({ type: currentType, protected: false, messages: currentMessages });
+    }
+    return segments;
+}
+/**
+ * Creates a transformContext middleware for context compression.
+ *
+ * Truncate strategy:
+ * - Protects the most recent N turns (protectedRecentTurns * 3 messages)
+ * - If total tokens are under 80% of maxTokens, returns unchanged
+ * - Otherwise keeps as many older messages as fit in budget, starting from most recent older ones
+ *
+ * Summarize strategy falls back to truncate for now.
+ */
+export function createCompressionMiddleware(config) {
+    const protectedRecentTurns = config.protectedRecentTurns ?? 3;
+    const protectedMessageCount = protectedRecentTurns * 3;
+    return async (messages, _signal) => {
+        // Estimate total tokens
+        const totalText = messages.map(m => messageText(m)).join('');
+        const totalTokens = estimateTokens(totalText);
+        // If under 80% of budget, return unchanged
+        if (totalTokens <= config.maxTokens * 0.8) {
+            return messages;
+        }
+        // Split into older and protected recent messages
+        const protectedCount = Math.min(protectedMessageCount, messages.length);
+        const splitIndex = messages.length - protectedCount;
+        const olderMessages = messages.slice(0, splitIndex);
+        const recentMessages = messages.slice(splitIndex);
+        // Calculate token budget for older messages
+        const recentText = recentMessages.map(m => messageText(m)).join('');
+        const recentTokens = estimateTokens(recentText);
+        const olderBudget = config.maxTokens - recentTokens;
+        if (olderBudget <= 0) {
+            // Only recent messages fit
+            return recentMessages;
+        }
+        // Use segment-based truncation to avoid splitting mid-turn
+        const segments = segmentMessages(olderMessages);
+        const kept = [];
+        let usedTokens = 0;
+        // Keep as many older segments as fit, starting from most recent
+        for (let i = segments.length - 1; i >= 0; i--) {
+            const segTokens = segments[i].messages.reduce((sum, m) => sum + estimateTokens(messageText(m)), 0);
+            if (usedTokens + segTokens <= olderBudget) {
+                kept.unshift(...segments[i].messages);
+                usedTokens += segTokens;
+            }
+            else {
+                break;
+            }
+        }
+        return [...kept, ...recentMessages];
+    };
+}
+//# sourceMappingURL=compression.js.map

package/dist/context/compression.js.map

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

package/dist/context/compression.test.d.ts

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

package/dist/context/compression.test.d.ts.map

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

package/dist/context/compression.test.js

@@ -0,0 +1,170 @@
+import { describe, it, expect } from 'vitest';
+import { estimateTokens, segmentMessages, createCompressionMiddleware, messageText } from './compression.js';
+function makeUser(text, ts = 1) {
+    return { role: 'user', content: text, timestamp: ts };
+}
+function makeAssistant(text, ts = 2) {
+    return {
+        role: 'assistant',
+        content: [{ type: 'text', text }],
+        api: 'anthropic-messages',
+        provider: 'anthropic',
+        model: 'claude-3',
+        usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
+        stopReason: 'stop',
+        timestamp: ts,
+    };
+}
+function makeToolResult(text, ts = 3) {
+    return {
+        role: 'toolResult',
+        toolCallId: 'tc1',
+        toolName: 'Read',
+        content: [{ type: 'text', text }],
+        isError: false,
+        timestamp: ts,
+    };
+}
+describe('estimateTokens', () => {
+    it('returns ceil(length / 4)', () => {
+        expect(estimateTokens('')).toBe(0);
+        expect(estimateTokens('a')).toBe(1);
+        expect(estimateTokens('abcd')).toBe(1);
+        expect(estimateTokens('abcde')).toBe(2);
+        expect(estimateTokens('a'.repeat(100))).toBe(25);
+    });
+});
+describe('messageText', () => {
+    it('extracts text from string content', () => {
+        expect(messageText(makeUser('hello'))).toBe('hello');
+    });
+    it('extracts text from array content with TextContent', () => {
+        expect(messageText(makeAssistant('world'))).toBe('world');
+    });
+    it('extracts text from toolResult', () => {
+        expect(messageText(makeToolResult('result'))).toBe('result');
+    });
+    it('falls back to JSON.stringify for unknown content', () => {
+        const msg = { role: 'memory', content: 'remembered', sources: [], timestamp: 1 };
+        const text = messageText(msg);
+        expect(text).toContain('remembered');
+    });
+});
+describe('segmentMessages', () => {
+    it('groups consecutive messages by segment type', () => {
+        const msgs = [
+            makeUser('q1'),
+            makeAssistant('a1'),
+            makeToolResult('r1'),
+            makeToolResult('r2'),
+            makeUser('q2'),
+        ];
+        const segments = segmentMessages(msgs);
+        expect(segments).toHaveLength(4);
+        expect(segments[0].type).toBe('user');
+        expect(segments[0].messages).toHaveLength(1);
+        expect(segments[1].type).toBe('assistant');
+        expect(segments[1].messages).toHaveLength(1);
+        expect(segments[2].type).toBe('toolIO');
+        expect(segments[2].messages).toHaveLength(2);
+        expect(segments[3].type).toBe('user');
+        expect(segments[3].messages).toHaveLength(1);
+    });
+    it('identifies memory messages as memory segment', () => {
+        const mem = { role: 'memory', content: 'fact', sources: [], timestamp: 1 };
+        const segments = segmentMessages([mem]);
+        expect(segments[0].type).toBe('memory');
+    });
+    it('identifies summary messages as summary segment', () => {
+        const sum = { role: 'summary', content: 'sum', compactedCount: 5, timestamp: 1 };
+        const segments = segmentMessages([sum]);
+        expect(segments[0].type).toBe('summary');
+    });
+    it('returns empty array for empty input', () => {
+        expect(segmentMessages([])).toEqual([]);
+    });
+});
+describe('createCompressionMiddleware', () => {
+    it('returns messages unchanged when under 80% of maxTokens', async () => {
+        const msgs = [
+            makeUser('short question'),
+            makeAssistant('short answer'),
+        ];
+        const middleware = createCompressionMiddleware({ maxTokens: 1000, strategy: 'truncate' });
+        const result = await middleware(msgs);
+        expect(result).toEqual(msgs);
+    });
+    it('truncates older messages when over budget', async () => {
+        // Create messages that exceed 80% of maxTokens
+        const longText = 'x'.repeat(400); // 100 tokens each
+        const msgs = [
+            makeUser(longText, 1), // old
+            makeAssistant(longText, 2), // old
+            makeUser(longText, 3), // old
+            makeAssistant(longText, 4), // old
+            makeUser(longText, 5), // old
+            makeAssistant(longText, 6), // old
+            // Recent turns (protected by default 3 turns * 3 = 9 messages, but we only have these)
+            makeUser('recent q1', 7),
+            makeAssistant('recent a1', 8),
+            makeToolResult('recent r1', 9),
+            makeUser('recent q2', 10),
+            makeAssistant('recent a2', 11),
+            makeToolResult('recent r2', 12),
+            makeUser('recent q3', 13),
+            makeAssistant('recent a3', 14),
+            makeToolResult('recent r3', 15),
+        ];
+        // Total tokens: 6*100 + 9*~3 = ~627 tokens
+        // maxTokens = 200, so 80% = 160, definitely over budget
+        const middleware = createCompressionMiddleware({ maxTokens: 200, strategy: 'truncate' });
+        const result = await middleware(msgs);
+        // Should have fewer messages than original (some older ones truncated)
+        expect(result.length).toBeLessThan(msgs.length);
+        // Should always include the recent protected messages
+        expect(result[result.length - 1]).toEqual(msgs[msgs.length - 1]);
+    });
+    it('protects the specified number of recent turns', async () => {
+        const longText = 'x'.repeat(400); // 100 tokens
+        const msgs = [
+            makeUser(longText, 1),
+            makeAssistant(longText, 2),
+            makeUser('q1', 3),
+            makeAssistant('a1', 4),
+        ];
+        const middleware = createCompressionMiddleware({
+            maxTokens: 50,
+            strategy: 'truncate',
+            protectedRecentTurns: 1, // protect last 3 messages
+        });
+        const result = await middleware(msgs);
+        // The last 3 messages should be protected
+        expect(result.length).toBeGreaterThanOrEqual(2);
+        expect(result[result.length - 1]).toEqual(msgs[msgs.length - 1]);
+        expect(result[result.length - 2]).toEqual(msgs[msgs.length - 2]);
+    });
+    it('summarize strategy falls back to truncate', async () => {
+        const longText = 'x'.repeat(400);
+        const msgs = [
+            makeUser(longText, 1),
+            makeAssistant(longText, 2),
+            makeUser('recent', 3),
+            makeAssistant('recent', 4),
+        ];
+        const middleware = createCompressionMiddleware({
+            maxTokens: 50,
+            strategy: 'summarize',
+            protectedRecentTurns: 1,
+        });
+        const result = await middleware(msgs);
+        expect(result.length).toBeLessThanOrEqual(msgs.length);
+    });
+    it('handles abort signal', async () => {
+        const msgs = [makeUser('hi')];
+        const controller = new AbortController();
+        const middleware = createCompressionMiddleware({ maxTokens: 1000, strategy: 'truncate' });
+        const result = await middleware(msgs, controller.signal);
+        expect(result).toEqual(msgs);
+    });
+});
+//# sourceMappingURL=compression.test.js.map

package/dist/context/compression.test.js.map

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

package/dist/context/converter.d.ts

@@ -0,0 +1,11 @@
+import type { Message } from '@mariozechner/pi-ai';
+import type { AgentMessage } from '@mariozechner/pi-agent-core';
+/**
+ * Converts AgentMessage[] to LLM-compatible Message[].
+ *
+ * Standard messages (user, assistant, toolResult) pass through unchanged.
+ * Custom SDK messages are converted to UserMessages with descriptive prefixes.
+ * Unknown roles are skipped.
+ */
+export declare function convertToLlm(messages: AgentMessage[]): Message[];
+//# sourceMappingURL=converter.d.ts.map

package/dist/context/converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/context/converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAiChE"}

package/dist/context/converter.js

@@ -0,0 +1,40 @@
+/**
+ * Converts AgentMessage[] to LLM-compatible Message[].
+ *
+ * Standard messages (user, assistant, toolResult) pass through unchanged.
+ * Custom SDK messages are converted to UserMessages with descriptive prefixes.
+ * Unknown roles are skipped.
+ */
+export function convertToLlm(messages) {
+    const result = [];
+    for (const msg of messages) {
+        const m = msg;
+        switch (m.role) {
+            case 'user':
+            case 'assistant':
+            case 'toolResult':
+                result.push(msg);
+                break;
+            case 'memory': {
+                const mem = msg;
+                result.push({ role: 'user', content: `[Memory] ${mem.content}`, timestamp: mem.timestamp });
+                break;
+            }
+            case 'summary': {
+                const sum = msg;
+                result.push({ role: 'user', content: `[Context Summary] ${sum.content}`, timestamp: sum.timestamp });
+                break;
+            }
+            case 'swarmReport': {
+                const rep = msg;
+                result.push({ role: 'user', content: `[Agent Report: ${rep.fromAgent}] ${rep.content}`, timestamp: rep.timestamp });
+                break;
+            }
+            default:
+                // Unknown roles are skipped
+                break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=converter.js.map

package/dist/context/converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.js","sourceRoot":"","sources":["../../src/context/converter.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAwB;IACnD,MAAM,MAAM,GAAc,EAAE,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,GAAuB,CAAC;QAClC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,MAAM,CAAC;YACZ,KAAK,WAAW,CAAC;YACjB,KAAK,YAAY;gBACf,MAAM,CAAC,IAAI,CAAC,GAAc,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,GAAG,GAAG,GAA6B,CAAC;gBAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC5F,MAAM;YACR,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,GAAG,GAAG,GAA+B,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;gBACrG,MAAM;YACR,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,GAAG,GAAG,GAAyB,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;gBACpH,MAAM;YACR,CAAC;YACD;gBACE,4BAA4B;gBAC5B,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/context/converter.test.d.ts

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

package/dist/context/converter.test.d.ts.map

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

package/dist/context/converter.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect } from 'vitest';
+import { convertToLlm } from './converter.js';
+describe('convertToLlm', () => {
+    it('passes through UserMessage unchanged', () => {
+        const user = { role: 'user', content: 'hello', timestamp: 1 };
+        const result = convertToLlm([user]);
+        expect(result).toEqual([user]);
+    });
+    it('passes through AssistantMessage unchanged', () => {
+        const assistant = {
+            role: 'assistant',
+            content: [{ type: 'text', text: 'hi' }],
+            api: 'anthropic-messages',
+            provider: 'anthropic',
+            model: 'claude-3',
+            usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
+            stopReason: 'stop',
+            timestamp: 1,
+        };
+        const result = convertToLlm([assistant]);
+        expect(result).toEqual([assistant]);
+    });
+    it('passes through ToolResultMessage unchanged', () => {
+        const toolResult = {
+            role: 'toolResult',
+            toolCallId: 'tc1',
+            toolName: 'Read',
+            content: [{ type: 'text', text: 'file content' }],
+            isError: false,
+            timestamp: 1,
+        };
+        const result = convertToLlm([toolResult]);
+        expect(result).toEqual([toolResult]);
+    });
+    it('converts MemoryInjectionMessage to UserMessage with [Memory] prefix', () => {
+        const memory = {
+            role: 'memory',
+            content: 'remembered fact',
+            sources: ['file.md'],
+            timestamp: 100,
+        };
+        const result = convertToLlm([memory]);
+        expect(result).toHaveLength(1);
+        expect(result[0]).toEqual({
+            role: 'user',
+            content: '[Memory] remembered fact',
+            timestamp: 100,
+        });
+    });
+    it('converts CompactionSummaryMessage to UserMessage with [Context Summary] prefix', () => {
+        const summary = {
+            role: 'summary',
+            content: 'conversation summary here',
+            compactedCount: 10,
+            timestamp: 200,
+        };
+        const result = convertToLlm([summary]);
+        expect(result).toHaveLength(1);
+        expect(result[0]).toEqual({
+            role: 'user',
+            content: '[Context Summary] conversation summary here',
+            timestamp: 200,
+        });
+    });
+    it('converts SwarmReportMessage to UserMessage with [Agent Report: <name>] prefix', () => {
+        const report = {
+            role: 'swarmReport',
+            content: 'task completed',
+            fromAgent: 'worker-1',
+            taskId: 'task-abc',
+            timestamp: 300,
+        };
+        const result = convertToLlm([report]);
+        expect(result).toHaveLength(1);
+        expect(result[0]).toEqual({
+            role: 'user',
+            content: '[Agent Report: worker-1] task completed',
+            timestamp: 300,
+        });
+    });
+    it('skips unknown roles', () => {
+        const unknown = { role: 'unknown', content: 'mystery', timestamp: 1 };
+        const result = convertToLlm([unknown]);
+        expect(result).toEqual([]);
+    });
+    it('handles mixed message types in order', () => {
+        const user = { role: 'user', content: 'hello', timestamp: 1 };
+        const memory = { role: 'memory', content: 'fact', sources: [], timestamp: 2 };
+        const assistant = {
+            role: 'assistant',
+            content: [{ type: 'text', text: 'response' }],
+            api: 'anthropic-messages',
+            provider: 'anthropic',
+            model: 'claude-3',
+            usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
+            stopReason: 'stop',
+            timestamp: 3,
+        };
+        const unknown = { role: 'alien', timestamp: 4 };
+        const result = convertToLlm([user, memory, assistant, unknown]);
+        expect(result).toHaveLength(3);
+        expect(result[0]).toEqual(user);
+        expect(result[1].content).toBe('[Memory] fact');
+        expect(result[2]).toEqual(assistant);
+    });
+    it('returns empty array for empty input', () => {
+        expect(convertToLlm([])).toEqual([]);
+    });
+});
+//# sourceMappingURL=converter.test.js.map

package/dist/context/converter.test.js.map

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

package/dist/context/run-context.d.ts

@@ -0,0 +1,9 @@
+import type { RunContext } from '../types.js';
+export interface RunContextOptions {
+    cwd: string;
+    sessionId?: string;
+    traceId?: string;
+    signal?: AbortSignal;
+}
+export declare function createRunContext(options: RunContextOptions): RunContext;
+//# sourceMappingURL=run-context.d.ts.map

package/dist/context/run-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-context.d.ts","sourceRoot":"","sources":["../../src/context/run-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CASvE"}

package/dist/context/run-context.js

@@ -0,0 +1,14 @@
+import { randomUUID } from 'node:crypto';
+import { createCostTracker } from '../observability/cost-tracker.js';
+import { generateTraceId } from '../observability/trace.js';
+export function createRunContext(options) {
+    return {
+        cwd: options.cwd,
+        sessionId: options.sessionId ?? randomUUID(),
+        traceId: options.traceId ?? generateTraceId(),
+        signal: options.signal ?? AbortSignal.timeout(2_147_483_647),
+        costTracker: createCostTracker(),
+        permissionDecisions: [],
+    };
+}
+//# sourceMappingURL=run-context.js.map

package/dist/context/run-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-context.js","sourceRoot":"","sources":["../../src/context/run-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAU5D,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,UAAU,EAAE;QAC5C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe,EAAE;QAC7C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,OAAO,CAAC,aAAa,CAAC;QAC5D,WAAW,EAAE,iBAAiB,EAAE;QAChC,mBAAmB,EAAE,EAAE;KACxB,CAAC;AACJ,CAAC"}

package/dist/context/run-context.test.d.ts

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

package/dist/context/run-context.test.d.ts.map

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

package/dist/context/run-context.test.js

@@ -0,0 +1,34 @@
+import { describe, it, expect } from 'vitest';
+import { createRunContext } from './run-context.js';
+describe('createRunContext', () => {
+    it('creates a RunContext with required cwd', () => {
+        const ctx = createRunContext({ cwd: '/tmp' });
+        expect(ctx.cwd).toBe('/tmp');
+        expect(ctx.sessionId).toBeTruthy();
+        expect(ctx.traceId).toBeTruthy();
+        expect(ctx.signal).toBeDefined();
+        expect(ctx.costTracker).toBeDefined();
+        expect(ctx.permissionDecisions).toEqual([]);
+    });
+    it('uses provided sessionId and traceId', () => {
+        const ctx = createRunContext({ cwd: '/tmp', sessionId: 'my-session', traceId: 'my-trace' });
+        expect(ctx.sessionId).toBe('my-session');
+        expect(ctx.traceId).toBe('my-trace');
+    });
+    it('uses provided signal', () => {
+        const controller = new AbortController();
+        const ctx = createRunContext({ cwd: '/tmp', signal: controller.signal });
+        expect(ctx.signal).toBe(controller.signal);
+    });
+    it('generates unique sessionIds and traceIds', () => {
+        const ctx1 = createRunContext({ cwd: '/tmp' });
+        const ctx2 = createRunContext({ cwd: '/tmp' });
+        expect(ctx1.sessionId).not.toBe(ctx2.sessionId);
+        expect(ctx1.traceId).not.toBe(ctx2.traceId);
+    });
+    it('costTracker works correctly', () => {
+        const ctx = createRunContext({ cwd: '/tmp' });
+        expect(ctx.costTracker.total()).toEqual({ tokens: 0, cost: 0 });
+    });
+});
+//# sourceMappingURL=run-context.test.js.map

package/dist/context/run-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-context.test.js","sourceRoot":"","sources":["../../src/context/run-context.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,GAAG,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5F,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,GAAG,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/context/system-prompt.d.ts

@@ -0,0 +1,24 @@
+import type { SdkTool, MemorySelection, PermissionMode, ResolvedSkill } from '../types.js';
+export interface SystemPromptConfig {
+    basePrompt?: string;
+    skills?: ResolvedSkill[];
+    tools?: SdkTool<any, any>[];
+    memories?: MemorySelection[];
+    permissionMode?: PermissionMode;
+    swarmContext?: {
+        teammates: string[];
+        instructions?: string;
+    };
+}
+/**
+ * Builds a system prompt by assembling sections in order:
+ * 1. Base prompt
+ * 2. Skill instructions
+ * 3. Tool descriptions
+ * 4. Memory context
+ * 5. Memory instructions
+ * 6. Permission context
+ * 7. Swarm context
+ */
+export declare function buildSystemPrompt(config: SystemPromptConfig): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/context/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/context/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3F,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,YAAY,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuEpE"}