@gkorepanov/ccodex 0.3.0

package/compatibility.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "productVersion": "0.3.0",
+  "node": ">=22.13 <27",
+  "codexCli": "0.144.4",
+  "codexGitRevision": "632c07017ed17f00ca6d911b754683dee785af69",
+  "claudeAgentSdk": "0.3.209",
+  "claudeCode": "2.1.209",
+  "protocolFixture": "codex-0.144.4",
+  "relayPackages": {
+    "darwin-arm64": "@gkorepanov/ccodex-relay-darwin-arm64",
+    "darwin-x64": "@gkorepanov/ccodex-relay-darwin-x64",
+    "linux-arm64-gnu": "@gkorepanov/ccodex-relay-linux-arm64-gnu",
+    "linux-x64-gnu": "@gkorepanov/ccodex-relay-linux-x64-gnu"
+  }
+}

package/config.example.toml

@@ -0,0 +1,20 @@
+# Absolute path to the real stock Codex binary. Never point this at codex-hybrid.
+real_codex = "/usr/local/bin/codex-real"
+claude_binary = "/home/user/.local/bin/claude"
+data_dir = "/home/user/.codex-hybrid"
+
+idle_timeout_seconds = 900
+model_cache_seconds = 300
+log_level = "info"
+log_prompts = false
+debug_capture = false
+debug_log_max_bytes = 1048576
+
+# Always-on boundary recorder for Codex App RPC requests, responses and notifications.
+# Two rolling segments share this total budget; secret-valued keys remain redacted.
+rpc_capture = true
+rpc_capture_include_content = true
+rpc_capture_max_bytes = 1073741824
+
+# No aliases are configured by default. Every `gpt-*` model id stays stock.
+# Current Codex Mobile selects Claude through namespaced `claude:*` catalog ids.

package/dist/claude/asyncQueue.d.ts

@@ -0,0 +1,8 @@
+export declare class AsyncQueue<T> implements AsyncIterable<T> {
+    private readonly values;
+    private readonly waiters;
+    private closed;
+    push(value: T): void;
+    close(): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}

package/dist/claude/asyncQueue.js

@@ -0,0 +1,32 @@
+export class AsyncQueue {
+    values = [];
+    waiters = [];
+    closed = false;
+    push(value) {
+        if (this.closed)
+            throw new Error("Queue is closed.");
+        const waiter = this.waiters.shift();
+        if (waiter)
+            waiter({ value, done: false });
+        else
+            this.values.push(value);
+    }
+    close() {
+        this.closed = true;
+        for (const waiter of this.waiters.splice(0))
+            waiter({ value: undefined, done: true });
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                const value = this.values.shift();
+                if (value !== undefined)
+                    return Promise.resolve({ value, done: false });
+                if (this.closed)
+                    return Promise.resolve({ value: undefined, done: true });
+                return new Promise((resolve) => this.waiters.push(resolve));
+            },
+        };
+    }
+}
+//# sourceMappingURL=asyncQueue.js.map

package/dist/claude/asyncQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncQueue.js","sourceRoot":"","sources":["../../src/claude/asyncQueue.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAU;IACJ,MAAM,GAAQ,EAAE,CAAC;IACjB,OAAO,GAA+C,EAAE,CAAC;IAClE,MAAM,GAAG,KAAK,CAAC;IAEhB,IAAI,CAAC,KAAQ;QAClB,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,MAAM;YAAE,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;;YACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxF,CAAC;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,GAAG,EAAE;gBACT,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClC,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACxE,IAAI,IAAI,CAAC,MAAM;oBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1E,OAAO,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACjF,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/claude/fileSnapshots.d.ts

@@ -0,0 +1,7 @@
+import type { FileUpdateChange } from "../codex/generated/v2/FileUpdateChange.js";
+export interface FileSnapshot {
+    readonly path: string;
+    readonly content: string | null;
+}
+export declare function snapshotFile(toolName: string, input: Record<string, unknown>, cwd: string): Promise<FileSnapshot | undefined>;
+export declare function diffFile(snapshot: FileSnapshot): Promise<FileUpdateChange | undefined>;

package/dist/claude/fileSnapshots.js

@@ -0,0 +1,44 @@
+import { readFile } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+import { createTwoFilesPatch } from "diff";
+function inputPath(toolName, input) {
+    const key = toolName === "NotebookEdit" ? "notebook_path" : "file_path";
+    const value = input[key] ?? input.path;
+    return typeof value === "string" && value ? value : undefined;
+}
+async function readText(path) {
+    try {
+        return new TextDecoder("utf-8", { fatal: true }).decode(await readFile(path));
+    }
+    catch (error) {
+        if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
+            return null;
+        return undefined;
+    }
+}
+export async function snapshotFile(toolName, input, cwd) {
+    const candidate = inputPath(toolName, input);
+    if (!candidate)
+        return undefined;
+    const path = isAbsolute(candidate) ? candidate : resolve(cwd, candidate);
+    const content = await readText(path);
+    return content === undefined ? undefined : { path, content };
+}
+export async function diffFile(snapshot) {
+    const content = await readText(snapshot.path);
+    if (content === undefined || content === snapshot.content)
+        return undefined;
+    const kind = snapshot.content === null
+        ? { type: "add" }
+        : content === null
+            ? { type: "delete" }
+            : { type: "update", move_path: null };
+    const beforePath = snapshot.content === null ? "/dev/null" : snapshot.path;
+    const afterPath = content === null ? "/dev/null" : snapshot.path;
+    return {
+        path: snapshot.path,
+        kind,
+        diff: createTwoFilesPatch(beforePath, afterPath, snapshot.content ?? "", content ?? "", "", ""),
+    };
+}
+//# sourceMappingURL=fileSnapshots.js.map

package/dist/claude/fileSnapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSnapshots.js","sourceRoot":"","sources":["../../src/claude/fileSnapshots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAQ3C,SAAS,SAAS,CAAC,QAAgB,EAAE,KAA8B;IACjE,MAAM,GAAG,GAAG,QAAQ,KAAK,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClG,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,KAA8B,EAC9B,GAAW;IAEX,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAsB;IACnD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC5E,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,KAAK,IAAI;QACpC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE;QAC1B,CAAC,CAAC,OAAO,KAAK,IAAI;YAChB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE;YAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3E,MAAM,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IACjE,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,IAAI;QACJ,IAAI,EAAE,mBAAmB,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,OAAO,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;KAChG,CAAC;AACJ,CAAC"}

package/dist/claude/hookMapper.d.ts

@@ -0,0 +1,36 @@
+import type { SDKHookProgressMessage, SDKHookResponseMessage, SDKHookStartedMessage } from "@anthropic-ai/claude-agent-sdk";
+declare const eventNames: {
+    readonly PreToolUse: "preToolUse";
+    readonly PermissionRequest: "permissionRequest";
+    readonly PostToolUse: "postToolUse";
+    readonly PreCompact: "preCompact";
+    readonly PostCompact: "postCompact";
+    readonly SessionStart: "sessionStart";
+    readonly UserPromptSubmit: "userPromptSubmit";
+    readonly SubagentStart: "subagentStart";
+    readonly SubagentStop: "subagentStop";
+    readonly Stop: "stop";
+};
+export interface ClaudeHookRun {
+    readonly id: string;
+    readonly eventName: (typeof eventNames)[keyof typeof eventNames];
+    readonly handlerType: "command";
+    readonly executionMode: "sync";
+    readonly scope: "thread" | "turn";
+    readonly sourcePath: string;
+    readonly source: "unknown";
+    readonly displayOrder: number;
+    status: "running" | "completed" | "failed" | "stopped";
+    statusMessage: string | null;
+    readonly startedAt: number;
+    completedAt: number | null;
+    durationMs: number | null;
+    entries: Array<{
+        kind: "feedback" | "error";
+        text: string;
+    }>;
+}
+export declare function startHookRun(message: SDKHookStartedMessage, cwd: string, activeTurn: boolean, displayOrder: number): ClaudeHookRun | undefined;
+export declare function appendHookProgress(run: ClaudeHookRun, message: SDKHookProgressMessage): void;
+export declare function completeHookRun(run: ClaudeHookRun, message: SDKHookResponseMessage): ClaudeHookRun;
+export {};

package/dist/claude/hookMapper.js

@@ -0,0 +1,54 @@
+import { isAbsolute, resolve } from "node:path";
+const eventNames = {
+    PreToolUse: "preToolUse",
+    PermissionRequest: "permissionRequest",
+    PostToolUse: "postToolUse",
+    PreCompact: "preCompact",
+    PostCompact: "postCompact",
+    SessionStart: "sessionStart",
+    UserPromptSubmit: "userPromptSubmit",
+    SubagentStart: "subagentStart",
+    SubagentStop: "subagentStop",
+    Stop: "stop",
+};
+export function startHookRun(message, cwd, activeTurn, displayOrder) {
+    const eventName = eventNames[message.hook_event];
+    if (!eventName)
+        return undefined;
+    return {
+        id: message.hook_id,
+        eventName,
+        handlerType: "command",
+        executionMode: "sync",
+        scope: activeTurn ? "turn" : "thread",
+        sourcePath: isAbsolute(message.hook_name) ? message.hook_name : resolve(cwd, message.hook_name),
+        source: "unknown",
+        displayOrder,
+        status: "running",
+        statusMessage: message.hook_name,
+        startedAt: Date.now(),
+        completedAt: null,
+        durationMs: null,
+        entries: [],
+    };
+}
+function appendOutput(run, message) {
+    const output = [message.output, message.stdout].filter(Boolean).join("\n");
+    if (output)
+        run.entries.push({ kind: "feedback", text: output });
+    if (message.stderr)
+        run.entries.push({ kind: "error", text: message.stderr });
+}
+export function appendHookProgress(run, message) {
+    appendOutput(run, message);
+}
+export function completeHookRun(run, message) {
+    appendOutput(run, message);
+    const completedAt = Date.now();
+    run.status = message.outcome === "success" ? "completed" : message.outcome === "cancelled" ? "stopped" : "failed";
+    run.statusMessage = message.exit_code === undefined ? message.outcome : `${message.outcome} (exit ${message.exit_code})`;
+    run.completedAt = completedAt;
+    run.durationMs = completedAt - run.startedAt;
+    return run;
+}
+//# sourceMappingURL=hookMapper.js.map

package/dist/claude/hookMapper.js.map

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

package/dist/claude/inputMapper.d.ts

@@ -0,0 +1,8 @@
+import type { SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";
+import type { UserInput } from "../codex/generated/v2/UserInput.js";
+interface InputContext {
+    readonly cwd: string;
+    readonly sandboxPolicy: unknown;
+}
+export declare function mapUserInput(input: readonly UserInput[], uuid?: string, context?: InputContext): Promise<SDKUserMessage>;
+export {};

package/dist/claude/inputMapper.js

@@ -0,0 +1,68 @@
+import { readFile, realpath } from "node:fs/promises";
+import { extname, isAbsolute, relative, resolve } from "node:path";
+import { invalidParams } from "../protocol/errors.js";
+const mediaTypes = {
+    ".gif": "image/gif",
+    ".jpeg": "image/jpeg",
+    ".jpg": "image/jpeg",
+    ".png": "image/png",
+    ".webp": "image/webp",
+};
+async function allowedImagePath(path, context) {
+    const candidate = await realpath(isAbsolute(path) ? path : resolve(context.cwd, path));
+    const sandbox = context.sandboxPolicy && typeof context.sandboxPolicy === "object" && "type" in context.sandboxPolicy
+        ? context.sandboxPolicy
+        : undefined;
+    if (sandbox?.type === "dangerFullAccess")
+        return candidate;
+    const roots = [context.cwd, ...(Array.isArray(sandbox?.writableRoots) ? sandbox.writableRoots.filter((root) => typeof root === "string") : [])];
+    for (const root of roots) {
+        const canonicalRoot = await realpath(root).catch(() => undefined);
+        if (!canonicalRoot)
+            continue;
+        const child = relative(canonicalRoot, candidate);
+        if (child === "" || (!child.startsWith("..") && !isAbsolute(child)))
+            return candidate;
+    }
+    throw invalidParams(`Claude local image '${path}' is outside the thread's readable workspace.`);
+}
+export async function mapUserInput(input, uuid, context) {
+    const content = [];
+    for (const item of input) {
+        if (item.type === "text")
+            content.push({ type: "text", text: item.text });
+        else if (item.type === "mention") {
+            content.push({ type: "text", text: `@${item.name} (${item.path})` });
+        }
+        else if (item.type === "skill") {
+            throw invalidParams("Codex skills are not available in Claude threads.");
+        }
+        else if (item.type === "image") {
+            const url = new URL(item.url);
+            if (url.protocol !== "https:" && url.protocol !== "http:")
+                throw invalidParams(`Unsupported Claude image URL scheme '${url.protocol}'.`);
+            content.push({ type: "image", source: { type: "url", url: item.url } });
+        }
+        else {
+            if (!context)
+                throw invalidParams("Local Claude images require a thread path policy.");
+            const path = await allowedImagePath(item.path, context);
+            const mediaType = mediaTypes[extname(path).toLocaleLowerCase()];
+            if (!mediaType)
+                throw invalidParams(`Unsupported Claude image type for '${item.path}'.`);
+            const bytes = await readFile(path);
+            content.push({
+                type: "image",
+                source: { type: "base64", media_type: mediaType, data: bytes.toString("base64") },
+            });
+        }
+    }
+    return {
+        type: "user",
+        session_id: "",
+        parent_tool_use_id: null,
+        ...(uuid ? { uuid } : {}),
+        message: { role: "user", content },
+    };
+}
+//# sourceMappingURL=inputMapper.js.map

package/dist/claude/inputMapper.js.map

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

package/dist/claude/interactions.d.ts

@@ -0,0 +1,23 @@
+import type { SubscriptionHub } from "../gateway/subscriptions.js";
+import type { HybridStore } from "../store/HybridStore.js";
+import { MetricsRegistry } from "../observability/metrics.js";
+export interface InteractionRequest {
+    readonly threadId: string;
+    readonly turnId: string | null;
+    readonly claudeRequestId: string | null;
+    readonly method: string;
+    readonly params: unknown;
+    readonly signal?: AbortSignal;
+}
+export declare class InteractionBridge {
+    private readonly store;
+    private readonly hub;
+    private readonly metrics;
+    private readonly waiters;
+    constructor(store: HybridStore, hub: SubscriptionHub, metrics?: MetricsRegistry);
+    open(request: InteractionRequest): Promise<unknown>;
+    resolve(requestId: string, response: unknown): boolean;
+    replay(threadId: string): void;
+    cancelThread(threadId: string): void;
+    private cancel;
+}

package/dist/claude/interactions.js

@@ -0,0 +1,77 @@
+import { v7 as uuidv7 } from "uuid";
+import { MetricsRegistry } from "../observability/metrics.js";
+export class InteractionBridge {
+    store;
+    hub;
+    metrics;
+    waiters = new Map();
+    constructor(store, hub, metrics = new MetricsRegistry()) {
+        this.store = store;
+        this.hub = hub;
+        this.metrics = metrics;
+    }
+    open(request) {
+        const existing = request.claudeRequestId
+            ? this.store.findPendingRequestByClaudeId(request.threadId, request.claudeRequestId)
+            : undefined;
+        if (existing && existing.status !== "pending")
+            return Promise.resolve(existing.response);
+        const record = existing ?? {
+            requestId: `hyb-claude-request:${uuidv7()}`,
+            threadId: request.threadId,
+            turnId: request.turnId,
+            claudeRequestId: request.claudeRequestId,
+            method: request.method,
+            params: request.params,
+            status: "pending",
+            response: null,
+            createdAt: Date.now(),
+            resolvedAt: null,
+        };
+        if (!existing)
+            this.store.createPendingRequest(record);
+        this.metrics.pendingOpened(record.requestId, record.createdAt);
+        const active = this.waiters.get(record.requestId);
+        if (active)
+            return active.promise;
+        let resolve;
+        const promise = new Promise((done) => { resolve = done; });
+        this.waiters.set(record.requestId, { promise, resolve });
+        this.hub.request(record.threadId, record.requestId, record.method, record.params);
+        request.signal?.addEventListener("abort", () => this.cancel(record.requestId), { once: true });
+        return promise;
+    }
+    resolve(requestId, response) {
+        const record = this.store.getPendingRequest(requestId);
+        if (!record || record.status !== "pending")
+            return false;
+        this.store.resolvePendingRequest(requestId, "resolved", response);
+        this.metrics.pendingClosed(requestId);
+        this.waiters.get(requestId)?.resolve(response);
+        this.waiters.delete(requestId);
+        this.hub.emit(record.threadId, "serverRequest/resolved", { threadId: record.threadId, requestId });
+        return true;
+    }
+    replay(threadId) {
+        for (const request of this.store.listPendingRequests(threadId)) {
+            this.metrics.pendingOpened(request.requestId, request.createdAt);
+            this.hub.request(threadId, request.requestId, request.method, request.params);
+        }
+    }
+    cancelThread(threadId) {
+        for (const request of this.store.listPendingRequests(threadId))
+            this.cancel(request.requestId);
+    }
+    cancel(requestId) {
+        const record = this.store.getPendingRequest(requestId);
+        if (!record || record.status !== "pending")
+            return;
+        const response = { cancelled: true };
+        this.store.resolvePendingRequest(requestId, "cancelled", response);
+        this.metrics.pendingClosed(requestId);
+        this.waiters.get(requestId)?.resolve(response);
+        this.waiters.delete(requestId);
+        this.hub.emit(record.threadId, "serverRequest/resolved", { threadId: record.threadId, requestId });
+    }
+}
+//# sourceMappingURL=interactions.js.map

package/dist/claude/interactions.js.map

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

package/dist/claude/interruptCompat.d.ts

@@ -0,0 +1,7 @@
+import type { Query } from "@anthropic-ai/claude-agent-sdk";
+export interface InterruptCancellation {
+    readonly receiptSupported: boolean;
+    readonly cancelled: string[];
+    readonly raced: string[];
+}
+export declare function interruptAndCancelOwned(query: Query, ownedMessageIds: ReadonlySet<string>, capabilities: ReadonlySet<string>): Promise<InterruptCancellation>;

package/dist/claude/interruptCompat.js

@@ -0,0 +1,20 @@
+export async function interruptAndCancelOwned(query, ownedMessageIds, capabilities) {
+    const receipt = await query.interrupt();
+    if (!receipt || !capabilities.has("interrupt_receipt_v1")) {
+        return { receiptSupported: false, cancelled: [], raced: [] };
+    }
+    const cancel = query.cancelAsyncMessage;
+    const ownedQueued = receipt.still_queued.filter((id) => ownedMessageIds.has(id));
+    if (ownedQueued.length > 0 && !cancel)
+        throw new Error("Claude CLI advertised interrupt receipts but the pinned SDK cannot cancel queued messages.");
+    const cancelled = [];
+    const raced = [];
+    for (const id of ownedQueued) {
+        if (await cancel.call(query, id))
+            cancelled.push(id);
+        else
+            raced.push(id);
+    }
+    return { receiptSupported: true, cancelled, raced };
+}
+//# sourceMappingURL=interruptCompat.js.map

package/dist/claude/interruptCompat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interruptCompat.js","sourceRoot":"","sources":["../../src/claude/interruptCompat.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAY,EACZ,eAAoC,EACpC,YAAiC;IAEjC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IACxC,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,MAAM,GAAI,KAA+B,CAAC,kBAAkB,CAAC;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACjF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;IACrJ,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,IAAI,MAAM,MAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;;YACjD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtD,CAAC"}

package/dist/claude/modelCatalog.d.ts

@@ -0,0 +1,19 @@
+import { type ModelInfo, type Query } from "@anthropic-ai/claude-agent-sdk";
+import type { Model } from "../codex/generated/v2/Model.js";
+import type { HybridConfig } from "../config/config.js";
+import type { Logger } from "../observability/logger.js";
+import { MetricsRegistry } from "../observability/metrics.js";
+export declare function assertClaudeControlSurface(value: unknown): asserts value is Query;
+export declare function mapClaudeModel(model: ModelInfo, prefix: string): Model;
+export declare class ClaudeModelCatalog {
+    private readonly config;
+    private readonly logger;
+    private readonly metrics;
+    private cache;
+    private loading;
+    constructor(config: HybridConfig, logger: Logger, metrics?: MetricsRegistry);
+    list(): Promise<Model[]>;
+    invalidate(): void;
+    private load;
+    private cacheKey;
+}

package/dist/claude/modelCatalog.js

@@ -0,0 +1,140 @@
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { MetricsRegistry } from "../observability/metrics.js";
+import { modelCatalogValue } from "./modelSelection.js";
+const effortDescriptions = {
+    low: "Faster responses with less reasoning.",
+    medium: "Balanced reasoning effort.",
+    high: "Deep reasoning for complex work.",
+    xhigh: "Extra-high reasoning effort.",
+    max: "Maximum available reasoning effort.",
+};
+const requiredControls = ["initializationResult", "supportedModels", "reinitialize", "interrupt", "setModel", "close"];
+export function assertClaudeControlSurface(value) {
+    if (!value || typeof value !== "object")
+        throw new Error("Claude SDK query did not return a control object.");
+    const missing = requiredControls.filter((method) => typeof value[method] !== "function");
+    if (missing.length > 0)
+        throw new Error(`Claude SDK query is missing required controls: ${missing.join(", ")}.`);
+}
+function defaultEffort(levels) {
+    if (levels.includes("high"))
+        return "high";
+    if (levels.includes("medium"))
+        return "medium";
+    return levels[0] ?? "medium";
+}
+export function mapClaudeModel(model, prefix) {
+    const efforts = model.supportsEffort ? (model.supportedEffortLevels ?? []) : [];
+    const serviceTiers = model.supportsFastMode
+        ? [
+            { id: "default", name: "Default", description: "Standard Claude execution." },
+            { id: "fast", name: "Fast", description: "Claude fast mode." },
+        ]
+        : [];
+    const id = `${prefix}${modelCatalogValue(model)}`;
+    return {
+        id,
+        model: id,
+        upgrade: null,
+        upgradeInfo: null,
+        availabilityNux: null,
+        displayName: model.displayName,
+        description: model.description,
+        hidden: false,
+        supportedReasoningEfforts: efforts.map((reasoningEffort) => ({
+            reasoningEffort,
+            description: effortDescriptions[reasoningEffort] ?? `${reasoningEffort} reasoning effort.`,
+        })),
+        defaultReasoningEffort: defaultEffort(efforts),
+        inputModalities: ["text", "image"],
+        supportsPersonality: true,
+        additionalSpeedTiers: [],
+        serviceTiers,
+        defaultServiceTier: serviceTiers.length > 0 ? "default" : null,
+        isDefault: false,
+    };
+}
+async function* idlePrompt(signal) {
+    if (signal.aborted)
+        return;
+    await new Promise((resolve) => signal.addEventListener("abort", () => resolve(), { once: true }));
+}
+export class ClaudeModelCatalog {
+    config;
+    logger;
+    metrics;
+    cache;
+    loading;
+    constructor(config, logger, metrics = new MetricsRegistry()) {
+        this.config = config;
+        this.logger = logger;
+        this.metrics = metrics;
+    }
+    async list() {
+        const key = this.cacheKey();
+        if (this.cache && this.cache.key === key && this.cache.expiresAt > Date.now())
+            return this.cache.models;
+        if (this.cache?.key !== key)
+            this.cache = undefined;
+        this.loading ??= this.load().finally(() => {
+            this.loading = undefined;
+        });
+        return this.loading;
+    }
+    invalidate() {
+        this.cache = undefined;
+    }
+    async load() {
+        const abort = new AbortController();
+        const sdkQuery = query({
+            prompt: idlePrompt(abort.signal),
+            options: {
+                pathToClaudeCodeExecutable: this.config.claudeBinary,
+                persistSession: false,
+                abortController: abort,
+                allowedTools: [],
+                settingSources: ["user", "project", "local"],
+                env: process.env,
+                stderr: (line) => this.logger.debug("claude.model-probe.stderr", { output: line }),
+            },
+        });
+        try {
+            assertClaudeControlSurface(sdkQuery);
+            const [, models] = await Promise.race([
+                Promise.all([sdkQuery.initializationResult(), sdkQuery.supportedModels()]),
+                new Promise((_, reject) => setTimeout(() => reject(new Error("Claude model probe timed out.")), 10_000)),
+            ]);
+            await sdkQuery.reinitialize();
+            await sdkQuery.interrupt();
+            const mapped = models.map((model) => mapClaudeModel(model, this.config.modelPrefix));
+            this.cache = {
+                key: this.cacheKey(),
+                expiresAt: Date.now() + this.config.modelCacheSeconds * 1_000,
+                models: mapped,
+            };
+            this.logger.info("claude.models.loaded", { count: mapped.length, controls: requiredControls });
+            return mapped;
+        }
+        catch (error) {
+            this.metrics.modelProbeFailed();
+            throw error;
+        }
+        finally {
+            abort.abort();
+        }
+    }
+    cacheKey() {
+        const binary = existsSync(this.config.claudeBinary) ? realpathSync(this.config.claudeBinary) : this.config.claudeBinary;
+        const identity = existsSync(binary) ? statSync(binary) : undefined;
+        const environment = [
+            "HOME", "CLAUDE_CONFIG_DIR", "ANTHROPIC_BASE_URL", "CLAUDE_CODE_USE_BEDROCK",
+            "CLAUDE_CODE_USE_VERTEX", "CLAUDE_CODE_USE_FOUNDRY",
+        ].map((name) => [name, process.env[name] ?? null]);
+        return createHash("sha256").update(JSON.stringify({
+            binary, size: identity?.size ?? null, mtimeMs: identity?.mtimeMs ?? null, environment,
+        })).digest("hex");
+    }
+}
+import { createHash } from "node:crypto";
+import { existsSync, realpathSync, statSync } from "node:fs";
+//# sourceMappingURL=modelCatalog.js.map