trickle-cli 0.1.192 → 0.1.193

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.
@@ -515,8 +515,12 @@ trickle flamegraph
515
515
 
516
516
  1. **Get overview**: \`trickle summary\` — status, errors, N+1 queries, root causes, fix recommendations
517
517
  2. **Understand a file**: \`trickle explain ${exampleFile}\` — functions, call graph, data flow, queries, variables
518
- 3. **Debug errors**: \`trickle context --errors\` — errors with nearby variable values
518
+ 3. **Debug errors**: \`trickle why\` — causal chain: error call trace → variables → LLM reasoning
519
519
  4. **Fix & verify**: \`trickle verify --baseline\` → fix code → \`${runCmd}\` → \`trickle verify\`
520
+ 5. **Evaluate quality**: \`trickle eval\` — A-F reliability score (completion, errors, cost, tools, latency)
521
+ 6. **Check security**: \`trickle security\` — prompt injection, privilege escalation, data exfiltration
522
+ 7. **LLM costs**: \`trickle cost-report\` — cost breakdown by provider/model with budget checking
523
+ 8. **Compliance**: \`trickle audit --compliance\` — risk classification, decision lineage, audit trail
520
524
 
521
525
  ### MCP Server (recommended for Claude Code)
522
526
 
@@ -533,19 +537,21 @@ Add to \`.claude/settings.json\` or \`claude_desktop_config.json\`:
533
537
  }
534
538
  \`\`\`
535
539
 
536
- Key MCP tools (26 total):
540
+ Key MCP tools (38 total):
537
541
 
538
542
  | Tool | Use for |
539
543
  |------|---------|
540
544
  | \`get_recommended_actions\` | Start here — tells you exactly what to do next |
541
545
  | \`get_last_run_summary\` | Complete overview: errors, queries, alerts, root causes |
546
+ | \`why\` | Causal debugging: trace back from error to root cause |
542
547
  | \`explain_file\` | Understand a file: functions, call graph, data flow, queries |
543
548
  | \`run_tests\` | Run tests with structured pass/fail + runtime context |
544
549
  | \`get_flamegraph\` | Performance hotspots sorted by execution time |
545
- | \`get_errors\` | Errors with variable values at the error location |
550
+ | \`get_llm_calls\` | LLM API calls with tokens, cost, latency |
551
+ | \`get_agent_trace\` | Agent execution tree with parent-child relationships |
552
+ | \`get_mcp_tool_calls\` | MCP tool invocations with latency and direction |
553
+ | \`get_cost_report\` | Cost breakdown by provider/model with budget check |
546
554
  | \`save_baseline\` / \`compare_with_baseline\` | Before/after comparison for fix verification |
547
- | \`get_new_alerts\` | Polling-based monitoring for new issues |
548
- | \`refresh_runtime_data\` | Re-run the app to capture fresh data |
549
555
 
550
556
  ### What trickle Captures (automatically, zero config)
551
557
 
@@ -556,6 +562,9 @@ Key MCP tools (26 total):
556
562
  - **Logs**: winston, pino, bunyan (JS); logging, loguru, structlog (Python)
557
563
  - **HTTP requests**: fetch/requests calls with status + latency
558
564
  - **Call traces**: execution flow with parent-child relationships
565
+ - **LLM calls**: OpenAI, Anthropic, Gemini — model, tokens, cost, latency (auto-detected)
566
+ - **Agent workflows**: LangChain, CrewAI, Claude Agent SDK, OpenAI Agents SDK (auto-detected)
567
+ - **MCP tool calls**: tool name, arguments, response, latency, direction
559
568
  - **Memory**: RSS + heap snapshots
560
569
  `;
561
570
  fs.writeFileSync(claudePath, content, "utf-8");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "trickle-cli",
3
- "version": "0.1.192",
3
+ "version": "0.1.193",
4
4
  "description": "CLI for trickle runtime type observability",
5
5
  "bin": {
6
6
  "trickle": "dist/index.js"
@@ -546,8 +546,12 @@ trickle flamegraph
546
546
 
547
547
  1. **Get overview**: \`trickle summary\` — status, errors, N+1 queries, root causes, fix recommendations
548
548
  2. **Understand a file**: \`trickle explain ${exampleFile}\` — functions, call graph, data flow, queries, variables
549
- 3. **Debug errors**: \`trickle context --errors\` — errors with nearby variable values
549
+ 3. **Debug errors**: \`trickle why\` — causal chain: error call trace → variables → LLM reasoning
550
550
  4. **Fix & verify**: \`trickle verify --baseline\` → fix code → \`${runCmd}\` → \`trickle verify\`
551
+ 5. **Evaluate quality**: \`trickle eval\` — A-F reliability score (completion, errors, cost, tools, latency)
552
+ 6. **Check security**: \`trickle security\` — prompt injection, privilege escalation, data exfiltration
553
+ 7. **LLM costs**: \`trickle cost-report\` — cost breakdown by provider/model with budget checking
554
+ 8. **Compliance**: \`trickle audit --compliance\` — risk classification, decision lineage, audit trail
551
555
 
552
556
  ### MCP Server (recommended for Claude Code)
553
557
 
@@ -564,19 +568,21 @@ Add to \`.claude/settings.json\` or \`claude_desktop_config.json\`:
564
568
  }
565
569
  \`\`\`
566
570
 
567
- Key MCP tools (26 total):
571
+ Key MCP tools (38 total):
568
572
 
569
573
  | Tool | Use for |
570
574
  |------|---------|
571
575
  | \`get_recommended_actions\` | Start here — tells you exactly what to do next |
572
576
  | \`get_last_run_summary\` | Complete overview: errors, queries, alerts, root causes |
577
+ | \`why\` | Causal debugging: trace back from error to root cause |
573
578
  | \`explain_file\` | Understand a file: functions, call graph, data flow, queries |
574
579
  | \`run_tests\` | Run tests with structured pass/fail + runtime context |
575
580
  | \`get_flamegraph\` | Performance hotspots sorted by execution time |
576
- | \`get_errors\` | Errors with variable values at the error location |
581
+ | \`get_llm_calls\` | LLM API calls with tokens, cost, latency |
582
+ | \`get_agent_trace\` | Agent execution tree with parent-child relationships |
583
+ | \`get_mcp_tool_calls\` | MCP tool invocations with latency and direction |
584
+ | \`get_cost_report\` | Cost breakdown by provider/model with budget check |
577
585
  | \`save_baseline\` / \`compare_with_baseline\` | Before/after comparison for fix verification |
578
- | \`get_new_alerts\` | Polling-based monitoring for new issues |
579
- | \`refresh_runtime_data\` | Re-run the app to capture fresh data |
580
586
 
581
587
  ### What trickle Captures (automatically, zero config)
582
588
 
@@ -587,6 +593,9 @@ Key MCP tools (26 total):
587
593
  - **Logs**: winston, pino, bunyan (JS); logging, loguru, structlog (Python)
588
594
  - **HTTP requests**: fetch/requests calls with status + latency
589
595
  - **Call traces**: execution flow with parent-child relationships
596
+ - **LLM calls**: OpenAI, Anthropic, Gemini — model, tokens, cost, latency (auto-detected)
597
+ - **Agent workflows**: LangChain, CrewAI, Claude Agent SDK, OpenAI Agents SDK (auto-detected)
598
+ - **MCP tool calls**: tool name, arguments, response, latency, direction
590
599
  - **Memory**: RSS + heap snapshots
591
600
  `;
592
601