Skip to content

Releases: braintied/agentlog

v0.2.0 — 12 Event Types, OTel, Multi-Agent

30 Mar 21:47
@ga1ien ga1ien
v0.2.0
08e75ab

Choose a tag to compare

View all tags
v0.2.0 — 12 Event Types, OTel, Multi-Agent Latest
Latest

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 attribution
  • traceId + spanId — OTel correlation
  • groupId — atomic multi-file operation linking

Multi-Agent Support

  • team object with agents[], processType (sequential/parallel/hierarchical/graph)
  • handoff events trace delegation chains
  • relationships.groupId links related sessions

Security

  • classification field (public/internal/confidential/restricted)
  • redactions[] with typed categories ([REDACTED:api_key])
  • Standard redaction format defined in spec

New Relationships

  • reviews[] — code review references
  • testRuns[] — test results with pass/fail/coverage
  • branches[] — 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
Assets 2
Loading

v0.1.1 — Schema, Spec, and Converters

30 Mar 21:17
@ga1ien ga1ien
v0.1.1
f801863

Choose a tag to compare

View all tags
v0.1.1 — Schema, Spec, and Converters

AgentLog v0.1.1

Open standard for AI agent session interchange.

What's Included

Core

  • AgentLog TypeScript type with full JSDoc documentation
  • 7 event types: message, toolCall, fileOperation, terminalCommand, search, reasoning, error
  • 3-layer schema: session envelope, event timeline, engineering graph relationships
  • Zod runtime validation (validateAgentLog)
  • Property bags on every object for vendor extensibility

Schema

  • JSON Schema (Draft 2020-12): schemas/agentlog.schema.json
  • Formal prose specification: spec/agentlog-spec.md

Converters

  • Claude Code JSONL → AgentLog
  • Watchtower DB → AgentLog

Examples

  • minimal-session.json — basic edit + test flow
  • debugging-session.json — Sentry error investigation
  • multi-agent-session.json — parallel sub-agent orchestration

Install

npm install @braintied/agentlog

Links

Loading