@gkorepanov/ccodex 0.4.25 → 0.5.0-rc.2

package/dist/mcp/server.js.map

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

package/dist/meta.d.ts

@@ -0,0 +1,71 @@
+export type Provider = "codex" | "claude";
+export interface Segment {
+    readonly provider: Provider;
+    readonly threadId: string;
+    /** Last turn of this segment; null for the current (last) segment. */
+    readonly lastTurnId: string | null;
+}
+export interface MetaData {
+    /**
+     * Threads that switched provider: public id → segments, oldest first. The public id is one of the segments
+     * (the first one; for a fork taken in a later segment, the forked backend), or none of them for a 0.4 thread id
+     * kept for its Claude session by the migration.
+     */
+    lineages: Record<string, Segment[]>;
+    /** Archived Claude sessions (stock keeps its own archive flag). */
+    archived: string[];
+    /** Section membership of Claude threads (stock keeps its own). */
+    sections: Record<string, {
+        sectionId: string;
+        enteredAt: number;
+    }>;
+    /** Manual order inside a section, merged over stock and Claude threads (only once it was changed). */
+    sectionOrder: Record<string, string[]>;
+    /** Claude threads rolled back but not continued yet: the kept history ends at this record. */
+    leaves: Record<string, string>;
+    /** Default model, effort and speed the App picked while its default model is a Claude one, by config key (never
+     *  written to Codex's config.toml). */
+    claudeDefaults?: Record<string, unknown> | null;
+}
+/**
+ * `~/.ccodex/state/meta.json`: tiny, optional. Missing file or key = defaults. The gateway is the only
+ * writer; each write goes to a temp file renamed over the original.
+ */
+export declare class Meta {
+    private readonly path;
+    private data;
+    private idRewrites;
+    private hiddenIds;
+    constructor(path: string);
+    get lineages(): Readonly<Record<string, readonly Segment[]>>;
+    lineage(publicId: string): readonly Segment[] | undefined;
+    /** Backend id → public id: the current backend and the row's backend of lineages where they differ from it. */
+    get rewrites(): ReadonlyMap<string, string>;
+    /** Backend threads that only exist as a part of some lineage (never listed on their own). */
+    hidden(threadId: string): boolean;
+    current(publicId: string): Segment | undefined;
+    /** The segment whose backend carries the lineage's row (name, preview, archive, section). */
+    row(publicId: string): Segment;
+    /** The backend id a public thread id is keyed by: its row's backend for lineages, itself otherwise. */
+    rowId(threadId: string): string;
+    setLineage(publicId: string, segments: Segment[]): void;
+    deleteLineage(publicId: string): void;
+    /** Drops finished segments whose backend is gone: Claude deletes transcripts after `cleanupPeriodDays`. */
+    prune(exists: (segment: Segment) => boolean): void;
+    isArchived(threadId: string): boolean;
+    setArchived(threadId: string, archived: boolean): void;
+    section(threadId: string): {
+        sectionId: string;
+        enteredAt: number;
+    } | undefined;
+    setSection(threadId: string, sectionId: string | null): void;
+    sectionOrder(sectionId: string): readonly string[];
+    setSectionOrder(sectionId: string, ids: string[]): void;
+    get claudeDefaults(): MetaData["claudeDefaults"];
+    setClaudeDefaults(value: MetaData["claudeDefaults"]): void;
+    leaf(threadId: string): string | undefined;
+    setLeaf(threadId: string, uuid: string | null): void;
+    forget(threadId: string): void;
+    private reindex;
+    private save;
+}

package/dist/meta.js

@@ -0,0 +1,130 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * `~/.ccodex/state/meta.json`: tiny, optional. Missing file or key = defaults. The gateway is the only
+ * writer; each write goes to a temp file renamed over the original.
+ */
+export class Meta {
+    path;
+    data;
+    idRewrites = new Map();
+    hiddenIds = new Set();
+    constructor(path) {
+        this.path = path;
+        const raw = existsSync(path) ? JSON.parse(readFileSync(path, "utf8")) : {};
+        this.data = {
+            lineages: raw.lineages ?? {}, archived: raw.archived ?? [], sections: raw.sections ?? {},
+            sectionOrder: raw.sectionOrder ?? {}, leaves: raw.leaves ?? {}, claudeDefaults: raw.claudeDefaults ?? null,
+        };
+        this.reindex();
+    }
+    get lineages() { return this.data.lineages; }
+    lineage(publicId) { return this.data.lineages[publicId]; }
+    /** Backend id → public id: the current backend and the row's backend of lineages where they differ from it. */
+    get rewrites() { return this.idRewrites; }
+    /** Backend threads that only exist as a part of some lineage (never listed on their own). */
+    hidden(threadId) { return this.hiddenIds.has(threadId); }
+    current(publicId) { return this.data.lineages[publicId]?.at(-1); }
+    /** The segment whose backend carries the lineage's row (name, preview, archive, section). */
+    row(publicId) {
+        const segments = this.data.lineages[publicId];
+        return segments.find((segment) => segment.threadId === publicId) ?? segments[0];
+    }
+    /** The backend id a public thread id is keyed by: its row's backend for lineages, itself otherwise. */
+    rowId(threadId) {
+        return this.data.lineages[threadId] ? this.row(threadId).threadId : threadId;
+    }
+    setLineage(publicId, segments) {
+        this.data.lineages[publicId] = segments;
+        this.reindex();
+        this.save();
+    }
+    deleteLineage(publicId) {
+        delete this.data.lineages[publicId];
+        this.reindex();
+        this.save();
+    }
+    /** Drops finished segments whose backend is gone: Claude deletes transcripts after `cleanupPeriodDays`. */
+    prune(exists) {
+        let changed = false;
+        for (const [publicId, segments] of Object.entries(this.data.lineages)) {
+            const kept = segments.filter((segment, index) => index === segments.length - 1 || exists(segment));
+            if (kept.length === segments.length)
+                continue;
+            changed = true;
+            if (kept.length === 1 && kept[0].threadId === publicId)
+                delete this.data.lineages[publicId];
+            else
+                this.data.lineages[publicId] = kept;
+        }
+        if (!changed)
+            return;
+        this.reindex();
+        this.save();
+    }
+    isArchived(threadId) { return this.data.archived.includes(threadId); }
+    setArchived(threadId, archived) {
+        this.data.archived = this.data.archived.filter((id) => id !== threadId);
+        if (archived)
+            this.data.archived.push(threadId);
+        this.save();
+    }
+    section(threadId) {
+        return this.data.sections[threadId];
+    }
+    setSection(threadId, sectionId) {
+        if (sectionId)
+            this.data.sections[threadId] = { sectionId, enteredAt: Math.floor(Date.now() / 1000) };
+        else
+            delete this.data.sections[threadId];
+        this.save();
+    }
+    sectionOrder(sectionId) { return this.data.sectionOrder[sectionId] ?? []; }
+    setSectionOrder(sectionId, ids) {
+        this.data.sectionOrder[sectionId] = ids;
+        this.save();
+    }
+    get claudeDefaults() { return this.data.claudeDefaults; }
+    setClaudeDefaults(value) {
+        this.data.claudeDefaults = value;
+        this.save();
+    }
+    leaf(threadId) { return this.data.leaves[threadId]; }
+    setLeaf(threadId, uuid) {
+        if (uuid)
+            this.data.leaves[threadId] = uuid;
+        else if (this.data.leaves[threadId])
+            delete this.data.leaves[threadId];
+        else
+            return;
+        this.save();
+    }
+    forget(threadId) {
+        this.data.archived = this.data.archived.filter((id) => id !== threadId);
+        delete this.data.sections[threadId];
+        delete this.data.leaves[threadId];
+        this.save();
+    }
+    reindex() {
+        this.idRewrites = new Map();
+        this.hiddenIds = new Set();
+        // Forks share segments: a segment is hidden unless it is some lineage's row.
+        const rows = new Set(Object.keys(this.data.lineages).map((publicId) => this.row(publicId).threadId));
+        for (const [publicId, segments] of Object.entries(this.data.lineages)) {
+            for (const segment of [this.row(publicId), segments.at(-1)]) {
+                if (segment.threadId !== publicId)
+                    this.idRewrites.set(segment.threadId, publicId);
+            }
+            for (const segment of segments)
+                if (!rows.has(segment.threadId))
+                    this.hiddenIds.add(segment.threadId);
+        }
+    }
+    save() {
+        mkdirSync(dirname(this.path), { recursive: true, mode: 0o700 });
+        const temporary = `${this.path}.${process.pid}.tmp`;
+        writeFileSync(temporary, `${JSON.stringify(this.data, null, 2)}\n`, { mode: 0o600 });
+        renameSync(temporary, this.path);
+    }
+}
+//# sourceMappingURL=meta.js.map

package/dist/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC;;;GAGG;AACH,MAAM,OAAO,IAAI;IAKqB;IAJ5B,IAAI,CAAW;IACf,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,YAAoC,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QAC9C,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,IAAI,CAAC,IAAI,GAAG;YACV,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;YACxF,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI;SAC3G,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,IAAW,QAAQ,KAAmD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3F,OAAO,CAAC,QAAgB,IAAoC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEzG,+GAA+G;IAC/G,IAAW,QAAQ,KAAkC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAE9E,6FAA6F;IACtF,MAAM,CAAC,QAAgB,IAAa,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE1E,OAAO,CAAC,QAAgB,IAAyB,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtG,6FAA6F;IACtF,GAAG,CAAC,QAAgB;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC;IACnF,CAAC;IAED,uGAAuG;IAChG,KAAK,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/E,CAAC;IAEM,UAAU,CAAC,QAAgB,EAAE,QAAmB;QACrD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,aAAa,CAAC,QAAgB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,2GAA2G;IACpG,KAAK,CAAC,MAAqC;QAChD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YACnG,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;gBAAE,SAAS;YAC9C,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,QAAQ,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;;gBACxF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,UAAU,CAAC,QAAgB,IAAa,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEvF,WAAW,CAAC,QAAgB,EAAE,QAAiB;QACpD,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QACxE,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAEM,UAAU,CAAC,QAAgB,EAAE,SAAwB;QAC1D,IAAI,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;;YACjG,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,YAAY,CAAC,SAAiB,IAAuB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEtG,eAAe,CAAC,SAAiB,EAAE,GAAa;QACrD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,IAAW,cAAc,KAAiC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IAErF,iBAAiB,CAAC,KAAiC;QACxD,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,IAAI,CAAC,QAAgB,IAAwB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEjF,OAAO,CAAC,QAAgB,EAAE,IAAmB;QAClD,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;aACvC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;;YAClE,OAAO;QACZ,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,QAAgB;QAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,6EAA6E;QAC7E,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrG,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtE,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;gBAC7D,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;oBAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACrF,CAAC;YACD,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC;oBAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxG,CAAC;IACH,CAAC;IAEO,IAAI;QACV,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QACpD,aAAa,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrF,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/protocol/codex.d.ts

@@ -0,0 +1,238 @@
+export type JsonValue = unknown;
+export type JsonObject = Record<string, any>;
+export type RequestId = string | number;
+export type UserInput = {
+    type: "text";
+    text: string;
+    text_elements?: unknown[];
+} | {
+    type: "image";
+    url: string;
+    detail?: string;
+} | {
+    type: "localImage";
+    path: string;
+    detail?: string;
+} | {
+    type: "audio";
+    url: string;
+} | {
+    type: "localAudio";
+    path: string;
+} | {
+    type: "skill";
+    name: string;
+    path: string;
+} | {
+    type: "mention";
+    name: string;
+    path: string;
+};
+export type CommandAction = {
+    type: "read";
+    command: string;
+    name: string;
+    path: string;
+} | {
+    type: "listFiles";
+    command: string;
+    path: string | null;
+} | {
+    type: "search";
+    command: string;
+    query: string | null;
+    path: string | null;
+} | {
+    type: "unknown";
+    command: string;
+};
+export type FileUpdateChange = {
+    path: string;
+    kind: {
+        type: "add";
+    } | {
+        type: "delete";
+    } | {
+        type: "update";
+        move_path: string | null;
+    };
+    diff: string;
+};
+export type ThreadItem = {
+    type: "userMessage";
+    id: string;
+    clientId: string | null;
+    content: UserInput[];
+} | {
+    type: "agentMessage";
+    id: string;
+    text: string;
+    phase: string | null;
+    memoryCitation: null;
+    delivery?: unknown;
+    questions?: unknown;
+} | {
+    type: "plan";
+    id: string;
+    text: string;
+} | {
+    type: "reasoning";
+    id: string;
+    summary: string[];
+    content: string[];
+} | {
+    type: "commandExecution";
+    id: string;
+    command: string;
+    cwd: string;
+    processId: string | null;
+    source: string;
+    status: string;
+    commandActions: CommandAction[];
+    aggregatedOutput: string | null;
+    exitCode: number | null;
+    durationMs: number | null;
+    pluginId?: string | null;
+    scriptPath?: string | null;
+} | {
+    type: "fileChange";
+    id: string;
+    changes: FileUpdateChange[];
+    status: string;
+} | {
+    type: "mcpToolCall";
+    id: string;
+    server: string;
+    tool: string;
+    status: string;
+    arguments: JsonValue;
+    result: {
+        content: JsonValue[];
+        structuredContent: JsonValue | null;
+        _meta?: JsonValue | null;
+    } | null;
+    error: {
+        message: string;
+    } | null;
+    durationMs: number | null;
+    [key: string]: unknown;
+} | {
+    type: "dynamicToolCall";
+    id: string;
+    namespace: string | null;
+    tool: string;
+    arguments: JsonValue;
+    status: string;
+    contentItems: JsonValue[] | null;
+    success: boolean | null;
+    durationMs: number | null;
+} | {
+    type: "collabAgentToolCall";
+    id: string;
+    tool: string;
+    status: string;
+    senderThreadId: string;
+    receiverThreadIds: string[];
+    prompt: string | null;
+    model: string | null;
+    reasoningEffort: string | null;
+    agentsStates: Record<string, {
+        status: string;
+        message: string | null;
+    }>;
+} | {
+    type: "webSearch";
+    id: string;
+    query: string;
+    results?: JsonValue;
+    action?: JsonValue;
+} | {
+    type: "imageView";
+    id: string;
+    path: string;
+} | {
+    type: "contextCompaction";
+    id: string;
+};
+export interface QueuedSubmissionLike {
+    id: string;
+    input: UserInput[];
+    clientUserMessageId: string;
+}
+export type TurnStatus = "completed" | "interrupted" | "failed" | "inProgress";
+export interface Turn {
+    id: string;
+    items: ThreadItem[];
+    itemsView?: "notLoaded" | "summary" | "full";
+    status: TurnStatus;
+    error: {
+        message: string;
+        codexErrorInfo: JsonValue | null;
+        additionalDetails: string | null;
+    } | null;
+    startedAt: number | null;
+    completedAt: number | null;
+    durationMs: number | null;
+}
+export type ThreadStatus = {
+    type: "notLoaded";
+} | {
+    type: "idle";
+} | {
+    type: "systemError";
+} | {
+    type: "active";
+    activeFlags: string[];
+};
+export interface Thread {
+    id: string;
+    sessionId?: string;
+    forkedFromId: string | null;
+    parentThreadId?: string | null;
+    preview: string;
+    ephemeral: boolean;
+    modelProvider: string;
+    model?: string | null;
+    reasoningEffort?: string | null;
+    createdAt: number;
+    updatedAt: number;
+    recencyAt?: number | null;
+    status: ThreadStatus;
+    path: string | null;
+    cwd: string;
+    cliVersion: string;
+    source: any;
+    threadSource?: string | null;
+    agentNickname: string | null;
+    agentRole: string | null;
+    gitInfo: any;
+    name: string | null;
+    turns: Turn[];
+    [key: string]: unknown;
+}
+export interface TokenUsageBreakdown {
+    totalTokens: number;
+    inputTokens: number;
+    cachedInputTokens: number;
+    cacheWriteInputTokens: number;
+    outputTokens: number;
+    reasoningOutputTokens: number;
+}
+export interface RpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export declare class RpcFailure extends Error {
+    readonly code: number;
+    readonly data?: unknown | undefined;
+    readonly verbatim: boolean;
+    /** `verbatim`: the message names a switched thread's backend on purpose (not rewritten to its public id). */
+    constructor(code: number, message: string, data?: unknown | undefined, verbatim?: boolean);
+}
+/** The model a turn/start or settings update asks for (Desktop sends it in the collaboration mode, with model null). */
+export declare const requestedModel: (params: JsonObject) => unknown;
+export declare const invalidParams: (message: string) => RpcFailure;
+export declare const invalidRequest: (message: string) => RpcFailure;
+export declare const internalError: (message: string) => RpcFailure;
+export declare function rpcError(error: unknown): RpcError;

package/dist/protocol/codex.js

@@ -0,0 +1,25 @@
+// Hand-written subset of the Codex app-server v2 protocol: only the shapes the Claude layer emits.
+// No pins: tests validate emitted objects against the JSON schema of the installed codex.
+export class RpcFailure extends Error {
+    code;
+    data;
+    verbatim;
+    /** `verbatim`: the message names a switched thread's backend on purpose (not rewritten to its public id). */
+    constructor(code, message, data, verbatim = false) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.verbatim = verbatim;
+    }
+}
+/** The model a turn/start or settings update asks for (Desktop sends it in the collaboration mode, with model null). */
+export const requestedModel = (params) => params.model ?? params.collaborationMode?.settings?.model;
+export const invalidParams = (message) => new RpcFailure(-32602, message);
+export const invalidRequest = (message) => new RpcFailure(-32600, message);
+export const internalError = (message) => new RpcFailure(-32603, message);
+export function rpcError(error) {
+    if (error instanceof RpcFailure)
+        return { code: error.code, message: error.message, ...(error.data === undefined ? {} : { data: error.data }) };
+    return { code: -32603, message: error instanceof Error ? error.message : String(error) };
+}
+//# sourceMappingURL=codex.js.map

package/dist/protocol/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/protocol/codex.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,0FAA0F;AA2H1F,MAAM,OAAO,UAAW,SAAQ,KAAK;IAEA;IAA+C;IAAgC;IADlH,6GAA6G;IAC7G,YAAmC,IAAY,EAAE,OAAe,EAAkB,IAAc,EAAkB,WAAW,KAAK;QAChI,KAAK,CAAC,OAAO,CAAC,CAAC;QADkB,SAAI,GAAJ,IAAI,CAAQ;QAAmC,SAAI,GAAJ,IAAI,CAAU;QAAkB,aAAQ,GAAR,QAAQ,CAAQ;IAElI,CAAC;CACF;AAED,wHAAwH;AACxH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAW,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,iBAAiB,EAAE,QAAQ,EAAE,KAAK,CAAC;AAEzH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAElF,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IAChJ,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC3F,CAAC"}

package/dist/protocol/turnPagination.d.ts

@@ -1,17 +1,32 @@
-import type { ThreadItem } from "../codex/generated/v2/ThreadItem.js";
-import type { ThreadItemsListParams } from "../codex/generated/v2/ThreadItemsListParams.js";
-import type { ThreadItemsListResponse } from "../codex/generated/v2/ThreadItemsListResponse.js";
-import type { ThreadTurnsListParams } from "../codex/generated/v2/ThreadTurnsListParams.js";
-import type { ThreadTurnsListResponse } from "../codex/generated/v2/ThreadTurnsListResponse.js";
-import type { Turn } from "../codex/generated/v2/Turn.js";
+import { type ThreadItem, type Turn } from "./codex.js";
+interface TurnsListParams {
+    cursor?: string | null;
+    limit?: number | null;
+    sortDirection?: "asc" | "desc" | null;
+    itemsView?: "notLoaded" | "summary" | "full" | null;
+}
+interface ItemsListParams {
+    cursor?: string | null;
+    limit?: number | null;
+    sortDirection?: "asc" | "desc" | null;
+    turnId?: string | null;
+}
+interface Page<T> {
+    data: T[];
+    nextCursor: string | null;
+    backwardsCursor: string | null;
+}
 export declare function turnCursor(turnId: string, includeAnchor: boolean): string;
 export declare function itemCursor(itemId: string, includeAnchor: boolean): string;
 /** The agent item stock treats as a turn's final answer: latest final_answer, else a phase-less message on a finished turn. */
 export declare function finalAgentItem(turn: Turn): ThreadItem | undefined;
 /** `itemsView: "summary"`: the first user message and the final agent message, in rollout order. Stock's live view of a running turn shows its latest agent message regardless of phase. */
 export declare function summaryItems(turn: Turn): ThreadItem[];
-export declare function paginateTurns(turns: readonly Turn[], params: Omit<ThreadTurnsListParams, "threadId">, legacyPrefixes?: readonly string[]): ThreadTurnsListResponse;
-export declare function paginateItems(turns: readonly Turn[], params: Omit<ThreadItemsListParams, "threadId">, legacyPrefixes?: readonly string[]): ThreadItemsListResponse;
+export declare function paginateTurns(turns: readonly Turn[], params: TurnsListParams, legacyPrefixes?: readonly string[]): Page<Turn>;
+export declare function paginateItems(turns: readonly Turn[], params: ItemsListParams, legacyPrefixes?: readonly string[]): Page<{
+    turnId: string;
+    item: ThreadItem;
+}>;
 /** The turn shape stock returns from `turn/start` and announces in `turn/started`: no items, `notLoaded`; items follow via `item/started`. */
 export declare function startedTurn(turn: Turn): Turn;
 /** Top-level resume/read/revert cursors: point inclusively at the newest turn and item, like stock paginated threads. */
@@ -19,3 +34,4 @@ export declare function historyCursors(turns: readonly Turn[]): {
     turnsBackwardsCursor: string | null;
     itemsBackwardsCursor: string | null;
 };
+export {};

package/dist/protocol/turnPagination.js

@@ -1,4 +1,4 @@
-import { invalidRequest } from "./errors.js";
+import { invalidRequest } from "./codex.js";
 function encodeCursor(key, anchor, includeAnchor) {
     return JSON.stringify({ [key]: anchor, includeAnchor });
 }

package/dist/protocol/turnPagination.js.map

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

package/examples/config.toml

@@ -1,26 +1,6 @@
-# Packaged installs normally use their pinned Codex/Claude binaries and ~/.ccodex/state.
-# Override only when deliberately testing another executable or state location.
-# On macOS the local Codex App reaches ccodex via CODEX_CLI_PATH=~/.ccodex/bin/codex
-# (installed by `ccodex setup`); no config key is required for it.
-# app_server_codex = "/absolute/path/to/codex"
-# delegate_codex = "/absolute/path/to/stock/codex"
-# claude_binary = "/absolute/path/to/claude"
-# data_dir = "~/.ccodex/state"
-
-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
+# ~/.ccodex/config.toml — every key is optional.
 
-# Remove or comment out this key to restore stock Codex title generation.
+# Remove or comment out rename_prompt to restore stock Codex title generation.
 rename_prompt = """
 Create a concise, vivid, memorable title for the task.
 Start with exactly one rare, expressive, context-relevant emoji followed by one space.
@@ -28,14 +8,15 @@ Avoid generic decorative emoji when a more specific symbol fits.
 Keep the complete title, including emoji, within 36 characters.
 Return only the title.
 """
+# title_model = "gpt-6-luna"        # default: the first visible luna/mini Codex model
 
-# Optional status command interception. This does not affect provider routing or lifecycle.
-[features]
-status_command = true # intercept `/ccstatus`, `/ccstate`, and legacy status aliases without a model turn
-side_chat_promotion = true # allow Fork to promote a temporary `/side` chat into a durable sidebar thread
-optimistic_side_startup = true # open `/side` immediately while its provider context is prepared in the background
-interactive_questions = true # render Claude's structured questions as native Codex App controls
-claude_skills = true # expose Claude skills in Codex App's `$` autocomplete
+# codex_binary = "/path/to/codex"   # default: the first `codex` on PATH that is not CCodex
+# delegate_codex = "/path/to/codex" # what plain `codex …` (TUI, exec, login) runs; default: codex_binary
+# claude_binary = "/path/to/claude" # default: the Claude Code bundled with the Agent SDK
+# data_dir = "~/.ccodex/state"
+# model_prefix = "claude:"
 
-# No aliases are configured by default. Every `gpt-*` model id stays stock.
-# Current Codex Mobile selects Claude through namespaced `claude:*` catalog ids.
+log_level = "info"
+# Codex App RPC capture under data_dir (rpc.jsonl, mode 0600, rolling).
+rpc_capture = true
+rpc_capture_max_bytes = 1073741824