@amalgm/chat 0.1.0

package/dist/contract/freeze.js

@@ -0,0 +1,151 @@
+/**
+ * The freeze algebra — engine `chat-core/contract.js:347-458` plus
+ * `chat-core/auth.js:66-68` (`fingerprint`), ported byte-exact.
+ *
+ * A session's runtime identity is the sha256 fingerprint of
+ * `frozenRuntimeFields`; the field ORDER inside that object is load-bearing
+ * (it is JSON.stringify'd) and must never change. Hashing is injected via
+ * `Sha256HexPort` (engine default: `node:crypto` sha256 hex digest).
+ */
+/**
+ * Engine `auth.js fingerprint()`: first 16 hex chars of sha256, or null for
+ * falsy input. Non-strings are coerced with `String()` exactly as the engine.
+ */
+export function fingerprint(value, sha256Hex) {
+    return value ? sha256Hex(String(value)).slice(0, 16) : null;
+}
+function normalizeMcpHeader(header, sha256Hex) {
+    return {
+        name: String(header?.name || '').toLowerCase(),
+        valueFingerprint: fingerprint(header?.value || '', sha256Hex),
+    };
+}
+function normalizeMcpServer(server, sha256Hex) {
+    return {
+        name: String(server?.name || ''),
+        type: String(server?.type || 'http'),
+        url: String(server?.url || ''),
+        headers: Array.isArray(server?.headers)
+            ? server.headers
+                .map((header) => normalizeMcpHeader(header, sha256Hex))
+                .sort((a, b) => a.name.localeCompare(b.name))
+            : [],
+    };
+}
+/**
+ * Engine `frozenRuntimeFields` (`contract.js:365-394`). Field order in the
+ * returned object is byte-exact — `runtimeKey` stringifies it.
+ */
+export function frozenRuntimeFields(input, ports) {
+    const { sha256Hex } = ports;
+    const authIdentity = input.authMethod === 'amalgm'
+        ? 'platform_proxy'
+        : input.auth?.tokenFingerprint || null;
+    const mcpServers = (Array.isArray(input.mcpServers) ? input.mcpServers : [])
+        .map((server) => normalizeMcpServer(server, sha256Hex))
+        .sort((a, b) => `${a.name}\0${a.type}\0${a.url}`.localeCompare(`${b.name}\0${b.type}\0${b.url}`));
+    return {
+        sessionId: input.sessionId,
+        userId: input.userId,
+        computerId: input.computerId,
+        harness: input.harness,
+        authMethod: input.authMethod,
+        auth: authIdentity,
+        modelId: input.modelId,
+        usageModelId: input.usageModelId,
+        cliModel: input.cliModel,
+        reasoningEffort: input.reasoningEffort || null,
+        fastMode: input.fastMode === true,
+        contextWindow: input.contextWindow ?? null,
+        maxTokens: input.maxTokens ?? null,
+        cwd: input.cwd,
+        runtimeHomeLayout: input.runtimeHomeLayout,
+        systemPrompt: fingerprint(input.systemPrompt || '', sha256Hex),
+        compiledAgentInstructions: fingerprint(input.compiledAgentInstructions || '', sha256Hex),
+        agentConfig: fingerprint(JSON.stringify(input.agentConfig || null), sha256Hex),
+        origin: fingerprint(JSON.stringify(input.origin || null), sha256Hex),
+        mcpServers: fingerprint(JSON.stringify(mcpServers), sha256Hex),
+    };
+}
+/** Engine `runtimeKey` (`contract.js:396-398`): fingerprint of the frozen fields. */
+export function runtimeKey(input, ports) {
+    return fingerprint(JSON.stringify(frozenRuntimeFields(input, ports)), ports.sha256Hex);
+}
+/**
+ * Engine `changedRuntimeFields` (`contract.js:405-410`): the frozen-field keys
+ * whose values differ between two contracts. Prefers precomputed
+ * `runtimeFields`; falls back to recomputing (hence the ports).
+ */
+export function changedRuntimeFields(current, next, ports) {
+    const currentFields = current?.runtimeFields || frozenRuntimeFields(current || {}, ports);
+    const nextFields = next?.runtimeFields || frozenRuntimeFields(next || {}, ports);
+    const keys = [...new Set([...Object.keys(currentFields), ...Object.keys(nextFields)])];
+    return keys.filter((key) => currentFields[key] !== nextFields[key]);
+}
+/**
+ * Engine `frozenContractChangedError` (`contract.js:412-421`). Message and
+ * `code` are byte-exact.
+ */
+export function frozenContractChangedError(current, next, ports) {
+    const changed = changedRuntimeFields(current, next, ports);
+    const label = changed.length ? ` (${changed.join(', ')})` : '';
+    const err = new Error(`Frozen session contract changed${label}; start a new session for auth/harness/computer/instruction/MCP changes`);
+    err.code = 'FROZEN_SESSION_CONTRACT_CHANGED';
+    err.changedFields = changed;
+    return err;
+}
+/**
+ * Engine `continueFrozenRuntimeContract` (`contract.js:423-458`): when the
+ * next turn's contract drifts, keep the frozen identity from the current
+ * contract, carry over per-turn fields from `next`, and record the drifted
+ * keys in `continuedFromChangedContract` (warn semantics — the turn proceeds).
+ */
+export function continueFrozenRuntimeContract(current, next, ports) {
+    if (!current)
+        return next;
+    const changed = changedRuntimeFields(current, next, ports);
+    if (changed.length === 0)
+        return next;
+    return {
+        ...next,
+        userId: current.userId,
+        computerId: current.computerId,
+        agentId: current.agentId,
+        agentConfigId: current.agentConfigId,
+        agentConfig: current.agentConfig,
+        runtimeHomeLayout: current.runtimeHomeLayout,
+        harness: current.harness,
+        authMethod: current.authMethod,
+        modelId: current.modelId,
+        usageModelId: current.usageModelId,
+        cliModel: current.cliModel,
+        reasoningEffort: current.reasoningEffort,
+        fastMode: current.fastMode,
+        contextWindow: current.contextWindow,
+        maxTokens: current.maxTokens,
+        cwd: current.cwd,
+        origin: current.origin,
+        constructs: current.constructs,
+        localBaseUrl: current.localBaseUrl,
+        mcpServers: current.mcpServers,
+        systemPrompt: current.systemPrompt,
+        compiledAgentInstructions: current.compiledAgentInstructions,
+        usageOwner: current.usageOwner,
+        auth: current.auth,
+        runtimeFields: current.runtimeFields,
+        runtimeKey: current.runtimeKey,
+        continuedFromChangedContract: changed,
+    };
+}
+/**
+ * Engine `assertSameContract` (`contract.js:650-655`): hard rejection when
+ * the runtime key moved. Throws `frozenContractChangedError`.
+ */
+export function assertSameContract(current, next, ports) {
+    if (!current)
+        return;
+    if (current.runtimeKey !== next.runtimeKey) {
+        throw frozenContractChangedError(current, next, ports);
+    }
+}
+//# sourceMappingURL=freeze.js.map

package/dist/contract/freeze.js.map

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

package/dist/contract/harnesses.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Harness identity — engine `chat-core/contract.js:12-22` (agentToHarness)
+ * and the hard allowlist enforced by `createContract` (`contract.js:575-577`),
+ * ported byte-exact.
+ */
+/** The only harnesses the clean chat core accepts. Order as in the engine. */
+export declare const SUPPORTED_HARNESSES: readonly ["claude_code", "codex", "opencode", "cursor", "pi"];
+export type Harness = (typeof SUPPORTED_HARNESSES)[number];
+/**
+ * Engine `agentToHarness`: map a UI agent id onto a harness id. Unknown
+ * non-empty values pass through unchanged (the allowlist check happens in
+ * `assertSupportedHarness` / `createContract`); empty input defaults to
+ * `'claude_code'`.
+ */
+export declare function agentToHarness(agent: unknown): string;
+/**
+ * The allowlist gate from `createContract` (`contract.js:575-577`).
+ * Throw message is byte-exact with the engine.
+ */
+export declare function assertSupportedHarness(harness: string): asserts harness is Harness;
+//# sourceMappingURL=harnesses.d.ts.map

package/dist/contract/harnesses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harnesses.d.ts","sourceRoot":"","sources":["../../src/contract/harnesses.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,+DAAgE,CAAC;AAEjG,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASrD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAIlF"}

package/dist/contract/harnesses.js

@@ -0,0 +1,39 @@
+/**
+ * Harness identity — engine `chat-core/contract.js:12-22` (agentToHarness)
+ * and the hard allowlist enforced by `createContract` (`contract.js:575-577`),
+ * ported byte-exact.
+ */
+/** The only harnesses the clean chat core accepts. Order as in the engine. */
+export const SUPPORTED_HARNESSES = ['claude_code', 'codex', 'opencode', 'cursor', 'pi'];
+/**
+ * Engine `agentToHarness`: map a UI agent id onto a harness id. Unknown
+ * non-empty values pass through unchanged (the allowlist check happens in
+ * `assertSupportedHarness` / `createContract`); empty input defaults to
+ * `'claude_code'`.
+ */
+export function agentToHarness(agent) {
+    const clean = String(agent || '').trim();
+    if (clean === 'claude')
+        return 'claude_code';
+    if (clean === 'codex')
+        return 'codex';
+    if (clean === 'opencode')
+        return 'opencode';
+    if (clean === 'cursor')
+        return 'cursor';
+    if (clean === 'pi')
+        return 'pi';
+    if (clean === 'claude_code')
+        return 'claude_code';
+    return clean || 'claude_code';
+}
+/**
+ * The allowlist gate from `createContract` (`contract.js:575-577`).
+ * Throw message is byte-exact with the engine.
+ */
+export function assertSupportedHarness(harness) {
+    if (!SUPPORTED_HARNESSES.includes(harness)) {
+        throw new Error(`Unsupported harness for clean chat core: ${harness}`);
+    }
+}
+//# sourceMappingURL=harnesses.js.map

package/dist/contract/harnesses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harnesses.js","sourceRoot":"","sources":["../../src/contract/harnesses.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAU,CAAC;AAIjG;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC;IAC7C,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACtC,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC5C,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IAClD,OAAO,KAAK,IAAI,aAAa,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,IAAI,CAAE,mBAAyC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,4CAA4C,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/contract/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @amalgm/chat contract — the frozen session contract.
+ *
+ * Sources of truth (engine working tree, ported byte-exact):
+ *  - `runtime/scripts/chat-core/contract.js`  → harnesses / models / freeze / create
+ *  - `runtime/lib/chatInput.js`               → chat-input
+ *  - `runtime/scripts/chat-core/chat-payload.js:33-185` → payload-merge
+ *  - `runtime/scripts/chat-core/input.js`     → input
+ */
+export * from './harnesses.js';
+export * from './models.js';
+export * from './freeze.js';
+export * from './create.js';
+export * from './chat-input.js';
+export * from './payload-merge.js';
+export * from './input.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/contract/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/dist/contract/index.js

@@ -0,0 +1,17 @@
+/**
+ * @amalgm/chat contract — the frozen session contract.
+ *
+ * Sources of truth (engine working tree, ported byte-exact):
+ *  - `runtime/scripts/chat-core/contract.js`  → harnesses / models / freeze / create
+ *  - `runtime/lib/chatInput.js`               → chat-input
+ *  - `runtime/scripts/chat-core/chat-payload.js:33-185` → payload-merge
+ *  - `runtime/scripts/chat-core/input.js`     → input
+ */
+export * from './harnesses.js';
+export * from './models.js';
+export * from './freeze.js';
+export * from './create.js';
+export * from './chat-input.js';
+export * from './payload-merge.js';
+export * from './input.js';
+//# sourceMappingURL=index.js.map

package/dist/contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/dist/contract/input.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Turn input normalization — engine `chat-core/input.js`, ported byte-exact.
+ *
+ * Two effects are severed into injected ports:
+ *  - `env` on the normalized input (engine: `process.env`)
+ *  - the lazy `require('../amalgm-mcp/project-context/prompt')` in
+ *    `promptText`/`openCodeParts` becomes an optional injected provider.
+ */
+export interface NormalizedInput {
+    text: string;
+    parts: unknown[];
+    files: unknown[];
+    systemPrompt: string;
+    env: Record<string, string | undefined>;
+}
+export interface NormalizeInputPorts {
+    /** Engine default: `process.env`. SDK default: `{}`. */
+    env?: Record<string, string | undefined> | undefined;
+}
+/** Engine `normalizeInput(payload)` (`input.js:10-25`). */
+export declare function normalizeInput(payload: Record<string, any>, ports?: NormalizeInputPorts): NormalizedInput;
+export interface PromptTextPorts {
+    /**
+     * Engine: `amalgm-mcp/project-context/prompt.js projectContextTurnUpdateBlock`
+     * — the per-turn project-context update block (empty in the common case).
+     * Omitted ⇒ no context update, exactly like an engine host without the
+     * module.
+     */
+    projectContextTurnUpdate?(contract: unknown): string | null | undefined;
+    /**
+     * Called with the first line of the provider's error message when it
+     * throws. Engine default:
+     * `console.warn('[chat-core] project context turn update failed:', message)`.
+     */
+    onProjectContextError?(message: string): void;
+}
+/** Engine `promptText(input, contract)` (`input.js:41-50`). */
+export declare function promptText(input: NormalizedInput, contract: unknown, ports?: PromptTextPorts): string;
+/** Engine `openCodeParts(input, contract)` (`input.js:52-62`). */
+export declare function openCodeParts(input: NormalizedInput, contract: unknown, ports?: PromptTextPorts): Array<{
+    type: string;
+    text?: string;
+    path?: string;
+}>;
+//# sourceMappingURL=input.d.ts.map

package/dist/contract/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/contract/input.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACtD;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,GAAE,mBAAwB,GAAG,eAAe,CAe7G;AAED,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,wBAAwB,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxE;;;;OAIG;IACH,qBAAqB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAiBD,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,GAAE,eAAoB,GAAG,MAAM,CASzG;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,OAAO,EACjB,KAAK,GAAE,eAAoB,GAC1B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAUvD"}

package/dist/contract/input.js

@@ -0,0 +1,78 @@
+/**
+ * Turn input normalization — engine `chat-core/input.js`, ported byte-exact.
+ *
+ * Two effects are severed into injected ports:
+ *  - `env` on the normalized input (engine: `process.env`)
+ *  - the lazy `require('../amalgm-mcp/project-context/prompt')` in
+ *    `promptText`/`openCodeParts` becomes an optional injected provider.
+ */
+function textFromPart(part) {
+    if (!part || typeof part !== 'object')
+        return '';
+    if (part.type === 'text' && typeof part.text === 'string')
+        return part.text;
+    if (typeof part.content === 'string')
+        return part.content;
+    return '';
+}
+/** Engine `normalizeInput(payload)` (`input.js:10-25`). */
+export function normalizeInput(payload, ports = {}) {
+    const chatInput = payload.chatInput && typeof payload.chatInput === 'object' ? payload.chatInput : null;
+    const parts = Array.isArray(payload.userParts) && payload.userParts.length > 0
+        ? payload.userParts
+        : Array.isArray(chatInput?.parts) && chatInput.parts.length > 0
+            ? chatInput.parts
+            : [{ type: 'text', text: payload.prompt || '' }];
+    const text = String(payload.prompt || parts.map(textFromPart).filter(Boolean).join('\n') || '').trim();
+    return {
+        text,
+        parts,
+        files: Array.isArray(chatInput?.files) ? chatInput.files : [],
+        systemPrompt: payload.systemPrompt || chatInput?.agent?.systemPrompt || '',
+        env: ports.env ?? {},
+    };
+}
+// Resumed provider threads cannot change their system prompt without busting
+// the provider's prompt cache, so context freshness rides on the turn instead:
+// when the project context revision moved since this session last saw it, the
+// turn gets a compact update block prepended. Empty in the common case.
+function projectContextTurnUpdate(contract, ports) {
+    if (!ports.projectContextTurnUpdate)
+        return '';
+    try {
+        return ports.projectContextTurnUpdate(contract) || '';
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message.split('\n')[0] : String(error);
+        ports.onProjectContextError?.(message);
+        return '';
+    }
+}
+/** Engine `promptText(input, contract)` (`input.js:41-50`). */
+export function promptText(input, contract, ports = {}) {
+    const chunks = [];
+    const contextUpdate = projectContextTurnUpdate(contract, ports);
+    if (contextUpdate)
+        chunks.push(contextUpdate);
+    if (input.files?.length) {
+        chunks.push(`<files>\n${input.files.map((file) => JSON.stringify(file)).join('\n')}\n</files>`);
+    }
+    chunks.push(input.text || '');
+    return chunks.filter(Boolean).join('\n\n');
+}
+/** Engine `openCodeParts(input, contract)` (`input.js:52-62`). */
+export function openCodeParts(input, contract, ports = {}) {
+    const text = input.text || input.parts.map(textFromPart).filter(Boolean).join('\n');
+    const out = [];
+    const contextUpdate = projectContextTurnUpdate(contract, ports);
+    if (contextUpdate)
+        out.push({ type: 'text', text: contextUpdate });
+    if (text)
+        out.push({ type: 'text', text });
+    for (const file of (input.files || [])) {
+        if (file?.path)
+            out.push({ type: 'file', path: file.path });
+    }
+    return out.length ? out : [{ type: 'text', text: '' }];
+}
+//# sourceMappingURL=input.js.map

package/dist/contract/input.js.map

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

package/dist/contract/models.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Model identity tables — engine `chat-core/contract.js:23-345`, ported
+ * byte-exact. A model has four identities:
+ *
+ *  - display id     — what the UI sent (`payload.modelId`)
+ *  - canonical id   — `canonicalModel()`: the billing identity
+ *                     (`contract.modelId` / `usageModelId`)
+ *  - runtime-CLI id — `cliModelFor()`: what the harness CLI is launched with
+ *                     (`contract.cliModel`)
+ *  - context profile — derived downstream from the canonical id
+ *
+ * The alias tables below are the frozen law: every row's spelling, order, and
+ * precedence must match the engine exactly, because `runtimeKey` fingerprints
+ * their outputs.
+ */
+export declare const GATEWAY_PROVIDERS: readonly ["prime-intellect", "arcee-ai", "alibaba", "amazon", "anthropic", "bytedance", "cohere", "cursor", "deepseek", "google", "inception", "kwaipilot", "meituan", "meta", "minimax", "mistral", "moonshotai", "morph", "nvidia", "openai", "perplexity", "xiaomi", "xai", "zai"];
+export declare function gatewayModelId(raw: unknown): string;
+export declare const CURSOR_CLI_ALIASES: Readonly<Record<string, string>>;
+export declare const CURSOR_CANONICAL_MODEL_ALIASES: Readonly<Record<string, string>>;
+export declare function cursorCliAlias(cliModel: string): string;
+export declare function cursorAnthropicCliModel(model: string): string;
+export declare function cursorCliModelFor(raw: unknown): string;
+/**
+ * Claude Code display-id -> canonical billing-id alias table
+ * (`contract.js:171-240`). Keys are matched after `vercel/` strip +
+ * lowercase.
+ */
+export declare const CLAUDE_CODE_MODEL_ALIASES: Readonly<Record<string, string>>;
+/**
+ * `canonicalModel(modelId, harness)` — engine `contract.js:164-258`.
+ * Throw message ("modelId is required for <harness>") is byte-exact.
+ */
+export declare function canonicalModel(modelId: unknown, harness: string): string;
+/**
+ * Claude Code canonical/display -> CLI launch alias table
+ * (`contract.js:264-284`). Looked up first by canonical id, then by the
+ * lowercased raw input, else the raw input passes through.
+ */
+export declare const CLAUDE_CODE_CLI_ALIASES: Readonly<Record<string, string>>;
+/**
+ * OpenCode gateway providers (`contract.js:312-334`). NOTE: intentionally a
+ * different list from `GATEWAY_PROVIDERS` — the engine's opencode branch omits
+ * 'moonshotai', 'morph', and 'nvidia'. Byte-parity requires keeping both.
+ */
+export declare const OPENCODE_GATEWAY_PROVIDERS: readonly ["prime-intellect", "arcee-ai", "alibaba", "amazon", "anthropic", "bytedance", "cohere", "cursor", "deepseek", "google", "inception", "kwaipilot", "meituan", "meta", "minimax", "mistral", "openai", "perplexity", "xiaomi", "xai", "zai"];
+export interface CliModelForArgs {
+    harness: string;
+    modelId?: unknown;
+    cliModel?: unknown;
+    reasoningEffort?: unknown;
+}
+/**
+ * `cliModelFor({ harness, modelId, cliModel, reasoningEffort })` — engine
+ * `contract.js:260-345`: the runtime-CLI identity for a model.
+ */
+export declare function cliModelFor({ harness, modelId, cliModel, reasoningEffort }: CliModelForArgs): string;
+//# sourceMappingURL=models.d.ts.map

package/dist/contract/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/contract/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,eAAO,MAAM,iBAAiB,uRAyBpB,CAAC;AAGX,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQnD;AAED,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuB/D,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwB3E,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA0B7D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAgBtD;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqEtE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBxE;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,sPAsB7B,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,eAAe,GAAG,MAAM,CAyCpG"}