@kb-labs/agent-contracts 0.6.0

package/LICENSE

@@ -0,0 +1,4 @@
+This project is licensed under the same terms as the KB Labs Plugin Template root project.
+
+See the root LICENSE file at the repository root for full details.
+

package/README.md

@@ -0,0 +1,33 @@
+# @kb-labs/agent-contracts
+
+Shared type definitions and contracts for the KB Labs agent system. Provides TypeScript interfaces, event schemas, API routes, and Zod validation used by all other `agent-*` packages.
+
+## What's Inside
+
+| Export | Description |
+|--------|-------------|
+| `types.ts` | Core types — `AgentConfig`, `AgentResult`, `SessionInfo`, `TurnInfo`, execution state |
+| `events.ts` | Agent event system — `AgentEvent` union type covering full lifecycle |
+| `ws-messages.ts` | WebSocket message contracts for real-time streaming |
+| `verification.ts` | Quality gate types — `VerificationResult`, `GateConfig` |
+| `turn.ts` | Turn-based interaction models |
+| `schemas.ts` | Zod validation schemas for runtime input validation |
+| `routes.ts` | API route definitions (`/api/v1/agents/*`) |
+| `analytics.ts` | Analytics event type constants |
+| `config-types.ts` | Configuration types, `DEFAULT_FILE_HISTORY_CONFIG` |
+| `detailed-trace-types.ts` | Detailed trace event types for NDJSON tracing |
+| `trace-command-response.ts` | Trace CLI command response types |
+
+## Usage
+
+```typescript
+import type { AgentConfig, AgentResult } from '@kb-labs/agent-contracts';
+import type { AgentEvent } from '@kb-labs/agent-contracts';
+import { AgentRunRequestSchema } from '@kb-labs/agent-contracts';
+```
+
+This package has **no runtime dependencies** on other agent packages — it's pure types + Zod schemas. Every other `agent-*` package depends on it.
+
+## Dependencies
+
+- `zod` — runtime schema validation