@agent-native/core 0.4.5 → 0.6.1

package/dist/agent/engine/translate-ai-sdk.js

@@ -0,0 +1,174 @@
+/**
+ * Translation helpers between AgentEngine normalized types and
+ * Vercel AI SDK (ai package) types.
+ */
+// ---------------------------------------------------------------------------
+// EngineTool → AI SDK CoreTool shape
+// ---------------------------------------------------------------------------
+/**
+ * Convert EngineTool[] to the `tools` Record<string, CoreTool> shape
+ * that AI SDK's streamText expects.
+ *
+ * AI SDK v4 requires tool parameters to be Zod schemas or jsonSchema()-wrapped
+ * objects. Pass the `jsonSchema` helper from the `ai` package to produce a
+ * compatible schema wrapper; fall back to the raw JSON Schema object when the
+ * helper is not available (older AI SDK or tests).
+ */
+export function engineToolsToAISDK(tools, jsonSchema) {
+    const result = {};
+    for (const tool of tools) {
+        const rawSchema = {
+            type: "object",
+            properties: tool.inputSchema.properties ?? {},
+            required: tool.inputSchema.required ?? [],
+        };
+        result[tool.name] = {
+            description: tool.description,
+            parameters: jsonSchema ? jsonSchema(rawSchema) : rawSchema,
+        };
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// EngineMessage → AI SDK CoreMessage
+// ---------------------------------------------------------------------------
+export function engineMessageToAISDK(msg) {
+    if (msg.role === "user") {
+        const content = [];
+        for (const part of msg.content) {
+            if (part.type === "text") {
+                content.push({ type: "text", text: part.text });
+            }
+            else if (part.type === "image") {
+                content.push({
+                    type: "image",
+                    image: `data:${part.mediaType};base64,${part.data}`,
+                });
+            }
+            else if (part.type === "tool-result") {
+                content.push({
+                    type: "tool-result",
+                    toolCallId: part.toolCallId,
+                    result: part.content,
+                    isError: part.isError,
+                });
+            }
+        }
+        return {
+            role: "user",
+            content: content.length === 1 && content[0].type === "text"
+                ? content[0].text
+                : content,
+        };
+    }
+    if (msg.role === "assistant") {
+        const content = [];
+        for (const part of msg.content) {
+            if (part.type === "text") {
+                content.push({ type: "text", text: part.text });
+            }
+            else if (part.type === "tool-call") {
+                content.push({
+                    type: "tool-call",
+                    toolCallId: part.id,
+                    toolName: part.name,
+                    args: part.input,
+                });
+            }
+            else if (part.type === "thinking") {
+                // AI SDK 5+ supports reasoning content parts
+                content.push({ type: "reasoning", text: part.text });
+            }
+        }
+        return {
+            role: "assistant",
+            content: content.length === 1 && content[0].type === "text"
+                ? content[0].text
+                : content,
+        };
+    }
+    // Exhaustive — EngineMessage only has "user" | "assistant" roles
+    return { role: msg.role, content: "" };
+}
+export function engineMessagesToAISDK(messages) {
+    return messages.map(engineMessageToAISDK);
+}
+// ---------------------------------------------------------------------------
+// AI SDK stream part → EngineEvent
+// ---------------------------------------------------------------------------
+export function aiSdkPartToEngineEvents(part) {
+    const events = [];
+    if (part.type === "text-delta") {
+        events.push({ type: "text-delta", text: part.textDelta ?? "" });
+    }
+    else if (part.type === "reasoning") {
+        events.push({
+            type: "thinking-delta",
+            text: part.textDelta ?? part.text ?? "",
+        });
+    }
+    else if (part.type === "tool-call") {
+        events.push({
+            type: "tool-call",
+            id: part.toolCallId,
+            name: part.toolName,
+            input: part.args,
+        });
+    }
+    else if (part.type === "error") {
+        // AI SDK emits { type: "error", error: Error } when streaming fails
+        const errMsg = (part.error instanceof Error ? part.error.message : String(part.error)) ??
+            "Unknown stream error";
+        events.push({ type: "stop", reason: "error", error: errMsg });
+    }
+    else if (part.type === "finish") {
+        // Usage info may arrive on the finish step
+        if (part.usage) {
+            events.push({
+                type: "usage",
+                inputTokens: part.usage.promptTokens ?? 0,
+                outputTokens: part.usage.completionTokens ?? 0,
+                cacheReadTokens: part.usage.cacheReadTokens ?? 0,
+                cacheWriteTokens: part.usage.cacheWriteTokens ?? 0,
+            });
+        }
+        const reason = part.finishReason;
+        events.push({
+            type: "stop",
+            reason: reason === "tool-calls"
+                ? "tool_use"
+                : reason === "length"
+                    ? "max_tokens"
+                    : "end_turn",
+        });
+    }
+    return events;
+}
+// ---------------------------------------------------------------------------
+// AI SDK step result → EngineContentPart[] (assistant content for messages)
+// ---------------------------------------------------------------------------
+export function aiSdkStepToAssistantContent(step) {
+    const parts = [];
+    if (typeof step.text === "string" && step.text) {
+        parts.push({ type: "text", text: step.text });
+    }
+    if (Array.isArray(step.toolCalls)) {
+        for (const tc of step.toolCalls) {
+            parts.push({
+                type: "tool-call",
+                id: tc.toolCallId,
+                name: tc.toolName,
+                input: tc.args,
+            });
+        }
+    }
+    if (Array.isArray(step.reasoning)) {
+        for (const r of step.reasoning) {
+            if (r.type === "text") {
+                parts.push({ type: "thinking", text: r.text });
+            }
+        }
+    }
+    return parts;
+}
+//# sourceMappingURL=translate-ai-sdk.js.map

package/dist/agent/engine/translate-ai-sdk.js.map

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

package/dist/agent/engine/translate-anthropic.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Translation helpers between the AgentEngine normalized types and
+ * @anthropic-ai/sdk's wire types.
+ *
+ * AnthropicEngine does very little translation because the framework's
+ * EngineMessage / EngineTool shapes were modeled on Anthropic's types.
+ * The main differences are: camelCase vs snake_case, and that
+ * Anthropic uses `input_schema` while we use `inputSchema`.
+ */
+import type Anthropic from "@anthropic-ai/sdk";
+import type { EngineTool, EngineMessage, EngineContentPart, EngineEvent } from "./types.js";
+export declare function engineToolToAnthropic(tool: EngineTool): Anthropic.Tool;
+export declare function engineToolsToAnthropic(tools: EngineTool[]): Anthropic.Tool[];
+export declare function engineMessageToAnthropic(msg: EngineMessage): Anthropic.MessageParam;
+export declare function engineMessagesToAnthropic(messages: EngineMessage[]): Anthropic.MessageParam[];
+export declare function anthropicContentToEngine(content: Anthropic.ContentBlock[]): EngineContentPart[];
+/**
+ * Translate an Anthropic stream chunk into zero or more EngineEvents.
+ * Called in a loop as chunks arrive from client.messages.stream().
+ */
+export declare function anthropicChunkToEngineEvents(chunk: any): EngineEvent[];
+export declare function buildToolResultPart(toolCallId: string, content: string, isError?: boolean): EngineContentPart;
+//# sourceMappingURL=translate-anthropic.d.ts.map

package/dist/agent/engine/translate-anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate-anthropic.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/translate-anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAMpB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,IAAI,CAMtE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAE5E;AAMD,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,aAAa,GACjB,SAAS,CAAC,YAAY,CAKxB;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,aAAa,EAAE,GACxB,SAAS,CAAC,YAAY,EAAE,CAE1B;AAiDD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,CAAC,YAAY,EAAE,GAChC,iBAAiB,EAAE,CA0BrB;AAMD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,GAAG,GAAG,WAAW,EAAE,CAoBtE;AAMD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,UAAQ,GACd,iBAAiB,CAOnB"}

package/dist/agent/engine/translate-anthropic.js

@@ -0,0 +1,140 @@
+/**
+ * Translation helpers between the AgentEngine normalized types and
+ * @anthropic-ai/sdk's wire types.
+ *
+ * AnthropicEngine does very little translation because the framework's
+ * EngineMessage / EngineTool shapes were modeled on Anthropic's types.
+ * The main differences are: camelCase vs snake_case, and that
+ * Anthropic uses `input_schema` while we use `inputSchema`.
+ */
+// ---------------------------------------------------------------------------
+// EngineTool → Anthropic.Tool
+// ---------------------------------------------------------------------------
+export function engineToolToAnthropic(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        input_schema: tool.inputSchema,
+    };
+}
+export function engineToolsToAnthropic(tools) {
+    return tools.map(engineToolToAnthropic);
+}
+// ---------------------------------------------------------------------------
+// EngineMessage → Anthropic.MessageParam
+// ---------------------------------------------------------------------------
+export function engineMessageToAnthropic(msg) {
+    return {
+        role: msg.role,
+        content: msg.content.map(enginePartToAnthropic),
+    };
+}
+export function engineMessagesToAnthropic(messages) {
+    return messages.map(engineMessageToAnthropic);
+}
+function enginePartToAnthropic(part) {
+    switch (part.type) {
+        case "text":
+            return { type: "text", text: part.text };
+        case "image":
+            return {
+                type: "image",
+                source: {
+                    type: "base64",
+                    media_type: part.mediaType,
+                    data: part.data,
+                },
+            };
+        case "tool-call":
+            return {
+                type: "tool_use",
+                id: part.id,
+                name: part.name,
+                input: part.input,
+            }; // tool_use is a ContentBlockParam in Anthropic SDK
+        case "tool-result":
+            return {
+                type: "tool_result",
+                tool_use_id: part.toolCallId,
+                content: part.content,
+                ...(part.isError ? { is_error: true } : {}),
+            };
+        case "thinking":
+            // Anthropic thinking blocks — pass through with signature for context window continuity
+            return {
+                type: "thinking",
+                thinking: part.text,
+                signature: part.signature ?? "",
+            };
+    }
+}
+// ---------------------------------------------------------------------------
+// Anthropic.ContentBlock → EngineContentPart (from final message)
+// ---------------------------------------------------------------------------
+export function anthropicContentToEngine(content) {
+    return content
+        .map((block) => {
+        if (block.type === "text") {
+            return { type: "text", text: block.text };
+        }
+        if (block.type === "tool_use") {
+            return {
+                type: "tool-call",
+                id: block.id,
+                name: block.name,
+                input: block.input,
+            };
+        }
+        if (block.type === "thinking") {
+            const b = block;
+            return {
+                type: "thinking",
+                text: b.thinking ?? "",
+                signature: b.signature,
+            };
+        }
+        // Unknown block type — skip
+        return { type: "text", text: "" };
+    })
+        .filter((p) => !(p.type === "text" && p.text === ""));
+}
+// ---------------------------------------------------------------------------
+// Anthropic stream chunk → EngineEvent
+// ---------------------------------------------------------------------------
+/**
+ * Translate an Anthropic stream chunk into zero or more EngineEvents.
+ * Called in a loop as chunks arrive from client.messages.stream().
+ */
+export function anthropicChunkToEngineEvents(chunk) {
+    const events = [];
+    if (chunk.type === "content_block_delta") {
+        if (chunk.delta?.type === "text_delta") {
+            events.push({ type: "text-delta", text: chunk.delta.text });
+        }
+        else if (chunk.delta?.type === "thinking_delta") {
+            events.push({ type: "thinking-delta", text: chunk.delta.thinking ?? "" });
+        }
+        else if (chunk.delta?.type === "signature_delta") {
+            // Signature arrives after thinking — emit as a thinking-delta with empty text
+            // but carry the signature for the caller to store
+            events.push({
+                type: "thinking-delta",
+                text: "",
+                signature: chunk.delta.signature,
+            });
+        }
+    }
+    return events;
+}
+// ---------------------------------------------------------------------------
+// Build tool_result blocks to append to messages after tool dispatch
+// ---------------------------------------------------------------------------
+export function buildToolResultPart(toolCallId, content, isError = false) {
+    return {
+        type: "tool-result",
+        toolCallId,
+        content,
+        ...(isError ? { isError } : {}),
+    };
+}
+//# sourceMappingURL=translate-anthropic.js.map

package/dist/agent/engine/translate-anthropic.js.map

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

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

@@ -0,0 +1,168 @@
+/**
+ * Pluggable Agent Engine abstraction.
+ *
+ * AgentEngine is the thin LLM adapter that sits beneath runAgentLoop.
+ * Every caller (HTTP handler, A2A, MCP, sub-agents, webhooks, jobs) uses
+ * an AgentEngine instead of a raw @anthropic-ai/sdk client.
+ *
+ * The framework's tool dispatch loop, sub-agents, SSE event stream, and all
+ * other harness features live above this layer and are unaffected by engine
+ * selection.
+ */
+/**
+ * Engine-normalized tool definition. Structurally identical to Anthropic's
+ * Tool type, with snake_case renamed to camelCase for consistency.
+ */
+export interface EngineTool {
+    name: string;
+    description: string;
+    /** JSON Schema for the tool's input parameters */
+    inputSchema: {
+        type: "object";
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+    /**
+     * Provider-specific options for this tool.
+     * E.g. `{ anthropic: { cacheControl: { type: "ephemeral" } } }`
+     */
+    providerOptions?: Record<string, unknown>;
+}
+export interface EngineTextPart {
+    type: "text";
+    text: string;
+}
+export interface EngineImagePart {
+    type: "image";
+    /** Base64-encoded image data */
+    data: string;
+    mediaType: "image/jpeg" | "image/png" | "image/gif" | "image/webp";
+}
+export interface EngineToolCallPart {
+    type: "tool-call";
+    id: string;
+    name: string;
+    input: unknown;
+}
+export interface EngineToolResultPart {
+    type: "tool-result";
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+}
+export interface EngineThinkingPart {
+    type: "thinking";
+    text: string;
+    /** Opaque signature for pass-through on next turn (Anthropic extended thinking) */
+    signature?: string;
+}
+export type EngineContentPart = EngineTextPart | EngineImagePart | EngineToolCallPart | EngineToolResultPart | EngineThinkingPart;
+export type EngineMessage = {
+    role: "user";
+    content: EngineContentPart[];
+} | {
+    role: "assistant";
+    content: EngineContentPart[];
+};
+export type EngineEvent = {
+    type: "text-delta";
+    text: string;
+} | {
+    type: "thinking-delta";
+    text: string;
+    signature?: string;
+} | {
+    type: "tool-call";
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    type: "usage";
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+} | {
+    type: "stop";
+    reason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence" | "error";
+    error?: string;
+};
+export interface EngineCapabilities {
+    /** Extended / adaptive thinking support */
+    thinking: boolean;
+    /** Anthropic-style prompt caching (cache_control blocks) */
+    promptCaching: boolean;
+    /** Vision / image input */
+    vision: boolean;
+    /** Computer use tool support */
+    computerUse: boolean;
+    /** Multiple tool calls in a single response */
+    parallelToolCalls: boolean;
+}
+export interface EngineStreamOptions {
+    model: string;
+    systemPrompt: string;
+    messages: EngineMessage[];
+    tools: EngineTool[];
+    abortSignal: AbortSignal;
+    maxTokens?: number;
+    temperature?: number;
+    /**
+     * Provider-specific options passed opaquely.
+     * Engines forward options they understand and ignore unknown keys.
+     *
+     * Example (Anthropic):
+     * ```ts
+     * providerOptions: {
+     *   anthropic: {
+     *     thinking: { type: "enabled", budgetTokens: 8000 },
+     *     cacheControl: { type: "ephemeral" },
+     *   }
+     * }
+     * ```
+     */
+    providerOptions?: {
+        anthropic?: {
+            thinking?: {
+                type: "enabled";
+                budgetTokens: number;
+            };
+            cacheControl?: {
+                type: "ephemeral";
+            };
+            topK?: number;
+        };
+        openai?: Record<string, unknown>;
+        google?: Record<string, unknown>;
+        [provider: string]: Record<string, unknown> | undefined;
+    };
+}
+/**
+ * The pluggable LLM adapter interface.
+ *
+ * Each engine performs one LLM API round-trip per `stream()` call.
+ * The framework's runAgentLoop drives the tool-calling loop by calling
+ * stream() repeatedly with updated messages.
+ *
+ * Engines yield EngineEvent items as they receive them from the LLM.
+ * They MUST yield a `stop` event as the last item, even on error.
+ */
+export interface AgentEngine {
+    /** Unique identifier, e.g. "anthropic", "ai-sdk:anthropic", "ai-sdk:openai" */
+    readonly name: string;
+    /** Human-readable label for UI display */
+    readonly label: string;
+    /** Default model for this engine */
+    readonly defaultModel: string;
+    /** Models this engine supports */
+    readonly supportedModels: readonly string[];
+    /** Capability flags used to gate provider-specific features */
+    readonly capabilities: EngineCapabilities;
+    /**
+     * Stream a single LLM API call. Yields EngineEvent items.
+     * The caller (runAgentLoop) handles retries, tool dispatch, and looping.
+     */
+    stream(opts: EngineStreamOptions): AsyncIterable<EngineEvent>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/agent/engine/types.js

@@ -0,0 +1,13 @@
+/**
+ * Pluggable Agent Engine abstraction.
+ *
+ * AgentEngine is the thin LLM adapter that sits beneath runAgentLoop.
+ * Every caller (HTTP handler, A2A, MCP, sub-agents, webhooks, jobs) uses
+ * an AgentEngine instead of a raw @anthropic-ai/sdk client.
+ *
+ * The framework's tool dispatch loop, sub-agents, SSE event stream, and all
+ * other harness features live above this layer and are unaffected by engine
+ * selection.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/agent/index.d.ts

@@ -1,3 +1,3 @@
-export { createProductionAgentHandler, type ScriptEntry, type ProductionAgentOptions, } from "./production-agent.js";
-export { type ScriptTool, type AgentMessage, type AgentChatRequest, type AgentChatEvent, } from "./types.js";
+export { createProductionAgentHandler, type ActionEntry, type ScriptEntry, type ProductionAgentOptions, } from "./production-agent.js";
+export { type ActionTool, type ScriptTool, type AgentMessage, type AgentChatRequest, type AgentChatEvent, type AgentChatReference, type MentionProvider, type MentionProviderItem, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,KAAK,WAAW,EAChB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}

package/dist/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAG7B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAI7B,MAAM,uBAAuB,CAAC"}

package/dist/agent/production-agent.d.ts

@@ -1,16 +1,78 @@
 import type { EventHandler as H3EventHandler } from "h3";
-import type { ScriptTool } from "./types.js";
-export interface ScriptEntry {
-    tool: ScriptTool;
-    run: (args: Record<string, string>) => Promise<string>;
+import type { ActionTool, AgentChatEvent } from "./types.js";
+import type { AgentEngine, EngineTool, EngineMessage } from "./engine/types.js";
+import { subscribeToRun, getActiveRunForThread, getActiveRunForThreadAsync, getRun, abortRun } from "./run-manager.js";
+import type { ActiveRun } from "./run-manager.js";
+/** Context passed to action run() for emitting intermediate events */
+export interface ActionRunContext {
+    /** Emit an SSE event to the client (e.g., agent_call_text for streaming) */
+    send: (event: AgentChatEvent) => void;
 }
+export interface ActionEntry {
+    tool: ActionTool;
+    run: (args: Record<string, string>, context?: ActionRunContext) => Promise<any>;
+    /** HTTP exposure config. `false` = agent-only. Omitted = auto-inferred from name. */
+    http?: import("../action.js").ActionHttpConfig | false;
+}
+/** @deprecated Use `ActionEntry` instead */
+export type ScriptEntry = ActionEntry;
 export interface ProductionAgentOptions {
-    scripts: Record<string, ScriptEntry>;
-    systemPrompt: string;
-    /** Falls back to ANTHROPIC_API_KEY env var */
+    /** Action entries for the agent. Use `actions` (preferred) or `scripts` (deprecated alias). */
+    actions?: Record<string, ActionEntry>;
+    /** @deprecated Use `actions` instead */
+    scripts?: Record<string, ActionEntry>;
+    /** Static system prompt string, or async function called per-request with the H3 event */
+    systemPrompt: string | ((event: any) => string | Promise<string>);
+    /** Falls back to ANTHROPIC_API_KEY env var. Ignored when `engine` is provided. */
     apiKey?: string;
+    /** Agent engine to use. Defaults to the "anthropic" engine. */
+    engine?: AgentEngine | string | {
+        name: string;
+        config: Record<string, unknown>;
+    };
     /** Model to use. Default: claude-sonnet-4-6 */
     model?: string;
+    /** Provider-specific options passed through to the engine */
+    providerOptions?: EngineMessage extends never ? never : any;
+    /** Called when a run completes (for server-side thread persistence) */
+    onRunComplete?: (run: ActiveRun, threadId: string | undefined) => void;
+    /** Called when a run starts, with the send function for emitting events and the threadId */
+    onRunStart?: (send: (event: AgentChatEvent) => void, threadId: string) => void;
+    /** Resolve the owner email from the H3 event (for usage tracking) */
+    resolveOwnerEmail?: (event: any) => string | Promise<string>;
+    /** Enable per-user usage limit checking and token tracking */
+    trackUsage?: boolean;
+    /** Usage limit in cents (default: 100 = $1.00) */
+    usageLimitCents?: number;
 }
+/** Accumulated token usage from an agent loop run */
+export interface AgentLoopUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    model: string;
+}
+/**
+ * Convert ActionEntry registry to EngineTool array.
+ */
+export declare function actionsToEngineTools(actions: Record<string, ActionEntry>): EngineTool[];
+/**
+ * The core agent loop — calls the engine iteratively until no more tool calls.
+ * Decoupled from HTTP transport so it can run in the background.
+ * Returns accumulated token usage for cost tracking.
+ */
+export declare function runAgentLoop(opts: {
+    engine: AgentEngine;
+    model: string;
+    systemPrompt: string;
+    tools: EngineTool[];
+    messages: EngineMessage[];
+    actions: Record<string, ActionEntry>;
+    send: (event: AgentChatEvent) => void;
+    signal: AbortSignal;
+    providerOptions?: any;
+}): Promise<AgentLoopUsage>;
 export declare function createProductionAgentHandler(options: ProductionAgentOptions): H3EventHandler;
+export { getActiveRunForThread, getActiveRunForThreadAsync, getRun, abortRun, subscribeToRun, };
 //# sourceMappingURL=production-agent.d.ts.map