@cleocode/core 2026.6.13 → 2026.6.15

package/dist/llm/provider-registry/builtin/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../src/llm/provider-registry/builtin/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,yCAAyC,CAAC;AAwChF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAa9B,CAAC"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../src/llm/provider-registry/builtin/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,yCAAyC,CAAC;AAqDhF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAa9B,CAAC"}

package/dist/llm/provider-registry/builtin/anthropic.js

@@ -37,28 +37,41 @@ function resolveAnthropicClientId() {
 /**
  * Anthropic OAuth PKCE configuration.
  *
- * Anthropic uses RFC 7636 PKCE (not device-code). Endpoints and redirect
- * URI mirror the Hermes Agent reference implementation
- * (`agent/anthropic_adapter.py` `_OAUTH_*` constants):
+ * Anthropic uses RFC 7636 PKCE (not device-code). Endpoints mirror the
+ * embedded Pi framework reference implementation
+ * (`@earendil-works/pi-ai` `dist/utils/oauth/anthropic.js`, also what
+ * OpenCode and Claude Code use):
  *   - authorizationEndpoint: https://claude.ai/oauth/authorize
- *   - tokenEndpoint:         https://console.anthropic.com/v1/oauth/token
- *   - redirectUri:           https://console.anthropic.com/oauth/code/callback
+ *   - tokenEndpoint:         https://platform.claude.com/v1/oauth/token
+ *   - redirectUri:           https://platform.claude.com/oauth/code/callback
+ *
+ * The `console.anthropic.com` endpoints were retired in the Anthropic →
+ * claude.com domain migration: the authorize server redirects to
+ * `platform.claude.com/oauth/code/callback` regardless of the requested
+ * redirect_uri, so exchanging against the old host fails with HTTP 400
+ * (T11958 / DHQ-075).
+ *
+ * Anthropic's token endpoint is non-RFC in two ways (mirrored from pi-ai):
+ *   - it expects an `application/json` body (`tokenBodyFormat: 'json'`), and
+ *   - it requires the authorize-time `state` echoed in the exchange body.
  *
  * The Anthropic-hosted redirect URI displays the authorization code on the
- * post-redirect page so the user can paste it back into the CLI prompt
- * (the same headless paste-back flow Hermes and Claude Code use). No local
- * HTTP listener is required.
+ * post-redirect page (`code=true` opts into that display) so the user can
+ * paste it back into the CLI prompt. No local HTTP listener is required.
  *
  * @task T9302
  * @task T9344
+ * @task T11958
  */
 const ANTHROPIC_OAUTH = {
     mode: 'pkce',
     clientId: resolveAnthropicClientId(),
     authorizationEndpoint: 'https://claude.ai/oauth/authorize',
-    tokenEndpoint: 'https://console.anthropic.com/v1/oauth/token',
+    tokenEndpoint: 'https://platform.claude.com/v1/oauth/token',
     scope: 'org:create_api_key user:profile user:inference',
-    redirectUri: 'https://console.anthropic.com/oauth/code/callback',
+    redirectUri: 'https://platform.claude.com/oauth/code/callback',
+    extraAuthParams: { code: 'true' },
+    tokenBodyFormat: 'json',
 };
 /**
  * Anthropic Claude provider profile.

package/dist/llm/provider-registry/builtin/anthropic.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../../src/llm/provider-registry/builtin/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,sCAAsC,CAAC;AAEhF;;;;;;GAMG;AACH,SAAS,wBAAwB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,IAAI,yBAAyB,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,eAAe,GAAwB;IAC3C,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,wBAAwB,EAAE;IACpC,qBAAqB,EAAE,mCAAmC;IAC1D,aAAa,EAAE,8CAA8C;IAC7D,KAAK,EAAE,gDAAgD;IACvD,WAAW,EAAE,mDAAmD;CACjE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,kBAAkB;IAC/B,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,2BAA2B;IACpC,YAAY,EAAE,2BAA2B;IACzC,OAAO,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;IACpC,2EAA2E;IAC3E,IAAI,EAAE,UAAU;IAChB,eAAe,EAAE,2BAA2B;IAC5C,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,EAAE,mBAAmB,EAAE,YAAY,EAAE;IACrD,KAAK,EAAE,eAAe;CACvB,CAAC"}
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../../src/llm/provider-registry/builtin/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,sCAAsC,CAAC;AAEhF;;;;;;GAMG;AACH,SAAS,wBAAwB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,IAAI,yBAAyB,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,eAAe,GAAwB;IAC3C,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,wBAAwB,EAAE;IACpC,qBAAqB,EAAE,mCAAmC;IAC1D,aAAa,EAAE,4CAA4C;IAC3D,KAAK,EAAE,gDAAgD;IACvD,WAAW,EAAE,iDAAiD;IAC9D,eAAe,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACjC,eAAe,EAAE,MAAM;CACxB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,kBAAkB;IAC/B,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,2BAA2B;IACpC,YAAY,EAAE,2BAA2B;IACzC,OAAO,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;IACpC,2EAA2E;IAC3E,IAAI,EAAE,UAAU;IAChB,eAAe,EAAE,2BAA2B;IAC5C,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,EAAE,mBAAmB,EAAE,YAAY,EAAE;IACrD,KAAK,EAAE,eAAe;CACvB,CAAC"}

package/dist/llm/provider-registry/builtin/ollama.d.ts

@@ -30,6 +30,24 @@ import type { ProviderProfile } from '@cleocode/contracts';
  * `authTypes: ['api_key']` is listed for compatibility with the credential
  * store API, but local Ollama deployments do not require an actual key —
  * users may leave it empty or store a token for remote/proxied deployments.
+ *
+ * ## Default model selection (DHQ-081 · T11978 · T11990)
+ *
+ * `defaultModel` is `gemma4:e4b` (standard/frontier tasks, requires ≥ 8 GB RAM).
+ * `defaultAuxModel` is `gemma4:e2b` (fast/aux tasks, requires ≥ 4 GB RAM).
+ *
+ * Tags live-verified on ollama.com/library/gemma4 2026-06-11:
+ *   - gemma4:e2b  = 7.2 GB download (Q4_K_M), edge 2B effective params
+ *   - gemma4:e4b  = 9.6 GB download (Q4_K_M), edge 4B effective params
+ *   - gemma4:12b  = 7.6 GB download (QAT), 12B params, 256k context
+ *
+ * The cross-provider selector (`cross-provider-selector.ts`) gates model selection
+ * on `os.totalmem()` and falls through to `qwen2:0.5b` only as a proof-of-life
+ * last resort when RAM is below 4 GB. These are the provider-registry SSoT
+ * constants; the selector reads them via `getProviderProfile('ollama')`.
+ *
+ * If the catalog does not yet have a `gemma4` family entry, the resolver logs a
+ * hint to run `cleo llm refresh-catalog`.
  */
 export declare const ollamaProfile: ProviderProfile;
 //# sourceMappingURL=ollama.d.ts.map

package/dist/llm/provider-registry/builtin/ollama.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../../src/llm/provider-registry/builtin/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,EAAE,eAa3B,CAAC"}
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../../src/llm/provider-registry/builtin/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,aAAa,EAAE,eAa3B,CAAC"}

package/dist/llm/provider-registry/builtin/ollama.js

@@ -32,17 +32,35 @@
  * `authTypes: ['api_key']` is listed for compatibility with the credential
  * store API, but local Ollama deployments do not require an actual key —
  * users may leave it empty or store a token for remote/proxied deployments.
+ *
+ * ## Default model selection (DHQ-081 · T11978 · T11990)
+ *
+ * `defaultModel` is `gemma4:e4b` (standard/frontier tasks, requires ≥ 8 GB RAM).
+ * `defaultAuxModel` is `gemma4:e2b` (fast/aux tasks, requires ≥ 4 GB RAM).
+ *
+ * Tags live-verified on ollama.com/library/gemma4 2026-06-11:
+ *   - gemma4:e2b  = 7.2 GB download (Q4_K_M), edge 2B effective params
+ *   - gemma4:e4b  = 9.6 GB download (Q4_K_M), edge 4B effective params
+ *   - gemma4:12b  = 7.6 GB download (QAT), 12B params, 256k context
+ *
+ * The cross-provider selector (`cross-provider-selector.ts`) gates model selection
+ * on `os.totalmem()` and falls through to `qwen2:0.5b` only as a proof-of-life
+ * last resort when RAM is below 4 GB. These are the provider-registry SSoT
+ * constants; the selector reads them via `getProviderProfile('ollama')`.
+ *
+ * If the catalog does not yet have a `gemma4` family entry, the resolver logs a
+ * hint to run `cleo llm refresh-catalog`.
  */
 export const ollamaProfile = {
     name: 'ollama',
     displayName: 'Ollama (local)',
     authTypes: ['api_key'],
     baseUrl: 'http://localhost:11434',
-    defaultModel: 'llama3',
+    defaultModel: 'gemma4:e4b',
     aliases: ['ollama-local'],
     // Hermes-parity routing/catalog fields (T11756). Local on-device tier.
     tier: 'local',
-    defaultAuxModel: 'llama3',
+    defaultAuxModel: 'gemma4:e2b',
     defaultMaxTokens: 2048,
     envVars: ['OLLAMA_API_KEY', 'OLLAMA_BASE_URL'],
     supportsThinkingBudget: false,

package/dist/llm/provider-registry/builtin/ollama.js.map

@@ -1 +1 @@
-{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../../../src/llm/provider-registry/builtin/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,gBAAgB;IAC7B,SAAS,EAAE,CAAC,SAAS,CAAC;IACtB,OAAO,EAAE,wBAAwB;IACjC,YAAY,EAAE,QAAQ;IACtB,OAAO,EAAE,CAAC,cAAc,CAAC;IACzB,uEAAuE;IACvE,IAAI,EAAE,OAAO;IACb,eAAe,EAAE,QAAQ;IACzB,gBAAgB,EAAE,IAAI;IACtB,OAAO,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC9C,sBAAsB,EAAE,KAAK;CAC9B,CAAC"}
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../../../src/llm/provider-registry/builtin/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,gBAAgB;IAC7B,SAAS,EAAE,CAAC,SAAS,CAAC;IACtB,OAAO,EAAE,wBAAwB;IACjC,YAAY,EAAE,YAAY;IAC1B,OAAO,EAAE,CAAC,cAAc,CAAC;IACzB,uEAAuE;IACvE,IAAI,EAAE,OAAO;IACb,eAAe,EAAE,YAAY;IAC7B,gBAAgB,EAAE,IAAI;IACtB,OAAO,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC9C,sBAAsB,EAAE,KAAK;CAC9B,CAAC"}

package/dist/llm/provider-registry/provider-alias.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Pure provider-alias resolution over {@link ProviderDef.aliases} (T11704).
+ *
+ * M3 Provider SSoT (epic T11667 · task T11704). {@link resolveProviderId} maps a name
+ * OR an alias to its canonical provider id, reading the {@link ProviderDef} set's
+ * `aliases` arrays as the SINGLE source — `codex`/`chatgpt` → `openai`,
+ * `claude` → `anthropic`, `google` → `gemini`, … It is the declarative replacement
+ * for the ad-hoc `_aliases` Map the in-process registry populates imperatively.
+ *
+ * ## Pure + deterministic + side-effect-free (AC2 · AC5)
+ *
+ * The resolver is a pure function of `(input, defs)`: no DB, no network, no module
+ * state. {@link buildAliasIndex} folds the provider set into an immutable
+ * `alias → id` index once; {@link resolveProviderId} is a single case-insensitive
+ * lookup. An alias that collides with ANOTHER provider's primary id is rejected at
+ * index-build time (a hard error) so a mis-declared alias can never silently
+ * mis-route. Unknown input returns `null`.
+ *
+ * @module llm/provider-registry/provider-alias
+ * @task T11704
+ * @epic T11667
+ * @see @cleocode/contracts — {@link ProviderDef} (the declarative contract, T11702)
+ * @see ./provider-defs.ts — {@link builtinProviderDefs} (the default provider set)
+ */
+import type { ProviderDef } from '@cleocode/contracts';
+/**
+ * An immutable case-insensitive `alias-or-id → canonical-id` index built from a
+ * provider set. Every provider's own id maps to itself; every alias maps to its
+ * provider's id.
+ *
+ * @task T11704
+ */
+export type ProviderAliasIndex = ReadonlyMap<string, string>;
+/**
+ * Build the immutable {@link ProviderAliasIndex} from a provider set.
+ *
+ * Every provider's lower-cased `id` maps to itself; every lower-cased alias maps to
+ * its provider's id. Pure + deterministic.
+ *
+ * @param defs - The provider definitions (defaults to {@link builtinProviderDefs}).
+ * @returns The case-insensitive alias index.
+ * @throws {Error} When an alias collides with ANOTHER provider's primary id, or two
+ *   providers declare the SAME alias (ambiguous resolution — AC2).
+ * @task T11704
+ */
+export declare function buildAliasIndex(defs?: ReadonlyArray<ProviderDef>): ProviderAliasIndex;
+/**
+ * Resolve a provider name or alias to its canonical provider id (case-insensitive).
+ *
+ * Pure + deterministic + side-effect-free. `codex`/`chatgpt` → `openai`,
+ * `claude` → `anthropic`, an exact provider id → itself. Returns `null` for an
+ * unknown name (callers handle the generic/fallback case).
+ *
+ * @param input - The provider name or alias to resolve.
+ * @param indexOrDefs - An already-built {@link ProviderAliasIndex}, OR the provider
+ *   set to build one from (defaults to {@link builtinProviderDefs}). Pass the prebuilt
+ *   index in a hot loop to avoid rebuilding per call.
+ * @returns The canonical provider id, or `null` when `input` matches no id/alias.
+ * @task T11704
+ */
+export declare function resolveProviderId(input: string, indexOrDefs?: ProviderAliasIndex | ReadonlyArray<ProviderDef>): string | null;
+//# sourceMappingURL=provider-alias.d.ts.map

package/dist/llm/provider-registry/provider-alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-alias.d.ts","sourceRoot":"","sources":["../../../src/llm/provider-registry/provider-alias.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,IAAI,GAAE,aAAa,CAAC,WAAW,CAAyB,GACvD,kBAAkB,CA8BpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,kBAAkB,GAAG,aAAa,CAAC,WAAW,CAAyB,GACnF,MAAM,GAAG,IAAI,CAMf"}

package/dist/llm/provider-registry/provider-alias.js

@@ -0,0 +1,85 @@
+/**
+ * Pure provider-alias resolution over {@link ProviderDef.aliases} (T11704).
+ *
+ * M3 Provider SSoT (epic T11667 · task T11704). {@link resolveProviderId} maps a name
+ * OR an alias to its canonical provider id, reading the {@link ProviderDef} set's
+ * `aliases` arrays as the SINGLE source — `codex`/`chatgpt` → `openai`,
+ * `claude` → `anthropic`, `google` → `gemini`, … It is the declarative replacement
+ * for the ad-hoc `_aliases` Map the in-process registry populates imperatively.
+ *
+ * ## Pure + deterministic + side-effect-free (AC2 · AC5)
+ *
+ * The resolver is a pure function of `(input, defs)`: no DB, no network, no module
+ * state. {@link buildAliasIndex} folds the provider set into an immutable
+ * `alias → id` index once; {@link resolveProviderId} is a single case-insensitive
+ * lookup. An alias that collides with ANOTHER provider's primary id is rejected at
+ * index-build time (a hard error) so a mis-declared alias can never silently
+ * mis-route. Unknown input returns `null`.
+ *
+ * @module llm/provider-registry/provider-alias
+ * @task T11704
+ * @epic T11667
+ * @see @cleocode/contracts — {@link ProviderDef} (the declarative contract, T11702)
+ * @see ./provider-defs.ts — {@link builtinProviderDefs} (the default provider set)
+ */
+import { builtinProviderDefs } from './provider-defs.js';
+/**
+ * Build the immutable {@link ProviderAliasIndex} from a provider set.
+ *
+ * Every provider's lower-cased `id` maps to itself; every lower-cased alias maps to
+ * its provider's id. Pure + deterministic.
+ *
+ * @param defs - The provider definitions (defaults to {@link builtinProviderDefs}).
+ * @returns The case-insensitive alias index.
+ * @throws {Error} When an alias collides with ANOTHER provider's primary id, or two
+ *   providers declare the SAME alias (ambiguous resolution — AC2).
+ * @task T11704
+ */
+export function buildAliasIndex(defs = builtinProviderDefs()) {
+    const ids = new Set();
+    for (const def of defs)
+        ids.add(def.id.toLowerCase());
+    const index = new Map();
+    // Primary ids first — an id always resolves to itself.
+    for (const id of ids)
+        index.set(id, id);
+    for (const def of defs) {
+        const canonical = def.id.toLowerCase();
+        for (const alias of def.aliases) {
+            const key = alias.toLowerCase();
+            // An alias that IS another provider's primary id is a hard collision.
+            if (ids.has(key) && key !== canonical) {
+                throw new Error(`[provider-alias] Alias "${alias}" for provider "${def.id}" collides with the ` +
+                    `primary id of another provider.`);
+            }
+            const existing = index.get(key);
+            if (existing !== undefined && existing !== canonical) {
+                throw new Error(`[provider-alias] Alias "${alias}" is declared by both "${existing}" and ` +
+                    `"${def.id}" — ambiguous resolution.`);
+            }
+            index.set(key, canonical);
+        }
+    }
+    return index;
+}
+/**
+ * Resolve a provider name or alias to its canonical provider id (case-insensitive).
+ *
+ * Pure + deterministic + side-effect-free. `codex`/`chatgpt` → `openai`,
+ * `claude` → `anthropic`, an exact provider id → itself. Returns `null` for an
+ * unknown name (callers handle the generic/fallback case).
+ *
+ * @param input - The provider name or alias to resolve.
+ * @param indexOrDefs - An already-built {@link ProviderAliasIndex}, OR the provider
+ *   set to build one from (defaults to {@link builtinProviderDefs}). Pass the prebuilt
+ *   index in a hot loop to avoid rebuilding per call.
+ * @returns The canonical provider id, or `null` when `input` matches no id/alias.
+ * @task T11704
+ */
+export function resolveProviderId(input, indexOrDefs = builtinProviderDefs()) {
+    // Discriminate on the Map's `get` method — an already-built ProviderAliasIndex
+    // (a ReadonlyMap) has it; a provider-set array does not (build the index from it).
+    const index = 'get' in indexOrDefs ? indexOrDefs : buildAliasIndex(indexOrDefs);
+    return index.get(input.trim().toLowerCase()) ?? null;
+}
+//# sourceMappingURL=provider-alias.js.map

package/dist/llm/provider-registry/provider-alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-alias.js","sourceRoot":"","sources":["../../../src/llm/provider-registry/provider-alias.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAWzD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAmC,mBAAmB,EAAE;IAExD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,uDAAuD;IACvD,KAAK,MAAM,EAAE,IAAI,GAAG;QAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAExC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAChC,sEAAsE;YACtE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,2BAA2B,KAAK,mBAAmB,GAAG,CAAC,EAAE,sBAAsB;oBAC7E,iCAAiC,CACpC,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CACb,2BAA2B,KAAK,0BAA0B,QAAQ,QAAQ;oBACxE,IAAI,GAAG,CAAC,EAAE,2BAA2B,CACxC,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,cAA+D,mBAAmB,EAAE;IAEpF,+EAA+E;IAC/E,mFAAmF;IACnF,MAAM,KAAK,GACT,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AACvD,CAAC"}

package/dist/llm/provider-registry/provider-defs.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Builtin {@link ProviderDef} set — the SEED SOURCE for the `providers` table.
+ *
+ * M3 Provider SSoT (epic T11667 · task T11703). The DECLARATIVE provider definitions
+ * are DERIVED from the existing runtime {@link ProviderProfile} builtins (the in-process
+ * registry SSoT) rather than re-declared — so the two never drift and there is one
+ * place to add a provider (the profile). `toProviderDef` projects a `ProviderProfile`
+ * (which bundles non-serializable hook closures) down to the serializable `ProviderDef`
+ * shape (DATA only): identity + aliases + auth + endpoint(s) + catalog key + headers +
+ * env vars + OAuth placeholder + the declarative request quirks.
+ *
+ * ## Why this lives under `provider-registry/`
+ *
+ * The builtin profiles are model-data SSoT (the LLM-chokepoint lint exempts this
+ * directory for model-id literals). This module reads their declarative DATA and
+ * never constructs a transport/client — it carries no model-id literals of its own.
+ *
+ * @module llm/provider-registry/provider-defs
+ * @task T11703
+ * @epic T11667
+ * @see @cleocode/contracts — {@link ProviderDef} (the declarative contract, T11702)
+ * @see ./index.ts — the in-process {@link ProviderProfile} registry (runtime SSoT)
+ * @see ./provider-seed.ts — the seeder that upserts these rows into `providers`
+ */
+import type { ProviderDef, ProviderProfile } from '@cleocode/contracts';
+/**
+ * Project a runtime {@link ProviderProfile} down to the serializable
+ * {@link ProviderDef} (DATA only — drops the hook closures, keeps their declarative
+ * {@link RequestQuirk} kinds). Pure + deterministic.
+ *
+ * @param profile - The runtime profile (in-process registry SSoT).
+ * @returns The declarative provider definition.
+ * @task T11703
+ */
+export declare function toProviderDef(profile: ProviderProfile): ProviderDef;
+/**
+ * The builtin {@link ProviderDef} set — DERIVED from the runtime
+ * {@link ProviderProfile} builtins. The SSoT-seed source for the `providers`
+ * table (T11703) and the input to the pure alias resolver (T11704).
+ *
+ * @returns Builtin provider definitions (one per provider id; xai collapsed to one).
+ * @task T11703
+ */
+export declare function builtinProviderDefs(): ReadonlyArray<ProviderDef>;
+//# sourceMappingURL=provider-defs.d.ts.map

package/dist/llm/provider-registry/provider-defs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-defs.d.ts","sourceRoot":"","sources":["../../../src/llm/provider-registry/provider-defs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,WAAW,EAEX,eAAe,EAIhB,MAAM,qBAAqB,CAAC;AAmG7B;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CA2BnE;AAuBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAAC,WAAW,CAAC,CAEhE"}

package/dist/llm/provider-registry/provider-defs.js

@@ -0,0 +1,145 @@
+/**
+ * Builtin {@link ProviderDef} set — the SEED SOURCE for the `providers` table.
+ *
+ * M3 Provider SSoT (epic T11667 · task T11703). The DECLARATIVE provider definitions
+ * are DERIVED from the existing runtime {@link ProviderProfile} builtins (the in-process
+ * registry SSoT) rather than re-declared — so the two never drift and there is one
+ * place to add a provider (the profile). `toProviderDef` projects a `ProviderProfile`
+ * (which bundles non-serializable hook closures) down to the serializable `ProviderDef`
+ * shape (DATA only): identity + aliases + auth + endpoint(s) + catalog key + headers +
+ * env vars + OAuth placeholder + the declarative request quirks.
+ *
+ * ## Why this lives under `provider-registry/`
+ *
+ * The builtin profiles are model-data SSoT (the LLM-chokepoint lint exempts this
+ * directory for model-id literals). This module reads their declarative DATA and
+ * never constructs a transport/client — it carries no model-id literals of its own.
+ *
+ * @module llm/provider-registry/provider-defs
+ * @task T11703
+ * @epic T11667
+ * @see @cleocode/contracts — {@link ProviderDef} (the declarative contract, T11702)
+ * @see ./index.ts — the in-process {@link ProviderProfile} registry (runtime SSoT)
+ * @see ./provider-seed.ts — the seeder that upserts these rows into `providers`
+ */
+import { anthropicProfile } from './builtin/anthropic.js';
+import { bedrockProfile } from './builtin/bedrock.js';
+import { geminiProfile } from './builtin/gemini.js';
+import { kimiCodeProfile } from './builtin/kimi-code.js';
+import { moonshotProfile } from './builtin/moonshot.js';
+import { ollamaProfile } from './builtin/ollama.js';
+import { openaiProfile } from './builtin/openai.js';
+import { openrouterProfile } from './builtin/openrouter.js';
+import { xaiProfile } from './builtin/xai.js';
+/**
+ * Per-builtin projection overlay (the non-`ProviderProfile` declarative DATA).
+ *
+ * Transport mapping mirrors `deriveApiMode` (api-mode.ts):
+ *  - `anthropic` / `kimi-code` → `anthropic-messages` (kimi speaks Anthropic wire)
+ *  - `openai` → `openai-completions` primary + `openai-responses` alt (Codex OAuth)
+ *  - `gemini` / `bedrock` / `ollama` → `aisdk` (reached via AI-SDK provider factory)
+ *  - `xai` → `openai-completions` primary + `openai-responses` alt (collapses the
+ *    prior `xaiProfile` / `xaiResponsesProfile` duplication into ONE row — AC4)
+ *  - `openrouter` / `moonshot` → `openai-completions`
+ *
+ * @task T11703
+ */
+const OVERLAYS = {
+    anthropic: { transport: 'anthropic-messages' },
+    openai: {
+        transport: 'openai-completions',
+        altTransports: [{ transport: 'openai-responses' }],
+    },
+    gemini: { transport: 'aisdk', aiSdkProvider: 'google' },
+    moonshot: { transport: 'openai-completions' },
+    'kimi-code': {
+        transport: 'anthropic-messages',
+        modelsDevId: 'moonshot',
+        quirks: ['kimi-reasoning-effort'],
+    },
+    openrouter: { transport: 'openai-completions', quirks: ['openrouter-pareto'] },
+    bedrock: { transport: 'aisdk', aiSdkProvider: 'bedrock' },
+    xai: {
+        transport: 'openai-completions',
+        altTransports: [{ transport: 'openai-responses' }],
+        quirks: ['grok-conv-id'],
+    },
+    ollama: { transport: 'aisdk', aiSdkProvider: 'openai-compatible' },
+};
+/**
+ * Build a {@link ProviderEndpoint} from a transport + base URL (+ AI-SDK key).
+ *
+ * @internal
+ */
+function makeEndpoint(transport, baseUrl, aiSdkProvider) {
+    if (transport === 'aisdk') {
+        // The aisdk variant REQUIRES an aiSdkProvider; default to the OpenAI-compatible
+        // factory when an overlay omits it (the generic compat path).
+        return { transport: 'aisdk', baseUrl, aiSdkProvider: aiSdkProvider ?? 'openai-compatible' };
+    }
+    return { transport, baseUrl };
+}
+/**
+ * Project a runtime {@link ProviderProfile} down to the serializable
+ * {@link ProviderDef} (DATA only — drops the hook closures, keeps their declarative
+ * {@link RequestQuirk} kinds). Pure + deterministic.
+ *
+ * @param profile - The runtime profile (in-process registry SSoT).
+ * @returns The declarative provider definition.
+ * @task T11703
+ */
+export function toProviderDef(profile) {
+    const overlay = OVERLAYS[profile.name.toLowerCase()];
+    const transport = overlay?.transport ?? 'openai-completions';
+    const endpoint = makeEndpoint(transport, profile.baseUrl, overlay?.aiSdkProvider);
+    const altEndpoints = (overlay?.altTransports ?? []).map((alt) => makeEndpoint(alt.transport, alt.baseUrl ?? profile.baseUrl, alt.aiSdkProvider));
+    const requestQuirks = (overlay?.quirks ?? []).map((kind) => ({ kind }));
+    const def = {
+        id: profile.name,
+        displayName: profile.displayName,
+        aliases: [...(profile.aliases ?? [])],
+        authMethods: [...profile.authTypes],
+        endpoint,
+        ...(altEndpoints.length > 0 ? { altEndpoints } : {}),
+        modelsDevId: overlay?.modelsDevId ?? profile.name,
+        ...(profile.defaultHeaders !== undefined
+            ? { defaultHeaders: { ...profile.defaultHeaders } }
+            : {}),
+        ...(profile.envVars !== undefined ? { envVars: [...profile.envVars] } : {}),
+        ...(profile.oauth !== undefined ? { oauth: profile.oauth } : {}),
+        ...(requestQuirks.length > 0 ? { requestQuirks } : {}),
+    };
+    return def;
+}
+/**
+ * Runtime profiles that seed the builtin {@link ProviderDef} set.
+ *
+ * The `xai` Responses profile (`xaiResponsesProfile`) is intentionally OMITTED — its
+ * Responses endpoint is folded into the single `xai` row's `altEndpoints` (AC4). The
+ * dual-ApiMode duplication collapses to one declarative row per provider id.
+ *
+ * @task T11703
+ */
+const SEED_PROFILES = [
+    anthropicProfile,
+    openaiProfile,
+    geminiProfile,
+    moonshotProfile,
+    kimiCodeProfile,
+    openrouterProfile,
+    bedrockProfile,
+    xaiProfile,
+    ollamaProfile,
+];
+/**
+ * The builtin {@link ProviderDef} set — DERIVED from the runtime
+ * {@link ProviderProfile} builtins. The SSoT-seed source for the `providers`
+ * table (T11703) and the input to the pure alias resolver (T11704).
+ *
+ * @returns Builtin provider definitions (one per provider id; xai collapsed to one).
+ * @task T11703
+ */
+export function builtinProviderDefs() {
+    return SEED_PROFILES.map(toProviderDef);
+}
+//# sourceMappingURL=provider-defs.js.map

package/dist/llm/provider-registry/provider-defs.js.map

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

package/dist/llm/provider-registry/provider-seed.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Provider seeder — populates the `providers` table from the builtin ProviderDef set.
+ *
+ * M3 Provider SSoT (epic T11667 · task T11703). {@link seedProviders} takes the builtin
+ * {@link ProviderDef} set (derived from the runtime {@link ProviderProfile} builtins by
+ * {@link builtinProviderDefs}), serializes each declarative field to its TEXT column,
+ * and UPSERTS each row via {@link openDualScopeDb}`('global')`. Seeding is the offline
+ * bootstrap of the provider SSoT — NO network is touched.
+ *
+ * ## Idempotent (AC5) + does NOT clobber user plugin providers
+ *
+ * The upsert targets the `id` primary key, so re-running yields the same row count and
+ * never duplicates (running twice = same rows). Only BUILTIN ids are touched — a user
+ * plugin provider row (a different id) is never read or written, so a re-seed cannot
+ * clobber it. `source` is stamped `seed` for these rows; plugin rows carry their own
+ * `source`.
+ *
+ * @module llm/provider-registry/provider-seed
+ * @task T11703
+ * @epic T11667
+ * @see ./provider-defs.ts — the builtin ProviderDef set (seed source)
+ * @see ../../store/schema/cleo-global/providers.ts — the persisted table
+ * @see ../catalog-seeder.ts — the sibling seeder this mirrors
+ */
+import type { ProviderDef } from '@cleocode/contracts';
+import { type CleoGlobalDb } from '../../store/dual-scope-db.js';
+import { type NewProviderRow } from '../../store/schema/cleo-global/providers.js';
+/** Result of a {@link seedProviders} run. */
+export interface SeedProvidersResult {
+    /** Whether rows were written this run. */
+    readonly seeded: boolean;
+    /** Number of builtin provider rows upserted. */
+    readonly rowCount: number;
+}
+/** Injectable seam for {@link seedProviders} (tests pass a temp-DB handle + defs). */
+export interface SeedProvidersDeps {
+    /**
+     * An already-open global Drizzle handle. When omitted the seeder opens via
+     * {@link openDualScopeDb}`('global')`. Tests pass a temp-DB handle (opened via
+     * {@link openProviderSeederAtPath}) to stay off `.cleo/*.db`.
+     */
+    readonly db?: CleoGlobalDb;
+    /**
+     * The provider definitions to seed, bypassing {@link builtinProviderDefs} (tests
+     * pass a fixture). When omitted the builtin set is used.
+     */
+    readonly defs?: ReadonlyArray<ProviderDef>;
+}
+/**
+ * Open the global seeder handle at an EXPLICIT path (test seam).
+ *
+ * @param dbPath - Absolute path to the temp `cleo.db`.
+ * @task T11703
+ */
+export declare function openProviderSeederAtPath(dbPath: string): Promise<CleoGlobalDb>;
+/**
+ * Serialize one {@link ProviderDef} into a `providers` INSERT row. JSON columns are
+ * `JSON.stringify`-serialized; `oauth` is NULL when the provider has no OAuth flow.
+ *
+ * @param def - The declarative provider definition.
+ * @returns The flattened `providers` row.
+ * @task T11703
+ */
+export declare function providerDefToRow(def: ProviderDef): NewProviderRow;
+/**
+ * Seed the `providers` table from the builtin {@link ProviderDef} set — idempotent,
+ * offline-first, plugin-safe.
+ *
+ * Upserts on the `id` primary key, so running twice yields the same row count and
+ * never duplicates (AC5). Only builtin ids are written; user plugin provider rows
+ * (other ids) are never touched. NO network is touched.
+ *
+ * @param deps - Optional injected DB handle / fixture defs (tests).
+ * @returns A {@link SeedProvidersResult} describing what happened.
+ * @task T11703
+ */
+export declare function seedProviders(deps?: SeedProvidersDeps): Promise<SeedProvidersResult>;
+//# sourceMappingURL=provider-seed.d.ts.map

package/dist/llm/provider-registry/provider-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-seed.d.ts","sourceRoot":"","sources":["../../../src/llm/provider-registry/provider-seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,KAAK,cAAc,EAAa,MAAM,6CAA6C,CAAC;AAK7F,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CAC5C;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAGpF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,CAejE;AASD;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA8B1F"}