@bowenqt/qiniu-ai-sdk 0.10.0 → 0.13.0

package/dist/ai/nodes/execute-node.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * ExecuteNode - Tool execution abstraction.
+ * Extracted from generateText for modular use in Graph Runtime.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeTools = executeTools;
+exports.toolResultsToMessages = toolResultsToMessages;
+/**
+ * Execute tools based on tool calls from LLM.
+ */
+async function executeTools(toolCalls, tools, context) {
+    const results = [];
+    for (const call of toolCalls) {
+        // Check abort signal
+        if (context.abortSignal?.aborted) {
+            results.push({
+                toolCallId: call.id,
+                result: 'Execution cancelled',
+                isError: true,
+            });
+            continue;
+        }
+        const tool = tools.get(call.function.name);
+        if (!tool) {
+            results.push({
+                toolCallId: call.id,
+                result: `Tool not found: ${call.function.name}`,
+                isError: true,
+            });
+            continue;
+        }
+        if (!tool.execute) {
+            results.push({
+                toolCallId: call.id,
+                result: `Tool ${call.function.name} has no execute function`,
+                isError: true,
+            });
+            continue;
+        }
+        try {
+            // Parse arguments
+            const args = parseToolArguments(call.function.arguments);
+            // Execute tool
+            const execContext = {
+                toolCallId: call.id,
+                messages: context.messages,
+                abortSignal: context.abortSignal,
+            };
+            const result = await tool.execute(args, execContext);
+            results.push({
+                toolCallId: call.id,
+                result: serializeResult(result),
+                isError: false,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            results.push({
+                toolCallId: call.id,
+                result: `Error: ${errorMessage}`,
+                isError: true,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Convert tool execution results to chat messages.
+ */
+function toolResultsToMessages(results) {
+    return results.map(r => ({
+        role: 'tool',
+        content: r.result,
+        tool_call_id: r.toolCallId,
+    }));
+}
+/**
+ * Parse tool arguments from JSON string.
+ */
+function parseToolArguments(payload) {
+    if (!payload || payload.trim() === '') {
+        return {};
+    }
+    try {
+        return JSON.parse(payload);
+    }
+    catch {
+        // Try to fix common JSON issues
+        try {
+            const fixed = payload
+                .replace(/'/g, '"')
+                .replace(/(\w+):/g, '"$1":');
+            return JSON.parse(fixed);
+        }
+        catch {
+            return { _raw: payload };
+        }
+    }
+}
+/**
+ * Serialize tool result to string.
+ */
+function serializeResult(result) {
+    if (result === undefined || result === null) {
+        return '';
+    }
+    if (typeof result === 'string') {
+        return result;
+    }
+    try {
+        return JSON.stringify(result, null, 2);
+    }
+    catch {
+        return String(result);
+    }
+}
+//# sourceMappingURL=execute-node.js.map

package/dist/ai/nodes/execute-node.js.map

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

package/dist/ai/nodes/execute-node.mjs

@@ -0,0 +1,114 @@
+/**
+ * ExecuteNode - Tool execution abstraction.
+ * Extracted from generateText for modular use in Graph Runtime.
+ */
+/**
+ * Execute tools based on tool calls from LLM.
+ */
+export async function executeTools(toolCalls, tools, context) {
+    const results = [];
+    for (const call of toolCalls) {
+        // Check abort signal
+        if (context.abortSignal?.aborted) {
+            results.push({
+                toolCallId: call.id,
+                result: 'Execution cancelled',
+                isError: true,
+            });
+            continue;
+        }
+        const tool = tools.get(call.function.name);
+        if (!tool) {
+            results.push({
+                toolCallId: call.id,
+                result: `Tool not found: ${call.function.name}`,
+                isError: true,
+            });
+            continue;
+        }
+        if (!tool.execute) {
+            results.push({
+                toolCallId: call.id,
+                result: `Tool ${call.function.name} has no execute function`,
+                isError: true,
+            });
+            continue;
+        }
+        try {
+            // Parse arguments
+            const args = parseToolArguments(call.function.arguments);
+            // Execute tool
+            const execContext = {
+                toolCallId: call.id,
+                messages: context.messages,
+                abortSignal: context.abortSignal,
+            };
+            const result = await tool.execute(args, execContext);
+            results.push({
+                toolCallId: call.id,
+                result: serializeResult(result),
+                isError: false,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            results.push({
+                toolCallId: call.id,
+                result: `Error: ${errorMessage}`,
+                isError: true,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Convert tool execution results to chat messages.
+ */
+export function toolResultsToMessages(results) {
+    return results.map(r => ({
+        role: 'tool',
+        content: r.result,
+        tool_call_id: r.toolCallId,
+    }));
+}
+/**
+ * Parse tool arguments from JSON string.
+ */
+function parseToolArguments(payload) {
+    if (!payload || payload.trim() === '') {
+        return {};
+    }
+    try {
+        return JSON.parse(payload);
+    }
+    catch {
+        // Try to fix common JSON issues
+        try {
+            const fixed = payload
+                .replace(/'/g, '"')
+                .replace(/(\w+):/g, '"$1":');
+            return JSON.parse(fixed);
+        }
+        catch {
+            return { _raw: payload };
+        }
+    }
+}
+/**
+ * Serialize tool result to string.
+ */
+function serializeResult(result) {
+    if (result === undefined || result === null) {
+        return '';
+    }
+    if (typeof result === 'string') {
+        return result;
+    }
+    try {
+        return JSON.stringify(result, null, 2);
+    }
+    catch {
+        return String(result);
+    }
+}
+//# sourceMappingURL=execute-node.js.map

package/dist/ai/nodes/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI Nodes - Modular components for agent execution.
+ */
+export { predict, type PredictOptions, type PredictResult } from './predict-node';
+export { executeTools, toolResultsToMessages, type ExecutionContext, type ToolExecutionResult } from './execute-node';
+export { compactMessages, buildToolPairs, ContextOverflowError } from './memory-node';
+export type { CompactionResult, CompactionConfig, ToolPair, InjectedSkill } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/nodes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/nodes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACtH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/ai/nodes/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * AI Nodes - Modular components for agent execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextOverflowError = exports.buildToolPairs = exports.compactMessages = exports.toolResultsToMessages = exports.executeTools = exports.predict = void 0;
+var predict_node_1 = require("./predict-node");
+Object.defineProperty(exports, "predict", { enumerable: true, get: function () { return predict_node_1.predict; } });
+var execute_node_1 = require("./execute-node");
+Object.defineProperty(exports, "executeTools", { enumerable: true, get: function () { return execute_node_1.executeTools; } });
+Object.defineProperty(exports, "toolResultsToMessages", { enumerable: true, get: function () { return execute_node_1.toolResultsToMessages; } });
+var memory_node_1 = require("./memory-node");
+Object.defineProperty(exports, "compactMessages", { enumerable: true, get: function () { return memory_node_1.compactMessages; } });
+Object.defineProperty(exports, "buildToolPairs", { enumerable: true, get: function () { return memory_node_1.buildToolPairs; } });
+Object.defineProperty(exports, "ContextOverflowError", { enumerable: true, get: function () { return memory_node_1.ContextOverflowError; } });
+//# sourceMappingURL=index.js.map

package/dist/ai/nodes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/nodes/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,+CAAkF;AAAzE,uGAAA,OAAO,OAAA;AAChB,+CAAsH;AAA7G,4GAAA,YAAY,OAAA;AAAE,qHAAA,qBAAqB,OAAA;AAC5C,6CAAsF;AAA7E,8GAAA,eAAe,OAAA;AAAE,6GAAA,cAAc,OAAA;AAAE,mHAAA,oBAAoB,OAAA"}

package/dist/ai/nodes/index.mjs

@@ -0,0 +1,7 @@
+/**
+ * AI Nodes - Modular components for agent execution.
+ */
+export { predict } from './predict-node.mjs';
+export { executeTools, toolResultsToMessages } from './execute-node.mjs';
+export { compactMessages, buildToolPairs, ContextOverflowError } from './memory-node.mjs';
+//# sourceMappingURL=index.js.map

package/dist/ai/nodes/memory-node.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Memory Node - Context Compaction with deterministic fallback.
+ *
+ * Fallback order:
+ * 1. Drop low-priority skill messages (_meta.droppable)
+ * 2. Drop oldest unprotected messages
+ * 3. Throw ContextOverflowError
+ */
+import type { ChatMessage } from '../../lib/types';
+import type { CompactionResult, CompactionConfig, ToolPair, InjectedSkill } from './types';
+import type { InternalMessage } from '../internal-types';
+/** Context overflow error */
+export declare class ContextOverflowError extends Error {
+    readonly currentTokens: number;
+    readonly maxTokens: number;
+    readonly recommendation: string;
+    constructor(currentTokens: number, maxTokens: number, recommendation: string);
+}
+/**
+ * Compact messages to fit within token budget.
+ * Implements deterministic fallback: droppable skills → old messages → error
+ *
+ * Key feature: recognizes _meta.droppable messages (skill-injected) for selective removal.
+ */
+export declare function compactMessages(messages: InternalMessage[], config: CompactionConfig, injectedSkills?: InjectedSkill[]): CompactionResult;
+/**
+ * Build tool call/result pairs.
+ * Returns pairs and orphan call IDs.
+ */
+export declare function buildToolPairs(messages: ChatMessage[]): {
+    toolPairs: ToolPair[];
+    orphanCalls: string[];
+};
+//# sourceMappingURL=memory-node.d.ts.map

package/dist/ai/nodes/memory-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-node.d.ts","sourceRoot":"","sources":["../../../src/ai/nodes/memory-node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,6BAA6B;AAC7B,qBAAa,oBAAqB,SAAQ,KAAK;aAEvB,aAAa,EAAE,MAAM;aACrB,SAAS,EAAE,MAAM;aACjB,cAAc,EAAE,MAAM;gBAFtB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM;CAK7C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,eAAe,EAAE,EAC3B,MAAM,EAAE,gBAAgB,EACxB,cAAc,GAAE,aAAa,EAAO,GACrC,gBAAgB,CA0HlB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IACrD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB,CAgCA"}

package/dist/ai/nodes/memory-node.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Memory Node - Context Compaction with deterministic fallback.
+ *
+ * Fallback order:
+ * 1. Drop low-priority skill messages (_meta.droppable)
+ * 2. Drop oldest unprotected messages
+ * 3. Throw ContextOverflowError
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextOverflowError = void 0;
+exports.compactMessages = compactMessages;
+exports.buildToolPairs = buildToolPairs;
+const internal_types_1 = require("../internal-types");
+/** Context overflow error */
+class ContextOverflowError extends Error {
+    constructor(currentTokens, maxTokens, recommendation) {
+        super(`Context overflow: ${currentTokens} tokens exceeds max ${maxTokens}. ${recommendation}`);
+        this.currentTokens = currentTokens;
+        this.maxTokens = maxTokens;
+        this.recommendation = recommendation;
+        this.name = 'ContextOverflowError';
+    }
+}
+exports.ContextOverflowError = ContextOverflowError;
+/**
+ * Compact messages to fit within token budget.
+ * Implements deterministic fallback: droppable skills → old messages → error
+ *
+ * Key feature: recognizes _meta.droppable messages (skill-injected) for selective removal.
+ */
+function compactMessages(messages, config, injectedSkills = []) {
+    const result = {
+        messages: [...messages],
+        occurred: false,
+        droppedSkills: [],
+        droppedMessages: 0,
+        orphanToolCalls: [],
+        recommendation: undefined,
+    };
+    // Check if compaction needed
+    let currentTokens = config.estimateTokens(result.messages);
+    if (currentTokens <= config.maxTokens) {
+        return result;
+    }
+    result.occurred = true;
+    // Build tool pairs (must be kept together)
+    const { toolPairs, orphanCalls } = buildToolPairs(result.messages);
+    result.orphanToolCalls = orphanCalls;
+    // Identify protected indices
+    const protectedIndices = new Set();
+    // Non-droppable system messages are protected
+    result.messages.forEach((msg, idx) => {
+        if (msg.role === 'system' && !(0, internal_types_1.isDroppable)(msg)) {
+            protectedIndices.add(idx);
+        }
+    });
+    // Tool pairs are protected
+    for (const pair of toolPairs) {
+        protectedIndices.add(pair.callMessageIndex);
+        if (pair.resultMessageIndex !== null) {
+            protectedIndices.add(pair.resultMessageIndex);
+        }
+    }
+    // Last user message is protected
+    for (let i = result.messages.length - 1; i >= 0; i--) {
+        if (result.messages[i].role === 'user') {
+            protectedIndices.add(i);
+            break;
+        }
+    }
+    // Step 1: Drop droppable skill messages (lowest priority first)
+    // Collect all droppable messages with their skill IDs
+    const droppableIndices = [];
+    result.messages.forEach((msg, idx) => {
+        if ((0, internal_types_1.isDroppable)(msg)) {
+            const skillId = (0, internal_types_1.getSkillId)(msg);
+            if (skillId) {
+                droppableIndices.push({
+                    idx,
+                    skillId,
+                    tokens: config.estimateTokens([msg]),
+                });
+            }
+        }
+    });
+    // Sort by priority (using injectedSkills order) - lowest priority first
+    const skillPriorityMap = new Map();
+    injectedSkills.forEach((skill, i) => skillPriorityMap.set(skill.name, i));
+    droppableIndices.sort((a, b) => {
+        const priorityA = skillPriorityMap.get(a.skillId) ?? 0;
+        const priorityB = skillPriorityMap.get(b.skillId) ?? 0;
+        return priorityA - priorityB; // Lower priority (earlier in list) dropped first
+    });
+    // Drop droppable messages until under budget
+    const indicesToRemove = new Set();
+    for (const { idx, skillId, tokens } of droppableIndices) {
+        if (currentTokens <= config.maxTokens)
+            break;
+        indicesToRemove.add(idx);
+        currentTokens -= tokens;
+        if (!result.droppedSkills.includes(skillId)) {
+            result.droppedSkills.push(skillId);
+        }
+    }
+    // Step 2: Drop oldest unprotected non-skill messages
+    for (let i = 0; i < result.messages.length && currentTokens > config.maxTokens; i++) {
+        if (!protectedIndices.has(i) && !indicesToRemove.has(i) && !(0, internal_types_1.isDroppable)(result.messages[i])) {
+            indicesToRemove.add(i);
+            currentTokens -= config.estimateTokens([result.messages[i]]);
+        }
+    }
+    // Apply removals
+    if (indicesToRemove.size > 0) {
+        const droppedSkillCount = droppableIndices.filter(d => indicesToRemove.has(d.idx)).length;
+        const droppedNonSkillCount = indicesToRemove.size - droppedSkillCount;
+        result.messages = result.messages.filter((_, idx) => !indicesToRemove.has(idx));
+        result.droppedMessages = droppedNonSkillCount;
+    }
+    // Step 3: Check if still over budget
+    currentTokens = config.estimateTokens(result.messages);
+    if (currentTokens > config.maxTokens) {
+        result.recommendation = `Reduce system prompt or decrease skill count. Current: ${currentTokens}, Max: ${config.maxTokens}`;
+        throw new ContextOverflowError(currentTokens, config.maxTokens, result.recommendation);
+    }
+    if (result.droppedSkills.length > 0 || result.droppedMessages > 0) {
+        result.recommendation = `Dropped ${result.droppedSkills.length} skills and ${result.droppedMessages} messages to fit context.`;
+    }
+    return result;
+}
+/**
+ * Build tool call/result pairs.
+ * Returns pairs and orphan call IDs.
+ */
+function buildToolPairs(messages) {
+    const toolPairs = [];
+    const orphanCalls = [];
+    messages.forEach((msg, idx) => {
+        if (msg.role === 'assistant' && msg.tool_calls) {
+            for (const call of msg.tool_calls) {
+                // Find matching result
+                const resultIdx = messages.findIndex((m, i) => i > idx && m.role === 'tool' && m.tool_call_id === call.id);
+                if (resultIdx !== -1) {
+                    toolPairs.push({
+                        callMessageIndex: idx,
+                        callId: call.id,
+                        resultMessageIndex: resultIdx,
+                    });
+                }
+                else {
+                    // Orphan call - keep but warn
+                    orphanCalls.push(call.id);
+                    toolPairs.push({
+                        callMessageIndex: idx,
+                        callId: call.id,
+                        resultMessageIndex: null,
+                    });
+                }
+            }
+        }
+    });
+    return { toolPairs, orphanCalls };
+}
+//# sourceMappingURL=memory-node.js.map

package/dist/ai/nodes/memory-node.js.map

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

package/dist/ai/nodes/memory-node.mjs

@@ -0,0 +1,158 @@
+/**
+ * Memory Node - Context Compaction with deterministic fallback.
+ *
+ * Fallback order:
+ * 1. Drop low-priority skill messages (_meta.droppable)
+ * 2. Drop oldest unprotected messages
+ * 3. Throw ContextOverflowError
+ */
+import { isDroppable, getSkillId } from '../internal-types.mjs';
+/** Context overflow error */
+export class ContextOverflowError extends Error {
+    constructor(currentTokens, maxTokens, recommendation) {
+        super(`Context overflow: ${currentTokens} tokens exceeds max ${maxTokens}. ${recommendation}`);
+        this.currentTokens = currentTokens;
+        this.maxTokens = maxTokens;
+        this.recommendation = recommendation;
+        this.name = 'ContextOverflowError';
+    }
+}
+/**
+ * Compact messages to fit within token budget.
+ * Implements deterministic fallback: droppable skills → old messages → error
+ *
+ * Key feature: recognizes _meta.droppable messages (skill-injected) for selective removal.
+ */
+export function compactMessages(messages, config, injectedSkills = []) {
+    const result = {
+        messages: [...messages],
+        occurred: false,
+        droppedSkills: [],
+        droppedMessages: 0,
+        orphanToolCalls: [],
+        recommendation: undefined,
+    };
+    // Check if compaction needed
+    let currentTokens = config.estimateTokens(result.messages);
+    if (currentTokens <= config.maxTokens) {
+        return result;
+    }
+    result.occurred = true;
+    // Build tool pairs (must be kept together)
+    const { toolPairs, orphanCalls } = buildToolPairs(result.messages);
+    result.orphanToolCalls = orphanCalls;
+    // Identify protected indices
+    const protectedIndices = new Set();
+    // Non-droppable system messages are protected
+    result.messages.forEach((msg, idx) => {
+        if (msg.role === 'system' && !isDroppable(msg)) {
+            protectedIndices.add(idx);
+        }
+    });
+    // Tool pairs are protected
+    for (const pair of toolPairs) {
+        protectedIndices.add(pair.callMessageIndex);
+        if (pair.resultMessageIndex !== null) {
+            protectedIndices.add(pair.resultMessageIndex);
+        }
+    }
+    // Last user message is protected
+    for (let i = result.messages.length - 1; i >= 0; i--) {
+        if (result.messages[i].role === 'user') {
+            protectedIndices.add(i);
+            break;
+        }
+    }
+    // Step 1: Drop droppable skill messages (lowest priority first)
+    // Collect all droppable messages with their skill IDs
+    const droppableIndices = [];
+    result.messages.forEach((msg, idx) => {
+        if (isDroppable(msg)) {
+            const skillId = getSkillId(msg);
+            if (skillId) {
+                droppableIndices.push({
+                    idx,
+                    skillId,
+                    tokens: config.estimateTokens([msg]),
+                });
+            }
+        }
+    });
+    // Sort by priority (using injectedSkills order) - lowest priority first
+    const skillPriorityMap = new Map();
+    injectedSkills.forEach((skill, i) => skillPriorityMap.set(skill.name, i));
+    droppableIndices.sort((a, b) => {
+        const priorityA = skillPriorityMap.get(a.skillId) ?? 0;
+        const priorityB = skillPriorityMap.get(b.skillId) ?? 0;
+        return priorityA - priorityB; // Lower priority (earlier in list) dropped first
+    });
+    // Drop droppable messages until under budget
+    const indicesToRemove = new Set();
+    for (const { idx, skillId, tokens } of droppableIndices) {
+        if (currentTokens <= config.maxTokens)
+            break;
+        indicesToRemove.add(idx);
+        currentTokens -= tokens;
+        if (!result.droppedSkills.includes(skillId)) {
+            result.droppedSkills.push(skillId);
+        }
+    }
+    // Step 2: Drop oldest unprotected non-skill messages
+    for (let i = 0; i < result.messages.length && currentTokens > config.maxTokens; i++) {
+        if (!protectedIndices.has(i) && !indicesToRemove.has(i) && !isDroppable(result.messages[i])) {
+            indicesToRemove.add(i);
+            currentTokens -= config.estimateTokens([result.messages[i]]);
+        }
+    }
+    // Apply removals
+    if (indicesToRemove.size > 0) {
+        const droppedSkillCount = droppableIndices.filter(d => indicesToRemove.has(d.idx)).length;
+        const droppedNonSkillCount = indicesToRemove.size - droppedSkillCount;
+        result.messages = result.messages.filter((_, idx) => !indicesToRemove.has(idx));
+        result.droppedMessages = droppedNonSkillCount;
+    }
+    // Step 3: Check if still over budget
+    currentTokens = config.estimateTokens(result.messages);
+    if (currentTokens > config.maxTokens) {
+        result.recommendation = `Reduce system prompt or decrease skill count. Current: ${currentTokens}, Max: ${config.maxTokens}`;
+        throw new ContextOverflowError(currentTokens, config.maxTokens, result.recommendation);
+    }
+    if (result.droppedSkills.length > 0 || result.droppedMessages > 0) {
+        result.recommendation = `Dropped ${result.droppedSkills.length} skills and ${result.droppedMessages} messages to fit context.`;
+    }
+    return result;
+}
+/**
+ * Build tool call/result pairs.
+ * Returns pairs and orphan call IDs.
+ */
+export function buildToolPairs(messages) {
+    const toolPairs = [];
+    const orphanCalls = [];
+    messages.forEach((msg, idx) => {
+        if (msg.role === 'assistant' && msg.tool_calls) {
+            for (const call of msg.tool_calls) {
+                // Find matching result
+                const resultIdx = messages.findIndex((m, i) => i > idx && m.role === 'tool' && m.tool_call_id === call.id);
+                if (resultIdx !== -1) {
+                    toolPairs.push({
+                        callMessageIndex: idx,
+                        callId: call.id,
+                        resultMessageIndex: resultIdx,
+                    });
+                }
+                else {
+                    // Orphan call - keep but warn
+                    orphanCalls.push(call.id);
+                    toolPairs.push({
+                        callMessageIndex: idx,
+                        callId: call.id,
+                        resultMessageIndex: null,
+                    });
+                }
+            }
+        }
+    });
+    return { toolPairs, orphanCalls };
+}
+//# sourceMappingURL=memory-node.js.map