agentx-sdk 0.1.0

package/dist/core/compaction/snip-compact.js

@@ -0,0 +1,61 @@
+/**
+ * Snip compact — removes low-value early messages before autocompact.
+ *
+ * Targets orphaned tool results (results not referenced by later messages)
+ * in the compactable region (outside tail protection).
+ *
+ * Runs between tool-result-budget and autocompact in the compaction pipeline.
+ */
+/**
+ * Remove orphaned tool results from early messages.
+ * Preserves: system messages, pinned messages, tail messages.
+ */
+export function snipCompact(messages, options) {
+    const { tailProtection } = options;
+    if (messages.length === 0)
+        return { messages: [], snippedCount: 0 };
+    // Separate protected messages
+    const system = messages.filter(m => m.role === 'system');
+    const pinned = messages.filter(m => m._pinned === true && m.role !== 'system');
+    const rest = messages.filter(m => m.role !== 'system' && m._pinned !== true);
+    const tailCount = Math.min(tailProtection, rest.length);
+    const early = rest.slice(0, rest.length - tailCount);
+    const tail = rest.slice(-tailCount);
+    if (early.length === 0) {
+        return { messages: [...messages], snippedCount: 0 };
+    }
+    // Find tool_call_ids that have a matching assistant tool_call anywhere (early + tail)
+    const referencedIds = new Set();
+    // From tail: both tool_call_id references and assistant tool_calls
+    for (const msg of tail) {
+        if (msg.tool_call_id)
+            referencedIds.add(msg.tool_call_id);
+        if (msg.tool_calls) {
+            for (const tc of msg.tool_calls) {
+                referencedIds.add(tc.id);
+            }
+        }
+    }
+    // From early: only assistant tool_calls (not tool results referencing themselves)
+    for (const msg of early) {
+        if (msg.tool_calls) {
+            for (const tc of msg.tool_calls) {
+                referencedIds.add(tc.id);
+            }
+        }
+    }
+    // Remove orphaned tool results from early messages
+    let snippedCount = 0;
+    const keptEarly = early.filter(msg => {
+        if (msg.role === 'tool' && msg.tool_call_id && !referencedIds.has(msg.tool_call_id)) {
+            snippedCount++;
+            return false;
+        }
+        return true;
+    });
+    return {
+        messages: [...system, ...pinned, ...keptEarly, ...tail],
+        snippedCount,
+    };
+}
+//# sourceMappingURL=snip-compact.js.map

package/dist/core/compaction/snip-compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snip-compact.js","sourceRoot":"","sources":["../../../src/core/compaction/snip-compact.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,QAAsC,EACtC,OAA2B;IAE3B,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAEnC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAEpE,8BAA8B;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAE,CAAwC,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACvH,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAK,CAAwC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IAErH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC;IAEpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACtD,CAAC;IAED,sFAAsF;IACtF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,mEAAmE;IACnE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,YAAY;YAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1D,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;gBAChC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IACD,kFAAkF;IAClF,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;gBAChC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QACnC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,YAAY,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACpF,YAAY,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC;QACvD,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/core/compaction/tool-result-budget.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tool result budget — aggregate truncation of large tool results.
+ *
+ * Runs BEFORE microcompact. While microcompact truncates individual messages
+ * to a per-message limit, tool-result-budget enforces a GLOBAL budget across
+ * all tool result messages. When total tool result chars exceed the budget,
+ * the largest results are truncated first.
+ *
+ * Ported from old_src/utils/toolResultStorage.ts applyToolResultBudget().
+ */
+import type { OpenRouterMessage } from '../../llm/message-types.js';
+export interface ToolResultBudgetOptions {
+    maxTotalToolResultChars: number;
+}
+export interface ToolResultBudgetResult {
+    messages: OpenRouterMessage[];
+    truncatedCount: number;
+}
+/**
+ * Apply a global budget to all tool result messages.
+ * Truncates the largest tool results first until total is within budget.
+ */
+export declare function applyToolResultBudget(messages: readonly OpenRouterMessage[], options: ToolResultBudgetOptions): ToolResultBudgetResult;
+//# sourceMappingURL=tool-result-budget.d.ts.map

package/dist/core/compaction/tool-result-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-budget.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/tool-result-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAKpE,MAAM,WAAW,uBAAuB;IACtC,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EACtC,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CA0DxB"}

package/dist/core/compaction/tool-result-budget.js

@@ -0,0 +1,67 @@
+/**
+ * Tool result budget — aggregate truncation of large tool results.
+ *
+ * Runs BEFORE microcompact. While microcompact truncates individual messages
+ * to a per-message limit, tool-result-budget enforces a GLOBAL budget across
+ * all tool result messages. When total tool result chars exceed the budget,
+ * the largest results are truncated first.
+ *
+ * Ported from old_src/utils/toolResultStorage.ts applyToolResultBudget().
+ */
+const HEAD_RATIO = 0.7;
+const TAIL_RATIO = 0.2;
+/**
+ * Apply a global budget to all tool result messages.
+ * Truncates the largest tool results first until total is within budget.
+ */
+export function applyToolResultBudget(messages, options) {
+    const { maxTotalToolResultChars } = options;
+    // Collect tool result indices and sizes
+    const toolResults = [];
+    for (let i = 0; i < messages.length; i++) {
+        const msg = messages[i];
+        if (msg.role === 'tool' && typeof msg.content === 'string') {
+            toolResults.push({ index: i, size: msg.content.length });
+        }
+    }
+    const totalChars = toolResults.reduce((sum, tr) => sum + tr.size, 0);
+    if (totalChars <= maxTotalToolResultChars) {
+        return { messages: [...messages], truncatedCount: 0 };
+    }
+    // Sort by size descending — truncate largest first
+    const sorted = [...toolResults].sort((a, b) => b.size - a.size);
+    // Calculate how much to cut
+    let remaining = totalChars - maxTotalToolResultChars;
+    const truncateTargets = new Map(); // index → target size
+    for (const tr of sorted) {
+        if (remaining <= 0)
+            break;
+        // Calculate how much this result should be
+        const cut = Math.min(remaining, tr.size - 200); // keep at least 200 chars
+        if (cut <= 0)
+            continue;
+        const targetSize = tr.size - cut;
+        truncateTargets.set(tr.index, targetSize);
+        remaining -= cut;
+    }
+    // Apply truncations
+    let truncatedCount = 0;
+    const result = messages.map((msg, i) => {
+        const targetSize = truncateTargets.get(i);
+        if (targetSize === undefined)
+            return msg;
+        truncatedCount++;
+        const content = msg.content;
+        const headSize = Math.floor(targetSize * HEAD_RATIO);
+        const tailSize = Math.floor(targetSize * TAIL_RATIO);
+        const head = content.slice(0, headSize);
+        const tail = content.slice(-tailSize);
+        const omitted = content.length - headSize - tailSize;
+        return {
+            ...msg,
+            content: `${head}\n\n[truncated ${omitted} characters — tool result budget exceeded]\n\n${tail}`,
+        };
+    });
+    return { messages: result, truncatedCount };
+}
+//# sourceMappingURL=tool-result-budget.js.map

package/dist/core/compaction/tool-result-budget.js.map

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

package/dist/core/context-analysis.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Context analysis — token accounting by role and subsystem.
+ *
+ * Provides visibility into where tokens are being spent.
+ * Ported from old_src/utils/contextAnalysis.ts pattern.
+ */
+import type { OpenRouterMessage } from '../llm/message-types.js';
+export interface ContextAnalysis {
+    totalTokens: number;
+    messageCount: number;
+    byRole: {
+        system: number;
+        user: number;
+        assistant: number;
+        tool: number;
+    };
+    toolResultCount: number;
+    toolResultChars: number;
+}
+/**
+ * Analyze context messages and return token breakdown.
+ */
+export declare function analyzeContext(messages: readonly OpenRouterMessage[]): ContextAnalysis;
+//# sourceMappingURL=context-analysis.d.ts.map

package/dist/core/context-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-analysis.d.ts","sourceRoot":"","sources":["../../src/core/context-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,eAAe,CA6BtF"}

package/dist/core/context-analysis.js

@@ -0,0 +1,37 @@
+/**
+ * Context analysis — token accounting by role and subsystem.
+ *
+ * Provides visibility into where tokens are being spent.
+ * Ported from old_src/utils/contextAnalysis.ts pattern.
+ */
+import { estimateTokens } from '../utils/token-counter.js';
+/**
+ * Analyze context messages and return token breakdown.
+ */
+export function analyzeContext(messages) {
+    const byRole = { system: 0, user: 0, assistant: 0, tool: 0 };
+    let totalTokens = 0;
+    let toolResultCount = 0;
+    let toolResultChars = 0;
+    for (const msg of messages) {
+        const content = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
+        const tokens = estimateTokens(content);
+        totalTokens += tokens;
+        const role = msg.role;
+        if (role in byRole) {
+            byRole[role] += tokens;
+        }
+        if (msg.role === 'tool') {
+            toolResultCount++;
+            toolResultChars += content.length;
+        }
+    }
+    return {
+        totalTokens,
+        messageCount: messages.length,
+        byRole,
+        toolResultCount,
+        toolResultChars,
+    };
+}
+//# sourceMappingURL=context-analysis.js.map

package/dist/core/context-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-analysis.js","sourceRoot":"","sources":["../../src/core/context-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAe3D;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAsC;IACnE,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC7D,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5F,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,WAAW,IAAI,MAAM,CAAC;QAEtB,MAAM,IAAI,GAAG,GAAG,CAAC,IAA2B,CAAC;QAC7C,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;QACzB,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACxB,eAAe,EAAE,CAAC;YAClB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW;QACX,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,MAAM;QACN,eAAe;QACf,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/core/context-builder.d.ts

@@ -0,0 +1,25 @@
+import type { OpenRouterMessage } from '../llm/message-types.js';
+import type { ChatMessage } from '../contracts/entities/chat-message.js';
+export interface ContextInjection {
+    source: string;
+    priority: number;
+    content: string;
+    tokens: number;
+}
+export interface ContextBuildResult {
+    messages: OpenRouterMessage[];
+    totalTokens: number;
+    injections: ContextInjection[];
+}
+/**
+ * Builds the full context (system prompt + injections + history) within a token budget.
+ */
+export declare function buildContext(options: {
+    systemPrompt?: string;
+    injections: ContextInjection[];
+    history: ChatMessage[];
+    maxTokens: number;
+    reserveTokens: number;
+    maxPinnedMessages: number;
+}): ContextBuildResult;
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/core/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/core/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAIzE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,kBAAkB,CAyDrB"}

package/dist/core/context-builder.js

@@ -0,0 +1,108 @@
+import { estimateTokens } from '../utils/token-counter.js';
+/**
+ * Builds the full context (system prompt + injections + history) within a token budget.
+ */
+export function buildContext(options) {
+    const { systemPrompt, injections, history, maxTokens, reserveTokens, maxPinnedMessages } = options;
+    const budget = maxTokens - reserveTokens;
+    let used = 0;
+    const messages = [];
+    const appliedInjections = [];
+    // 1. System prompt
+    let systemContent = systemPrompt ?? '';
+    const systemTokens = estimateTokens(systemContent);
+    used += systemTokens;
+    // 2. Injections sorted by priority (higher = more important), wrapped in <system-reminder>
+    const sortedInjections = [...injections].sort((a, b) => b.priority - a.priority);
+    for (const injection of sortedInjections) {
+        if (used + injection.tokens <= budget) {
+            systemContent += `\n\n<system-reminder>\n${injection.content}\n</system-reminder>`;
+            used += injection.tokens;
+            appliedInjections.push(injection);
+        }
+    }
+    if (systemContent) {
+        messages.push({ role: 'system', content: systemContent });
+    }
+    // 3. History — pinned messages always included, then recent messages
+    const pinned = history.filter(m => m.pinned).slice(0, maxPinnedMessages);
+    const unpinned = history.filter(m => !m.pinned);
+    // Include pinned first
+    for (const msg of pinned) {
+        const tokens = estimateTokens(typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content));
+        if (used + tokens <= budget) {
+            messages.push(chatMessageToOpenRouter(msg));
+            used += tokens;
+        }
+    }
+    // Include unpinned from most recent, fill remaining budget
+    const unpinnedReversed = [...unpinned].reverse();
+    const unpinnedToInclude = [];
+    for (const msg of unpinnedReversed) {
+        const tokens = estimateTokens(typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content));
+        if (used + tokens <= budget) {
+            unpinnedToInclude.unshift(chatMessageToOpenRouter(msg));
+            used += tokens;
+        }
+        else {
+            break;
+        }
+    }
+    messages.push(...unpinnedToInclude);
+    // 4. Merge consecutive same-role messages (API constraint: no consecutive user/user)
+    const merged = mergeConsecutiveMessages(messages);
+    return { messages: merged, totalTokens: used, injections: appliedInjections };
+}
+/**
+ * Merge consecutive messages with the same role.
+ * Prevents API errors from consecutive user or assistant messages.
+ */
+function mergeConsecutiveMessages(messages) {
+    if (messages.length <= 1)
+        return messages;
+    const result = [messages[0]];
+    for (let i = 1; i < messages.length; i++) {
+        const current = messages[i];
+        const prev = result[result.length - 1];
+        // Only merge user+user or assistant+assistant (not system, not tool)
+        if (current.role === prev.role &&
+            (current.role === 'user' || current.role === 'assistant') &&
+            typeof prev.content === 'string' &&
+            typeof current.content === 'string' &&
+            !current.tool_call_id &&
+            !prev.tool_calls) {
+            result[result.length - 1] = { ...prev, content: `${prev.content}\n\n${current.content}` };
+        }
+        else {
+            result.push(current);
+        }
+    }
+    return result;
+}
+function chatMessageToOpenRouter(msg) {
+    const result = {
+        role: msg.role,
+        content: typeof msg.content === 'string' ? msg.content : contentPartsToOpenRouter(msg.content),
+    };
+    if (msg.toolCalls) {
+        result.tool_calls = msg.toolCalls.map(tc => ({
+            id: tc.id,
+            type: 'function',
+            function: { name: tc.function.name, arguments: tc.function.arguments },
+        }));
+    }
+    if (msg.toolCallId) {
+        result.tool_call_id = msg.toolCallId;
+    }
+    return result;
+}
+function contentPartsToOpenRouter(parts) {
+    return parts.map(p => {
+        if (p.type === 'text')
+            return p.text;
+        if (p.type === 'image_url' && p.image_url?.url)
+            return `[image: ${p.image_url.url}]`;
+        return '';
+    }).filter(Boolean).join('');
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/core/context-builder.js.map

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

package/dist/core/conversation-manager.d.ts

@@ -0,0 +1,19 @@
+import type { ChatMessage } from '../contracts/entities/chat-message.js';
+import type { ConversationStore } from '../contracts/entities/stores.js';
+/**
+ * Manages conversation threads with mutex for isolation.
+ */
+export declare class ConversationManager {
+    private readonly store;
+    private readonly locks;
+    constructor(store?: ConversationStore);
+    /**
+     * Acquires mutex for a thread, executes fn, then releases.
+     */
+    withThread<T>(threadId: string, fn: () => Promise<T>): Promise<T>;
+    appendMessage(message: ChatMessage, threadId: string): void;
+    getHistory(threadId: string): ChatMessage[];
+    getPinnedMessages(threadId: string): ChatMessage[];
+    clearThread(threadId: string): void;
+}
+//# sourceMappingURL=conversation-manager.d.ts.map

package/dist/core/conversation-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../src/core/conversation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AA0BzE;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAE9C,KAAK,CAAC,EAAE,iBAAiB;IAIrC;;OAEG;IACG,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBvE,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI3D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAI3C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAIlD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAGpC"}

package/dist/core/conversation-manager.js

@@ -0,0 +1,62 @@
+/**
+ * In-memory fallback ConversationStore.
+ */
+class InMemoryConversationStore {
+    threads = new Map();
+    appendMessage(message, threadId) {
+        if (!this.threads.has(threadId))
+            this.threads.set(threadId, []);
+        this.threads.get(threadId).push(message);
+    }
+    listThread(threadId) {
+        return this.threads.get(threadId) ?? [];
+    }
+    listPinned(threadId) {
+        return this.listThread(threadId).filter(m => m.pinned);
+    }
+    clearThread(threadId) {
+        this.threads.delete(threadId);
+    }
+}
+/**
+ * Manages conversation threads with mutex for isolation.
+ */
+export class ConversationManager {
+    store;
+    locks = new Map();
+    constructor(store) {
+        this.store = store ?? new InMemoryConversationStore();
+    }
+    /**
+     * Acquires mutex for a thread, executes fn, then releases.
+     */
+    async withThread(threadId, fn) {
+        // Wait for any existing lock on this thread
+        while (this.locks.has(threadId)) {
+            await this.locks.get(threadId);
+        }
+        let releaseLock;
+        const lockPromise = new Promise(resolve => { releaseLock = resolve; });
+        this.locks.set(threadId, lockPromise);
+        try {
+            return await fn();
+        }
+        finally {
+            this.locks.delete(threadId);
+            releaseLock();
+        }
+    }
+    appendMessage(message, threadId) {
+        this.store.appendMessage(message, threadId);
+    }
+    getHistory(threadId) {
+        return this.store.listThread(threadId);
+    }
+    getPinnedMessages(threadId) {
+        return this.store.listPinned(threadId);
+    }
+    clearThread(threadId) {
+        this.store.clearThread(threadId);
+    }
+}
+//# sourceMappingURL=conversation-manager.js.map

package/dist/core/conversation-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-manager.js","sourceRoot":"","sources":["../../src/core/conversation-manager.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,yBAAyB;IACZ,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE5D,aAAa,CAAC,OAAoB,EAAE,QAAgB;QAClD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACb,KAAK,CAAoB;IACzB,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE1D,YAAY,KAAyB;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,yBAAyB,EAAE,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAI,QAAgB,EAAE,EAAoB;QACxD,4CAA4C;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,WAAuB,CAAC;QAC5B,MAAM,WAAW,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,GAAG,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEtC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,WAAY,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,aAAa,CAAC,OAAoB,EAAE,QAAgB;QAClD,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,iBAAiB,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/core/execution-context.d.ts

@@ -0,0 +1,6 @@
+import type { ExecutionContext as IExecutionContext } from '../contracts/entities/execution-context.js';
+/**
+ * Creates a new execution context with a unique traceId.
+ */
+export declare function createExecutionContext(threadId: string, model: string, parentTraceId?: string): IExecutionContext;
+//# sourceMappingURL=execution-context.d.ts.map

package/dist/core/execution-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../src/core/execution-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAExG;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAQjH"}

package/dist/core/execution-context.js

@@ -0,0 +1,14 @@
+import { randomUUID } from 'node:crypto';
+/**
+ * Creates a new execution context with a unique traceId.
+ */
+export function createExecutionContext(threadId, model, parentTraceId) {
+    return {
+        traceId: randomUUID(),
+        threadId,
+        startedAt: Date.now(),
+        model,
+        parentTraceId,
+    };
+}
+//# sourceMappingURL=execution-context.js.map

package/dist/core/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/core/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,KAAa,EAAE,aAAsB;IAC5F,OAAO;QACL,OAAO,EAAE,UAAU,EAAE;QACrB,QAAQ;QACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK;QACL,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/core/loop-deps.d.ts

@@ -0,0 +1,15 @@
+import type { StreamChatParams, StreamChunk } from '../llm/message-types.js';
+import type { OpenRouterClient } from '../llm/openrouter-client.js';
+/**
+ * Dependency injection for the react loop.
+ * Allows tests to inject fakes without mocking the entire OpenRouterClient.
+ */
+export interface LoopDeps {
+    /** Override for client.streamChat — returns the same stream chunk types */
+    callModel: (params: StreamChatParams) => AsyncIterableIterator<StreamChunk>;
+    /** UUID generator — useful for deterministic tests */
+    uuid: () => string;
+}
+/** Create production deps from a real client */
+export declare function createProductionDeps(client: OpenRouterClient): LoopDeps;
+//# sourceMappingURL=loop-deps.d.ts.map

package/dist/core/loop-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-deps.d.ts","sourceRoot":"","sources":["../../src/core/loop-deps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,SAAS,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC5E,sDAAsD;IACtD,IAAI,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CAKvE"}

package/dist/core/loop-deps.js

@@ -0,0 +1,8 @@
+/** Create production deps from a real client */
+export function createProductionDeps(client) {
+    return {
+        callModel: (params) => client.streamChat(params),
+        uuid: () => crypto.randomUUID(),
+    };
+}
+//# sourceMappingURL=loop-deps.js.map

package/dist/core/loop-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-deps.js","sourceRoot":"","sources":["../../src/core/loop-deps.ts"],"names":[],"mappings":"AAcA,gDAAgD;AAChD,MAAM,UAAU,oBAAoB,CAAC,MAAwB;IAC3D,OAAO;QACL,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAChD,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;KAChC,CAAC;AACJ,CAAC"}

package/dist/core/loop-types.d.ts

@@ -0,0 +1,34 @@
+import type { OpenRouterMessage } from '../llm/message-types.js';
+import type { TokenUsage } from '../contracts/entities/token-usage.js';
+/** Why the loop ended */
+export type TerminalReason = 'stop' | 'abort' | 'error' | 'cost_limit' | 'max_iterations' | 'prompt_too_long' | 'max_output_tokens' | 'stop_hook';
+/** Return value of the generator when the loop exits */
+export interface Terminal {
+    reason: TerminalReason;
+    usage: TokenUsage;
+    error?: Error;
+}
+/** Why the loop continued to the next iteration */
+export type ContinueReason = 'next_turn' | 'max_output_tokens_escalate' | 'max_output_tokens_recovery' | 'reactive_compact_retry' | 'model_fallback' | 'stop_hook_blocking' | 'token_budget_continuation';
+export interface Continue {
+    reason: ContinueReason;
+}
+export interface AutoCompactTracking {
+    lastCompactTurn: number;
+    consecutiveFailures: number;
+}
+export interface LoopState {
+    readonly messages: readonly OpenRouterMessage[];
+    readonly turnCount: number;
+    readonly consecutiveErrors: number;
+    readonly maxOutputTokensRecoveryCount: number;
+    readonly maxOutputTokensOverride: number | undefined;
+    readonly hasAttemptedCompaction: boolean;
+    readonly autoCompactTracking: AutoCompactTracking | undefined;
+    readonly transition: Continue | undefined;
+    /** Tracks tool-level retry attempts (onToolError: 'retry'). */
+    readonly toolRetryCount: number;
+}
+/** Create initial loop state from the starting messages */
+export declare function createInitialState(messages: OpenRouterMessage[]): LoopState;
+//# sourceMappingURL=loop-types.d.ts.map

package/dist/core/loop-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-types.d.ts","sourceRoot":"","sources":["../../src/core/loop-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAIvE,yBAAyB;AACzB,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,OAAO,GACP,OAAO,GACP,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,WAAW,CAAC;AAEhB,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAID,mDAAmD;AACnD,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,4BAA4B,GAC5B,4BAA4B,GAC5B,wBAAwB,GACxB,gBAAgB,GAChB,oBAAoB,GACpB,2BAA2B,CAAC;AAEhC,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,cAAc,CAAC;CACxB;AAID,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,uBAAuB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC1C,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAY3E"}

package/dist/core/loop-types.js

@@ -0,0 +1,15 @@
+/** Create initial loop state from the starting messages */
+export function createInitialState(messages) {
+    return {
+        messages,
+        turnCount: 1,
+        consecutiveErrors: 0,
+        maxOutputTokensRecoveryCount: 0,
+        maxOutputTokensOverride: undefined,
+        hasAttemptedCompaction: false,
+        autoCompactTracking: undefined,
+        transition: undefined,
+        toolRetryCount: 0,
+    };
+}
+//# sourceMappingURL=loop-types.js.map

package/dist/core/loop-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-types.js","sourceRoot":"","sources":["../../src/core/loop-types.ts"],"names":[],"mappings":"AA2DA,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,QAA6B;IAC9D,OAAO;QACL,QAAQ;QACR,SAAS,EAAE,CAAC;QACZ,iBAAiB,EAAE,CAAC;QACpB,4BAA4B,EAAE,CAAC;QAC/B,uBAAuB,EAAE,SAAS;QAClC,sBAAsB,EAAE,KAAK;QAC7B,mBAAmB,EAAE,SAAS;QAC9B,UAAU,EAAE,SAAS;QACrB,cAAc,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC"}

package/dist/core/message-normalize.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Message normalization for API submission.
+ *
+ * Ensures messages respect LLM API constraints:
+ * - tool_result must follow an assistant message with matching tool_calls
+ * - Orphaned tool results (no matching tool_call) are removed
+ * - Assistant messages with orphaned tool_calls (no matching result) get tool_calls stripped
+ * - Empty assistant messages without tool_calls are removed
+ *
+ * Ported from old_src/utils/messages.ts normalizeMessagesForAPI() — simplified for SDK.
+ */
+import type { OpenRouterMessage } from '../llm/message-types.js';
+/**
+ * Normalize messages before sending to the LLM API.
+ * Removes orphaned tool results/calls and empty messages.
+ */
+export declare function normalizeMessagesForAPI(messages: readonly OpenRouterMessage[]): OpenRouterMessage[];
+//# sourceMappingURL=message-normalize.d.ts.map

package/dist/core/message-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-normalize.d.ts","sourceRoot":"","sources":["../../src/core/message-normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CA4DnG"}