@amalgm/chat 0.1.0

package/dist/contract/create.d.ts

@@ -0,0 +1,191 @@
+/**
+ * `createContract` — engine `chat-core/contract.js:460-648`, ported as a pure
+ * orchestration. Effectful collaborators are injected:
+ *
+ *  - `authEnvelope`        — engine `chat-core/auth.js authEnvelope` (reads the
+ *                            BYOK credential store + provider auth files)
+ *  - `normalizeAgentConfig`— engine `amalgm-mcp/agent-config/schema.js`
+ *                            (uses crypto.randomUUID for stable ids)
+ *  - `cwd` ports           — the filesystem checks behind `resolveCwd`
+ *                            (engine: fs.statSync / os.homedir / path,
+ *                            `runtime/scripts/lib/project-paths.js`)
+ *  - `sha256Hex`           — the runtimeKey fingerprint (engine: node:crypto)
+ *
+ * Env-derived engine defaults become documented options:
+ *
+ *  - `options.defaultCwd`  — engine `DEFAULT_CWD` = `AMALGM_DEFAULT_CWD` || '/workspace'
+ *  - `options.port`        — engine `runtimePort('chat-server')` (runtime-manifest)
+ *  - `options.proxyToken`  — engine config `PROXY_TOKEN`
+ *  - `options.proxyBaseUrl`— engine `PROXY_BASE_URL || DEFAULT_PROXY_BASE_URL`
+ *  - `options.amalgmDir`   — engine config `AMALGM_DIR`
+ *  - `options.containerId` — engine `process.env.AMALGM_CONTAINER_ID`
+ */
+import type { FreezePorts, FrozenRuntimeFields } from './freeze.js';
+/** Engine `AUTH_BY_HARNESS` (`auth.js:9-15`): supported methods, first = default. */
+export declare const AUTH_BY_HARNESS: Readonly<Record<string, readonly string[]>>;
+/**
+ * Engine `coerceAuth` (`auth.js:70-73`): clamp a requested auth method to the
+ * harness's supported set, defaulting to the first supported method.
+ */
+export declare function coerceAuth(harness: string, requested: unknown): string;
+/** The envelope returned by the host's `authEnvelope` (engine `auth.js:148-200`). */
+export interface AuthEnvelope {
+    method: string;
+    baseUrl?: string | null;
+    credentialId?: string | null;
+    credentialName?: string | null;
+    providerKind?: string | null;
+    forwardBaseUrl?: string | null;
+    tokenRef?: string | null;
+    tokenFingerprint?: string | null;
+    runtimeHome?: string | null;
+    runtimeHomeSources?: string[];
+    [key: string]: unknown;
+}
+/** The exact argument object the engine passes to `authEnvelope`. */
+export interface AuthEnvelopeArgs {
+    harness: string;
+    authMethod: string;
+    sessionId: string;
+    localBaseUrl: string;
+    proxyToken: string | undefined;
+    proxyBaseUrl: string | undefined;
+    amalgmDir: string | undefined;
+    userId: string;
+    credentialId: string | null;
+    modelId: string;
+    agentConfigId: string;
+    runtimeHomeLayout: string;
+}
+/**
+ * Filesystem/OS ports behind `resolveCwd`. Engine defaults:
+ *  - `expandHome`          — `contract.js:460-467` (os.homedir + path.join)
+ *  - `canonicalProjectPath`— `runtime/scripts/lib/project-paths.js`
+ *  - `isDirectory`         — `fs.statSync(p).isDirectory()` (throwing is fine;
+ *                            it is treated as "not a directory")
+ *  - `processCwd`          — `process.cwd()` (throwing is fine)
+ *  - `homedir`             — `os.homedir()`
+ *  - `isAbsolute` / `resolvePath` — `path.isAbsolute` / `path.resolve`
+ */
+export interface CwdPorts {
+    expandHome(value: unknown): string;
+    canonicalProjectPath(value: string): string;
+    isDirectory(candidate: string): boolean;
+    processCwd(): string | null;
+    homedir(): string;
+    isAbsolute(candidate: string): boolean;
+    resolvePath(from: string, to: string): string;
+}
+export interface WorkspaceCwdUnavailableError extends Error {
+    code: 'workspace_cwd_unavailable';
+    status: 409;
+}
+/**
+ * The 409 thrown when a cloud-workspace turn cannot resolve its folder —
+ * engine `contract.js:493-497,503-507`. Message, `code`, and `status` are
+ * byte-exact.
+ */
+export declare function workspaceCwdUnavailableError(): WorkspaceCwdUnavailableError;
+export interface ResolveCwdOptions {
+    /** Fallback project cwd (engine `options.cwd`). */
+    cwd?: string | undefined;
+    /** Engine `DEFAULT_CWD` = `AMALGM_DEFAULT_CWD` || '/workspace'. */
+    defaultCwd?: string | undefined;
+    /** True when the payload carries `cloudWorkspaceRef` — 409 instead of fallback. */
+    requireCwd?: boolean | undefined;
+}
+/**
+ * Engine `resolveCwd` (`contract.js:486-510`), decision logic verbatim.
+ * With `requireCwd`, an empty or non-existent cwd throws
+ * `workspace_cwd_unavailable` (409) instead of falling back.
+ */
+export declare function resolveCwd(rawCwd: unknown, options: ResolveCwdOptions, ports: CwdPorts): string;
+export interface ContractOrigin {
+    type: string;
+    id: string;
+    name: string | null;
+    projectPath: string | null;
+}
+/** Engine `normalizeOrigin` (`contract.js:516-533`) — pure, ported fully. */
+export declare function normalizeOrigin(payload?: Record<string, any>): ContractOrigin | null;
+export interface ContractConstruct {
+    type: string;
+    id: string | null;
+    name: string | null;
+    projectPath: string | null;
+    path: string | null;
+}
+/** Engine `normalizeConstructs` (`contract.js:552-567`) — pure, ported fully. */
+export declare function normalizeConstructs(payload?: Record<string, any>, cwd?: string | null): Array<ContractConstruct | ContractOrigin>;
+/** Engine `positiveOrNull` (`contract.js:400-403`). */
+export declare function positiveOrNull(value: unknown): number | null;
+export interface CreateContractPorts extends FreezePorts {
+    /** Engine `chat-core/auth.js authEnvelope` — host auth, BYOK store, provider files. */
+    authEnvelope(args: AuthEnvelopeArgs): AuthEnvelope;
+    /** Engine `amalgm-mcp/agent-config/schema.js normalizeAgentConfig`. */
+    normalizeAgentConfig(input: unknown): unknown;
+    /** Filesystem/OS ports for `resolveCwd`. */
+    cwd: CwdPorts;
+    /** Optional override; defaults to the pure `coerceAuth` above (engine `auth.js`). */
+    coerceAuth?(harness: string, requested: unknown): string;
+}
+export interface CreateContractOptions {
+    /** Fallback project cwd fed to `resolveCwd` (engine `options.cwd`). */
+    cwd?: string | undefined;
+    /** Engine `DEFAULT_CWD` = env `AMALGM_DEFAULT_CWD` || '/workspace'. */
+    defaultCwd?: string | undefined;
+    /** Full local base URL; wins over `port` (engine `options.localBaseUrl`). */
+    localBaseUrl?: string | undefined;
+    /** Chat-server port. Engine default: `runtimePort('chat-server')` (runtime-manifest). */
+    port?: number | undefined;
+    /** Engine config `PROXY_TOKEN` (proxy-token-store). */
+    proxyToken?: string | undefined;
+    /** Engine `PROXY_BASE_URL || DEFAULT_PROXY_BASE_URL` (chat-server/config). */
+    proxyBaseUrl?: string | undefined;
+    /** Engine config `AMALGM_DIR`. */
+    amalgmDir?: string | undefined;
+    /** Fallback user id (engine `options.userId`). */
+    userId?: string | undefined;
+    /** Engine `process.env.AMALGM_CONTAINER_ID` — computerId fallback. */
+    containerId?: string | undefined;
+}
+export interface ChatContract {
+    sessionId: string;
+    userId: string;
+    computerId: string;
+    assistantMessageId: string;
+    userMessageId: string | null;
+    agentId: string;
+    agentConfigId: string;
+    agentConfig: unknown;
+    runtimeHomeLayout: string;
+    harness: string;
+    authMethod: string;
+    modelId: string;
+    usageModelId: string;
+    providerSessionId: string | null;
+    cliModel: string;
+    reasoningEffort: string | null;
+    fastMode: boolean;
+    contextWindow: number | null;
+    maxTokens: number | null;
+    cwd: string;
+    origin: ContractOrigin | null;
+    constructs: Array<ContractConstruct | ContractOrigin>;
+    localBaseUrl: string;
+    mcpServers: unknown[];
+    systemPrompt: string;
+    compiledAgentInstructions: string;
+    usageOwner: 'platform_proxy' | 'local_user';
+    auth: AuthEnvelope;
+    runtimeFields: FrozenRuntimeFields;
+    runtimeKey: string | null;
+}
+/**
+ * Engine `createContract` (`contract.js:569-648`). Field-for-field parity,
+ * including every error message and precedence chain. The uncommitted
+ * cloud-workspace behavior is preserved: `payload.cloudWorkspaceRef` makes
+ * cwd resolution mandatory (`workspace_cwd_unavailable`, 409).
+ */
+export declare function createContract(payload: Record<string, any>, options: CreateContractOptions, ports: CreateContractPorts): ChatContract;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/contract/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIpE,qFAAqF;AACrF,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAMvE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAGtE;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAID;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACnC,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC,UAAU,IAAI,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,IAAI,MAAM,CAAC;IAClB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,4BAA6B,SAAQ,KAAK;IACzD,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE,GAAG,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,4BAA4B,CAK3E;AAmBD,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,mFAAmF;IACnF,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAkB/F;AAQD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,cAAc,GAAG,IAAI,CAiBxF;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAmBD,iFAAiF;AACjF,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EACjC,GAAG,GAAE,MAAM,GAAG,IAAW,GACxB,KAAK,CAAC,iBAAiB,GAAG,cAAc,CAAC,CAe3C;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG5D;AAID,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,uFAAuF;IACvF,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAAC;IACnD,uEAAuE;IACvE,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9C,4CAA4C;IAC5C,GAAG,EAAE,QAAQ,CAAC;IACd,qFAAqF;IACrF,UAAU,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,KAAK,CAAC,iBAAiB,GAAG,cAAc,CAAC,CAAC;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB,EAAE,MAAM,CAAC;IAClC,UAAU,EAAE,gBAAgB,GAAG,YAAY,CAAC;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,mBAAmB,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,mBAAmB,GACzB,YAAY,CAqFd"}

package/dist/contract/create.js

@@ -0,0 +1,249 @@
+/**
+ * `createContract` — engine `chat-core/contract.js:460-648`, ported as a pure
+ * orchestration. Effectful collaborators are injected:
+ *
+ *  - `authEnvelope`        — engine `chat-core/auth.js authEnvelope` (reads the
+ *                            BYOK credential store + provider auth files)
+ *  - `normalizeAgentConfig`— engine `amalgm-mcp/agent-config/schema.js`
+ *                            (uses crypto.randomUUID for stable ids)
+ *  - `cwd` ports           — the filesystem checks behind `resolveCwd`
+ *                            (engine: fs.statSync / os.homedir / path,
+ *                            `runtime/scripts/lib/project-paths.js`)
+ *  - `sha256Hex`           — the runtimeKey fingerprint (engine: node:crypto)
+ *
+ * Env-derived engine defaults become documented options:
+ *
+ *  - `options.defaultCwd`  — engine `DEFAULT_CWD` = `AMALGM_DEFAULT_CWD` || '/workspace'
+ *  - `options.port`        — engine `runtimePort('chat-server')` (runtime-manifest)
+ *  - `options.proxyToken`  — engine config `PROXY_TOKEN`
+ *  - `options.proxyBaseUrl`— engine `PROXY_BASE_URL || DEFAULT_PROXY_BASE_URL`
+ *  - `options.amalgmDir`   — engine config `AMALGM_DIR`
+ *  - `options.containerId` — engine `process.env.AMALGM_CONTAINER_ID`
+ */
+import { agentToHarness, assertSupportedHarness } from './harnesses.js';
+import { canonicalModel, cliModelFor } from './models.js';
+import { frozenRuntimeFields, runtimeKey } from './freeze.js';
+// ── Host auth surface (engine chat-core/auth.js) ────────────────────────────
+/** Engine `AUTH_BY_HARNESS` (`auth.js:9-15`): supported methods, first = default. */
+export const AUTH_BY_HARNESS = {
+    claude_code: ['amalgm', 'byok', 'provider_auth'],
+    codex: ['amalgm', 'byok', 'provider_auth'],
+    opencode: ['amalgm', 'byok', 'provider_auth'],
+    cursor: ['provider_auth'],
+    pi: ['amalgm', 'byok', 'provider_auth'],
+};
+/**
+ * Engine `coerceAuth` (`auth.js:70-73`): clamp a requested auth method to the
+ * harness's supported set, defaulting to the first supported method.
+ */
+export function coerceAuth(harness, requested) {
+    const supported = AUTH_BY_HARNESS[harness] || ['amalgm'];
+    return requested && supported.includes(requested) ? requested : supported[0];
+}
+/**
+ * The 409 thrown when a cloud-workspace turn cannot resolve its folder —
+ * engine `contract.js:493-497,503-507`. Message, `code`, and `status` are
+ * byte-exact.
+ */
+export function workspaceCwdUnavailableError() {
+    return Object.assign(new Error('Cloud workspace folder is unavailable.'), { code: 'workspace_cwd_unavailable', status: 409 });
+}
+function existingDirectory(candidate, ports) {
+    if (!candidate)
+        return null;
+    try {
+        return ports.isDirectory(candidate) ? candidate : null;
+    }
+    catch {
+        return null;
+    }
+}
+function safeProcessCwd(ports) {
+    try {
+        return ports.processCwd();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Engine `resolveCwd` (`contract.js:486-510`), decision logic verbatim.
+ * With `requireCwd`, an empty or non-existent cwd throws
+ * `workspace_cwd_unavailable` (409) instead of falling back.
+ */
+export function resolveCwd(rawCwd, options, ports) {
+    const fallback = existingDirectory(ports.canonicalProjectPath(ports.expandHome(options.cwd)), ports)
+        || existingDirectory(ports.canonicalProjectPath(ports.expandHome(options.defaultCwd ?? '/workspace')), ports)
+        || existingDirectory(safeProcessCwd(ports), ports)
+        || ports.homedir();
+    const expanded = ports.expandHome(rawCwd);
+    if (!expanded) {
+        if (options.requireCwd) {
+            throw workspaceCwdUnavailableError();
+        }
+        return fallback;
+    }
+    const absolute = ports.isAbsolute(expanded) ? expanded : ports.resolvePath(fallback, expanded);
+    const resolved = existingDirectory(ports.canonicalProjectPath(absolute), ports);
+    if (!resolved && options.requireCwd) {
+        throw workspaceCwdUnavailableError();
+    }
+    return resolved || fallback;
+}
+// ── Pure payload normalizers (engine contract.js:512-567) ───────────────────
+function nullableString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+/** Engine `normalizeOrigin` (`contract.js:516-533`) — pure, ported fully. */
+export function normalizeOrigin(payload = {}) {
+    const raw = payload.origin && typeof payload.origin === 'object' ? payload.origin : {};
+    const type = nullableString(raw.type || payload.originType || payload.origin);
+    const id = nullableString(raw.id
+        || raw.originId
+        || payload.originId
+        || payload.taskId
+        || payload.triggerId);
+    if (!type || !id)
+        return null;
+    return {
+        type,
+        id,
+        name: nullableString(raw.name || raw.originName || payload.originName),
+        projectPath: nullableString(raw.projectPath || payload.projectPath || payload.cwd),
+    };
+}
+function normalizeConstruct(input, fallback = {}) {
+    if (!input || typeof input !== 'object')
+        return null;
+    const type = nullableString(input.type || input.scopeType);
+    if (!type)
+        return null;
+    const id = nullableString(input.id || input.scopeId || input.originId);
+    const projectPath = nullableString(input.projectPath || input.path || fallback.projectPath);
+    const item = {
+        type,
+        id,
+        name: nullableString(input.name || input.originName),
+        projectPath,
+        path: nullableString(input.path),
+    };
+    if (!item.id && !item.projectPath && !item.path)
+        return null;
+    return item;
+}
+/** Engine `normalizeConstructs` (`contract.js:552-567`) — pure, ported fully. */
+export function normalizeConstructs(payload = {}, cwd = null) {
+    const constructs = [];
+    for (const item of Array.isArray(payload.constructs) ? payload.constructs : []) {
+        const normalized = normalizeConstruct(item, { projectPath: cwd });
+        if (normalized)
+            constructs.push(normalized);
+    }
+    const origin = normalizeOrigin(payload);
+    if (origin)
+        constructs.push(origin);
+    const seen = new Set();
+    return constructs.filter((item) => {
+        const key = `${item.type}:${item.id || item.projectPath || item.path || ''}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/** Engine `positiveOrNull` (`contract.js:400-403`). */
+export function positiveOrNull(value) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+}
+/**
+ * Engine `createContract` (`contract.js:569-648`). Field-for-field parity,
+ * including every error message and precedence chain. The uncommitted
+ * cloud-workspace behavior is preserved: `payload.cloudWorkspaceRef` makes
+ * cwd resolution mandatory (`workspace_cwd_unavailable`, 409).
+ */
+export function createContract(payload, options, ports) {
+    const sessionId = payload.codeSessionId || payload.sessionId;
+    if (!sessionId)
+        throw new Error('codeSessionId is required');
+    const assistantMessageId = payload.assistantMessageId;
+    if (!assistantMessageId)
+        throw new Error('assistantMessageId is required');
+    const harness = agentToHarness(payload.harness || payload.agentId || payload.agent);
+    assertSupportedHarness(harness);
+    const coerce = ports.coerceAuth || coerceAuth;
+    const authMethod = coerce(harness, payload.authMethod || 'amalgm');
+    const modelId = canonicalModel(payload.modelId || payload.cliModel, harness);
+    const reasoningEffort = payload.reasoningEffort || null;
+    const fastMode = payload.fastMode === true;
+    const cliModel = cliModelFor({ harness, modelId, cliModel: payload.cliModel, reasoningEffort });
+    const cwd = resolveCwd(payload.cwd, {
+        cwd: options.cwd,
+        defaultCwd: options.defaultCwd,
+        requireCwd: Boolean(payload.cloudWorkspaceRef),
+    }, ports.cwd);
+    if (!options.localBaseUrl && options.port == null) {
+        throw new Error("createContract requires options.localBaseUrl or options.port (engine default: runtimePort('chat-server'))");
+    }
+    const localBaseUrl = options.localBaseUrl || `http://127.0.0.1:${options.port}`;
+    const origin = normalizeOrigin({ ...payload, cwd });
+    const userId = payload.userId || options.userId || 'unknown-user';
+    const payloadChatAgent = payload.chatInput && typeof payload.chatInput === 'object' && !Array.isArray(payload.chatInput)
+        ? payload.chatInput.agent
+        : null;
+    const agentConfigId = nullableString(payload.agentConfigId
+        || payload.amalgmAgentId
+        || payload.agentConfig?.agentId
+        || payloadChatAgent?.customAgentId) || harness;
+    const agentConfig = ports.normalizeAgentConfig(payload.agentConfig || { agentId: agentConfigId });
+    const runtimeHomeLayout = 'per-agent';
+    const auth = ports.authEnvelope({
+        harness,
+        authMethod,
+        sessionId,
+        localBaseUrl,
+        proxyToken: options.proxyToken,
+        proxyBaseUrl: options.proxyBaseUrl,
+        amalgmDir: options.amalgmDir,
+        userId,
+        credentialId: payload.credentialId || payload.byokCredentialId || null,
+        modelId,
+        agentConfigId,
+        runtimeHomeLayout,
+    });
+    const contract = {
+        sessionId,
+        userId,
+        computerId: payload.computerId || options.containerId || 'local-computer',
+        assistantMessageId,
+        userMessageId: payload.userMessageId || null,
+        agentId: payload.agentId || (harness === 'claude_code' ? 'claude' : harness),
+        agentConfigId,
+        agentConfig,
+        runtimeHomeLayout,
+        harness,
+        authMethod: auth.method,
+        modelId,
+        usageModelId: modelId,
+        providerSessionId: nullableString(payload.providerSessionId || payload.provider_session_id),
+        cliModel,
+        reasoningEffort,
+        fastMode,
+        contextWindow: positiveOrNull(payload.contextWindow),
+        maxTokens: positiveOrNull(payload.maxTokens),
+        cwd,
+        origin,
+        constructs: normalizeConstructs({ ...payload, origin }, cwd),
+        localBaseUrl,
+        mcpServers: Array.isArray(payload.mcpServers) ? payload.mcpServers : [],
+        systemPrompt: payload.systemPrompt || '',
+        compiledAgentInstructions: payload.compiledAgentInstructions || '',
+        usageOwner: (auth.method === 'amalgm' ? 'platform_proxy' : 'local_user'),
+        auth,
+    };
+    const withIdentity = contract;
+    withIdentity.runtimeFields = frozenRuntimeFields(contract, ports);
+    withIdentity.runtimeKey = runtimeKey(contract, ports);
+    return withIdentity;
+}
+//# sourceMappingURL=create.js.map

package/dist/contract/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/contract/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9D,+EAA+E;AAE/E,qFAAqF;AACrF,MAAM,CAAC,MAAM,eAAe,GAAgD;IAC1E,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC;IAChD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC;IAC1C,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC;IAC7C,MAAM,EAAE,CAAC,eAAe,CAAC;IACzB,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC;CACxC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,SAAkB;IAC5D,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,OAAO,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAmB,CAAC,CAAC,CAAC,CAAE,SAAoB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC;AACtG,CAAC;AA4DD;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,MAAM,CAAC,MAAM,CAClB,IAAI,KAAK,CAAC,wCAAwC,CAAC,EACnD,EAAE,IAAI,EAAE,2BAA2B,EAAE,MAAM,EAAE,GAAG,EAAW,CAC5B,CAAC;AACpC,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAoC,EAAE,KAAe;IAC9E,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAe;IACrC,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,OAA0B,EAAE,KAAe;IACrF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;WAC/F,iBAAiB,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,IAAI,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC;WAC1G,iBAAiB,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;WAC/C,KAAK,CAAC,OAAO,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,4BAA4B,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/F,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;IAChF,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,4BAA4B,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,QAAQ,IAAI,QAAQ,CAAC;AAC9B,CAAC;AAED,+EAA+E;AAE/E,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzE,CAAC;AASD,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,UAA+B,EAAE;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,MAAM,EAAE,GAAG,cAAc,CACvB,GAAG,CAAC,EAAE;WACH,GAAG,CAAC,QAAQ;WACZ,OAAO,CAAC,QAAQ;WAChB,OAAO,CAAC,MAAM;WACd,OAAO,CAAC,SAAS,CACrB,CAAC;IACF,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO;QACL,IAAI;QACJ,EAAE;QACF,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;QACtE,WAAW,EAAE,cAAc,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;KACnF,CAAC;AACJ,CAAC;AAUD,SAAS,kBAAkB,CAAC,KAAU,EAAE,WAA4C,EAAE;IACpF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,EAAE;QACF,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC;QACpD,WAAW;QACX,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC;KACjC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CACjC,UAA+B,EAAE,EACjC,MAAqB,IAAI;IAEzB,MAAM,UAAU,GAA8C,EAAE,CAAC;IACjE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/E,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QAClE,IAAI,UAAU;YAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,MAAM;QAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,IAAS,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QAC7E,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAqED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA4B,EAC5B,OAA8B,EAC9B,KAA0B;IAE1B,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;IAC7D,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC7D,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IACtD,IAAI,CAAC,kBAAkB;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IACpF,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,UAAU,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7E,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;IAChG,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE;QAClC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;KAC/C,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACd,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,2GAA2G,CAC5G,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,oBAAoB,OAAO,CAAC,IAAI,EAAE,CAAC;IAChF,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAClE,MAAM,gBAAgB,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;QACtH,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK;QACzB,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,aAAa,GAAG,cAAc,CAClC,OAAO,CAAC,aAAa;WAClB,OAAO,CAAC,aAAa;WACrB,OAAO,CAAC,WAAW,EAAE,OAAO;WAC5B,gBAAgB,EAAE,aAAa,CACnC,IAAI,OAAO,CAAC;IACb,MAAM,WAAW,GAAG,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAClG,MAAM,iBAAiB,GAAG,WAAW,CAAC;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC;QAC9B,OAAO;QACP,UAAU;QACV,SAAS;QACT,YAAY;QACZ,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM;QACN,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,gBAAgB,IAAI,IAAI;QACtE,OAAO;QACP,aAAa;QACb,iBAAiB;KAClB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG;QACf,SAAS;QACT,MAAM;QACN,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW,IAAI,gBAAgB;QACzE,kBAAkB;QAClB,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC5C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5E,aAAa;QACb,WAAW;QACX,iBAAiB;QACjB,OAAO;QACP,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,OAAO;QACP,YAAY,EAAE,OAAO;QACrB,iBAAiB,EAAE,cAAc,CAAC,OAAO,CAAC,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC;QAC3F,QAAQ;QACR,eAAe;QACf,QAAQ;QACR,aAAa,EAAE,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC;QACpD,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC;QAC5C,GAAG;QACH,MAAM;QACN,UAAU,EAAE,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC;QAC5D,YAAY;QACZ,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;QACvE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,yBAAyB,EAAE,OAAO,CAAC,yBAAyB,IAAI,EAAE;QAClE,UAAU,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAoC;QAC3G,IAAI;KACL,CAAC;IACF,MAAM,YAAY,GAAG,QAAwB,CAAC;IAC9C,YAAY,CAAC,aAAa,GAAG,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClE,YAAY,CAAC,UAAU,GAAG,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/contract/freeze.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 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).
+ */
+import type { Sha256HexPort } from '../ports.js';
+export interface FreezePorts {
+    /** Lowercase hex SHA-256 of a UTF-8 string (engine: node:crypto). */
+    sha256Hex: Sha256HexPort;
+}
+/**
+ * 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 declare function fingerprint(value: unknown, sha256Hex: Sha256HexPort): string | null;
+/**
+ * Loose contract shape: the freeze algebra reads these fields but must accept
+ * any object (parity with the untyped engine).
+ */
+export interface ContractLike {
+    [key: string]: unknown;
+    runtimeFields?: Record<string, unknown> | undefined;
+    runtimeKey?: string | null | undefined;
+}
+export interface FrozenRuntimeFields {
+    sessionId: unknown;
+    userId: unknown;
+    computerId: unknown;
+    harness: unknown;
+    authMethod: unknown;
+    auth: unknown;
+    modelId: unknown;
+    usageModelId: unknown;
+    cliModel: unknown;
+    reasoningEffort: unknown;
+    fastMode: boolean;
+    contextWindow: unknown;
+    maxTokens: unknown;
+    cwd: unknown;
+    runtimeHomeLayout: unknown;
+    systemPrompt: string | null;
+    compiledAgentInstructions: string | null;
+    agentConfig: string | null;
+    origin: string | null;
+    mcpServers: string | null;
+}
+/**
+ * Engine `frozenRuntimeFields` (`contract.js:365-394`). Field order in the
+ * returned object is byte-exact — `runtimeKey` stringifies it.
+ */
+export declare function frozenRuntimeFields(input: any, ports: FreezePorts): FrozenRuntimeFields;
+/** Engine `runtimeKey` (`contract.js:396-398`): fingerprint of the frozen fields. */
+export declare function runtimeKey(input: any, ports: FreezePorts): string | null;
+/**
+ * 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 declare function changedRuntimeFields(current: any, next: any, ports: FreezePorts): string[];
+export interface FrozenContractChangedError extends Error {
+    code: 'FROZEN_SESSION_CONTRACT_CHANGED';
+    changedFields: string[];
+}
+/**
+ * Engine `frozenContractChangedError` (`contract.js:412-421`). Message and
+ * `code` are byte-exact.
+ */
+export declare function frozenContractChangedError(current: any, next: any, ports: FreezePorts): FrozenContractChangedError;
+/**
+ * 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 declare function continueFrozenRuntimeContract<T extends ContractLike>(current: any, next: T, ports: FreezePorts): T;
+/**
+ * Engine `assertSameContract` (`contract.js:650-655`): hard rejection when
+ * the runtime key moved. Throws `frozenContractChangedError`.
+ */
+export declare function assertSameContract(current: any, next: any, ports: FreezePorts): void;
+//# sourceMappingURL=freeze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"freeze.d.ts","sourceRoot":"","sources":["../../src/contract/freeze.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAEnF;AAkCD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,GAAG,mBAAmB,CA+BvF;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAExE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,CAO1F;AAED,MAAM,WAAW,0BAA2B,SAAQ,KAAK;IACvD,IAAI,EAAE,iCAAiC,CAAC;IACxC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,GAAG,0BAA0B,CASlH;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,YAAY,EAClE,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,WAAW,GACjB,CAAC,CAmCH;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAKpF"}