@gkorepanov/ccodex 0.4.25 → 0.5.0-rc.2

package/dist/gateway/catalog.js

@@ -0,0 +1,268 @@
+import { invalidParams, invalidRequest } from "../protocol/codex.js";
+const CACHE_MS = 10_000;
+function sortKey(params) {
+    return params.sortKey === "updated_at" ? "updatedAt" : params.sortKey === "recency_at" ? "recencyAt" : "createdAt";
+}
+function encodeCursor(value) {
+    return Buffer.from(JSON.stringify(value)).toString("base64url");
+}
+function decodeCursor(cursor, key) {
+    if (!cursor)
+        return 0;
+    try {
+        const value = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+        if (value.key === key)
+            return value.offset;
+    }
+    catch {
+        // fall through
+    }
+    throw invalidParams("Thread pagination query changed; restart pagination.");
+}
+function sourceKind(thread) {
+    const source = thread.source;
+    if (typeof source === "string")
+        return source;
+    if (source && typeof source === "object" && "subAgent" in source) {
+        const sub = source.subAgent;
+        if (sub && typeof sub === "object" && "thread_spawn" in sub)
+            return "subAgentThreadSpawn";
+        return "subAgentOther";
+    }
+    return "unknown";
+}
+/**
+ * `thread/list` & co: stock's pages (same filters) merged with Claude sessions filtered the same way.
+ * Lineage backends other than the public one are hidden; lineage rows show the current backend's state.
+ */
+export class Catalog {
+    gateway;
+    stockCache;
+    constructor(gateway) {
+        this.gateway = gateway;
+    }
+    claudeMatches(thread, params) {
+        const meta = this.gateway.meta;
+        if ((params.archived ?? false) !== meta.isArchived(thread.id))
+            return false;
+        if (params.modelProviders?.length && !params.modelProviders.includes("claude"))
+            return false;
+        const kinds = params.sourceKinds?.length ? params.sourceKinds : undefined;
+        if (kinds ? !kinds.includes(sourceKind(thread)) : thread.parentThreadId)
+            return false;
+        if (params.cwd) {
+            const cwds = Array.isArray(params.cwd) ? params.cwd : [params.cwd];
+            if (!cwds.includes(thread.cwd))
+                return false;
+        }
+        if (params.sectionId !== undefined) {
+            const section = meta.section(thread.id)?.sectionId ?? null;
+            if (section !== params.sectionId)
+                return false;
+        }
+        if (params.projectId)
+            return false;
+        if (params.parentThreadId && thread.parentThreadId !== meta.rowId(params.parentThreadId))
+            return false;
+        if (params.searchTerm) {
+            const term = String(params.searchTerm).toLowerCase();
+            if (!`${thread.name ?? ""}\n${thread.preview}`.toLowerCase().includes(term))
+                return false;
+        }
+        return true;
+    }
+    async claudeThreads(params) {
+        const publicAncestor = params.ancestorThreadId ?? params.parentThreadId ?? undefined;
+        const ancestor = publicAncestor && this.gateway.meta.rowId(publicAncestor);
+        const claude = this.gateway.claude;
+        let threads = claude.threads();
+        if (ancestor && claude.owns(ancestor))
+            threads = await claude.subagentThreads(ancestor);
+        else if (ancestor)
+            threads = [];
+        return threads.filter((thread) => this.claudeMatches(thread, params));
+    }
+    /**
+     * Stock threads for one filter set, fetched only as far as needed, in pages of the client's size: stock's
+     * paging depends on the page size, so this walks exactly the pages the client would get from stock itself.
+     */
+    async stockThreads(connection, params, needed, fresh) {
+        const { cursor: _cursor, ...filters } = params;
+        const key = JSON.stringify(filters);
+        if (fresh || !this.stockCache || this.stockCache.key !== key || Date.now() - this.stockCache.at > CACHE_MS) {
+            this.stockCache = { key, at: Date.now(), threads: [], next: null, done: false };
+        }
+        const cache = this.stockCache;
+        while (!cache.done && cache.threads.length < needed) {
+            const page = await connection.upstream.request("thread/list", { ...filters, cursor: cache.next });
+            cache.threads.push(...page.data);
+            cache.next = page.nextCursor;
+            cache.done = !page.nextCursor;
+        }
+        return cache.threads;
+    }
+    /** Lineage backends are hidden; a lineage's public row carries its current backend's live state. */
+    async project(threads) {
+        return Promise.all(threads.filter((thread) => !this.gateway.lineages.isHidden(thread.id)).map((thread) => this.gateway.lineages.projectRow(thread)));
+    }
+    /** Position of a row in the requested order: negative sorts first. */
+    order(params) {
+        const key = sortKey(params);
+        const direction = params.sortDirection === "asc" ? 1 : -1;
+        return (thread) => direction * Number(thread[key] ?? thread.updatedAt ?? 0);
+    }
+    merge(stock, claude, params) {
+        const order = this.order(params);
+        if (params.sortKey === "section_position")
+            return this.sectionOrdered(params.sectionId, stock, claude);
+        const claudeSorted = [...claude].sort((left, right) => order(left) - order(right) || left.id.localeCompare(right.id));
+        const merged = [];
+        let s = 0;
+        let c = 0;
+        while (s < stock.length || c < claudeSorted.length) {
+            const takeStock = c >= claudeSorted.length
+                || (s < stock.length && order(stock[s]) <= order(claudeSorted[c]));
+            merged.push(takeStock ? stock[s++] : claudeSorted[c++]);
+        }
+        return merged;
+    }
+    /**
+     * A section's manual order over stock and Claude threads (recorded once a Claude thread is in it); threads that
+     * entered later keep stock's order, then Claude's by entry time, at the end.
+     */
+    sectionOrdered(sectionId, stock, claude) {
+        const order = sectionId ? this.gateway.meta.sectionOrder(sectionId) : [];
+        const rank = (thread) => {
+            const index = order.indexOf(thread.id);
+            return index >= 0 ? index : order.length;
+        };
+        const entered = [...claude].sort((left, right) => Number(left.sectionEnteredAt ?? 0) - Number(right.sectionEnteredAt ?? 0));
+        return [...stock, ...entered].sort((left, right) => rank(left) - rank(right));
+    }
+    async list(connection, params) {
+        const limit = Math.max(1, Math.min(Number(params.limit ?? 50), 200));
+        const { cursor: _cursor, limit: _limit, ...filters } = params;
+        const key = JSON.stringify(filters);
+        const offset = decodeCursor(params.cursor, key);
+        if (!params.cursor) {
+            await Promise.all([this.gateway.claude.catalog.refresh(), this.refreshSections(), this.gateway.claude.models().catch(() => undefined)]);
+        }
+        const claude = await this.project(await this.claudeThreads(params));
+        const stock = await this.stockThreads(connection, { ...params, limit }, offset + limit, !params.cursor);
+        const complete = this.stockCache.done;
+        const shown = await this.project(stock);
+        let merged = this.merge(shown, claude, params);
+        // Without all stock rows, only the part of the merge that no unseen stock row can precede is final (the last
+        // stock row read may itself be hidden or projected: its sort value is the boundary).
+        if (!complete && stock.length) {
+            const order = this.order(params);
+            const boundary = order(stock.at(-1));
+            const seen = new Set(shown);
+            merged = merged.filter((thread) => seen.has(thread) || order(thread) <= boundary);
+        }
+        const data = merged.slice(offset, offset + limit);
+        const more = offset + limit < merged.length || !complete;
+        return {
+            data,
+            nextCursor: more && data.length ? encodeCursor({ key, offset: offset + data.length }) : null,
+            backwardsCursor: null,
+        };
+    }
+    async refreshSections() {
+        const { data } = await this.gateway.stock.request("threadSection/list", { limit: 100 });
+        this.gateway.sections.clear();
+        for (const section of data)
+            this.gateway.sections.set(section.id, section);
+    }
+    async search(connection, params) {
+        const searchTerm = String(params.searchTerm ?? "").trim();
+        if (!searchTerm)
+            throw invalidRequest("thread/search requires a non-empty searchTerm");
+        const key = sortKey(params);
+        const direction = params.sortDirection === "asc" ? 1 : -1;
+        const limit = Math.max(1, Math.min(Number(params.limit ?? 25), 100));
+        const queryKey = JSON.stringify({ searchTerm, archived: params.archived, sourceKinds: params.sourceKinds, key, direction });
+        const offset = decodeCursor(params.cursor, queryKey);
+        // Only as many stock results as this page needs (a full stock search takes seconds), in the client's pages.
+        const stockResults = [];
+        let cursor = null;
+        do {
+            const page = await connection.upstream.request("thread/search", { ...params, searchTerm, cursor, limit });
+            stockResults.push(...page.data);
+            cursor = page.nextCursor;
+        } while (cursor && stockResults.length < offset + limit);
+        const claude = (await this.project(await this.claudeThreads({ archived: params.archived, sourceKinds: params.sourceKinds, searchTerm })))
+            .map((thread) => ({ thread, snippet: thread.name ?? thread.preview.slice(0, 120) }));
+        const visible = stockResults.filter((result) => !this.gateway.lineages.isHidden(result.thread.id));
+        let all = [...visible, ...claude].sort((left, right) => direction * (Number(left.thread[key] ?? 0) - Number(right.thread[key] ?? 0)));
+        // Without all stock results, only the part no unseen stock result can precede is final.
+        if (cursor && visible.length)
+            all = all.slice(0, all.indexOf(visible.at(-1)) + 1);
+        const data = all.slice(offset, offset + limit);
+        return {
+            data,
+            nextCursor: offset + limit < all.length || (cursor && data.length) ? encodeCursor({ key: queryKey, offset: offset + data.length }) : null,
+            backwardsCursor: null,
+        };
+    }
+    async loaded(connection, params) {
+        const stock = [];
+        let cursor = null;
+        do {
+            const page = await connection.upstream.request("thread/loaded/list", { cursor, limit: 100 });
+            stock.push(...page.data);
+            cursor = page.nextCursor;
+        } while (cursor);
+        const rewrites = this.gateway.meta.rewrites;
+        const ids = [...stock, ...this.gateway.claude.loadedIds()].map((id) => rewrites.get(id) ?? id)
+            .filter((id) => !this.gateway.lineages.isHidden(id));
+        const unique = [...new Set(ids)];
+        const limit = Math.max(1, Math.min(Number(params.limit ?? 100), 100));
+        const offset = decodeCursor(params.cursor, "loaded");
+        const data = unique.slice(offset, offset + limit);
+        return { data, nextCursor: offset + limit < unique.length ? encodeCursor({ key: "loaded", offset: offset + limit }) : null };
+    }
+    /**
+     * `thread/section/move`: stock orders its own threads, Claude threads live in meta. Once a section holds a
+     * Claude thread its merged manual order is recorded, and a stock thread is placed before the next stock one.
+     */
+    async moveInSection(connection, params) {
+        const { threadId, sectionId, beforeThreadId } = params;
+        const meta = this.gateway.meta;
+        const isClaude = (id) => this.gateway.claude.owns(meta.rowId(id));
+        const members = sectionId === null ? [] : (await this.list(connection, { sectionId, sortKey: "section_position", limit: 200, archived: false })).data;
+        const order = members.map((thread) => thread.id).filter((id) => id !== threadId);
+        if (!isClaude(threadId) && !order.some(isClaude))
+            return connection.upstream.request("thread/section/move", { ...params, threadId: meta.rowId(threadId) });
+        const at = beforeThreadId ? order.indexOf(beforeThreadId) : -1;
+        order.splice(at < 0 ? order.length : at, 0, threadId);
+        if (isClaude(threadId)) {
+            meta.setSection(meta.rowId(threadId), sectionId);
+        }
+        else {
+            const next = order.slice(order.indexOf(threadId) + 1).find((id) => !isClaude(id));
+            await connection.upstream.request("thread/section/move", { threadId: meta.rowId(threadId), sectionId, beforeThreadId: next ? meta.rowId(next) : null });
+        }
+        if (sectionId)
+            meta.setSectionOrder(sectionId, order);
+        return {};
+    }
+    /** Mobile (codex-backend) learns about threads from notifications: announce every Claude thread once. */
+    async announce(connection) {
+        for (const thread of this.gateway.claude.threads()) {
+            if (thread.parentThreadId)
+                continue;
+            connection.notify("thread/started", { thread: { ...thread, turns: [] } });
+            if (thread.name)
+                connection.notify("thread/name/updated", { threadId: thread.id, threadName: thread.name });
+            connection.notify(this.gateway.meta.isArchived(thread.id) ? "thread/archived" : "thread/unarchived", { threadId: thread.id });
+        }
+        for (const segments of Object.values(this.gateway.meta.lineages)) {
+            for (const { threadId } of segments) {
+                if (this.gateway.meta.hidden(threadId))
+                    connection.send(JSON.stringify({ method: "thread/deleted", params: { threadId } }), true);
+            }
+        }
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/gateway/catalog.js.map

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

package/dist/gateway/connection.d.ts

@@ -0,0 +1,36 @@
+import WebSocket from "ws";
+import type { Provider } from "../meta.js";
+import { type RequestId } from "../protocol/codex.js";
+import type { Gateway } from "./server.js";
+import type { StockClient } from "./stock.js";
+/**
+ * One client (Desktop, TUI, relay-bridged mobile client). Everything that is not ours is forwarded byte for
+ * byte to this client's own stock connection and back.
+ */
+export declare class Connection {
+    private readonly gateway;
+    private readonly client;
+    readonly upstream: StockClient;
+    readonly id: `${string}-${string}-${string}-${string}-${string}`;
+    clientName?: string;
+    /** Provider of the thread this client last worked in (rate limits follow it). */
+    provider: Provider;
+    /** Ephemeral threads this client is creating: only their creator hears of them (stock tells every client). */
+    readonly ephemeralRequests: Set<RequestId>;
+    private closed;
+    /** What the client sent past its handshake before the gateway was ready, in order. */
+    private backlog?;
+    constructor(gateway: Gateway, client: WebSocket, upstream: StockClient);
+    /** Everything to the client goes here; a switched thread's current backend id reads as its public id. */
+    send(text: string, raw?: boolean): void;
+    notify(method: string, params: unknown): void;
+    respond(id: RequestId, result: unknown): void;
+    /** Server→client request originated by CCodex (string ids never collide with stock's numeric ids). */
+    request(id: string, method: string, params: unknown): void;
+    private close;
+    private forward;
+    private onClientText;
+    private dispatch;
+    private route;
+    private onStockText;
+}

package/dist/gateway/connection.js

@@ -0,0 +1,136 @@
+import { randomUUID } from "node:crypto";
+import WebSocket from "ws";
+import { RpcFailure, rpcError } from "../protocol/codex.js";
+/** Methods that take an optional threadId only as context; for Claude threads it is dropped and stock answers. */
+const THREAD_CONTEXT_METHODS = new Set([
+    "app/installed", "app/list", "app/read", "experimentalFeature/list", "feedback/upload", "mcpServerStatus/list",
+    "mcpServer/tool/call", "mcpServer/resource/read", "mcpServer/oauth/login", "mcpServer/event/stream/start",
+]);
+/**
+ * One client (Desktop, TUI, relay-bridged mobile client). Everything that is not ours is forwarded byte for
+ * byte to this client's own stock connection and back.
+ */
+export class Connection {
+    gateway;
+    client;
+    upstream;
+    id = randomUUID();
+    clientName;
+    /** Provider of the thread this client last worked in (rate limits follow it). */
+    provider = "codex";
+    /** Ephemeral threads this client is creating: only their creator hears of them (stock tells every client). */
+    ephemeralRequests = new Set();
+    closed = false;
+    /** What the client sent past its handshake before the gateway was ready, in order. */
+    backlog = [];
+    constructor(gateway, client, upstream) {
+        this.gateway = gateway;
+        this.client = client;
+        this.upstream = upstream;
+        gateway.recorder.connection("opened", this.id);
+        client.on("message", (data) => this.onClientText(data.toString()));
+        client.once("close", () => this.close());
+        client.on("error", () => this.close());
+        upstream.onFrame = (text) => this.onStockText(text);
+        upstream.onClose = () => this.close();
+        void gateway.ready.then(() => {
+            const backlog = this.backlog ?? [];
+            this.backlog = undefined;
+            for (const text of backlog)
+                this.dispatch(text);
+        });
+    }
+    /** Everything to the client goes here; a switched thread's current backend id reads as its public id. */
+    send(text, raw = false) {
+        if (this.closed || this.client.readyState !== WebSocket.OPEN)
+            return;
+        if (!raw)
+            text = this.gateway.lineages.rewrite(text);
+        this.gateway.recorder.frame(this.id, "gateway_to_client", text);
+        this.client.send(text);
+    }
+    notify(method, params) {
+        this.send(JSON.stringify({ method, params }));
+    }
+    respond(id, result) {
+        this.ephemeralRequests.delete(id);
+        this.send(JSON.stringify({ id, result }));
+    }
+    /** Server→client request originated by CCodex (string ids never collide with stock's numeric ids). */
+    request(id, method, params) {
+        this.send(JSON.stringify({ id, method, params }));
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.gateway.detach(this);
+        this.gateway.recorder.connection("closed", this.id);
+        if (this.client.readyState === WebSocket.OPEN)
+            this.client.close();
+        this.upstream.close();
+    }
+    forward(text) {
+        this.upstream.send(text).catch(() => this.close());
+    }
+    onClientText(text) {
+        this.gateway.recorder.frame(this.id, "client_to_gateway", text);
+        if (this.backlog && !/^\{(?:"id":[^,]*,)?"method":"initialized?"/u.test(text))
+            this.backlog.push(text);
+        else
+            this.dispatch(text);
+    }
+    dispatch(text) {
+        let message;
+        try {
+            message = JSON.parse(text);
+        }
+        catch {
+            this.forward(text);
+            return;
+        }
+        if ((message.method === "thread/start" || message.method === "thread/fork") && message.params?.ephemeral === true) {
+            this.ephemeralRequests.add(message.id);
+        }
+        if (message.method === undefined) {
+            if (typeof message.id === "string" && message.id.startsWith("ccodex:"))
+                this.gateway.resolveServerRequest(message);
+            else
+                this.forward(text);
+            return;
+        }
+        if (message.id === undefined) {
+            this.forward(text);
+            return;
+        }
+        const handler = this.route(message.method, message.params ?? {});
+        if (!handler) {
+            this.forward(text);
+            return;
+        }
+        handler(this, message.params ?? {}).then((result) => this.respond(message.id, result), (error) => {
+            this.gateway.logger.warn("request.failed", { method: message.method, error: String(error) });
+            this.send(JSON.stringify({ id: message.id, error: rpcError(error) }), error instanceof RpcFailure && error.verbatim);
+        });
+    }
+    route(method, params) {
+        const gateway = this.gateway;
+        const threadId = typeof params.threadId === "string" ? params.threadId : undefined;
+        const own = gateway.handlers.get(method);
+        if (own)
+            return own;
+        if (threadId && THREAD_CONTEXT_METHODS.has(method) && gateway.isClaudeThread(threadId)) {
+            const { threadId: _, ...rest } = params;
+            return () => this.upstream.request(method, rest);
+        }
+        return gateway.threadHandler(this, method, params);
+    }
+    onStockText(text) {
+        if (this.ephemeralRequests.size && text.startsWith("{\"id\""))
+            this.ephemeralRequests.delete(JSON.parse(text).id);
+        const rewritten = this.gateway.fromBackendFrame(this, text);
+        if (rewritten !== undefined)
+            this.send(rewritten);
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/gateway/connection.js.map

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

package/dist/gateway/lineage.d.ts

@@ -0,0 +1,60 @@
+import { type JsonObject, type Thread } from "../protocol/codex.js";
+import type { Connection } from "./connection.js";
+import type { Gateway } from "./server.js";
+/** Codex's own `templates/compact/prompt.md` and `summary_prefix.md`. */
+export declare const COMPACT_PROMPT = "You are performing a CONTEXT CHECKPOINT COMPACTION. Create a handoff summary for another LLM that will resume the task.\nInclude:\n- Current progress and key decisions made\n- Important context, constraints, or user preferences\n- What remains to be done (clear next steps)\n- Any critical data, examples, or references needed to continue\nBe concise, structured, and focused on helping the next LLM seamlessly continue the work.";
+export declare const SUMMARY_PREFIX = "Another language model started to solve this problem and produced a summary of its thinking process. You also have access to the state of the tools that were used by that language model. Use this to build on the work that has already been done and avoid duplicating work. Here is the summary produced by the other language model, use the information in this summary to assist with your own analysis:";
+/**
+ * Threads that switched provider. Each segment lives natively in its provider; meta.json keeps only the segment
+ * list. History is stitched, everything else goes to the current segment's backend.
+ */
+export declare class Lineages {
+    private readonly gateway;
+    /** Model of the other provider chosen through `thread/settings/update`; the switch runs on the next turn. */
+    private readonly pending;
+    private readonly resumed;
+    /** Stock backends being created by switches, their held announcements, and the backends (both providers) created so far. */
+    private creatingBackends;
+    private readonly heldAnnouncements;
+    private readonly newBackends;
+    constructor(gateway: Gateway);
+    private segments;
+    private providerOf;
+    switchRequested(method: string, params: JsonObject): boolean;
+    rewrite(text: string): string;
+    /** A backend of a switched thread: never a thread of its own for clients. */
+    isBackend(threadId: string): boolean;
+    /** Not listed: a backend that is no lineage's row (a row backend lists as its public thread). */
+    isHidden(threadId: string): boolean;
+    /** Holds a new thread's announcement while a switch creates a stock backend; false = deliver it now. */
+    holdAnnouncement(connection: Connection, threadId: string, text: string): boolean;
+    /** Stock announces a new thread to every connection before its creator learns the id: a backend's announcement
+     *  is held until then and dropped, or Desktop keeps it as a row that can never open. */
+    private startBackend;
+    handle(connection: Connection, method: string, params: JsonObject): Promise<unknown>;
+    /** The request on one segment's own backend (thread id replaced). */
+    private forward;
+    private segmentTurns;
+    /** Turns of each segment, cut at its last turn; a Claude segment after a switch starts with the marker turn. */
+    private perSegment;
+    private stitchedTurns;
+    private thread;
+    /** The public row (preview, creation) with the current backend's live state and name (✳️ while on Claude). */
+    private merge;
+    /** List row of a lineage's public thread. */
+    projectRow(row: Thread): Promise<Thread>;
+    private history;
+    /** Segment index holding `turnId`, and the turn's index inside that segment's (cut) turns. */
+    private locate;
+    private fork;
+    private revert;
+    /**
+     * `turn/start` with the other provider's model: summarize the current segment, start a native thread on the
+     * other provider with the summary injected, then run the user's turn there. Desktop gives its optimistic message
+     * to the first turn that starts, so live the compaction shows only inside the user's turn: under its preallocated
+     * id towards Claude, after stock started it towards codex. On failure the user's turn fails.
+     */
+    private switchProvider;
+    private gptSummary;
+    private toCodex;
+}