@adecore/agent-contracts 0.17.0-beta.1 → 0.17.0-beta.2

package/LICENSE

@@ -6,7 +6,7 @@ FSL-1.1-MIT
 
 ## Notice
 
-Copyright 2026 Bas Milius
+Copyright 2026 - present Bas Milius
 
 ## Terms and Conditions
 

package/README.md

@@ -1,20 +1,39 @@
 # @adecore/agent-contracts
 
-Zod schemas and TypeScript contracts shared by agent chat hosts and clients. The package covers conversations, attachments, approvals, providers, model selections, accounts, tasks, worktrees, and usage. It is browser safe and contains no process or transport implementation.
+[![npm](https://img.shields.io/npm/v/@adecore/agent-contracts)](https://www.npmjs.com/package/@adecore/agent-contracts)
+[![Docs](https://img.shields.io/badge/docs-adecore.dev-blue)](https://adecore.dev/agent-contracts/)
+
+The Zod schemas and TypeScript types an agent chat host and its clients share: the frames on the wire, the requests and events, a chat and its items, providers, models, accounts, tasks, worktrees and usage. It opens no connection and starts no process, so a browser, a preload and a backend can all import it.
+
+## Install
+
+```sh
+bun add @adecore/agent-contracts
+```
+
+## Use
 
 ```ts
 import { AGENT_REQUEST_SCHEMAS, parseRequest } from '@adecore/agent-contracts';
-import type { FramePort } from '@adecore/agent-contracts/port';
 
-const payload = AGENT_REQUEST_SCHEMAS['chat.send'].payload.parse({ chatId: 'chat-1', text: 'Hello' });
+const frame = parseRequest(incoming);
+if (frame.ok && frame.value.type === 'chat.send') {
+    const payload = AGENT_REQUEST_SCHEMAS['chat.send'].payload.parse(frame.value.payload);
+}
 ```
 
-Envelope parsing checks frame structure. Persisted and wire discriminants, including the historical host-owned subagent origin, remain unchanged during the package migration. Validate payloads and correlated results against the selected table schema too. A consumer supplies transport ownership, authorization, and any larger host protocol.
+The root exports everything. Each group also has a subpath of its own: `agent`, `chat`, `envelope`, `ids`, `model`, `port`, `protocol`, `provider-accounts`, `task`, `text`, `usage` and `worktree`.
 
-The [documentation](https://adecore.dev/agent-contracts/) covers [setup](https://adecore.dev/agent-contracts/getting-started), [frames and replay](https://adecore.dev/agent-contracts/frames-and-events), [conversation content](https://adecore.dev/agent-contracts/conversation), [providers/accounts](https://adecore.dev/agent-contracts/providers-and-accounts), [tasks/usage](https://adecore.dev/agent-contracts/tasks-and-usage), and [entrypoints/compatibility](https://adecore.dev/agent-contracts/validation-and-compatibility).
+## Documentation
 
-The root reexports all groups. Supported subpaths are `agent`, `chat`, `envelope`, `ids`, `model`, `port`, `protocol`, `provider-accounts`, `task`, `text`, `usage`, and `worktree`.
+| Page | What it covers |
+|---|---|
+| [Overview](https://adecore.dev/agent-contracts/) | Install, a first check and the entry points |
+| [Protocol](https://adecore.dev/agent-contracts/protocol) | Frames, the request and event tables, replay and adding requests |
+| [Conversation](https://adecore.dev/agent-contracts/conversation) | A chat's info and items, attachments, approvals, bookmarks and forks |
+| [Providers and accounts](https://adecore.dev/agent-contracts/providers-and-accounts) | Agent kinds, model catalogs, capabilities, runtime modes and accounts |
+| [Tasks and usage](https://adecore.dev/agent-contracts/tasks-and-usage) | Tasks, worktrees, token totals, summaries and plan limits |
 
-This package is private at `0.0.0`, pending publication setup. In the local workspace, build it with `bun run --cwd packages/agent-contracts build`, then run its `typecheck` and `test` scripts. Default exports use compiled JavaScript/declarations; the `source` condition uses TypeScript. Build it before the backend and React packages.
+## License
 
-Transferred code retains FSL-1.1-MIT. See [LICENSE](./LICENSE).
+FSL-1.1-MIT. See [LICENSE](./LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agent-contracts",
-  "version": "0.17.0-beta.1",
+  "version": "0.17.0-beta.2",
   "description": "Schemas and port contracts for agent chats, provider accounts, models and usage.",
   "type": "module",
   "exports": {