@contractspec/module.examples 3.7.6 → 3.8.2

package/README.md

@@ -1,21 +1,69 @@
 # @contractspec/module.examples
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Example contract specifications collection.**
 
-Pure, deterministic types and registries for ContractSpec Examples.
+## What It Provides
 
-## Purpose
+- **Layer**: module.
+- **Consumers**: apps (web-landing, docs), bundles (contractspec-studio).
+- Related ContractSpec packages include `@contractspec/example.agent-console`, `@contractspec/example.ai-chat-assistant`, `@contractspec/example.ai-support-bot`, `@contractspec/example.analytics-dashboard`, `@contractspec/example.calendar-google`, `@contractspec/example.content-generation`, ...
+- `agent-console` is the default autonomous-agent showcase surfaced through `/sandbox`.
+- `data-grid-showcase` is the focused ContractSpec table showcase surfaced through `/sandbox?template=data-grid-showcase`.
 
-This module defines the canonical “Example” shape (metadata + entrypoints) and exposes:
+## Installation
 
-- A registry API to list/search examples
-- Pure validators to enforce minimum required metadata across examples
+`npm install @contractspec/module.examples`
 
-## Design principles
+or
 
-- No I/O (no filesystem, no network)
-- Deterministic outputs from explicit inputs
-- Strong typing (no `any`)
+`bun add @contractspec/module.examples`
 
+## Usage
 
+Import the root entrypoint from `@contractspec/module.examples`, or choose a documented subpath when you only need one part of the package surface.
+
+## Architecture
+
+- `src/builtins.ts` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/registry.test.ts` is part of the package's public or composition surface.
+- `src/registry.ts` is part of the package's public or composition surface.
+- `src/runtime` is part of the package's public or composition surface.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run generate:registry` — bun ../../../scripts/generate-example-registry.ts --write
+- `bun run prebuild` — bun run generate:registry && contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Add table capabilities.
+- Stability.
+- Vnext ai-native.
+
+## Notes
+
+- This module is a thin aggregator -- business logic belongs in individual example packages under `packages/examples/`.
+- Adding a new example requires both creating the example package and wiring it as a dependency here.
+- Depends on ~30 example workspace packages; keep the dependency list in sync with `packages/examples/`.
+- The meetup-ready autonomous-agent path is the deterministic `agent-console` sandbox plus its replay proof lane.
+- The shared ContractSpec table stack is demonstrated directly by `data-grid-showcase` and reused in `analytics-dashboard`, `crm-pipeline`, `integration-hub`, and `agent-console`.

package/dist/builtins.d.ts

@@ -1,2 +1,2 @@
-import type { ExampleSpec } from "@contractspec/lib.contracts-spec/examples/types";
+import type { ExampleSpec } from '@contractspec/lib.contracts-spec/examples/types';
 export declare const EXAMPLE_REGISTRY: readonly ExampleSpec[];

package/dist/index.d.ts

@@ -4,7 +4,7 @@
  * Pure types + registries for ContractSpec examples.
  */
 export * from './registry';
+export * from './runtime/context';
 export * from './runtime/engine';
 export * from './runtime/installer';
 export * from './runtime/registry';
-export * from './runtime/context';

package/dist/index.js

@@ -10,6 +10,7 @@ import AnalyticsDashboard from "@contractspec/example.analytics-dashboard/exampl
 import CalendarGoogle from "@contractspec/example.calendar-google/example";
 import ContentGeneration from "@contractspec/example.content-generation/example";
 import CrmPipeline from "@contractspec/example.crm-pipeline/example";
+import DataGridShowcase from "@contractspec/example.data-grid-showcase/example";
 import EmailGmail from "@contractspec/example.email-gmail/example";
 import InAppDocs from "@contractspec/example.in-app-docs/example";
 import IntegrationHub from "@contractspec/example.integration-hub/example";
@@ -35,7 +36,10 @@ import LifecycleDashboard from "@contractspec/example.lifecycle-dashboard/exampl
 import LocaleJurisdictionGate from "@contractspec/example.locale-jurisdiction-gate/example";
 import Marketplace from "@contractspec/example.marketplace/example";
 import MeetingRecorderProviders from "@contractspec/example.meeting-recorder-providers/example";
+import MessagingAgentActions from "@contractspec/example.messaging-agent-actions/example";
+import Minimal from "@contractspec/example.minimal/example";
 import OpenbankingPowens from "@contractspec/example.openbanking-powens/example";
+import OpencodeCli from "@contractspec/example.opencode-cli/example";
 import Personalization from "@contractspec/example.personalization/example";
 import PocketFamilyOffice from "@contractspec/example.pocket-family-office/example";
 import PolicySafeKnowledgeAssistant from "@contractspec/example.policy-safe-knowledge-assistant/example";
@@ -48,6 +52,7 @@ import VersionedKnowledgeBase from "@contractspec/example.versioned-knowledge-ba
 import VideoApiShowcase from "@contractspec/example.video-api-showcase/example";
 import VideoDocsTerminal from "@contractspec/example.video-docs-terminal/example";
 import VideoMarketingClip from "@contractspec/example.video-marketing-clip/example";
+import VisualizationShowcase from "@contractspec/example.visualization-showcase/example";
 import VoiceProviders from "@contractspec/example.voice-providers/example";
 import WealthSnapshot from "@contractspec/example.wealth-snapshot/example";
 import WorkflowSystem from "@contractspec/example.workflow-system/example";
@@ -59,6 +64,7 @@ var EXAMPLE_REGISTRY = [
   CalendarGoogle,
   ContentGeneration,
   CrmPipeline,
+  DataGridShowcase,
   EmailGmail,
   InAppDocs,
   IntegrationHub,
@@ -84,7 +90,10 @@ var EXAMPLE_REGISTRY = [
   LocaleJurisdictionGate,
   Marketplace,
   MeetingRecorderProviders,
+  MessagingAgentActions,
+  Minimal,
   OpenbankingPowens,
+  OpencodeCli,
   Personalization,
   PocketFamilyOffice,
   PolicySafeKnowledgeAssistant,
@@ -97,6 +106,7 @@ var EXAMPLE_REGISTRY = [
   VideoApiShowcase,
   VideoDocsTerminal,
   VideoMarketingClip,
+  VisualizationShowcase,
   VoiceProviders,
   WealthSnapshot,
   WorkflowSystem
@@ -118,12 +128,43 @@ function getExample(key) {
 function searchExamples(query) {
   return globalRegistry.search(query);
 }
-// src/runtime/engine.ts
+// src/runtime/context.tsx
+import { ApolloProvider } from "@apollo/client/react";
+import { web as web2 } from "@contractspec/lib.runtime-sandbox";
+import { useEffect, useMemo, useState } from "react";
 import {
-  createDefaultTransformEngine,
-  registerBasicValidation,
-  registerDefaultReactRenderer
-} from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+  AGENT_CONSOLE_DEMO_ORGANIZATION_ID,
+  createAgentConsoleDemoHandlers,
+  getAgentConsoleDashboardData
+} from "@contractspec/example.agent-console";
+import {
+  createAnalyticsHandlers
+} from "@contractspec/example.analytics-dashboard";
+import {
+  createCrmHandlers
+} from "@contractspec/example.crm-pipeline";
+import {
+  createIntegrationHandlers
+} from "@contractspec/example.integration-hub";
+import {
+  createMarketplaceHandlers
+} from "@contractspec/example.marketplace";
+import {
+  createPolicySafeKnowledgeAssistantHandlers
+} from "@contractspec/example.policy-safe-knowledge-assistant";
+import {
+  createSaasHandlers
+} from "@contractspec/example.saas-boilerplate";
+import {
+  createWorkflowHandlers
+} from "@contractspec/example.workflow-system";
+import {
+  TemplateRuntimeContext,
+  useTemplateComponents,
+  useTemplateRuntime
+} from "@contractspec/lib.example-shared-ui";
+
+// src/runtime/engine.ts
 import {
   agentDashboardMarkdownRenderer,
   agentListMarkdownRenderer,
@@ -132,36 +173,42 @@ import {
   toolRegistryMarkdownRenderer
 } from "@contractspec/example.agent-console";
 import {
-  projectListMarkdownRenderer,
-  projectListReactRenderer,
-  saasBillingMarkdownRenderer,
-  saasDashboardMarkdownRenderer
-} from "@contractspec/example.saas-boilerplate";
+  analyticsDashboardMarkdownRenderer,
+  dashboardListMarkdownRenderer,
+  queryBuilderMarkdownRenderer
+} from "@contractspec/example.analytics-dashboard";
 import {
   crmDashboardMarkdownRenderer,
   crmPipelineMarkdownRenderer,
   crmPipelineReactRenderer
 } from "@contractspec/example.crm-pipeline";
 import {
-  workflowDashboardMarkdownRenderer,
-  workflowDefinitionListMarkdownRenderer,
-  workflowInstanceDetailMarkdownRenderer
-} from "@contractspec/example.workflow-system";
+  connectionListMarkdownRenderer,
+  integrationDashboardMarkdownRenderer,
+  syncConfigMarkdownRenderer
+} from "@contractspec/example.integration-hub";
 import {
   marketplaceDashboardMarkdownRenderer,
   orderListMarkdownRenderer,
   productCatalogMarkdownRenderer
 } from "@contractspec/example.marketplace";
 import {
-  connectionListMarkdownRenderer,
-  integrationDashboardMarkdownRenderer,
-  syncConfigMarkdownRenderer
-} from "@contractspec/example.integration-hub";
+  projectListMarkdownRenderer,
+  projectListReactRenderer,
+  saasBillingMarkdownRenderer,
+  saasDashboardMarkdownRenderer
+} from "@contractspec/example.saas-boilerplate";
+import { visualizationShowcaseMarkdownRenderer } from "@contractspec/example.visualization-showcase/ui/renderers";
 import {
-  analyticsDashboardMarkdownRenderer,
-  dashboardListMarkdownRenderer,
-  queryBuilderMarkdownRenderer
-} from "@contractspec/example.analytics-dashboard";
+  workflowDashboardMarkdownRenderer,
+  workflowDefinitionListMarkdownRenderer,
+  workflowInstanceDetailMarkdownRenderer
+} from "@contractspec/example.workflow-system";
+import {
+  createDefaultTransformEngine,
+  registerBasicValidation,
+  registerDefaultReactRenderer
+} from "@contractspec/lib.contracts-spec/presentations/transform-engine";
 function createTemplateTransformEngine() {
   const engine = createDefaultTransformEngine();
   registerDefaultReactRenderer(engine);
@@ -194,6 +241,7 @@ function registerTemplateRenderers(engine) {
   engine.register(analyticsDashboardMarkdownRenderer);
   engine.register(dashboardListMarkdownRenderer);
   engine.register(queryBuilderMarkdownRenderer);
+  engine.register(visualizationShowcaseMarkdownRenderer);
 }
 var templateEngine = null;
 function getTemplateEngine() {
@@ -205,6 +253,10 @@ function getTemplateEngine() {
 function resetTemplateEngine() {
   templateEngine = null;
 }
+
+// src/runtime/installer.ts
+import { web } from "@contractspec/lib.runtime-sandbox";
+
 // src/runtime/registry.ts
 var PRESENTATIONS_BY_TEMPLATE = {
   "saas-boilerplate": [
@@ -215,9 +267,9 @@ var PRESENTATIONS_BY_TEMPLATE = {
   "crm-pipeline": ["crm-pipeline.dashboard", "crm-pipeline.deal.pipeline"],
   "agent-console": [
     "agent-console.dashboard",
-    "agent-console.agent.list",
+    "agent-console.agent.viewList",
     "agent-console.run.list",
-    "agent-console.tool.registry"
+    "agent-console.tool.list"
   ],
   "workflow-system": [
     "workflow-system.dashboard",
@@ -227,8 +279,7 @@ var PRESENTATIONS_BY_TEMPLATE = {
   marketplace: [
     "marketplace.dashboard",
     "marketplace.product.catalog",
-    "marketplace.order.list",
-    "marketplace.store.manage"
+    "marketplace.order.list"
   ],
   "integration-hub": [
     "integration-hub.dashboard",
@@ -240,6 +291,7 @@ var PRESENTATIONS_BY_TEMPLATE = {
     "analytics-dashboard.list",
     "analytics-dashboard.query.builder"
   ],
+  "visualization-showcase": ["visualization-showcase.gallery"],
   "learning-journey-studio-onboarding": [
     "learning.journey.track_list",
     "learning.journey.track_detail",
@@ -271,6 +323,28 @@ var PRESENTATIONS_BY_TEMPLATE = {
     "learning.journey.progress_widget"
   ]
 };
+var GENERATED_TEMPLATE_REGISTRY = listExamples().filter((example) => example.meta.key !== "agent-console").map((example) => {
+  const tags = [...example.meta.tags ?? []];
+  const category = tags.some((tag) => tag.toLowerCase() === "ai") || tags.some((tag) => tag.toLowerCase() === "assistant") ? "ai" : "business";
+  return {
+    id: example.meta.key,
+    name: example.meta.title ?? example.meta.key,
+    description: example.meta.description ?? "",
+    category,
+    complexity: "beginner",
+    icon: "\uD83D\uDCE6",
+    features: [],
+    tags,
+    schema: { models: [], contracts: [] },
+    components: { list: "ExampleList", detail: "ExampleDetail" },
+    preview: {
+      demoUrl: `/sandbox?template=${encodeURIComponent(example.meta.key)}`
+    },
+    package: example.entrypoints.packageName,
+    presentations: PRESENTATIONS_BY_TEMPLATE[example.meta.key] ?? [],
+    renderTargets: ["react", "markdown"]
+  };
+});
 var TEMPLATE_REGISTRY = [
   {
     id: "todos-app",
@@ -357,30 +431,42 @@ var TEMPLATE_REGISTRY = [
       quickstart: "/docs/templates/recipe-app-i18n"
     }
   },
-  ...listExamples().map((example) => {
-    const tags = example.meta.keywords ?? [];
-    const category = tags.some((t) => t.toLowerCase() === "ai") || tags.some((t) => t.toLowerCase() === "assistant") ? "ai" : "business";
-    const complexity = "beginner";
-    const icon = "\uD83D\uDCE6";
-    return {
-      id: example.meta.key,
-      name: example.meta.title ?? example.meta.key,
-      description: example.meta.description ?? "",
-      category,
-      complexity,
-      icon,
-      features: [],
-      tags: [...tags],
-      schema: { models: [], contracts: [] },
-      components: { list: "ExampleList", detail: "ExampleDetail" },
-      preview: {
-        demoUrl: `/sandbox?template=${encodeURIComponent(example.meta.key)}`
-      },
-      package: example.entrypoints.packageName,
-      presentations: PRESENTATIONS_BY_TEMPLATE[example.meta.key] ?? [],
-      renderTargets: ["react", "markdown"]
-    };
-  })
+  {
+    id: "agent-console",
+    name: "Agent Console",
+    description: "Deterministic autonomous-agent walkthrough with seeded agents, tool registry, runs, metrics, and replayable proof.",
+    category: "ai",
+    complexity: "intermediate",
+    icon: "\uD83E\uDD16",
+    features: [
+      "Seeded autonomous agents",
+      "Tool registry",
+      "Run execution history",
+      "Metrics",
+      "Markdown and React views"
+    ],
+    tags: ["ai", "agents", "autonomous", "meetup", "sandbox"],
+    schema: {
+      models: ["Agent", "Tool", "Run"],
+      contracts: [
+        "agent-console.agent.list",
+        "agent-console.agent.create",
+        "agent-console.run.execute"
+      ]
+    },
+    components: {
+      list: "AgentListView",
+      detail: "RunListView",
+      form: "CreateAgentModal"
+    },
+    preview: {
+      demoUrl: "/sandbox?template=agent-console"
+    },
+    package: "@contractspec/example.agent-console",
+    presentations: PRESENTATIONS_BY_TEMPLATE["agent-console"] ?? [],
+    renderTargets: ["react", "markdown"]
+  },
+  ...GENERATED_TEMPLATE_REGISTRY
 ];
 function listTemplates(filter) {
   if (!filter)
@@ -454,7 +540,6 @@ class ContractSpecRegistryClient {
 }
 
 // src/runtime/installer.ts
-import { web } from "@contractspec/lib.runtime-sandbox";
 "use client";
 var { LocalRuntimeServices } = web;
 var SAVE_TEMPLATE_MUTATION = `
@@ -560,39 +645,60 @@ function toBase64(bytes) {
   });
   return btoa(binary);
 }
+
+// src/runtime/presentations.ts
+function createComponentPresentation(key, title, description, goal, context, componentKey) {
+  return {
+    meta: {
+      key,
+      version: "1.0.0",
+      title,
+      description,
+      stability: "experimental",
+      goal,
+      context,
+      owners: ["@contractspec/examples"],
+      tags: ["template", "sandbox"]
+    },
+    source: {
+      type: "component",
+      framework: "react",
+      componentKey
+    },
+    targets: ["react", "markdown"]
+  };
+}
+var TEMPLATE_PRESENTATIONS = {
+  "agent-console.dashboard": createComponentPresentation("agent-console.dashboard", "Agent Console Dashboard", "Operational dashboard for the agent console example.", "Review agent activity, throughput, and execution health.", "Sandbox presentation used for markdown previews.", "AgentConsoleDashboard"),
+  "agent-console.agent.list": createComponentPresentation("agent-console.agent.list", "Agent List", "List of seeded agents in the agent console example.", "Browse configured agents and their current capabilities.", "Sandbox presentation used for markdown previews.", "AgentListView"),
+  "agent-console.agent.viewList": createComponentPresentation("agent-console.agent.viewList", "Agent List", "List of seeded agents in the agent console example.", "Browse configured agents and their current capabilities.", "Sandbox presentation used for markdown previews.", "AgentListView"),
+  "agent-console.run.list": createComponentPresentation("agent-console.run.list", "Run List", "Execution history for the agent console example.", "Inspect recent runs and their outcomes.", "Sandbox presentation used for markdown previews.", "RunListView"),
+  "agent-console.tool.list": createComponentPresentation("agent-console.tool.list", "Tool Registry", "Available tools for the agent console example.", "Inspect the tool registry exposed to the seeded agents.", "Sandbox presentation used for markdown previews.", "ToolRegistryView"),
+  "agent-console.tool.registry": createComponentPresentation("agent-console.tool.registry", "Tool Registry", "Available tools for the agent console example.", "Inspect the tool registry exposed to the seeded agents.", "Sandbox presentation used for markdown previews.", "ToolRegistryView"),
+  "analytics-dashboard.dashboard": createComponentPresentation("analytics-dashboard.dashboard", "Analytics Dashboard", "Dashboard view for the analytics example.", "Review saved widgets and query-backed dashboards.", "Sandbox presentation used for markdown previews.", "AnalyticsDashboard"),
+  "analytics-dashboard.list": createComponentPresentation("analytics-dashboard.list", "Dashboard List", "List view for analytics dashboards.", "Browse dashboards available in the analytics example.", "Sandbox presentation used for markdown previews.", "DashboardList"),
+  "analytics-dashboard.query.builder": createComponentPresentation("analytics-dashboard.query.builder", "Query Builder", "Query authoring surface for the analytics example.", "Inspect reusable queries that power dashboards.", "Sandbox presentation used for markdown previews.", "QueryBuilder"),
+  "crm-pipeline.dashboard": createComponentPresentation("crm-pipeline.dashboard", "CRM Dashboard", "Dashboard for the CRM pipeline example.", "Track pipeline health and revenue progress.", "Sandbox presentation used for markdown previews.", "CrmDashboard"),
+  "crm-pipeline.deal.pipeline": createComponentPresentation("crm-pipeline.deal.pipeline", "Pipeline Kanban", "Pipeline board for the CRM pipeline example.", "Review deal flow across pipeline stages.", "Sandbox presentation used for markdown previews.", "PipelineKanbanView"),
+  "integration-hub.connection.list": createComponentPresentation("integration-hub.connection.list", "Connection List", "Connected systems in the integration hub example.", "Review connected systems and connection health.", "Sandbox presentation used for markdown previews.", "ConnectionList"),
+  "integration-hub.dashboard": createComponentPresentation("integration-hub.dashboard", "Integration Dashboard", "Operational dashboard for the integration hub example.", "Monitor integration mix, connection health, and sync issues.", "Sandbox presentation used for markdown previews.", "IntegrationDashboard"),
+  "integration-hub.sync.config": createComponentPresentation("integration-hub.sync.config", "Sync Configuration", "Sync configuration surface for the integration hub example.", "Inspect sync configuration and field mapping defaults.", "Sandbox presentation used for markdown previews.", "SyncConfigEditor"),
+  "marketplace.dashboard": createComponentPresentation("marketplace.dashboard", "Marketplace Dashboard", "Dashboard for the marketplace example.", "Review order flow, category mix, and revenue summaries.", "Sandbox presentation used for markdown previews.", "MarketplaceDashboard"),
+  "marketplace.order.list": createComponentPresentation("marketplace.order.list", "Order List", "Order list for the marketplace example.", "Inspect order activity and fulfillment state.", "Sandbox presentation used for markdown previews.", "OrderList"),
+  "marketplace.product.catalog": createComponentPresentation("marketplace.product.catalog", "Product Catalog", "Product catalog for the marketplace example.", "Browse the available products and merchandising data.", "Sandbox presentation used for markdown previews.", "ProductCatalog"),
+  "saas-boilerplate.billing.settings": createComponentPresentation("saas-boilerplate.billing.settings", "Billing Settings", "Subscription and usage settings for the SaaS example.", "Review billing configuration and current subscription data.", "Sandbox presentation used for markdown previews.", "SubscriptionView"),
+  "saas-boilerplate.dashboard": createComponentPresentation("saas-boilerplate.dashboard", "SaaS Dashboard", "Dashboard for the SaaS boilerplate example.", "Review account, project, and billing summaries.", "Sandbox presentation used for markdown previews.", "SaasDashboard"),
+  "saas-boilerplate.project.list": createComponentPresentation("saas-boilerplate.project.list", "Project List", "Project list for the SaaS boilerplate example.", "Browse projects and their current lifecycle state.", "Sandbox presentation used for markdown previews.", "ProjectListView"),
+  "visualization-showcase.gallery": createComponentPresentation("visualization-showcase.gallery", "Visualization Showcase", "Focused showcase of ContractSpec visualization primitives.", "Review the canonical visualization catalog and design-system wrappers.", "Sandbox presentation used for markdown previews.", "VisualizationShowcase"),
+  "workflow-system.dashboard": createComponentPresentation("workflow-system.dashboard", "Workflow Dashboard", "Dashboard for the workflow system example.", "Review workflow instance health and workload metrics.", "Sandbox presentation used for markdown previews.", "WorkflowDashboard"),
+  "workflow-system.definition.list": createComponentPresentation("workflow-system.definition.list", "Workflow Definition List", "Workflow definitions in the workflow system example.", "Browse available workflow definitions.", "Sandbox presentation used for markdown previews.", "WorkflowDefinitionList"),
+  "workflow-system.instance.detail": createComponentPresentation("workflow-system.instance.detail", "Workflow Instance Detail", "Workflow instance details in the workflow system example.", "Inspect the state and approvals for a workflow instance.", "Sandbox presentation used for markdown previews.", "WorkflowInstanceDetail")
+};
+function resolveTemplatePresentation(presentationName) {
+  return TEMPLATE_PRESENTATIONS[presentationName];
+}
+
 // src/runtime/context.tsx
-import { useEffect, useMemo, useState } from "react";
-import { ApolloProvider } from "@apollo/client/react";
-import { web as web2 } from "@contractspec/lib.runtime-sandbox";
-import {
-  createCrmHandlers
-} from "@contractspec/example.crm-pipeline";
-import {
-  createSaasHandlers
-} from "@contractspec/example.saas-boilerplate";
-import {
-  createAgentHandlers
-} from "@contractspec/example.agent-console";
-import {
-  createWorkflowHandlers
-} from "@contractspec/example.workflow-system";
-import {
-  createMarketplaceHandlers
-} from "@contractspec/example.marketplace";
-import {
-  createIntegrationHandlers
-} from "@contractspec/example.integration-hub";
-import {
-  createAnalyticsHandlers
-} from "@contractspec/example.analytics-dashboard";
-import {
-  createPolicySafeKnowledgeAssistantHandlers
-} from "@contractspec/example.policy-safe-knowledge-assistant";
-import {
-  TemplateRuntimeContext,
-  useTemplateRuntime,
-  useTemplateComponents
-} from "@contractspec/lib.example-shared-ui";
 import { jsxDEV } from "react/jsx-dev-runtime";
 "use client";
 var { LocalRuntimeServices: LocalRuntimeServices2 } = web2;
@@ -622,7 +728,7 @@ class TemplateHandlers {
 }
 function TemplateRuntimeProvider({
   templateId,
-  projectId = "default-project",
+  projectId = "local-project",
   lazy = false,
   children
 }) {
@@ -647,7 +753,7 @@ function TemplateRuntimeProvider({
         const handlers = new TemplateHandlers;
         handlers.crm = createCrmHandlers(runtime.db);
         handlers.saas = createSaasHandlers(runtime.db);
-        handlers.agent = createAgentHandlers(runtime.db);
+        handlers.agent = createAgentConsoleDemoHandlers({ projectId });
         handlers.workflow = createWorkflowHandlers(runtime.db);
         handlers.marketplace = createMarketplaceHandlers(runtime.db);
         handlers.integration = createIntegrationHandlers(runtime.db);
@@ -744,37 +850,19 @@ function TemplateRuntimeProvider({
             };
           }
           if (presentationName === "agent-console.dashboard") {
-            const [agentsResult, runsResult, toolsResult] = await Promise.all([
-              handlers.agent.listAgents({
-                projectId,
-                organizationId: "demo-org",
-                limit: 10
-              }),
-              handlers.agent.listRuns({ projectId, limit: 10 }),
-              handlers.agent.listTools({
-                projectId,
-                organizationId: "demo-org",
-                limit: 10
-              })
-            ]);
+            const data = await getAgentConsoleDashboardData(handlers.agent, {
+              projectId,
+              organizationId: AGENT_CONSOLE_DEMO_ORGANIZATION_ID
+            });
             return {
-              data: {
-                agents: agentsResult.items,
-                runs: runsResult.items,
-                tools: toolsResult.items,
-                summary: {
-                  totalAgents: agentsResult.total,
-                  totalRuns: runsResult.total,
-                  totalTools: toolsResult.total
-                }
-              },
+              data,
               metadata: { timestamp: new Date, source: "agent-console" }
             };
           }
-          if (presentationName === "agent-console.agent.list") {
+          if (presentationName === "agent-console.agent.viewList" || presentationName === "agent-console.agent.list") {
             const result = await handlers.agent.listAgents({
               projectId,
-              organizationId: "demo-org",
+              organizationId: AGENT_CONSOLE_DEMO_ORGANIZATION_ID,
               limit: 50
             });
             return {
@@ -800,10 +888,10 @@ function TemplateRuntimeProvider({
               }
             };
           }
-          if (presentationName === "agent-console.tool.registry") {
+          if (presentationName === "agent-console.tool.list" || presentationName === "agent-console.tool.registry") {
             const result = await handlers.agent.listTools({
               projectId,
-              organizationId: "demo-org",
+              organizationId: AGENT_CONSOLE_DEMO_ORGANIZATION_ID,
               limit: 50
             });
             return {
@@ -815,6 +903,15 @@ function TemplateRuntimeProvider({
               }
             };
           }
+          if (presentationName === "visualization-showcase.gallery") {
+            return {
+              data: null,
+              metadata: {
+                timestamp: new Date,
+                source: "visualization-showcase"
+              }
+            };
+          }
           console.warn(`No data fetcher found for presentation: ${presentationName}`);
           return {
             data: null,
@@ -831,7 +928,8 @@ function TemplateRuntimeProvider({
             projectId,
             engine,
             handlers,
-            fetchData
+            fetchData,
+            resolvePresentation: resolveTemplatePresentation
           });
         }
       } catch (err) {