agentel 0.2.6 → 0.2.8

package/README.md

@@ -41,7 +41,7 @@ ref for repeatable installs:
 ```sh
 npm install -g brianlzhou/agentlog
 # or
-npm install -g brianlzhou/agentlog#v0.2.6
+npm install -g brianlzhou/agentlog#v0.2.8
 agentlog init
 ```
 
@@ -80,6 +80,7 @@ AGENTLOG_HOME=/tmp/agentlog-demo node ./bin/agentlog.js import --source codex-de
 AGENTLOG_HOME=/tmp/agentlog-demo node ./bin/agentlog.js import chatgpt
 AGENTLOG_HOME=/tmp/agentlog-demo node ./bin/agentlog.js import claude-web
 AGENTLOG_HOME=/tmp/agentlog-demo node ./bin/agentlog.js import chatgpt ~/Downloads/chatgpt-export.zip --username you@example.com
+AGENTLOG_HOME=/tmp/agentlog-demo node ./bin/agentlog.js import chatgpt "~/Downloads/OpenAI-export/User Online Activity" --username you@example.com
 AGENTLOG_HOME=/tmp/agentlog-demo node ./bin/agentlog.js import claude-web ~/Downloads/claude-export --username you --display-name "Personal Claude"
 AGENTLOG_HOME=/tmp/agentlog-demo node ./bin/agentlog.js import --source claude --since 30d
 AGENTLOG_HOME=/tmp/agentlog-demo node ./bin/agentlog.js import --source claude-code-desktop --since all
@@ -364,6 +365,9 @@ alongside it:
 For large multi-session stores such as Cursor SQLite, the per-session raw
 manifest may reference one shared copy under `raw-sources/` instead of copying
 the same database into every session folder.
+Web chat imports may also reference a shared raw export archive; ChatGPT
+attachments remain preserved there and fresh imports render image/file cards in
+the readable transcript when the export includes the file bytes.
 
 `events.jsonl` uses the local `agentlog.events.v2` canonical event shape:
 `session.started`, `prompt.submitted`, `response.generated`, `tool.called`, and
@@ -382,7 +386,12 @@ search.
 
 Stats are import-time metadata, not viewer-time transcript repair. Archive
 metadata stores message counts, user-message counts, token usage, and models for
-each session, and the web stats view reads those fields directly. Codex SDK and
+each session, and the web stats view reads those fields directly. Token totals
+include cache-read/cache-write tokens when providers report them, while the
+stats payload and UI also keep input, output, cache, and reasoning sub-counts
+separately when available. Codex imports preserve `threads.tokens_used` as the
+provider total and split rollout `token_count` events into fresh input, cache
+read, output, and reasoning metadata. Codex SDK and
 Claude SDK batch jobs are kept out of primary activity totals, streaks, folder
 rankings, and provider/model charts; the stats payload and web view expose them
 as a separate SDK jobs section so high-volume automation does not drown out
@@ -406,13 +415,24 @@ as `[chatgpt]conversations/<account-id>` and
 metadata in `~/.agentlog/state/web-accounts.json`; use
 `agentlog import accounts list` to inspect mappings and
 `agentlog import accounts rename <provider> <account-id-or-username> --display-name <name>`
-to change the viewer display name. Claude.ai exports preserve conversation
-summaries and split structured thinking parts from visible assistant answers
-when the export includes that detail. Repeated manual uploads are incremental:
-unchanged conversations are skipped, and updated conversations replace the
-stable session for that provider/account/conversation id. Existing malformed
-pre-v1 web-chat archives are not migrated automatically; reimport from the
-original export after a reset or cleanup.
+to change the viewer display name.
+
+For newer OpenAI privacy exports named `OpenAI-export`, unzip the download and
+import the `User Online Activity` folder. Running `agentlog import chatgpt`
+without a path starts a walkthrough that asks for export paths one at a time,
+then account username/email and display name. ChatGPT
+conversations may be split across multiple
+`Conversations__...chatgpt...part-000N` ZIPs or folders; passing the parent
+folder is best, but the walkthrough can also collect the split part folders
+individually and preserve `chat.html`, manifests, ZIPs, and attached files in
+the shared raw export archive. Claude.ai exports preserve conversation summaries
+and split structured
+thinking parts from visible assistant answers when the export includes that
+detail. Repeated manual uploads are incremental: unchanged conversations are
+skipped, and updated conversations replace the stable session for that
+provider/account/conversation id. Existing malformed pre-v1 web-chat archives
+are not migrated automatically; reimport from the original export after a reset
+or cleanup.
 
 Tool calls and tool results are normalized before archive write where provider
 data is available. For example, Devin tool calls live in
@@ -432,16 +452,19 @@ importer/parser logic to rebuild the local archive without redoing setup:
 
 ```sh
 npm install -g agentel@latest
-agentlog update --yes --since all
+agentlog update --yes
 ```
 
 `agentlog update` preserves `config.json`, redaction settings, web account
-labels, source histories, and recall integrations. It removes derived local
-archive, import, index, cache, and sync bookkeeping, then reimports configured
-local sources from the stored preferences. It does not touch remote sync objects
-by default; use `agentlog sync replace` when the remote should match the rebuilt
-local archive. It also does not rediscover manual ChatGPT/Claude.ai export
-files; reimport those web exports from the original ZIP/folder when needed.
+labels, manually imported ChatGPT/Claude.ai archives, source histories, and
+recall integrations. It removes derived local archive, import, index, cache, and
+sync bookkeeping, then reimports configured local sources from the stored
+preferences. The rebuild window comes from the initial backfill or an explicit
+all-source import such as `agentlog import --source all --since all`; the
+fallback for legacy configs is `all`. The watcher's rolling
+`imports.defaultSinceDays` is not used by `agentlog update`. It does not touch
+remote sync objects by default; use `agentlog sync replace` when the remote
+should match the rebuilt local archive.
 
 Use `agentlog config` to change `~/.agentlog/config.json` without rerunning the
 init wizard:
@@ -489,8 +512,11 @@ saved in config and used by later `agentlog import --source all` runs unless
 Default init sources:
 
 - Codex CLI sessions and Codex Desktop sessions from Codex state, shown as
-  separate toggles; Codex SDK jobs are available as an opt-in batch source
-- Claude Code CLI transcripts from `~/.claude/projects`
+  separate toggles, including linked Codex subagent child sessions when
+  `thread_spawn_edges` metadata is present; Codex SDK jobs are available as an
+  opt-in batch source
+- Claude Code CLI transcripts from `~/.claude/projects`, including subagent
+  definition snapshots and `subagents/*.jsonl` runs imported as child sessions
 - Claude Code Desktop metadata and Claude Workspace/local-agent sessions from
   the Claude app data, shown as separate toggles
 - Gemini CLI saved chats/checkpoints under `~/.gemini/tmp`, plus session/export JSONL stores with tool, usage, and checkpoint metadata
@@ -545,6 +571,7 @@ agentlog import --source codex-sdk --since all
 agentlog import chatgpt
 agentlog import claude-web
 agentlog import chatgpt ~/Downloads/chatgpt-export.zip --username you@example.com
+agentlog import chatgpt "~/Downloads/OpenAI-export/User Online Activity" --username you@example.com
 agentlog import claude-web ~/Downloads/claude-export --username you --display-name "Personal Claude"
 agentlog import --source claude --since 30d
 agentlog import --source claude-code-desktop --since all

package/docs/code-reference.md

@@ -433,7 +433,10 @@ Embedded history web app functions:
 - `renderMarkdownLink(label, href)`: renders safe links.
 - `renderSkillLink(name, skillPath)`: renders `$skill` links.
 - `compactSkillPath(value)`: shortens skill paths for display.
-- `setView(mode)`: toggles readable and raw Markdown views.
+- `captureRelativeScrollPosition()`: captures the detail pane scroll ratio.
+- `restoreRelativeScrollPosition(position, serial)`: restores a captured scroll
+  ratio after a view-mode layout swap.
+- `setView(mode, options)`: toggles readable and raw Markdown views.
 - `sessionDetailsText(payload)`: builds copyable session details.
 - `copyText(value)`: writes text to the clipboard.
 - `copySessionDetails()`: copies session metadata for pasting into agents.
@@ -559,8 +562,8 @@ Import dispatch and generic providers:
 - `matchesImportedSessionRepo(session, repo, wantedRepos)`: checks repo filters
   for sessions with repo or scope attribution.
 - `importCodexProvider(provider, since, options, env)`: imports Codex CLI,
-  Desktop, or opt-in exec/SDK threads from state DB, rollout files, and Codex
-  supplementary summaries when available.
+  Desktop, or opt-in exec/SDK threads from the state DB, session index, rollout
+  files, and Codex supplementary summaries when available.
 - `importCursorProvider(provider, since, options, env)`: imports Cursor SQLite
   and Cursor project transcript sessions; supervisor calls set
   `cursorRecovery=false` to skip raw SQLite salvage/backfill.
@@ -655,8 +658,9 @@ Source location and file helpers:
   tool names are kept with interactive Claude Code conversations.
 - `readInitialLines(file, maxLines, maxBytes)`: reads a bounded prefix of a
   large JSONL file.
-- `readCodexThreads(env)`: queries Codex state DB for top-level threads and
-  optional `stage1_outputs` summary documents.
+- `readCodexThreads(env)`: queries Codex state DB for top-level threads, merges
+  `session_index.jsonl` titles, and reads optional `stage1_outputs` summary
+  documents.
 - `sqliteTableExists(dbPath, tableName)`: checks optional SQLite tables before
   querying version-dependent Codex state.
 - `codexStateDb(env)`: resolves Codex state DB path.

package/docs/history-source-handling.md

@@ -95,15 +95,20 @@ split as non-assistant input, assistant output, and Claude thinking output, not
 reconstructed billing context windows.
 
 ```sh
-agentlog update --yes --since all
+agentlog update --yes
 ```
 
 `agentlog update` preserves config preferences, redaction settings, web account
-labels, source histories, and recall integrations. It removes derived local
-archive/import/index state and reimports configured local sources. Manual web
-exports still need to be imported again from the original export file when those
-archives need to be rebuilt. `agentlog reset` is the heavier path: it removes
-agentlog state and archive objects, including config, while still leaving source
+labels, manually imported ChatGPT/Claude.ai archive objects, source histories,
+and recall integrations. It removes derived local agent archive/import/index
+state and reimports configured local sources. The default rebuild window is
+`imports.updateSince`, saved from the initial backfill or explicit all-source
+imports, falling back to `all` for legacy configs. The watcher's rolling
+`imports.defaultSinceDays` is not used by `agentlog update`; `--since` still
+overrides it for one run. Manual web exports only need to be
+imported again from the original export file when those chat archives themselves
+need to be rebuilt. `agentlog reset` is the heavier path: it removes agentlog
+state and archive objects, including config, while still leaving source
 application histories such as Cursor, Codex, Claude, Gemini, or Devin logs
 untouched.
 
@@ -195,36 +200,36 @@ package-prefixed scheme.
 
 | Source type | Version |
 | --- | --- |
-| `codex-cli-history` | `0.2.6.0` |
-| `codex-desktop-history` | `0.2.6.0` |
-| `codex-sdk-history` | `0.2.6.0` |
-| `cli-history` | `0.2.6.0` |
-| `claude-sdk-history` | `0.2.6.0` |
-| `claude-code-desktop-metadata` | `0.2.6.0` |
-| `claude-workspace-desktop` | `0.2.6.0` |
-| `cursor-workspace-sqlite` | `0.2.6.0` |
-| `cursor-global-sqlite` | `0.2.6.0` |
-| `cursor-raw-sqlite-salvage` | `0.2.6.0` |
-| `cursor-agent-transcripts` | `0.2.6.0` |
-| `devin-cli-history` | `0.2.6.0` |
-| `gemini-cli-history` | `0.2.6.0` |
-| `cline-task-history` | `0.2.6.0` |
-| `opencode-cli-history` | `0.2.6.0` |
-| `opencode-cli-sqlite-history` | `0.2.6.0` |
-| `opencode-desktop-history` | `0.2.6.0` |
-| `opencode-desktop-sqlite-history` | `0.2.6.0` |
-| `opencode-web-sqlite-history` | `0.2.6.0` |
-| `opencode-history` | `0.2.6.0` |
-| `opencode-sqlite-history` | `0.2.6.0` |
-| `aider-chat-history` | `0.2.6.0` |
-| `antigravity-history` | `0.2.6.0` |
-| `antigravity-trajectory-summary` | `0.2.6.0` |
-| `windsurf-trajectory-export` | `0.2.6.0` |
-| `web-chat-export` | `0.2.6.0` |
-| `chatgpt-export` | `0.2.6.0` |
-| `claude-web-export` | `0.2.6.0` |
-| `claude-web-memory` | `0.2.6.0` |
-| `import` | `0.2.6.0` |
+| `codex-cli-history` | `0.2.8.0` |
+| `codex-desktop-history` | `0.2.8.0` |
+| `codex-sdk-history` | `0.2.8.0` |
+| `cli-history` | `0.2.8.0` |
+| `claude-sdk-history` | `0.2.8.0` |
+| `claude-code-desktop-metadata` | `0.2.8.0` |
+| `claude-workspace-desktop` | `0.2.8.0` |
+| `cursor-workspace-sqlite` | `0.2.8.0` |
+| `cursor-global-sqlite` | `0.2.8.0` |
+| `cursor-raw-sqlite-salvage` | `0.2.8.0` |
+| `cursor-agent-transcripts` | `0.2.8.0` |
+| `devin-cli-history` | `0.2.8.0` |
+| `gemini-cli-history` | `0.2.8.0` |
+| `cline-task-history` | `0.2.8.0` |
+| `opencode-cli-history` | `0.2.8.0` |
+| `opencode-cli-sqlite-history` | `0.2.8.0` |
+| `opencode-desktop-history` | `0.2.8.0` |
+| `opencode-desktop-sqlite-history` | `0.2.8.0` |
+| `opencode-web-sqlite-history` | `0.2.8.0` |
+| `opencode-history` | `0.2.8.0` |
+| `opencode-sqlite-history` | `0.2.8.0` |
+| `aider-chat-history` | `0.2.8.0` |
+| `antigravity-history` | `0.2.8.0` |
+| `antigravity-trajectory-summary` | `0.2.8.0` |
+| `windsurf-trajectory-export` | `0.2.8.0` |
+| `web-chat-export` | `0.2.8.0` |
+| `chatgpt-export` | `0.2.8.0` |
+| `claude-web-export` | `0.2.8.0` |
+| `claude-web-memory` | `0.2.8.0` |
+| `import` | `0.2.8.0` |
 
 `cursor-sqlite-history` and `antigravity-brain` are compatibility aliases for
 older labels. Fingerprints include the parser version prefix, so changing the
@@ -360,29 +365,72 @@ stable local command for the archived source.
 - Import selector: `codex-cli`
 - Provider: `codex`
 - Source type: `codex-cli-history`
-- Primary store: `~/.codex/state_5.sqlite`
+- Primary stores: `~/.codex/state_5.sqlite` and
+  `~/.codex/session_index.jsonl`
 - Session files: rollout paths referenced by the `threads` table, plus
   unindexed `rollout-*.jsonl` files under `sessions` and `archived_sessions`
 - Source split: `threads.source = "cli"`
 - Overrides:
   - `CODEX_STATE_DB` overrides the state database path.
+  - `CODEX_SESSION_INDEX` overrides the session index path.
   - `CODEX_HOME` is used for the fallback sessions root.
 
 The importer reads `id`, `rollout_path`, `created_at`, `updated_at`, `source`,
-`cwd`, and `title` from the Codex state database using `sqlite3`. When the
-database has the newer `stage1_outputs` table, agentlog also reads
+`cwd`, `title`, and available subagent metadata columns from the Codex state
+database using `sqlite3`. It also reads `thread_spawn_edges` when present. It then
+prefers `~/.codex/session_index.jsonl` when a matching `thread_name` entry is
+present, because Codex Desktop can now keep the sidebar title there while
+leaving `threads.title` as the full first prompt. If the index has no title for
+a session, the parser falls back to the rollout `thread_name_updated` event
+when Codex emits one, then to non-prompt-shaped state titles and finally to
+first-user-message inference. When a prompt starts with `$agentlog-recall` and
+then continues with a separate task paragraph, fallback title inference skips
+the recall lookup line and titles the session from the task body. If existing
+Codex archives show long context titles, recall-query titles, or stale first
+prompts instead of the Codex sidebar title, reimport them with
+`agentlog import --source codex-desktop --since all` or
+`agentlog import --source codex-cli --since all`. When the database has the
+newer `stage1_outputs` table, agentlog also reads
 `rollout_summary` and `raw_memory` as supplementary Codex summary documents and
 adds them to the archived transcript. The importer also scans
 `~/.codex/sessions` and `~/.codex/archived_sessions` for `rollout-*.jsonl` and
 `rollout-*.jsonl.zst` files that are not referenced by the state database, so
 older archived rollouts still get backed up.
 
+Codex subagents are stored as ordinary rollout threads whose `threads.source`
+can be a JSON `subagent.thread_spawn` object, with parent/child relationships in
+`thread_spawn_edges` and optional `agent_nickname`, `agent_role`, and
+`agent_path` columns. Agentlog resolves those rows back to the parent's source
+split (`codex-cli-history`, `codex-desktop-history`, or `codex-sdk-history`),
+imports each child as `conversationKind = "codex_subagent"` with
+`parentComposerId` set to the parent thread id, and attaches compact run
+metadata to the parent as `metadata.sessionSummary.codexSubagentRuns`. The web
+viewer renders those runs inline and opens the child transcript in the same
+subagent modal used for Claude Code. Existing Codex archives need a full
+reimport, for example `agentlog import --source codex-desktop --since all`, to
+gain the child-session links.
+
 The rollout JSONL parser captures readable `response_item` reasoning summaries,
 Codex `event_msg` assistant/user messages, task and compaction markers, local
 shell calls, web search calls, custom tool calls such as `apply_patch`, tool
 outputs, and token-count usage deltas. Shell calls that run `apply_patch`
 through a heredoc are promoted to edit tool calls with `patch`, `diff`, and
-target path metadata. The working directory comes from the parsed transcript
+target path metadata. Codex token totals are normalized
+from `event_msg.token_count.info.total_token_usage`: `input_tokens` is split
+into fresh input and `cached_input_tokens`, output tokens are preserved, and
+`reasoning_output_tokens` is stored as a visible sub-count that is already
+included in Codex output totals. When the Codex state database exposes
+`threads.tokens_used`, agentlog stores it as the session-level provider total so
+the stats page can reconcile rollout splits with Codex's own thread counter.
+Because these fields are import-time metadata, changing Codex token semantics
+requires a full reimport, for example:
+
+```bash
+agentlog import --source codex-desktop --since all
+agentlog import --source codex-cli --since all
+```
+
+The working directory comes from the parsed transcript
 first, then the `threads.cwd` column. If neither is available, the session is
 archived under `codex/uncategorized` instead of inheriting the supervisor's
 current directory. Repo attribution is computed from the resolved directory.
@@ -393,15 +441,17 @@ Reading `.zst` sessions requires `zstd` or `unzstd`.
 - Import selector: `codex-desktop`
 - Provider: `codex`
 - Source type: `codex-desktop-history`
-- Primary store: `~/.codex/state_5.sqlite`
+- Primary stores: `~/.codex/state_5.sqlite` and
+  `~/.codex/session_index.jsonl`
 - Session files: rollout paths referenced by the `threads` table
 - Source split: `threads.source = "vscode"`
 - Overrides: same as Codex CLI
 
-Codex Desktop uses the same state database, summary-document handling, and
-rollout parser as Codex CLI. The only distinction is the `threads.source` value.
-This is why the web source dropdown can split Codex CLI and Codex Desktop even
-though both archive under the same `codex` provider.
+Codex Desktop uses the same state database, session-index title handling,
+summary-document handling, and rollout parser as Codex CLI. The only distinction
+is the `threads.source` value. This is why the web source dropdown can split
+Codex CLI and Codex Desktop even though both archive under the same `codex`
+provider.
 
 ## Codex SDK Jobs
 
@@ -427,22 +477,49 @@ in the separate SDK jobs aggregate instead of primary interactive totals.
 - Import command: `agentlog import chatgpt <path> [--scope local|team]`
 - Provider: `chatgpt`
 - Source type: `chatgpt-export`
-- Source file: ChatGPT JSON export or ZIP containing a JSON export
+- Source file: ChatGPT JSON export, OpenAI export ZIP, extracted
+  `OpenAI-export`, or `User Online Activity` folder
 - Default archive scope: `chatgpt`
 
-ChatGPT is not scanned automatically from a desktop app. The import command
-without a path prints official export instructions for OpenAI's Privacy Portal
-and ChatGPT Data Controls. The user then provides the downloaded official export
-file. ZIP imports prefer `conversations.json`, then another JSON file with
-`chat` in the name, then the first JSON file in the ZIP.
+ChatGPT is not scanned automatically from a desktop app. In a terminal, the
+import command without a path starts a walkthrough that asks for the export path
+or paths, account username/email, and display name.
+Use `agentlog import chatgpt --instructions` for static Privacy Portal and
+ChatGPT Data Controls instructions. Older ChatGPT exports usually contain a
+single `conversations.json`. Newer OpenAI privacy exports can arrive as
+`OpenAI-export/User Online Activity` with conversation data split across ZIPs or
+folders such as
+`Conversations__<account-hash>-chatgpt-0001-part-0001` and
+`...part-0002`. Import the parent `User Online Activity` folder when possible.
+The walkthrough also accepts each split `Conversations__...chatgpt...part`
+folder one at a time, ending on a blank line, so agentlog sees all split JSON
+files, manifests, `chat.html`, conversation ZIPs, and attached files together. Very large outer
+`OpenAI-export.zip` files should be unzipped first because Node and unzip tooling
+can hit multi-gigabyte file limits.
+
+ChatGPT attachment files are preserved in the shared raw export archive and are
+shown from normalized message metadata in the readable transcript. Fresh imports
+render image/file attachment cards instead of folding `[Attachment: ...]`
+placeholders into message text. Reimport ChatGPT exports after upgrading to
+populate the attachment metadata and viewer URLs.
+File cards are only linked when the exported raw archive actually contains the
+file bytes; ChatGPT privacy exports may list some uploaded PDFs or documents in
+conversation metadata without including the original file. ChatGPT tool calls
+such as `web.run` are normalized into tool-call cards, uploaded-file parsing
+messages are normalized as file tool results, and private-use citation markers
+including file citations render as citation labels instead of unsupported glyph
+boxes.
 
 For OpenAI export mappings, agentlog reads each node message, normalizes
-`author.role`, extracts `content.parts`, and uses `create_time` or `update_time`
-as the timestamp. Web imports are scope-based by default because they generally
-do not have a reliable local working directory. Since official exports do not
-usually include usage, the importer archives estimated per-message
-`metadata.usage` from native message content and marks the resulting session
-usage as estimated.
+`author.role`, extracts `content.parts`, records attachment and asset-pointer
+metadata, and uses `create_time` or `update_time` as the timestamp. Non-chat JSON
+such as `user_settings.json` is available for account metadata but is not counted
+as a conversation. Extensionless binary attachment files are preserved as raw
+files rather than parsed as JSON. Web imports are scope-based by default because
+they generally do not have a reliable local working directory. Since official
+exports do not usually include usage, the importer archives estimated
+per-message `metadata.usage` from native message content and marks the resulting
+session usage as estimated.
 
 ## Claude Code CLI
 
@@ -489,6 +566,26 @@ also include Remote Control attachment counts/details, available tool names,
 MCP server names, queue timing/content, agent ids, slugs, API error counts, and
 MCP structured-content counts.
 
+For each Claude Code session with a working directory, agentlog also snapshots
+Claude subagent definitions from the user-level `~/.claude/agents` directory and
+the nearest project `.claude/agents` directory. It parses the Markdown
+frontmatter fields that Claude uses for subagents (`name`, `description`,
+`tools`, and `model`), records the effective project-over-user definition set in
+`metadata.sessionSummary.claudeSubagents`, and preserves the source `.md` files
+in the session raw manifest. The transcript is not padded with full subagent
+instructions; use the raw archive when the complete definition body is needed.
+
+Claude Code subagent run transcripts stored under
+`~/.claude/projects/<project>/<parent-session-id>/subagents/*.jsonl` are also
+attached to the parent session as `metadata.sessionSummary.claudeSubagentRuns`
+and imported as child sessions with `conversationKind = "claude_subagent"` and
+`parentComposerId` set to the parent Claude Code session id. The parent summary
+keeps compact run metadata, prompts, result previews, model names, usage totals,
+and tool counts; the child session carries the full normalized transcript and
+preserves both the JSONL and any sibling `.meta.json` file in raw storage. The
+web viewer renders run summaries inline at their transcript timestamps and links
+to the child session instead of dumping every subagent run at the top.
+
 When the Claude desktop app has a matching
 `~/Library/Application Support/Claude/claude-code-sessions/**/local_*.json`
 record with `cliSessionId`, the CLI importer uses that sidecar's generated
@@ -885,8 +982,8 @@ per-message timestamp exists, it uses the source file's mtime with stable
 millisecond offsets so imports do not get stamped with the time of import.
 
 Cursor project slugs are decoded back to local paths when possible. For example,
-`Users-bzhou-Documents-GitHub-spring-next` resolves to
-`/Users/bzhou/Documents/GitHub/spring-next` if that directory exists. If no
+`Users-alex-Documents-GitHub-spring-next` resolves to
+`/Users/alex/Documents/GitHub/spring-next` if that directory exists. If no
 working directory can be resolved for a newer transcript, it archives under
 `cursor/uncategorized` instead of assigning the session to the current repo.
 
@@ -969,14 +1066,18 @@ created by Desktop, CLI, and Web clients, so agentlog classifies each SQLite
 session row individually. Desktop sessions are identified by session ids in
 OpenCode Desktop sidecar state such as `ai.opencode.desktop/*.dat`; sub-sessions
 inherit Desktop classification from a Desktop parent. CLI sessions are
-identified by session-level `agent` or `model` metadata. Remaining non-`local`
-shared core rows are labeled as Web sessions. Rows without reliable client
-evidence stay on the legacy `opencode-sqlite-history` source type. The
+identified by session-level `agent` or `model` metadata, or by CLI evidence in
+the sanitized message metadata when session rows omit those fields. Remaining
+non-`local` shared core rows are labeled as Web sessions. Rows without reliable
+client evidence stay on the legacy `opencode-sqlite-history` source type. The
 `session`, `message`, `part`, and `project` tables provide session
 metadata, working directory, user/assistant messages, reasoning text, tool
-calls, tool outputs, model/provider ids, cost, and token usage. Because the
-database is a multi-session source, raw preservation stores it as a shared raw
-source instead of duplicating the same file into every session archive.
+calls, tool outputs, model/provider ids, cost, and token usage. During SQLite
+reads, agentlog removes the bulky `message.data.summary` object before JSON
+transport; canonical transcript text still comes from the `part` table, and raw
+preservation keeps the original database byte-for-byte. Because the database is a
+multi-session source, raw preservation stores it as a shared raw source instead
+of duplicating the same file into every session archive.
 
 agentlog also reads OpenCode's JSON session store directly. Sessions provide the
 archive id and project id; message and part files provide role text, reasoning

package/docs/release.md

@@ -64,5 +64,5 @@ After tagging and pushing the release, sanity-check both public install forms:
 
 ```sh
 npm install -g agentel
-npm install -g brianlzhou/agentlog#v0.2.6
+npm install -g brianlzhou/agentlog#v0.2.8
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentel",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Local-first archive and recall layer for agent coding sessions.",
   "type": "commonjs",
   "license": "MIT",
@@ -53,5 +53,8 @@
   "engines": {
     "node": ">=20"
   },
-  "packageManager": "npm@11.5.1"
+  "packageManager": "npm@11.5.1",
+  "dependencies": {
+    "better-sqlite3": "^12.9.0"
+  }
 }