@agent-native/core 0.7.11 → 0.7.13

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

@@ -0,0 +1,430 @@
+/**
+ * BuilderEngine — HTTP client for the Builder.io managed LLM gateway.
+ *
+ * The gateway accepts an Anthropic-shaped request body and streams events as
+ * JSONL. This engine translates the framework's EngineStreamOptions into the
+ * gateway request, parses the streamed events into EngineEvent items, and
+ * maps gateway error responses (402 quota, 403 disabled, 401 auth, 429
+ * concurrency) into structured stop events that carry an upgrade URL when
+ * the chat UI needs to prompt the user to upgrade.
+ *
+ * Credentials come from BUILDER_PRIVATE_KEY (set via the Builder CLI-auth
+ * onboarding flow). Base URL is overridable via BUILDER_GATEWAY_BASE_URL.
+ */
+import { engineMessagesToAnthropic, engineToolsToAnthropic, } from "./translate-anthropic.js";
+import { getBuilderAuthHeader, getBuilderGatewayBaseUrl, } from "../../server/credential-provider.js";
+import { getSetting } from "../../settings/store.js";
+export const BUILDER_CAPABILITIES = {
+    thinking: true,
+    // TODO: flip to true once we forward `cache_control` blocks through to
+    // the gateway request body. Today the engine builds the Anthropic-shaped
+    // body without cache_control markers, and Anthropic caching is opt-in
+    // (not automatic), so claiming `promptCaching: true` would overpromise.
+    promptCaching: false,
+    vision: true,
+    computerUse: false,
+    parallelToolCalls: true,
+};
+export const BUILDER_SUPPORTED_MODELS = [
+    "claude-opus-4-7",
+    "claude-sonnet-4-6",
+    "claude-haiku-4-5",
+    "gpt-5-4",
+    "gpt-5-4-mini",
+    "gpt-5-1-codex-mini",
+    "gemini-3-1-pro",
+    "gemini-3-0-flash",
+    "grok-code-fast",
+    "qwen3-coder",
+    "kimi-k2-5",
+    "deepseek-v3-1",
+    "z-ai-glm-4-5",
+];
+export const BUILDER_DEFAULT_MODEL = "claude-sonnet-4-6";
+/**
+ * Bucket an Anthropic `thinking.budgetTokens` value into the gateway's
+ * three-level `reasoning_effort` enum (low / medium / high).
+ *
+ * The thresholds are chosen to align with typical Anthropic extended-thinking
+ * budgets we see in the wild:
+ *   • < 2000  → short one-step reasoning ("low")
+ *   • 2000–8000 → multi-step thinking ("medium")
+ *   • ≥ 8000  → deep planning / long chains ("high")
+ *
+ * 8000 is Anthropic's documented default in our framework (see
+ * engine/types.ts:195), so callers that don't explicitly set
+ * `budgetTokens` map to "high" via the default. If the gateway later
+ * exposes more granular knobs or different thresholds, revisit this map.
+ */
+function mapReasoningEffort(budgetTokens) {
+    if (budgetTokens < 2000)
+        return "low";
+    if (budgetTokens < 8000)
+        return "medium";
+    return "high";
+}
+/**
+ * Build the URL the chat UI should link to when a user hits a quota error.
+ * Deep-links to the connected org's billing page when BUILDER_ORG_NAME is
+ * known, else falls back to the generic account billing page.
+ */
+function buildUpgradeUrl() {
+    const orgName = process.env.BUILDER_ORG_NAME;
+    if (orgName) {
+        return `https://builder.io/app/organizations/${encodeURIComponent(orgName)}/billing`;
+    }
+    return "https://builder.io/account/billing";
+}
+class BuilderEngine {
+    name = "builder";
+    label = "Builder.io Gateway";
+    defaultModel = BUILDER_DEFAULT_MODEL;
+    supportedModels = BUILDER_SUPPORTED_MODELS;
+    capabilities = BUILDER_CAPABILITIES;
+    async *stream(opts) {
+        // Honor the SQL disconnect flag even when BUILDER_PRIVATE_KEY is still
+        // in process.env (nitro dev env-runner can preserve it across reloads
+        // — see core-routes-plugin.ts plugin init).
+        try {
+            const disconnected = await getSetting("builder-disconnected");
+            if (disconnected) {
+                yield {
+                    type: "stop",
+                    reason: "error",
+                    error: "Builder is disconnected. Reconnect in Settings → LLM to use the Builder gateway.",
+                    errorCode: "missing_credentials",
+                };
+                return;
+            }
+        }
+        catch {
+            // DB not reachable — proceed with env-based check below.
+        }
+        const authHeader = getBuilderAuthHeader();
+        if (!authHeader) {
+            yield {
+                type: "stop",
+                reason: "error",
+                error: "BUILDER_PRIVATE_KEY is not set",
+                errorCode: "missing_credentials",
+            };
+            return;
+        }
+        const messages = engineMessagesToAnthropic(opts.messages);
+        const tools = engineToolsToAnthropic(opts.tools);
+        const thinkingBudget = opts.providerOptions?.anthropic?.thinking?.budgetTokens;
+        const body = {
+            model: opts.model,
+            messages,
+            ...(opts.systemPrompt ? { system: opts.systemPrompt } : {}),
+            ...(tools.length > 0 ? { tools } : {}),
+            ...(opts.maxOutputTokens !== undefined
+                ? { max_tokens: opts.maxOutputTokens }
+                : {}),
+            ...(typeof thinkingBudget === "number"
+                ? { reasoning_effort: mapReasoningEffort(thinkingBudget) }
+                : {}),
+        };
+        const gatewayBaseUrl = getBuilderGatewayBaseUrl();
+        const orgLabel = process.env.BUILDER_ORG_NAME || "unknown-org";
+        const tStart = Date.now();
+        console.log(`[builder-engine] → POST ${gatewayBaseUrl}/messages model=${opts.model} tools=${tools.length} org=${orgLabel}`);
+        let response;
+        try {
+            response = await fetch(`${gatewayBaseUrl}/messages`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: authHeader,
+                },
+                body: JSON.stringify(body),
+                signal: opts.abortSignal,
+            });
+        }
+        catch (err) {
+            yield {
+                type: "stop",
+                reason: "error",
+                error: err instanceof Error ? err.message : String(err),
+            };
+            return;
+        }
+        console.log(`[builder-engine] ← ${response.status} ${response.statusText} in ${Date.now() - tStart}ms`);
+        if (!response.ok) {
+            yield* emitHttpError(response);
+            return;
+        }
+        const reader = response.body?.getReader();
+        if (!reader) {
+            yield {
+                type: "stop",
+                reason: "error",
+                error: "Builder gateway response has no body",
+            };
+            return;
+        }
+        yield* parseJsonlStream(reader);
+    }
+}
+async function* emitHttpError(response) {
+    const status = response.status;
+    // Read the body once as text and then try to parse — calling `.json()`
+    // and then `.text()` as a fallback fails because the body stream is
+    // already consumed (TypeError: Body has already been read), so we'd
+    // silently lose non-JSON error payloads like HTML proxy 502s.
+    let errBody = {};
+    const rawText = await response.text().catch(() => "");
+    if (rawText) {
+        try {
+            errBody = JSON.parse(rawText);
+        }
+        catch {
+            errBody.message = rawText;
+        }
+    }
+    const code = errBody.code ?? `http_${status}`;
+    const message = errBody.message ?? `Builder gateway returned ${status}`;
+    // Belt-and-suspenders: 402 without a structured `credits-limit` code
+    // (e.g. bare proxy response) still means quota → show upgrade CTA.
+    if (code.startsWith("credits-limit") || status === 402) {
+        yield {
+            type: "stop",
+            reason: "error",
+            error: message,
+            errorCode: code,
+            upgradeUrl: buildUpgradeUrl(),
+        };
+        return;
+    }
+    if (code === "gateway_not_enabled") {
+        yield {
+            type: "stop",
+            reason: "error",
+            error: message,
+            errorCode: code,
+        };
+        return;
+    }
+    if (status === 401 || code === "unauthorized") {
+        yield {
+            type: "stop",
+            reason: "error",
+            error: message ||
+                "Builder authentication failed. Reconnect Builder via Settings → LLM.",
+            errorCode: "unauthorized",
+        };
+        return;
+    }
+    if (status === 403) {
+        yield {
+            type: "stop",
+            reason: "error",
+            error: message,
+            errorCode: code,
+        };
+        return;
+    }
+    if (status === 429 || code === "too_many_concurrent_requests") {
+        // Include "too many requests" in the message so production-agent's
+        // isRetryableError picks it up and retries the turn.
+        yield {
+            type: "stop",
+            reason: "error",
+            error: `${message} (too many requests)`,
+            errorCode: code,
+        };
+        return;
+    }
+    yield {
+        type: "stop",
+        reason: "error",
+        error: message,
+        errorCode: code,
+    };
+}
+// Yields one non-empty JSONL line at a time. Flushes any trailing content
+// after the stream ends so a final event without a newline terminator
+// isn't silently dropped — some gateway proxies close the connection on
+// a complete line and the client must still process it.
+async function* readJsonlLines(reader) {
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        let newlineIdx = buffer.indexOf("\n");
+        while (newlineIdx !== -1) {
+            const line = buffer.slice(0, newlineIdx).trim();
+            buffer = buffer.slice(newlineIdx + 1);
+            newlineIdx = buffer.indexOf("\n");
+            if (line)
+                yield line;
+        }
+    }
+    const tail = buffer.trim();
+    if (tail)
+        yield tail;
+}
+async function* parseJsonlStream(reader) {
+    const parts = [];
+    let pendingText = "";
+    let pendingThinking = null;
+    const flushPending = () => {
+        if (pendingText) {
+            parts.push({ type: "text", text: pendingText });
+            pendingText = "";
+        }
+        if (pendingThinking) {
+            parts.push({
+                type: "thinking",
+                text: pendingThinking.text,
+                ...(pendingThinking.signature !== undefined
+                    ? { signature: pendingThinking.signature }
+                    : {}),
+            });
+            pendingThinking = null;
+        }
+    };
+    try {
+        for await (const line of readJsonlLines(reader)) {
+            let event;
+            try {
+                event = JSON.parse(line);
+            }
+            catch {
+                yield {
+                    type: "stop",
+                    reason: "error",
+                    error: `Builder gateway emitted invalid JSONL: ${line}`,
+                };
+                return;
+            }
+            switch (event.type) {
+                case "text-delta": {
+                    const text = event.text ?? "";
+                    pendingText += text;
+                    yield { type: "text-delta", text };
+                    break;
+                }
+                case "thinking-delta": {
+                    const text = event.text ?? "";
+                    if (!pendingThinking)
+                        pendingThinking = { text: "" };
+                    pendingThinking.text += text;
+                    if (event.signature)
+                        pendingThinking.signature = event.signature;
+                    yield {
+                        type: "thinking-delta",
+                        text,
+                        ...(event.signature ? { signature: event.signature } : {}),
+                    };
+                    break;
+                }
+                case "tool-call-delta":
+                    // Engine contract has no equivalent; drop. The authoritative
+                    // `tool-call` event follows with the fully-parsed input.
+                    break;
+                case "tool-call": {
+                    flushPending();
+                    parts.push({
+                        type: "tool-call",
+                        id: event.id,
+                        name: event.name,
+                        input: event.input,
+                    });
+                    yield {
+                        type: "tool-call",
+                        id: event.id,
+                        name: event.name,
+                        input: event.input,
+                    };
+                    break;
+                }
+                case "usage": {
+                    const cacheWrite = (event.cacheCreatedTokens ?? 0) + (event.cacheCreated1hTokens ?? 0);
+                    yield {
+                        type: "usage",
+                        inputTokens: event.inputTokens ?? 0,
+                        outputTokens: event.outputTokens ?? 0,
+                        ...(event.cacheInputTokens !== undefined
+                            ? { cacheReadTokens: event.cacheInputTokens }
+                            : {}),
+                        ...(cacheWrite > 0 ? { cacheWriteTokens: cacheWrite } : {}),
+                    };
+                    break;
+                }
+                case "stop": {
+                    flushPending();
+                    yield { type: "assistant-content", parts };
+                    const reason = event.reason ?? "end_turn";
+                    if (reason === "rate_limited") {
+                        // Include "rate_limit" in the message so production-agent's
+                        // isRetryableError picks it up and retries.
+                        yield {
+                            type: "stop",
+                            reason: "error",
+                            error: `rate_limit exceeded: ${event.error ?? "upstream provider rate limited"}`,
+                            errorCode: "rate_limited",
+                        };
+                    }
+                    else if (reason === "error") {
+                        yield {
+                            type: "stop",
+                            reason: "error",
+                            error: event.error ?? "Gateway error",
+                        };
+                    }
+                    else if (reason === "end_turn" ||
+                        reason === "tool_use" ||
+                        reason === "max_tokens" ||
+                        reason === "stop_sequence") {
+                        yield { type: "stop", reason };
+                    }
+                    else {
+                        yield {
+                            type: "stop",
+                            reason: "error",
+                            error: `Unknown stop reason: ${reason}`,
+                        };
+                    }
+                    return;
+                }
+                default:
+                    // Unknown event type — ignore for forward compat.
+                    break;
+            }
+        }
+        // Stream ended without a stop event — synthesize one so callers don't hang.
+        flushPending();
+        yield { type: "assistant-content", parts };
+        yield {
+            type: "stop",
+            reason: "error",
+            error: "Builder gateway stream ended without a stop event",
+        };
+    }
+    catch (err) {
+        yield {
+            type: "stop",
+            reason: "error",
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        // Release the reader on every exit path — early returns (invalid JSONL,
+        // stop event) and generator abandonment both leave the underlying
+        // Response body locked otherwise. cancel() also closes the socket.
+        try {
+            await reader.cancel();
+        }
+        catch {
+            // Already cancelled or closed
+        }
+    }
+}
+export function createBuilderEngine(_config = {}) {
+    return new BuilderEngine();
+}
+//# sourceMappingURL=builder-engine.js.map

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

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

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

@@ -1 +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,CAoE7C"}
+{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/builtin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAqF7C"}

package/dist/agent/engine/builtin.js

@@ -8,6 +8,7 @@
 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";
+import { createBuilderEngine, BUILDER_CAPABILITIES, BUILDER_DEFAULT_MODEL, BUILDER_SUPPORTED_MODELS, } from "./builder-engine.js";
 let _registered = false;
 /**
  * Register all built-in engines. Safe to call multiple times (idempotent).
@@ -16,10 +17,25 @@ export function registerBuiltinEngines() {
     if (_registered)
         return;
     _registered = true;
-    // ── Anthropic (default) ────────────────────────────────────────────────────
+    // ── Builder.io managed gateway ─────────────────────────────────────────────
+    // Registered first so detectEngineFromEnv picks it when BUILDER_PRIVATE_KEY
+    // is set — Builder is the managed path we want everyone on long-term.
+    // Users who prefer BYO keys can opt out via AGENT_ENGINE_PREFER_BYO_KEY=true,
+    // which drops Builder to the fallback slot in detectEngineFromEnv.
+    registerAgentEngine({
+        name: "builder",
+        label: "Builder.io Gateway",
+        description: "Managed LLM access via Builder.io — Claude, GPT, Gemini, GLM, and more through a single connection. Free during beta.",
+        capabilities: BUILDER_CAPABILITIES,
+        defaultModel: BUILDER_DEFAULT_MODEL,
+        supportedModels: BUILDER_SUPPORTED_MODELS,
+        requiredEnvVars: ["BUILDER_PRIVATE_KEY"],
+        create: (config) => createBuilderEngine(config),
+    });
+    // ── Anthropic ──────────────────────────────────────────────────────────────
     registerAgentEngine({
         name: "anthropic",
-        label: "Claude (Anthropic SDK)",
+        label: "Claude",
         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,
@@ -39,14 +55,14 @@ export function registerBuiltinEngines() {
         "ollama",
     ];
     const providerLabels = {
-        anthropic: "Claude via AI SDK",
-        openai: "OpenAI (AI SDK)",
-        openrouter: "OpenRouter (AI SDK)",
-        google: "Google Gemini (AI SDK)",
-        groq: "Groq (AI SDK)",
-        mistral: "Mistral (AI SDK)",
-        cohere: "Cohere (AI SDK)",
-        ollama: "Ollama (local, AI SDK)",
+        anthropic: "Claude",
+        openai: "OpenAI",
+        openrouter: "OpenRouter",
+        google: "Gemini",
+        groq: "Groq",
+        mistral: "Mistral",
+        cohere: "Cohere",
+        ollama: "Ollama",
     };
     const providerDescriptions = {
         anthropic: "Claude models through the Vercel AI SDK. Supports thinking and caching via AI SDK providerOptions.",

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

@@ -1 +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,YAAY;QACZ,QAAQ;QACR,MAAM;QACN,SAAS;QACT,QAAQ;QACR,QAAQ;KACT,CAAC;IAEF,MAAM,cAAc,GAAkC;QACpD,SAAS,EAAE,mBAAmB;QAC9B,MAAM,EAAE,iBAAiB;QACzB,UAAU,EAAE,qBAAqB;QACjC,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,UAAU,EACR,gMAAgM;QAClM,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"}
+{"version":3,"file":"builtin.js","sourceRoot":"","sources":["../../../src/agent/engine/builtin.ts"],"names":[],"mappings":"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"}

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

@@ -2,7 +2,7 @@
  * 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 { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getStoredModelForEngine, detectEngineFromEnv, isAgentEngineSettingConfigured, isStoredEngineUsable, 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";

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

@@ -1 +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"}
+{"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,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,EACpB,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

@@ -1,7 +1,7 @@
 /**
  * Public exports for the pluggable agent engine system.
  */
-export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, } from "./registry.js";
+export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getStoredModelForEngine, detectEngineFromEnv, isAgentEngineSettingConfigured, isStoredEngineUsable, } 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";

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

@@ -1 +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"}
+{"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,EACb,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,GAGrB,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/provider-env-vars.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Single source of truth for every built-in LLM provider's env var name and
+ * UI metadata. Imported by both server and client code — keep it free of
+ * runtime imports so it stays tree-shakeable into the browser bundle.
+ *
+ * Add a new provider here when adding it to builtin.ts; all three UI gates
+ * (AssistantChat composer, settings env-var list, settings key form) pick
+ * it up automatically.
+ */
+export interface ProviderEnvMeta {
+    envVar: string;
+    /** Shown next to the env var in the settings "framework env keys" list */
+    label: string;
+    /** Input placeholder hint shown in the LLM picker's key field */
+    placeholder: string;
+}
+export declare const PROVIDER_ENV_META: Record<string, ProviderEnvMeta>;
+export declare const PROVIDER_TO_ENV: Record<string, string>;
+export declare const PROVIDER_ENV_VARS: readonly string[];
+export declare const PROVIDER_ENV_PLACEHOLDERS: Record<string, string>;
+//# sourceMappingURL=provider-env-vars.d.ts.map

package/dist/agent/engine/provider-env-vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-env-vars.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/provider-env-vars.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAoC7D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAElD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EACf,CAAC;AAEjC,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG1D,CAAC"}

package/dist/agent/engine/provider-env-vars.js

@@ -0,0 +1,50 @@
+/**
+ * Single source of truth for every built-in LLM provider's env var name and
+ * UI metadata. Imported by both server and client code — keep it free of
+ * runtime imports so it stays tree-shakeable into the browser bundle.
+ *
+ * Add a new provider here when adding it to builtin.ts; all three UI gates
+ * (AssistantChat composer, settings env-var list, settings key form) pick
+ * it up automatically.
+ */
+export const PROVIDER_ENV_META = {
+    anthropic: {
+        envVar: "ANTHROPIC_API_KEY",
+        label: "Anthropic API Key",
+        placeholder: "sk-ant-...",
+    },
+    openai: {
+        envVar: "OPENAI_API_KEY",
+        label: "OpenAI API Key",
+        placeholder: "sk-...",
+    },
+    google: {
+        envVar: "GOOGLE_GENERATIVE_AI_API_KEY",
+        label: "Google Gemini API Key",
+        placeholder: "AI...",
+    },
+    openrouter: {
+        envVar: "OPENROUTER_API_KEY",
+        label: "OpenRouter API Key",
+        placeholder: "sk-or-...",
+    },
+    groq: {
+        envVar: "GROQ_API_KEY",
+        label: "Groq API Key",
+        placeholder: "gsk_...",
+    },
+    mistral: {
+        envVar: "MISTRAL_API_KEY",
+        label: "Mistral API Key",
+        placeholder: "...",
+    },
+    cohere: {
+        envVar: "COHERE_API_KEY",
+        label: "Cohere API Key",
+        placeholder: "...",
+    },
+};
+export const PROVIDER_TO_ENV = Object.fromEntries(Object.entries(PROVIDER_ENV_META).map(([k, v]) => [k, v.envVar]));
+export const PROVIDER_ENV_VARS = Object.values(PROVIDER_TO_ENV);
+export const PROVIDER_ENV_PLACEHOLDERS = Object.fromEntries(Object.values(PROVIDER_ENV_META).map((m) => [m.envVar, m.placeholder]));
+//# sourceMappingURL=provider-env-vars.js.map

package/dist/agent/engine/provider-env-vars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-env-vars.js","sourceRoot":"","sources":["../../../src/agent/engine/provider-env-vars.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,CAAC,MAAM,iBAAiB,GAAoC;IAChE,SAAS,EAAE;QACT,MAAM,EAAE,mBAAmB;QAC3B,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,YAAY;KAC1B;IACD,MAAM,EAAE;QACN,MAAM,EAAE,gBAAgB;QACxB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,QAAQ;KACtB;IACD,MAAM,EAAE;QACN,MAAM,EAAE,8BAA8B;QACtC,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,OAAO;KACrB;IACD,UAAU,EAAE;QACV,MAAM,EAAE,oBAAoB;QAC5B,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,WAAW;KACzB;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,cAAc;QACtB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,SAAS;KACvB;IACD,OAAO,EAAE;QACP,MAAM,EAAE,iBAAiB;QACzB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,KAAK;KACnB;IACD,MAAM,EAAE;QACN,MAAM,EAAE,gBAAgB;QACxB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,KAAK;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAA2B,MAAM,CAAC,WAAW,CACvE,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CACjE,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAC5B,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AAEjC,MAAM,CAAC,MAAM,yBAAyB,GACpC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CACvE,CAAC"}