agentx-sdk 0.1.0

package/dist/core/react-loop.js

@@ -0,0 +1,403 @@
+import { createInitialState } from './loop-types.js';
+import { StreamingToolExecutor } from './streaming-tool-executor.js';
+import { microcompact } from './compaction/microcompact.js';
+import { applyToolResultBudget } from './compaction/tool-result-budget.js';
+import { snipCompact } from './compaction/snip-compact.js';
+import { autocompact } from './compaction/autocompact.js';
+import { runStopHooks } from './stop-hooks.js';
+import { PromptTooLongError, OverloadedError, InsufficientCreditsError, classifyAPIError } from '../llm/errors.js';
+import { SKILL_TOOL_NAME } from '../tools/skill-tool.js';
+import { normalizeMessagesForAPI } from './message-normalize.js';
+const MAX_OUTPUT_TOKENS_RECOVERY_LIMIT = 3;
+const MAX_BUDGET_CONTINUATIONS = 4;
+const MIN_DELTA_TOKENS = 50;
+const DEFAULT_MAX_TOOL_RESULT_CHARS = 10_000;
+const DEFAULT_COMPACTION_THRESHOLD = 0.8;
+const DEFAULT_TAIL_PROTECTION = 4;
+/**
+ * ReAct loop as AsyncGenerator.
+ * Yields AgentEvent, returns Terminal.
+ * State is immutable — replaced atomically at each continue site.
+ */
+export async function* executeReactLoop(initialMessages, config) {
+    const { client, toolExecutor, maxIterations, maxConsecutiveErrors, onToolError, costPolicy, signal, maxContextTokens, compactionThreshold, fallbackModel, maxOutputTokens, escalatedMaxOutputTokens, stopHooks, deps, tokenBudget, } = config;
+    let currentModel = config.model;
+    const usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+    const toolDefs = toolExecutor.listTools().length > 0 ? toolExecutor.getToolDefinitions() : undefined;
+    // DI: use injected callModel or default to client.streamChat
+    const callModel = deps?.callModel ?? ((params) => client.streamChat(params));
+    // Token budget continuation tracking
+    let budgetContinuationCount = 0;
+    let cumulativeOutputTokens = 0;
+    let state = createInitialState([...initialMessages]);
+    while (true) {
+        const { messages, turnCount, consecutiveErrors } = state;
+        // --- Check abort ---
+        if (signal?.aborted) {
+            return { reason: 'abort', usage };
+        }
+        // --- Check cost policy ---
+        if (costPolicy?.maxTokensPerExecution && usage.totalTokens >= costPolicy.maxTokensPerExecution) {
+            if (costPolicy.onLimitReached === 'stop') {
+                return { reason: 'cost_limit', usage };
+            }
+            yield { type: 'warning', message: 'Token limit approaching', code: 'cost_warning' };
+        }
+        // --- Check max iterations ---
+        if (turnCount > maxIterations) {
+            yield { type: 'warning', message: 'Max iterations reached', code: 'max_iterations' };
+            return { reason: 'max_iterations', usage };
+        }
+        // --- Compaction pipeline (before LLM call) ---
+        let compactedMessages = [...messages];
+        // 0. Tool result budget — aggregate truncation (largest first)
+        if (maxContextTokens) {
+            const budgetChars = Math.floor(maxContextTokens * 4 * 0.5); // 50% of context in chars
+            const budgetResult = applyToolResultBudget(compactedMessages, { maxTotalToolResultChars: budgetChars });
+            if (budgetResult.truncatedCount > 0) {
+                compactedMessages = budgetResult.messages;
+            }
+        }
+        // 0.5. Snip compact — remove orphaned early tool results
+        const snipResult = snipCompact(compactedMessages, { tailProtection: DEFAULT_TAIL_PROTECTION });
+        if (snipResult.snippedCount > 0) {
+            compactedMessages = snipResult.messages;
+        }
+        // 1. Microcompact — truncate large tool results (with per-tool overrides)
+        const perToolMaxChars = new Map();
+        for (const tool of toolExecutor.listTools()) {
+            if (tool.maxResultChars !== undefined) {
+                perToolMaxChars.set(tool.name, tool.maxResultChars);
+            }
+        }
+        // Build tool_call_id → tool_name map from assistant messages in history
+        const toolCallIdToName = new Map();
+        for (const msg of compactedMessages) {
+            if (msg.role === 'assistant' && msg.tool_calls) {
+                for (const tc of msg.tool_calls) {
+                    toolCallIdToName.set(tc.id, tc.function.name);
+                }
+            }
+        }
+        const microResult = microcompact(compactedMessages, {
+            maxToolResultChars: DEFAULT_MAX_TOOL_RESULT_CHARS,
+            perToolMaxChars: perToolMaxChars.size > 0 ? perToolMaxChars : undefined,
+            toolCallIdToName: toolCallIdToName.size > 0 ? toolCallIdToName : undefined,
+        });
+        if (microResult.truncatedCount > 0) {
+            compactedMessages = microResult.messages;
+            yield { type: 'compaction', strategy: 'microcompact', tokensFreed: 0 };
+        }
+        // 2. Autocompact — summarize if threshold exceeded
+        if (maxContextTokens) {
+            const autoResult = await autocompact(compactedMessages, client, {
+                maxContextTokens,
+                compactionThreshold: compactionThreshold ?? DEFAULT_COMPACTION_THRESHOLD,
+                tailProtection: DEFAULT_TAIL_PROTECTION,
+            });
+            if (autoResult) {
+                compactedMessages = autoResult.messages;
+                yield { type: 'compaction', strategy: 'autocompact', tokensFreed: autoResult.tokensFreed };
+            }
+        }
+        // --- Turn start ---
+        yield { type: 'turn_start', iteration: turnCount - 1 };
+        let fullText = '';
+        let finishReason = '';
+        let turnOutputTokens = 0;
+        const toolCalls = [];
+        const earlyToolResults = []; // Tool results completed during streaming
+        // --- Stream from LLM ---
+        const streamingExecutor = new StreamingToolExecutor(toolExecutor, signal);
+        const effectiveMaxTokens = state.maxOutputTokensOverride ?? maxOutputTokens;
+        try {
+            // Normalize messages before API call (remove orphaned tool results/calls, empty messages)
+            const normalizedMessages = normalizeMessagesForAPI(compactedMessages);
+            for await (const chunk of callModel({
+                messages: normalizedMessages,
+                tools: toolDefs,
+                model: currentModel,
+                signal,
+                maxTokens: effectiveMaxTokens,
+            })) {
+                switch (chunk.type) {
+                    case 'content':
+                        fullText += chunk.data;
+                        yield { type: 'text_delta', content: chunk.data };
+                        break;
+                    case 'tool_call':
+                        toolCalls.push({ id: chunk.id, name: chunk.name, arguments: chunk.arguments });
+                        yield {
+                            type: 'tool_call_start',
+                            toolCall: { id: chunk.id, type: 'function', function: { name: chunk.name, arguments: chunk.arguments } },
+                        };
+                        streamingExecutor.addTool(chunk.id, chunk.name, chunk.arguments);
+                        break;
+                    case 'done':
+                        finishReason = chunk.finishReason;
+                        if (chunk.usage) {
+                            usage.inputTokens += chunk.usage.inputTokens;
+                            usage.outputTokens += chunk.usage.outputTokens;
+                            usage.totalTokens += chunk.usage.totalTokens;
+                            turnOutputTokens = chunk.usage.outputTokens;
+                        }
+                        break;
+                }
+                // Yield progress events from tools executing during streaming
+                for (const progress of streamingExecutor.getProgressEvents()) {
+                    yield { type: 'tool_progress', toolCallId: progress.toolCallId, toolName: progress.toolName, data: progress.data };
+                }
+                // Yield completed tool results during streaming and collect for message history
+                for (const completed of streamingExecutor.getCompletedResults()) {
+                    yield { type: 'tool_call_end', toolCallId: completed.id, result: completed.result, duration: completed.duration };
+                    earlyToolResults.push({ role: 'tool', content: completed.result.content, tool_call_id: completed.id });
+                    if (completed.result.isError && onToolError === 'stop') {
+                        yield { type: 'turn_end', iteration: turnCount - 1, hasToolCalls: true };
+                        return { reason: 'error', usage };
+                    }
+                }
+            }
+            // --- Build assistant message ---
+            const assistantMessage = { role: 'assistant', content: fullText };
+            if (toolCalls.length > 0) {
+                assistantMessage.tool_calls = toolCalls.map(tc => ({
+                    id: tc.id,
+                    type: 'function',
+                    function: { name: tc.name, arguments: tc.arguments },
+                }));
+            }
+            // --- Max Output Tokens Recovery (two steps: escalate first, then resume) ---
+            if (finishReason === 'length' && toolCalls.length === 0) {
+                // Step 1: Escalate maxTokens (retry same request with higher limit)
+                if (escalatedMaxOutputTokens &&
+                    state.maxOutputTokensOverride === undefined) {
+                    yield { type: 'recovery', reason: 'max_output_tokens_escalate', attempt: 1 };
+                    state = {
+                        ...state,
+                        maxOutputTokensOverride: escalatedMaxOutputTokens,
+                        transition: { reason: 'max_output_tokens_escalate' },
+                    };
+                    continue;
+                }
+                // Step 2: Multi-turn recovery (inject resume message)
+                const recoveryCount = state.maxOutputTokensRecoveryCount + 1;
+                if (recoveryCount > MAX_OUTPUT_TOKENS_RECOVERY_LIMIT) {
+                    if (fullText)
+                        yield { type: 'text_done', content: fullText };
+                    yield { type: 'turn_end', iteration: turnCount - 1, hasToolCalls: false };
+                    return { reason: 'max_output_tokens', usage };
+                }
+                yield { type: 'recovery', reason: 'max_output_tokens_recovery', attempt: recoveryCount };
+                const resumeMessage = {
+                    role: 'user',
+                    content: '[System: Your response was truncated. Resume directly from where you stopped — no recap, no repetition.]',
+                };
+                state = {
+                    ...state,
+                    messages: [...messages, assistantMessage, resumeMessage],
+                    maxOutputTokensRecoveryCount: recoveryCount,
+                    transition: { reason: 'max_output_tokens_recovery' },
+                };
+                continue;
+            }
+            // --- No tool calls → check stop hooks + budget continuation ---
+            if (toolCalls.length === 0) {
+                // Run stop hooks (if any)
+                if (stopHooks && stopHooks.length > 0) {
+                    const hookResult = await runStopHooks(stopHooks, {
+                        messages,
+                        assistantText: fullText,
+                        turnCount,
+                    });
+                    if (hookResult.preventContinuation) {
+                        if (fullText)
+                            yield { type: 'text_done', content: fullText };
+                        yield { type: 'turn_end', iteration: turnCount - 1, hasToolCalls: false };
+                        return { reason: 'stop_hook', usage };
+                    }
+                    if (hookResult.blockingErrors.length > 0) {
+                        yield { type: 'recovery', reason: 'stop_hook_blocking', attempt: 1 };
+                        const errorMessages = hookResult.blockingErrors.map(err => ({
+                            role: 'user',
+                            content: `[Stop hook error: ${err}]`,
+                        }));
+                        state = {
+                            ...state,
+                            messages: [...messages, assistantMessage, ...errorMessages],
+                            turnCount: turnCount + 1,
+                            transition: { reason: 'stop_hook_blocking' },
+                        };
+                        continue;
+                    }
+                }
+                // Token budget continuation
+                if (tokenBudget) {
+                    cumulativeOutputTokens += turnOutputTokens;
+                    const outputThreshold = tokenBudget.total * tokenBudget.outputThreshold;
+                    const belowThreshold = cumulativeOutputTokens < outputThreshold;
+                    const notExhausted = budgetContinuationCount < MAX_BUDGET_CONTINUATIONS;
+                    const notDiminishing = turnOutputTokens >= MIN_DELTA_TOKENS || budgetContinuationCount === 0;
+                    if (belowThreshold && notExhausted && notDiminishing) {
+                        budgetContinuationCount++;
+                        yield { type: 'recovery', reason: 'token_budget_continuation', attempt: budgetContinuationCount };
+                        const nudgeMessage = {
+                            role: 'user',
+                            content: '[System: Continue working. You still have budget remaining.]',
+                        };
+                        state = {
+                            ...state,
+                            messages: [...messages, assistantMessage, nudgeMessage],
+                            turnCount: turnCount + 1,
+                            transition: { reason: 'token_budget_continuation' },
+                        };
+                        continue;
+                    }
+                }
+                // Normal completion
+                if (fullText)
+                    yield { type: 'text_done', content: fullText };
+                yield { type: 'turn_end', iteration: turnCount - 1, hasToolCalls: false };
+                return { reason: 'stop', usage };
+            }
+            // --- Collect remaining tool results (include early results from streaming phase) ---
+            const toolResultMessages = [...earlyToolResults];
+            let hasToolError = false;
+            const touchedFilePaths = [];
+            // Drain remaining progress events
+            for (const progress of streamingExecutor.getProgressEvents()) {
+                yield { type: 'tool_progress', toolCallId: progress.toolCallId, toolName: progress.toolName, data: progress.data };
+            }
+            for await (const completed of streamingExecutor.getRemainingResults()) {
+                yield { type: 'tool_call_end', toolCallId: completed.id, result: completed.result, duration: completed.duration };
+                if (completed.result.isError && onToolError === 'stop') {
+                    toolResultMessages.push({ role: 'tool', content: completed.result.content, tool_call_id: completed.id });
+                    yield { type: 'turn_end', iteration: turnCount - 1, hasToolCalls: true };
+                    return { reason: 'error', usage };
+                }
+                if (completed.result.isError)
+                    hasToolError = true;
+                // Pin skill tool results so they survive compaction
+                const toolResultMsg = { role: 'tool', content: completed.result.content, tool_call_id: completed.id };
+                if (completed.name === SKILL_TOOL_NAME) {
+                    toolResultMsg._pinned = true;
+                }
+                toolResultMessages.push(toolResultMsg);
+                // Extract file paths for conditional skill activation
+                if (config.onFilePathsTouched) {
+                    const toolDef = toolExecutor.listTools().find(t => t.name === completed.name);
+                    if (toolDef?.getFilePath) {
+                        const tc = toolCalls.find(c => c.id === completed.id);
+                        if (tc) {
+                            try {
+                                const parsed = JSON.parse(tc.arguments);
+                                const paths = toolDef.getFilePath(parsed);
+                                if (paths) {
+                                    const arr = Array.isArray(paths) ? paths : [paths];
+                                    touchedFilePaths.push(...arr);
+                                }
+                            }
+                            catch { /* parse error — skip */ }
+                        }
+                    }
+                    // Also check metadata.filePaths
+                    const metaPaths = completed.result.metadata?.filePaths;
+                    if (Array.isArray(metaPaths)) {
+                        touchedFilePaths.push(...metaPaths.filter((p) => typeof p === 'string'));
+                    }
+                }
+            }
+            // --- Conditional skill activation from file operations ---
+            if (config.onFilePathsTouched && touchedFilePaths.length > 0) {
+                const activated = config.onFilePathsTouched(touchedFilePaths);
+                for (const skillName of activated) {
+                    yield { type: 'skill_activated', skillName };
+                }
+            }
+            // --- onToolError: 'retry' — re-run LLM turn so model can correct its args ---
+            if (hasToolError && onToolError === 'retry' && state.toolRetryCount < 1) {
+                yield { type: 'recovery', reason: 'tool_retry', attempt: state.toolRetryCount + 1 };
+                state = {
+                    ...state,
+                    messages: [...messages, assistantMessage, ...toolResultMessages],
+                    turnCount: turnCount + 1,
+                    consecutiveErrors: 0,
+                    toolRetryCount: state.toolRetryCount + 1,
+                    transition: { reason: 'next_turn' },
+                };
+                continue;
+            }
+            yield { type: 'turn_end', iteration: turnCount - 1, hasToolCalls: true };
+            // --- Continue site: next_turn ---
+            state = {
+                ...state,
+                messages: [...messages, assistantMessage, ...toolResultMessages],
+                turnCount: turnCount + 1,
+                consecutiveErrors: 0,
+                transition: { reason: 'next_turn' },
+            };
+            continue;
+        }
+        catch (error) {
+            const classified = classifyAPIError(error);
+            // --- PTL Recovery (413) ---
+            if (classified instanceof PromptTooLongError && !state.hasAttemptedCompaction) {
+                if (maxContextTokens) {
+                    // Use original messages from state (not compactedMessages which may already be compacted)
+                    const compactResult = await autocompact([...messages], client, {
+                        maxContextTokens,
+                        compactionThreshold: 0.1, // Force compaction
+                        tailProtection: DEFAULT_TAIL_PROTECTION,
+                    });
+                    if (compactResult) {
+                        yield { type: 'recovery', reason: 'reactive_compact_retry', attempt: 1 };
+                        yield { type: 'compaction', strategy: 'autocompact', tokensFreed: compactResult.tokensFreed };
+                        state = {
+                            ...state,
+                            messages: compactResult.messages,
+                            hasAttemptedCompaction: true,
+                            transition: { reason: 'reactive_compact_retry' },
+                        };
+                        continue;
+                    }
+                }
+                return { reason: 'prompt_too_long', usage };
+            }
+            if (classified instanceof PromptTooLongError) {
+                return { reason: 'prompt_too_long', usage };
+            }
+            // --- Insufficient Credits (402) — non-recoverable ---
+            if (classified instanceof InsufficientCreditsError) {
+                yield { type: 'error', error: classified, recoverable: false };
+                return { reason: 'error', usage, error: classified };
+            }
+            // --- Model Fallback (529/503) ---
+            if (classified instanceof OverloadedError && fallbackModel && currentModel !== fallbackModel) {
+                yield { type: 'model_fallback', from: currentModel, to: fallbackModel };
+                currentModel = fallbackModel;
+                state = {
+                    ...state,
+                    transition: { reason: 'model_fallback' },
+                };
+                continue;
+            }
+            // --- Generic error recovery ---
+            const newConsecutiveErrors = consecutiveErrors + 1;
+            const actualError = classified instanceof Error ? classified : new Error(String(classified));
+            yield {
+                type: 'error',
+                error: actualError,
+                recoverable: newConsecutiveErrors < maxConsecutiveErrors,
+            };
+            if (newConsecutiveErrors >= maxConsecutiveErrors) {
+                return { reason: 'error', usage, error: actualError };
+            }
+            state = {
+                ...state,
+                consecutiveErrors: newConsecutiveErrors,
+                transition: undefined,
+            };
+            continue;
+        }
+    }
+}
+//# sourceMappingURL=react-loop.js.map

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

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

package/dist/core/stop-hooks.d.ts

@@ -0,0 +1,18 @@
+import type { OpenRouterMessage } from '../llm/message-types.js';
+export interface StopHookContext {
+    messages: readonly OpenRouterMessage[];
+    assistantText: string;
+    turnCount: number;
+}
+export interface StopHookResult {
+    blockingErrors: string[];
+    preventContinuation: boolean;
+}
+/** A hook that runs when the model produces a final response (no tool calls) */
+export interface StopHook {
+    name: string;
+    execute(context: StopHookContext): Promise<StopHookResult>;
+}
+/** Run all stop hooks, merge results */
+export declare function runStopHooks(hooks: StopHook[], context: StopHookContext): Promise<StopHookResult>;
+//# sourceMappingURL=stop-hooks.d.ts.map

package/dist/core/stop-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-hooks.d.ts","sourceRoot":"","sources":["../../src/core/stop-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5D;AAED,wCAAwC;AACxC,wBAAsB,YAAY,CAChC,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAezB"}

package/dist/core/stop-hooks.js

@@ -0,0 +1,18 @@
+/** Run all stop hooks, merge results */
+export async function runStopHooks(hooks, context) {
+    const allErrors = [];
+    let preventContinuation = false;
+    for (const hook of hooks) {
+        try {
+            const result = await hook.execute(context);
+            allErrors.push(...result.blockingErrors);
+            if (result.preventContinuation)
+                preventContinuation = true;
+        }
+        catch {
+            // Stop hooks should not break the loop
+        }
+    }
+    return { blockingErrors: allErrors, preventContinuation };
+}
+//# sourceMappingURL=stop-hooks.js.map

package/dist/core/stop-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-hooks.js","sourceRoot":"","sources":["../../src/core/stop-hooks.ts"],"names":[],"mappings":"AAmBA,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAiB,EACjB,OAAwB;IAExB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3C,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;YACzC,IAAI,MAAM,CAAC,mBAAmB;gBAAE,mBAAmB,GAAG,IAAI,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;AAC5D,CAAC"}

package/dist/core/stream-emitter.d.ts

@@ -0,0 +1,24 @@
+import type { AgentEvent } from '../contracts/entities/agent-event.js';
+/**
+ * Async push/pull channel with bounded queue and backpressure for AgentEvents.
+ */
+export declare class StreamEmitter {
+    private readonly queue;
+    private readonly maxQueueSize;
+    private resolve;
+    private done;
+    constructor(maxQueueSize?: number);
+    /**
+     * Push an event into the channel.
+     */
+    emit(event: AgentEvent): void;
+    /**
+     * Close the channel — no more events will be emitted.
+     */
+    close(): void;
+    /**
+     * Returns an AsyncIterableIterator for consuming events.
+     */
+    iterator(): AsyncIterableIterator<AgentEvent>;
+}
+//# sourceMappingURL=stream-emitter.d.ts.map

package/dist/core/stream-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-emitter.d.ts","sourceRoot":"","sources":["../../src/core/stream-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAEvE;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,OAAO,CAA8D;IAC7E,OAAO,CAAC,IAAI,CAAS;gBAET,YAAY,SAAO;IAI/B;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAc7B;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,QAAQ,IAAI,qBAAqB,CAAC,UAAU,CAAC;CAuB9C"}

package/dist/core/stream-emitter.js

@@ -0,0 +1,65 @@
+/**
+ * Async push/pull channel with bounded queue and backpressure for AgentEvents.
+ */
+export class StreamEmitter {
+    queue = [];
+    maxQueueSize;
+    resolve = null;
+    done = false;
+    constructor(maxQueueSize = 1000) {
+        this.maxQueueSize = maxQueueSize;
+    }
+    /**
+     * Push an event into the channel.
+     */
+    emit(event) {
+        if (this.done)
+            return;
+        if (this.resolve) {
+            // Consumer is waiting — deliver directly
+            const r = this.resolve;
+            this.resolve = null;
+            r({ value: event, done: false });
+        }
+        else if (this.queue.length < this.maxQueueSize) {
+            this.queue.push(event);
+        }
+        // If queue is full, drop event (backpressure)
+    }
+    /**
+     * Close the channel — no more events will be emitted.
+     */
+    close() {
+        this.done = true;
+        if (this.resolve) {
+            const r = this.resolve;
+            this.resolve = null;
+            r({ value: undefined, done: true });
+        }
+    }
+    /**
+     * Returns an AsyncIterableIterator for consuming events.
+     */
+    iterator() {
+        const self = this;
+        return {
+            next() {
+                // Drain queue first
+                if (self.queue.length > 0) {
+                    return Promise.resolve({ value: self.queue.shift(), done: false });
+                }
+                if (self.done) {
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                // Wait for next emit
+                return new Promise(resolve => {
+                    self.resolve = resolve;
+                });
+            },
+            [Symbol.asyncIterator]() {
+                return this;
+            },
+        };
+    }
+}
+//# sourceMappingURL=stream-emitter.js.map

package/dist/core/stream-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-emitter.js","sourceRoot":"","sources":["../../src/core/stream-emitter.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,aAAa;IACP,KAAK,GAAiB,EAAE,CAAC;IACzB,YAAY,CAAS;IAC9B,OAAO,GAAyD,IAAI,CAAC;IACrE,IAAI,GAAG,KAAK,CAAC;IAErB,YAAY,YAAY,GAAG,IAAI;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAiB;QACpB,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO;QAEtB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,yCAAyC;YACzC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,8CAA8C;IAChD,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,CAAC,CAAC,EAAE,KAAK,EAAE,SAAkC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,OAAO;YACL,IAAI;gBACF,oBAAoB;gBACpB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACtE,CAAC;gBAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACd,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAkC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpF,CAAC;gBAED,qBAAqB;gBACrB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;oBAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;gBACzB,CAAC,CAAC,CAAC;YACL,CAAC;YACD,CAAC,MAAM,CAAC,aAAa,CAAC;gBACpB,OAAO,IAAI,CAAC;YACd,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/core/streaming-tool-executor.d.ts

@@ -0,0 +1,54 @@
+import type { ToolExecutor } from '../tools/tool-executor.js';
+import type { AgentToolResult } from '../contracts/entities/tool-call.js';
+export interface ToolExecutionResult {
+    id: string;
+    name: string;
+    result: AgentToolResult;
+    duration: number;
+}
+export interface ToolProgressInfo {
+    toolCallId: string;
+    toolName: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Executes tools while the LLM is still streaming.
+ * Respects concurrency safety: safe tools run in parallel, unsafe tools run alone.
+ * Results are always yielded in submission order.
+ * Supports progress callbacks — tools can report incremental updates.
+ */
+export declare class StreamingToolExecutor {
+    private readonly tools;
+    private readonly executor;
+    private readonly signal?;
+    private processing;
+    /** Accumulated progress events from all tools (drained by getProgressEvents) */
+    private pendingProgress;
+    constructor(executor: ToolExecutor, signal?: AbortSignal);
+    /** Called during LLM streaming when a tool_call chunk arrives */
+    addTool(id: string, name: string, args: string): void;
+    /**
+     * Non-blocking: yields completed results in submission order.
+     * Call during streaming to drain finished tools without waiting.
+     */
+    getCompletedResults(): Generator<ToolExecutionResult>;
+    /**
+     * Non-blocking: drains accumulated progress events from all tools.
+     * Call during streaming alongside getCompletedResults().
+     */
+    getProgressEvents(): Generator<ToolProgressInfo>;
+    /**
+     * Blocking: waits for all remaining tools to complete, yielding in order.
+     * Call after streaming ends.
+     */
+    getRemainingResults(): AsyncGenerator<ToolExecutionResult>;
+    /**
+     * Process the queue respecting concurrency rules:
+     * - Multiple consecutive safe tools can execute in parallel
+     * - An unsafe tool must execute alone (waits for all prior to finish)
+     */
+    private processQueue;
+    private startTool;
+    private executeTool;
+}
+//# sourceMappingURL=streaming-tool-executor.d.ts.map

package/dist/core/streaming-tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-tool-executor.d.ts","sourceRoot":"","sources":["../../src/core/streaming-tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAgBD;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAc;IACtC,OAAO,CAAC,UAAU,CAAS;IAC3B,gFAAgF;IAChF,OAAO,CAAC,eAAe,CAA0B;gBAErC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW;IAKxD,iEAAiE;IACjE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAgBrD;;;OAGG;IACF,mBAAmB,IAAI,SAAS,CAAC,mBAAmB,CAAC;IAgBtD;;;OAGG;IACF,iBAAiB,IAAI,SAAS,CAAC,gBAAgB,CAAC;IAMjD;;;OAGG;IACI,mBAAmB,IAAI,cAAc,CAAC,mBAAmB,CAAC;IAkBjE;;;;OAIG;YACW,YAAY;IAgC1B,OAAO,CAAC,SAAS;YAKH,WAAW;CAkC1B"}