codeburn/docs/providers
Resham Joshi 354492e500
Some checks are pending
CI / semgrep (push) Waiting to run
Tests / test (22) (push) Waiting to run
Tests / test (22.13.0) (push) Waiting to run
Tests / test (24) (push) Waiting to run
Tests / test (26) (push) Waiting to run
Tests / test-platforms (macos-latest) (push) Waiting to run
Tests / test-platforms (windows-latest) (push) Waiting to run
Tests / desktop (push) Waiting to run
Tests / vscode (push) Waiting to run
Copilot: count every agent round and bill exact credits in VS Code chat sessions (#1752)
* Copilot: count every agent round and exact credits in VS Code chat sessions

Copilot Chat 0.69 keeps only the last model call of an agent request in result.metadata. Read the request's modelTotals (input, cache reads, output over every call) first, then root completionTokens, then metadata. Carry copilotCredits as nanoAiu so plan credits are exact. Bump the copilot parse tag so cached chat sessions re-parse.

modelKeyMatches no longer lets claude-sonnet-4 capture claude-sonnet-4-6.

* Copilot: bill chat-session credits exactly and skip agent-host twins

A chat-session request that records copilotCredits now costs credits x $0.01 through costFromBilling; requests without it stay priced from tokens. A chat session whose id matches a session-state dir is left to the agent-host path so it is counted once.

* Copilot: drop agent-host twins at serve time, rate chat requests one by one, re-derive past days

A chat-session journal request is left out when the same session has billed agent-host usage (session-state calls with tokens or nanoAiu, or session-store rows). Plan credits rate chat-session requests individually, so older requests in a mixed session keep their estimate. DAILY_CACHE_VERSION 75 with copilot pending re-derive so settled days pick up the new counts.
2026-10-13 01:02:04 +02:00
..
amp.md feat: Amp support - read the local thread mirror (#1572) (#1578) 2026-10-02 10:36:05 +02:00
antigravity.md fix(antigravity): count cache reads and price the standalone app's model (#1655) 2026-10-06 20:58:31 +02:00
claude.md fix(claude): discover macOS Claude-3p Cowork sessions (#1579) 2026-10-07 20:30:50 +02:00
cline-cli.md chore: remove Roo Code support (#1551) 2026-09-24 21:34:39 +02:00
cline.md chore: remove Roo Code support (#1551) 2026-09-24 21:34:39 +02:00
codebuff.md docs: sync provider registry, test inventory, and Gemini page with the tree 2026-09-01 05:27:15 -07:00
codewhale.md Scope the root test script to tests/ so npm test runs from a clean install 2026-08-09 10:19:58 -05:00
codex.md feat(codex): show thread names from session_index.jsonl (#1687) 2026-10-09 13:25:13 +02:00
command-code.md feat(providers): add Command Code (#1658) 2026-10-07 00:18:50 +02:00
copilot.md Copilot: count every agent round and bill exact credits in VS Code chat sessions (#1752) 2026-10-13 01:02:04 +02:00
crush.md fix(providers): accept Crush's {"projects":[...]} registry shape (#1510) 2026-09-23 17:50:42 +02:00
cursor-agent.md fix(cursor-agent): leave Cursor IDE chat transcripts to the cursor provider (#1717) 2026-10-10 07:05:35 +02:00
cursor.md fix(cursor): stop counting billed CLI sessions twice, mark guessed-model sync rows estimated (#1654) 2026-10-06 20:43:24 +02:00
devin.md feat(devin): read usage from sessions.db (#1605) 2026-10-02 16:42:57 +02:00
droid.md Add CONTRIBUTING.md, docs/architecture.md, and per-provider docs (#284) 2026-05-09 18:39:41 -07:00
dsh.md Read DSH session format v4 written by dsh 0.2.0-rc.2 (#1612) 2026-10-05 11:54:55 +02:00
forge.md feat(providers): add forge provider support (#401) 2026-05-26 03:36:57 -07:00
gemini.md docs: sync provider registry, test inventory, and Gemini page with the tree 2026-09-01 05:27:15 -07:00
goose.md Add CONTRIBUTING.md, docs/architecture.md, and per-provider docs (#284) 2026-05-09 18:39:41 -07:00
grok.md docs(grok): state the mixed-session drop and the global daily re-derivation plainly 2026-08-18 10:22:36 -07:00
grokbot.md Grok Bot: sessions, estimated spend and the weekly allowance on all three surfaces (#1462) 2026-09-16 21:17:48 +02:00
hermes.md Find Hermes sessions in Windows local app data (#1617) 2026-10-04 21:01:04 +02:00
ibm-bob.md chore: remove Roo Code support (#1551) 2026-09-24 21:34:39 +02:00
kilo-code.md chore: remove Roo Code support (#1551) 2026-09-24 21:34:39 +02:00
kimi.md Add Kimi provider 2026-05-11 19:02:28 +03:00
kimicode.md kimicode: discover desktop-runtime sessions and fix menubar visibility 2026-07-23 21:31:25 +02:00
kiro.md fix(parser): flatten already-sliced previews and memoize canonical path walks 2026-08-16 01:49:10 -07:00
lingtai-tui.md Scope the root test script to tests/ so npm test runs from a clean install 2026-08-09 10:19:58 -05:00
mistral-vibe.md Restore usage from Mistral Vibe Unified Harness sessions (#1599) 2026-10-06 21:15:06 +02:00
mux.md feat(providers): add coder/mux as a datasource (#438) 2026-06-06 03:04:24 +02:00
NEW_PROVIDER.md chore: pin node via .nvmrc, add the new-provider checklist 2026-08-04 03:17:41 +03:00
omp.md Add CONTRIBUTING.md, docs/architecture.md, and per-provider docs (#284) 2026-05-09 18:39:41 -07:00
open-design.md docs: sync provider registry, test inventory, and Gemini page with the tree 2026-09-01 05:27:15 -07:00
openclaude.md feat(openclaude): OpenClaude CLI provider (#213) 2026-08-04 04:05:25 +03:00
openclaw.md fix(openclaw): read the per-agent sqlite transcript store the 2026-09-01 migration writes (#1526) 2026-09-28 19:17:20 +02:00
opencode.md fix(opencode): Vertex sessions no longer show $0 (#1552) 2026-09-25 00:01:02 +02:00
pi.md fix(pi): classify native skill loads as Skill, not Read (#588) (#590) 2026-07-01 15:57:31 +02:00
quickdesk.md feat(quickdesk): Amazon Quick Desktop provider, parse ~/.quickwork sessions and metrics (#707) 2026-07-18 00:02:01 +03:00
qwen.md Add CONTRIBUTING.md, docs/architecture.md, and per-provider docs (#284) 2026-05-09 18:39:41 -07:00
README.md feat(providers): add Command Code (#1658) 2026-10-07 00:18:50 +02:00
vercel-gateway.md chore: remove Roo Code support (#1551) 2026-09-24 21:34:39 +02:00
vscode-cline-parser.md chore: remove Roo Code support (#1551) 2026-09-24 21:34:39 +02:00
warp.md feat: add Warp provider adapter (#350) 2026-05-21 00:19:53 -07:00
zcode.md feat(quota): add ZCode (z.ai coding plan) live quota provider (#1347) 2026-09-18 18:11:08 -07:00
zed.md release: 0.9.15 2026-07-02 06:19:14 +02:00
zerostack.md Add zerostack provider (#519) 2026-06-19 14:44:45 +02:00

Provider Docs

One file per provider integration. If you are fixing a bug or adding a feature scoped to a single provider, read the file for that provider first; it tells you which file to edit, where on disk the source data lives, and what edge cases the test suite already covers.

For the architectural picture, see ../architecture.md.

Provider Index

Eager (always loaded)

Provider Storage Source Test
Amp JSON (per-thread) src/providers/amp.ts tests/providers/amp.test.ts
Claude JSONL (no parser) src/providers/claude.ts none (covered indirectly)
Cline JSON src/providers/cline.ts tests/providers/cline.test.ts
Cline CLI JSON src/providers/cline-cli.ts tests/providers/cline-cli.test.ts
CodeWhale JSON src/providers/codewhale.ts tests/providers/codewhale.test.ts
Command Code JSONL src/providers/command-code.ts tests/providers/command-code.test.ts
Codebuff JSON src/providers/codebuff.ts tests/providers/codebuff.test.ts
Codex JSONL src/providers/codex.ts tests/providers/codex.test.ts
Copilot JSONL + SQLite (OTel) + Nitrite .db (JetBrains) src/providers/copilot.ts tests/providers/copilot.test.ts
Devin JSON + SQLite enrichment src/providers/devin.ts tests/providers/devin.test.ts
Droid JSONL src/providers/droid.ts tests/providers/droid.test.ts
DeepSeek Harness JSONL (zstd frames) src/providers/dsh.ts tests/providers/dsh.test.ts
Gemini JSON / JSONL src/providers/gemini.ts tests/providers/gemini.test.ts
Hermes Agent SQLite src/providers/hermes.ts tests/providers/hermes.test.ts
IBM Bob JSON src/providers/ibm-bob.ts tests/providers/ibm-bob.test.ts
KiloCode JSON src/providers/kilo-code.ts tests/providers/kilo-code.test.ts
Kiro JSON src/providers/kiro.ts tests/providers/kiro.test.ts
Kimi JSONL src/providers/kimi.ts tests/providers/kimi.test.ts
Kimi Code JSONL src/providers/kimicode.ts tests/providers/kimicode.test.ts
LingTai TUI JSONL src/providers/lingtai-tui.ts tests/providers/lingtai-tui.test.ts
Mistral Vibe JSON / JSONL src/providers/mistral-vibe.ts tests/providers/mistral-vibe.test.ts
Mux JSONL src/providers/mux.ts tests/providers/mux.test.ts
OpenClaw JSONL src/providers/openclaw.ts tests/providers/openclaw.test.ts
OpenClaude JSONL src/providers/openclaude.ts tests/providers/openclaude.test.ts
Open Design JSONL src/providers/open-design.ts tests/providers/open-design.test.ts
Pi JSONL src/providers/pi.ts tests/providers/pi.test.ts
OMP JSONL src/providers/pi.ts tests/providers/omp.test.ts
Qwen JSONL src/providers/qwen.ts none
Quick Desktop EMF JSONL + SQLite src/providers/quickdesk.ts tests/providers/quickdesk.test.ts
Zerostack JSON src/providers/zerostack.ts tests/providers/zerostack.test.ts
Grok Build JSON/JSONL src/providers/grok.ts tests/providers/grok.test.ts
Grok Bot JSON src/providers/grokbot.ts tests/providers/grokbot.test.ts

Lazy (loaded on first call)

Provider Storage Source Test
Antigravity protobuf over RPC src/providers/antigravity.ts tests/providers/antigravity.test.ts
Crush SQLite (per-project) src/providers/crush.ts tests/providers/crush.test.ts
Forge SQLite src/providers/forge.ts tests/providers/forge.test.ts
Cursor SQLite src/providers/cursor.ts tests/providers/cursor.test.ts
Cursor Agent text / JSONL src/providers/cursor-agent.ts tests/providers/cursor-agent.test.ts
Goose SQLite src/providers/goose.ts none
OpenCode SQLite src/providers/opencode.ts tests/providers/opencode.test.ts
Warp SQLite src/providers/warp.ts tests/providers/warp.test.ts
Vercel AI Gateway REST API src/providers/vercel-gateway.ts tests/providers/vercel-gateway.test.ts
ZCode SQLite (usage) + z.ai quota endpoint (plan) src/providers/zcode.ts, src/quota/zcode.ts tests/providers/zcode.test.ts, tests/quota-zcode.test.ts
Zed SQLite src/providers/zed.ts tests/providers/zed.test.ts

Shared

Helper Used by Source
vscode-cline-parser cline, ibm-bob, kilo-code src/providers/vscode-cline-parser.ts

File Format

Each provider doc has the same structure:

  1. One-line summary of what the provider integrates.
  2. Where it reads from on disk (or over RPC).
  3. Storage format and validation rules.
  4. Caching (which cache layer, if any).
  5. Deduplication key so you understand cross-provider dedup.
  6. Quirks that have bitten us before.
  7. When fixing a bug here as a checklist.

If you add a new provider, copy claude.md as a template and fill in your provider's specifics. Update this index, and prefer adding a real test fixture under tests/providers/.