@stigmer/runner 3.0.1

package/dist/shared/llm-proxy.js

@@ -0,0 +1,116 @@
+/**
+ * LLM proxy routing utilities — shared between ExecuteDeepAgent and
+ * ClassifyToolApprovals (and any future LLM-calling activities).
+ *
+ * Responsibilities:
+ * 1. Infer the LLM provider from a model name string (prefix heuristics).
+ * 2. Construct the correct proxy base URL for each provider, matching the
+ *    path pattern expected by stigmer-cloud's LlmProxyController:
+ *      - Anthropic: {proxy}/v1/proxy/llm/anthropic
+ *      - OpenAI:    {proxy}/v1/proxy/llm/openai/v1
+ * 3. Build authorization and scope headers for proxy requests.
+ *
+ * These utilities mirror the Python agent-runner's `LLMConfig.build_llm_kwargs`
+ * but as composable functions rather than a config class method.
+ */
+/**
+ * Provider-specific path suffixes appended to `STIGMER_PROXY_ENDPOINT`.
+ *
+ * OpenAI's SDK includes `/v1` in its default base URL (https://api.openai.com/v1),
+ * so the proxy path includes it: `/v1/proxy/llm/openai/v1`.
+ *
+ * Anthropic's SDK does NOT include `/v1` in its base URL (https://api.anthropic.com),
+ * so the proxy path omits it: `/v1/proxy/llm/anthropic`.
+ */
+const PROXY_PATHS = {
+    anthropic: "/v1/proxy/llm/anthropic",
+    openai: "/v1/proxy/llm/openai/v1",
+};
+const OPENAI_PREFIXES = ["gpt", "o1", "o3", "o4", "chatgpt"];
+/**
+ * Infer the LLM provider from a model name.
+ *
+ * Resolution order:
+ * 1. Explicit prefix syntax: "provider:model-name" (e.g. "openai:gpt-4.1")
+ * 2. Name prefix heuristics (claude → anthropic, gpt/o1/o3/o4 → openai)
+ *
+ * Throws if the provider cannot be determined — callers should not silently
+ * fall back to a default provider when an unknown model is requested.
+ */
+export function inferProvider(modelName) {
+    if (!modelName) {
+        throw new Error("Model name is required but received an empty string");
+    }
+    const colonIdx = modelName.indexOf(":");
+    if (colonIdx > 0 && colonIdx < modelName.length - 1) {
+        const prefix = modelName.slice(0, colonIdx).toLowerCase();
+        if (prefix === "anthropic" || prefix === "openai") {
+            return prefix;
+        }
+    }
+    const lower = modelName.toLowerCase();
+    if (lower.startsWith("claude")) {
+        return "anthropic";
+    }
+    for (const prefix of OPENAI_PREFIXES) {
+        if (lower.startsWith(prefix)) {
+            return "openai";
+        }
+    }
+    throw new Error(`Cannot determine LLM provider for model "${modelName}". ` +
+        `Known prefixes: claude* (anthropic), gpt*/o1*/o3*/o4*/chatgpt* (openai). ` +
+        `Use explicit prefix syntax "provider:model-name" for non-standard model names.`);
+}
+/**
+ * Strip an explicit "provider:" prefix from the model name, returning
+ * just the model ID portion. If no explicit prefix is present, returns
+ * the original name unchanged.
+ */
+export function stripProviderPrefix(modelName) {
+    const colonIdx = modelName.indexOf(":");
+    if (colonIdx > 0 && colonIdx < modelName.length - 1) {
+        const prefix = modelName.slice(0, colonIdx).toLowerCase();
+        if (prefix === "anthropic" || prefix === "openai") {
+            return modelName.slice(colonIdx + 1);
+        }
+    }
+    return modelName;
+}
+/**
+ * Construct the proxy base URL for a given provider.
+ *
+ * The returned URL is what gets passed as `baseURL` / `clientOptions.baseURL`
+ * to the LangChain model constructor. The LangChain SDK appends provider-
+ * specific API paths (e.g. `/v1/messages` for Anthropic, `/chat/completions`
+ * for OpenAI).
+ *
+ * Example:
+ *   resolveProxyBaseUrl("https://api.stigmer.ai", "openai")
+ *   → "https://api.stigmer.ai/v1/proxy/llm/openai/v1"
+ */
+export function resolveProxyBaseUrl(proxyEndpoint, provider) {
+    const base = proxyEndpoint.replace(/\/+$/, "");
+    return `${base}${PROXY_PATHS[provider]}`;
+}
+/**
+ * Build the HTTP headers for proxy-routed LLM requests.
+ *
+ * Always includes Bearer authorization. Optionally includes scope headers
+ * used by the proxy for FGA authorization and billing attribution.
+ */
+export function buildProxyHeaders(token, options) {
+    const headers = {
+        Authorization: `Bearer ${token}`,
+    };
+    if (options?.executionId) {
+        headers["X-Stigmer-Execution-Id"] = options.executionId;
+    }
+    if (options?.mcpServerId) {
+        headers["X-Stigmer-Mcp-Server-Id"] = options.mcpServerId;
+    }
+    if (options?.workflowExecutionId) {
+        headers["X-Stigmer-Workflow-Execution-Id"] = options.workflowExecutionId;
+    }
+    return headers;
+}
+//# sourceMappingURL=llm-proxy.js.map

package/dist/shared/llm-proxy.js.map

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

package/dist/shared/mcp-manager.d.ts

@@ -0,0 +1,47 @@
+/**
+ * MCP connection manager for the deep agent execution path.
+ *
+ * Wraps @langchain/mcp-adapters MultiServerMCPClient with:
+ * - Conversion from ResolvedMcpServer[] to the SDK's Connection config
+ * - Proper async cleanup via close()
+ * - Cloud compatibility validation (warn on non-installable stdio commands)
+ * - Tool filtering based on discovered capabilities
+ *
+ * The Cursor execution path does NOT use this manager — it passes MCP
+ * configs directly to the Cursor SDK via toCursorMcpConfig(). This
+ * manager is exclusively for LangGraph-based deep agent executions.
+ */
+import { MultiServerMCPClient } from "@langchain/mcp-adapters";
+import type { Connection } from "@langchain/mcp-adapters";
+import type { DynamicStructuredTool } from "@langchain/core/tools";
+import type { ResolvedMcpServer } from "./mcp-resolver.js";
+/**
+ * Classifies a stdio command's compatibility with cloud execution.
+ * Returns true for commands that are installable/available in typical
+ * cloud environments (npx, node, uvx, python).
+ */
+export declare function isCloudCompatibleCommand(command: string): boolean;
+/**
+ * Log warnings for MCP servers that may not work in cloud mode.
+ * Does not filter or reject — just provides operator visibility.
+ */
+export declare function warnCloudIncompatibleServers(servers: ResolvedMcpServer[], isCloudMode: boolean): void;
+/**
+ * Convert harness-agnostic ResolvedMcpServer[] into the
+ * MultiServerMCPClient connection config format.
+ */
+export declare function toMcpClientConfig(servers: ResolvedMcpServer[]): Record<string, Connection>;
+export interface McpConnectionResult {
+    client: MultiServerMCPClient;
+    tools: DynamicStructuredTool[];
+    serverToolMap: Record<string, DynamicStructuredTool[]>;
+}
+/**
+ * Create and initialize MCP connections from resolved server specs.
+ *
+ * The caller is responsible for calling result.client.close() when
+ * done — typically in a finally block or via a cleanup handler.
+ */
+export declare function connectMcpServers(servers: ResolvedMcpServer[], options?: {
+    isCloudMode?: boolean;
+}): Promise<McpConnectionResult>;

package/dist/shared/mcp-manager.js

@@ -0,0 +1,118 @@
+/**
+ * MCP connection manager for the deep agent execution path.
+ *
+ * Wraps @langchain/mcp-adapters MultiServerMCPClient with:
+ * - Conversion from ResolvedMcpServer[] to the SDK's Connection config
+ * - Proper async cleanup via close()
+ * - Cloud compatibility validation (warn on non-installable stdio commands)
+ * - Tool filtering based on discovered capabilities
+ *
+ * The Cursor execution path does NOT use this manager — it passes MCP
+ * configs directly to the Cursor SDK via toCursorMcpConfig(). This
+ * manager is exclusively for LangGraph-based deep agent executions.
+ */
+import { MultiServerMCPClient } from "@langchain/mcp-adapters";
+const CLOUD_SAFE_COMMANDS = new Set(["npx", "node", "uvx", "python", "python3"]);
+/**
+ * Classifies a stdio command's compatibility with cloud execution.
+ * Returns true for commands that are installable/available in typical
+ * cloud environments (npx, node, uvx, python).
+ */
+export function isCloudCompatibleCommand(command) {
+    const base = command.split("/").pop() ?? command;
+    return CLOUD_SAFE_COMMANDS.has(base);
+}
+/**
+ * Log warnings for MCP servers that may not work in cloud mode.
+ * Does not filter or reject — just provides operator visibility.
+ */
+export function warnCloudIncompatibleServers(servers, isCloudMode) {
+    if (!isCloudMode)
+        return;
+    for (const server of servers) {
+        if (server.connectionType === "stdio" && server.command) {
+            if (!isCloudCompatibleCommand(server.command)) {
+                console.warn(`[MCP] Server '${server.slug}' uses stdio command '${server.command}' ` +
+                    `which may not be available in cloud execution environments. ` +
+                    `Consider using an HTTP MCP server or an npx-installable package.`);
+            }
+        }
+    }
+}
+/**
+ * Convert harness-agnostic ResolvedMcpServer[] into the
+ * MultiServerMCPClient connection config format.
+ */
+export function toMcpClientConfig(servers) {
+    const config = {};
+    for (const server of servers) {
+        if (server.connectionType === "stdio") {
+            if (!server.command)
+                continue;
+            config[server.slug] = {
+                transport: "stdio",
+                command: server.command,
+                args: server.args ?? [],
+                env: server.env ?? processEnvAsStrings(),
+                cwd: server.cwd,
+            };
+        }
+        else if (server.connectionType === "http" || server.connectionType === "sse") {
+            if (!server.url)
+                continue;
+            config[server.slug] = {
+                transport: "http",
+                url: server.url,
+                headers: server.headers,
+            };
+        }
+    }
+    return config;
+}
+/**
+ * Create and initialize MCP connections from resolved server specs.
+ *
+ * The caller is responsible for calling result.client.close() when
+ * done — typically in a finally block or via a cleanup handler.
+ */
+export async function connectMcpServers(servers, options) {
+    if (options?.isCloudMode) {
+        warnCloudIncompatibleServers(servers, true);
+    }
+    const connectionConfig = toMcpClientConfig(servers);
+    if (Object.keys(connectionConfig).length === 0) {
+        const client = new MultiServerMCPClient({});
+        return { client, tools: [], serverToolMap: {} };
+    }
+    const client = new MultiServerMCPClient(connectionConfig);
+    const serverToolMap = await client.initializeConnections();
+    const tools = [];
+    for (const serverTools of Object.values(serverToolMap)) {
+        tools.push(...serverTools);
+    }
+    console.log(`[MCP] Connected ${Object.keys(serverToolMap).length} server(s), ` +
+        `${tools.length} tool(s) total: ${Object.entries(serverToolMap)
+            .map(([name, t]) => `${name}(${t.length})`)
+            .join(", ")}`);
+    return { client, tools, serverToolMap };
+}
+/**
+ * Snapshot of process.env as a string-only record (no undefined values).
+ * Used as a fallback when an MCP server has no declared env — the
+ * subprocess inherits the runner's full environment, matching standard
+ * Unix child-process behavior.
+ *
+ * Without this, @modelcontextprotocol/sdk only passes a restricted
+ * whitelist (HOME, PATH, USER, etc.) which drops platform variables
+ * like STIGMER_SERVER_ADDRESS.
+ */
+function processEnvAsStrings() {
+    const env = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value !== undefined) {
+            env[key] = value;
+        }
+    }
+    return env;
+}
+//# sourceMappingURL=mcp-manager.js.map

package/dist/shared/mcp-manager.js.map

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

package/dist/shared/mcp-resolver.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Resolves Stigmer McpServerUsage references into an intermediate
+ * ResolvedMcpServer format that is harness-agnostic.
+ *
+ * Both ExecuteCursor and ExecuteDeepAgent need MCP server connection info
+ * and tool approval policies. This module provides the common resolution
+ * logic; each harness maps ResolvedMcpServer into its SDK-specific format.
+ */
+import type { McpServerUsage } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/spec_pb";
+import type { McpServer } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+import type { ToolApprovalPolicy } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/spec_pb";
+import type { StigmerClient } from "../client/stigmer-client.js";
+/**
+ * Harness-agnostic intermediate representation of a resolved MCP server.
+ * Contains connection info and approval policies. Each harness maps this
+ * into its SDK-specific format (e.g., Cursor McpServerConfig, LangGraph
+ * MultiServerMCPClient config).
+ */
+export interface ResolvedMcpServer {
+    slug: string;
+    connectionType: "stdio" | "http" | "sse";
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    toolApprovals: ToolApprovalPolicy[];
+    pinnedToolApprovals: ToolApprovalPolicy[];
+    discoveredCapabilitiesEmpty: boolean;
+}
+export interface McpResolutionResult {
+    resolvedServers: ResolvedMcpServer[];
+}
+/**
+ * Fetch McpServer resources and resolve into intermediate format.
+ */
+export declare function resolveMcpServers(client: StigmerClient, usages: McpServerUsage[], envVars?: Record<string, string>): Promise<McpResolutionResult>;
+export declare function mcpServerToResolved(server: McpServer, slug: string, envVars: Record<string, string>): ResolvedMcpServer | null;
+export declare function extractMcpServerSlugs(usages: McpServerUsage[]): string[];
+export { PlaceholderResolutionError } from "./placeholder-resolver.js";

package/dist/shared/mcp-resolver.js

@@ -0,0 +1,96 @@
+/**
+ * Resolves Stigmer McpServerUsage references into an intermediate
+ * ResolvedMcpServer format that is harness-agnostic.
+ *
+ * Both ExecuteCursor and ExecuteDeepAgent need MCP server connection info
+ * and tool approval policies. This module provides the common resolution
+ * logic; each harness maps ResolvedMcpServer into its SDK-specific format.
+ */
+import { resolveHeaders, resolvePlaceholders, filterEnvToDeclaredKeys, PlaceholderResolutionError, } from "./placeholder-resolver.js";
+/**
+ * Fetch McpServer resources and resolve into intermediate format.
+ */
+export async function resolveMcpServers(client, usages, envVars = {}) {
+    const resolved = [];
+    for (const usage of usages) {
+        const ref = usage.mcpServerRef;
+        if (!ref?.slug)
+            continue;
+        try {
+            const mcpServer = await client.getMcpServerByReference(ref);
+            const serverEnv = filterEnvToDeclaredKeys(mcpServer.spec?.env, envVars, ref.slug);
+            const server = mcpServerToResolved(mcpServer, ref.slug, serverEnv);
+            if (server)
+                resolved.push(server);
+        }
+        catch (err) {
+            if (err instanceof PlaceholderResolutionError) {
+                console.error(`MCP server ${ref.org}/${ref.slug}: ${err.message}`);
+            }
+            else {
+                console.warn(`Failed to resolve MCP server ${ref.org}/${ref.slug}: ${err instanceof Error ? err.message : err}`);
+            }
+        }
+    }
+    return { resolvedServers: resolved };
+}
+export function mcpServerToResolved(server, slug, envVars) {
+    const spec = server.spec;
+    if (!spec)
+        return null;
+    const status = server.status;
+    const toolApprovals = status?.toolApprovals ?? [];
+    const pinnedToolApprovals = spec.pinnedToolApprovals ?? [];
+    const discoveredCapabilitiesEmpty = !status?.discoveredCapabilities
+        || (status.discoveredCapabilities.tools.length === 0
+            && status.discoveredCapabilities.resourceTemplates.length === 0);
+    const base = {
+        toolApprovals,
+        pinnedToolApprovals,
+        discoveredCapabilitiesEmpty,
+    };
+    switch (spec.serverType.case) {
+        case "stdio": {
+            const stdio = spec.serverType.value;
+            if (!stdio.command)
+                return null;
+            const resolvedArgs = stdio.args.length > 0
+                ? stdio.args.map((arg, i) => resolvePlaceholders(arg, envVars, `stdio arg[${i}]`))
+                : undefined;
+            return {
+                slug,
+                connectionType: "stdio",
+                command: stdio.command,
+                args: resolvedArgs,
+                env: Object.keys(envVars).length > 0 ? { ...envVars } : undefined,
+                cwd: stdio.workingDir || undefined,
+                ...base,
+            };
+        }
+        case "http": {
+            const http = spec.serverType.value;
+            if (!http.url)
+                return null;
+            const rawHeaders = Object.keys(http.headers).length > 0 ? http.headers : undefined;
+            const resolved = rawHeaders
+                ? resolveHeaders(Object.fromEntries(Object.entries(rawHeaders)), envVars)
+                : undefined;
+            return {
+                slug,
+                connectionType: "http",
+                url: http.url,
+                headers: resolved,
+                ...base,
+            };
+        }
+        default:
+            return null;
+    }
+}
+export function extractMcpServerSlugs(usages) {
+    return usages
+        .map((u) => u.mcpServerRef?.slug)
+        .filter((s) => !!s);
+}
+export { PlaceholderResolutionError } from "./placeholder-resolver.js";
+//# sourceMappingURL=mcp-resolver.js.map

package/dist/shared/mcp-resolver.js.map

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

package/dist/shared/model-pricing-data.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Model pricing data — fetched from the model registry API and cached.
+ *
+ * On first access, fetches the full model registry, filters to models
+ * with pricing info, and caches the result. Falls back to conservative
+ * default pricing if the API is unreachable.
+ */
+export interface ModelPricing {
+    readonly model: string;
+    readonly displayName: string;
+    readonly costTier: string;
+    readonly inputPricePerMillion: number;
+    readonly outputPricePerMillion: number;
+    readonly cacheWritePricePerMillion: number;
+    readonly cacheReadPricePerMillion: number;
+}
+export declare const DEFAULT_PRICING: ModelPricing;
+export declare function getPricingTable(): Promise<readonly ModelPricing[]>;

package/dist/shared/model-pricing-data.js

@@ -0,0 +1,78 @@
+/**
+ * Model pricing data — fetched from the model registry API and cached.
+ *
+ * On first access, fetches the full model registry, filters to models
+ * with pricing info, and caches the result. Falls back to conservative
+ * default pricing if the API is unreachable.
+ */
+const DEFAULT_API_URL = "https://api.stigmer.ai";
+const CACHE_TTL_MS = 3_600_000;
+export const DEFAULT_PRICING = {
+    model: "unknown",
+    displayName: "Unknown",
+    costTier: "standard",
+    inputPricePerMillion: 1.25,
+    outputPricePerMillion: 6.00,
+    cacheWritePricePerMillion: 1.25,
+    cacheReadPricePerMillion: 0.25,
+};
+let cache = null;
+let inflightFetch = null;
+function parsePricingTable(json) {
+    if (!json || typeof json !== "object")
+        return [];
+    const models = json.models;
+    if (!Array.isArray(models))
+        return [];
+    return models
+        .filter((m) => m.pricing != null)
+        .map((m) => ({
+        model: m.id,
+        displayName: m.displayName,
+        costTier: m.costTier ?? "standard",
+        inputPricePerMillion: m.pricing.inputPricePerMillion,
+        outputPricePerMillion: m.pricing.outputPricePerMillion,
+        cacheWritePricePerMillion: m.pricing.cacheWritePricePerMillion,
+        cacheReadPricePerMillion: m.pricing.cacheReadPricePerMillion,
+    }));
+}
+async function fetchFromApi() {
+    const url = `${process.env.STIGMER_CLOUD_API_URL ?? DEFAULT_API_URL}/v1/proxy/model-registry`;
+    const headers = {};
+    const token = process.env.STIGMER_TOKEN ?? process.env.STIGMER_AUTH_TOKEN;
+    if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+    }
+    const res = await fetch(url, { headers });
+    if (!res.ok)
+        throw new Error(`Model registry fetch failed: ${res.status}`);
+    const data = await res.json();
+    const table = parsePricingTable(data);
+    if (table.length === 0) {
+        throw new Error("Model registry returned no models with pricing");
+    }
+    return table;
+}
+export async function getPricingTable() {
+    if (cache && Date.now() < cache.expiresAt) {
+        return cache.data;
+    }
+    if (inflightFetch)
+        return inflightFetch;
+    inflightFetch = fetchFromApi()
+        .then((data) => {
+        cache = { data, expiresAt: Date.now() + CACHE_TTL_MS };
+        return data;
+    })
+        .catch((err) => {
+        console.warn(`Failed to fetch model registry, using default pricing: ${err}`);
+        const fallback = [DEFAULT_PRICING];
+        cache = { data: fallback, expiresAt: Date.now() + CACHE_TTL_MS };
+        return fallback;
+    })
+        .finally(() => {
+        inflightFetch = null;
+    });
+    return inflightFetch;
+}
+//# sourceMappingURL=model-pricing-data.js.map

package/dist/shared/model-pricing-data.js.map

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

package/dist/shared/model-pricing.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Model pricing lookup and cost computation.
+ */
+import type { ModelPricing } from "./model-pricing-data.js";
+export type { ModelPricing };
+/**
+ * Ensure the pricing map has been populated from the API cache.
+ * Call once at startup or before the first pricing lookup.
+ */
+export declare function ensureLoaded(): Promise<void>;
+export declare function resolveModelId(requestedModel: string): string;
+export declare function getModelPricing(model: string): ModelPricing;
+/**
+ * Compute USD cost for a single turn using disjoint token buckets.
+ */
+export declare function computeTurnCost(pricing: ModelPricing, inputTokens: number, outputTokens: number, cacheWriteTokens: number, cacheReadTokens: number): number;
+/**
+ * Compute cost in micro-USD for a workflow LLM call.
+ *
+ * Uses the cloud-fetched pricing registry (via `ensureLoaded`).
+ * Falls back to DEFAULT_PRICING for unknown models so that cost
+ * is always estimated rather than silently reported as zero.
+ */
+export declare function computeLlmCostMicros(modelId: string, inputTokens: number, outputTokens: number): number;

package/dist/shared/model-pricing.js

@@ -0,0 +1,58 @@
+/**
+ * Model pricing lookup and cost computation.
+ */
+import { getPricingTable, DEFAULT_PRICING } from "./model-pricing-data.js";
+let pricingByModel = null;
+let initPromise = null;
+/**
+ * Ensure the pricing map has been populated from the API cache.
+ * Call once at startup or before the first pricing lookup.
+ */
+export async function ensureLoaded() {
+    if (initPromise)
+        return initPromise;
+    initPromise = getPricingTable().then((table) => {
+        pricingByModel = new Map(table.map((entry) => [entry.model, entry]));
+    });
+    return initPromise;
+}
+function getMap() {
+    if (!pricingByModel) {
+        console.warn("Model pricing accessed before ensureLoaded() — returning empty map");
+        return new Map();
+    }
+    return pricingByModel;
+}
+export function resolveModelId(requestedModel) {
+    if (!requestedModel || requestedModel === "default")
+        return "default";
+    if (getMap().has(requestedModel))
+        return requestedModel;
+    console.warn(`Model "${requestedModel}" not in pricing registry (${getMap().size} models), falling back to "default"`);
+    return "default";
+}
+export function getModelPricing(model) {
+    return getMap().get(model) ?? { ...DEFAULT_PRICING, model };
+}
+/**
+ * Compute USD cost for a single turn using disjoint token buckets.
+ */
+export function computeTurnCost(pricing, inputTokens, outputTokens, cacheWriteTokens, cacheReadTokens) {
+    return (inputTokens * pricing.inputPricePerMillion
+        + outputTokens * pricing.outputPricePerMillion
+        + cacheWriteTokens * pricing.cacheWritePricePerMillion
+        + cacheReadTokens * pricing.cacheReadPricePerMillion) / 1_000_000;
+}
+/**
+ * Compute cost in micro-USD for a workflow LLM call.
+ *
+ * Uses the cloud-fetched pricing registry (via `ensureLoaded`).
+ * Falls back to DEFAULT_PRICING for unknown models so that cost
+ * is always estimated rather than silently reported as zero.
+ */
+export function computeLlmCostMicros(modelId, inputTokens, outputTokens) {
+    const pricing = getModelPricing(modelId);
+    const costUsd = computeTurnCost(pricing, inputTokens, outputTokens, 0, 0);
+    return Math.round(costUsd * 1_000_000);
+}
+//# sourceMappingURL=model-pricing.js.map

package/dist/shared/model-pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.js","sourceRoot":"","sources":["../../src/shared/model-pricing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK3E,IAAI,cAAc,GAAqC,IAAI,CAAC;AAC5D,IAAI,WAAW,GAAyB,IAAI,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,WAAW,GAAG,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7C,cAAc,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,MAAM;IACb,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACnF,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,cAAsB;IACnD,IAAI,CAAC,cAAc,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtE,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,OAAO,cAAc,CAAC;IACxD,OAAO,CAAC,IAAI,CACV,UAAU,cAAc,8BAA8B,MAAM,EAAE,CAAC,IAAI,qCAAqC,CACzG,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,eAAe,EAAE,KAAK,EAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAqB,EACrB,WAAmB,EACnB,YAAoB,EACpB,gBAAwB,EACxB,eAAuB;IAEvB,OAAO,CACL,WAAW,GAAG,OAAO,CAAC,oBAAoB;UACxC,YAAY,GAAG,OAAO,CAAC,qBAAqB;UAC5C,gBAAgB,GAAG,OAAO,CAAC,yBAAyB;UACpD,eAAe,GAAG,OAAO,CAAC,wBAAwB,CACrD,GAAG,SAAS,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,WAAmB,EACnB,YAAoB;IAEpB,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AACzC,CAAC"}