docs: port SDK implementation docs

[somus]

This pull request ports and consolidates the SDK implementation documentation into the repository. It adds three new in-depth guides (adapter-authoring.md, implementation-semantics.md, redaction.md) and significantly restructures the root README.md, the parser-source-matrix.md, and the individual package README files. The changes improve the contributor and user documentation by clarifying package boundaries, runtime semantics, redaction workflows, adapter authoring checklists, fixture policies, and verification procedures. No source code changes are introduced—the entire diff is documentation and package-level README updates.

[stage-review]

Ready to review this PR? Stage has broken it down into 6 individual chapters for you:

	Title
1	Restructure root README and project metadata
2	Define SDK implementation semantics and package boundaries
3	Document schema, types, and core packages
4	Establish adapter authoring and source matrix guides
5	Update adapter-related package documentation
6	Document redaction, storage, and orchestration

_{Chapters generated by Stage for commit eba18a6 on Jun 16, 2026 12:01pm UTC.}

[pkg-pr-new]

Open in StackBlitz

@agent-trail/adapter-kit

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/adapter-kit@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/adapter-kit@26

@agent-trail/adapters

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/adapters@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/adapters@26

@agent-trail/catalog

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/catalog@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/catalog@26

@agent-trail/core

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/core@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/core@26

@agent-trail/redact

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/redact@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/redact@26

@agent-trail/render-model

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/render-model@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/render-model@26

@agent-trail/schema

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/schema@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/schema@26

@agent-trail/sessions

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/sessions@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/sessions@26

@agent-trail/source-schemas

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/source-schemas@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/source-schemas@26

@agent-trail/store

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/store@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/store@26

@agent-trail/types

bun add https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/types@26

npm i https://pkg.pr.new/agent-trail/typescript-sdk/@agent-trail/types@26

commit: eba18a6

[kody-ai]

Pull Request Standard violation: The Verification section lists bun run check:biome, bun run check:types, bun run check:exports, local Markdown link check, and git diff --check without the mandatory results. Provide both exact verification commands and their output to comply with the standard.

Kody rule violation: Follow Pull Request Standards

[kody-ai]

Kody Review Complete

Great news! 🎉
No issues were found that match your current review configurations.

Keep up the excellent work! 🚀

Kody Guide: Usage and Configuration

Interacting with Kody

• Request a Review: Ask Kody to review your PR manually by adding a comment with the @kody start-review command at the root of your PR.

• Validate Business Logic: Ask Kody to validate your code against business rules by adding a comment with the @kody -v business-logic command.

• Provide Feedback: Help Kody learn and improve by reacting to its comments with a 👍 for helpful suggestions or a 👎 if improvements are needed.

Current Kody Configuration

Review Options

The following review options are enabled or disabled:

Options	Enabled
Bug	✅
Performance	✅
Security	✅
Business Logic	✅

Access your configuration settings here.

​