@lanegrid/agtrace 0.2.1 → 0.3.1

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.
Files changed (4) hide show
  1. package/CHANGELOG.md +160 -0
  2. package/README.md +4 -3
  3. package/npm-shrinkwrap.json +2 -2
  4. package/package.json +2 -2
package/CHANGELOG.md CHANGED
@@ -2,6 +2,166 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## [0.3.1] - 2026-01-01
6
+
7
+ ### Documentation
8
+
9
+ - Add Zero-Instrumentation point highlighting auto-discovery of provider logs ([ae2d2d9](https://github.com/lanegrid/agtrace/commit/ae2d2d9c56310e8b1a4061aba0039ebff4eae521))
10
+
11
+ - Add SDK badge (npm for CLI, crates.io for SDK) ([fcb34e0](https://github.com/lanegrid/agtrace/commit/fcb34e0f251e5ae7d689168c269df763ba12ad22))
12
+
13
+ - Update SDK version references from 0.2 to 0.3 ([8192c38](https://github.com/lanegrid/agtrace/commit/8192c38b21acb7eebf755f3759424a4cc8363aaf))
14
+
15
+
16
+ ### Miscellaneous Tasks
17
+
18
+ - Add GitHub issue templates for bug reports, feature requests, and provider support ([80f226d](https://github.com/lanegrid/agtrace/commit/80f226d8f9441762a065dc919ee5276ae4fa8cb1))
19
+
20
+ - Add GitHub label configuration and setup script ([bdf1407](https://github.com/lanegrid/agtrace/commit/bdf140748d3b0efb60880b194fd971ef75d9ad82))
21
+
22
+
23
+ ## [0.3.1] - 2026-01-01
24
+
25
+ ### Documentation
26
+
27
+ - Add Zero-Instrumentation point highlighting auto-discovery of provider logs ([ae2d2d9](https://github.com/lanegrid/agtrace/commit/ae2d2d9c56310e8b1a4061aba0039ebff4eae521))
28
+
29
+ - Add SDK badge (npm for CLI, crates.io for SDK) ([fcb34e0](https://github.com/lanegrid/agtrace/commit/fcb34e0f251e5ae7d689168c269df763ba12ad22))
30
+
31
+ - Update SDK version references from 0.2 to 0.3 ([8192c38](https://github.com/lanegrid/agtrace/commit/8192c38b21acb7eebf755f3759424a4cc8363aaf))
32
+
33
+
34
+ ### Miscellaneous Tasks
35
+
36
+ - Add GitHub issue templates for bug reports, feature requests, and provider support ([80f226d](https://github.com/lanegrid/agtrace/commit/80f226d8f9441762a065dc919ee5276ae4fa8cb1))
37
+
38
+ - Add GitHub label configuration and setup script ([bdf1407](https://github.com/lanegrid/agtrace/commit/bdf140748d3b0efb60880b194fd971ef75d9ad82))
39
+
40
+
41
+ ## [0.3.1] - 2026-01-01
42
+
43
+ ### Documentation
44
+
45
+ - Add Zero-Instrumentation point highlighting auto-discovery of provider logs ([ae2d2d9](https://github.com/lanegrid/agtrace/commit/ae2d2d9c56310e8b1a4061aba0039ebff4eae521))
46
+
47
+ - Add SDK badge (npm for CLI, crates.io for SDK) ([fcb34e0](https://github.com/lanegrid/agtrace/commit/fcb34e0f251e5ae7d689168c269df763ba12ad22))
48
+
49
+ - Update SDK version references from 0.2 to 0.3 ([8192c38](https://github.com/lanegrid/agtrace/commit/8192c38b21acb7eebf755f3759424a4cc8363aaf))
50
+
51
+
52
+ ### Miscellaneous Tasks
53
+
54
+ - Add GitHub issue templates for bug reports, feature requests, and provider support ([80f226d](https://github.com/lanegrid/agtrace/commit/80f226d8f9441762a065dc919ee5276ae4fa8cb1))
55
+
56
+ - Add GitHub label configuration and setup script ([bdf1407](https://github.com/lanegrid/agtrace/commit/bdf140748d3b0efb60880b194fd971ef75d9ad82))
57
+
58
+
59
+ ## [0.3.1] - 2026-01-01
60
+
61
+ ### Documentation
62
+
63
+ - Add Zero-Instrumentation point highlighting auto-discovery of provider logs ([ae2d2d9](https://github.com/lanegrid/agtrace/commit/ae2d2d9c56310e8b1a4061aba0039ebff4eae521))
64
+
65
+ - Add SDK badge (npm for CLI, crates.io for SDK) ([fcb34e0](https://github.com/lanegrid/agtrace/commit/fcb34e0f251e5ae7d689168c269df763ba12ad22))
66
+
67
+ - Update SDK version references from 0.2 to 0.3 ([8192c38](https://github.com/lanegrid/agtrace/commit/8192c38b21acb7eebf755f3759424a4cc8363aaf))
68
+
69
+
70
+ ### Miscellaneous Tasks
71
+
72
+ - Add GitHub issue templates for bug reports, feature requests, and provider support ([80f226d](https://github.com/lanegrid/agtrace/commit/80f226d8f9441762a065dc919ee5276ae4fa8cb1))
73
+
74
+ - Add GitHub label configuration and setup script ([bdf1407](https://github.com/lanegrid/agtrace/commit/bdf140748d3b0efb60880b194fd971ef75d9ad82))
75
+
76
+
77
+ ## [0.3.0] - 2026-01-01
78
+
79
+ ### Bug Fixes
80
+
81
+ - *(types)* Add missing server and tool fields to McpArgs test initialization ([11d6e65](https://github.com/lanegrid/agtrace/commit/11d6e65db8558f0198f5811dff1a6e1f1b798d08))
82
+
83
+ - *(codex)* Make exit code regex case-insensitive to correctly detect errors ([db204f9](https://github.com/lanegrid/agtrace/commit/db204f9b72d9e8903d18bd1ce9dc24293963f319))
84
+
85
+ - *(providers)* Resolve all clippy lint warnings and update TokenUsagePayload schema usage ([032a95a](https://github.com/lanegrid/agtrace/commit/032a95a1a4e9db0d3eba498a6ce9bb7431383f6c))
86
+
87
+ - *(watch)* Remove hardcoded context window fallback in TUI to match console behavior ([5432bc7](https://github.com/lanegrid/agtrace/commit/5432bc783e92fa3488fa191a7e0699f537a117ff))
88
+
89
+ - *(watch)* Use assembled session for accurate cumulative token display in TUI ([0f9d292](https://github.com/lanegrid/agtrace/commit/0f9d292c9dd0a208b46071c072ec2f98e19b0d04))
90
+
91
+ - *(watch)* Use same cumulative token logic as SATURATION HISTORY in dashboard ([4862b92](https://github.com/lanegrid/agtrace/commit/4862b92c4ca44947be6f0cf53f84b682dfeae024))
92
+
93
+ - Correct token double-counting in extract_state_updates (fresh_input should use uncached only) ([f9f4431](https://github.com/lanegrid/agtrace/commit/f9f4431faaf55a0baa9f8627d54d1cf22a73e640))
94
+
95
+
96
+ ### Documentation
97
+
98
+ - Add comprehensive doc comments to SDK re-exported types ([9db448b](https://github.com/lanegrid/agtrace/commit/9db448b6204ad68db08e245e810188cf52b24145))
99
+
100
+ - *(providers)* Add token conversion rationale for each provider (Claude/Codex/Gemini) ([090826c](https://github.com/lanegrid/agtrace/commit/090826c5779941f1929d913ce9a5095bbc98ac5c))
101
+
102
+
103
+ ### Features
104
+
105
+ - *(sdk)* Add tool_call_stats example for analyzing tool usage across sessions ([598b74a](https://github.com/lanegrid/agtrace/commit/598b74ad710594529ae6c3fd449d42b93f82178e))
106
+
107
+ - *(sdk)* Refactor tool_call_stats to show detailed per-provider statistics ([abc9c5f](https://github.com/lanegrid/agtrace/commit/abc9c5f5e72d687e5f0999571ff979f7bbde35f4))
108
+
109
+ - *(sdk)* Add normalized ToolKind statistics to tool_call_stats example ([8f5cffd](https://github.com/lanegrid/agtrace/commit/8f5cffd7385dfad2cd2d7c084a47bbdf81d52f7b))
110
+
111
+ - *(sdk)* Add Execute command statistics to tool_call_stats example ([1b9fd49](https://github.com/lanegrid/agtrace/commit/1b9fd49afcb3572b25558dbc46b30cf5e6156c64))
112
+
113
+ - *(sdk)* Add per-tool-name Execute command breakdown in tool_call_stats ([625ab94](https://github.com/lanegrid/agtrace/commit/625ab949dbec48803ae2583c5720f0938074563a))
114
+
115
+ - *(sdk)* Add command pattern statistics to tool_call_stats (reveals sed usage in codex) ([c98ff8d](https://github.com/lanegrid/agtrace/commit/c98ff8dfd79d0dfe1a919180d96d0670d17d2b12))
116
+
117
+ - *(codex)* Classify read-oriented shell commands as Read instead of Execute ([408b4b8](https://github.com/lanegrid/agtrace/commit/408b4b869d3b62f2bbd67db064b6e40c366d1c17))
118
+
119
+ - *(gemini)* Detect MCP tools via display_name pattern instead of mcp__ prefix ([cb1b83f](https://github.com/lanegrid/agtrace/commit/cb1b83ffd423ec92c871395aa76ef3d12d996163))
120
+
121
+ - *(codex)* Classify pattern search commands (rg/grep) as Search instead of Read ([27de169](https://github.com/lanegrid/agtrace/commit/27de169379d4b7164277ff88bd0fabe3775311ca))
122
+
123
+ - *(sdk)* Add provider efficiency comparison example ([37f3350](https://github.com/lanegrid/agtrace/commit/37f335004b5c78a7795f33e6ea62d8436f9219d4))
124
+
125
+ - *(engine)* Migrate to ContextWindowUsage with last-wins semantics for turn aggregation ([9e433b2](https://github.com/lanegrid/agtrace/commit/9e433b278710b1fbadab86399b638e4e21668c87))
126
+
127
+
128
+ ### Miscellaneous Tasks
129
+
130
+ - Move debug examples to sdk/examples/debug and gitignore them ([d3ca56e](https://github.com/lanegrid/agtrace/commit/d3ca56ecd9634e45af8383833d8de9a2089a76a8))
131
+
132
+ - Remove debug script ([99be7ca](https://github.com/lanegrid/agtrace/commit/99be7caf71fc722c817982f254a0956aaf560df8))
133
+
134
+
135
+ ### Refactor
136
+
137
+ - Move AgentSession and related types from agtrace-engine to agtrace-types ([cd7ed18](https://github.com/lanegrid/agtrace/commit/cd7ed18f402dc9b26f07c3eabd89df6ad137376e))
138
+
139
+ - Extract compute_turn_metrics to SessionAnalysisExt in agtrace-engine ([99ecfeb](https://github.com/lanegrid/agtrace/commit/99ecfebeb6060f4b755e349655e7d7c9896bb350))
140
+
141
+ - Move MCP tool name parsing from agtrace-types to agtrace-providers ([c86807f](https://github.com/lanegrid/agtrace/commit/c86807f286b6e0039fd4e64820b4c590ab90b772))
142
+
143
+ - Add MCP tool name parsing to Codex provider ([30eb2d9](https://github.com/lanegrid/agtrace/commit/30eb2d98c9fafb9cabaf65efecef052a144ec416))
144
+
145
+ - Add server and tool fields to McpArgs for structured MCP data ([6598568](https://github.com/lanegrid/agtrace/commit/65985684c92a13b742e816df354f7598864cbf62))
146
+
147
+ - Move MCP normalization to provider mappers and deprecate normalize_tool_call (resolves #26) ([0345d6e](https://github.com/lanegrid/agtrace/commit/0345d6e3d9804c43e8d20cb642ff6d9ecd92e473))
148
+
149
+ - Change SessionFilter.limit to Option<usize> for unlimited session queries and add provider statistics to tool_call_stats example ([7b79cb7](https://github.com/lanegrid/agtrace/commit/7b79cb7a915161762395f4e00ce4e7d7a7f9124a))
150
+
151
+ - *(providers)* Use trait-based ProviderAdapter in fixture generation example ([0972303](https://github.com/lanegrid/agtrace/commit/0972303479eb55b040756e6f9d651a6174d635e5))
152
+
153
+ - *(types)* Normalize TokenUsage schema across providers (Claude/Codex/Gemini) ([5fd2334](https://github.com/lanegrid/agtrace/commit/5fd2334001367096fa41cfe5acf017e0360325c6))
154
+
155
+ - *(engine)* Remove providers dependency from tests to fix layer violation ([9c7a08a](https://github.com/lanegrid/agtrace/commit/9c7a08a1ae02bc0934bc361be6a58b826d700b55))
156
+
157
+ - Restore original token aggregation logic while preserving TokenUsagePayload schema ([ce0e162](https://github.com/lanegrid/agtrace/commit/ce0e162450b3af7ed16aa23fe84e00e6ec923122))
158
+
159
+
160
+ ### Testing
161
+
162
+ - Regenerate fixtures and update snapshots for TokenUsagePayload schema changes ([1f71815](https://github.com/lanegrid/agtrace/commit/1f7181537faaafc80246e04c843c000bf9145b00))
163
+
164
+
5
165
  ## [0.2.1] - 2025-12-31
6
166
 
7
167
  ### Bug Fixes
package/README.md CHANGED
@@ -4,8 +4,8 @@
4
4
  <p><strong>The Observability Platform for AI Agents.</strong></p>
5
5
  <p>Local-first OpenTelemetry for Claude, Codex, and Gemini.</p>
6
6
 
7
- [![npm version](https://img.shields.io/npm/v/@lanegrid/agtrace.svg?style=flat)](https://www.npmjs.com/package/@lanegrid/agtrace)
8
- [![crates.io](https://img.shields.io/crates/v/agtrace.svg)](https://crates.io/crates/agtrace)
7
+ [![npm](https://img.shields.io/npm/v/@lanegrid/agtrace.svg?style=flat&label=npm)](https://www.npmjs.com/package/@lanegrid/agtrace)
8
+ [![crates.io](https://img.shields.io/crates/v/agtrace-sdk.svg?label=SDK)](https://crates.io/crates/agtrace-sdk)
9
9
  </div>
10
10
 
11
11
  ---
@@ -20,6 +20,7 @@ Use the **CLI** for instant visualization, or build custom monitoring tools with
20
20
  1. **Universal Normalization**: Converts diverse provider logs (Claude, Gemini, etc.) into a standard `AgentEvent` model.
21
21
  2. **Schema-on-Read**: Resilient to provider updates. No database migrations needed.
22
22
  3. **Local-First**: 100% offline. Privacy by design.
23
+ 4. **Zero-Instrumentation**: Automatically detects and watches logs from standard locations (`~/.claude/projects`, `~/.codex/sessions`, `~/.gemini/tmp`). No code changes required.
23
24
 
24
25
  ## 🚀 Quick Start (CLI)
25
26
 
@@ -38,7 +39,7 @@ Embed agent observability into your own tools (vital-checkers, IDE plugins, dash
38
39
 
39
40
  ```toml
40
41
  [dependencies]
41
- agtrace-sdk = "0.2"
42
+ agtrace-sdk = "0.3"
42
43
  ```
43
44
 
44
45
  ```rust,no_run
package/npm-shrinkwrap.json CHANGED
@@ -23,7 +23,7 @@
23
23
  "hasInstallScript": true,
24
24
  "license": "MIT OR Apache-2.0",
25
25
  "name": "@lanegrid/agtrace",
26
- "version": "0.2.1"
26
+ "version": "0.3.1"
27
27
  },
28
28
  "node_modules/@isaacs/balanced-match": {
29
29
  "engines": {
@@ -515,5 +515,5 @@
515
515
  }
516
516
  },
517
517
  "requires": true,
518
- "version": "0.2.1"
518
+ "version": "0.3.1"
519
519
  }
package/package.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "artifactDownloadUrl": "https://github.com/lanegrid/agtrace/releases/download/v0.2.1",
2
+ "artifactDownloadUrl": "https://github.com/lanegrid/agtrace/releases/download/v0.3.1",
3
3
  "bin": {
4
4
  "agtrace": "run-agtrace.js"
5
5
  },
@@ -93,7 +93,7 @@
93
93
  "zipExt": ".tar.xz"
94
94
  }
95
95
  },
96
- "version": "0.2.1",
96
+ "version": "0.3.1",
97
97
  "volta": {
98
98
  "node": "18.14.1",
99
99
  "npm": "9.5.0"