somtum 2.3.0 → 3.0.0

package/README.md

@@ -1,13 +1,13 @@
 <img src="./assets/logo.png" width="500" alt="Somtum Logo">
 
-**Local-first memory and prompt-cache layer for Claude Code.**
+**Local-first memory and prompt-cache layer for coding agents: Claude Code and Codex.**
 
 [**Docs**](https://riz007.github.io/somtum/) · [**npm**](https://www.npmjs.com/package/somtum)
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm version](https://badge.fury.io/js/somtum.svg)](https://www.npmjs.com/package/somtum)
 
-Somtum (Thai: ส้มตำ) is named after the vibrant, shredded green papaya salad. Just like its namesake, Somtum blends durable observations from your Claude Code sessions — decisions, bugfixes, learnings, file summaries — stores them in a local SQLite database, and injects the relevant ones back into context the next time you work on the same project.
+Somtum (Thai: ส้มตำ) is named after the vibrant, shredded green papaya salad. Just like its namesake, Somtum blends durable observations from your Claude Code and Codex sessions — decisions, bugfixes, learnings, file summaries — stores them in a local SQLite database, and injects the relevant ones back into context the next time you work on the same project.
 
 Zero-config: one `somtum init` and every session end is captured automatically. No server, no cloud account, no mandatory tuning.
 
@@ -33,6 +33,8 @@ Zero-config: one `somtum init` and every session end is captured automatically.
 - [Troubleshooting](#troubleshooting)
 - [License](#license)
 
+> **v3.0.0** — Codex support (`somtum init --agent codex`) · selectable extraction backends incl. Codex CLI and GLM · fixes silently lost sessions and oversized extraction calls · [upgrade guide](https://riz007.github.io/somtum/guide/upgrading-v3)
+>
 > **v2.0.0** — Global DB (`~/.somtum/global.db`) · cross-project workspace recall · memory deduplication (`superseded_by`) · `--show-superseded` on `somtum list` · stats instrumentation fix · dashboard dark-mode redesign
 >
 > **v1.5.0** — Multi-page VitePress docs site · `somtum list` · `somtum reset` · `somtum forget --all` · embeddings timeout safety · config crash-resilience · `injection.max_chars` wired up · warm-start race fix · auth-error hints
@@ -43,13 +45,13 @@ Zero-config: one `somtum init` and every session end is captured automatically.
 
 ## Why Somtum?
 
-LLM agents like Claude Code start every session with a blank slate. That leads to:
+Coding agents like Claude Code and Codex start every session with a blank slate. That leads to:
 
 - **Repetitive context** — re-explaining the same architectural choices every session
-- **Regressions** — Claude suggests a fix you already tried and discarded
+- **Regressions** — the agent suggests a fix you already tried and discarded
 - **Token waste** — reading large files just to "set the scene"
 
-**Somtum gives Claude a long-term memory.** Once a decision is made or a bug is fixed, it's remembered across all future sessions — without bloating your context window.
+**Somtum gives your coding agent a long-term memory.** Once a decision is made or a bug is fixed, it's remembered across all future sessions, in Claude Code and Codex alike, without bloating your context window.
 
 ### What a session looks like with Somtum
 
@@ -69,13 +71,13 @@ Session 2: Claude suggests        Session 2: Claude already knows about
 
 ## How it works
 
-At the end of each Claude Code session, Somtum reads the session transcript and asks Claude Haiku to extract the parts worth keeping — decisions, bug fixes, things learned. Those observations are stored locally in SQLite. **On every subsequent prompt**, Somtum automatically retrieves the most relevant memories and injects them into context — no manual recall needed.
+At the end of each Claude Code or Codex session, Somtum reads the session transcript and asks a small model to extract the parts worth keeping — decisions, bug fixes, things learned. Those observations are stored locally in SQLite. **On every subsequent prompt**, Somtum automatically retrieves the most relevant memories and injects them into context — no manual recall needed.
 
 ### Memory lifecycle
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
-│                    Claude Code Session                      │
+│               Claude Code or Codex session                  │
 │                                                             │
 │       you code · debug · review · make decisions            │
 └──────────────────────────────┬──────────────────────────────┘
@@ -134,13 +136,13 @@ You work a session debugging an auth bug and refactoring a module. At session en
 ]
 ```
 
-Next session, when you ask "why are we using pnpm?" or touch `src/auth/refresh.ts`, Claude finds these memories and already has the context.
+Next session, when you ask "why are we using pnpm?" or touch `src/auth/refresh.ts`, the agent gets these memories and already has the context.
 
 ### Architecture
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
-│                      Claude Code / Agent                    │
+│                 Claude Code / Codex / MCP client            │
 └──────────┬──────────────────────────────┬───────────────────┘
            │ hooks                        │ MCP tools
            ▼                              ▼
@@ -206,8 +208,13 @@ Next session, when you ask "why are we using pnpm?" or touch `src/auth/refresh.t
 ## Requirements
 
 - **Node 20+**
-- **Claude Code** — Somtum hooks into Claude Code's `SessionEnd`, `UserPromptSubmit`, and `PreToolUse` events
-- **`ANTHROPIC_API_KEY`** _(optional)_ — if set, Somtum uses the Anthropic API directly for extraction. If not set, Somtum falls back to the `claude` CLI that ships with Claude Code, so **no separate API key is required for Claude Code subscribers**.
+- **Claude Code or Codex** — Somtum hooks into their `SessionEnd`, `PreCompact` and `UserPromptSubmit` events. Both agents share one memory store per project.
+- **An extraction backend**, picked automatically in this order:
+  1. `ANTHROPIC_API_KEY`, or `ANTHROPIC_AUTH_TOKEN` + `ANTHROPIC_BASE_URL` for Anthropic-compatible providers such as GLM
+  2. the `claude` CLI (Claude Code subscribers need no separate key)
+  3. the `codex` CLI (ChatGPT/Codex subscribers need no separate key)
+
+  Override with `somtum config set extraction.backend anthropic|claude-cli|codex-cli`.
 
 ---
 
@@ -239,69 +246,47 @@ Somtum uses [`better-sqlite3`](https://github.com/WiseLibs/better-sqlite3), whic
 
 ## Quickstart
 
-### Before you begin — pick your setup
-
-**Using Claude Code (subscription)?**
-You do not need an API key. Somtum calls the `claude` CLI that ships with Claude Code.
-Confirm it is installed: `which claude`
-If nothing prints, reinstall Claude Code or add its binary to your PATH.
-
-**Using the Anthropic API directly?**
-Add your key to your shell profile (not just the current terminal tab):
-
-```bash
-# Add to ~/.zshrc or ~/.bashrc
-export ANTHROPIC_API_KEY="sk-ant-..."
-source ~/.zshrc
-```
-
-Both paths work. Most Claude Code users should use Option A.
-
----
-
-### Step 1 — Choose your extraction backend
+### Step 1 — Check your extraction backend
 
-Somtum needs to call a Claude model at session end to extract observations. Pick one:
+At the end of each session Somtum asks a small model to pull out what's worth remembering. It uses the first backend available, so most people need to do nothing:
 
-**Option A: Claude Code subscription (no extra setup)**
+| You have | Backend used |
+| --- | --- |
+| `ANTHROPIC_API_KEY` in your shell profile | Anthropic API (Haiku) |
+| `ANTHROPIC_AUTH_TOKEN` + `ANTHROPIC_BASE_URL` (GLM or another Anthropic-compatible provider) | that provider |
+| Claude Code installed (`which claude` prints a path) | `claude` CLI, on your subscription |
+| Codex installed (`which codex` prints a path) | `codex` CLI, on your ChatGPT plan |
 
-If you already have Claude Code installed, you're done. Somtum calls `claude --print` automatically when no API key is present. Skip to Step 2.
+> Keys must be in your shell profile, not just exported in an open terminal tab. Hooks inherit the environment of the shell that _started_ the agent.
 
-**Option B: Direct Anthropic API key (optional — faster, lets you pick the model)**
+### Step 2 — Install in your project
 
-Add to `~/.zshrc` (or `~/.bashrc`):
-
-```bash
-export ANTHROPIC_API_KEY="sk-ant-..."
-```
+Run from the **root of the project you open in your agent**.
 
-Then reload:
+**Claude Code**
 
 ```bash
-source ~/.zshrc
+somtum init --all
+# Installs:
+#   - SessionEnd + PreCompact capture hooks  (memory extraction)
+#   - UserPromptSubmit hook                  (auto-inject + prompt cache)
+#   - PreToolUse file-gating hook            (large file summarization)
+#   - MCP server in .mcp.json                (recall/remember tools)
 ```
 
-> The key must be in your shell profile, not just exported in an open terminal tab. The `SessionEnd` hook inherits the environment of the shell that _started_ Claude Code — not the current terminal.
+> Use `--all`. A plain `somtum init` installs only the capture hooks: memories are saved but not injected, and the agent sees them only if it calls the MCP `recall` tool.
 
-### Step 2 — Install inside a Claude Code project
-
-Run this from the **root of the project you work on with Claude Code**:
+**Codex** (or both, on the same project; they share one memory store):
 
 ```bash
-somtum init
-```
-
-To enable all features at once (recommended):
-
-```bash
-somtum init --all
+somtum init --agent codex
 # Installs:
-#   - SessionEnd capture hook     (memory extraction)
-#   - UserPromptSubmit cache hook (prompt cache lookup)
-#   - PreToolUse file-gating hook (large file summarization)
-#   - MCP server in .mcp.json     (Claude can call recall/remember tools)
+#   - .codex/hooks.json   SessionEnd + PreCompact capture, UserPromptSubmit injection
+#   - .codex/config.toml  [mcp_servers.somtum]
 ```
 
+Codex only loads project-level config for trusted projects. Sessions are read from `~/.codex/sessions` (or `$CODEX_HOME/sessions`).
+
 ### Step 3 — Verify your setup
 
 Run doctor immediately after init to confirm everything is connected:
@@ -312,14 +297,14 @@ somtum doctor
 
 All checks should show `✓`. The two most important are:
 
-- **`api_key`** — confirms Somtum has a way to call Claude for extraction
-- **`hooks_installed`** — confirms the SessionEnd hook is registered
+- **`extraction_backend`** — confirms Somtum has a model to extract memories with
+- **`hooks_installed`** — confirms hooks are registered for Claude Code, Codex, or both
 
 Do not start your first session until all checks pass. Each failing check shows an inline fix command.
 
-### Step 4 — Use Claude Code normally
+### Step 4 — Use your agent normally
 
-Open a Claude Code session **from the same directory** where you ran `somtum init`. Work as you normally would. When the session ends, the hook extracts observations automatically in the background (capped at 90 seconds).
+Open Claude Code or Codex **from the same directory** where you ran `somtum init`. Work as you normally would. When the session ends, the hook extracts observations automatically in the background (capped at 90 seconds).
 
 ### Step 5 — Check your memory
 
@@ -341,7 +326,7 @@ If `somtum stats` shows `memories 0` after a session, see [Troubleshooting](#tro
 
 ## Verifying the setup
 
-After your **first** Claude Code session ends:
+After your **first** session ends:
 
 **1. Check the hook log**
 
@@ -356,18 +341,16 @@ A successful run:
 2026-04-30T10:15:44.891Z [post_session] ok — inserted=4 superseded=1 cache=2 summaries=1
 ```
 
-Using the `claude` CLI fallback (no API key):
+Each run also logs which backend it used:
 
 ```
-2026-04-30T10:15:42.123Z [post_session] starting
-2026-04-30T10:15:42.124Z [post_session] ANTHROPIC_API_KEY not set — will use claude CLI fallback
-2026-04-30T10:15:44.891Z [post_session] ok — inserted=4 superseded=1 cache=2 summaries=1
+2026-04-30T10:15:42.124Z [post_session] extraction backend: claude-cli
 ```
 
 Neither backend available:
 
 ```
-2026-04-30T10:15:42.123Z [post_session] ERROR: Neither ANTHROPIC_API_KEY nor the claude CLI is available.
+2026-04-30T10:15:42.123Z [post_session] ERROR: No extraction backend: set ANTHROPIC_API_KEY (or ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL), or install the claude or codex CLI.
 ```
 
 **2. Check stats**
@@ -496,9 +479,9 @@ Somtum uses hostname-aware syncing — merging observations from multiple machin
 
 ## MCP Server
 
-When you run `somtum init --all`, Somtum registers an MCP server that Claude can call autonomously during a session:
+When you run `somtum init --all` (Claude Code) or `somtum init --agent codex`, Somtum registers an MCP server the agent can call on its own during a session. Any other MCP client can use it too: point it at `somtum mcp` over stdio.
 
-| Tool                | What Claude does with it                                                                                        |
+| Tool                | What the agent does with it                                                                                        |
 | ------------------- | --------------------------------------------------------------------------------------------------------------- |
 | `recall`            | Searches memories when unsure about a project detail. Merges project + global DB results. Accepts `strategy`    |
 | `get`               | Retrieves full observation bodies by ID. Checks global DB if not found in project DB. Bumps `last_confirmed_at` |
@@ -509,7 +492,7 @@ When you run `somtum init --all`, Somtum registers an MCP server that Claude can
 | `forget`            | Soft-deletes an observation                                                                                      |
 | `stats`             | Reports tokens saved, cache hit rate, false-hit count, corpus size, and `global_memories` count                 |
 
-Every MCP response includes a `tokens` field so Claude can account for retrieval cost.
+Every MCP response includes a `tokens` field so the agent can account for retrieval cost.
 
 ### Memory scope
 
@@ -581,6 +564,10 @@ somtum config set file_gating.enabled false
 # Limit observations extracted per session (default: 10)
 somtum config set extraction.max_observations_per_session 5
 
+# Pin the extraction backend (default: auto) and the model codex exec uses
+somtum config set extraction.backend codex-cli
+somtum config set extraction.codex_model <model>
+
 # Control automatic memory injection on every prompt (default: on)
 somtum config set injection.enabled false          # turn off auto-inject
 somtum config set injection.k 5                    # inject more memories (default: 3)
@@ -725,7 +712,8 @@ src/
     store.ts          # MemoryStore — CRUD for observations
     cache.ts          # PromptCache — exact + fuzzy lookup
     retriever/        # bm25, embeddings, hybrid, index, factory
-    extractor.ts      # session transcript → observations (Claude Haiku)
+    extractor.ts      # session transcript → observations
+    llm_backend.ts    # picks the extraction backend
     index_gen.ts      # renders index.md (incremental past 1k obs)
     memory_files.ts   # writes memories/<YYYY-MM>/<ulid>.md
     retrieval_stats.ts
@@ -774,18 +762,18 @@ Check the hook log first:
 cat ~/.somtum/hook.log
 ```
 
-**`claude` CLI not found and no `ANTHROPIC_API_KEY` set**
+**No extraction backend**
 
-- If you use Claude Code: run `which claude` — if nothing prints, reinstall Claude Code or add its binary to your `PATH`.
-- If you prefer the direct API: add `export ANTHROPIC_API_KEY="sk-ant-..."` to `~/.zshrc` and `source ~/.zshrc`. Must be in your profile, not just exported in the current terminal tab.
+- Claude Code users: run `which claude`. Codex users: run `which codex`. If nothing prints, install the CLI or add it to your `PATH`.
+- API users: add `export ANTHROPIC_API_KEY="sk-ant-..."` to `~/.zshrc` and `source ~/.zshrc`. It must be in your profile, not just exported in the current terminal tab.
 
-Run `somtum doctor` — the `api_key` check tells you exactly which backend is available.
+Run `somtum doctor`: the `extraction_backend` check shows which backend will be used.
 
 **Hook not installed in the right directory**
 
-`somtum init` writes the hook to `.claude/settings.json` in the directory where you ran it. If you launch Claude Code from a different directory, it reads a different settings file.
+`somtum init` writes hooks into the directory where you ran it (`.claude/settings.json` or `.codex/hooks.json`). If you launch the agent from a different directory, it reads different settings.
 
-Fix: run `somtum init` from the same directory you use to launch Claude Code.
+Fix: run `somtum init` from the same directory you launch the agent from.
 
 ```bash
 cd ~/my-project

package/dist/agents/claude_code.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from './types.js';
+export declare const claudeCode: AgentAdapter;
+//# sourceMappingURL=claude_code.d.ts.map

package/dist/agents/claude_code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude_code.d.ts","sourceRoot":"","sources":["../../src/agents/claude_code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiH/C,eAAO,MAAM,UAAU,EAAE,YAKxB,CAAC"}

package/dist/agents/claude_code.js

@@ -0,0 +1,112 @@
+import { truncateToolInput, truncateToolResult } from './shared.js';
+const FILE_TOOL_NAMES = new Set(['Read', 'Edit', 'Write', 'NotebookEdit']);
+// Claude Code transcripts deliver tool results as user-role messages whose
+// content is tool_result blocks. Those are not real user prompts: treating
+// them as such splits prompt→response pairs at every tool call and pollutes
+// the cache. Detect them so they can be reclassified as role 'tool'.
+function isToolResultContent(content) {
+    if (!Array.isArray(content))
+        return false;
+    let sawToolResult = false;
+    for (const block of content) {
+        if (block == null || typeof block !== 'object')
+            continue;
+        const t = block.type;
+        if (t === 'tool_result')
+            sawToolResult = true;
+        else if (t === 'text')
+            return false;
+    }
+    return sawToolResult;
+}
+function extractFilesFromBlock(block) {
+    if (block == null || typeof block !== 'object')
+        return [];
+    const b = block;
+    if (b.type !== 'tool_use' || b.name === undefined)
+        return [];
+    if (!FILE_TOOL_NAMES.has(b.name))
+        return [];
+    const input = b.input;
+    const p = input?.file_path ?? input?.notebook_path;
+    return typeof p === 'string' && p.length > 0 ? [p] : [];
+}
+function coerceContent(content) {
+    if (typeof content === 'string')
+        return { text: content, files: [] };
+    if (Array.isArray(content)) {
+        const files = [];
+        const text = content
+            .map((block) => {
+            if (block == null)
+                return '';
+            if (typeof block === 'string')
+                return block;
+            if (typeof block === 'object' &&
+                'text' in block &&
+                typeof block.text === 'string') {
+                return block.text;
+            }
+            if (typeof block === 'object' &&
+                'type' in block &&
+                block.type === 'tool_use') {
+                const b = block;
+                files.push(...extractFilesFromBlock(block));
+                return `[tool_use ${b.name ?? ''} ${truncateToolInput(JSON.stringify(b.input ?? {}))}]`;
+            }
+            if (typeof block === 'object' &&
+                'type' in block &&
+                block.type === 'tool_result') {
+                const b = block;
+                return `[tool_result ${truncateToolResult(coerceContent(b.content).text)}]`;
+            }
+            return '';
+        })
+            .filter((s) => s.length > 0)
+            .join('\n');
+        return { text, files };
+    }
+    return { text: '', files: [] };
+}
+function parse(raw) {
+    const lines = raw.split(/\r?\n/).filter((l) => l.trim().length > 0);
+    const turns = [];
+    for (const line of lines) {
+        let obj;
+        try {
+            obj = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        // Meta lines (caveats, command wrappers) and sidechain (subagent) turns
+        // are not part of the main conversation.
+        if (obj.isMeta === true || obj.isSidechain === true)
+            continue;
+        let role = (obj.message?.role ?? obj.role ?? obj.type ?? 'user');
+        if (role !== 'user' && role !== 'assistant' && role !== 'system' && role !== 'tool')
+            continue;
+        const content = obj.message?.content ?? obj.content;
+        if (role === 'user' && isToolResultContent(content))
+            role = 'tool';
+        const { text, files } = coerceContent(content);
+        if (text.length === 0)
+            continue;
+        const turn = { role, text };
+        if (obj.timestamp)
+            turn.timestamp = obj.timestamp;
+        if (files.length > 0)
+            turn.files_touched = files;
+        turns.push(turn);
+    }
+    return turns;
+}
+// Claude Code is the fallback format: generic {role, content} JSONL parses
+// correctly through it, so detect() accepts anything.
+export const claudeCode = {
+    id: 'claude-code',
+    name: 'Claude Code',
+    detect: () => true,
+    parse,
+};
+//# sourceMappingURL=claude_code.js.map

package/dist/agents/claude_code.js.map

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

package/dist/agents/codex.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from './types.js';
+export declare const codex: AgentAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/agents/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/agents/codex.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA6K/C,eAAO,MAAM,KAAK,EAAE,YAMnB,CAAC"}

package/dist/agents/codex.js

@@ -0,0 +1,173 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { truncateToolInput, truncateToolResult } from './shared.js';
+// User-role blocks Codex injects itself: environment, AGENTS.md, permissions,
+// app state. Most are one <snake_case> tag wrapping the whole block, and new
+// ones keep appearing, so match that shape as well as the known prefixes.
+const INJECTED_PREFIXES = ['# AGENTS.md instructions', '<permissions'];
+const INJECTED_TAG_BLOCK = /^<([a-z]+(?:_[a-z]+)+)>[\s\S]*<\/\1>$/;
+// IDE extensions wrap the prompt as "# Context from my IDE setup: ...
+// ## My request for Codex:\n<prompt>". The heading text varies by version.
+const IDE_CONTEXT_PREFIX = '# Context from my IDE setup';
+const IDE_REQUEST_MARKER = /^## My request[^\n]*:\n/m;
+const PATCH_FILE_LINE = /^\*\*\* (?:Add|Update|Delete) File: (.+)$/gm;
+function userText(blocks) {
+    const parts = [];
+    for (const b of blocks) {
+        const text = b.text?.trim();
+        if (!text)
+            continue;
+        if (INJECTED_PREFIXES.some((p) => text.startsWith(p)))
+            continue;
+        if (INJECTED_TAG_BLOCK.test(text))
+            continue;
+        if (text.startsWith(IDE_CONTEXT_PREFIX)) {
+            const m = IDE_REQUEST_MARKER.exec(text);
+            if (m)
+                parts.push(text.slice(m.index + m[0].length).trim());
+            continue;
+        }
+        parts.push(text);
+    }
+    return parts.join('\n');
+}
+function assistantText(blocks) {
+    return blocks
+        .map((b) => b.text ?? '')
+        .filter((t) => t.length > 0)
+        .join('\n');
+}
+function asText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === undefined || value === null)
+        return '';
+    return JSON.stringify(value);
+}
+function patchedFiles(patch) {
+    return [...patch.matchAll(PATCH_FILE_LINE)].map((m) => m[1].trim());
+}
+// Guardian reviews and other subagent threads get their own rollout file.
+// They are Codex talking to itself, not the user's session.
+function isSubagentSession(meta) {
+    const threadSource = meta['thread_source'];
+    if (typeof threadSource === 'string' && threadSource !== 'user')
+        return true;
+    return typeof meta['source'] === 'object' && meta['source'] !== null;
+}
+function toTurn(line) {
+    const p = line.payload ?? {};
+    let turn = null;
+    switch (p['type']) {
+        case 'message': {
+            const blocks = (Array.isArray(p['content']) ? p['content'] : []);
+            if (p['role'] === 'user') {
+                const text = userText(blocks);
+                if (text)
+                    turn = { role: 'user', text };
+            }
+            else if (p['role'] === 'assistant') {
+                const text = assistantText(blocks);
+                if (text)
+                    turn = { role: 'assistant', text };
+            }
+            break;
+        }
+        case 'function_call':
+            turn = {
+                role: 'assistant',
+                text: `[tool_use ${asText(p['name'])} ${truncateToolInput(asText(p['arguments']))}]`,
+            };
+            break;
+        case 'custom_tool_call': {
+            const input = asText(p['input']);
+            turn = {
+                role: 'assistant',
+                text: `[tool_use ${asText(p['name'])} ${truncateToolInput(input)}]`,
+            };
+            if (p['name'] === 'apply_patch') {
+                const files = patchedFiles(input);
+                if (files.length > 0)
+                    turn.files_touched = files;
+            }
+            break;
+        }
+        case 'function_call_output':
+        case 'custom_tool_call_output':
+            turn = { role: 'tool', text: `[tool_result ${truncateToolResult(asText(p['output']))}]` };
+            break;
+    }
+    if (turn && line.timestamp)
+        turn.timestamp = line.timestamp;
+    return turn;
+}
+function parse(raw) {
+    const turns = [];
+    for (const lineText of raw.split(/\r?\n/)) {
+        if (lineText.trim().length === 0)
+            continue;
+        let line;
+        try {
+            line = JSON.parse(lineText);
+        }
+        catch {
+            continue;
+        }
+        if (line.type === 'session_meta' && isSubagentSession(line.payload ?? {}))
+            return [];
+        if (line.type !== 'response_item')
+            continue;
+        const turn = toTurn(line);
+        if (turn)
+            turns.push(turn);
+    }
+    return turns;
+}
+function detect(raw) {
+    const nl = raw.indexOf('\n');
+    const firstLine = (nl === -1 ? raw : raw.slice(0, nl)).trim();
+    try {
+        const obj = JSON.parse(firstLine);
+        return ((obj.type === 'session_meta' || obj.type === 'response_item') &&
+            typeof obj.payload === 'object');
+    }
+    catch {
+        return false;
+    }
+}
+function sessionsDir() {
+    return join(process.env['CODEX_HOME'] ?? join(homedir(), '.codex'), 'sessions');
+}
+// Codex hooks may send transcript_path: null. Rollout filenames end in the
+// session id, so search the date folders newest-first.
+function findTranscript(sessionId) {
+    const root = sessionsDir();
+    if (!existsSync(root))
+        return null;
+    const suffix = `${sessionId}.jsonl`;
+    const newestFirst = (dir) => readdirSync(dir).sort().reverse();
+    try {
+        for (const y of newestFirst(root)) {
+            for (const m of newestFirst(join(root, y))) {
+                for (const d of newestFirst(join(root, y, m))) {
+                    const hit = readdirSync(join(root, y, m, d)).find((f) => f.endsWith(suffix));
+                    if (hit)
+                        return join(root, y, m, d, hit);
+                }
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export const codex = {
+    id: 'codex',
+    name: 'Codex',
+    detect,
+    parse,
+    findTranscript,
+};
+//# sourceMappingURL=codex.js.map

package/dist/agents/codex.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,7 @@
+import type { AgentAdapter, AgentId } from './types.js';
+export type { AgentAdapter, AgentId } from './types.js';
+export { AGENT_IDS } from './types.js';
+export declare function getAgent(id: AgentId): AgentAdapter;
+export declare function detectAgent(raw: string): AgentAdapter;
+export declare function findTranscript(sessionId: string): string | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAIxD,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMvC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,YAAY,CAIlD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAErD;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D"}