@agent-native/core 0.4.5 → 0.6.1

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

@@ -0,0 +1,169 @@
+/**
+ * AnthropicEngine — wraps @anthropic-ai/sdk for use as an AgentEngine.
+ *
+ * This is the default, best-in-class engine. It supports all Anthropic-native
+ * features: extended thinking, prompt caching, vision, computer use, and
+ * parallel tool calls.
+ *
+ * All providerOptions.anthropic fields are forwarded directly to the SDK.
+ */
+import { engineToolsToAnthropic, engineMessagesToAnthropic, anthropicContentToEngine, anthropicChunkToEngineEvents, } from "./translate-anthropic.js";
+export const ANTHROPIC_CAPABILITIES = {
+    thinking: true,
+    promptCaching: true,
+    vision: true,
+    computerUse: true,
+    parallelToolCalls: true,
+};
+export const ANTHROPIC_SUPPORTED_MODELS = [
+    "claude-opus-4-6",
+    "claude-sonnet-4-6",
+    "claude-haiku-4-5-20251001",
+    "claude-opus-4-5",
+    "claude-sonnet-4-5",
+    "claude-haiku-4-5",
+];
+export const ANTHROPIC_DEFAULT_MODEL = "claude-sonnet-4-6";
+class AnthropicEngine {
+    name = "anthropic";
+    label = "Claude (Anthropic SDK)";
+    defaultModel = ANTHROPIC_DEFAULT_MODEL;
+    supportedModels = ANTHROPIC_SUPPORTED_MODELS;
+    capabilities = ANTHROPIC_CAPABILITIES;
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async *stream(opts) {
+        const Anthropic = (await import("@anthropic-ai/sdk")).default;
+        const client = new Anthropic({ apiKey: this.apiKey });
+        const tools = engineToolsToAnthropic(opts.tools);
+        const messages = engineMessagesToAnthropic(opts.messages);
+        const anthropicOpts = opts.providerOptions?.anthropic;
+        // Build extra body params for Anthropic-native features
+        const extra = {};
+        if (anthropicOpts?.thinking) {
+            extra.thinking = {
+                type: anthropicOpts.thinking.type,
+                budget_tokens: anthropicOpts.thinking.budgetTokens,
+            };
+        }
+        if (anthropicOpts?.topK !== undefined) {
+            extra.top_k = anthropicOpts.topK;
+        }
+        // Apply prompt caching to the system prompt if requested.
+        // We pass the system prompt as a structured array so we can add cache_control.
+        const systemBlocks = [{ type: "text", text: opts.systemPrompt }];
+        if (anthropicOpts?.cacheControl) {
+            systemBlocks[0].cache_control = { type: "ephemeral" };
+        }
+        // Apply cache_control to the last tool definition when caching is enabled.
+        // Anthropic caches the prefix up to and including the last cached block.
+        let cachedTools = tools;
+        if (anthropicOpts?.cacheControl && tools.length > 0) {
+            cachedTools = [...tools];
+            const last = { ...cachedTools[cachedTools.length - 1] };
+            last.cache_control = { type: "ephemeral" };
+            cachedTools[cachedTools.length - 1] = last;
+        }
+        const requestParams = {
+            model: opts.model,
+            max_tokens: opts.maxTokens ?? 16384,
+            system: systemBlocks,
+            tools: cachedTools.length > 0 ? cachedTools : undefined,
+            messages,
+            ...(opts.temperature !== undefined
+                ? { temperature: opts.temperature }
+                : {}),
+            ...extra,
+        };
+        // Remove undefined tools to avoid Anthropic API validation errors
+        if (!requestParams.tools)
+            delete requestParams.tools;
+        const apiStream = client.messages.stream(requestParams, {
+            signal: opts.abortSignal,
+        });
+        let thinkingText = "";
+        let thinkingSignature = "";
+        try {
+            for await (const chunk of apiStream) {
+                const events = anthropicChunkToEngineEvents(chunk);
+                for (const event of events) {
+                    if (event.type === "thinking-delta") {
+                        thinkingText += event.text;
+                        if (event.signature)
+                            thinkingSignature = event.signature;
+                    }
+                    yield event;
+                }
+            }
+            const finalMessage = await apiStream.finalMessage();
+            const assistantContent = anthropicContentToEngine(finalMessage.content);
+            // Emit usage
+            if (finalMessage.usage) {
+                yield {
+                    type: "usage",
+                    inputTokens: finalMessage.usage.input_tokens ?? 0,
+                    outputTokens: finalMessage.usage.output_tokens ?? 0,
+                    cacheReadTokens: finalMessage.usage.cache_read_input_tokens ?? 0,
+                    cacheWriteTokens: finalMessage.usage.cache_creation_input_tokens ?? 0,
+                };
+            }
+            // Emit stop reason
+            const stopReason = finalMessage.stop_reason ?? "end_turn";
+            yield {
+                type: "stop",
+                reason: stopReason === "tool_use"
+                    ? "tool_use"
+                    : stopReason === "max_tokens"
+                        ? "max_tokens"
+                        : "end_turn",
+            };
+            // Store the final assistant content for the caller via a side channel.
+            // runAgentLoop reads this via the assistantContentRef passed in opts.
+            // We attach it as a non-enumerable symbol property.
+            opts[ASSISTANT_CONTENT_KEY] = assistantContent;
+        }
+        catch (err) {
+            yield {
+                type: "stop",
+                reason: "error",
+                error: err?.message ?? String(err),
+            };
+            throw err;
+        }
+    }
+}
+/**
+ * Symbol used by AnthropicEngine to return the final assistant content blocks
+ * back to runAgentLoop without changing the EngineEvent stream shape.
+ */
+export const ASSISTANT_CONTENT_KEY = Symbol("assistantContent");
+/**
+ * Create an AnthropicEngine instance.
+ * Falls back to ANTHROPIC_API_KEY env var if no key is provided.
+ */
+export function createAnthropicEngine(config = {}) {
+    const apiKey = config.apiKey ??
+        process.env.ANTHROPIC_API_KEY ??
+        "";
+    if (!apiKey) {
+        // Return a "missing key" engine that immediately errors
+        return {
+            name: "anthropic",
+            label: "Claude (Anthropic SDK)",
+            defaultModel: ANTHROPIC_DEFAULT_MODEL,
+            supportedModels: ANTHROPIC_SUPPORTED_MODELS,
+            capabilities: ANTHROPIC_CAPABILITIES,
+            async *stream() {
+                yield {
+                    type: "stop",
+                    reason: "error",
+                    error: "ANTHROPIC_API_KEY is not set",
+                };
+            },
+        };
+    }
+    return new AnthropicEngine(apiKey);
+}
+//# sourceMappingURL=anthropic-engine.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Registers built-in agent engines (anthropic, ai-sdk:*) into the global registry.
+ *
+ * This module is imported once at server startup via the agent-chat plugin.
+ * Additional engines can be registered by calling registerAgentEngine() from
+ * any server plugin after startup.
+ */
+/**
+ * Register all built-in engines. Safe to call multiple times (idempotent).
+ */
+export declare function registerBuiltinEngines(): void;
+//# sourceMappingURL=builtin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/builtin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAgE7C"}

package/dist/agent/engine/builtin.js

@@ -0,0 +1,72 @@
+/**
+ * Registers built-in agent engines (anthropic, ai-sdk:*) into the global registry.
+ *
+ * This module is imported once at server startup via the agent-chat plugin.
+ * Additional engines can be registered by calling registerAgentEngine() from
+ * any server plugin after startup.
+ */
+import { registerAgentEngine } from "./registry.js";
+import { createAnthropicEngine, ANTHROPIC_CAPABILITIES, ANTHROPIC_DEFAULT_MODEL, ANTHROPIC_SUPPORTED_MODELS, } from "./anthropic-engine.js";
+import { createAISDKEngine, PROVIDER_CAPABILITIES, PROVIDER_DEFAULT_MODELS, PROVIDER_SUPPORTED_MODELS, PROVIDER_ENV_VARS, PROVIDER_PACKAGES, } from "./ai-sdk-engine.js";
+let _registered = false;
+/**
+ * Register all built-in engines. Safe to call multiple times (idempotent).
+ */
+export function registerBuiltinEngines() {
+    if (_registered)
+        return;
+    _registered = true;
+    // ── Anthropic (default) ────────────────────────────────────────────────────
+    registerAgentEngine({
+        name: "anthropic",
+        label: "Claude (Anthropic SDK)",
+        description: "Anthropic's SDK — best-in-class Claude models with full feature support (thinking, prompt caching, vision, computer use).",
+        capabilities: ANTHROPIC_CAPABILITIES,
+        defaultModel: ANTHROPIC_DEFAULT_MODEL,
+        supportedModels: ANTHROPIC_SUPPORTED_MODELS,
+        requiredEnvVars: ["ANTHROPIC_API_KEY"],
+        create: (config) => createAnthropicEngine(config),
+    });
+    // ── Vercel AI SDK providers ────────────────────────────────────────────────
+    const aiSdkProviders = [
+        "anthropic",
+        "openai",
+        "google",
+        "groq",
+        "mistral",
+        "cohere",
+        "ollama",
+    ];
+    const providerLabels = {
+        anthropic: "Claude via AI SDK",
+        openai: "OpenAI (AI SDK)",
+        google: "Google Gemini (AI SDK)",
+        groq: "Groq (AI SDK)",
+        mistral: "Mistral (AI SDK)",
+        cohere: "Cohere (AI SDK)",
+        ollama: "Ollama (local, AI SDK)",
+    };
+    const providerDescriptions = {
+        anthropic: "Claude models through the Vercel AI SDK. Supports thinking and caching via AI SDK providerOptions.",
+        openai: "OpenAI GPT models via the Vercel AI SDK. Requires OPENAI_API_KEY.",
+        google: "Google Gemini models via the Vercel AI SDK. Requires GOOGLE_GENERATIVE_AI_API_KEY.",
+        groq: "Groq LPU inference via the Vercel AI SDK. Requires GROQ_API_KEY.",
+        mistral: "Mistral models via the Vercel AI SDK. Requires MISTRAL_API_KEY.",
+        cohere: "Cohere Command models via the Vercel AI SDK. Requires COHERE_API_KEY.",
+        ollama: "Local Ollama models via the Vercel AI SDK. No API key required.",
+    };
+    for (const provider of aiSdkProviders) {
+        registerAgentEngine({
+            name: `ai-sdk:${provider}`,
+            label: providerLabels[provider],
+            description: providerDescriptions[provider],
+            installPackage: `ai ${PROVIDER_PACKAGES[provider]}`,
+            capabilities: PROVIDER_CAPABILITIES[provider],
+            defaultModel: PROVIDER_DEFAULT_MODELS[provider],
+            supportedModels: PROVIDER_SUPPORTED_MODELS[provider],
+            requiredEnvVars: PROVIDER_ENV_VARS[provider],
+            create: (config) => createAISDKEngine(provider, config),
+        });
+    }
+}
+//# sourceMappingURL=builtin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.js","sourceRoot":"","sources":["../../../src/agent/engine/builtin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAE5B,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,WAAW;QAAE,OAAO;IACxB,WAAW,GAAG,IAAI,CAAC;IAEnB,8EAA8E;IAC9E,mBAAmB,CAAC;QAClB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,2HAA2H;QAC7H,YAAY,EAAE,sBAAsB;QACpC,YAAY,EAAE,uBAAuB;QACrC,eAAe,EAAE,0BAA0B;QAC3C,eAAe,EAAE,CAAC,mBAAmB,CAAC;QACtC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC;KAClD,CAAC,CAAC;IAEH,8EAA8E;IAC9E,MAAM,cAAc,GAAoB;QACtC,WAAW;QACX,QAAQ;QACR,QAAQ;QACR,MAAM;QACN,SAAS;QACT,QAAQ;QACR,QAAQ;KACT,CAAC;IAEF,MAAM,cAAc,GAAkC;QACpD,SAAS,EAAE,mBAAmB;QAC9B,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,wBAAwB;QAChC,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,wBAAwB;KACjC,CAAC;IAEF,MAAM,oBAAoB,GAAkC;QAC1D,SAAS,EACP,oGAAoG;QACtG,MAAM,EAAE,mEAAmE;QAC3E,MAAM,EACJ,oFAAoF;QACtF,IAAI,EAAE,kEAAkE;QACxE,OAAO,EAAE,iEAAiE;QAC1E,MAAM,EACJ,uEAAuE;QACzE,MAAM,EAAE,iEAAiE;KAC1E,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;QACtC,mBAAmB,CAAC;YAClB,IAAI,EAAE,UAAU,QAAQ,EAAE;YAC1B,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC;YAC/B,WAAW,EAAE,oBAAoB,CAAC,QAAQ,CAAC;YAC3C,cAAc,EAAE,MAAM,iBAAiB,CAAC,QAAQ,CAAC,EAAE;YACnD,YAAY,EAAE,qBAAqB,CAAC,QAAQ,CAAC;YAC7C,YAAY,EAAE,uBAAuB,CAAC,QAAQ,CAAC;YAC/C,eAAe,EAAE,yBAAyB,CAAC,QAAQ,CAAC;YACpD,eAAe,EAAE,iBAAiB,CAAC,QAAQ,CAAC;YAC5C,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Public exports for the pluggable agent engine system.
+ */
+export type { AgentEngine, EngineCapabilities, EngineTool, EngineMessage, EngineContentPart, EngineTextPart, EngineImagePart, EngineToolCallPart, EngineToolResultPart, EngineThinkingPart, EngineEvent, EngineStreamOptions, } from "./types.js";
+export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, type AgentEngineEntry, type ResolveEngineConfig, } from "./registry.js";
+export { createAnthropicEngine, ANTHROPIC_DEFAULT_MODEL, ANTHROPIC_SUPPORTED_MODELS, ANTHROPIC_CAPABILITIES, } from "./anthropic-engine.js";
+export { createAISDKEngine, type AISDKProvider } from "./ai-sdk-engine.js";
+export { registerBuiltinEngines } from "./builtin.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/agent/engine/index.js

@@ -0,0 +1,8 @@
+/**
+ * Public exports for the pluggable agent engine system.
+ */
+export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, } from "./registry.js";
+export { createAnthropicEngine, ANTHROPIC_DEFAULT_MODEL, ANTHROPIC_SUPPORTED_MODELS, ANTHROPIC_CAPABILITIES, } from "./anthropic-engine.js";
+export { createAISDKEngine } from "./ai-sdk-engine.js";
+export { registerBuiltinEngines } from "./builtin.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,GAGd,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAsB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,61 @@
+/**
+ * Agent Engine Registry.
+ *
+ * Mirrors the CLI_REGISTRY pattern (packages/core/src/terminal/cli-registry.ts)
+ * but is open — anyone can register a custom engine via registerAgentEngine()
+ * from a server plugin at startup.
+ *
+ * Built-in engines (anthropic, ai-sdk) are auto-registered by builtin.ts.
+ */
+import type { AgentEngine, EngineCapabilities } from "./types.js";
+export interface AgentEngineEntry {
+    /** Unique name, e.g. "anthropic", "ai-sdk:anthropic", "ai-sdk:openai" */
+    name: string;
+    /** Human-readable label for UI */
+    label: string;
+    /** Short description for engine picker */
+    description: string;
+    /** npm package hint displayed in UI when package is missing */
+    installPackage?: string;
+    /** Engine capabilities */
+    capabilities: EngineCapabilities;
+    /** Default model string */
+    defaultModel: string;
+    /** All supported models (shown in model picker) */
+    supportedModels: readonly string[];
+    /** Environment variables required for this engine to work */
+    requiredEnvVars: string[];
+    /** Create an engine instance from config */
+    create(config: Record<string, unknown>): AgentEngine;
+}
+/**
+ * Register a custom agent engine. Called at server startup (e.g., from a
+ * server plugin or builtin.ts). Throws if name is already registered.
+ */
+export declare function registerAgentEngine(entry: AgentEngineEntry): void;
+/** Get a registered engine entry by name, or undefined if not found */
+export declare function getAgentEngineEntry(name: string): AgentEngineEntry | undefined;
+/** List all registered engine entries */
+export declare function listAgentEngines(): AgentEngineEntry[];
+export interface ResolveEngineConfig {
+    /** Explicit engine name or instance from createAgentChatPlugin options */
+    engineOption?: string | AgentEngine | {
+        name: string;
+        config: Record<string, unknown>;
+    };
+    /** API key (used as config for the resolved engine) */
+    apiKey?: string;
+    /** Model override (used as part of engine config) */
+    model?: string;
+}
+/**
+ * Resolve an AgentEngine from options → settings → env → default.
+ *
+ * Resolution order:
+ * 1. Explicit `engineOption` from plugin options (string name, instance, or {name, config})
+ * 2. Settings store key "agent-engine" → { engine: string }
+ * 3. Env var AGENT_ENGINE
+ * 4. Default "anthropic" (requires ANTHROPIC_API_KEY)
+ */
+export declare function resolveEngine(config: ResolveEngineConfig): Promise<AgentEngine>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,YAAY,EAAE,kBAAkB,CAAC;IACjC,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,6DAA6D;IAC7D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,4CAA4C;IAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC;CACtD;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAajE;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,SAAS,CAE9B;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,IAAI,gBAAgB,EAAE,CAErD;AAED,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,YAAY,CAAC,EACT,MAAM,GACN,WAAW,GACX;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACtD,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAwEtB"}

package/dist/agent/engine/registry.js

@@ -0,0 +1,101 @@
+/**
+ * Agent Engine Registry.
+ *
+ * Mirrors the CLI_REGISTRY pattern (packages/core/src/terminal/cli-registry.ts)
+ * but is open — anyone can register a custom engine via registerAgentEngine()
+ * from a server plugin at startup.
+ *
+ * Built-in engines (anthropic, ai-sdk) are auto-registered by builtin.ts.
+ */
+import { getSetting } from "../../settings/store.js";
+const _registry = new Map();
+/**
+ * Register a custom agent engine. Called at server startup (e.g., from a
+ * server plugin or builtin.ts). Throws if name is already registered.
+ */
+export function registerAgentEngine(entry) {
+    if (_registry.has(entry.name)) {
+        // Allow re-registration in tests / hot-reload — just overwrite
+        if (process.env.NODE_ENV === "test") {
+            _registry.set(entry.name, entry);
+            return;
+        }
+        console.warn(`[agent-engine] Engine "${entry.name}" is already registered. Skipping.`);
+        return;
+    }
+    _registry.set(entry.name, entry);
+}
+/** Get a registered engine entry by name, or undefined if not found */
+export function getAgentEngineEntry(name) {
+    return _registry.get(name);
+}
+/** List all registered engine entries */
+export function listAgentEngines() {
+    return Array.from(_registry.values());
+}
+/**
+ * Resolve an AgentEngine from options → settings → env → default.
+ *
+ * Resolution order:
+ * 1. Explicit `engineOption` from plugin options (string name, instance, or {name, config})
+ * 2. Settings store key "agent-engine" → { engine: string }
+ * 3. Env var AGENT_ENGINE
+ * 4. Default "anthropic" (requires ANTHROPIC_API_KEY)
+ */
+export async function resolveEngine(config) {
+    const { engineOption, apiKey, model: _model } = config;
+    // 1. Explicit instance passed directly
+    if (engineOption &&
+        typeof engineOption === "object" &&
+        "stream" in engineOption) {
+        return engineOption;
+    }
+    // 2. Explicit {name, config} object
+    if (engineOption &&
+        typeof engineOption === "object" &&
+        "name" in engineOption) {
+        const { name, config: engineConfig } = engineOption;
+        const entry = _registry.get(name);
+        if (!entry)
+            throw new Error(`[agent-engine] Unknown engine: "${name}". Registered: ${[..._registry.keys()].join(", ")}`);
+        return entry.create({ apiKey, ...engineConfig });
+    }
+    // 3. Explicit string name from options
+    if (typeof engineOption === "string") {
+        const entry = _registry.get(engineOption);
+        if (!entry)
+            throw new Error(`[agent-engine] Unknown engine: "${engineOption}". Registered: ${[..._registry.keys()].join(", ")}`);
+        return entry.create({ apiKey });
+    }
+    // 4. Settings store
+    try {
+        const stored = await getSetting("agent-engine");
+        if (stored && typeof stored.engine === "string") {
+            const entry = _registry.get(stored.engine);
+            if (entry) {
+                const storedApiKey = stored.apiKey ?? apiKey;
+                return entry.create({
+                    apiKey: storedApiKey,
+                    ...(stored.config ?? {}),
+                });
+            }
+        }
+    }
+    catch {
+        // Settings not available — fall through
+    }
+    // 5. Env var
+    const envEngine = process.env.AGENT_ENGINE;
+    if (envEngine) {
+        const entry = _registry.get(envEngine);
+        if (entry)
+            return entry.create({ apiKey });
+    }
+    // 6. Default: anthropic
+    const anthropicEntry = _registry.get("anthropic");
+    if (!anthropicEntry) {
+        throw new Error("[agent-engine] Default Anthropic engine is not registered. Did builtin.ts fail to load?");
+    }
+    return anthropicEntry.create({ apiKey });
+}
+//# sourceMappingURL=registry.js.map

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

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

package/dist/agent/engine/translate-ai-sdk.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Translation helpers between AgentEngine normalized types and
+ * Vercel AI SDK (ai package) types.
+ */
+import type { EngineTool, EngineMessage, EngineContentPart } from "./types.js";
+/**
+ * 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 declare function engineToolsToAISDK(tools: EngineTool[], jsonSchema?: (schema: Record<string, unknown>) => unknown): Record<string, any>;
+export declare function engineMessageToAISDK(msg: EngineMessage): any;
+export declare function engineMessagesToAISDK(messages: EngineMessage[]): any[];
+export declare function aiSdkPartToEngineEvents(part: any): import("./types.js").EngineEvent[];
+export declare function aiSdkStepToAssistantContent(step: any): EngineContentPart[];
+//# sourceMappingURL=translate-ai-sdk.d.ts.map

package/dist/agent/engine/translate-ai-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate-ai-sdk.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/translate-ai-sdk.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAM/E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EAAE,EACnB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GACxD,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAcrB;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,CAyD5D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,GAAG,EAAE,CAEtE;AAMD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,GAAG,GACR,OAAO,YAAY,EAAE,WAAW,EAAE,CA+CpC;AAMD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,GAAG,GAAG,iBAAiB,EAAE,CA2B1E"}