@sumicom/quicksave 0.8.2 → 0.8.4

package/dist/ai/codexAppServer/stdioTransport.js

@@ -0,0 +1,111 @@
+import { createInterface } from 'node:readline';
+/**
+ * Stdio transport for the codex `app-server` child process. Frames
+ * messages as JSONL on stdin/stdout — one JSON object per line.
+ *
+ * This wrapper is intentionally narrow: it does NOT spawn the child
+ * (that's `processManager.ts`) or run the JSON-RPC protocol (that's
+ * `rpcClient.ts`). It just translates between line-buffered JSON and
+ * structured messages.
+ */
+export class StdioTransport {
+    child;
+    messageListeners = new Set();
+    closeListeners = new Set();
+    closed = false;
+    /** Logger for parse failures and stderr lines. The default no-ops so
+     * tests stay quiet; real users should pass a console-bound logger. */
+    log;
+    constructor(child, opts = {}) {
+        if (!child.stdin || !child.stdout) {
+            throw new Error('StdioTransport requires a child process with stdin and stdout pipes');
+        }
+        this.child = child;
+        this.log = opts.log ?? { warn: () => { } };
+        const rl = createInterface({ input: child.stdout });
+        rl.on('line', (line) => this.handleLine(line));
+        rl.on('close', () => this.handleClose(null));
+        child.on('exit', (code, signal) => {
+            const reason = code === 0 || code === null
+                ? null
+                : new Error(`codex app-server exited with code=${code} signal=${signal ?? 'none'}`);
+            this.handleClose(reason);
+        });
+        child.on('error', (err) => this.handleClose(err));
+    }
+    async send(message) {
+        if (this.closed)
+            throw new Error('stdio transport closed');
+        const stdin = this.child.stdin;
+        if (!stdin || stdin.destroyed)
+            throw new Error('stdio transport stdin unavailable');
+        const line = JSON.stringify(message) + '\n';
+        return new Promise((resolve, reject) => {
+            stdin.write(line, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    onMessage(listener) {
+        this.messageListeners.add(listener);
+        return () => this.messageListeners.delete(listener);
+    }
+    onClose(listener) {
+        this.closeListeners.add(listener);
+        return () => this.closeListeners.delete(listener);
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.handleClose(null);
+        try {
+            this.child.stdin?.end();
+        }
+        catch {
+            // best-effort
+        }
+    }
+    handleLine(line) {
+        if (line.length === 0)
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (err) {
+            this.log.warn(`codex app-server: failed to parse JSON-RPC line: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        if (typeof parsed !== 'object' || parsed === null) {
+            this.log.warn(`codex app-server: ignoring non-object JSON-RPC line: ${typeof parsed}`);
+            return;
+        }
+        for (const l of this.messageListeners) {
+            try {
+                l(parsed);
+            }
+            catch {
+                // listeners must not throw; swallow.
+            }
+        }
+    }
+    handleClose(reason) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const l of this.closeListeners) {
+            try {
+                l(reason);
+            }
+            catch {
+                // swallow
+            }
+        }
+        this.messageListeners.clear();
+        this.closeListeners.clear();
+    }
+}
+//# sourceMappingURL=stdioTransport.js.map

package/dist/ai/codexAppServer/stdioTransport.js.map

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

package/dist/ai/codexAppServer/tokenAccounting.d.ts

@@ -0,0 +1,76 @@
+import type { CardStreamEnd } from '@sumicom/quicksave-shared';
+import type { ThreadTokenUsage } from './schema/generated/v2/ThreadTokenUsage.js';
+import type { ThreadTokenUsageUpdatedNotification } from './schema/generated/v2/ThreadTokenUsageUpdatedNotification.js';
+import type { TokenUsageBreakdown } from './schema/generated/v2/TokenUsageBreakdown.js';
+/**
+ * Cumulative seed loaded from `eventStore` on cold resume so per-turn
+ * deltas line up after a daemon restart. Mirrors the SDK provider's
+ * `loadCumulativeSeed` shape so we can swap providers without touching
+ * the eventStore round-trip.
+ */
+export interface CumulativeUsageSeed {
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens?: number;
+}
+/**
+ * Tracks `thread/tokenUsage/updated` notifications and produces the
+ * `tokenUsage` block for `CardStreamEnd` at `turn/completed` time.
+ *
+ * Key facts about v2's token usage model (verified against codex CLI
+ * 0.125.0 — see `docs/references/codex-app-server/implementation-plan.md`
+ * §11):
+ *
+ * - `ThreadTokenUsageUpdatedNotification.tokenUsage.last` is the
+ *   **per-turn delta** the server already computed. We pass it through
+ *   directly — no slice math required.
+ * - `tokenUsage.total` is the running thread-cumulative. We expose it
+ *   on `CardStreamEnd.tokenUsage.cumulative*` so the eventStore can
+ *   round-trip it for cold resumes.
+ * - The notification carries `turnId` so we can key updates per-turn
+ *   even when several arrive between `turn/started` and `turn/completed`.
+ *
+ * Ordering: typically the latest `thread/tokenUsage/updated` precedes
+ * `turn/completed` for that turn, but not always. The provider's run
+ * loop should `awaitFor(turnId)` briefly when finalizing — see
+ * `awaitTurnUsage()`.
+ */
+export declare class TokenAccounting {
+    /** Latest cumulative we believe the server has, regardless of which
+     * turn supplied it. Persisted to eventStore via the run path. */
+    private cumulative;
+    /** Latest `tokenUsage` payload keyed by turnId. */
+    private byTurn;
+    /** Pending awaiters waiting for a usage notification on a specific turn. */
+    private waiters;
+    seedFromLastTurn(seed: CumulativeUsageSeed | null | undefined): void;
+    /**
+     * Feed a `thread/tokenUsage/updated` notification. Updates the
+     * running cumulative and per-turn caches, and resolves any active
+     * waiters.
+     */
+    observe(notification: ThreadTokenUsageUpdatedNotification): void;
+    /**
+     * Wait for a `thread/tokenUsage/updated` notification carrying
+     * `turnId`. Resolves immediately if one was already observed.
+     * Resolves to `null` if `timeoutMs` elapses first (the run loop
+     * should still emit `CardStreamEnd` — better an empty usage block
+     * than a hung turn).
+     */
+    awaitTurnUsage(turnId: string, timeoutMs: number): Promise<ThreadTokenUsage | null>;
+    /** Drop any state for a turn — call after stream-end is emitted to
+     * keep the per-turn cache from growing unboundedly. */
+    releaseTurn(turnId: string): void;
+    /** Map a `ThreadTokenUsage` payload to the `CardStreamEnd.tokenUsage`
+     * shape. Returns undefined when the input is null. */
+    static toCardStreamEndUsage(usage: ThreadTokenUsage | null | undefined): CardStreamEnd['tokenUsage'];
+    /** Snapshot the running cumulative — used by the run path to
+     * persist `LastTurnInfo` after every successful turn end. */
+    snapshotCumulative(): CumulativeUsageSeed;
+}
+/** Build a synthetic `ThreadTokenUsage` from a per-turn breakdown plus
+ * a precomputed cumulative — used in tests. */
+export declare function makeUsage(last: TokenUsageBreakdown, total: TokenUsageBreakdown, modelContextWindow?: number | null): ThreadTokenUsage;
+/** Build a `TokenUsageBreakdown` literal — used in tests. */
+export declare function makeBreakdown(input: number, output: number, cachedInput?: number): TokenUsageBreakdown;
+//# sourceMappingURL=tokenAccounting.d.ts.map

package/dist/ai/codexAppServer/tokenAccounting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenAccounting.d.ts","sourceRoot":"","sources":["../../../src/ai/codexAppServer/tokenAccounting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,8DAA8D,CAAC;AACxH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAExF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAe;IAC1B;qEACiE;IACjE,OAAO,CAAC,UAAU,CAIhB;IAEF,mDAAmD;IACnD,OAAO,CAAC,MAAM,CAAuC;IAErD,4EAA4E;IAC5E,OAAO,CAAC,OAAO,CAA+D;IAE9E,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IASpE;;;;OAIG;IACH,OAAO,CAAC,YAAY,EAAE,mCAAmC,GAAG,IAAI;IAchE;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAuBnF;2DACuD;IACvD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKjC;0DACsD;IACtD,MAAM,CAAC,oBAAoB,CACzB,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GACzC,aAAa,CAAC,YAAY,CAAC;IAW9B;iEAC6D;IAC7D,kBAAkB,IAAI,mBAAmB;CAG1C;AAED;+CAC+C;AAC/C,wBAAgB,SAAS,CACvB,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,mBAAmB,EAC1B,kBAAkB,GAAE,MAAM,GAAG,IAAW,GACvC,gBAAgB,CAElB;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,mBAAmB,CAQjG"}

package/dist/ai/codexAppServer/tokenAccounting.js

@@ -0,0 +1,135 @@
+/**
+ * Tracks `thread/tokenUsage/updated` notifications and produces the
+ * `tokenUsage` block for `CardStreamEnd` at `turn/completed` time.
+ *
+ * Key facts about v2's token usage model (verified against codex CLI
+ * 0.125.0 — see `docs/references/codex-app-server/implementation-plan.md`
+ * §11):
+ *
+ * - `ThreadTokenUsageUpdatedNotification.tokenUsage.last` is the
+ *   **per-turn delta** the server already computed. We pass it through
+ *   directly — no slice math required.
+ * - `tokenUsage.total` is the running thread-cumulative. We expose it
+ *   on `CardStreamEnd.tokenUsage.cumulative*` so the eventStore can
+ *   round-trip it for cold resumes.
+ * - The notification carries `turnId` so we can key updates per-turn
+ *   even when several arrive between `turn/started` and `turn/completed`.
+ *
+ * Ordering: typically the latest `thread/tokenUsage/updated` precedes
+ * `turn/completed` for that turn, but not always. The provider's run
+ * loop should `awaitFor(turnId)` briefly when finalizing — see
+ * `awaitTurnUsage()`.
+ */
+export class TokenAccounting {
+    /** Latest cumulative we believe the server has, regardless of which
+     * turn supplied it. Persisted to eventStore via the run path. */
+    cumulative = {
+        inputTokens: 0,
+        outputTokens: 0,
+        cachedInputTokens: 0,
+    };
+    /** Latest `tokenUsage` payload keyed by turnId. */
+    byTurn = new Map();
+    /** Pending awaiters waiting for a usage notification on a specific turn. */
+    waiters = new Map();
+    seedFromLastTurn(seed) {
+        if (!seed)
+            return;
+        this.cumulative = {
+            inputTokens: seed.inputTokens,
+            outputTokens: seed.outputTokens,
+            cachedInputTokens: seed.cachedInputTokens ?? 0,
+        };
+    }
+    /**
+     * Feed a `thread/tokenUsage/updated` notification. Updates the
+     * running cumulative and per-turn caches, and resolves any active
+     * waiters.
+     */
+    observe(notification) {
+        this.byTurn.set(notification.turnId, notification.tokenUsage);
+        this.cumulative = {
+            inputTokens: notification.tokenUsage.total.inputTokens,
+            outputTokens: notification.tokenUsage.total.outputTokens,
+            cachedInputTokens: notification.tokenUsage.total.cachedInputTokens,
+        };
+        const ws = this.waiters.get(notification.turnId);
+        if (ws) {
+            this.waiters.delete(notification.turnId);
+            for (const w of ws)
+                w(notification.tokenUsage);
+        }
+    }
+    /**
+     * Wait for a `thread/tokenUsage/updated` notification carrying
+     * `turnId`. Resolves immediately if one was already observed.
+     * Resolves to `null` if `timeoutMs` elapses first (the run loop
+     * should still emit `CardStreamEnd` — better an empty usage block
+     * than a hung turn).
+     */
+    awaitTurnUsage(turnId, timeoutMs) {
+        const cached = this.byTurn.get(turnId);
+        if (cached)
+            return Promise.resolve(cached);
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                const arr = this.waiters.get(turnId);
+                if (arr) {
+                    const idx = arr.indexOf(onUsage);
+                    if (idx >= 0)
+                        arr.splice(idx, 1);
+                    if (arr.length === 0)
+                        this.waiters.delete(turnId);
+                }
+                resolve(null);
+            }, timeoutMs);
+            const onUsage = (usage) => {
+                clearTimeout(timer);
+                resolve(usage);
+            };
+            const arr = this.waiters.get(turnId) ?? [];
+            arr.push(onUsage);
+            this.waiters.set(turnId, arr);
+        });
+    }
+    /** Drop any state for a turn — call after stream-end is emitted to
+     * keep the per-turn cache from growing unboundedly. */
+    releaseTurn(turnId) {
+        this.byTurn.delete(turnId);
+        this.waiters.delete(turnId);
+    }
+    /** Map a `ThreadTokenUsage` payload to the `CardStreamEnd.tokenUsage`
+     * shape. Returns undefined when the input is null. */
+    static toCardStreamEndUsage(usage) {
+        if (!usage)
+            return undefined;
+        return {
+            input: usage.last.inputTokens,
+            output: usage.last.outputTokens,
+            cumulativeInput: usage.total.inputTokens,
+            cumulativeOutput: usage.total.outputTokens,
+            cumulativeCachedInput: usage.total.cachedInputTokens,
+        };
+    }
+    /** Snapshot the running cumulative — used by the run path to
+     * persist `LastTurnInfo` after every successful turn end. */
+    snapshotCumulative() {
+        return { ...this.cumulative };
+    }
+}
+/** Build a synthetic `ThreadTokenUsage` from a per-turn breakdown plus
+ * a precomputed cumulative — used in tests. */
+export function makeUsage(last, total, modelContextWindow = null) {
+    return { last, total, modelContextWindow };
+}
+/** Build a `TokenUsageBreakdown` literal — used in tests. */
+export function makeBreakdown(input, output, cachedInput = 0) {
+    return {
+        totalTokens: input + output,
+        inputTokens: input,
+        cachedInputTokens: cachedInput,
+        outputTokens: output,
+        reasoningOutputTokens: 0,
+    };
+}
+//# sourceMappingURL=tokenAccounting.js.map

package/dist/ai/codexAppServer/tokenAccounting.js.map

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

package/dist/ai/codexAppServer/version.d.ts

@@ -0,0 +1,7 @@
+/** Codex CLI version that the vendored schema under
+ * `schema/generated/` was generated from. The schema must be
+ * regenerated (see `apps/agent/scripts/regen-codex-schema.sh`)
+ * whenever this is bumped. ProcessManager warns if the running CLI
+ * differs by minor or major. */
+export declare const CODEX_SCHEMA_PINNED_VERSION = "0.125.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/ai/codexAppServer/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/ai/codexAppServer/version.ts"],"names":[],"mappings":"AAAA;;;;gCAIgC;AAChC,eAAO,MAAM,2BAA2B,YAAY,CAAC"}

package/dist/ai/codexAppServer/version.js

@@ -0,0 +1,7 @@
+/** Codex CLI version that the vendored schema under
+ * `schema/generated/` was generated from. The schema must be
+ * regenerated (see `apps/agent/scripts/regen-codex-schema.sh`)
+ * whenever this is bumped. ProcessManager warns if the running CLI
+ * differs by minor or major. */
+export const CODEX_SCHEMA_PINNED_VERSION = '0.125.0';
+//# sourceMappingURL=version.js.map

package/dist/ai/codexAppServer/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/ai/codexAppServer/version.ts"],"names":[],"mappings":"AAAA;;;;gCAIgC;AAChC,MAAM,CAAC,MAAM,2BAA2B,GAAG,SAAS,CAAC"}

package/dist/ai/enrichEntry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enrichEntry.d.ts","sourceRoot":"","sources":["../../src/ai/enrichEntry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAErB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAGnC;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAgB9E"}
+{"version":3,"file":"enrichEntry.d.ts","sourceRoot":"","sources":["../../src/ai/enrichEntry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAErB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAGnC;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAiB9E"}

package/dist/ai/enrichEntry.js

@@ -15,6 +15,7 @@ export function enrichEntry(entry) {
         ...entry,
         lastPromptAt: stats.lastPromptAt ?? undefined,
         lastTurnEndedAt: stats.lastTurnEndedAt ?? undefined,
+        lastCacheTouchAt: stats.lastCacheTouchAt ?? undefined,
         turnCount: stats.turnCount || undefined,
         totalInputTokens: stats.totalInputTokens || undefined,
         totalOutputTokens: stats.totalOutputTokens || undefined,

package/dist/ai/enrichEntry.js.map

@@ -1 +1 @@
-{"version":3,"file":"enrichEntry.js","sourceRoot":"","sources":["../../src/ai/enrichEntry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,KAA2B;IACrD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO;QACL,GAAG,KAAK;QACR,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,SAAS;QAC7C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,SAAS;QACnD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS;QACvC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,SAAS;QACrD,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,SAAS;QACvD,mBAAmB,EAAE,QAAQ,EAAE,WAAW;QAC1C,2BAA2B,EAAE,QAAQ,EAAE,mBAAmB;QAC1D,uBAAuB,EAAE,QAAQ,EAAE,eAAe;QAClD,oBAAoB,EAAE,QAAQ,EAAE,YAAiD;KAClF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"enrichEntry.js","sourceRoot":"","sources":["../../src/ai/enrichEntry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,KAA2B;IACrD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO;QACL,GAAG,KAAK;QACR,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,SAAS;QAC7C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,SAAS;QACnD,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,SAAS;QACrD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS;QACvC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,SAAS;QACrD,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,SAAS;QACvD,mBAAmB,EAAE,QAAQ,EAAE,WAAW;QAC1C,2BAA2B,EAAE,QAAQ,EAAE,mBAAmB;QAC1D,uBAAuB,EAAE,QAAQ,EAAE,eAAe;QAClD,oBAAoB,EAAE,QAAQ,EAAE,YAAiD;KAClF,CAAC;AACJ,CAAC"}

package/dist/ai/provider.d.ts

@@ -1,6 +1,16 @@
 import type { AgentId, CardEvent, CardStreamEnd, ContextUsageBreakdown } from '@sumicom/quicksave-shared';
 import type { StreamCardBuilder } from './cardBuilder.js';
-export type PermissionLevel = 'bypassPermissions' | 'acceptEdits' | 'default' | 'plan' | 'auto';
+export declare const CLAUDE_PERMISSION_MODES: readonly ["default", "acceptEdits", "bypassPermissions", "plan", "auto"];
+export declare const CODEX_PERMISSION_PRESETS: readonly ["read-only", "default", "auto-review", "full-access"];
+export type ClaudePermissionMode = typeof CLAUDE_PERMISSION_MODES[number];
+export type CodexPermissionPreset = typeof CODEX_PERMISSION_PRESETS[number];
+export type PermissionLevel = ClaudePermissionMode | CodexPermissionPreset;
+export declare function isClaudePermissionMode(value: unknown): value is ClaudePermissionMode;
+export declare function isCodexPermissionPreset(value: unknown): value is CodexPermissionPreset;
+export declare function defaultPermissionLevelForAgent(agentId: AgentId): PermissionLevel;
+export declare function isPermissionLevelAcceptedForAgent(agentId: AgentId, value: unknown): boolean;
+export declare function normalizePermissionLevelForAgent(agentId: AgentId, value: unknown): PermissionLevel;
+export declare function isFullAccessPermission(agentId: AgentId, level: PermissionLevel): boolean;
 export type ProviderHistoryMode = 'claude-jsonl' | 'memory';
 /** Represents a running provider session. */
 export interface ProviderSession {
@@ -32,6 +42,13 @@ export interface ProviderCallbacks {
      * so daemon-side side effects (e.g. UpdateSessionStatus persistence) must be
      * driven from this hook, not handlePermissionRequest. */
     onToolUse?(sessionId: string, toolName: string, toolInput: Record<string, unknown>): void;
+    /** Fired whenever the provider observes an SDK message whose `usage` indicates
+     * a cache hit or write (`cache_creation_input_tokens > 0` or
+     * `cache_read_input_tokens > 0`). Each fire effectively means "Anthropic just
+     * touched the cache for this session", which is the precise event that
+     * resets the 5-minute (or 1h) cache TTL on the server. SessionManager uses
+     * this to anchor the PWA's countdown without waiting for the turn to end. */
+    onCacheTouch?(sessionId: string): void;
     onModelDetected(model: string): void;
     /** Fired when the underlying provider process has fully exited. SessionManager
      * uses this to remove the session from its in-memory map and emit
@@ -48,6 +65,16 @@ export interface StartSessionOpts {
     permissionLevel: PermissionLevel;
     sandboxed: boolean;
     systemPrompt?: string;
+    /** Per-session reasoning depth. Currently only the Codex provider honors
+     *  this — it maps to the SDK's `modelReasoningEffort` (minimal/low/medium/
+     *  high/xhigh). Claude providers ignore it (their depth is decided by the
+     *  model variant, not a per-turn knob). */
+    reasoningEffort?: string;
+    /** Auto-compact ceiling for Claude Code (200k / 500k / 1M). Only the
+     *  Claude CLI provider honors this — it sets `CLAUDE_CODE_AUTO_COMPACT_WINDOW`
+     *  on the spawn env and appends the `[1m]` model suffix when the value
+     *  exceeds 200k (which enables the API's 1M context beta). Codex ignores. */
+    contextWindow?: number;
     /** Absolute path to the daemon-owned sentinel file the CLI's PermissionRequest
      *  hook consults to auto-approve every tool. Presence of the file means bypass
      *  is active. Only ClaudeCliProvider uses it; other providers ignore it. */
@@ -62,6 +89,8 @@ export interface ResumeSessionOpts {
     permissionLevel: PermissionLevel;
     sandboxed: boolean;
     systemPrompt?: string;
+    reasoningEffort?: string;
+    contextWindow?: number;
     bypassFlagPath?: string;
 }
 export interface CodingAgentProvider {

package/dist/ai/provider.d.ts.map

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

package/dist/ai/provider.js

@@ -1,2 +1,57 @@
-export {};
+export const CLAUDE_PERMISSION_MODES = [
+    'default',
+    'acceptEdits',
+    'bypassPermissions',
+    'plan',
+    'auto',
+];
+export const CODEX_PERMISSION_PRESETS = [
+    'read-only',
+    'default',
+    'auto-review',
+    'full-access',
+];
+export function isClaudePermissionMode(value) {
+    return typeof value === 'string' && CLAUDE_PERMISSION_MODES.includes(value);
+}
+export function isCodexPermissionPreset(value) {
+    return typeof value === 'string' && CODEX_PERMISSION_PRESETS.includes(value);
+}
+export function defaultPermissionLevelForAgent(agentId) {
+    return agentId === 'codex' ? 'default' : 'acceptEdits';
+}
+export function isPermissionLevelAcceptedForAgent(agentId, value) {
+    if (agentId === 'codex') {
+        return isCodexPermissionPreset(value)
+            || value === 'bypassPermissions'
+            || value === 'plan'
+            || value === 'auto'
+            || value === 'acceptEdits';
+    }
+    return isClaudePermissionMode(value);
+}
+export function normalizePermissionLevelForAgent(agentId, value) {
+    if (agentId === 'codex') {
+        if (isCodexPermissionPreset(value))
+            return value;
+        // Compatibility for sessions created before Codex had first-class presets.
+        if (value === 'bypassPermissions')
+            return 'full-access';
+        if (value === 'plan')
+            return 'read-only';
+        if (value === 'auto')
+            return 'auto-review';
+        if (value === 'acceptEdits')
+            return 'default';
+        return defaultPermissionLevelForAgent(agentId);
+    }
+    if (isClaudePermissionMode(value))
+        return value;
+    return defaultPermissionLevelForAgent(agentId);
+}
+export function isFullAccessPermission(agentId, level) {
+    return agentId === 'codex'
+        ? level === 'full-access'
+        : level === 'bypassPermissions';
+}
 //# sourceMappingURL=provider.js.map

package/dist/ai/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/ai/provider.ts"],"names":[],"mappings":""}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/ai/provider.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS;IACT,aAAa;IACb,mBAAmB;IACnB,MAAM;IACN,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,WAAW;IACX,SAAS;IACT,aAAa;IACb,aAAa;CACL,CAAC;AAMX,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,uBAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,wBAA8C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAgB;IAC7D,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,OAAgB,EAAE,KAAc;IAChF,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,uBAAuB,CAAC,KAAK,CAAC;eAChC,KAAK,KAAK,mBAAmB;eAC7B,KAAK,KAAK,MAAM;eAChB,KAAK,KAAK,MAAM;eAChB,KAAK,KAAK,aAAa,CAAC;IAC/B,CAAC;IACD,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAAgB,EAChB,KAAc;IAEd,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,IAAI,uBAAuB,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACjD,2EAA2E;QAC3E,IAAI,KAAK,KAAK,mBAAmB;YAAE,OAAO,aAAa,CAAC;QACxD,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,WAAW,CAAC;QACzC,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,aAAa,CAAC;QAC3C,IAAI,KAAK,KAAK,aAAa;YAAE,OAAO,SAAS,CAAC;QAC9C,OAAO,8BAA8B,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,sBAAsB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,8BAA8B,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,KAAsB;IAC7E,OAAO,OAAO,KAAK,OAAO;QACxB,CAAC,CAAC,KAAK,KAAK,aAAa;QACzB,CAAC,CAAC,KAAK,KAAK,mBAAmB,CAAC;AACpC,CAAC"}

package/dist/ai/sandboxMcpStdio.js

@@ -15,7 +15,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { execFileSync } from 'child_process';
-import { realpathSync, existsSync, readFileSync } from 'fs';
+import { realpathSync, existsSync, readFileSync, writeFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { homedir, platform } from 'os';
 import { fileURLToPath } from 'url';
@@ -34,6 +34,7 @@ const quicksaveHome = process.env.QUICKSAVE_HOME || join(homedir(), '.quicksave'
 const sessionRegistryDir = join(quicksaveHome, 'state', 'session-registry');
 /** Same encoding as `apps/agent/src/ai/sessionRegistry.ts:encodeProjectPath`. */
 const encodedCwd = cwd.replace(/\//g, '-');
+const SESSION_NOTE_HISTORY_CAP = 50;
 const PROFILE_PATH = join(__ownDir, 'profiles', 'project-sandbox.sb');
 function detectBackend() {
     const os = platform();
@@ -92,6 +93,10 @@ server.tool('SandboxBash', 'Execute a shell command WITHOUT requiring user permi
     'Ideal for builds, tests, linters, file edits, and any project-scoped command.', {
     command: z.string().describe('The shell command to execute'),
     timeout: z.number().optional().describe('Timeout in milliseconds (default: 120000)'),
+}, {
+    readOnlyHint: false,
+    destructiveHint: false,
+    openWorldHint: false,
 }, async (args) => {
     if (!backend) {
         const os = platform();
@@ -145,6 +150,57 @@ function readStoredStatus() {
         return empty;
     }
 }
+function sessionRegistryPath() {
+    if (!sessionIdHint)
+        return null;
+    return join(sessionRegistryDir, encodedCwd, `${sessionIdHint}.json`);
+}
+function isSessionStage(value) {
+    return value === 'investigating' ||
+        value === 'working' ||
+        value === 'verifying' ||
+        value === 'done';
+}
+function writeStoredStatus(args) {
+    const path = sessionRegistryPath();
+    if (!path || !existsSync(path))
+        return;
+    let entry;
+    try {
+        entry = JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return;
+    }
+    let changed = false;
+    if (typeof args.subject === 'string' && args.subject.length > 0) {
+        entry.title = args.subject;
+        changed = true;
+    }
+    if (typeof args.stage === 'string' && isSessionStage(args.stage)) {
+        entry.stage = args.stage;
+        changed = true;
+    }
+    if (typeof args.blocked === 'boolean') {
+        entry.blocked = args.blocked;
+        changed = true;
+    }
+    if (typeof args.note === 'string' && args.note.length > 0) {
+        entry.note = args.note;
+        const prior = Array.isArray(entry.noteHistory)
+            ? entry.noteHistory
+            : [];
+        const next = [...prior, { ts: Date.now(), text: args.note }];
+        entry.noteHistory = next.length > SESSION_NOTE_HISTORY_CAP
+            ? next.slice(next.length - SESSION_NOTE_HISTORY_CAP)
+            : next;
+        changed = true;
+    }
+    if (!changed)
+        return;
+    entry.lastAccessedAt = Date.now();
+    writeFileSync(path, JSON.stringify(entry, null, 2));
+}
 server.tool('UpdateSessionStatus', 'Update the ticket-style status for the current session, shown to the user on the home screen.\n' +
     '\n' +
     'Call at the START of every session (first response), and again whenever stage changes, ' +
@@ -193,14 +249,19 @@ server.tool('UpdateSessionStatus', 'Update the ticket-style status for the curre
     blocked: z.boolean().optional().describe('True when stuck, false when unblocked'),
     note: z.string().optional()
         .describe('One progress/finding entry (~12 words). Appended to the session event log; emit on each meaningful state change.'),
+}, {
+    readOnlyHint: false,
+    destructiveHint: false,
+    openWorldHint: false,
 }, async (args) => {
     const isDryRun = args.subject === undefined &&
         args.stage === undefined &&
         args.blocked === undefined &&
         args.note === undefined;
-    // Daemon-side `shouldAutoApprove` has already persisted any updates by the
-    // time this handler runs, so re-reading the registry file yields the final
-    // merged state for both dry-run and write paths.
+    // Codex MCP approval mode "approve" bypasses the daemon permission callback,
+    // so this stdio server owns persistence when it has a session-id hint.
+    if (!isDryRun)
+        writeStoredStatus(args);
     const snapshot = readStoredStatus();
     const header = isDryRun
         ? (snapshot.source === 'stored' ? 'Current session status (dry-run read):' : 'No stored status for this session yet.')