Note
This repository owns SDK package behavior. Agent Trail wire-format decisions live in the spec repository.
TypeScript packages for Agent Trail schema assets, generated types, core JSONL utilities, adapter authoring, source-agent adapters, redaction, catalog metadata, render models, workflow orchestration, and content-addressed local storage.
| Package | Purpose |
|---|---|
@agent-trail/schema |
Vendored Agent Trail schema and validation fixtures. |
@agent-trail/types |
Generated TypeScript declarations for Agent Trail records. |
@agent-trail/core |
JSONL parsing, validation, hashing, serialization, and reconciliation. |
@agent-trail/adapter-kit |
Reader, mapping, source-schema, and reconciler primitives for adapters. |
@agent-trail/source-schemas |
JSON Schemas for supported upstream source-agent records. |
@agent-trail/adapters |
Concrete adapters for supported coding agents. |
@agent-trail/catalog |
SQLite catalog primitives for source sessions, stored objects, and shares. |
@agent-trail/redact |
Redaction APIs and configuration loading for shared trails. |
@agent-trail/store |
Content-addressed local store for finalized trail artifacts. |
@agent-trail/render-model |
Renderer-agnostic transcript model for viewers. |
@agent-trail/sessions |
Workflow APIs for discover, list, load, share, and export. |
docs/implementation-semantics.md- SDK runtime behavior and package boundaries.docs/adapter-authoring.md- checklist for external adapter authors and SDK adapter maintainers.docs/parser-source-matrix.md- supported source-agent formats, fixture evidence, and update process.docs/redaction.md- redaction workflow, public API, configuration, and safety notes.docs/GLOSSARY.md- SDK-owned terminology.docs/adr/0001-sdk-package-architecture-and-public-api-boundaries.md- package architecture and public API policy.
- agent-trail/spec - format contract, JSON Schema source, fixtures, and format ADRs.
- agent-trail/typescript-sdk - TypeScript packages for Agent Trail files.
- agent-trail/cli - command-line tools for Agent Trail workflows.
- agent-trail/web - docs site and shared trail web viewer.
mise run setup
mise run checkUse mise run check:actions after editing GitHub Actions workflows.
See CONTRIBUTING.md for workflow and PR expectations.
MIT. See LICENSE.