@chances-ai/engine 24.0.0

package/dist/ai/known-models.js

@@ -0,0 +1,129 @@
+export const KNOWN_MODELS = [
+    {
+        id: "anthropic",
+        api: "anthropic",
+        envKey: "ANTHROPIC_API_KEY",
+        models: [
+            m("claude-opus-4-7", "anthropic", "anthropic", 200_000, 15, 75, true, true),
+            m("claude-sonnet-4-6", "anthropic", "anthropic", 200_000, 3, 15, true, true),
+            m("claude-haiku-4-5", "anthropic", "anthropic", 200_000, 0.8, 4, true, false),
+        ],
+    },
+    {
+        id: "openai",
+        api: "openai",
+        envKey: "OPENAI_API_KEY",
+        models: [
+            m("gpt-4o", "openai", "openai", 128_000, 2.5, 10, true, true),
+            m("gpt-4o-mini", "openai", "openai", 128_000, 0.15, 0.6, true, false),
+        ],
+    },
+    {
+        id: "google",
+        api: "google",
+        envKey: "GOOGLE_GENERATIVE_AI_API_KEY",
+        models: [
+            m("gemini-2.0-flash", "google", "google", 1_048_576, 0.1, 0.4, true, true),
+            m("gemini-1.5-pro", "google", "google", 2_097_152, 1.25, 5, true, true),
+        ],
+    },
+    {
+        id: "xai",
+        api: "openai-compatible",
+        envKey: "XAI_API_KEY",
+        baseURL: "https://api.x.ai/v1",
+        models: [m("grok-2-latest", "xai", "openai-compatible", 131_072, 2, 10, true, false)],
+    },
+    {
+        id: "groq",
+        api: "openai-compatible",
+        envKey: "GROQ_API_KEY",
+        baseURL: "https://api.groq.com/openai/v1",
+        models: [
+            m("llama-3.3-70b-versatile", "groq", "openai-compatible", 131_072, 0.59, 0.79, true, false),
+        ],
+    },
+    {
+        id: "openrouter",
+        api: "openai-compatible",
+        envKey: "OPENROUTER_API_KEY",
+        baseURL: "https://openrouter.ai/api/v1",
+        // openrouter is a passthrough router — supportsTools depends on the
+        // underlying model. `openrouter/auto` picks per-request from openrouter's
+        // routing logic, so we cannot promise tool support and leave it `false`
+        // — the router will skip it for tool-required turns. Slug-specific
+        // models (like the claude-3.5 entry below) declare their real capability.
+        models: [
+            m("openrouter/auto", "openrouter", "openai-compatible", 200_000, 0, 0, false, false),
+            m("anthropic/claude-3.5-sonnet", "openrouter", "openai-compatible", 200_000, 3, 15, true, true),
+        ],
+    },
+    {
+        id: "deepseek",
+        api: "openai-compatible",
+        envKey: "DEEPSEEK_API_KEY",
+        baseURL: "https://api.deepseek.com",
+        models: [
+            m("deepseek-chat", "deepseek", "openai-compatible", 65_536, 0.27, 1.1, true, false),
+            m("deepseek-reasoner", "deepseek", "openai-compatible", 65_536, 0.55, 2.19, true, false),
+        ],
+    },
+    {
+        id: "doubao",
+        api: "openai-compatible",
+        envKey: "ARK_API_KEY",
+        baseURL: "https://ark.cn-beijing.volces.com/api/v3",
+        // Doubao 1.5 pro 32k supports function-calling; pricing is the public
+        // Volcengine ark list as of integration time and should be re-verified.
+        models: [
+            m("doubao-1-5-pro-32k", "doubao", "openai-compatible", 32_768, 0.11, 0.27, true, false),
+            m("doubao-1-5-pro-256k", "doubao", "openai-compatible", 262_144, 0.69, 1.37, true, false),
+        ],
+    },
+    {
+        id: "minimax",
+        api: "openai-compatible",
+        envKey: "MINIMAX_API_KEY",
+        baseURL: "https://api.minimax.chat/v1",
+        // Tool-use on MiniMax abab-6.5s is supported via OpenAI-compat function
+        // calling; older abab variants are not. Stick to the modern model.
+        models: [
+            m("abab6.5s-chat", "minimax", "openai-compatible", 245_760, 0.14, 0.14, true, false),
+        ],
+    },
+    {
+        id: "glm",
+        api: "openai-compatible",
+        envKey: "ZHIPUAI_API_KEY",
+        baseURL: "https://open.bigmodel.cn/api/paas/v4",
+        models: [
+            m("glm-4-plus", "glm", "openai-compatible", 131_072, 0.69, 0.69, true, false),
+            m("glm-4-flash", "glm", "openai-compatible", 131_072, 0, 0, true, false),
+        ],
+    },
+    {
+        id: "kimi",
+        api: "openai-compatible",
+        envKey: "MOONSHOT_API_KEY",
+        baseURL: "https://api.moonshot.cn/v1",
+        // Moonshot v1 supports function calling on 8k/32k/128k tiers. Older
+        // models did not — verify per-model before adding here.
+        models: [
+            m("moonshot-v1-32k", "kimi", "openai-compatible", 32_768, 3.42, 3.42, true, false),
+            m("moonshot-v1-128k", "kimi", "openai-compatible", 131_072, 8.22, 8.22, true, false),
+        ],
+    },
+];
+function m(id, provider, api, contextWindow, inputCostPerMTok, outputCostPerMTok, supportsTools, supportsVision) {
+    return {
+        id,
+        provider,
+        api,
+        contextWindow,
+        supportsTools,
+        supportsVision,
+        inputCostPerMTok,
+        outputCostPerMTok,
+    };
+}
+//# sourceMappingURL=known-models.js.map

package/dist/ai/known-models.js.map

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

package/dist/ai/registry.d.ts

@@ -0,0 +1,12 @@
+import type { ModelDescriptor, ProviderAdapter } from "./types.js";
+/** Registry pattern: aggregates the models every loaded adapter advertises. */
+export declare class ModelRegistry {
+    private readonly models;
+    private readonly adapters;
+    register(adapter: ProviderAdapter): void;
+    adapterFor(modelId: string): ProviderAdapter | undefined;
+    get(modelId: string): ModelDescriptor | undefined;
+    all(): ModelDescriptor[];
+    providers(): string[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/ai/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/ai/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,+EAA+E;AAC/E,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAE/D,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAKxC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAKxD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIjD,GAAG,IAAI,eAAe,EAAE;IAIxB,SAAS,IAAI,MAAM,EAAE;CAGtB"}

package/dist/ai/registry.js

@@ -0,0 +1,24 @@
+/** Registry pattern: aggregates the models every loaded adapter advertises. */
+export class ModelRegistry {
+    models = new Map();
+    adapters = new Map();
+    register(adapter) {
+        this.adapters.set(adapter.id, adapter);
+        for (const model of adapter.listModels())
+            this.models.set(model.id, model);
+    }
+    adapterFor(modelId) {
+        const model = this.models.get(modelId);
+        return model ? this.adapters.get(model.provider) : undefined;
+    }
+    get(modelId) {
+        return this.models.get(modelId);
+    }
+    all() {
+        return [...this.models.values()];
+    }
+    providers() {
+        return [...this.adapters.keys()];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/ai/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/ai/registry.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,OAAO,aAAa;IACP,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC5C,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE/D,QAAQ,CAAC,OAAwB;QAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,EAAE;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;IAED,UAAU,CAAC,OAAe;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAED,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/ai/retry.d.ts

@@ -0,0 +1,11 @@
+export interface RetryDecision {
+    retryable: boolean;
+    reason: "rate-limit" | "server-5xx" | "network" | "non-retryable";
+}
+export declare function classifyProviderError(message: string): RetryDecision;
+export interface RetryConfig {
+    /** Backoff before each retry attempt, in ms. Length caps the retry count. */
+    delaysMs: readonly number[];
+}
+export declare const defaultRetryConfig: RetryConfig;
+//# sourceMappingURL=retry.d.ts.map

package/dist/ai/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/ai/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,eAAe,CAAC;CACnE;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAKpE;AAED,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,kBAAkB,EAAE,WAA6C,CAAC"}

package/dist/ai/retry.js

@@ -0,0 +1,14 @@
+const RATE_LIMIT_RX = /(rate.?limit|\b429\b|too\s+many\s+requests|throttl|quota\s+exceed)/i;
+const SERVER_5XX_RX = /(\b5\d\d\b|service\s+unavailable|gateway\s+timeout|internal\s+server\s+error|bad\s+gateway|overloaded_error|model\s+is\s+overloaded)/i;
+const NETWORK_RX = /(econnreset|econnrefused|etimedout|enotfound|socket\s+hang\s+up|connection\s+refused|network\s+error|fetch\s+failed|deadline\s+exceeded)/i;
+export function classifyProviderError(message) {
+    if (RATE_LIMIT_RX.test(message))
+        return { retryable: true, reason: "rate-limit" };
+    if (SERVER_5XX_RX.test(message))
+        return { retryable: true, reason: "server-5xx" };
+    if (NETWORK_RX.test(message))
+        return { retryable: true, reason: "network" };
+    return { retryable: false, reason: "non-retryable" };
+}
+export const defaultRetryConfig = { delaysMs: [500, 1000, 2000] };
+//# sourceMappingURL=retry.js.map

package/dist/ai/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/ai/retry.ts"],"names":[],"mappings":"AAKA,MAAM,aAAa,GAAG,qEAAqE,CAAC;AAC5F,MAAM,aAAa,GAAG,uIAAuI,CAAC;AAC9J,MAAM,UAAU,GAAG,2IAA2I,CAAC;AAE/J,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClF,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClF,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC5E,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AACvD,CAAC;AAOD,MAAM,CAAC,MAAM,kBAAkB,GAAgB,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC"}

package/dist/ai/router.d.ts

@@ -0,0 +1,25 @@
+import type { ModelRegistry } from "./registry.js";
+import type { ModelDescriptor, ProviderAdapter } from "./types.js";
+export interface RouteHints {
+    /** Caller's preferred model id (e.g. from config). */
+    preferredModel?: string;
+    /** Caller's preferred provider id. */
+    preferredProvider?: string;
+    /** True when the turn may issue tool calls. */
+    needsTools?: boolean;
+}
+export interface Route {
+    adapter: ProviderAdapter;
+    model: ModelDescriptor;
+}
+/**
+ * Strategy pattern. 1.x is rule-based: honor an explicit model, else the first
+ * model of the preferred provider, else the cheapest tool-capable model.
+ * 2.x swaps in profile/policy strategies + fallback chains without touching core.
+ */
+export declare class ModelRouter {
+    private readonly registry;
+    constructor(registry: ModelRegistry);
+    pick(hints?: RouteHints): Route;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/ai/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/ai/router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,aAAa;IAEpD,IAAI,CAAC,KAAK,GAAE,UAAe,GAAG,KAAK;CAyBpC"}

package/dist/ai/router.js

@@ -0,0 +1,36 @@
+import { AppError, ErrorCode } from "@chances-ai/runtime";
+/**
+ * Strategy pattern. 1.x is rule-based: honor an explicit model, else the first
+ * model of the preferred provider, else the cheapest tool-capable model.
+ * 2.x swaps in profile/policy strategies + fallback chains without touching core.
+ */
+export class ModelRouter {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    pick(hints = {}) {
+        const candidates = this.registry.all();
+        if (candidates.length === 0) {
+            throw new AppError(ErrorCode.Provider, "No models registered");
+        }
+        let model;
+        if (hints.preferredModel)
+            model = this.registry.get(hints.preferredModel);
+        if (!model && hints.preferredProvider) {
+            model = candidates.find((m) => m.provider === hints.preferredProvider);
+        }
+        if (!model) {
+            const pool = hints.needsTools ? candidates.filter((m) => m.supportsTools) : candidates;
+            model = [...(pool.length ? pool : candidates)].sort((a, b) => a.inputCostPerMTok - b.inputCostPerMTok)[0];
+        }
+        if (!model)
+            throw new AppError(ErrorCode.Provider, "No suitable model found");
+        const adapter = this.registry.adapterFor(model.id);
+        if (!adapter) {
+            throw new AppError(ErrorCode.Provider, `No adapter for model ${model.id}`);
+        }
+        return { adapter, model };
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/ai/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/ai/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAkB1D;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,QAAuB;QAAvB,aAAQ,GAAR,QAAQ,CAAe;IAAG,CAAC;IAExD,IAAI,CAAC,QAAoB,EAAE;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,KAAkC,CAAC;QACvC,IAAI,KAAK,CAAC,cAAc;YAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YACtC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YACvF,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAClD,CAAC,CAAC,CAAC,CAAC;QACP,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;QAE9E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,wBAAwB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/ai/setup.d.ts

@@ -0,0 +1,23 @@
+import { type ProviderEntry } from "./known-models.js";
+import { ModelRegistry } from "./registry.js";
+export interface RegistryOptions {
+    /** Resolve an API key by provider id (e.g. "deepseek"), or undefined. */
+    apiKeyFor: (providerId: string) => string | undefined;
+    /** Override KNOWN_MODELS — useful for tests and config-driven setups. */
+    providers?: ProviderEntry[];
+}
+/**
+ * Composition helper: always register the offline mock, then walk the
+ * provider table and register one adapter per provider whose key is set.
+ * Dispatch is data-driven by `ProviderEntry.api` — no if/else over provider
+ * id in callers, so adding a new OpenAI-compatible vendor is a single entry
+ * in {@link KNOWN_MODELS}.
+ */
+export declare function buildRegistry(opts: RegistryOptions): ModelRegistry;
+/**
+ * Convenience: turn the provider table into the `envByProvider` map that
+ * `AuthStore` needs. Used at boot so the env-name list lives in one place
+ * (here) rather than being duplicated in `@chances-ai/config`.
+ */
+export declare function envByProviderFrom(providers?: ProviderEntry[]): Record<string, string>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/ai/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/ai/setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtD,yEAAyE;IACzE,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,CAWlE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,aAAa,EAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnG"}

package/dist/ai/setup.js

@@ -0,0 +1,47 @@
+import { AiSdkAdapter } from "./adapters/ai-sdk.js";
+import { MockAdapter } from "./adapters/mock.js";
+import { OpenAICompatibleAdapter } from "./adapters/openai-compatible.js";
+import { KNOWN_MODELS } from "./known-models.js";
+import { ModelRegistry } from "./registry.js";
+/**
+ * Composition helper: always register the offline mock, then walk the
+ * provider table and register one adapter per provider whose key is set.
+ * Dispatch is data-driven by `ProviderEntry.api` — no if/else over provider
+ * id in callers, so adding a new OpenAI-compatible vendor is a single entry
+ * in {@link KNOWN_MODELS}.
+ */
+export function buildRegistry(opts) {
+    const registry = new ModelRegistry();
+    registry.register(new MockAdapter());
+    const providers = opts.providers ?? KNOWN_MODELS;
+    for (const entry of providers) {
+        const apiKey = opts.apiKeyFor(entry.id);
+        if (!apiKey)
+            continue;
+        registry.register(buildAdapter(entry, apiKey));
+    }
+    return registry;
+}
+/**
+ * Convenience: turn the provider table into the `envByProvider` map that
+ * `AuthStore` needs. Used at boot so the env-name list lives in one place
+ * (here) rather than being duplicated in `@chances-ai/config`.
+ */
+export function envByProviderFrom(providers = KNOWN_MODELS) {
+    return Object.fromEntries(providers.map((p) => [p.id, p.envKey]));
+}
+function buildAdapter(entry, apiKey) {
+    if (entry.api === "openai-compatible") {
+        if (!entry.baseURL) {
+            throw new Error(`provider '${entry.id}' is api=openai-compatible but has no baseURL`);
+        }
+        return new OpenAICompatibleAdapter({
+            provider: entry.id,
+            baseURL: entry.baseURL,
+            apiKey,
+            models: entry.models,
+        });
+    }
+    return new AiSdkAdapter({ provider: entry.api, apiKey, models: entry.models });
+}
+//# sourceMappingURL=setup.js.map

package/dist/ai/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/ai/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAsB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAS9C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAqB;IACjD,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;IAErC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAA6B,YAAY;IACzE,OAAO,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,YAAY,CAAC,KAAoB,EAAE,MAAc;IACxD,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,EAAE,+CAA+C,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,IAAI,uBAAuB,CAAC;YACjC,QAAQ,EAAE,KAAK,CAAC,EAAE;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM;YACN,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACjF,CAAC"}

package/dist/ai/summarizer.d.ts

@@ -0,0 +1,24 @@
+import type { Message, ProviderAdapter } from "./types.js";
+/**
+ * System prompt used for `/compact`. Fixed text — no per-call customization
+ * yet (3.x.later could let the user pass focus instructions on top). Kept
+ * tight on purpose so a 200-turn conversation doesn't blow the summary
+ * model's own context with the prompt itself.
+ *
+ * Modeled on oh-my-pi's compaction prompt structure but stripped of its
+ * file/edit/todo metadata sections — those depend on session-tree machinery
+ * we don't have. v3.0 ships text-only; the structured fields are a 3.x.later
+ * concern when we wire compaction into auto-trigger paths.
+ */
+export declare const COMPACT_SUMMARY_SYSTEM: string;
+/**
+ * Drives `adapter.stream` to summarize a message history into a single string.
+ *
+ * Returns the assembled assistant text. Tool calls emitted by the adapter
+ * during the summarization stream are ignored — summarization is a single
+ * turn that must not branch into more tool work. Any `error` event surfaces
+ * as `AppError(Provider)` so the caller can show a useful failure message
+ * instead of "Compaction failed: undefined".
+ */
+export declare function summarizeConversation(adapter: ProviderAdapter, modelId: string, messages: Message[], signal: AbortSignal): Promise<string>;
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/ai/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../src/ai/summarizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,QASvB,CAAC;AAEb;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/ai/summarizer.js

@@ -0,0 +1,56 @@
+import { AppError, ErrorCode } from "@chances-ai/runtime";
+/**
+ * System prompt used for `/compact`. Fixed text — no per-call customization
+ * yet (3.x.later could let the user pass focus instructions on top). Kept
+ * tight on purpose so a 200-turn conversation doesn't blow the summary
+ * model's own context with the prompt itself.
+ *
+ * Modeled on oh-my-pi's compaction prompt structure but stripped of its
+ * file/edit/todo metadata sections — those depend on session-tree machinery
+ * we don't have. v3.0 ships text-only; the structured fields are a 3.x.later
+ * concern when we wire compaction into auto-trigger paths.
+ */
+export const COMPACT_SUMMARY_SYSTEM = [
+    "You summarize software-engineering conversations.",
+    "Output a compact plain-text summary that preserves:",
+    "- decisions reached and the rationale behind them,",
+    "- file paths that were read, written, or discussed,",
+    "- unresolved questions or pending work,",
+    "- key error messages or test failures encountered.",
+    "Do NOT include greetings, sign-offs, or markdown headings. Plain prose only.",
+    "Aim for under 300 words; trim ruthlessly when the conversation is longer.",
+].join("\n");
+/**
+ * Drives `adapter.stream` to summarize a message history into a single string.
+ *
+ * Returns the assembled assistant text. Tool calls emitted by the adapter
+ * during the summarization stream are ignored — summarization is a single
+ * turn that must not branch into more tool work. Any `error` event surfaces
+ * as `AppError(Provider)` so the caller can show a useful failure message
+ * instead of "Compaction failed: undefined".
+ */
+export async function summarizeConversation(adapter, modelId, messages, signal) {
+    if (messages.length === 0)
+        return "";
+    let text = "";
+    const stream = adapter.stream({ model: modelId, system: COMPACT_SUMMARY_SYSTEM, messages, tools: [] }, signal);
+    for await (const event of stream) {
+        switch (event.type) {
+            case "text-delta":
+                text += event.text;
+                break;
+            case "error":
+                throw new AppError(ErrorCode.Provider, `Summarization failed: ${event.message}`);
+            // Usage + done + any stray tool-call are intentionally ignored — the
+            // summarizer doesn't need token bookkeeping (caller can compare
+            // session size before/after) and tool calls during summarization are
+            // a provider misconfiguration, not a user-visible failure.
+            case "usage":
+            case "tool-call":
+            case "done":
+                break;
+        }
+    }
+    return text;
+}
+//# sourceMappingURL=summarizer.js.map

package/dist/ai/summarizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.js","sourceRoot":"","sources":["../../src/ai/summarizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG1D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,mDAAmD;IACnD,qDAAqD;IACrD,oDAAoD;IACpD,qDAAqD;IACrD,yCAAyC;IACzC,oDAAoD;IACpD,8EAA8E;IAC9E,2EAA2E;CAC5E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAwB,EACxB,OAAe,EACf,QAAmB,EACnB,MAAmB;IAEnB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAC3B,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EACvE,MAAM,CACP,CAAC;IACF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,YAAY;gBACf,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;gBACnB,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,yBAAyB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACnF,qEAAqE;YACrE,gEAAgE;YAChE,qEAAqE;YACrE,2DAA2D;YAC3D,KAAK,OAAO,CAAC;YACb,KAAK,WAAW,CAAC;YACjB,KAAK,MAAM;gBACT,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ai/types.d.ts

@@ -0,0 +1,83 @@
+import type { JSONValue } from "@chances-ai/runtime";
+export type Role = "system" | "user" | "assistant" | "tool";
+export type ContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool-call";
+    callId: string;
+    name: string;
+    args: JSONValue;
+} | {
+    type: "tool-result";
+    callId: string;
+    name: string;
+    output: string;
+    ok: boolean;
+};
+export interface Message {
+    role: Role;
+    content: ContentPart[];
+}
+/** Provider-facing tool schema (no executor — execution lives in @chances-ai/tools). */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    /** JSON Schema for the parameters object. */
+    parameters: JSONValue;
+}
+export interface ToolCallRequest {
+    callId: string;
+    name: string;
+    args: JSONValue;
+}
+export interface Usage {
+    inputTokens: number;
+    outputTokens: number;
+}
+/**
+ * Protocol family used to talk to a provider. Drives which adapter class is
+ * instantiated in `buildRegistry`. Chinese providers and the Western "long
+ * tail" (xai / groq / openrouter) all flow through `openai-compatible`.
+ */
+export type ApiFamily = "anthropic" | "openai" | "google" | "openai-compatible";
+/** Capabilities, never hard-coded model names — the registry/router decide. */
+export interface ModelDescriptor {
+    id: string;
+    provider: string;
+    /** Wire protocol — selects which adapter handles the request. */
+    api: ApiFamily;
+    contextWindow: number;
+    supportsTools: boolean;
+    supportsVision: boolean;
+    inputCostPerMTok: number;
+    outputCostPerMTok: number;
+}
+export interface ChatRequest {
+    model: string;
+    system?: string;
+    messages: Message[];
+    tools: ToolDefinition[];
+}
+export type ProviderEvent = {
+    type: "text-delta";
+    text: string;
+} | {
+    type: "tool-call";
+    call: ToolCallRequest;
+} | {
+    type: "usage";
+    usage: Usage;
+} | {
+    type: "done";
+} | {
+    type: "error";
+    message: string;
+};
+/** The single seam every provider implements. `core` depends only on this. */
+export interface ProviderAdapter {
+    readonly id: string;
+    listModels(): ModelDescriptor[];
+    stream(req: ChatRequest, signal: AbortSignal): AsyncIterable<ProviderEvent>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAE5D,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAEhF,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,GAAG,EAAE,SAAS,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,UAAU,IAAI,eAAe,EAAE,CAAC;IAChC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;CAC7E"}

package/dist/ai/types.js

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

package/dist/ai/types.js.map

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

package/dist/core/compaction/circuit-breaker.d.ts

@@ -0,0 +1,32 @@
+/**
+ * (3.5) 3-strike circuit breaker. Mirrors claude-code
+ * `autoCompact.ts:286-294`: after N consecutive failures,
+ * `tripped()` returns true and threshold-triggered compaction
+ * stops firing. Manual `/compact` and reactive overflow recovery
+ * still bypass via `Compactor.compact()`'s own gating; a
+ * successful manual/overflow run also `reset()`s the counter so
+ * threshold compaction re-arms.
+ *
+ * Scope: per-`Compactor` instance, which is per-engine. Survives
+ * `/clear`, resets on `/resume` (new engine, new compactor — a
+ * deliberate `/resume` is the user starting fresh).
+ *
+ * Codex Round-1 SHOULD-FIX #3 spelled out the scope honesty: we
+ * call it "compactor-instance scope" not "session scope" to avoid
+ * future readers expecting persistence across process restarts.
+ */
+export declare class CircuitBreaker {
+    private failures;
+    private readonly limit;
+    constructor(limit?: number);
+    tripped(): boolean;
+    /** Records a fault. Cancelled errors should NOT be passed here —
+     * user-initiated cancellation is not a compactor fault. The caller
+     * is responsible for skipping this on `AppError(Cancelled)`. */
+    note(): void;
+    /** Called on a successful compaction OR a manual override. */
+    reset(): void;
+    /** Visible to tests / `/doctor` rendering. */
+    failureCount(): number;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/core/compaction/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,SAAI;IAIrB,OAAO,IAAI,OAAO;IAIlB;;oEAEgE;IAChE,IAAI,IAAI,IAAI;IAIZ,8DAA8D;IAC9D,KAAK,IAAI,IAAI;IAIb,8CAA8C;IAC9C,YAAY,IAAI,MAAM;CAGvB"}

package/dist/core/compaction/circuit-breaker.js

@@ -0,0 +1,42 @@
+/**
+ * (3.5) 3-strike circuit breaker. Mirrors claude-code
+ * `autoCompact.ts:286-294`: after N consecutive failures,
+ * `tripped()` returns true and threshold-triggered compaction
+ * stops firing. Manual `/compact` and reactive overflow recovery
+ * still bypass via `Compactor.compact()`'s own gating; a
+ * successful manual/overflow run also `reset()`s the counter so
+ * threshold compaction re-arms.
+ *
+ * Scope: per-`Compactor` instance, which is per-engine. Survives
+ * `/clear`, resets on `/resume` (new engine, new compactor — a
+ * deliberate `/resume` is the user starting fresh).
+ *
+ * Codex Round-1 SHOULD-FIX #3 spelled out the scope honesty: we
+ * call it "compactor-instance scope" not "session scope" to avoid
+ * future readers expecting persistence across process restarts.
+ */
+export class CircuitBreaker {
+    failures = 0;
+    limit;
+    constructor(limit = 3) {
+        this.limit = Math.max(1, limit);
+    }
+    tripped() {
+        return this.failures >= this.limit;
+    }
+    /** Records a fault. Cancelled errors should NOT be passed here —
+     * user-initiated cancellation is not a compactor fault. The caller
+     * is responsible for skipping this on `AppError(Cancelled)`. */
+    note() {
+        this.failures += 1;
+    }
+    /** Called on a successful compaction OR a manual override. */
+    reset() {
+        this.failures = 0;
+    }
+    /** Visible to tests / `/doctor` rendering. */
+    failureCount() {
+        return this.failures;
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map