@devxiyang/agent-kernel 0.0.2

package/dist/core/agent/loop.js

@@ -0,0 +1,378 @@
+/**
+ * Agent loop — the "userspace shell" around the kernel.
+ *
+ * Design:
+ *   - No dependency on any LLM provider (AI SDK, OpenAI, etc.).
+ *   - Provider is injected as StreamFn; tools are injected as AgentTool[].
+ *   - The kernel is the single source of truth for conversation history.
+ *   - Nested loop pattern: inner loop handles tool calls
+ *     and steering; outer loop handles follow-up messages.
+ *
+ * Each inner iteration (one turn):
+ *   1. Write pending entries to kernel.
+ *   2. Emit turn_start.
+ *   3. buildContext → transformContext? → AgentMessage[]
+ *   4. stream(messages) → LLMStepResult, emitting LLMStreamEvents to UI.
+ *   5. Write assistant entry to kernel.
+ *   6. Execute tool calls (write each result to kernel, check steering between calls).
+ *   7. Emit turn_end { toolResults }.
+ *   8. If tool calls were made → repeat from 1 (LLM processes results).
+ *   9. Else → check for follow-up messages (outer loop) or stop.
+ */
+import { Value } from '@sinclair/typebox/value';
+import { EventStream } from '../../event-stream';
+// ─── runLoop ──────────────────────────────────────────────────────────────────
+/**
+ * Start the agent loop. Returns an EventStream immediately.
+ * Consumer iterates events with `for await` and awaits stream.result().
+ */
+export function runLoop(kernel, config) {
+    const stream = new EventStream();
+    void _run(kernel, config, stream);
+    return stream;
+}
+// ─── _run ─────────────────────────────────────────────────────────────────────
+/**
+ * Core async driver for the agent loop.
+ * Runs entirely in the background; all output is pushed into `stream`.
+ */
+async function _run(kernel, config, stream) {
+    const startedAt = Date.now();
+    let stepText = ''; // current step text; reset on each step start
+    let stepReasoning = ''; // current step reasoning; reset on each step start
+    let stepNumber = 0;
+    let totalUsage = {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        totalTokens: 0,
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+    };
+    // Partial tool calls streamed in the current LLM step (cleared on each step start).
+    let partialToolCalls = [];
+    stream.push({ type: 'agent_start' });
+    try {
+        // Check for any messages already queued before this run starts (e.g. steering
+        // messages typed while a previous run was finishing)
+        let pendingMessages = await config.getSteeringMessages?.() ?? [];
+        // ── Outer loop: continues when follow-up messages arrive ──────────────
+        while (true) {
+            let hasMoreToolCalls = true;
+            let steeringAfterTools = null;
+            // ── Inner loop: one LLM call + tool execution per iteration ─────────
+            while (hasMoreToolCalls || pendingMessages.length > 0) {
+                // Write pending steering / follow-up entries to kernel
+                for (const entry of pendingMessages) {
+                    kernel.append(entry);
+                }
+                pendingMessages = [];
+                if (stepNumber >= config.maxSteps) {
+                    hasMoreToolCalls = false;
+                    break;
+                }
+                stream.push({ type: 'turn_start' });
+                // Build conversation context from kernel; allow caller to transform it
+                const rawMessages = kernel.buildMessages();
+                const messages = await config.transformContext?.(rawMessages, config.signal) ?? rawMessages;
+                // Signal start of assistant message
+                stream.push({ type: 'message_start', entry: { type: 'assistant', payload: { text: '', toolCalls: [] } } });
+                // Reset per-step partial tracking (also reset before each retry attempt)
+                const resetPartials = () => {
+                    partialToolCalls = [];
+                    stepText = '';
+                    stepReasoning = '';
+                };
+                resetPartials();
+                // Call the LLM; onEvent forwards real-time events to the UI stream
+                const makeOnEvent = () => (event) => {
+                    if (event.type === 'text-delta') {
+                        stepText += event.delta;
+                        stream.push({ type: 'text_delta', delta: event.delta });
+                    }
+                    else if (event.type === 'reasoning-delta') {
+                        stepReasoning += event.delta;
+                        stream.push({ type: 'reasoning_delta', delta: event.delta });
+                    }
+                    else if (event.type === 'tool-call') {
+                        partialToolCalls.push({ toolCallId: event.toolCallId, toolName: event.toolName, input: event.input });
+                        stream.push({ type: 'tool_call', toolCallId: event.toolCallId, toolName: event.toolName, input: event.input });
+                    }
+                };
+                const streamCall = () => {
+                    resetPartials();
+                    return config.stream(messages, config.tools, makeOnEvent(), config.signal);
+                };
+                const stepResult = config.retryOnError
+                    ? await withRetry(streamCall, config.retryOnError, config.signal)
+                    : await streamCall();
+                stepNumber++;
+                accumulateUsage(totalUsage, stepResult.usage);
+                // Write the assistant turn to kernel
+                const assistantEntry = {
+                    type: 'assistant',
+                    payload: {
+                        text: stepResult.text,
+                        reasoning: stepResult.reasoning,
+                        toolCalls: stepResult.toolCalls,
+                        stopReason: stepResult.stopReason,
+                    },
+                    usage: stepResult.usage,
+                };
+                kernel.append(assistantEntry);
+                stream.push({ type: 'message_end', entry: assistantEntry });
+                stream.push({ type: 'step_done', stepNumber, usage: stepResult.usage });
+                await config.onStepEnd?.(kernel, stepNumber);
+                // ── onContextFull hook ────────────────────────────────────────────
+                if (config.onContextFull && kernel.budget.limit < Infinity && kernel.contextSize >= kernel.budget.limit) {
+                    await config.onContextFull(kernel, stepNumber);
+                }
+                // ── Execute tool calls ────────────────────────────────────────────
+                hasMoreToolCalls = stepResult.toolCalls.length > 0;
+                let turnToolResults = [];
+                if (hasMoreToolCalls) {
+                    const result = await executeTools(stepResult.toolCalls, config.tools, kernel, stream, config.signal, config.getSteeringMessages, config.parallelTools ?? false, config.toolTimeout);
+                    turnToolResults = result.toolResults;
+                    steeringAfterTools = result.steeringMessages ?? null;
+                }
+                stream.push({ type: 'turn_end', toolResults: turnToolResults });
+                // Update pending messages for next inner iteration
+                if (steeringAfterTools && steeringAfterTools.length > 0) {
+                    pendingMessages = steeringAfterTools;
+                    steeringAfterTools = null;
+                }
+                else {
+                    pendingMessages = await config.getSteeringMessages?.() ?? [];
+                }
+            }
+            // ────────────────────────────────────────────────────────────────────
+            // Agent would stop here — check for queued follow-up messages
+            const followUps = await config.getFollowUpMessages?.() ?? [];
+            if (followUps.length > 0) {
+                pendingMessages = followUps;
+                continue;
+            }
+            break;
+        }
+        // ──────────────────────────────────────────────────────────────────────
+        stream.push({ type: 'agent_end' });
+        stream.end({
+            usage: totalUsage,
+            durationMs: Date.now() - startedAt,
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const isAbort = error instanceof Error && error.name === 'AbortError';
+        const stopReason = isAbort ? 'aborted' : 'error';
+        // If meaningful content was streamed before the error/abort, save it as a
+        // normal assistant entry (no error field) — the user can see what was produced.
+        // Only add the error field when nothing useful was streamed.
+        // Use step-scoped partials — previous steps are already committed to kernel.
+        const hasContent = stepText.trim().length > 0 || stepReasoning.trim().length > 0 || partialToolCalls.length > 0;
+        const errorEntry = hasContent
+            ? { type: 'assistant', payload: { text: stepText, reasoning: stepReasoning || undefined, toolCalls: partialToolCalls, stopReason } }
+            : { type: 'assistant', payload: { text: '', toolCalls: [], stopReason, error: errorMessage } };
+        kernel.append(errorEntry);
+        stream.push({ type: 'message_end', entry: errorEntry });
+        stream.push({ type: 'turn_end', toolResults: [] });
+        stream.push({ type: 'agent_end', error: errorMessage });
+        stream.end({
+            usage: totalUsage,
+            durationMs: Date.now() - startedAt,
+        });
+    }
+}
+// ─── executeTools ─────────────────────────────────────────────────────────────
+/**
+ * Dispatcher: routes to sequential or parallel execution based on config.
+ * Returns the aggregated tool results and any steering messages that arrived.
+ */
+async function executeTools(toolCalls, tools, kernel, stream, signal, getSteeringMessages, parallelTools, toolTimeout) {
+    if (parallelTools) {
+        return executeToolsParallel(toolCalls, tools, kernel, stream, signal, getSteeringMessages, toolTimeout);
+    }
+    return executeToolsSequential(toolCalls, tools, kernel, stream, signal, getSteeringMessages, toolTimeout);
+}
+/**
+ * Execute tool calls one at a time. After each call, check for steering messages.
+ * If steering arrives, skip the remaining tools (writing "interrupted" results so
+ * the kernel stays consistent) and return the steering entries to the caller.
+ */
+async function executeToolsSequential(toolCalls, tools, kernel, stream, signal, getSteeringMessages, toolTimeout) {
+    let steeringMessages;
+    const toolResults = [];
+    for (const tc of toolCalls) {
+        // If steering arrived during a previous tool call, skip the rest
+        if (steeringMessages) {
+            const skipped = skipTool(tc.toolCallId, tc.toolName, kernel, stream);
+            toolResults.push({ toolCallId: tc.toolCallId, toolName: tc.toolName, ...skipped });
+            continue;
+        }
+        const result = await runSingleTool(tc, tools, stream, signal, toolTimeout);
+        const { content, isError, details } = result;
+        const toolResultEntry = {
+            type: 'tool_result',
+            payload: { toolCallId: tc.toolCallId, toolName: tc.toolName, content, isError },
+        };
+        kernel.append(toolResultEntry);
+        stream.push({ type: 'tool_result', toolCallId: tc.toolCallId, content, isError, details });
+        toolResults.push({ toolCallId: tc.toolCallId, toolName: tc.toolName, content, isError, details });
+        // Check for steering messages between tool calls (SIGINT semantics)
+        const steering = await getSteeringMessages?.() ?? [];
+        if (steering.length > 0) {
+            steeringMessages = steering;
+        }
+    }
+    return { steeringMessages, toolResults };
+}
+/**
+ * Execute all tool calls concurrently with Promise.allSettled.
+ * Each tool gets its own AbortController linked to the parent signal.
+ * Steering is checked once after all tools complete; if present, all results
+ * are discarded and "interrupted" placeholders are written to the kernel.
+ */
+async function executeToolsParallel(toolCalls, tools, kernel, stream, signal, getSteeringMessages, toolTimeout) {
+    let steeringArrived = false;
+    // Per-tool AbortControllers linked to the parent signal
+    const controllers = toolCalls.map(() => new AbortController());
+    if (signal) {
+        const onAbort = () => controllers.forEach(c => c.abort());
+        signal.addEventListener('abort', onAbort, { once: true });
+    }
+    // Run all tools concurrently
+    const settled = await Promise.allSettled(toolCalls.map((tc, i) => runSingleTool(tc, tools, stream, controllers[i].signal, toolTimeout)));
+    // Check for steering after all tools complete
+    const steeringMessages = await getSteeringMessages?.() ?? [];
+    if (steeringMessages.length > 0) {
+        steeringArrived = true;
+    }
+    const toolResults = [];
+    for (let i = 0; i < toolCalls.length; i++) {
+        const tc = toolCalls[i];
+        const outcome = settled[i];
+        // If steering arrived, discard results and skip remaining
+        if (steeringArrived) {
+            const skipped = skipTool(tc.toolCallId, tc.toolName, kernel, stream);
+            toolResults.push({ toolCallId: tc.toolCallId, toolName: tc.toolName, ...skipped });
+            continue;
+        }
+        const result = outcome.status === 'fulfilled'
+            ? outcome.value
+            : { content: outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason), isError: true };
+        const { content, isError, details } = result;
+        const toolResultEntry = {
+            type: 'tool_result',
+            payload: { toolCallId: tc.toolCallId, toolName: tc.toolName, content, isError },
+        };
+        kernel.append(toolResultEntry);
+        stream.push({ type: 'tool_result', toolCallId: tc.toolCallId, content, isError, details });
+        toolResults.push({ toolCallId: tc.toolCallId, toolName: tc.toolName, content, isError, details });
+    }
+    return { steeringMessages: steeringArrived ? steeringMessages : undefined, toolResults };
+}
+/**
+ * Validate input and execute a single tool call.
+ * Wraps execution with an optional timeout. Any thrown error is converted to
+ * an error ToolResult rather than propagating (keeps the loop alive).
+ */
+async function runSingleTool(tc, tools, stream, signal, toolTimeout) {
+    const tool = tools.find((t) => t.name === tc.toolName);
+    try {
+        if (!tool)
+            throw new Error(`Tool not found: ${tc.toolName}`);
+        const validated = validateInput(tool, tc.input);
+        if (!validated.ok) {
+            return { content: validated.content, isError: true };
+        }
+        const execPromise = tool.execute(tc.toolCallId, validated.value, signal, (partial) => stream.push({ type: 'tool_update', toolCallId: tc.toolCallId, partial }));
+        return await (toolTimeout ? withTimeout(execPromise, toolTimeout, signal) : execPromise);
+    }
+    catch (err) {
+        return { content: err instanceof Error ? err.message : String(err), isError: true };
+    }
+}
+// ─── withTimeout ──────────────────────────────────────────────────────────────
+/**
+ * Race a promise against a deadline. Rejects with a timeout error if the
+ * promise does not settle within `ms` milliseconds. Clears the timer on abort.
+ */
+function withTimeout(promise, ms, signal) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`Tool timed out after ${ms}ms`)), ms);
+        const clear = () => clearTimeout(timer);
+        signal?.addEventListener('abort', clear);
+        promise.then(v => { clear(); resolve(v); }, e => { clear(); reject(e); });
+    });
+}
+// ─── withRetry ────────────────────────────────────────────────────────────────
+/**
+ * Retry `fn` up to `opts.maxAttempts` times with a fixed `opts.delayMs` pause
+ * between attempts. Aborts immediately if the signal is already cancelled.
+ */
+async function withRetry(fn, opts, signal) {
+    let lastErr;
+    for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {
+        if (signal?.aborted)
+            throw new DOMException('Aborted', 'AbortError');
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (signal?.aborted)
+                throw err;
+            if (attempt === opts.maxAttempts)
+                throw err;
+            lastErr = err;
+            await new Promise(r => setTimeout(r, opts.delayMs));
+        }
+    }
+    throw lastErr;
+}
+// ─── accumulateUsage ──────────────────────────────────────────────────────────
+/** Add per-step token/cost counters into the running totals for the whole run. */
+function accumulateUsage(acc, step) {
+    acc.input += step.input;
+    acc.output += step.output;
+    acc.cacheRead += step.cacheRead;
+    acc.cacheWrite += step.cacheWrite;
+    acc.totalTokens += step.totalTokens;
+    acc.cost.input += step.cost.input;
+    acc.cost.output += step.cost.output;
+    acc.cost.cacheRead += step.cost.cacheRead;
+    acc.cost.cacheWrite += step.cost.cacheWrite;
+    acc.cost.total += step.cost.total;
+}
+/**
+ * Validate and coerce tool input against its TypeBox schema.
+ * Returns the cleaned value on success, or a human-readable error string on failure.
+ * If the tool has no schema, the raw input is passed through unchanged.
+ */
+function validateInput(tool, input) {
+    if (!tool.parameters)
+        return { ok: true, value: input };
+    try {
+        const value = Value.Parse(tool.parameters, input);
+        return { ok: true, value };
+    }
+    catch {
+        const errors = [...Value.Errors(tool.parameters, input)];
+        const detail = errors.map((e) => `${e.path || '(root)'}: ${e.message}`).join('; ');
+        return { ok: false, content: detail || 'Parameter validation failed' };
+    }
+}
+// ─── skipTool ─────────────────────────────────────────────────────────────────
+/**
+ * Write an "interrupted" tool_result placeholder for a skipped tool call.
+ * Used when steering arrives mid-batch so the kernel never has unmatched tool calls.
+ */
+function skipTool(toolCallId, toolName, kernel, stream) {
+    const content = 'Skipped: user interrupted.';
+    kernel.append({
+        type: 'tool_result',
+        payload: { toolCallId, toolName, content, isError: true },
+    });
+    stream.push({ type: 'tool_result', toolCallId, content, isError: true });
+    return { content, isError: true };
+}
+//# sourceMappingURL=loop.js.map

package/dist/core/agent/loop.js.map

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

package/dist/core/agent/types.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Type definitions for the Agent module.
+ *
+ * Covers the provider-agnostic LLM streaming contract (StreamFn / LLMStreamEvent),
+ * tool definitions (AgentTool / ToolResult), execution hooks (ToolWrapHooks),
+ * agent configuration (AgentConfig / AgentOptions), and the event bus (AgentEvent).
+ */
+import type { TObject, Static } from '@sinclair/typebox';
+import type { Usage, AgentEntry, AgentMessage, AgentKernel, ContentPart, ToolCallInfo } from '../kernel';
+export type { Usage, StopReason, ToolCallInfo, AgentEntry, AgentMessage, } from '../kernel';
+/**
+ * Real-time events emitted by the provider during a single LLM call.
+ * The loop forwards these to the UI event stream as they arrive.
+ */
+export type LLMStreamEvent = {
+    type: 'text-delta';
+    delta: string;
+} | {
+    type: 'reasoning-delta';
+    delta: string;
+} | {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+};
+/** Reason the LLM stopped generating in a given step. */
+export type LLMStopReason = 'stop' | 'tool_use' | 'length' | 'content_filter' | (string & {});
+/**
+ * Resolved value returned by StreamFn after a single LLM call completes.
+ * Contains the full text/reasoning, all tool calls requested, and token usage.
+ */
+export type LLMStepResult = {
+    text: string;
+    reasoning?: string;
+    toolCalls: ToolCallInfo[];
+    stopReason: LLMStopReason;
+    usage: Usage;
+};
+/**
+ * Provider-injected stream function. Implementer closes over model, API key,
+ * system prompt, and any other provider config.
+ *
+ * `tools` carries the full AgentTool definitions (name, description, parameters)
+ * so the provider adapter can build its own tool schema without hardcoding it.
+ */
+export type StreamFn = (messages: AgentMessage[], tools: AgentTool[], onEvent: (event: LLMStreamEvent) => void, signal?: AbortSignal) => Promise<LLMStepResult>;
+export type ToolContent = string | ContentPart[];
+/**
+ * Result returned by a tool's execute function.
+ *
+ * - `content`  — what the LLM sees (text or multimodal parts)
+ * - `isError`  — whether this is an error result
+ * - `details`  — structured data for the UI only; the LLM never sees this
+ */
+export type ToolResult<TDetails = unknown> = {
+    content: ToolContent;
+    isError: boolean;
+    details?: TDetails;
+};
+export type AgentTool<TSchema extends TObject = TObject, TDetails = unknown> = {
+    name: string;
+    /** Human-readable label for UI display. Defaults to `name` if omitted. */
+    label?: string;
+    /** Passed to the LLM provider as the tool description. */
+    description: string;
+    /**
+     * TypeBox schema for the tool's input parameters.
+     * Used for runtime validation in the loop and passed directly to the provider
+     * as JSON Schema (TypeBox schemas are standard JSON Schema at runtime).
+     */
+    parameters?: TSchema;
+    execute: (toolCallId: string, input: Static<TSchema>, signal?: AbortSignal, onUpdate?: (partial: ToolResult<TDetails>) => void) => Promise<ToolResult<TDetails>>;
+};
+/**
+ * Return value from BeforeToolCallHook:
+ *  - `{ action: 'block', reason }` — framework-handled: skip tool, return reason as error
+ *  - `{ action: string }` — caller-defined extension; framework passes through as-is
+ *  - `void`              — allow as-is
+ */
+export type BlockResult = {
+    action: 'block';
+    reason: string;
+};
+export type BeforeToolCallResult = BlockResult | {
+    action: string & {};
+};
+export type BeforeToolCallHook = (toolCallId: string, toolName: string, input: Record<string, unknown>) => Promise<BeforeToolCallResult | void> | BeforeToolCallResult | void;
+/**
+ * Partial override of the tool result. Only fields you return are applied;
+ * return void to keep the original unchanged.
+ */
+export type AfterToolCallResult = {
+    content?: ToolContent;
+    isError?: boolean;
+    details?: unknown;
+};
+export type AfterToolCallHook = (toolCallId: string, toolName: string, result: ToolResult) => Promise<AfterToolCallResult | void> | AfterToolCallResult | void;
+export type ToolWrapHooks = {
+    before?: BeforeToolCallHook;
+    after?: AfterToolCallHook;
+};
+export type ToolResultInfo = {
+    toolCallId: string;
+    toolName: string;
+    content: ToolContent;
+    isError: boolean;
+    details?: unknown;
+};
+/**
+ * Runtime configuration passed to runLoop on each execution.
+ * Most fields mirror AgentOptions; the queue-drain callbacks are wired by Agent.
+ */
+export interface AgentConfig {
+    /** Provider-injected streaming function. */
+    stream: StreamFn;
+    /** Tools made available to the LLM for this run. */
+    tools: AgentTool[];
+    /** Maximum number of LLM + tool-execution cycles before the loop stops. */
+    maxSteps: number;
+    /** Abort signal forwarded to stream calls and tool executions. */
+    signal?: AbortSignal;
+    /** Returns queued steering entries; called between tool calls and before each LLM step. */
+    getSteeringMessages?: () => Promise<AgentEntry[]>;
+    /** Returns queued follow-up entries; checked after the agent would otherwise stop. */
+    getFollowUpMessages?: () => Promise<AgentEntry[]>;
+    /**
+     * Optional hook to modify or replace the message array before each LLM call.
+     * Useful for injecting system context, filtering, or summarising long threads.
+     */
+    transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;
+    /** Called after every completed LLM step. Useful for side-effects or logging. */
+    onStepEnd?: (kernel: AgentKernel, stepNumber: number) => Promise<void>;
+    /** Run tool calls concurrently. Default: false (sequential). */
+    parallelTools?: boolean;
+    /** Fired when context size reaches or exceeds budget.limit. Callback should call kernel.compact(). */
+    onContextFull?: (kernel: AgentKernel, stepNumber: number) => Promise<void>;
+    /** Per-tool execution timeout in ms. Undefined = no timeout. */
+    toolTimeout?: number;
+    /** Retry config for LLM stream errors. */
+    retryOnError?: {
+        maxAttempts: number;
+        delayMs: number;
+    };
+}
+/**
+ * All events emitted by the agent loop.
+ *
+ * Lifecycle:  agent_start → (turn_start → message_start → … → message_end
+ *             → tool_call* → tool_result* → turn_end → step_done)* → agent_end
+ *
+ * - agent_start / agent_end    — wraps the entire run
+ * - turn_start / turn_end      — wraps one LLM call + tool execution cycle
+ * - message_start / message_end — wraps the streaming assistant message
+ * - text_delta / reasoning_delta — incremental text chunks from the LLM
+ * - tool_call                  — a tool the LLM requested to execute
+ * - tool_update                — partial progress update from a long-running tool
+ * - tool_result                — final result after a tool finishes
+ * - step_done                  — emitted after tool results are written to kernel
+ */
+export type AgentEvent = {
+    type: 'agent_start';
+} | {
+    type: 'agent_end';
+    error?: string;
+} | {
+    type: 'turn_start';
+} | {
+    type: 'turn_end';
+    toolResults: ToolResultInfo[];
+} | {
+    type: 'message_start';
+    entry: AgentEntry;
+} | {
+    type: 'message_end';
+    entry: AgentEntry;
+} | {
+    type: 'text_delta';
+    delta: string;
+} | {
+    type: 'reasoning_delta';
+    delta: string;
+} | {
+    type: 'tool_call';
+    toolCallId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+} | {
+    type: 'tool_update';
+    toolCallId: string;
+    partial: ToolResult;
+} | {
+    type: 'tool_result';
+    toolCallId: string;
+    content: ToolContent;
+    isError: boolean;
+    details?: unknown;
+} | {
+    type: 'step_done';
+    stepNumber: number;
+    usage: Usage;
+};
+/** Resolved value of EventStream.result() after a successful agent run. */
+export type AgentResult = {
+    /** Aggregated token usage across all steps in the run. */
+    usage: Usage;
+    /** Wall-clock duration of the entire run in milliseconds. */
+    durationMs: number;
+};
+/**
+ * Controls how queued steering or follow-up messages are drained each time the
+ * agent checks the queue.
+ *
+ * - 'one-at-a-time' — dequeue a single entry per check (default)
+ * - 'all'           — dequeue all pending entries at once
+ */
+export type QueueMode = 'all' | 'one-at-a-time';
+export interface AgentOptions {
+    stream: StreamFn;
+    tools: AgentTool[];
+    maxSteps: number;
+    transformContext?: AgentConfig['transformContext'];
+    onStepEnd?: AgentConfig['onStepEnd'];
+    steeringMode?: QueueMode;
+    followUpMode?: QueueMode;
+    parallelTools?: AgentConfig['parallelTools'];
+    onContextFull?: AgentConfig['onContextFull'];
+    toolTimeout?: AgentConfig['toolTimeout'];
+    retryOnError?: AgentConfig['retryOnError'];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/agent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,EACb,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,KAAK,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,WAAW,CAAA;AAIlB;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAM,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAE/F,yDAAyD;AACzD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE7F;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAQ,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,EAAG,YAAY,EAAE,CAAA;IAC1B,UAAU,EAAE,aAAa,CAAA;IACzB,KAAK,EAAO,KAAK,CAAA;CAClB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,CACrB,QAAQ,EAAE,YAAY,EAAE,EACxB,KAAK,EAAK,SAAS,EAAE,EACrB,OAAO,EAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,EACzC,MAAM,CAAC,EAAG,WAAW,KAClB,OAAO,CAAC,aAAa,CAAC,CAAA;AAI3B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,EAAE,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,QAAQ,GAAG,OAAO,IAAI;IAC3C,OAAO,EAAI,WAAW,CAAA;IACtB,OAAO,EAAI,OAAO,CAAA;IAClB,OAAO,CAAC,EAAG,QAAQ,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,SAAS,CACnB,OAAO,SAAU,OAAO,GAAG,OAAO,EAClC,QAAQ,GAAG,OAAO,IAChB;IACF,IAAI,EAAU,MAAM,CAAA;IACpB,0EAA0E;IAC1E,KAAK,CAAC,EAAQ,MAAM,CAAA;IACpB,0DAA0D;IAC1D,WAAW,EAAG,MAAM,CAAA;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAG,OAAO,CAAA;IACrB,OAAO,EAAE,CACP,UAAU,EAAE,MAAM,EAClB,KAAK,EAAO,MAAM,CAAC,OAAO,CAAC,EAC3B,MAAM,CAAC,EAAK,WAAW,EACvB,QAAQ,CAAC,EAAG,CAAC,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,KAChD,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;CACnC,CAAA;AAID;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7D,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX;IAAE,MAAM,EAAE,MAAM,GAAG,EAAE,CAAA;CAAE,CAAA;AAE3B,MAAM,MAAM,kBAAkB,GAAG,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAI,MAAM,EAClB,KAAK,EAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,GAAG,oBAAoB,GAAG,IAAI,CAAA;AAEvE;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAG,WAAW,CAAA;IACtB,OAAO,CAAC,EAAG,OAAO,CAAA;IAClB,OAAO,CAAC,EAAG,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAI,MAAM,EAClB,MAAM,EAAM,UAAU,KACnB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAAA;AAErE,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,KAAK,CAAC,EAAG,iBAAiB,CAAA;CAC3B,CAAA;AAID,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAI,MAAM,CAAA;IAClB,OAAO,EAAK,WAAW,CAAA;IACvB,OAAO,EAAK,OAAO,CAAA;IACnB,OAAO,CAAC,EAAI,OAAO,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,MAAM,EAAK,QAAQ,CAAA;IACnB,oDAAoD;IACpD,KAAK,EAAM,SAAS,EAAE,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,EAAG,MAAM,CAAA;IACjB,kEAAkE;IAClE,MAAM,CAAC,EAAI,WAAW,CAAA;IAEtB,2FAA2F;IAC3F,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACjD,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAEjD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CACjB,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,CAAC,EAAG,WAAW,KAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAE5B,iFAAiF;IACjF,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtE,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB,sGAAsG;IACtG,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1E,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,0CAA0C;IAC1C,YAAY,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,EAAM,MAAM,CAAA;KACpB,CAAA;CACF;AAID;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,cAAc,EAAE,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAG,KAAK,EAAE,UAAU,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAI,KAAK,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACtG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAI7D,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG;IACxB,0DAA0D;IAC1D,KAAK,EAAO,KAAK,CAAA;IACjB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAID;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,eAAe,CAAA;AAE/C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAa,QAAQ,CAAA;IAC3B,KAAK,EAAc,SAAS,EAAE,CAAA;IAC9B,QAAQ,EAAW,MAAM,CAAA;IACzB,gBAAgB,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAA;IAClD,SAAS,CAAC,EAAS,WAAW,CAAC,WAAW,CAAC,CAAA;IAC3C,YAAY,CAAC,EAAM,SAAS,CAAA;IAC5B,YAAY,CAAC,EAAM,SAAS,CAAA;IAC5B,aAAa,CAAC,EAAK,WAAW,CAAC,eAAe,CAAC,CAAA;IAC/C,aAAa,CAAC,EAAK,WAAW,CAAC,eAAe,CAAC,CAAA;IAC/C,WAAW,CAAC,EAAO,WAAW,CAAC,aAAa,CAAC,CAAA;IAC7C,YAAY,CAAC,EAAM,WAAW,CAAC,cAAc,CAAC,CAAA;CAC/C"}

package/dist/core/agent/types.js

@@ -0,0 +1,9 @@
+/**
+ * Type definitions for the Agent module.
+ *
+ * Covers the provider-agnostic LLM streaming contract (StreamFn / LLMStreamEvent),
+ * tool definitions (AgentTool / ToolResult), execution hooks (ToolWrapHooks),
+ * agent configuration (AgentConfig / AgentOptions), and the event bus (AgentEvent).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}