@contractspec/bundle.library 3.7.7 → 3.8.2

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # @contractspec/bundle.library
 
+## 3.8.2
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/lib.contracts-runtime-server-graphql@3.7.10
+  - @contractspec/lib.contracts-runtime-server-rest@3.7.10
+  - @contractspec/lib.contracts-runtime-server-mcp@3.7.10
+  - @contractspec/lib.contracts-integrations@3.8.2
+  - @contractspec/module.context-storage@0.7.10
+  - @contractspec/lib.contracts-library@3.7.10
+  - @contractspec/lib.example-shared-ui@6.0.10
+  - @contractspec/lib.provider-ranking@0.7.8
+  - @contractspec/lib.runtime-sandbox@2.7.9
+  - @contractspec/lib.surface-runtime@0.5.10
+  - @contractspec/lib.contracts-spec@4.1.2
+  - @contractspec/lib.design-system@3.8.3
+  - @contractspec/lib.ai-providers@3.7.8
+  - @contractspec/lib.content-gen@3.7.10
+  - @contractspec/module.examples@3.8.2
+  - @contractspec/lib.ui-kit-web@3.9.2
+  - @contractspec/lib.knowledge@3.7.10
+  - @contractspec/lib.ui-link@3.7.8
+  - @contractspec/lib.logger@3.7.8
+  - @contractspec/lib.schema@3.7.8
+
+## 3.8.1
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-runtime-server-graphql@3.7.9
+  - @contractspec/lib.contracts-runtime-server-rest@3.7.9
+  - @contractspec/lib.contracts-runtime-server-mcp@3.7.9
+  - @contractspec/lib.contracts-integrations@3.8.1
+  - @contractspec/module.context-storage@0.7.9
+  - @contractspec/lib.contracts-library@3.7.9
+  - @contractspec/lib.example-shared-ui@6.0.9
+  - @contractspec/lib.runtime-sandbox@2.7.8
+  - @contractspec/lib.surface-runtime@0.5.9
+  - @contractspec/lib.contracts-spec@4.1.1
+  - @contractspec/lib.design-system@3.8.2
+  - @contractspec/lib.content-gen@3.7.9
+  - @contractspec/module.examples@3.8.1
+  - @contractspec/lib.ui-kit-web@3.9.1
+  - @contractspec/lib.knowledge@3.7.9
+  - @contractspec/lib.ui-link@3.7.7
+  - @contractspec/lib.ai-providers@3.7.7
+  - @contractspec/lib.logger@3.7.7
+  - @contractspec/lib.provider-ranking@0.7.7
+  - @contractspec/lib.schema@3.7.7
+
 ## 3.7.6
 
 ### Patch Changes
@@ -231,6 +285,7 @@
 ### Patch Changes
 
 - 27b77db: feat(ai-models): add latest models and align defaults
+
   - Add claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5, gpt-5.4, gpt-5-mini
   - Add mistral-large-2512, mistral-medium-2508, mistral-small-2506, devstral-2512
   - Add gemini-3.1-pro-preview, gemini-3.1-flash-lite-preview, gemini-3-flash-preview
@@ -380,6 +435,7 @@
 ### Patch Changes
 
 - 1fa29a0: feat(bundle.library): add LibraryBundle, WorkspaceShellRenderer, bundles export
+
   - Add LibraryBundle and bundles/index for workspace shell composition
   - Add WorkspaceShellRenderer component for dynamic slot rendering
   - Add @contractspec/lib.surface-runtime dependency

package/dist/components/docs/examples/DocsExamplesPage.js

@@ -1,4 +1,54 @@
 // @bun
+// src/components/docs/examples/exampleShowcaseData.ts
+var EXAMPLE_SHOWCASES = {
+  "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`
+  }
+};
+function getExampleShowcaseData(key) {
+  return EXAMPLE_SHOWCASES[key];
+}
+
 // src/components/docs/examples/DocsExamplesPage.tsx
 import { ExampleCatalogDataView } from "@contractspec/lib.contracts-spec/docs";
 import {
@@ -14,6 +64,9 @@ import { jsx, jsxs } from "react/jsx-runtime";
 function buildReferenceRoute(key) {
   return `/docs/reference/${key}/${key}`;
 }
+function buildDocsRoute(key) {
+  return getExampleShowcaseData(key)?.sandboxHref ? `/docs/examples/${key}` : buildReferenceRoute(key);
+}
 function DocsExamplesPage() {
   const items = listExamples().map((example) => {
     const title = example.meta.title ?? example.meta.key;
@@ -21,7 +74,7 @@ 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
     };
@@ -59,7 +112,7 @@ function DocsExamplesPage() {
             justify: "end",
             children: [
               example.sandboxEnabled ? /* @__PURE__ */ jsx(ButtonLink, {
-                href: "/sandbox",
+                href: `/sandbox?template=${example.id}`,
                 size: "sm",
                 variant: "outline",
                 children: "Sandbox"

package/dist/components/docs/examples/ExampleShowcasePage.d.ts

@@ -0,0 +1,5 @@
+interface ExampleShowcasePageProps {
+    exampleKey: 'agent-console' | 'ai-chat-assistant' | 'messaging-agent-actions';
+}
+export declare function ExampleShowcasePage({ exampleKey }: ExampleShowcasePageProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/docs/examples/ExampleShowcasePage.js

@@ -0,0 +1,258 @@
+// @bun
+// src/components/docs/examples/exampleShowcaseData.ts
+var EXAMPLE_SHOWCASES = {
+  "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`
+  }
+};
+function getExampleShowcaseData(key) {
+  return EXAMPLE_SHOWCASES[key];
+}
+
+// src/components/docs/examples/ExampleShowcasePage.tsx
+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 { jsx, jsxs } from "react/jsx-runtime";
+function ExampleShowcasePage({ exampleKey }) {
+  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 /* @__PURE__ */ jsxs("div", {
+    className: "space-y-10",
+    children: [
+      /* @__PURE__ */ jsxs("section", {
+        className: "space-y-5",
+        children: [
+          /* @__PURE__ */ jsx("p", {
+            className: "editorial-kicker",
+            children: "Meetup-ready example"
+          }),
+          /* @__PURE__ */ jsx("h1", {
+            className: "editorial-title max-w-5xl",
+            children: title
+          }),
+          /* @__PURE__ */ jsx("p", {
+            className: "editorial-subtitle",
+            children: showcase.lead
+          }),
+          /* @__PURE__ */ jsx("p", {
+            className: "editorial-copy max-w-4xl",
+            children: summary
+          }),
+          /* @__PURE__ */ jsxs("div", {
+            className: "flex flex-wrap gap-3",
+            children: [
+              /* @__PURE__ */ jsx(ButtonLink, {
+                href: showcase.sandboxHref,
+                children: "Open sandbox"
+              }),
+              /* @__PURE__ */ jsx(ButtonLink, {
+                href: showcase.referenceHref,
+                variant: "outline",
+                children: "Generated reference"
+              })
+            ]
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsxs("section", {
+        className: "grid gap-5 lg:grid-cols-3",
+        children: [
+          /* @__PURE__ */ jsxs("article", {
+            className: "editorial-panel space-y-4",
+            children: [
+              /* @__PURE__ */ jsxs("div", {
+                className: "flex items-center gap-3",
+                children: [
+                  /* @__PURE__ */ jsx("div", {
+                    className: "rounded-full border border-border/80 bg-background/85 p-2",
+                    children: /* @__PURE__ */ jsx(Play, {
+                      size: 18
+                    })
+                  }),
+                  /* @__PURE__ */ jsx("h2", {
+                    className: "font-semibold text-xl",
+                    children: "Sandbox preview"
+                  })
+                ]
+              }),
+              /* @__PURE__ */ jsx("p", {
+                className: "editorial-copy text-sm",
+                children: "Load the same public browser surface used for the prepared live demo."
+              }),
+              /* @__PURE__ */ jsx(ButtonLink, {
+                href: showcase.sandboxHref,
+                size: "sm",
+                children: "Open preview"
+              })
+            ]
+          }),
+          /* @__PURE__ */ jsxs("article", {
+            className: "editorial-panel space-y-4",
+            children: [
+              /* @__PURE__ */ jsxs("div", {
+                className: "flex items-center gap-3",
+                children: [
+                  /* @__PURE__ */ jsx("div", {
+                    className: "rounded-full border border-border/80 bg-background/85 p-2",
+                    children: /* @__PURE__ */ jsx(FileCode2, {
+                      size: 18
+                    })
+                  }),
+                  /* @__PURE__ */ jsx("h2", {
+                    className: "font-semibold text-xl",
+                    children: "Reference docs"
+                  })
+                ]
+              }),
+              /* @__PURE__ */ jsx("p", {
+                className: "editorial-copy text-sm",
+                children: "Inspect the generated contract-facing material instead of relying on marketing summaries."
+              }),
+              /* @__PURE__ */ jsx(ButtonLink, {
+                href: showcase.referenceHref,
+                size: "sm",
+                variant: "outline",
+                children: "Open reference"
+              })
+            ]
+          }),
+          /* @__PURE__ */ jsxs("article", {
+            className: "editorial-panel space-y-4",
+            children: [
+              /* @__PURE__ */ jsxs("div", {
+                className: "flex items-center gap-3",
+                children: [
+                  /* @__PURE__ */ jsx("div", {
+                    className: "rounded-full border border-border/80 bg-background/85 p-2",
+                    children: /* @__PURE__ */ jsx(TerminalSquare, {
+                      size: 18
+                    })
+                  }),
+                  /* @__PURE__ */ jsx("h2", {
+                    className: "font-semibold text-xl",
+                    children: "Package context"
+                  })
+                ]
+              }),
+              /* @__PURE__ */ jsx("p", {
+                className: "editorial-copy text-sm",
+                children: "Use the agent-facing package page for fast repo orientation, then jump to the source directory."
+              }),
+              /* @__PURE__ */ jsx("p", {
+                className: "rounded-[18px] border border-border/70 bg-background/75 px-4 py-3 font-mono text-sm",
+                children: packageName
+              }),
+              /* @__PURE__ */ jsxs("div", {
+                className: "flex flex-wrap gap-2",
+                children: [
+                  /* @__PURE__ */ jsx(ButtonLink, {
+                    href: showcase.llmsHref,
+                    size: "sm",
+                    variant: "outline",
+                    children: "LLMS page"
+                  }),
+                  /* @__PURE__ */ jsx(ButtonLink, {
+                    href: showcase.repoHref,
+                    size: "sm",
+                    variant: "outline",
+                    children: "GitHub source"
+                  })
+                ]
+              })
+            ]
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsxs("section", {
+        className: "editorial-panel space-y-5",
+        children: [
+          /* @__PURE__ */ jsxs("div", {
+            className: "space-y-2",
+            children: [
+              /* @__PURE__ */ jsx("p", {
+                className: "editorial-kicker",
+                children: "Talk commands"
+              }),
+              /* @__PURE__ */ jsx("h2", {
+                className: "editorial-panel-title",
+                children: "Exact local commands for the meetup lane"
+              }),
+              /* @__PURE__ */ jsx("p", {
+                className: "editorial-copy text-sm",
+                children: "Use the package build and test first, then launch the web shell and open the prepared sandbox route."
+              })
+            ]
+          }),
+          /* @__PURE__ */ jsx(CodeBlock, {
+            language: "bash",
+            filename: `${exampleKey}-meetup-runbook`,
+            code: showcase.localCommands
+          }),
+          /* @__PURE__ */ jsxs("p", {
+            className: "text-muted-foreground text-sm",
+            children: [
+              "For the full fallback order and safe live-edit workflow, use",
+              " ",
+              /* @__PURE__ */ jsx(Link, {
+                href: "https://github.com/lssm-tech/contractspec/blob/main/docs/meetup-agent-examples-runbook.md",
+                children: "the meetup runbook"
+              }),
+              "."
+            ]
+          })
+        ]
+      })
+    ]
+  });
+}
+export {
+  ExampleShowcasePage
+};

package/dist/components/docs/examples/exampleShowcaseData.d.ts

@@ -0,0 +1,10 @@
+export interface ExampleShowcaseData {
+    key: 'agent-console' | 'ai-chat-assistant' | 'messaging-agent-actions';
+    lead: string;
+    sandboxHref: string;
+    referenceHref: string;
+    llmsHref: string;
+    repoHref: string;
+    localCommands: string;
+}
+export declare function getExampleShowcaseData(key: string): ExampleShowcaseData | undefined;

package/dist/components/docs/examples/exampleShowcaseData.js

@@ -0,0 +1,53 @@
+// @bun
+// src/components/docs/examples/exampleShowcaseData.ts
+var EXAMPLE_SHOWCASES = {
+  "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`
+  }
+};
+function getExampleShowcaseData(key) {
+  return EXAMPLE_SHOWCASES[key];
+}
+export {
+  getExampleShowcaseData
+};

package/dist/components/docs/examples/index.d.ts

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