Profile: top-level-repository
One agent experience. Every interface.
Cross-framework application framework for building interactive agent experiences on top of AgentsKit. Define chat behavior once, answer exact local facts before any backend call, and render the same definition through native React, React Native, Ink, Vue, Svelte, Solid, and Angular shells.
AgentsKit remains the controller/runtime substrate. AgentsKit Chat composes typed definitions, deterministic routes, policy, protocol envelopes, Web-standard handlers, and renderer bindings into full interactive applications.
Repository claims are derived from canonical evidence and checked in CI:
| Surface | Current proof |
|---|---|
| Public npm packages | 2 |
| Native renderers | 7 |
| Standard components | 12 |
| Conformance requirements | 12 |
| Renderer quick starts | 7 |
| Example applications | 6 |
| Architecture ADRs | 33 |
| Agent handoffs | 28 |
Counts live in ecosystem-claims.json, generated by scripts/gen-ecosystem-claims.mjs. The conformance matrix, launch checklist, and dogfood record provide release and adoption evidence.
node examples/verify-readme.mjsScaffold a React project from the published CLI, then verify the README claim ledger locally:
pnpm dlx @agentskit/chat-cli@0.4.1 init my-chat --renderer react --yespnpm dlx @agentskit/chat-cli@0.4.1 init my-chat --renderer react --yesContinue with the seven renderer quick starts, API reference, and deployment modes.
flowchart LR
D["defineChat"] --> L["deterministic answers"]
L --> A["trusted Ask backend"]
D --> R["React · Vue · Svelte · Solid · Angular · RN · Ink"]
AgentsKit Chat 0.4.1 ships as two public npm packages with provenance: @agentskit/chat and @agentskit/chat-cli. Protocol, server, devtools, and renderer APIs are versioned subpaths of @agentskit/chat; React and Ink can also render host-owned controlled sessions without creating a second controller. Patch releases preserve protocol meaning, component contracts, and persisted session compatibility. See stability and upgrades, the 0.4 release notes, the 0.3 package migration, and the compatibility matrix.
- Node.js 22 in CI; Node.js 24 in release workflows
- TypeScript strict mode across packages
- Peer ranges for
@agentskit/core, renderer bindings, and@agentskit/memoryare authoritative in each published manifest
- Get started in all seven renderers
- Hosted and self-hosted Ask backend
- Deterministic answer protocol
- DOM renderer parity examples
- Architecture overview
- ADR-0002: upstream-first adoption
- Agent documentation index
pnpm --filter @agentskit/chat-example-react dev
pnpm --filter @agentskit/chat-example-vue dev
pnpm --filter @agentskit/chat-example-svelte dev
pnpm --filter @agentskit/chat-example-solid devReact, Vue, Svelte, and Solid share definitions from @agentskit/chat-example-shared. React Native and Ink keep dedicated proof apps.
Read CONTRIBUTING.md and AGENTS.md before editing. Use doc-bridge for ownership routing:
pnpm docs:bridge:index
pnpm docs:bridge:query ownership <id> --agent
pnpm docs:bridge:gateTags: agentskit-chat, agentskit, typescript, cross-framework, chat-ui, deterministic-answers
| Product | Relationship |
|---|---|
| AgentsKit | Controller, adapters, memory, eval, and framework bindings consumed upstream |
| Registry | Dogfoods the consolidated protocol and Ask surface |
| AgentsKit Chat | This repository: the shared application layer for conversational surfaces |
| Playbook | Dogfoods deterministic local answers and shared Ask integration |
| Doc Bridge | Indexes ownership, gates, and agent handoffs for this repository |
| Code Review | Reviews changes before merge with the model already in your workflow |
| AKOS | Adds enterprise orchestration, governance, and production controls |