@amodalai/runtime 0.1.26 → 0.2.1

package/dist/src/agent/states/dispatching.js.map

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

package/dist/src/agent/states/executing.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { SSEEvent } from '../../types.js';
+import type { ToolDefinition } from '../../tools/types.js';
+import type { ExecutingState, AgentContext, TransitionResult, ToolCall, ToolResult } from '../loop-types.js';
+/**
+ * Handle the EXECUTING state — execute a single tool call.
+ */
+export declare function handleExecuting(state: ExecutingState, ctx: AgentContext): Promise<TransitionResult>;
+/**
+ * Execute a tool call, building the ToolContext from the AgentContext.
+ * Enforces a timeout via AbortSignal to prevent hanging on broken tools.
+ */
+export declare function executeTool(call: ToolCall, toolDef: ToolDefinition, ctx: AgentContext): Promise<unknown>;
+/**
+ * After a tool result: append to messages, then continue to next call or back to THINKING.
+ */
+export declare function nextAfterToolResult(state: ExecutingState, result: ToolResult, effects: SSEEvent[], ctx: AgentContext): TransitionResult;

package/dist/src/agent/states/executing.js

@@ -0,0 +1,452 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { SSEEventType } from '../../types.js';
+import { estimateTokenCount } from '../token-estimate.js';
+import { DISPATCH_TOOL_NAME } from '../../tools/dispatch-tool.js';
+/**
+ * Handle the EXECUTING state — execute a single tool call.
+ */
+export async function handleExecuting(state, ctx) {
+    const { current, queue } = state;
+    const effects = [];
+    const timestamp = new Date().toISOString();
+    // 1. Look up the tool
+    const toolDef = ctx.toolRegistry.get(current.toolName);
+    if (!toolDef) {
+        const result = {
+            callId: current.toolCallId,
+            toolName: current.toolName,
+            status: 'error',
+            content: `Tool "${current.toolName}" not found. Available tools: ${ctx.toolRegistry.names().join(', ')}`,
+        };
+        ctx.logger.warn('tool_not_found', {
+            tool: current.toolName,
+            session: ctx.sessionId,
+        });
+        return nextAfterToolResult(state, result, effects, ctx);
+    }
+    // 2. Validate args against schema (cheap guard against hallucinated params)
+    //    Only for Zod schemas — FlexibleSchema (MCP/custom tools) uses jsonSchema()
+    //    which is validated by the AI SDK at the provider level.
+    if ('safeParse' in toolDef.parameters) {
+        const validation = toolDef.parameters.safeParse(current.args);
+        if (!validation.success) {
+            const result = {
+                callId: current.toolCallId,
+                toolName: current.toolName,
+                status: 'error',
+                content: `Invalid parameters: ${validation.error.message}`,
+            };
+            ctx.logger.warn('tool_args_invalid', {
+                tool: current.toolName,
+                callId: current.toolCallId,
+                session: ctx.sessionId,
+                errors: validation.error.issues,
+            });
+            return nextAfterToolResult(state, result, effects, ctx);
+        }
+    }
+    // 3a. Tool-level confirmation gate — applies to any tool that sets
+    //     `requiresConfirmation: true`. Routes through CONFIRMING on the first
+    //     call; subsequent passes (after user approval) are tracked in
+    //     `ctx.confirmedCallIds` to avoid an infinite EXECUTING → CONFIRMING
+    //     loop. Connection tools handle confirmation via their ACL path below
+    //     and should leave this flag undefined.
+    if (toolDef.requiresConfirmation && !ctx.confirmedCallIds.has(current.toolCallId)) {
+        ctx.logger.info('tool_confirmation_required', {
+            tool: current.toolName,
+            callId: current.toolCallId,
+            session: ctx.sessionId,
+            reason: 'tool_flagged_requires_confirmation',
+        });
+        return {
+            next: { type: 'confirming', call: current, remainingQueue: queue },
+            effects: [...effects, {
+                    type: SSEEventType.ConfirmationRequired,
+                    endpoint: current.toolName,
+                    method: 'EXECUTE',
+                    reason: `Tool "${current.toolName}" requires user confirmation`,
+                    escalated: false,
+                    timestamp,
+                }],
+        };
+    }
+    // 3b. Connection-tool ACL check — access.json rules with endpoint-level
+    //     allow/deny/confirm tiers. Store/admin tools have their own guards
+    //     (read-only paths, blocked filenames, schema validation).
+    if (toolDef.metadata?.category === 'connection' && toolDef.metadata.connection) {
+        const method = typeof current.args['method'] === 'string' ? current.args['method'] : 'GET';
+        const endpoint = typeof current.args['endpoint'] === 'string' ? current.args['endpoint'] : '/';
+        const rawIntent = current.args['intent'];
+        const intent = rawIntent === 'write' || rawIntent === 'confirmed_write' ? rawIntent : 'read';
+        const permResult = ctx.permissionChecker.check({
+            connection: toolDef.metadata.connection,
+            endpointPath: `${method} ${endpoint}`,
+            intent,
+            method,
+            params: current.args,
+        });
+        if (!permResult.allowed) {
+            const result = {
+                callId: current.toolCallId,
+                toolName: current.toolName,
+                status: 'error',
+                content: `Permission denied: ${permResult.reason}`,
+            };
+            ctx.logger.warn('tool_permission_denied', {
+                tool: current.toolName,
+                reason: permResult.reason,
+                session: ctx.sessionId,
+            });
+            return nextAfterToolResult(state, result, effects, ctx);
+        }
+        if (permResult.allowed &&
+            permResult.requiresConfirmation &&
+            !ctx.confirmedCallIds.has(current.toolCallId)) {
+            return {
+                next: { type: 'confirming', call: current, remainingQueue: queue },
+                effects: [...effects, {
+                        type: SSEEventType.ConfirmationRequired,
+                        endpoint,
+                        method,
+                        reason: permResult.reason,
+                        escalated: false,
+                        timestamp,
+                    }],
+            };
+        }
+    }
+    // 4. Intercept dispatch_task — transition to DISPATCHING instead of executing
+    if (current.toolName === DISPATCH_TOOL_NAME) {
+        const args = current.args;
+        const rawTools = Array.isArray(args['tools']) ? args['tools'] : [];
+        const toolSubset = rawTools
+            .filter((t) => typeof t === 'string')
+            .filter((t) => t !== DISPATCH_TOOL_NAME);
+        effects.push({
+            type: SSEEventType.ToolCallStart,
+            tool_name: current.toolName,
+            tool_id: current.toolCallId,
+            parameters: sanitizeParams(current.args),
+            timestamp,
+        });
+        return {
+            next: {
+                type: 'dispatching',
+                task: {
+                    agentName: String(args['agent_name'] ?? 'sub-agent'),
+                    toolSubset,
+                    prompt: String(args['prompt'] ?? ''),
+                    maxTurns: typeof args['max_turns'] === 'number' ? args['max_turns'] : undefined,
+                },
+                toolCallId: current.toolCallId,
+                queue,
+                results: state.results,
+            },
+            effects,
+        };
+    }
+    // 5. Decide: can we batch this call with leading read-only calls from the
+    //    queue? Batching lets independent read-only tools run concurrently
+    //    instead of taking one EXECUTING transition per call. Non-batchable
+    //    calls (writes, confirmation-required, connection ACL, dispatch) still
+    //    flow through the single-call path for correctness.
+    const batch = collectBatch(current, toolDef, queue, ctx);
+    if (batch.calls.length > 1) {
+        return executeBatch(state, batch, effects, ctx);
+    }
+    // Single-call path: execute the current tool, emit events, advance state.
+    effects.push(buildToolCallStartEvent(current, timestamp));
+    const { result, duration } = await runToolCall(current, toolDef, ctx);
+    effects.push(buildToolCallResultEvent(current, result, duration));
+    ctx.logger.info('tool_call', {
+        tool: current.toolName,
+        callId: current.toolCallId,
+        status: result.status,
+        session: ctx.sessionId,
+        duration,
+    });
+    return nextAfterToolResult(state, result, effects, ctx);
+}
+/**
+ * A call is batchable when it can't trigger a mid-queue state-machine
+ * transition. Connection tools are excluded because their ACL check can
+ * return `requiresConfirmation`, which would need a transition to
+ * CONFIRMING — and a batch can only produce one `next` state.
+ * Confirmation-flagged and dispatch tools are excluded for the same
+ * reason: the state machine must route them individually.
+ */
+function isBatchable(toolDef) {
+    return (toolDef.readOnly === true &&
+        !toolDef.requiresConfirmation &&
+        toolDef.metadata?.category !== 'connection');
+}
+/**
+ * Collect the current call plus the leading contiguous run of batchable
+ * calls from the queue. Stops at the first non-batchable call so writes
+ * and gated calls stay sequential.
+ */
+function collectBatch(current, currentToolDef, queue, ctx) {
+    if (!isBatchable(currentToolDef)) {
+        return { calls: [{ call: current, toolDef: currentToolDef }], remainingQueue: queue };
+    }
+    const calls = [{ call: current, toolDef: currentToolDef }];
+    let i = 0;
+    for (; i < queue.length; i++) {
+        const peek = queue[i];
+        const peekDef = ctx.toolRegistry.get(peek.toolName);
+        if (!peekDef || !isBatchable(peekDef))
+            break;
+        calls.push({ call: peek, toolDef: peekDef });
+    }
+    return { calls, remainingQueue: queue.slice(i) };
+}
+/**
+ * Run a batch of read-only tool calls concurrently. Emits per-call
+ * ToolCallStart events first (so UIs can render N in-flight cards at once),
+ * awaits all results via Promise.all, then emits per-call ToolCallResult
+ * events in the original call order. A failure in one call does not block
+ * the others — each produces its own result message for the model.
+ */
+async function executeBatch(state, batch, priorEffects, ctx) {
+    const effects = [...priorEffects];
+    const startTimestamp = new Date().toISOString();
+    // Fire all start events before kicking off the work
+    for (const { call } of batch.calls) {
+        effects.push(buildToolCallStartEvent(call, startTimestamp));
+    }
+    // Run all calls concurrently (pre-exec cache is used per-call inside runToolCall)
+    const runs = await Promise.all(batch.calls.map(({ call, toolDef }) => runToolCall(call, toolDef, ctx)));
+    // Emit result events + structured logs in the original order
+    for (let i = 0; i < batch.calls.length; i++) {
+        const { call } = batch.calls[i];
+        const { result, duration } = runs[i];
+        effects.push(buildToolCallResultEvent(call, result, duration));
+        ctx.logger.info('tool_call', {
+            tool: call.toolName,
+            callId: call.toolCallId,
+            status: result.status,
+            session: ctx.sessionId,
+            duration,
+        });
+    }
+    // Apply smart-snipping per result and append each as a tool message in
+    // call order, then advance the state. Batched results never individually
+    // transition — they collectively advance the state once.
+    const snippedResults = runs.map(({ result }) => snipIfOversized(result, ctx));
+    for (const result of snippedResults) {
+        ctx.messages = [...ctx.messages, buildToolResultMessage(result)];
+    }
+    const allResults = [...state.results, ...snippedResults];
+    // More calls pending? Continue in EXECUTING with the next one.
+    if (batch.remainingQueue.length > 0) {
+        const [next, ...rest] = batch.remainingQueue;
+        return {
+            next: { type: 'executing', queue: rest, current: next, results: allResults },
+            effects,
+        };
+    }
+    // Batch cleared the queue — transition to COMPACTING or THINKING.
+    return transitionAfterQueueEmpty(ctx, effects);
+}
+// ---------------------------------------------------------------------------
+// Per-call execution helpers
+// ---------------------------------------------------------------------------
+/**
+ * Execute one tool call (using the pre-exec cache when present), capture
+ * duration, and build a ToolResult. Never throws — tool failures become
+ * error results the model can observe.
+ */
+async function runToolCall(call, toolDef, ctx) {
+    const startedAt = Date.now();
+    try {
+        // Check pre-execution cache first (read-only tools started during streaming)
+        const cached = ctx.preExecutionCache.get(call.toolCallId);
+        const output = cached ? await cached : await executeTool(call, toolDef, ctx);
+        const content = typeof output === 'string' ? output : JSON.stringify(output);
+        // Detect error-as-result pattern: tool returned {error: "..."} without throwing.
+        // This happens when tool internals catch errors and return them as data.
+        // Treat these as failures so the SSE event shows status: 'error'.
+        const isErrorResult = typeof output === 'object' &&
+            output !== null &&
+            'error' in output &&
+            typeof output['error'] === 'string' &&
+            Object.keys(output).length === 1;
+        const duration = Date.now() - startedAt;
+        if (isErrorResult) {
+            ctx.logger.warn('tool_returned_error', {
+                tool: call.toolName,
+                callId: call.toolCallId,
+                error: output['error'],
+                session: ctx.sessionId,
+                duration,
+            });
+        }
+        return {
+            result: {
+                callId: call.toolCallId,
+                toolName: call.toolName,
+                status: isErrorResult ? 'error' : 'success',
+                content,
+            },
+            duration,
+        };
+    }
+    catch (err) {
+        const duration = Date.now() - startedAt;
+        ctx.logger.error('tool_execution_error', {
+            tool: call.toolName,
+            callId: call.toolCallId,
+            error: err instanceof Error ? err.message : String(err),
+            session: ctx.sessionId,
+            duration,
+        });
+        return {
+            result: {
+                callId: call.toolCallId,
+                toolName: call.toolName,
+                status: 'error',
+                content: `Tool execution failed: ${err instanceof Error ? err.message : String(err)}`,
+            },
+            duration,
+        };
+    }
+}
+function buildToolCallStartEvent(call, timestamp) {
+    return {
+        type: SSEEventType.ToolCallStart,
+        tool_name: call.toolName,
+        tool_id: call.toolCallId,
+        parameters: sanitizeParams(call.args),
+        timestamp,
+    };
+}
+function buildToolCallResultEvent(call, result, duration) {
+    return {
+        type: SSEEventType.ToolCallResult,
+        tool_id: call.toolCallId,
+        status: result.status,
+        duration_ms: duration,
+        ...(result.status === 'error' ? { error: result.content } : {}),
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Execute a tool call, building the ToolContext from the AgentContext.
+ * Enforces a timeout via AbortSignal to prevent hanging on broken tools.
+ */
+export async function executeTool(call, toolDef, ctx) {
+    const toolCtx = ctx.buildToolContext(call.toolCallId);
+    // Combine session abort signal with a per-tool timeout.
+    // Mutate instead of spread — toolCtx.request() reads ctx.signal at call
+    // time, so the combined signal propagates to HTTP requests and other
+    // async operations inside the tool.
+    const timeoutSignal = AbortSignal.timeout(ctx.config.toolTimeoutMs);
+    toolCtx.signal = AbortSignal.any([ctx.signal, timeoutSignal]);
+    return toolDef.execute(call.args, toolCtx);
+}
+/**
+ * After a tool result: append to messages, then continue to next call or back to THINKING.
+ */
+export function nextAfterToolResult(state, result, effects, ctx) {
+    const snipped = snipIfOversized(result, ctx);
+    // Append tool result message
+    const resultMessage = buildToolResultMessage(snipped);
+    ctx.messages = [...ctx.messages, resultMessage];
+    const allResults = [...state.results, snipped];
+    // More tool calls in the queue?
+    if (state.queue.length > 0) {
+        const [next, ...rest] = state.queue;
+        return {
+            next: {
+                type: 'executing',
+                queue: rest,
+                current: next,
+                results: allResults,
+            },
+            effects,
+        };
+    }
+    return transitionAfterQueueEmpty(ctx, effects);
+}
+/**
+ * Smart snipping: if a tool result exceeds maxResultSize, keep the first
+ * and last 2K chars with a [snipped] marker in between. This preserves the
+ * beginning (usually headers/structure) and end (usually the answer) while
+ * cutting the middle bulk.
+ */
+function snipIfOversized(result, ctx) {
+    if (result.content.length <= ctx.config.maxResultSize)
+        return result;
+    const originalSize = result.content.length;
+    const keepChars = 2_000;
+    const head = result.content.slice(0, keepChars);
+    const tail = result.content.slice(-keepChars);
+    ctx.logger.info('tool_result_snipped', {
+        callId: result.callId,
+        tool: result.toolName,
+        originalSize,
+        snippedTo: keepChars * 2,
+        session: ctx.sessionId,
+    });
+    return {
+        ...result,
+        content: `${head}\n\n[... snipped ${String(originalSize - keepChars * 2)} chars — full output was ${String(originalSize)} chars ...]\n\n${tail}`,
+    };
+}
+/**
+ * Transition after the tool-call queue is drained — either COMPACTING if
+ * context is heavy, or THINKING for the next LLM turn.
+ */
+function transitionAfterQueueEmpty(ctx, effects) {
+    const estimatedTokens = estimateTokenCount(ctx.messages, ctx.provider);
+    if (estimatedTokens > ctx.maxContextTokens * ctx.config.compactThreshold) {
+        ctx.logger.info('context_compaction_triggered', {
+            session: ctx.sessionId,
+            estimatedTokens,
+            maxContextTokens: ctx.maxContextTokens,
+            threshold: ctx.config.compactThreshold,
+        });
+        return {
+            next: { type: 'compacting', messages: ctx.messages, estimatedTokens },
+            effects,
+        };
+    }
+    return {
+        next: { type: 'thinking', messages: ctx.messages },
+        effects,
+    };
+}
+/**
+ * Build a tool result message in AI SDK format.
+ */
+function buildToolResultMessage(result) {
+    return {
+        role: 'tool',
+        content: [{
+                type: 'tool-result',
+                toolCallId: result.callId,
+                toolName: result.toolName,
+                output: { type: 'text', value: result.content },
+            }],
+    };
+}
+/**
+ * Strip sensitive fields from tool call parameters for SSE events.
+ */
+function sanitizeParams(params) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (/token|secret|password|key|auth/i.test(key)) {
+            sanitized[key] = '[REDACTED]';
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+//# sourceMappingURL=executing.js.map

package/dist/src/agent/states/executing.js.map

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

package/dist/src/agent/states/streaming.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { StreamingState, AgentContext, TransitionResult } from '../loop-types.js';
+/**
+ * Handle the STREAMING state.
+ */
+export declare function handleStreaming(state: StreamingState, ctx: AgentContext): Promise<TransitionResult>;