Repository navigation
AgentLog v0.2.0
Major schema upgrade based on a 47-recommendation pre-adoption audit testing against Claude Code, Cursor, Codex, Aider, Copilot Workspace, Devin, and Windsurf.
5 New Event Types
| Event | What it captures |
|---|---|
handoff |
Agent-to-agent delegation with fromAgent/toAgent |
approval |
Human-in-the-loop permission decisions |
plan |
Structured task decomposition with dependencies |
checkpoint |
State snapshots for rollback/recovery |
contextLoad |
Agent loading context from RAG, memory, codebase |
Per-Event Intelligence
Every event now carries optional:
tokenUsage+estimatedCostUsd+model— per-call cost attributiontraceId+spanId— OTel correlationgroupId— atomic multi-file operation linking
Multi-Agent Support
teamobject with agents[], processType (sequential/parallel/hierarchical/graph)handoffevents trace delegation chainsrelationships.groupIdlinks related sessions
Security
classificationfield (public/internal/confidential/restricted)redactions[]with typed categories ([REDACTED:api_key])- Standard redaction format defined in spec
New Relationships
reviews[]— code review referencestestRuns[]— test results with pass/fail/coveragebranches[]— branch operations
Backward Compatible
v0.1 documents validate against v0.2 schema — all new fields have defaults.
Install
npm install @braintied/agentlog@0.2.0