@rarebit-one/harness-kernel 0.5.1

package/dist/providers/mock.d.ts

@@ -0,0 +1,25 @@
+import type { CompletionRequest, ConverseRequest, ConverseResult, Provider } from "./types.js";
+import type { ProviderSelection } from "./index.js";
+/**
+ * Deterministic, offline provider. Used when no API key is configured — or when a
+ * workflow explicitly asks for `preferred: mock` — so the end-to-end loop (and
+ * tests) run without network access or credentials.
+ *
+ * It cannot call a model, but it is handed the SAME provider selection a real
+ * provider would receive (the resolved per-run model + per-org BYO keys) and
+ * self-documents what a real run WOULD have used. That makes model/key
+ * resolution OBSERVABLE offline — a caller's e2e harness can read it back out of
+ * the run's output artifact to assert key precedence. It never echoes a key,
+ * only its last-4 marker.
+ */
+export declare class MockProvider implements Provider {
+    readonly name = "mock";
+    private readonly selection;
+    constructor(selection?: ProviderSelection);
+    private resolvedModel;
+    private byoKeyMarker;
+    private selectionLines;
+    complete(req: CompletionRequest): Promise<string>;
+    converse(req: ConverseRequest): Promise<ConverseResult>;
+}
+//# sourceMappingURL=mock.d.ts.map

package/dist/providers/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/providers/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,QAAQ,CAAC,IAAI,UAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAEjC,SAAS,GAAE,iBAAsB;IAS7C,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;IAWtB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB3C,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAS9D"}

package/dist/providers/mock.js

@@ -0,0 +1,85 @@
+/**
+ * Deterministic, offline provider. Used when no API key is configured — or when a
+ * workflow explicitly asks for `preferred: mock` — so the end-to-end loop (and
+ * tests) run without network access or credentials.
+ *
+ * It cannot call a model, but it is handed the SAME provider selection a real
+ * provider would receive (the resolved per-run model + per-org BYO keys) and
+ * self-documents what a real run WOULD have used. That makes model/key
+ * resolution OBSERVABLE offline — a caller's e2e harness can read it back out of
+ * the run's output artifact to assert key precedence. It never echoes a key,
+ * only its last-4 marker.
+ */
+export class MockProvider {
+    name = "mock";
+    selection;
+    constructor(selection = {}) {
+        this.selection = selection;
+    }
+    // "What a real provider would have used" for the model: the model the caller
+    // resolved (workflow YAML → org default), else the host's
+    // env-default model (the SAME env vars the real providers read), else
+    // the provider's built-in default. `source` labels which rung of that fallback
+    // won, so the offline observer can tell the org-default case from the env case.
+    resolvedModel() {
+        if (this.selection.model)
+            return { value: this.selection.model, source: "resolved" };
+        const envModel = process.env.ANTHROPIC_MODEL ?? process.env.OPENAI_MODEL ?? process.env.OPENROUTER_MODEL;
+        if (envModel)
+            return { value: envModel, source: "runner env default" };
+        return { value: "(provider built-in default)", source: "provider built-in default" };
+    }
+    // Which per-org BYO key WOULD have been threaded, by masked last-4 ONLY — never
+    // the key itself. `(none …)` means the org set no key for that provider, so the
+    // runner's own env key would be used.
+    byoKeyMarker() {
+        const creds = this.selection.credentials ?? {};
+        const present = ["anthropic", "openai", "openrouter"]
+            .filter((p) => creds[p])
+            .map((p) => `${p}:…${creds[p].slice(-4)}`);
+        return present.length ? present.join(", ") : "(none — runner env key would be used)";
+    }
+    // The block the e2e harness parses out of output.md. Deterministic and offline.
+    selectionLines() {
+        const model = this.resolvedModel();
+        return [
+            "## Provider selection (mock — dry run)",
+            "",
+            `model: ${model.value} (${model.source}; would be used)`,
+            `org BYO key: ${this.byoKeyMarker()}`,
+            "",
+        ];
+    }
+    complete(req) {
+        const preview = req.prompt.slice(0, 600);
+        return Promise.resolve([
+            "# Workflow Output (mock provider)",
+            "",
+            "_Generated offline by the harness-kernel mock provider. Set ANTHROPIC_API_KEY",
+            "or OPENAI_API_KEY to use a real model._",
+            "",
+            ...this.selectionLines(),
+            "## System",
+            "",
+            req.system,
+            "",
+            "## Context + Inputs (excerpt)",
+            "",
+            "```",
+            preview,
+            "```",
+        ].join("\n"));
+    }
+    // The mock never calls tools, so the agent loop terminates after one turn. It
+    // echoes which tools were available, which is handy when running offline.
+    async converse(req) {
+        const lastUser = [...req.messages].reverse().find((m) => m.role === "user");
+        const prompt = lastUser && lastUser.role === "user" ? lastUser.text : "";
+        const text = await this.complete({
+            system: `${req.system}\n\nAvailable tools: ${req.tools.map((t) => t.name).join(", ") || "(none)"}`,
+            prompt,
+        });
+        return { text, toolCalls: [] };
+    }
+}
+//# sourceMappingURL=mock.js.map

package/dist/providers/mock.js.map

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

package/dist/providers/openai.d.ts

@@ -0,0 +1,32 @@
+import OpenAI from "openai";
+import type { AgentMessage, CompletionRequest, ConverseRequest, ConverseResult, Provider } from "./types.js";
+/** Map provider-neutral messages to OpenAI chat messages (pure; tested). */
+export declare function toOpenAIMessages(messages: AgentMessage[]): OpenAI.Chat.Completions.ChatCompletionMessageParam[];
+/** Reduce an OpenAI response message to text + tool calls (pure; tested). */
+export declare function parseOpenAIMessage(message: OpenAI.Chat.Completions.ChatCompletionMessage): ConverseResult;
+/** Constructor options for an OpenAI-compatible (chat.completions) provider. */
+export interface OpenAICompatibleOptions {
+    apiKey: string;
+    model: string;
+    /** Alternate chat.completions endpoint (e.g. OpenRouter); omit for api.openai.com. */
+    baseURL?: string;
+    /** Extra headers sent on every request (e.g. OpenRouter attribution). */
+    defaultHeaders?: Record<string, string>;
+}
+/**
+ * Shared core for providers speaking the OpenAI chat.completions dialect
+ * (including tools). OpenAI proper and OpenRouter both instantiate this —
+ * they differ only in name, endpoint, headers, and env defaults.
+ */
+export declare class OpenAICompatibleProvider implements Provider {
+    readonly name: string;
+    private client;
+    private model;
+    constructor(name: string, opts: OpenAICompatibleOptions);
+    complete(req: CompletionRequest): Promise<string>;
+    converse(req: ConverseRequest): Promise<ConverseResult>;
+}
+export declare class OpenAIProvider extends OpenAICompatibleProvider {
+    constructor(apiKey: string, model?: string);
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,QAAQ,EAET,MAAM,YAAY,CAAA;AAEnB,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EAAE,GACvB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,0BAA0B,EAAE,CA0BtD;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,qBAAqB,GACrD,cAAc,CAchB;AAaD,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,QAAQ;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,KAAK,CAAQ;gBAET,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB;IAejD,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAajD,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAiB9D;AAED,qBAAa,cAAe,SAAQ,wBAAwB;gBAC9C,MAAM,EAAE,MAAM,EAAE,KAAK,SAAwC;CAG1E"}

package/dist/providers/openai.js

@@ -0,0 +1,118 @@
+import OpenAI from "openai";
+import { maxTokens, providerMaxRetries, providerTimeoutMs } from "./clientOptions.js";
+/** Map provider-neutral messages to OpenAI chat messages (pure; tested). */
+export function toOpenAIMessages(messages) {
+    const out = [];
+    for (const m of messages) {
+        if (m.role === "user") {
+            out.push({ role: "user", content: m.text });
+        }
+        else if (m.role === "assistant") {
+            const msg = {
+                role: "assistant",
+                content: m.text,
+            };
+            if (m.toolCalls.length > 0) {
+                msg.tool_calls = m.toolCalls.map((tc) => ({
+                    id: tc.id,
+                    type: "function",
+                    function: { name: tc.name, arguments: JSON.stringify(tc.input) },
+                }));
+            }
+            out.push(msg);
+        }
+        else {
+            // Each tool result becomes its own `tool` message keyed by the call id.
+            for (const r of m.results) {
+                out.push({ role: "tool", tool_call_id: r.toolCallId, content: r.content });
+            }
+        }
+    }
+    return out;
+}
+/** Reduce an OpenAI response message to text + tool calls (pure; tested). */
+export function parseOpenAIMessage(message) {
+    // Surface a refusal as text so a refused turn is distinguishable from a normal
+    // empty-but-final one (otherwise the agent loop ends silently with no signal).
+    const text = message.content ?? (message.refusal ? `Refused: ${message.refusal}` : "");
+    const toolCalls = [];
+    for (const tc of message.tool_calls ?? []) {
+        if (tc.type !== "function")
+            continue;
+        toolCalls.push({
+            id: tc.id,
+            name: tc.function.name,
+            input: parseArguments(tc.function.arguments),
+        });
+    }
+    return { text, toolCalls };
+}
+/** Parse a tool-call arguments JSON string, tolerating empty/invalid input. */
+function parseArguments(raw) {
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Shared core for providers speaking the OpenAI chat.completions dialect
+ * (including tools). OpenAI proper and OpenRouter both instantiate this —
+ * they differ only in name, endpoint, headers, and env defaults.
+ */
+export class OpenAICompatibleProvider {
+    name;
+    client;
+    model;
+    constructor(name, opts) {
+        // The SDK retries transient 429/5xx/network errors with exponential backoff
+        // internally, so a blip doesn't fail the whole run; `timeout` bounds each
+        // request. Both are env-overridable.
+        this.name = name;
+        this.client = new OpenAI({
+            apiKey: opts.apiKey,
+            timeout: providerTimeoutMs(),
+            maxRetries: providerMaxRetries(),
+            ...(opts.baseURL !== undefined ? { baseURL: opts.baseURL } : {}),
+            ...(opts.defaultHeaders !== undefined ? { defaultHeaders: opts.defaultHeaders } : {}),
+        });
+        this.model = opts.model;
+    }
+    async complete(req) {
+        const completion = await this.client.chat.completions.create({
+            model: this.model,
+            max_tokens: maxTokens(), // match AnthropicProvider rather than the model default
+            messages: [
+                { role: "system", content: req.system },
+                { role: "user", content: req.prompt },
+            ],
+        });
+        return completion.choices[0]?.message?.content ?? "";
+    }
+    async converse(req) {
+        const tools = req.tools.map((t) => ({
+            type: "function",
+            function: { name: t.name, description: t.description, parameters: t.inputSchema },
+        }));
+        const completion = await this.client.chat.completions.create({
+            model: this.model,
+            max_tokens: maxTokens(), // match AnthropicProvider rather than the model default
+            messages: [{ role: "system", content: req.system }, ...toOpenAIMessages(req.messages)],
+            ...(tools.length > 0 ? { tools } : {}),
+        });
+        const message = completion.choices[0]?.message;
+        if (!message)
+            return { text: "", toolCalls: [] };
+        return parseOpenAIMessage(message);
+    }
+}
+export class OpenAIProvider extends OpenAICompatibleProvider {
+    constructor(apiKey, model = process.env.OPENAI_MODEL ?? "gpt-4.1") {
+        super("openai", { apiKey, model });
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/providers/openrouter.d.ts

@@ -0,0 +1,29 @@
+import { OpenAICompatibleProvider } from "./openai.js";
+export declare const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+/**
+ * Default model when neither the payload nor OPENROUTER_MODEL specifies one.
+ * OpenRouter model ids are provider-namespaced (`anthropic/...`, `openai/...`)
+ * and pass through to the API untouched.
+ */
+export declare const OPENROUTER_DEFAULT_MODEL = "anthropic/claude-sonnet-4.5";
+/**
+ * The optional attribution OpenRouter's convention asks apps to send, used for
+ * its public rankings. The kernel has no app identity of its own, so it sends
+ * nothing unless the embedding application supplies one.
+ */
+export interface OpenRouterAttribution {
+    /** App URL, sent as the `HTTP-Referer` header. */
+    referer?: string;
+    /** App name, sent as the `X-Title` header. */
+    title?: string;
+}
+/**
+ * OpenRouter speaks the OpenAI chat.completions dialect (including tools), so
+ * this is the shared OpenAI-compatible core pointed at openrouter.ai. Pass
+ * `attribution` to identify your app in OpenRouter's rankings; omit it and no
+ * attribution headers are sent.
+ */
+export declare class OpenRouterProvider extends OpenAICompatibleProvider {
+    constructor(apiKey: string, model?: string, attribution?: OpenRouterAttribution);
+}
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/providers/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../src/providers/openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAEtD,eAAO,MAAM,mBAAmB,iCAAiC,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,gCAAgC,CAAA;AAErE;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAUD;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,wBAAwB;gBAE5D,MAAM,EAAE,MAAM,EACd,KAAK,SAA2D,EAChE,WAAW,GAAE,qBAA0B;CAU1C"}

package/dist/providers/openrouter.js

@@ -0,0 +1,35 @@
+import { OpenAICompatibleProvider } from "./openai.js";
+export const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+/**
+ * Default model when neither the payload nor OPENROUTER_MODEL specifies one.
+ * OpenRouter model ids are provider-namespaced (`anthropic/...`, `openai/...`)
+ * and pass through to the API untouched.
+ */
+export const OPENROUTER_DEFAULT_MODEL = "anthropic/claude-sonnet-4.5";
+/** Build the attribution headers, omitting any the caller left unset. */
+function attributionHeaders(attribution) {
+    const headers = {};
+    if (attribution.referer)
+        headers["HTTP-Referer"] = attribution.referer;
+    if (attribution.title)
+        headers["X-Title"] = attribution.title;
+    return headers;
+}
+/**
+ * OpenRouter speaks the OpenAI chat.completions dialect (including tools), so
+ * this is the shared OpenAI-compatible core pointed at openrouter.ai. Pass
+ * `attribution` to identify your app in OpenRouter's rankings; omit it and no
+ * attribution headers are sent.
+ */
+export class OpenRouterProvider extends OpenAICompatibleProvider {
+    constructor(apiKey, model = process.env.OPENROUTER_MODEL ?? OPENROUTER_DEFAULT_MODEL, attribution = {}) {
+        const headers = attributionHeaders(attribution);
+        super("openrouter", {
+            apiKey,
+            model,
+            baseURL: OPENROUTER_BASE_URL,
+            ...(Object.keys(headers).length > 0 ? { defaultHeaders: headers } : {}),
+        });
+    }
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/providers/openrouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.js","sourceRoot":"","sources":["../../src/providers/openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAA;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,6BAA6B,CAAA;AAcrE,yEAAyE;AACzE,SAAS,kBAAkB,CAAC,WAAkC;IAC5D,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,IAAI,WAAW,CAAC,OAAO;QAAE,OAAO,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC,OAAO,CAAA;IACtE,IAAI,WAAW,CAAC,KAAK;QAAE,OAAO,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,KAAK,CAAA;IAC7D,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,wBAAwB;IAC9D,YACE,MAAc,EACd,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,wBAAwB,EAChE,cAAqC,EAAE;QAEvC,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;QAC/C,KAAK,CAAC,YAAY,EAAE;YAClB,MAAM;YACN,KAAK;YACL,OAAO,EAAE,mBAAmB;YAC5B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/providers/types.d.ts

@@ -0,0 +1,60 @@
+export interface CompletionRequest {
+    system: string;
+    prompt: string;
+}
+/** A tool offered to the model, described by a JSON-Schema input shape. */
+export interface ToolSpec {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/** The model's request to invoke a tool. */
+export interface ToolCall {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/** The reply to a ToolCall. */
+export interface ToolResult {
+    toolCallId: string;
+    /** The string projection sent to the model — the only part a provider serializes. */
+    content: string;
+    /**
+     * The typed payload `content` was projected from, when the tool produced one.
+     * Providers ignore it; callers and clients read it to avoid re-parsing a
+     * struct back out of the string.
+     */
+    structured?: unknown;
+    isError?: boolean;
+}
+/** Provider-neutral conversation turn (mapped to each provider's wire format). */
+export type AgentMessage = {
+    role: "user";
+    text: string;
+} | {
+    role: "assistant";
+    text: string;
+    toolCalls: ToolCall[];
+} | {
+    role: "tool";
+    results: ToolResult[];
+};
+export interface ConverseRequest {
+    system: string;
+    messages: AgentMessage[];
+    tools: ToolSpec[];
+}
+export interface ConverseResult {
+    /** Assistant prose for this turn (may be empty when it only calls tools). */
+    text: string;
+    /** Tools the model wants run; empty means the turn is final. */
+    toolCalls: ToolCall[];
+}
+export interface Provider {
+    readonly name: string;
+    /** One-shot completion (no tools) — kept for simple callers. */
+    complete(req: CompletionRequest): Promise<string>;
+    /** One step of a tool-use conversation; the agent loop drives the rest. */
+    converse(req: ConverseRequest): Promise<ConverseResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,4CAA4C;AAC5C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,kFAAkF;AAClF,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAAA;AAE3C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,SAAS,EAAE,QAAQ,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACjD,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CACxD"}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

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

package/dist/routing/staticResolver.d.ts

@@ -0,0 +1,41 @@
+import { type CapabilityDefinition, type ResolvedRoute, type RouteContext, type RouteResolver } from "./types.js";
+/**
+ * The kernel's built-in resolver: capabilities as code.
+ *
+ * It takes a list of {@link CapabilityDefinition}s — from a literal, a JSON
+ * file, environment config, anything the application already has — and resolves
+ * names against them in memory. No database, no migration, no service to stand
+ * up. That matters beyond convenience: it means the whole seam is exercisable
+ * in a unit test, and an application that never wants dynamic routing never
+ * needs any infrastructure at all.
+ *
+ * An application that *does* want dynamic routing writes its own
+ * {@link RouteResolver} against the same interface. That adapter — with its
+ * tables, its prompt versioning, its per-tenant overrides — lives in the app
+ * layer. It does not live here.
+ */
+export declare class StaticRouteResolver implements RouteResolver {
+    readonly name = "static";
+    private readonly definitions;
+    constructor(definitions?: CapabilityDefinition[]);
+    /**
+     * Add or replace a capability. Unlike the model registry, redefinition is
+     * allowed: a resolver is configuration, and layering a config file over a
+     * built-in default is a normal thing to want.
+     */
+    define(definition: CapabilityDefinition): this;
+    has(capability: string): boolean;
+    /** Every defined capability name. */
+    capabilities(): string[];
+    /**
+     * Resolve a name to its route, filling defaults for the optional parts so
+     * callers get a fully-determined {@link ResolvedRoute}. Throws
+     * {@link UnknownCapabilityError} when the name isn't defined.
+     *
+     * `ctx` is accepted for interface parity and ignored here — static routing is
+     * by definition context-free. A resolver that varies by invocation mode or
+     * tenant is exactly the app-layer adapter this interface exists to admit.
+     */
+    resolve(capability: string, _ctx?: RouteContext): Promise<ResolvedRoute>;
+}
+//# sourceMappingURL=staticResolver.d.ts.map

package/dist/routing/staticResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticResolver.d.ts","sourceRoot":"","sources":["../../src/routing/staticResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,IAAI,YAAW;IAExB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;gBAE1D,WAAW,GAAE,oBAAoB,EAAO;IAIpD;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI;IAK9C,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC,qCAAqC;IACrC,YAAY,IAAI,MAAM,EAAE;IAIxB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CAkBzE"}

package/dist/routing/staticResolver.js

@@ -0,0 +1,67 @@
+import { UnknownCapabilityError, } from "./types.js";
+/**
+ * The kernel's built-in resolver: capabilities as code.
+ *
+ * It takes a list of {@link CapabilityDefinition}s — from a literal, a JSON
+ * file, environment config, anything the application already has — and resolves
+ * names against them in memory. No database, no migration, no service to stand
+ * up. That matters beyond convenience: it means the whole seam is exercisable
+ * in a unit test, and an application that never wants dynamic routing never
+ * needs any infrastructure at all.
+ *
+ * An application that *does* want dynamic routing writes its own
+ * {@link RouteResolver} against the same interface. That adapter — with its
+ * tables, its prompt versioning, its per-tenant overrides — lives in the app
+ * layer. It does not live here.
+ */
+export class StaticRouteResolver {
+    name = "static";
+    definitions = new Map();
+    constructor(definitions = []) {
+        for (const definition of definitions)
+            this.define(definition);
+    }
+    /**
+     * Add or replace a capability. Unlike the model registry, redefinition is
+     * allowed: a resolver is configuration, and layering a config file over a
+     * built-in default is a normal thing to want.
+     */
+    define(definition) {
+        this.definitions.set(definition.name, definition);
+        return this;
+    }
+    has(capability) {
+        return this.definitions.has(capability);
+    }
+    /** Every defined capability name. */
+    capabilities() {
+        return [...this.definitions.keys()];
+    }
+    /**
+     * Resolve a name to its route, filling defaults for the optional parts so
+     * callers get a fully-determined {@link ResolvedRoute}. Throws
+     * {@link UnknownCapabilityError} when the name isn't defined.
+     *
+     * `ctx` is accepted for interface parity and ignored here — static routing is
+     * by definition context-free. A resolver that varies by invocation mode or
+     * tenant is exactly the app-layer adapter this interface exists to admit.
+     */
+    resolve(capability, _ctx) {
+        const definition = this.definitions.get(capability);
+        if (!definition) {
+            // Rejected, not thrown: the interface promises a Promise, and a caller
+            // that attached `.catch()` instead of awaiting would otherwise be hit by
+            // a synchronous throw it never had a chance to handle.
+            return Promise.reject(new UnknownCapabilityError(capability, this.capabilities()));
+        }
+        return Promise.resolve({
+            capability: definition.name,
+            model: definition.model,
+            prompt: definition.prompt ?? "",
+            tools: definition.tools ?? [],
+            limits: definition.limits ?? {},
+            ...(definition.meta ? { meta: definition.meta } : {}),
+        });
+    }
+}
+//# sourceMappingURL=staticResolver.js.map

package/dist/routing/staticResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticResolver.js","sourceRoot":"","sources":["../../src/routing/staticResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAKvB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,mBAAmB;IACrB,IAAI,GAAG,QAAQ,CAAA;IAEP,WAAW,GAAG,IAAI,GAAG,EAAgC,CAAA;IAEtE,YAAY,cAAsC,EAAE;QAClD,KAAK,MAAM,UAAU,IAAI,WAAW;YAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAC/D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAgC;QACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QACjD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACzC,CAAC;IAED,qCAAqC;IACrC,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAkB,EAAE,IAAmB;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACnD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,uEAAuE;YACvE,yEAAyE;YACzE,uDAAuD;YACvD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA;QACpF,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,UAAU,EAAE,UAAU,CAAC,IAAI;YAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;YAC/B,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;YAC/B,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/routing/types.d.ts

@@ -0,0 +1,72 @@
+import type { ModelRef } from "../models/registry.js";
+import type { InvocationMode } from "../tools/metadata.js";
+/**
+ * Route resolution: "which model, prompt and tools should capability X use?"
+ *
+ * This sits **one layer above** the model registry. A resolver picks the whole
+ * bundle for a named capability; the {@link ModelRef} it returns is then bound
+ * to a concrete implementation by `ModelRegistry.resolve`. The two are not the
+ * same question and must not be conflated:
+ *
+ *   resolver:  "summarise-thread"      → { model: chat:anthropic, prompt, tools }
+ *   registry:  { kind: "chat", id: "anthropic" } → the ModelInvocation
+ *
+ * The kernel ships exactly one resolver — {@link StaticRouteResolver}, backed by
+ * plain code or config, usable with zero infrastructure. A database-backed
+ * resolver is an **app-layer adapter behind this interface**, never a kernel
+ * concern: the kernel has no database, no schema and no control plane, and the
+ * moment a field here exists only to serve one product's tables, this seam has
+ * drifted across the line.
+ */
+/** A capability as declared by the application: the bundle, before resolution. */
+export interface CapabilityDefinition {
+    /** The name callers route by. */
+    name: string;
+    /** Which model kind + id serves it. */
+    model: ModelRef;
+    /** System prompt for the capability. */
+    prompt?: string;
+    /** Tool names this capability may use; absent means "no restriction". */
+    tools?: string[];
+    /** Budgets an engine or loop should honour. */
+    limits?: RouteLimits;
+    /** Free-form application detail carried through resolution untouched. */
+    meta?: Record<string, unknown>;
+}
+export interface RouteLimits {
+    maxSteps?: number;
+    maxDurationMs?: number;
+}
+/** What a resolver returns: a fully-determined route for one capability. */
+export interface ResolvedRoute {
+    capability: string;
+    model: ModelRef;
+    prompt: string;
+    tools: string[];
+    limits: RouteLimits;
+    meta?: Record<string, unknown>;
+}
+/**
+ * The little a resolver is told about the call site. Deliberately thin — the
+ * moment this grows product-shaped fields, resolution has stopped being generic.
+ */
+export interface RouteContext {
+    /** How the turn was invoked; a resolver may route differently per mode. */
+    mode?: InvocationMode;
+    correlationId?: string;
+}
+/** Thrown when a capability name has no route. */
+export declare class UnknownCapabilityError extends Error {
+    readonly capability: string;
+    constructor(capability: string, known: string[]);
+}
+/**
+ * Resolves a capability name to a route. Implementations must **fail loud** on
+ * an unknown capability rather than returning a default — a silently-defaulted
+ * route sends traffic to the wrong model with no signal.
+ */
+export interface RouteResolver {
+    readonly name: string;
+    resolve(capability: string, ctx?: RouteContext): Promise<ResolvedRoute>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/routing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/routing/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AAEH,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,KAAK,EAAE,QAAQ,CAAA;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,kDAAkD;AAClD,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;CAMhD;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CACxE"}

package/dist/routing/types.js

@@ -0,0 +1,11 @@
+/** Thrown when a capability name has no route. */
+export class UnknownCapabilityError extends Error {
+    capability;
+    constructor(capability, known) {
+        const alternatives = known.length > 0 ? known.join(", ") : "(none defined)";
+        super(`no route defined for capability "${capability}" — defined: ${alternatives}`);
+        this.name = "UnknownCapabilityError";
+        this.capability = capability;
+    }
+}
+//# sourceMappingURL=types.js.map