@contractspec/bundle.library 3.7.7 → 3.8.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.library",
-  "version": "3.7.7",
+  "version": "3.8.2",
   "type": "module",
   "scripts": {
     "clean": "rm -rf dist",
@@ -300,6 +300,18 @@
       "node": "./dist/node/components/docs/examples/DocsExamplesPage.js",
       "default": "./dist/components/docs/examples/DocsExamplesPage.js"
     },
+    "./components/docs/examples/exampleShowcaseData": {
+      "types": "./dist/components/docs/examples/exampleShowcaseData.d.ts",
+      "bun": "./dist/components/docs/examples/exampleShowcaseData.js",
+      "node": "./dist/node/components/docs/examples/exampleShowcaseData.js",
+      "default": "./dist/components/docs/examples/exampleShowcaseData.js"
+    },
+    "./components/docs/examples/ExampleShowcasePage": {
+      "types": "./dist/components/docs/examples/ExampleShowcasePage.d.ts",
+      "bun": "./dist/components/docs/examples/ExampleShowcasePage.js",
+      "node": "./dist/node/components/docs/examples/ExampleShowcasePage.js",
+      "default": "./dist/components/docs/examples/ExampleShowcasePage.js"
+    },
     "./components/docs/generated": {
       "types": "./dist/components/docs/generated/index.d.ts",
       "bun": "./dist/components/docs/generated/index.js",
@@ -1814,23 +1826,23 @@
   "dependencies": {
     "@apollo/client": "^4.1.6",
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@contractspec/lib.ai-providers": "3.7.6",
-    "@contractspec/lib.contracts-spec": "4.0.0",
-    "@contractspec/lib.contracts-library": "3.7.7",
-    "@contractspec/lib.content-gen": "3.7.7",
-    "@contractspec/lib.contracts-runtime-server-mcp": "3.7.7",
-    "@contractspec/lib.design-system": "3.8.0",
-    "@contractspec/lib.surface-runtime": "0.5.7",
-    "@contractspec/lib.provider-ranking": "0.7.6",
-    "@contractspec/lib.example-shared-ui": "6.0.7",
-    "@contractspec/lib.knowledge": "3.7.7",
-    "@contractspec/lib.logger": "3.7.6",
-    "@contractspec/lib.runtime-sandbox": "2.7.6",
-    "@contractspec/lib.schema": "3.7.6",
-    "@contractspec/lib.ui-kit-web": "3.8.0",
-    "@contractspec/lib.ui-link": "3.7.6",
-    "@contractspec/module.context-storage": "0.7.7",
-    "@contractspec/module.examples": "3.7.7",
+    "@contractspec/lib.ai-providers": "3.7.8",
+    "@contractspec/lib.contracts-spec": "4.1.2",
+    "@contractspec/lib.contracts-library": "3.7.10",
+    "@contractspec/lib.content-gen": "3.7.10",
+    "@contractspec/lib.contracts-runtime-server-mcp": "3.7.10",
+    "@contractspec/lib.design-system": "3.8.3",
+    "@contractspec/lib.surface-runtime": "0.5.10",
+    "@contractspec/lib.provider-ranking": "0.7.8",
+    "@contractspec/lib.example-shared-ui": "6.0.10",
+    "@contractspec/lib.knowledge": "3.7.10",
+    "@contractspec/lib.logger": "3.7.8",
+    "@contractspec/lib.runtime-sandbox": "2.7.9",
+    "@contractspec/lib.schema": "3.7.8",
+    "@contractspec/lib.ui-kit-web": "3.9.2",
+    "@contractspec/lib.ui-link": "3.7.8",
+    "@contractspec/module.context-storage": "0.7.10",
+    "@contractspec/module.examples": "3.8.2",
     "@dnd-kit/core": "^6.1.0",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -1846,16 +1858,16 @@
     "posthog-react-native": "^4.37.4",
     "react-hook-form": "^7.71.2",
     "zod": "^4.3.5",
-    "@contractspec/lib.contracts-integrations": "3.7.7",
-    "@contractspec/lib.contracts-runtime-server-rest": "3.7.7",
-    "@contractspec/lib.contracts-runtime-server-graphql": "3.7.7"
+    "@contractspec/lib.contracts-integrations": "3.8.2",
+    "@contractspec/lib.contracts-runtime-server-rest": "3.7.10",
+    "@contractspec/lib.contracts-runtime-server-graphql": "3.7.10"
   },
   "devDependencies": {
     "@types/react": "~19.2.14",
-    "@contractspec/tool.typescript": "3.7.6",
+    "@contractspec/tool.typescript": "3.7.8",
     "typescript": "^5.9.3",
     "@types/bun": "~1.3.11",
-    "@contractspec/tool.bun": "3.7.6"
+    "@contractspec/tool.bun": "3.7.8"
   },
   "repository": {
     "type": "git",
@@ -2148,6 +2160,18 @@
         "node": "./dist/node/components/docs/examples/DocsExamplesPage.js",
         "default": "./dist/components/docs/examples/DocsExamplesPage.js"
       },
+      "./components/docs/examples/exampleShowcaseData": {
+        "types": "./dist/components/docs/examples/exampleShowcaseData.d.ts",
+        "bun": "./dist/components/docs/examples/exampleShowcaseData.js",
+        "node": "./dist/node/components/docs/examples/exampleShowcaseData.js",
+        "default": "./dist/components/docs/examples/exampleShowcaseData.js"
+      },
+      "./components/docs/examples/ExampleShowcasePage": {
+        "types": "./dist/components/docs/examples/ExampleShowcasePage.d.ts",
+        "bun": "./dist/components/docs/examples/ExampleShowcasePage.js",
+        "node": "./dist/node/components/docs/examples/ExampleShowcasePage.js",
+        "default": "./dist/components/docs/examples/ExampleShowcasePage.js"
+      },
       "./components/docs/generated": {
         "types": "./dist/components/docs/generated/index.d.ts",
         "bun": "./dist/components/docs/generated/index.js",

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

@@ -9,6 +9,7 @@ import {
 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';
 
 interface ExampleItem extends Record<string, unknown> {
 	id: string;
@@ -23,6 +24,12 @@ 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()
 		.map((example) => {
@@ -31,7 +38,7 @@ export function DocsExamplesPage() {
 				id: example.meta.key,
 				title,
 				summary: example.meta.summary ?? example.meta.description,
-				route: buildReferenceRoute(example.meta.key),
+				route: buildDocsRoute(example.meta.key),
 				tags: example.meta.tags,
 				sandboxEnabled: example.surfaces.sandbox.enabled,
 			};
@@ -65,7 +72,11 @@ export function DocsExamplesPage() {
 					return (
 						<HStack gap="xs" justify="end">
 							{example.sandboxEnabled ? (
-								<ButtonLink href="/sandbox" size="sm" variant="outline">
+								<ButtonLink
+									href={`/sandbox?template=${example.id}`}
+									size="sm"
+									variant="outline"
+								>
 									Sandbox
 								</ButtonLink>
 							) : null}

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

@@ -0,0 +1,122 @@
+import { ButtonLink, CodeBlock } from '@contractspec/lib.design-system';
+import Link from '@contractspec/lib.ui-link';
+import { getExample } from '@contractspec/module.examples';
+import { FileCode2, Play, TerminalSquare } from 'lucide-react';
+import { getExampleShowcaseData } from './exampleShowcaseData';
+
+interface ExampleShowcasePageProps {
+	exampleKey: 'agent-console' | 'ai-chat-assistant' | 'messaging-agent-actions';
+}
+
+export function ExampleShowcasePage({ exampleKey }: ExampleShowcasePageProps) {
+	const showcase = getExampleShowcaseData(exampleKey);
+	const example = getExample(exampleKey);
+
+	if (!showcase || !example) {
+		return null;
+	}
+
+	const title = example.meta.title ?? example.meta.key;
+	const summary = example.meta.summary ?? example.meta.description ?? '';
+	const packageName = example.entrypoints.packageName;
+
+	return (
+		<div className="space-y-10">
+			<section className="space-y-5">
+				<p className="editorial-kicker">Meetup-ready example</p>
+				<h1 className="editorial-title max-w-5xl">{title}</h1>
+				<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>
+					<ButtonLink href={showcase.referenceHref} variant="outline">
+						Generated reference
+					</ButtonLink>
+				</div>
+			</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} />
+						</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>
+
+				<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">
+							<FileCode2 size={18} />
+						</div>
+						<h2 className="font-semibold text-xl">Reference docs</h2>
+					</div>
+					<p className="editorial-copy text-sm">
+						Inspect the generated contract-facing material instead of relying on
+						marketing summaries.
+					</p>
+					<ButtonLink href={showcase.referenceHref} size="sm" variant="outline">
+						Open reference
+					</ButtonLink>
+				</article>
+
+				<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">
+							<TerminalSquare size={18} />
+						</div>
+						<h2 className="font-semibold text-xl">Package context</h2>
+					</div>
+					<p className="editorial-copy text-sm">
+						Use the agent-facing package page for fast repo orientation, then
+						jump to the source directory.
+					</p>
+					<p className="rounded-[18px] border border-border/70 bg-background/75 px-4 py-3 font-mono text-sm">
+						{packageName}
+					</p>
+					<div className="flex flex-wrap gap-2">
+						<ButtonLink href={showcase.llmsHref} size="sm" variant="outline">
+							LLMS page
+						</ButtonLink>
+						<ButtonLink href={showcase.repoHref} size="sm" variant="outline">
+							GitHub source
+						</ButtonLink>
+					</div>
+				</article>
+			</section>
+
+			<section className="editorial-panel space-y-5">
+				<div className="space-y-2">
+					<p className="editorial-kicker">Talk commands</p>
+					<h2 className="editorial-panel-title">
+						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.
+					</p>
+				</div>
+				<CodeBlock
+					language="bash"
+					filename={`${exampleKey}-meetup-runbook`}
+					code={showcase.localCommands}
+				/>
+				<p className="text-muted-foreground text-sm">
+					For the full fallback order and safe live-edit workflow, use{' '}
+					<Link href="https://github.com/lssm-tech/contractspec/blob/main/docs/meetup-agent-examples-runbook.md">
+						the meetup runbook
+					</Link>
+					.
+				</p>
+			</section>
+		</div>
+	);
+}

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

@@ -0,0 +1,65 @@
+export interface ExampleShowcaseData {
+	key: 'agent-console' | 'ai-chat-assistant' | 'messaging-agent-actions';
+	lead: string;
+	sandboxHref: string;
+	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
+
+# Open in the browser
+# http://localhost:3000/sandbox?template=messaging-agent-actions`,
+	},
+};
+
+export function getExampleShowcaseData(
+	key: string
+): ExampleShowcaseData | undefined {
+	return EXAMPLE_SHOWCASES[key];
+}

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

@@ -1 +1,2 @@
 export { DocsExamplesPage } from './DocsExamplesPage';
+export { ExampleShowcasePage } from './ExampleShowcasePage';