agent-inspect 1.0.0 → 1.0.2
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/CHANGELOG.md +105 -0
- package/README.md +168 -418
- package/SECURITY.md +77 -0
- package/docs/ADAPTERS.md +15 -0
- package/docs/API.md +152 -0
- package/docs/ARCHITECTURE.md +13 -0
- package/docs/CLI.md +212 -0
- package/docs/COMPARE.md +69 -0
- package/docs/DIFF.md +11 -0
- package/docs/EXPORTS.md +12 -0
- package/docs/GETTING-STARTED.md +128 -0
- package/docs/KNOWN-ISSUES.md +34 -0
- package/docs/LIMITATIONS.md +32 -0
- package/docs/LOG-TO-TREE-QUICKSTART.md +54 -0
- package/docs/LOGS.md +13 -0
- package/docs/SCHEMA.md +199 -0
- package/docs/SCREENSHOTS.md +14 -0
- package/package.json +36 -13
- package/packages/cli/dist/index.cjs +1 -1
- package/packages/cli/dist/index.cjs.map +1 -1
- package/packages/cli/dist/index.mjs +1 -1
- package/packages/cli/dist/index.mjs.map +1 -1
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 1.0.2
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- c72f044: docs: polish README
|
|
8
|
+
|
|
9
|
+
## 1.0.1
|
|
10
|
+
|
|
11
|
+
### Patch Changes
|
|
12
|
+
|
|
13
|
+
- 575b093: docs: onboarding polish
|
|
14
|
+
|
|
15
|
+
## Unreleased
|
|
16
|
+
|
|
17
|
+
### Documentation
|
|
18
|
+
|
|
19
|
+
- Improved README onboarding for new users.
|
|
20
|
+
- Added comparison guide.
|
|
21
|
+
- Added log-to-tree quickstart.
|
|
22
|
+
- Added a quickstart demo example.
|
|
23
|
+
- Clarified docs organization between user-facing `docs/` and internal `docs-local/`.
|
|
24
|
+
|
|
25
|
+
## 1.0.0
|
|
26
|
+
|
|
27
|
+
### Stable local tracing
|
|
28
|
+
|
|
29
|
+
- Stable manual tracing entry points: `inspectRun`, `step`, `step.llm`, `step.tool`, `observe`
|
|
30
|
+
- v0.1 JSONL trace compatibility retained (schemaVersion `"0.1"`)
|
|
31
|
+
|
|
32
|
+
### Local inspection CLI
|
|
33
|
+
|
|
34
|
+
- Stable CLI workflows: `list`, `view`, `clean`
|
|
35
|
+
- Safety-critical cleanup verifies traces before deletion
|
|
36
|
+
|
|
37
|
+
### Structured logs and live tail
|
|
38
|
+
|
|
39
|
+
- Local log-to-tree parsing and live tail workflows (`logs`, `tail`) with confidence labeling
|
|
40
|
+
- Best-effort log4js parsing; JSON logs first-class; no unsafe object parsing
|
|
41
|
+
|
|
42
|
+
### Optional LangChain adapter
|
|
43
|
+
|
|
44
|
+
- `@agent-inspect/langchain` optional adapter package (experimental surface)
|
|
45
|
+
|
|
46
|
+
### Optional TUI
|
|
47
|
+
|
|
48
|
+
- `@agent-inspect/tui` optional Ink/React viewer (experimental programmatic surface)
|
|
49
|
+
|
|
50
|
+
### Standards-aligned local export
|
|
51
|
+
|
|
52
|
+
- Markdown/HTML exports for sharing traces locally
|
|
53
|
+
- OpenInference-compatible JSON export (experimental; verify against backends)
|
|
54
|
+
- OTLP JSON export (experimental; JSON mapping only, no OTLP gRPC)
|
|
55
|
+
|
|
56
|
+
### Diff and compare
|
|
57
|
+
|
|
58
|
+
- Local, read-only diff of two manual traces (`diff`)
|
|
59
|
+
|
|
60
|
+
### Fixtures, recipes, and hardening (v0.9)
|
|
61
|
+
|
|
62
|
+
- Canonical fixtures under `fixtures/` plus validation scripts
|
|
63
|
+
- Runnable recipes under `examples/recipes/` with deterministic expected output markers
|
|
64
|
+
- Package smoke checks and adoption hardening tests
|
|
65
|
+
|
|
66
|
+
### Documentation and stability
|
|
67
|
+
|
|
68
|
+
- Added/updated API/CLI/schema/getting-started docs for v1.0 stabilization
|
|
69
|
+
- Added stability and compatibility tests to prevent accidental surface breaks
|
|
70
|
+
|
|
71
|
+
### Known limitations
|
|
72
|
+
|
|
73
|
+
- Local-first only; no SaaS/dashboard; no vendor sinks; no replay; no cost engine
|
|
74
|
+
|
|
75
|
+
## Historical notes (v0.1–v0.9)
|
|
76
|
+
|
|
77
|
+
AgentInspect started as a minimal manual tracing MVP (v0.1) and evolved through:
|
|
78
|
+
|
|
79
|
+
- local inspection improvements (metadata, filtering, safety checks)
|
|
80
|
+
- structured log ingestion (JSON first-class, log4js best-effort)
|
|
81
|
+
- conservative tree building rules with confidence labels
|
|
82
|
+
- incremental live tail rendering
|
|
83
|
+
- standards-aligned local exports (experimental)
|
|
84
|
+
- run diff and compare
|
|
85
|
+
- fixtures, recipes, and hardening focused on adoption
|
|
86
|
+
|
|
87
|
+
For detailed intent and sequencing (planning docs), see:
|
|
88
|
+
|
|
89
|
+
- `docs-local/roadmap/VERSION-ROADMAP.md`
|
|
90
|
+
- `docs-local/strategy/PRODUCT-PRINCIPLES.md`
|
|
91
|
+
|
|
92
|
+
# agent-inspect
|
|
93
|
+
|
|
94
|
+
## 0.1.2
|
|
95
|
+
|
|
96
|
+
### Patch Changes
|
|
97
|
+
|
|
98
|
+
- 62afb94: fix CI/publish smoke + vitest config
|
|
99
|
+
|
|
100
|
+
## 0.1.1
|
|
101
|
+
|
|
102
|
+
### Patch Changes
|
|
103
|
+
|
|
104
|
+
- bd719ef: Prepare npm publishing (Trusted Publishing via GitHub Actions OIDC) and polish documentation.
|
|
105
|
+
- 76791b8: Improve README, release docs, and npm publishing guidance.
|