[feature]: Craft Agent Integration & DeepSeek API Support

[LINYI1992]

What problem does this solve?

TokenTracker currently works well for tracking token usage from CLI tools and supported providers, but it lacks:

• visibility into agent-based workflows (e.g., Craft Agent), where token usage happens across multiple steps and tool calls
• support for newer LLM providers like DeepSeek, which are increasingly used for cost-efficient inference

This makes it harder to use TokenTracker in more advanced or production AI setups.

Proposed solution

1. Add basic integration support for agent frameworks like Craft Agent:
   • track token usage per task / step
   • allow passing simple metadata (e.g., task_id, agent_name)
2. Add DeepSeek API support:
   • support deepseek-v4
   • track token usage and cost via OpenAI-compatible interface

A lightweight implementation (e.g., wrapper or adapter) would already be very helpful.

⸻

Thanks for the great project!

Alternatives considered

No response

Category

New AI tool integration

Anything else?

No response

[linear]

001-76

[mm7894215]

Hi @LINYICo — thanks for the great suggestion! Both halves of this request shipped in v0.5.101 today.

What landed

1. Craft Agents integration (lukilabs/craft-agents-oss)

A new passive JSONL reader (no hooks to install — TokenTracker just reads the session files Craft already writes):

• Discovers sessions under ~/.craft-agent/workspaces/<id>/sessions/<sid>/session.jsonl
• Honors user-relocated workspaces listed in ~/.craft-agent/config.json
• Reads the pre-aggregated SessionTokenUsage block on the session header line and routes growing-snapshot deltas into 30-min UTC buckets
• 10 new unit tests cover delta-vs-cumulative semantics, cross-hour-bucket routing, least-recently-seen cap eviction, and multi-workspace discovery
• CRAFT_CONFIG_DIR env var lets you point at a non-default config directory if needed

2. DeepSeek API support

Craft Agents already exposes DeepSeek as a first-class provider (deepseek-v4-pro / deepseek-v4-flash), so any DeepSeek session you run through Craft is now tracked automatically. We also fixed pricing for the legacy deepseek-chat / deepseek-reasoner names which DeepSeek's docs say map to v4-flash modes — these previously inherited stale LiteLLM prices ($0.28 / $0.42) and now correctly resolve to v4-flash pricing ($0.14 / $0.28). The v4-pro 75% promotional discount is also pinned and we have a scheduled check on 2026-06-01 to verify after the discount expires.

Heads-up — needs deeper testing

We don't have a heavy Craft Agents installed user base yet, so the integration was end-to-end tested against the real session schema (synthesized from the upstream packages/shared/src/sessions/types.ts), but not against a long-running real-world Craft session with mixed providers. If you actively use Craft Agents, please give it a thorough try and report back:

• Install / upgrade: npm install -g tokentracker-cli@0.5.101 (or brew upgrade tokentracker once the Homebrew tap auto-updates within an hour)
• Run a few sessions in Craft (especially DeepSeek + Anthropic + any non-default workspace location)
• tokentracker sync — should report Parsing Craft … buckets N
• tokentracker status — should show Craft Agents: passive reader (X session jsonl files found)
• Open the dashboard and confirm the model breakdown attributes tokens to the correct provider/model

If anything goes wrong — wrong token counts, missing sessions, sessions in custom workspace paths not picked up, model names showing as craft-unknown when they shouldn't, or any other surprise — please open a fresh issue with tokentracker diagnostics output attached. Closing this for now since the feature shipped, but happy to keep iterating based on real usage.

Closing as completed. Thanks again! 🙏