instar 0.28.113 → 0.28.115

package/dist/providers/adapters/openai-codex/integration/sessionResumeIndex.js

@@ -0,0 +1,120 @@
+/**
+ * SessionResumeIndex implementation for openai-codex.
+ *
+ * Codex rollouts live at $CODEX_HOME/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl
+ * with a SQLite index at `sqlite_home` (per the deep-dive). This adapter
+ * walks the filesystem directly; the SQLite index is a Phase 5 optimization.
+ *
+ * `codex resume --last` / `codex resume --all` are the CLI-side picker
+ * surfaces; this primitive exposes a programmatic equivalent.
+ */
+import { promises as fs } from 'node:fs';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { UnsupportedCapabilityError } from '../../../errors.js';
+import { OPENAI_CODEX_ID } from '../errors.js';
+import { listAllRollouts, findRolloutFile } from '../observability/sessionPaths.js';
+import { syntheticHandleForThread, bindCodexThreadId } from '../observability/sessionId.js';
+function uuidFromFilename(filename) {
+    const m = filename.match(/rollout-[^-]+-(.+)\.jsonl$/);
+    return m?.[1] ?? null;
+}
+async function readSummary(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        let projectRoot;
+        let turnCount = 0;
+        let firstUserMessage;
+        for (const line of content.split('\n')) {
+            if (!line.trim())
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed['cwd'] && !projectRoot)
+                    projectRoot = String(parsed['cwd']);
+                const type = String(parsed['type'] ?? '');
+                if (type === 'turn.started' || type === 'turn.completed')
+                    turnCount++;
+                if (!firstUserMessage && type === 'item.completed') {
+                    const item = parsed['item'];
+                    if (item?.['type'] === 'user_message') {
+                        firstUserMessage = String(item['text'] ?? '').slice(0, 200);
+                    }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return { projectRoot, turnCount, summary: firstUserMessage };
+    }
+    catch {
+        return {};
+    }
+}
+class OpenAiCodexSessionResumeIndex {
+    config;
+    capability = CapabilityFlag.SessionResumeIndex;
+    constructor(config) {
+        this.config = config;
+    }
+    async findById(providerSessionId, _options) {
+        const file = await findRolloutFile(providerSessionId, this.config.codexHome);
+        if (!file)
+            return null;
+        const meta = await readSummary(file);
+        const stat = await fs.stat(file);
+        return {
+            providerSessionId,
+            projectRoot: meta.projectRoot,
+            lastActiveAt: new Date(stat.mtimeMs).toISOString(),
+            turnCount: meta.turnCount,
+            summary: meta.summary,
+            providerSpecific: { [OPENAI_CODEX_ID]: { rolloutPath: file } },
+        };
+    }
+    async findRecent(options) {
+        const limit = options?.limit ?? 10;
+        const rollouts = await listAllRollouts(this.config.codexHome, limit * 3);
+        const out = [];
+        const cutoff = options?.maxAgeMs ? Date.now() - options.maxAgeMs : 0;
+        for (const r of rollouts) {
+            if (r.mtime < cutoff)
+                continue;
+            const uuid = uuidFromFilename(r.path);
+            if (!uuid)
+                continue;
+            const meta = await readSummary(r.path);
+            if (options?.projectRoot && meta.projectRoot !== options.projectRoot)
+                continue;
+            out.push({
+                providerSessionId: uuid,
+                projectRoot: meta.projectRoot,
+                lastActiveAt: new Date(r.mtime).toISOString(),
+                turnCount: meta.turnCount,
+                summary: meta.summary,
+                providerSpecific: { [OPENAI_CODEX_ID]: { rolloutPath: r.path } },
+            });
+            if (out.length >= limit)
+                break;
+        }
+        return out;
+    }
+    async listByProject(projectRoot, options) {
+        return this.findRecent({ projectRoot, limit: 100, signal: options?.signal });
+    }
+    async resume(providerSessionId, options) {
+        if (options?.fromTurnIndex !== undefined) {
+            // Codex supports thread/rollback via app-server; the headless `codex
+            // resume` CLI path is "latest turn." Surface as unsupported until we
+            // wire the app-server path in Phase 5.
+            throw new UnsupportedCapabilityError(CapabilityFlag.SessionResumeIndex, OPENAI_CODEX_ID);
+        }
+        const handle = syntheticHandleForThread(providerSessionId);
+        bindCodexThreadId(handle, providerSessionId);
+        return handle;
+    }
+}
+export function createSessionResumeIndex(config) {
+    return new OpenAiCodexSessionResumeIndex(config);
+}
+//# sourceMappingURL=sessionResumeIndex.js.map

package/dist/providers/adapters/openai-codex/integration/sessionResumeIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionResumeIndex.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/integration/sessionResumeIndex.ts"],"names":[],"mappings":"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"}

package/dist/providers/adapters/openai-codex/models.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Model-tier resolution for openai-codex.
+ *
+ * Maps the canonical ModelTier ('fast' | 'balanced' | 'capable') onto a
+ * concrete OpenAI/Codex model name. Per the deep-dive (02-codex-deep-
+ * dive.md), Codex uses `--model <name>` to select. ChatGPT-subscription
+ * auth restricts available models; OPENAI_API_KEY mode opens the full
+ * surface.
+ */
+import type { ModelTier } from '../../types.js';
+/**
+ * Resolve a tier or raw model string to a concrete model name to pass to
+ * the codex CLI. If `tierOrModel` doesn't match a known tier, it's
+ * returned verbatim (treated as a raw model name).
+ */
+export declare function resolveCliModelFlag(tierOrModel: string | ModelTier | undefined): string;
+//# sourceMappingURL=models.d.ts.map

package/dist/providers/adapters/openai-codex/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../../src/providers/adapters/openai-codex/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAwChD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAMvF"}

package/dist/providers/adapters/openai-codex/models.js

@@ -0,0 +1,60 @@
+/**
+ * Model-tier resolution for openai-codex.
+ *
+ * Maps the canonical ModelTier ('fast' | 'balanced' | 'capable') onto a
+ * concrete OpenAI/Codex model name. Per the deep-dive (02-codex-deep-
+ * dive.md), Codex uses `--model <name>` to select. ChatGPT-subscription
+ * auth restricts available models; OPENAI_API_KEY mode opens the full
+ * surface.
+ */
+/**
+ * Default tier-to-name map. Callers can override per-call via
+ * OneShotCompletionOptions.model or AgenticSessionHeadlessOptions.model
+ * (which accepts either a tier name or a raw model name).
+ *
+ * Model availability on the ChatGPT subscription auth path differs from
+ * OPENAI_API_KEY auth. Per OpenAI Community thread 1378986 (referenced
+ * 2026-05-15), several `-codex` suffixed model names were retired from
+ * ChatGPT accounts on 2026-04-14 and are API-only now. Empirically
+ * probed 2026-05-15 against Justin's ChatGPT Plus subscription via
+ * codex-cli 0.130.0:
+ *
+ *   ✅ working on ChatGPT account:  gpt-5.2, gpt-5.3-codex, gpt-5.4
+ *   ❌ rejected on ChatGPT account: gpt-5, gpt-5-codex, gpt-5.2-codex
+ *                                   (Codex CLI's default), gpt-5.3, gpt-5.4-codex
+ *
+ * Default tier choices below favor the subscription path:
+ *   - fast:     gpt-5.2 (cheapest working, plain ChatGPT model)
+ *   - balanced: gpt-5.3-codex (coding-specialist tier)
+ *   - capable:  gpt-5.4 (most powerful; burns ~20x more quota per
+ *                forum reports, use sparingly)
+ *
+ * Callers on the API-key path can override these per-call to access the
+ * full model surface (gpt-5-codex, etc.) by passing a raw model name
+ * instead of a tier.
+ *
+ * Drift risk: model availability changes regularly. This map is a
+ * Rule-3 surface and the codex event-normalizer canary catches the
+ * resulting upstream errors (auth-classified error events), but the
+ * authoritative-name check belongs in a dedicated canary — Phase 5
+ * follow-up.
+ */
+const TIER_TO_MODEL = {
+    fast: 'gpt-5.2',
+    balanced: 'gpt-5.3-codex',
+    capable: 'gpt-5.4',
+};
+/**
+ * Resolve a tier or raw model string to a concrete model name to pass to
+ * the codex CLI. If `tierOrModel` doesn't match a known tier, it's
+ * returned verbatim (treated as a raw model name).
+ */
+export function resolveCliModelFlag(tierOrModel) {
+    if (!tierOrModel)
+        return TIER_TO_MODEL.balanced;
+    if (tierOrModel in TIER_TO_MODEL) {
+        return TIER_TO_MODEL[tierOrModel];
+    }
+    return tierOrModel;
+}
+//# sourceMappingURL=models.js.map

package/dist/providers/adapters/openai-codex/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/providers/adapters/openai-codex/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,aAAa,GAA8B;IAC/C,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAA2C;IAC7E,IAAI,CAAC,WAAW;QAAE,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChD,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;QACjC,OAAO,aAAa,CAAC,WAAwB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/providers/adapters/openai-codex/observability/conversationLogReader.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ConversationLogReader implementation for openai-codex.
+ *
+ * Reads Codex's per-session rollout JSONL at $CODEX_HOME/sessions/YYYY/MM/
+ * DD/rollout-<ts>-<uuid>.jsonl and normalizes its events to CanonicalEvent
+ * via the same eventNormalizer the live agentic session uses.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (degraded triage / resume)
+ *   Frequency:   per-session-end / per-replay
+ *   Stability:   semi-stable (Codex changes rollout schema occasionally)
+ *   Fallback:    skip unparseable lines, emit ProviderRaw for unknown event types
+ *   Verdict:     deterministic JSON parse via shared normalizer + canary
+ */
+import type { ConversationLogReader } from '../../../primitives/observability/conversationLogReader.js';
+import type { OpenAiCodexConfig } from '../config.js';
+export declare function createConversationLogReader(config: OpenAiCodexConfig): ConversationLogReader;
+//# sourceMappingURL=conversationLogReader.d.ts.map

package/dist/providers/adapters/openai-codex/observability/conversationLogReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogReader.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/conversationLogReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,4DAA4D,CAAC;AAIpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAoEtD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CAE5F"}

package/dist/providers/adapters/openai-codex/observability/conversationLogReader.js

@@ -0,0 +1,93 @@
+/**
+ * ConversationLogReader implementation for openai-codex.
+ *
+ * Reads Codex's per-session rollout JSONL at $CODEX_HOME/sessions/YYYY/MM/
+ * DD/rollout-<ts>-<uuid>.jsonl and normalizes its events to CanonicalEvent
+ * via the same eventNormalizer the live agentic session uses.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (degraded triage / resume)
+ *   Frequency:   per-session-end / per-replay
+ *   Stability:   semi-stable (Codex changes rollout schema occasionally)
+ *   Fallback:    skip unparseable lines, emit ProviderRaw for unknown event types
+ *   Verdict:     deterministic JSON parse via shared normalizer + canary
+ */
+import { promises as fs } from 'node:fs';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { createSessionId } from './sessionId.js';
+import { findRolloutFile } from './sessionPaths.js';
+import { normalizeCodexJsonlEvent } from './eventNormalizer.js';
+async function* parseRollout(filePath) {
+    let content;
+    try {
+        content = await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    for (const line of content.split('\n')) {
+        if (!line.trim())
+            continue;
+        const ev = normalizeCodexJsonlEvent(line);
+        if (ev)
+            yield ev;
+    }
+}
+class OpenAiCodexConversationLogReader {
+    config;
+    capability = CapabilityFlag.ConversationLogReader;
+    constructor(config) {
+        this.config = config;
+    }
+    async read(session, options) {
+        const threadId = await createSessionId().providerIdFor(session);
+        if (!threadId)
+            return [];
+        const file = await findRolloutFile(threadId, this.config.codexHome);
+        if (!file)
+            return [];
+        const out = [];
+        for await (const ev of parseRollout(file)) {
+            if (options?.types && !options.types.includes(ev.type))
+                continue;
+            if (options?.since && ev.timestamp < options.since)
+                continue;
+            if (options?.until && ev.timestamp > options.until)
+                continue;
+            out.push(ev);
+            if (options?.limit && out.length >= options.limit)
+                break;
+        }
+        return out;
+    }
+    readStream(session, options) {
+        const cfg = this.config;
+        return {
+            async *[Symbol.asyncIterator]() {
+                const threadId = await createSessionId().providerIdFor(session);
+                if (!threadId)
+                    return;
+                const file = await findRolloutFile(threadId, cfg.codexHome);
+                if (!file)
+                    return;
+                let count = 0;
+                for await (const ev of parseRollout(file)) {
+                    if (options?.types && !options.types.includes(ev.type))
+                        continue;
+                    if (options?.since && ev.timestamp < options.since)
+                        continue;
+                    if (options?.until && ev.timestamp > options.until)
+                        continue;
+                    yield ev;
+                    count++;
+                    if (options?.limit && count >= options.limit)
+                        return;
+                }
+            },
+        };
+    }
+}
+export function createConversationLogReader(config) {
+    return new OpenAiCodexConversationLogReader(config);
+}
+//# sourceMappingURL=conversationLogReader.js.map

package/dist/providers/adapters/openai-codex/observability/conversationLogReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogReader.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/conversationLogReader.ts"],"names":[],"mappings":"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"}

package/dist/providers/adapters/openai-codex/observability/conversationLogTailer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ConversationLogTailer implementation for openai-codex.
+ *
+ * Polls the rollout JSONL file for appended lines and emits normalized
+ * events. Same drift surface as ConversationLogReader; canary coverage is
+ * shared.
+ */
+import type { ConversationLogTailer } from '../../../primitives/observability/conversationLogTailer.js';
+import type { OpenAiCodexConfig } from '../config.js';
+export declare function createConversationLogTailer(config: OpenAiCodexConfig): ConversationLogTailer;
+//# sourceMappingURL=conversationLogTailer.d.ts.map

package/dist/providers/adapters/openai-codex/observability/conversationLogTailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogTailer.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/conversationLogTailer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,4DAA4D,CAAC;AAIpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA4DtD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CAE5F"}

package/dist/providers/adapters/openai-codex/observability/conversationLogTailer.js

@@ -0,0 +1,78 @@
+/**
+ * ConversationLogTailer implementation for openai-codex.
+ *
+ * Polls the rollout JSONL file for appended lines and emits normalized
+ * events. Same drift surface as ConversationLogReader; canary coverage is
+ * shared.
+ */
+import { promises as fs } from 'node:fs';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { createSessionId } from './sessionId.js';
+import { findRolloutFile } from './sessionPaths.js';
+import { normalizeCodexJsonlEvent } from './eventNormalizer.js';
+class OpenAiCodexConversationLogTailer {
+    config;
+    capability = CapabilityFlag.ConversationLogTailer;
+    constructor(config) {
+        this.config = config;
+    }
+    tail(session, options) {
+        const cfg = this.config;
+        const pollMs = options?.pollIntervalMs ?? 1000;
+        return {
+            async *[Symbol.asyncIterator]() {
+                const threadId = await createSessionId().providerIdFor(session);
+                if (!threadId)
+                    return;
+                let file = null;
+                while (!file) {
+                    if (options?.signal?.aborted)
+                        return;
+                    file = await findRolloutFile(threadId, cfg.codexHome);
+                    if (!file)
+                        await new Promise((r) => setTimeout(r, pollMs));
+                }
+                let lastSize = 0;
+                let leftover = '';
+                while (!options?.signal?.aborted) {
+                    let stat;
+                    try {
+                        stat = await fs.stat(file);
+                    }
+                    catch {
+                        return;
+                    }
+                    if (stat.size > lastSize) {
+                        const fd = await fs.open(file, 'r');
+                        try {
+                            const buf = Buffer.alloc(stat.size - lastSize);
+                            await fd.read(buf, 0, buf.length, lastSize);
+                            const chunk = leftover + buf.toString('utf-8');
+                            const lines = chunk.split('\n');
+                            leftover = lines.pop() ?? '';
+                            for (const line of lines) {
+                                if (!line.trim())
+                                    continue;
+                                const ev = normalizeCodexJsonlEvent(line);
+                                if (ev) {
+                                    if (options?.types && !options.types.includes(ev.type))
+                                        continue;
+                                    yield ev;
+                                }
+                            }
+                        }
+                        finally {
+                            await fd.close();
+                        }
+                        lastSize = stat.size;
+                    }
+                    await new Promise((r) => setTimeout(r, pollMs));
+                }
+            },
+        };
+    }
+}
+export function createConversationLogTailer(config) {
+    return new OpenAiCodexConversationLogTailer(config);
+}
+//# sourceMappingURL=conversationLogTailer.js.map

package/dist/providers/adapters/openai-codex/observability/conversationLogTailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogTailer.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/conversationLogTailer.ts"],"names":[],"mappings":"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"}

package/dist/providers/adapters/openai-codex/observability/eventNormalizer.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Codex JSONL event normalizer.
+ *
+ * Codex `--json` emits a stream of JSONL events with these shapes (per
+ * the deep-dive in specs/provider-portability/02-codex-deep-dive.md §C
+ * and empirical probing 2026-05-15):
+ *
+ *   {"type":"thread.started","thread_id":"<uuid-v7>"}
+ *   {"type":"turn.started"}
+ *   {"type":"turn.completed","usage":{...}}
+ *   {"type":"turn.failed","error":{"message":"..."}}
+ *   {"type":"item.started","item":{...}}
+ *   {"type":"item.completed","item":{...}}
+ *   {"type":"item.agentMessage.delta","delta":"..."}
+ *   {"type":"item.commandExecution.requestApproval","item":{...}}
+ *   {"type":"item.commandExecution.outputDelta","delta":"..."}
+ *   {"type":"error","message":"..."}
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: critical (silent corruption if a new Codex event type isn't recognized)
+ *   Frequency:   per-event (per-prompt during a session)
+ *   Stability:   unstable — Codex CLI changes event vocabulary across versions
+ *   Fallback:    emit ProviderRawEvent for unrecognized types, never drop silently
+ *   Verdict:     deterministic JSON parse + canary (canary lives at canary/codexEventNormalizerCanary.ts)
+ *
+ * Drift risk: high — every Codex CLI minor version may add new event types
+ * or change existing payload shapes. The canary verifies the recognized
+ * vocabulary by issuing a known-shape prompt and asserting the expected
+ * event sequence appears.
+ */
+import type { CanonicalEvent } from '../../../events.js';
+/**
+ * Parse a single line of Codex `--json` output and return a CanonicalEvent.
+ * Returns `null` when the line is not a recognizable JSON object (e.g.,
+ * blank lines, status bar fragments, ANSI noise from tmux capture).
+ *
+ * Unknown event types are emitted as `ProviderRawEvent` so the consumer
+ * sees them but with explicit "this isn't a canonical event" framing.
+ */
+export declare function normalizeCodexJsonlEvent(line: string): CanonicalEvent | null;
+/**
+ * The set of Codex event-type strings this normalizer currently recognizes.
+ * The canary uses this set to assert the recognized vocabulary hasn't
+ * shrunk silently across Codex CLI upgrades.
+ */
+export declare const RECOGNIZED_CODEX_EVENT_TYPES: Set<string>;
+//# sourceMappingURL=eventNormalizer.d.ts.map

package/dist/providers/adapters/openai-codex/observability/eventNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventNormalizer.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/eventNormalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAgJ5E;AAYD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,aAavC,CAAC"}