agent-trace-capture 0.0.0-stage → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CAPTURE.md ADDED
@@ -0,0 +1,12 @@
1
+ # Agent Trace Capture
2
+
3
+ Run `npx agent-trace-capture` to take a one-time snapshot of local coding-agent histories and upload it to the configured capture service. The public service stores these captures in the Aionos AWS S3 bucket. Histories can include prompts, private code, tool output and secrets typed into a conversation. No personal AWS credentials are required.
4
+
5
+ - `npx agent-trace-capture --dry-run` lists discovered sessions and candidate paths without creating or uploading an archive.
6
+ - `npx agent-trace-capture --local-only --output traces.zip` keeps the archives on your computer.
7
+ - `npx agent-trace-capture --providers codex,cursor` limits collection to named providers.
8
+ - `--server-url` overrides the hosted destination. The client also accepts `AGENT_TRACE_SERVER_URL` and `AGENT_TRACE_UPLOAD_TOKEN`.
9
+
10
+ On supported installations, the command uses Agent Dump 1.2.12 to discover sessions, exports raw history where supported, and uses JSON for other providers. It checks existing native and desktop readers for additional sources. It skips a fallback file when its bytes exactly match a raw export for the same provider. A normalized session and a native source can describe the same conversation. File counts and session counts measure different things.
11
+
12
+ The archives include individual manifests. A private local receipt beside the first ZIP records the captured session URIs, custom source paths, exact matches, export failures, S3 keys and checksums. Each run creates a new snapshot. Individual large sources remain intact. Explicit storage-root overrides use the bundled native collector. Where the optional Agent Dump binary is unavailable, the command reports that it is using the bundled collector. Use Node 22 or later for Agent Dump. Standalone binaries use the native reader.
package/COVERAGE.md ADDED
@@ -0,0 +1,40 @@
1
+ # Coding tool coverage
2
+
3
+ The npm command uses Agent Dump first. See [capture behavior](CAPTURE.md) for primary exports, native fallbacks and receipts. The native adapter table below also applies to standalone downloads.
4
+
5
+ The standalone apps and the npm fallback use the native Go collector and detect existing histories for the 11 providers below. The original Python collector remains available for private deployments. Missing history is reported as zero candidate files. Capture retains raw histories; it does not convert every tool into a common event schema.
6
+
7
+ | CLI provider | Product | Capture | Validation |
8
+ | --- | --- | --- | --- |
9
+ | `claude` | Claude Code | Project JSONL and subagent JSONL | Synthetic archive/hash tests; local discovery |
10
+ | `codex` | Codex | Active/archived JSONL and JSONL.ZST | Synthetic archive/hash tests; local discovery |
11
+ | `cursor` | Cursor IDE | Agent transcripts; filtered SQLite chat rows | SQLite/WAL fixtures; local discovery |
12
+ | `opencode` | OpenCode | Allowlisted SQLite session/message/part tables; older JSON stores | Real OpenCode 1.19.5 free-model run in Docker; deployed Vercel/R2 flow; SQLite/WAL fixtures |
13
+ | `kimi` | Kimi Code CLI | Context and wire JSONL, including subagents | Primary-source layout check; synthetic files, exclusions, ZIP tests |
14
+ | `gemini` | Gemini CLI | Session JSON and JSONL under project chat directories | Primary-source layout check; synthetic old/new layouts, exclusions, ZIP tests |
15
+ | `copilot` | GitHub Copilot CLI | Session `events.jsonl` | Official storage docs; synthetic files, exclusions, ZIP tests |
16
+ | `cline` | Cline | API conversation, UI events, context history, task metadata | Primary-source filenames; synthetic editor/standalone layouts and exclusions |
17
+ | `roo` | Roo Code | Same allowlisted task histories in its extension storage | Primary-source filenames; synthetic editor/profile layouts and exclusions |
18
+ | `continue` | Continue | Saved session JSON files | Primary-source paths; synthetic files, exclusions, ZIP tests |
19
+ | `aider` | Aider | Project chat-history Markdown | Official option defaults; synthetic project selection/boundary and ZIP tests |
20
+
21
+ All adapters skip symlinks and preserve originals. macOS/Windows/Linux editor root calculations have fixture checks. This is not a claim of live testing each product/version on each OS. Aider captures selected projects only; alternate homes/profiles require flags. Histories can still contain secrets pasted into prompts or tool outputs, so excluding separate credential files does not make traces redacted.
22
+
23
+ The macOS npm reader preserves local Windsurf Cascade protobuf files. Amp remains outside automatic capture. Amp documents cloud-backed thread export; this client does not access its account or export API. No verified local Cascade decoder is included. Collecting Cline/Roo extensions inside the Windsurf editor is distinct from capturing Cascade itself.
24
+
25
+ Sources checked during implementation:
26
+
27
+ - [Kimi data locations](https://github.com/MoonshotAI/kimi-cli/blob/main/docs/en/configuration/data-locations.md)
28
+ - [Gemini chat recording](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/services/chatRecordingService.ts) and [storage paths](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/config/storage.ts)
29
+ - [Copilot session data](https://docs.github.com/en/enterprise-cloud%40latest/copilot/concepts/agents/copilot-cli/chronicle)
30
+ - [Cline storage filenames](https://github.com/cline/cline/blob/main/apps/vscode/src/core/storage/disk.ts)
31
+ - [Roo storage filenames](https://github.com/RooCodeInc/Roo-Code/blob/main/src/shared/globalFileNames.ts)
32
+ - [Continue session paths](https://github.com/continuedev/continue/blob/main/core/util/paths.ts)
33
+ - [Aider history defaults](https://aider.chat/docs/config/aider_conf.html)
34
+ - [Amp thread export](https://ampcode.com/docs/threads)
35
+
36
+ ## Distribution validation
37
+
38
+ The native collector has separate fixture tests for allowlisted file adapters, SQLite/WAL reads and credential-table exclusions, archive hashes, partial capture, output boundaries, installation IDs, and upload HTTP/checksum behavior. The npm launcher is tested without Python or shell access in PATH and has no install hooks or runtime npm dependencies. Release builds include fallback trusted certificate roots for minimal systems with no OS certificate bundle; normal OS certificate validation is preserved.
39
+
40
+ Executables are cross-built for Windows, macOS, and Linux on x64/ARM64. macOS ARM64 collection and Linux ARM64 collection/upload are runtime-tested; Linux x64 version execution is tested through Docker emulation. Windows and Intel macOS builds have not been run on native devices and are not signed/notarized with a trusted publisher identity.
package/README.md CHANGED
@@ -1,3 +1,12 @@
1
- # Temporary Holding Version
1
+ # Agent Trace Capture
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Run `npx agent-trace-capture` to take a one-time snapshot of local coding-agent histories and upload it to the configured capture service. The public service stores these captures in the Aionos AWS S3 bucket. Histories can include prompts, private code, tool output and secrets typed into a conversation. No personal AWS credentials are required.
4
+
5
+ - `npx agent-trace-capture --dry-run` lists discovered sessions and candidate paths without creating or uploading an archive.
6
+ - `npx agent-trace-capture --local-only --output traces.zip` keeps the archives on your computer.
7
+ - `npx agent-trace-capture --providers codex,cursor` limits collection to named providers.
8
+ - `--server-url` overrides the hosted destination. The client also accepts `AGENT_TRACE_SERVER_URL` and `AGENT_TRACE_UPLOAD_TOKEN`.
9
+
10
+ On supported installations, the command uses Agent Dump 1.2.12 to discover sessions, exports raw history where supported, and uses JSON for other providers. It checks existing native and desktop readers for additional sources. It skips a fallback file when its bytes exactly match a raw export for the same provider. A normalized session and a native source can describe the same conversation. File counts and session counts measure different things.
11
+
12
+ The archives include individual manifests. A private local receipt beside the first ZIP records the captured session URIs, custom source paths, exact matches, export failures, S3 keys and checksums. Each run creates a new snapshot. Individual large sources remain intact. Explicit storage-root overrides use the bundled native collector. Where the optional Agent Dump binary is unavailable, the command reports that it is using the bundled collector. Use Node 22 or later for Agent Dump. Standalone binaries use the native reader.