@contractspec/bundle.library 3.8.12 → 3.9.2

package/src/application/mcp/contractsMcpResources.ts

@@ -87,6 +87,54 @@ export function buildContractsResources(services: ContractsMcpServices) {
 		})
 	);
 
+	resources.register(
+		defineResourceTemplate({
+			meta: {
+				uriTemplate: 'adoption://catalog',
+				title: 'ContractSpec adoption catalog',
+				description:
+					'Bundled ContractSpec adoption catalog used by Connect and MCP.',
+				mimeType: 'application/json',
+				tags: TAGS,
+			},
+			input: z.object({}),
+			resolve: async () => {
+				const results = await services.searchAdoptionCatalog({
+					query: 'contractspec',
+				});
+				return {
+					uri: 'adoption://catalog',
+					mimeType: 'application/json',
+					data: JSON.stringify(results, null, 2),
+				};
+			},
+		})
+	);
+
+	resources.register(
+		defineResourceTemplate({
+			meta: {
+				uriTemplate: 'adoption://policy/{family}',
+				title: 'ContractSpec adoption policy',
+				description: 'Family-aware adoption recommendation and verdict policy.',
+				mimeType: 'application/json',
+				tags: TAGS,
+			},
+			input: z.object({ family: z.string() }),
+			resolve: async ({ family }) => {
+				const resolution = await services.resolveAdoption({
+					family,
+					query: family,
+				});
+				return {
+					uri: `adoption://policy/${encodeURIComponent(family)}`,
+					mimeType: 'application/json',
+					data: JSON.stringify(resolution, null, 2),
+				};
+			},
+		})
+	);
+
 	return resources;
 }
 
@@ -124,6 +172,7 @@ export function buildContractsPrompts() {
 						'3. Edit content and call contracts.update',
 						'4. Run contracts.validate to verify changes',
 						'5. Run contracts.build to regenerate artifacts',
+						'6. Use adoption.resolve to prefer existing workspace or ContractSpec surfaces before inventing new ones',
 						goal ? `Agent goal: ${goal}` : '',
 					]
 						.filter(Boolean)

package/src/application/mcp/contractsMcpTools.ts

@@ -11,6 +11,7 @@ import {
 	OperationSpecRegistry,
 } from '@contractspec/lib.contracts-spec';
 import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
+import { registerAdoptionOps } from './contractsMcpAdoptionTools';
 import type { ContractsMcpServices } from './contractsMcpTypes';
 
 const OWNERS = ['@contractspec'];
@@ -161,6 +162,7 @@ export function buildContractsOps(services: ContractsMcpServices) {
 	);
 
 	registerMutationTools(registry, services);
+	registerAdoptionOps(registry, services);
 
 	return registry;
 }

package/src/application/mcp/contractsMcpTypes.ts

@@ -44,4 +44,20 @@ export interface ContractsMcpServices {
 	): Promise<{ deleted: boolean; cleanedFiles: string[]; errors: string[] }>;
 
 	fetchRegistryManifest(): Promise<unknown>;
+
+	searchAdoptionCatalog(options: {
+		family?: string;
+		platform?: string;
+		query: string;
+	}): Promise<unknown[]>;
+
+	resolveAdoption(options: {
+		family: string;
+		paths?: string[];
+		platform?: string;
+		query: string;
+		runtime?: string;
+	}): Promise<unknown>;
+
+	syncAdoptionCatalog(): Promise<{ catalogPath: string; total: number }>;
 }

package/src/bundles/LibraryBundle.ts

@@ -1,148 +1,37 @@
-/**
- * Library bundle spec for workspace shell (sandbox, docs, templates).
- * Uses @contractspec/lib.surface-runtime for adaptive, preference-driven layouts.
- */
-
 import { defineModuleBundle } from '@contractspec/lib.surface-runtime/spec';
 
 export const LibraryBundle = defineModuleBundle({
 	meta: {
-		key: 'library.workspace',
-		version: '0.1.0',
-		title: 'Library Workspace',
+		key: 'bundles.library',
+		version: '1.0.0',
+		title: 'Library',
 		description:
-			'Workspace shell for docs, templates, sandbox, and feature discovery',
-		owners: ['team-platform'],
-		tags: ['library', 'workspace', 'docs', 'sandbox', 'templates'],
-		stability: 'experimental',
+			'ContractSpec package declaration for @contractspec/bundle.library.',
 	},
-
 	routes: [
 		{
-			routeId: 'sandbox',
-			path: '/sandbox',
-			defaultSurface: 'workspace-shell',
-		},
-		{
-			routeId: 'docs',
-			path: '/docs',
-			defaultSurface: 'workspace-shell',
-		},
-		{
-			routeId: 'docs-slug',
-			path: '/docs/:slug',
-			defaultSurface: 'workspace-shell',
-		},
-		{
-			routeId: 'studio',
-			path: '/studio/:projectSlug',
-			defaultSurface: 'workspace-shell',
+			routeId: 'default',
+			path: '/',
+			defaultSurface: 'main',
 		},
 	],
-
 	surfaces: {
-		'workspace-shell': {
-			surfaceId: 'workspace-shell',
+		main: {
+			surfaceId: 'main',
 			kind: 'workbench',
-			title: 'Workspace Shell',
-			slots: [
-				{
-					slotId: 'header',
-					role: 'header',
-					accepts: ['action-bar'],
-					cardinality: 'many',
-				},
-				{
-					slotId: 'sidebar',
-					role: 'secondary',
-					accepts: ['entity-section', 'custom-widget'],
-					cardinality: 'one',
-				},
-				{
-					slotId: 'primary',
-					role: 'primary',
-					accepts: [
-						'entity-section',
-						'rich-doc',
-						'data-view',
-						'form',
-						'custom-widget',
-					],
-					cardinality: 'many',
-					mutableByAi: true,
-					mutableByUser: true,
-				},
-				{
-					slotId: 'assistant',
-					role: 'assistant',
-					accepts: ['assistant-panel', 'chat-thread'],
-					cardinality: 'many',
-					mutableByAi: true,
-					mutableByUser: true,
-				},
-			],
-
-			layouts: [
-				{
-					layoutId: 'sidebar-main',
-					title: 'Sidebar + Main',
-					root: {
-						type: 'panel-group',
-						direction: 'horizontal',
-						persistKey: 'library.workspace.sidebar-main',
-						children: [
-							{ type: 'slot', slotId: 'sidebar' },
-							{
-								type: 'panel-group',
-								direction: 'vertical',
-								persistKey: 'library.workspace.content',
-								children: [
-									{ type: 'slot', slotId: 'header' },
-									{ type: 'slot', slotId: 'primary' },
-								],
-							},
-						],
-					},
-				},
-				{
-					layoutId: 'sidebar-main-assistant',
-					title: 'Sidebar + Main + Assistant',
-					root: {
-						type: 'panel-group',
-						direction: 'horizontal',
-						persistKey: 'library.workspace.sidebar-main-assistant',
-						children: [
-							{ type: 'slot', slotId: 'sidebar' },
-							{
-								type: 'panel-group',
-								direction: 'vertical',
-								persistKey: 'library.workspace.content',
-								children: [
-									{ type: 'slot', slotId: 'header' },
-									{ type: 'slot', slotId: 'primary' },
-								],
-							},
-							{ type: 'slot', slotId: 'assistant' },
-						],
-					},
-				},
-			],
-
+			title: 'Library',
+			slots: [],
+			layouts: [],
 			data: [],
-
 			verification: {
 				dimensions: {
-					guidance:
-						'Can reveal walkthrough notes, field help, and contextual hints.',
-					density:
-						'Can select compact, balanced, or dense layouts for docs and templates.',
-					dataDepth:
-						'Controls content depth, pagination size, and inline expansion.',
-					control: 'Shows advanced commands and raw config only when allowed.',
-					media:
-						'Supports text-first docs, visual templates, and hybrid modes.',
-					pace: 'Maps to motion tokens and confirmation behavior.',
-					narrative: 'Can order summary before or after detail sections.',
+					guidance: 'Scaffolded guidance profile for Library.',
+					density: 'Scaffolded density profile for Library.',
+					dataDepth: 'Scaffolded data-depth profile for Library.',
+					control: 'Scaffolded control profile for Library.',
+					media: 'Scaffolded media profile for Library.',
+					pace: 'Scaffolded pace profile for Library.',
+					narrative: 'Scaffolded narrative profile for Library.',
 				},
 			},
 		},

package/src/components/docs/docsManifest.test.ts

@@ -28,6 +28,19 @@ describe('docs manifest learning paths', () => {
 		expect(buildHrefs).toContain('/docs/guides/host-builder-workbench');
 	});
 
+	it('keeps cross-platform UI resolvable without promoting it to primary nav', () => {
+		expect(
+			getDocsPageByHref('/docs/libraries/cross-platform-ui')
+		).toBeDefined();
+
+		const buildSection = getPrimaryDocsSections().find(
+			(section) => section.key === 'build'
+		);
+		const buildHrefs = buildSection?.items.map((item) => item.href) ?? [];
+
+		expect(buildHrefs).not.toContain('/docs/libraries/cross-platform-ui');
+	});
+
 	it('orders the new guides as intended within build traversal', () => {
 		const buildSection = getPrimaryDocsSections().find(
 			(section) => section.key === 'build'
@@ -61,6 +74,7 @@ describe('docs manifest learning paths', () => {
 			'/docs/architecture/control-plane',
 			'/docs/specs/overlays',
 			'/docs/studio',
+			'/docs/libraries/cross-platform-ui',
 		]) {
 			expect(
 				getDocsPageByHref(href) != null || NON_MANIFEST_DOC_ROUTES.has(href)

package/src/components/docs/docsManifest.ts

@@ -384,6 +384,16 @@ export const DOCS_PAGES: readonly DocsPageEntry[] = [
 		audience: 'oss',
 		ctaMode: 'oss-next',
 	},
+	{
+		href: '/docs/libraries/cross-platform-ui',
+		title: 'Cross-platform UI',
+		description:
+			'Understand how the presentation runtimes, ui-kit-web, ui-kit, and design-system stay aligned across React and React Native.',
+		section: 'build',
+		order: 71,
+		audience: 'oss',
+		ctaMode: 'oss-next',
+	},
 	{
 		href: '/docs/architecture',
 		title: 'Architecture',
@@ -418,6 +428,18 @@ export const DOCS_PAGES: readonly DocsPageEntry[] = [
 		audience: 'operator',
 		ctaMode: 'oss-next',
 	},
+	{
+		href: '/docs/guides/release-capsules',
+		title: 'Author release capsules',
+		description:
+			'Pair changesets with structured release capsules, generate release artifacts, and keep changelog plus docs surfaces aligned.',
+		section: 'operate',
+		order: 25,
+		navTitle: 'Release capsules',
+		primaryNav: true,
+		audience: 'operator',
+		ctaMode: 'reference',
+	},
 	{
 		href: '/docs/safety/security-trust',
 		title: 'Security and trust',

package/src/components/docs/examples/DocsExamplesPage.tsx

@@ -8,8 +8,10 @@ import {
 } from '@contractspec/lib.design-system';
 import { HStack, VStack } from '@contractspec/lib.ui-kit-web/ui/stack';
 import { H1, Muted } from '@contractspec/lib.ui-kit-web/ui/typography';
-import { listExamples } from '@contractspec/module.examples';
-import { getExampleShowcaseData } from './exampleShowcaseData';
+import {
+	buildExampleDocsHref,
+	listDiscoverableExamples,
+} from '@contractspec/module.examples';
 
 interface ExampleItem extends Record<string, unknown> {
 	id: string;
@@ -20,25 +22,15 @@ interface ExampleItem extends Record<string, unknown> {
 	sandboxEnabled: boolean;
 }
 
-function buildReferenceRoute(key: string) {
-	return `/docs/reference/${key}/${key}`;
-}
-
-function buildDocsRoute(key: string) {
-	return getExampleShowcaseData(key)?.sandboxHref
-		? `/docs/examples/${key}`
-		: buildReferenceRoute(key);
-}
-
 export function DocsExamplesPage() {
-	const items: ExampleItem[] = listExamples()
+	const items: ExampleItem[] = listDiscoverableExamples()
 		.map((example) => {
 			const title = example.meta.title ?? example.meta.key;
 			return {
 				id: example.meta.key,
 				title,
 				summary: example.meta.summary ?? example.meta.description,
-				route: buildDocsRoute(example.meta.key),
+				route: buildExampleDocsHref(example.meta.key),
 				tags: example.meta.tags,
 				sandboxEnabled: example.surfaces.sandbox.enabled,
 			};

package/src/components/docs/examples/ExampleShowcasePage.tsx

@@ -5,7 +5,7 @@ import { FileCode2, Play, TerminalSquare } from 'lucide-react';
 import { getExampleShowcaseData } from './exampleShowcaseData';
 
 interface ExampleShowcasePageProps {
-	exampleKey: 'agent-console' | 'ai-chat-assistant' | 'messaging-agent-actions';
+	exampleKey: string;
 }
 
 export function ExampleShowcasePage({ exampleKey }: ExampleShowcasePageProps) {
@@ -28,7 +28,9 @@ export function ExampleShowcasePage({ exampleKey }: ExampleShowcasePageProps) {
 				<p className="editorial-subtitle">{showcase.lead}</p>
 				<p className="editorial-copy max-w-4xl">{summary}</p>
 				<div className="flex flex-wrap gap-3">
-					<ButtonLink href={showcase.sandboxHref}>Open sandbox</ButtonLink>
+					{showcase.sandboxHref ? (
+						<ButtonLink href={showcase.sandboxHref}>Open sandbox</ButtonLink>
+					) : null}
 					<ButtonLink href={showcase.referenceHref} variant="outline">
 						Generated reference
 					</ButtonLink>
@@ -36,21 +38,23 @@ export function ExampleShowcasePage({ exampleKey }: ExampleShowcasePageProps) {
 			</section>
 
 			<section className="grid gap-5 lg:grid-cols-3">
-				<article className="editorial-panel space-y-4">
-					<div className="flex items-center gap-3">
-						<div className="rounded-full border border-border/80 bg-background/85 p-2">
-							<Play size={18} />
+				{showcase.sandboxHref ? (
+					<article className="editorial-panel space-y-4">
+						<div className="flex items-center gap-3">
+							<div className="rounded-full border border-border/80 bg-background/85 p-2">
+								<Play size={18} />
+							</div>
+							<h2 className="font-semibold text-xl">Sandbox preview</h2>
 						</div>
-						<h2 className="font-semibold text-xl">Sandbox preview</h2>
-					</div>
-					<p className="editorial-copy text-sm">
-						Load the same public browser surface used for the prepared live
-						demo.
-					</p>
-					<ButtonLink href={showcase.sandboxHref} size="sm">
-						Open preview
-					</ButtonLink>
-				</article>
+						<p className="editorial-copy text-sm">
+							Load the same public browser surface used for the prepared live
+							demo.
+						</p>
+						<ButtonLink href={showcase.sandboxHref} size="sm">
+							Open preview
+						</ButtonLink>
+					</article>
+				) : null}
 
 				<article className="editorial-panel space-y-4">
 					<div className="flex items-center gap-3">
@@ -100,8 +104,8 @@ export function ExampleShowcasePage({ exampleKey }: ExampleShowcasePageProps) {
 						Exact local commands for the meetup lane
 					</h2>
 					<p className="editorial-copy text-sm">
-						Use the package build and test first, then launch the web shell and
-						open the prepared sandbox route.
+						Build the example package, then launch the web shell and open the
+						prepared docs or sandbox route.
 					</p>
 				</div>
 				<CodeBlock

package/src/components/docs/examples/exampleShowcaseData.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, test } from 'bun:test';
+import { listDiscoverableExamples } from '@contractspec/module.examples';
+import { getExampleShowcaseData } from './exampleShowcaseData';
+
+describe('example showcase data', () => {
+	test('builds showcase data for every discoverable example', () => {
+		for (const example of listDiscoverableExamples()) {
+			expect(getExampleShowcaseData(example.meta.key)).toBeDefined();
+		}
+	});
+
+	test('preserves override copy and generic fallback links', () => {
+		const dataGrid = getExampleShowcaseData('data-grid-showcase');
+		const calendar = getExampleShowcaseData('calendar-google');
+
+		expect(dataGrid?.lead).toContain('Canonical table example');
+		expect(calendar?.sandboxHref).toBe('/sandbox?template=calendar-google');
+		expect(calendar?.referenceHref).toBe(
+			'/docs/reference/calendar-google/calendar-google'
+		);
+	});
+});

package/src/components/docs/examples/exampleShowcaseData.ts

@@ -1,65 +1,90 @@
+import {
+	buildExampleDocsHref,
+	buildExampleReferenceHref,
+	getDiscoverableExample,
+	getExamplePreviewHref,
+} from '@contractspec/module.examples';
+
 export interface ExampleShowcaseData {
-	key: 'agent-console' | 'ai-chat-assistant' | 'messaging-agent-actions';
+	key: string;
 	lead: string;
-	sandboxHref: string;
+	sandboxHref: string | null;
 	referenceHref: string;
 	llmsHref: string;
 	repoHref: string;
 	localCommands: string;
 }
 
-const EXAMPLE_SHOWCASES: Record<string, ExampleShowcaseData> = {
-	'agent-console': {
-		key: 'agent-console',
-		lead: 'Primary meetup path for autonomous agents: typed tools, agent configs, run history, and execution logs in one regenerable surface.',
-		sandboxHref: '/sandbox?template=agent-console',
-		referenceHref: '/docs/reference/agent-console/agent-console',
-		llmsHref: '/llms/example.agent-console',
-		repoHref:
-			'https://github.com/lssm-tech/contractspec/tree/main/packages/examples/agent-console',
-		localCommands: `bun run --cwd packages/examples/agent-console build
-bun run --cwd packages/examples/agent-console test
-bun run --cwd packages/apps/web-landing dev
-
-# Open in the browser
-# http://localhost:3000/sandbox?template=agent-console`,
-	},
-	'ai-chat-assistant': {
-		key: 'ai-chat-assistant',
-		lead: 'Secondary meetup path for MCP-aware assistants: reasoning, sources, suggestions, and a minimal contract-backed search tool.',
-		sandboxHref: '/sandbox?template=ai-chat-assistant',
-		referenceHref: '/docs/reference/ai-chat-assistant/assistant.search',
-		llmsHref: '/llms/example.ai-chat-assistant',
-		repoHref:
-			'https://github.com/lssm-tech/contractspec/tree/main/packages/examples/ai-chat-assistant',
-		localCommands: `bun run --cwd packages/examples/ai-chat-assistant build
-bun run --cwd packages/examples/ai-chat-assistant test
-bun run --cwd packages/apps/web-landing dev
-
-# Open in the browser
-# http://localhost:3000/sandbox?template=ai-chat-assistant`,
-	},
-	'messaging-agent-actions': {
-		key: 'messaging-agent-actions',
-		lead: 'Live messaging lane for the meetup: inbound Slack, WhatsApp, or Telegram messages route through fixed intents, allowlisted actions, and deterministic confirmations.',
-		sandboxHref: '/sandbox?template=messaging-agent-actions',
-		referenceHref:
-			'/docs/reference/messaging-agent-actions/messaging.agentActions.process',
-		llmsHref: '/llms/example.messaging-agent-actions',
-		repoHref:
-			'https://github.com/lssm-tech/contractspec/tree/main/packages/examples/messaging-agent-actions',
-		localCommands: `bun run --cwd packages/examples/messaging-agent-actions build
-bun run --cwd packages/examples/messaging-agent-actions test
-bun run --cwd packages/examples/messaging-agent-actions proof
-bun run --cwd packages/apps/web-landing dev
+const LEAD_OVERRIDES: Record<string, string> = {
+	'agent-console':
+		'Primary meetup path for autonomous agents: typed tools, agent configs, run history, and execution logs in one regenerable surface.',
+	'ai-chat-assistant':
+		'Secondary meetup path for MCP-aware assistants: reasoning, sources, suggestions, and a minimal contract-backed search tool.',
+	'data-grid-showcase':
+		'Canonical table example for the full ContractSpec stack: declarative DataView contract, shared controller, raw web primitive, native-first primitive, and the composed design-system wrapper.',
+	'messaging-agent-actions':
+		'Live messaging lane for the meetup: inbound Slack, WhatsApp, or Telegram messages route through fixed intents, allowlisted actions, and deterministic confirmations.',
+};
 
-# Open in the browser
-# http://localhost:3000/sandbox?template=messaging-agent-actions`,
-	},
+const REFERENCE_HREF_OVERRIDES: Record<string, string> = {
+	'agent-console': '/docs/reference/agent-console/agent-console',
+	'ai-chat-assistant': '/docs/reference/ai-chat-assistant/assistant.search',
+	'data-grid-showcase': '/docs/reference/data-grid-showcase/data-grid-showcase',
+	'messaging-agent-actions':
+		'/docs/reference/messaging-agent-actions/messaging.agentActions.process',
 };
 
 export function getExampleShowcaseData(
 	key: string
 ): ExampleShowcaseData | undefined {
-	return EXAMPLE_SHOWCASES[key];
+	const example = getDiscoverableExample(key);
+
+	if (!example) {
+		return undefined;
+	}
+
+	const directory = example.entrypoints.packageName.replace(
+		'@contractspec/example.',
+		''
+	);
+	const docsHref = buildExampleDocsHref(key);
+	const sandboxHref = getExamplePreviewHref(key);
+
+	return {
+		key,
+		lead:
+			LEAD_OVERRIDES[key] ??
+			example.meta.summary ??
+			example.meta.description ??
+			'Public ContractSpec reference example.',
+		sandboxHref,
+		referenceHref:
+			REFERENCE_HREF_OVERRIDES[key] ?? buildExampleReferenceHref(key),
+		llmsHref: `/llms/${example.entrypoints.packageName.replace(
+			'@contractspec/',
+			''
+		)}`,
+		repoHref: `https://github.com/lssm-tech/contractspec/tree/main/packages/examples/${directory}`,
+		localCommands: buildLocalCommands(directory, docsHref, sandboxHref),
+	};
+}
+
+function buildLocalCommands(
+	directory: string,
+	docsHref: string,
+	sandboxHref: string | null
+): string {
+	const lines = [
+		`bun run --cwd packages/examples/${directory} build`,
+		'bun run --cwd packages/apps/web-landing dev',
+		'',
+		'# Open in the browser',
+		`# http://localhost:3000${docsHref}`,
+	];
+
+	if (sandboxHref) {
+		lines.push(`# http://localhost:3000${sandboxHref}`);
+	}
+
+	return lines.join('\n');
 }

package/src/components/docs/generated/docs-index._common.json

@@ -66,7 +66,7 @@
 	{
 		"id": "_common/AddNumbersSpec",
 		"title": "AddNumbersSpec",
-		"summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/tests/spec.ts`\n```typescript\nexport const AddNumbersSpec = defineCommand({\\n  meta: { name: 'math.add', version: '1.0.0', /* \\u2026 */ },\\n  io: {\\n    input: AddNumbersInput,\\n    output: AddNumbersOutput,\\n  },\\n  policy: { auth: 'user' },\\n});",
+		"summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/tests/spec.ts`\n```typescript\nimport { compareVersions } from 'compare-versions';\nimport type { DocBlock } from '../docs/types';",
 		"route": "/docs/reference/_common/AddNumbersSpec",
 		"source": "generated",
 		"contentPath": "_common/AddNumbersSpec.md"
@@ -615,6 +615,14 @@
 		"source": "generated",
 		"contentPath": "_common/docs.tech.workflows.overview.md"
 	},
+	{
+		"id": "_common/forms.rich-fields-showcase",
+		"title": "forms.rich-fields-showcase",
+		"summary": "Canonical showcase for readonly, autocomplete, address, phone, temporal, and repeated grouped fields.\n- **Type**: form (form)\n- **Version**: 1.0.0\n- **Tags**: forms, showcase\n- **File**: `packages/libs/contracts-spec/src/forms/richFieldsShowcase.form.ts`",
+		"route": "/docs/reference/_common/forms.rich-fields-showcase",
+		"source": "generated",
+		"contentPath": "_common/forms.rich-fields-showcase.md"
+	},
 	{
 		"id": "_common/init",
 		"title": "init",

package/src/components/docs/generated/docs-index.ai-chat.json

@@ -58,7 +58,7 @@
 	{
 		"id": "ai-chat/ai-chat.error",
 		"title": "ai-chat.error",
-		"summary": "Chat error occurred\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @ai-chat\n- **Tags**: ai-chat, error\n- **File**: `packages/modules/ai-chat/src/events.ts`\n```typescript\nexport const ChatErrorEvent = defineEvent({",
+		"summary": "Chat error occurred\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @ai-chat\n- **Tags**: ai-chat, error\n- **File**: `packages/modules/ai-chat/src/events.ts`\n```typescript\nimport { defineEvent } from '@contractspec/lib.contracts-spec';",
 		"route": "/docs/reference/ai-chat/ai-chat.error",
 		"source": "generated",
 		"contentPath": "ai-chat/ai-chat.error.md"