instar 0.28.113 → 0.28.115

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

@@ -0,0 +1,84 @@
+/**
+ * ProcessLifecycle implementation for openai-codex.
+ *
+ * Codex sessions run as a `codex exec` subprocess inside a tmux session
+ * (matching the Anthropic adapter's pattern). State is read from tmux
+ * `list-panes` for PIDs and standard `ps` for memory/CPU.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: medium (process-health monitoring)
+ *   Frequency:   per-check (polled by external watchdog)
+ *   Stability:   stable (tmux/ps semantics don't drift)
+ *   Fallback:    treat unreadable state as 'dead'
+ *   Verdict:     deterministic; OS-level — weekly canary cadence appropriate
+ */
+import { execFileSync } from 'node:child_process';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { tmuxSessionFromHandle } from '../transport/agenticSessionHeadless.js';
+class OpenAiCodexProcessLifecycle {
+    config;
+    capability = CapabilityFlag.ProcessLifecycle;
+    constructor(config) {
+        this.config = config;
+    }
+    async state(session, _options) {
+        const tmuxName = tmuxSessionFromHandle(session);
+        let panesOut = '';
+        try {
+            panesOut = execFileSync(this.config.tmuxPath, ['list-panes', '-t', tmuxName, '-F', '#{pane_pid}'], { encoding: 'utf-8', timeout: 5000 });
+        }
+        catch {
+            return { alive: false, pids: [], startedAt: new Date(0).toISOString() };
+        }
+        const pids = panesOut.split('\n').map((x) => Number(x.trim())).filter((n) => n > 0);
+        if (pids.length === 0) {
+            return { alive: false, pids: [], startedAt: new Date(0).toISOString() };
+        }
+        let rssBytes;
+        try {
+            const psOut = execFileSync('ps', ['-o', 'rss=,lstart=', '-p', pids.join(',')], {
+                encoding: 'utf-8',
+                timeout: 3000,
+            });
+            const firstLine = psOut.split('\n').find((l) => l.trim().length > 0) ?? '';
+            const rssMatch = firstLine.match(/^\s*(\d+)/);
+            if (rssMatch?.[1])
+                rssBytes = Number(rssMatch[1]) * 1024;
+        }
+        catch {
+            /* ps not available — leave undefined */
+        }
+        return {
+            alive: true,
+            pids,
+            startedAt: new Date().toISOString(),
+            rssBytes,
+        };
+    }
+    subscribe(session) {
+        const lifecycle = this;
+        return {
+            async *[Symbol.asyncIterator]() {
+                let wasAlive = (await lifecycle.state(session)).alive;
+                while (true) {
+                    await new Promise((r) => setTimeout(r, 2000));
+                    const current = await lifecycle.state(session);
+                    if (wasAlive && !current.alive) {
+                        yield {
+                            session,
+                            kind: 'died',
+                            state: current,
+                            timestamp: new Date().toISOString(),
+                        };
+                        return;
+                    }
+                    wasAlive = current.alive;
+                }
+            },
+        };
+    }
+}
+export function createProcessLifecycle(config) {
+    return new OpenAiCodexProcessLifecycle(config);
+}
+//# sourceMappingURL=processLifecycle.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * SessionId implementation for openai-codex.
+ *
+ * Codex assigns a UUIDv7 to each thread. The adapter's SessionHandle is
+ * `openai-codex/<tmuxName>` while the codex-side thread ID is a UUIDv7
+ * captured at thread.started time. This primitive provides the binding.
+ */
+import type { SessionHandle } from '../../../types.js';
+import type { SessionId } from '../../../primitives/observability/sessionId.js';
+/**
+ * Bind a Codex thread UUID to a SessionHandle. Called by the
+ * AgenticSessionHeadless primitive when it observes the first
+ * `thread.started` event in the JSONL stream.
+ */
+export declare function bindCodexThreadId(handle: SessionHandle, threadId: string): void;
+/** Looks up the SessionHandle for a Codex thread, even from a string. */
+export declare function handleForThreadId(threadId: string): SessionHandle | null;
+/** Construct a session handle for a known thread without an active tmux session. */
+export declare function syntheticHandleForThread(threadId: string): SessionHandle;
+export declare function createSessionId(): SessionId;
+//# sourceMappingURL=sessionId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionId.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/sessionId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAuB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAmBhF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAG/E;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAExE;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAExE;AAED,wBAAgB,eAAe,IAAI,SAAS,CAE3C"}

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

@@ -0,0 +1,42 @@
+/**
+ * SessionId implementation for openai-codex.
+ *
+ * Codex assigns a UUIDv7 to each thread. The adapter's SessionHandle is
+ * `openai-codex/<tmuxName>` while the codex-side thread ID is a UUIDv7
+ * captured at thread.started time. This primitive provides the binding.
+ */
+import { sessionHandle } from '../../../types.js';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { OPENAI_CODEX_ID } from '../errors.js';
+const handleToThread = new Map();
+const threadToHandle = new Map();
+class OpenAiCodexSessionId {
+    capability = CapabilityFlag.SessionId;
+    async providerIdFor(session, _options) {
+        return handleToThread.get(session) ?? null;
+    }
+    async handleFor(providerSessionId, _options) {
+        return threadToHandle.get(providerSessionId) ?? null;
+    }
+}
+/**
+ * Bind a Codex thread UUID to a SessionHandle. Called by the
+ * AgenticSessionHeadless primitive when it observes the first
+ * `thread.started` event in the JSONL stream.
+ */
+export function bindCodexThreadId(handle, threadId) {
+    handleToThread.set(handle, threadId);
+    threadToHandle.set(threadId, handle);
+}
+/** Looks up the SessionHandle for a Codex thread, even from a string. */
+export function handleForThreadId(threadId) {
+    return threadToHandle.get(threadId) ?? null;
+}
+/** Construct a session handle for a known thread without an active tmux session. */
+export function syntheticHandleForThread(threadId) {
+    return sessionHandle(`${OPENAI_CODEX_ID}/thread-${threadId}`);
+}
+export function createSessionId() {
+    return new OpenAiCodexSessionId();
+}
+//# sourceMappingURL=sessionId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionId.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/sessionId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;AACxD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;AAExD,MAAM,oBAAoB;IACf,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC;IAE/C,KAAK,CAAC,aAAa,CAAC,OAAsB,EAAE,QAA8B;QACxE,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,iBAAyB,EAAE,QAA8B;QACvE,OAAO,cAAc,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC;IACvD,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqB,EAAE,QAAgB;IACvE,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AAC9C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO,aAAa,CAAC,GAAG,eAAe,WAAW,QAAQ,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,oBAAoB,EAAE,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Shared helpers for locating Codex session files on disk.
+ *
+ * Codex writes rollout files to `$CODEX_HOME/sessions/YYYY/MM/DD/
+ * rollout-<ts>-<uuid>.jsonl` — date-partitioned, unlike Claude's flat
+ * directory layout. These helpers find a session's rollout file by UUID.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (driver of conversation-log reads, resume index, etc.)
+ *   Frequency:   per-read (per-resume, per-conversation-replay)
+ *   Stability:   semi-stable (Codex changes session layout occasionally)
+ *   Fallback:    none — if the layout changes, callers get empty results
+ *   Verdict:     deterministic FS walk + canary (canary at canary/codexSessionLayoutCanary.ts)
+ */
+export declare function codexHomeFromConfig(codexHome?: string): string;
+/** Find a rollout JSONL file by Codex thread UUID. Returns null on miss. */
+export declare function findRolloutFile(threadId: string, codexHome?: string): Promise<string | null>;
+/** List all rollout files under $CODEX_HOME/sessions, newest first. */
+export declare function listAllRollouts(codexHome?: string, limit?: number): Promise<ReadonlyArray<{
+    path: string;
+    mtime: number;
+}>>;
+//# sourceMappingURL=sessionPaths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionPaths.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/sessionPaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,4EAA4E;AAC5E,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB;AA2BD,uEAAuE;AACvE,wBAAsB,eAAe,CACnC,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,SAAM,GACV,OAAO,CAAC,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAMzD"}

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

@@ -0,0 +1,89 @@
+/**
+ * Shared helpers for locating Codex session files on disk.
+ *
+ * Codex writes rollout files to `$CODEX_HOME/sessions/YYYY/MM/DD/
+ * rollout-<ts>-<uuid>.jsonl` — date-partitioned, unlike Claude's flat
+ * directory layout. These helpers find a session's rollout file by UUID.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (driver of conversation-log reads, resume index, etc.)
+ *   Frequency:   per-read (per-resume, per-conversation-replay)
+ *   Stability:   semi-stable (Codex changes session layout occasionally)
+ *   Fallback:    none — if the layout changes, callers get empty results
+ *   Verdict:     deterministic FS walk + canary (canary at canary/codexSessionLayoutCanary.ts)
+ */
+import { promises as fs } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+export function codexHomeFromConfig(codexHome) {
+    return codexHome ?? path.join(homedir(), '.codex');
+}
+/** Find a rollout JSONL file by Codex thread UUID. Returns null on miss. */
+export async function findRolloutFile(threadId, codexHome) {
+    if (!threadId)
+        return null;
+    const root = path.join(codexHomeFromConfig(codexHome), 'sessions');
+    return walkForUuid(root, threadId);
+}
+async function walkForUuid(root, uuid) {
+    let entries;
+    try {
+        entries = await fs.readdir(root);
+    }
+    catch {
+        return null;
+    }
+    for (const entry of entries) {
+        const full = path.join(root, entry);
+        let stat;
+        try {
+            stat = await fs.stat(full);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            const nested = await walkForUuid(full, uuid);
+            if (nested)
+                return nested;
+        }
+        else if (stat.isFile() && entry.startsWith('rollout-') && entry.includes(uuid) && entry.endsWith('.jsonl')) {
+            return full;
+        }
+    }
+    return null;
+}
+/** List all rollout files under $CODEX_HOME/sessions, newest first. */
+export async function listAllRollouts(codexHome, limit = 100) {
+    const root = path.join(codexHomeFromConfig(codexHome), 'sessions');
+    const all = [];
+    await walkCollect(root, all);
+    all.sort((a, b) => b.mtime - a.mtime);
+    return all.slice(0, limit);
+}
+async function walkCollect(dir, out) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry);
+        let stat;
+        try {
+            stat = await fs.stat(full);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            await walkCollect(full, out);
+        }
+        else if (stat.isFile() && entry.startsWith('rollout-') && entry.endsWith('.jsonl')) {
+            out.push({ path: full, mtime: stat.mtimeMs });
+        }
+    }
+}
+//# sourceMappingURL=sessionPaths.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * SubagentLifecycleObserver implementation for openai-codex.
+ *
+ * Codex has no native SubagentStart / SubagentStop hook events (per the
+ * deep-dive §B). Adapter synthesizes events from app-server
+ * `thread/started` / `thread/closed` notifications. Capability flag
+ * `SubagentLifecycleHooks` is FALSE for this adapter; isNative() returns
+ * false; emitted events are tagged `synthesized: true` in providerSpecific.
+ *
+ * Phase 4 baseline: the synthesis stream is provided via an internal
+ * EventEmitter that the agentic-session primitive feeds when it observes
+ * app-server-side thread notifications. When the app-server is not in
+ * use, subagent observation degrades to "no events emitted" — explicit
+ * declaration that subagents are not observable through this path.
+ */
+import type { SubagentLifecycleObserver } from '../../../primitives/observability/subagentLifecycleObserver.js';
+import type { SubagentLifecycleEvent } from '../../../events.js';
+/** Feed a synthesized subagent event from app-server notifications. */
+export declare function feedSubagentEvent(event: SubagentLifecycleEvent): void;
+export declare function createSubagentLifecycleObserver(): SubagentLifecycleObserver;
+//# sourceMappingURL=subagentLifecycleObserver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagentLifecycleObserver.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/subagentLifecycleObserver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EACV,yBAAyB,EAG1B,MAAM,gEAAgE,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AA+CjE,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAarE;AAED,wBAAgB,+BAA+B,IAAI,yBAAyB,CAE3E"}

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

@@ -0,0 +1,86 @@
+/**
+ * SubagentLifecycleObserver implementation for openai-codex.
+ *
+ * Codex has no native SubagentStart / SubagentStop hook events (per the
+ * deep-dive §B). Adapter synthesizes events from app-server
+ * `thread/started` / `thread/closed` notifications. Capability flag
+ * `SubagentLifecycleHooks` is FALSE for this adapter; isNative() returns
+ * false; emitted events are tagged `synthesized: true` in providerSpecific.
+ *
+ * Phase 4 baseline: the synthesis stream is provided via an internal
+ * EventEmitter that the agentic-session primitive feeds when it observes
+ * app-server-side thread notifications. When the app-server is not in
+ * use, subagent observation degrades to "no events emitted" — explicit
+ * declaration that subagents are not observable through this path.
+ */
+import { EventEmitter } from 'node:events';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { OPENAI_CODEX_ID } from '../errors.js';
+const emitter = new EventEmitter();
+const active = new Map();
+class OpenAiCodexSubagentLifecycleObserver {
+    capability = CapabilityFlag.SubagentLifecycleObserver;
+    isNative() { return false; }
+    subscribe(options) {
+        const signal = options?.signal;
+        const parentFilter = options?.parent;
+        const kindFilter = options?.kinds ? new Set(options.kinds) : null;
+        return {
+            async *[Symbol.asyncIterator]() {
+                const queue = [];
+                let resolveNext = null;
+                const onEvent = (ev) => {
+                    if (parentFilter && ev.parentSession !== parentFilter)
+                        return;
+                    if (kindFilter && !kindFilter.has(ev.lifecycleKind))
+                        return;
+                    queue.push(ev);
+                    if (resolveNext) {
+                        resolveNext();
+                        resolveNext = null;
+                    }
+                };
+                emitter.on('subagent', onEvent);
+                const cleanup = () => emitter.off('subagent', onEvent);
+                signal?.addEventListener('abort', cleanup, { once: true });
+                try {
+                    while (!signal?.aborted) {
+                        while (queue.length > 0)
+                            yield queue.shift();
+                        await new Promise((resolve) => {
+                            resolveNext = resolve;
+                            if (signal)
+                                signal.addEventListener('abort', () => { resolveNext = null; resolve(); }, { once: true });
+                        });
+                    }
+                }
+                finally {
+                    cleanup();
+                }
+            },
+        };
+    }
+    async active(parent, _options) {
+        return [...active.values()].filter((a) => a.parent === parent);
+    }
+}
+/** Feed a synthesized subagent event from app-server notifications. */
+export function feedSubagentEvent(event) {
+    const stamped = { ...event, providerSpecific: { [OPENAI_CODEX_ID]: { synthesized: true } } };
+    if (event.lifecycleKind === 'started') {
+        active.set(event.childSession, {
+            child: event.childSession,
+            parent: event.parentSession,
+            startedAt: event.timestamp,
+            purpose: event.purpose,
+        });
+    }
+    else if (event.lifecycleKind === 'completed' || event.lifecycleKind === 'failed') {
+        active.delete(event.childSession);
+    }
+    emitter.emit('subagent', stamped);
+}
+export function createSubagentLifecycleObserver() {
+    return new OpenAiCodexSubagentLifecycleObserver();
+}
+//# sourceMappingURL=subagentLifecycleObserver.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * UsageMeterProvider implementation for openai-codex.
+ *
+ * Codex has no documented public usage endpoint (per the deep-dive §D).
+ * isAuthoritative() returns FALSE; the implementation falls back to local
+ * accounting from `turn.completed.usage` events accumulated in the
+ * session-event stream. Callers needing exact billable spend must
+ * cross-reference with OpenAI's web dashboard.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (cost-routing input)
+ *   Frequency:   per-poll (5-60min)
+ *   Stability:   stable (local accounting won't drift)
+ *   Fallback:    return null when no data has been accumulated
+ *   Verdict:     deterministic local-accounting; canary verifies turn.completed.usage parsing
+ */
+import type { UsageMeterProvider } from '../../../primitives/observability/usageMeterProvider.js';
+/** Called by the event stream when a turn.completed event arrives. */
+export declare function recordTurnUsage(inputTokens: number, outputTokens: number): void;
+export declare function createUsageMeterProvider(): UsageMeterProvider;
+/** Reset local accumulator. Used by tests. */
+export declare function _resetAccumulator(): void;
+//# sourceMappingURL=usageMeterProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usageMeterProvider.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/usageMeterProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,yDAAyD,CAAC;AASjE,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAI/E;AAwBD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC"}

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

@@ -0,0 +1,59 @@
+/**
+ * UsageMeterProvider implementation for openai-codex.
+ *
+ * Codex has no documented public usage endpoint (per the deep-dive §D).
+ * isAuthoritative() returns FALSE; the implementation falls back to local
+ * accounting from `turn.completed.usage` events accumulated in the
+ * session-event stream. Callers needing exact billable spend must
+ * cross-reference with OpenAI's web dashboard.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (cost-routing input)
+ *   Frequency:   per-poll (5-60min)
+ *   Stability:   stable (local accounting won't drift)
+ *   Fallback:    return null when no data has been accumulated
+ *   Verdict:     deterministic local-accounting; canary verifies turn.completed.usage parsing
+ */
+import { CapabilityFlag } from '../../../capabilities.js';
+// Module-level accumulator that the agentic-session stream feeds when it
+// observes `turn.completed.usage` events.
+let totalInputTokens = 0;
+let totalOutputTokens = 0;
+let lastUpdate = null;
+/** Called by the event stream when a turn.completed event arrives. */
+export function recordTurnUsage(inputTokens, outputTokens) {
+    totalInputTokens += inputTokens;
+    totalOutputTokens += outputTokens;
+    lastUpdate = new Date().toISOString();
+}
+class OpenAiCodexUsageMeterProvider {
+    capability = CapabilityFlag.UsageMeterProvider;
+    isAuthoritative() { return false; }
+    async read(_options) {
+        if (lastUpdate === null)
+            return null;
+        const window = {
+            granularity: 'session',
+            resetsAt: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
+            usedPercent: 0,
+            usedAbsolute: totalInputTokens + totalOutputTokens,
+            unit: 'tokens',
+        };
+        return {
+            capturedAt: new Date().toISOString(),
+            source: 'estimated',
+            windows: [window],
+            agentSdkCredit: null,
+        };
+    }
+}
+export function createUsageMeterProvider() {
+    return new OpenAiCodexUsageMeterProvider();
+}
+/** Reset local accumulator. Used by tests. */
+export function _resetAccumulator() {
+    totalInputTokens = 0;
+    totalOutputTokens = 0;
+    lastUpdate = null;
+}
+//# sourceMappingURL=usageMeterProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usageMeterProvider.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/observability/usageMeterProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,yEAAyE;AACzE,0CAA0C;AAC1C,IAAI,gBAAgB,GAAG,CAAC,CAAC;AACzB,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAC1B,IAAI,UAAU,GAAkB,IAAI,CAAC;AAErC,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,YAAoB;IACvE,gBAAgB,IAAI,WAAW,CAAC;IAChC,iBAAiB,IAAI,YAAY,CAAC;IAClC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,6BAA6B;IACxB,UAAU,GAAG,cAAc,CAAC,kBAAkB,CAAC;IACxD,eAAe,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IAE5C,KAAK,CAAC,IAAI,CAAC,QAA8B;QACvC,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACrC,MAAM,MAAM,GAAgB;YAC1B,WAAW,EAAE,SAAS;YACtB,QAAQ,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;YAClE,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,gBAAgB,GAAG,iBAAiB;YAClD,IAAI,EAAE,QAAQ;SACf,CAAC;QACF,OAAO;YACL,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,CAAC,MAAM,CAAC;YACjB,cAAc,EAAE,IAAI;SACrB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,6BAA6B,EAAE,CAAC;AAC7C,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB;IAC/B,gBAAgB,GAAG,CAAC,CAAC;IACrB,iBAAiB,GAAG,CAAC,CAAC;IACtB,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Stub-primitive factory for the openai-codex adapter.
+ *
+ * Used by the parity-test harness when it needs to verify that a
+ * capability flag is honestly declared. The parity check fails if the
+ * adapter returns a `stub` primitive for a capability the adapter has
+ * declared in capabilities.ts — that would be lying about capability.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (capability-declaration honesty)
+ *   Frequency:   parity-test runs only (test-time)
+ *   Stability:   very stable (Symbol.for identity)
+ *   Fallback:    none required
+ *   Verdict:     deterministic; reused canary at
+ *                src/providers/canary/capabilityHonestyCanary.ts already
+ *                covers both Anthropic factories — extended to cover this
+ *                adapter in this batch.
+ */
+import { CapabilityFlag } from '../../capabilities.js';
+/**
+ * Build a stub primitive for the given capability. The stub carries the
+ * canonical STUB_MARKER Symbol so `isStubPrimitive` recognizes it.
+ */
+export declare function createStubPrimitive(capability: CapabilityFlag): Record<string, unknown>;
+//# sourceMappingURL=stubs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.d.ts","sourceRoot":"","sources":["../../../../src/providers/adapters/openai-codex/stubs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBvF"}

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

@@ -0,0 +1,38 @@
+/**
+ * Stub-primitive factory for the openai-codex adapter.
+ *
+ * Used by the parity-test harness when it needs to verify that a
+ * capability flag is honestly declared. The parity check fails if the
+ * adapter returns a `stub` primitive for a capability the adapter has
+ * declared in capabilities.ts — that would be lying about capability.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (capability-declaration honesty)
+ *   Frequency:   parity-test runs only (test-time)
+ *   Stability:   very stable (Symbol.for identity)
+ *   Fallback:    none required
+ *   Verdict:     deterministic; reused canary at
+ *                src/providers/canary/capabilityHonestyCanary.ts already
+ *                covers both Anthropic factories — extended to cover this
+ *                adapter in this batch.
+ */
+import { STUB_MARKER } from '../../markers.js';
+/**
+ * Build a stub primitive for the given capability. The stub carries the
+ * canonical STUB_MARKER Symbol so `isStubPrimitive` recognizes it.
+ */
+export function createStubPrimitive(capability) {
+    return new Proxy({ capability, [STUB_MARKER]: true }, {
+        get(target, prop) {
+            if (prop === 'capability' || prop === STUB_MARKER || prop === Symbol.toPrimitive) {
+                return target[prop];
+            }
+            if (typeof prop === 'symbol')
+                return undefined;
+            return () => {
+                throw new Error(`openai-codex stub: attempted to call method '${String(prop)}' on a stub primitive for capability ${capability}. This indicates a parity-test misconfiguration.`);
+            };
+        },
+    });
+}
+//# sourceMappingURL=stubs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../../../../src/providers/adapters/openai-codex/stubs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA0B;IAC5D,OAAO,IAAI,KAAK,CACd,EAAE,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAsC,EACvE;QACE,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;gBACjF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YACD,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC/C,OAAO,GAAG,EAAE;gBACV,MAAM,IAAI,KAAK,CACb,gDAAgD,MAAM,CAAC,IAAI,CAAC,wCAAwC,UAAU,kDAAkD,CACjK,CAAC;YACJ,CAAC,CAAC;QACJ,CAAC;KACF,CACF,CAAC;AACJ,CAAC"}

package/dist/providers/adapters/openai-codex/transport/agenticSessionHeadless.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AgenticSessionHeadless implementation for the openai-codex adapter.
+ *
+ * Two implementation choices for headless Codex sessions:
+ *   1. `codex exec --json PROMPT` in a tmux session, parse stdout JSONL
+ *      events into CanonicalEvent stream.
+ *   2. `codex app-server` JSON-RPC `thread/start` method (richer, but
+ *      requires running the app-server).
+ *
+ * Phase 4 uses (1) — mirrors the Anthropic adapter's tmux pattern, gives
+ * us live stdout to parse, doesn't require app-server lifecycle
+ * management. The app-server path is reserved for `agenticSessionRpc`.
+ *
+ * Event normalization per the deep-dive (02-codex-deep-dive.md §C):
+ *   - `thread.started` → session-lifecycle (started)
+ *   - `turn.started` → no canonical event (boundary marker only)
+ *   - `turn.completed` → turn-end (with usage)
+ *   - `item.agentMessage.delta` → message-delta
+ *   - `item.commandExecution.*` → tool-call / tool-result
+ *   - `error` → error
+ *   - `turn.failed` → error + session-lifecycle (ended)
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: medium — tmux capture-pane format drift would degrade
+ *                event observability for headless Codex sessions; mirrors
+ *                liveOutputStream.ts's tmux-output dependence (also
+ *                registered in 06-state-detector-registry.md).
+ *   Frequency:   per-poll (500ms cadence while session alive) for the
+ *                capture-pane loop; per-session for the `new-session`
+ *                spawn boundary.
+ *   Stability:   stable — tmux CLI is OS-level, slow-drift.
+ *   Fallback:    none for capture-pane parsing (a format change would
+ *                surface as missing events, caught by the
+ *                openaiKeyLeakageCanary at adapter init via the env-scrub
+ *                contract it shares); code fix is remediation for any
+ *                real format change.
+ *   Verdict:     OS-level format stability + sibling canary coverage at
+ *                the spawn boundary (Rule 1a env-scrub via
+ *                openaiKeyLeakageCanary) is the structural coverage. The
+ *                tmux capture-pane loop reads from the pane the
+ *                env-scrubbed new-session spawn produced.
+ */
+import type { AgenticSessionHeadless } from '../../../primitives/transport/agenticSessionHeadless.js';
+import type { SessionHandle } from '../../../types.js';
+import type { OpenAiCodexConfig } from '../config.js';
+/**
+ * Extract the tmux session name from a SessionHandle issued by this adapter.
+ */
+export declare function tmuxSessionFromHandle(handle: SessionHandle): string;
+export declare function createAgenticSessionHeadless(config: OpenAiCodexConfig): AgenticSessionHeadless;
+//# sourceMappingURL=agenticSessionHeadless.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agenticSessionHeadless.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/transport/agenticSessionHeadless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAIH,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,yDAAyD,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA8ItD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CASnE;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,iBAAiB,GACxB,sBAAsB,CAExB"}