@contractspec/bundle.library 2.9.1 → 3.0.0

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

@@ -1,13 +1,13 @@
 {
-  "generatedAt": "2026-02-15T02:25:57.758Z",
-  "total": 753,
+  "generatedAt": "2026-02-27T08:24:14.176Z",
+  "total": 808,
   "version": null,
   "contentRoot": "../../../../../../../generated/docs",
   "chunks": [
     {
       "key": "_common",
       "file": "docs-index._common.json",
-      "total": 59
+      "total": 89
     },
     {
       "key": "agent-console",
@@ -49,6 +49,11 @@
       "file": "docs-index.files.json",
       "total": 22
     },
+    {
+      "key": "health",
+      "file": "docs-index.health.json",
+      "total": 12
+    },
     {
       "key": "identity-rbac",
       "file": "docs-index.identity-rbac.json",
@@ -127,7 +132,7 @@
     {
       "key": "platform.integrations",
       "file": "docs-index.platform-integrations.json",
-      "total": 29
+      "total": 39
     },
     {
       "key": "platform.knowledge",
@@ -169,6 +174,11 @@
       "file": "docs-index.versioned-knowledge-base.json",
       "total": 10
     },
+    {
+      "key": "video-api-showcase",
+      "file": "docs-index.video-api-showcase.json",
+      "total": 3
+    },
     {
       "key": "wealth-snapshot",
       "file": "docs-index.wealth-snapshot.json",

package/src/components/docs/generated/docs-index.platform-integrations.json

@@ -1,4 +1,20 @@
 [
+  {
+    "id": "platform.integrations/ai-image.fal",
+    "title": "ai-image.fal",
+    "summary": "Fal integration for AI image generation using Flux and Stable Diffusion models.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: image, generation, flux, stable-diffusion",
+    "route": "/docs/reference/platform.integrations/ai-image.fal",
+    "source": "generated",
+    "contentPath": "platform.integrations/ai-image.fal.md"
+  },
+  {
+    "id": "platform.integrations/ai-image.openai",
+    "title": "ai-image.openai",
+    "summary": "OpenAI integration for AI image generation using DALL-E and gpt-image models.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: image, generation, dall-e, gpt-image",
+    "route": "/docs/reference/platform.integrations/ai-image.openai",
+    "source": "generated",
+    "contentPath": "platform.integrations/ai-image.openai.md"
+  },
   {
     "id": "platform.integrations/ai-llm.mistral",
     "title": "ai-llm.mistral",
@@ -7,10 +23,42 @@
     "source": "generated",
     "contentPath": "platform.integrations/ai-llm.mistral.md"
   },
+  {
+    "id": "platform.integrations/ai-voice-conv.mistral",
+    "title": "ai-voice-conv.mistral",
+    "summary": "Mistral conversational voice integration using conversation sessions and speech models for bidirectional interactions.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, conversational, mistral, agents, sessions",
+    "route": "/docs/reference/platform.integrations/ai-voice-conv.mistral",
+    "source": "generated",
+    "contentPath": "platform.integrations/ai-voice-conv.mistral.md"
+  },
+  {
+    "id": "platform.integrations/ai-voice-conv.openai",
+    "title": "ai-voice-conv.openai",
+    "summary": "OpenAI Realtime API integration for bidirectional conversational voice with GPT models.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, conversational, realtime, openai",
+    "route": "/docs/reference/platform.integrations/ai-voice-conv.openai",
+    "source": "generated",
+    "contentPath": "platform.integrations/ai-voice-conv.openai.md"
+  },
+  {
+    "id": "platform.integrations/ai-voice-stt.deepgram",
+    "title": "ai-voice-stt.deepgram",
+    "summary": "Deepgram integration for real-time and batch speech-to-text transcription with speaker diarization.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, stt, transcription, diarization",
+    "route": "/docs/reference/platform.integrations/ai-voice-stt.deepgram",
+    "source": "generated",
+    "contentPath": "platform.integrations/ai-voice-stt.deepgram.md"
+  },
+  {
+    "id": "platform.integrations/ai-voice-stt.mistral",
+    "title": "ai-voice-stt.mistral",
+    "summary": "Mistral audio transcription integration for batch and streaming speech-to-text use cases.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, stt, transcription, mistral, voxtral",
+    "route": "/docs/reference/platform.integrations/ai-voice-stt.mistral",
+    "source": "generated",
+    "contentPath": "platform.integrations/ai-voice-stt.mistral.md"
+  },
   {
     "id": "platform.integrations/ai-voice.elevenlabs",
     "title": "ai-voice.elevenlabs",
-    "summary": "ElevenLabs integration for neural voice synthesis and voice catalog access.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, tts\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/elevenlabs.ts`",
+    "summary": "ElevenLabs integration for neural voice synthesis and voice catalog access.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, tts, stt\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/elevenlabs.ts`",
     "route": "/docs/reference/platform.integrations/ai-voice.elevenlabs",
     "source": "generated",
     "contentPath": "platform.integrations/ai-voice.elevenlabs.md"
@@ -151,6 +199,38 @@
     "source": "generated",
     "contentPath": "platform.integrations/meeting-recorder.tldv.md"
   },
+  {
+    "id": "platform.integrations/messaging.github",
+    "title": "messaging.github",
+    "summary": "GitHub integration for issue and pull request comment workflows backed by webhook events.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: messaging, github, pull-requests",
+    "route": "/docs/reference/platform.integrations/messaging.github",
+    "source": "generated",
+    "contentPath": "platform.integrations/messaging.github.md"
+  },
+  {
+    "id": "platform.integrations/messaging.slack",
+    "title": "messaging.slack",
+    "summary": "Slack integration for inbound events, threaded responses, and interactive messaging workflows.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: messaging, slack",
+    "route": "/docs/reference/platform.integrations/messaging.slack",
+    "source": "generated",
+    "contentPath": "platform.integrations/messaging.slack.md"
+  },
+  {
+    "id": "platform.integrations/messaging.whatsapp.meta",
+    "title": "messaging.whatsapp.meta",
+    "summary": "Meta WhatsApp Cloud API integration for inbound message processing and outbound replies.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: messaging, whatsapp, meta",
+    "route": "/docs/reference/platform.integrations/messaging.whatsapp.meta",
+    "source": "generated",
+    "contentPath": "platform.integrations/messaging.whatsapp.meta.md"
+  },
+  {
+    "id": "platform.integrations/messaging.whatsapp.twilio",
+    "title": "messaging.whatsapp.twilio",
+    "summary": "Twilio-powered WhatsApp integration for inbound webhooks and outbound conversational messaging.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: messaging, whatsapp, twilio",
+    "route": "/docs/reference/platform.integrations/messaging.whatsapp.twilio",
+    "source": "generated",
+    "contentPath": "platform.integrations/messaging.whatsapp.twilio.md"
+  },
   {
     "id": "platform.integrations/openbanking.powens",
     "title": "openbanking.powens",

package/src/components/docs/generated/docs-index.video-api-showcase.json

@@ -0,0 +1,26 @@
+[
+  {
+    "id": "video-api-showcase/createUser",
+    "title": "createUser",
+    "summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/examples/video-api-showcase/src/sample-specs.ts`\n```typescript\nexport const createUser = defineCommand({\nmeta: {\nname: \"CreateUser\",",
+    "route": "/docs/reference/video-api-showcase/createUser",
+    "source": "generated",
+    "contentPath": "video-api-showcase/createUser.md"
+  },
+  {
+    "id": "video-api-showcase/listTransactions",
+    "title": "listTransactions",
+    "summary": "- **Type**: operation (query)\n- **Version**: 1.0.0\n- **File**: `packages/examples/video-api-showcase/src/sample-specs.ts`\n```typescript\nexport const listTransactions = defineQuery({\nmeta: {\nname: \"ListTransactions\",",
+    "route": "/docs/reference/video-api-showcase/listTransactions",
+    "source": "generated",
+    "contentPath": "video-api-showcase/listTransactions.md"
+  },
+  {
+    "id": "video-api-showcase/sendNotification",
+    "title": "sendNotification",
+    "summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/examples/video-api-showcase/src/sample-specs.ts`\n```typescript\nexport const sendNotification = defineCommand({\nmeta: {\nname: \"SendNotification\",",
+    "route": "/docs/reference/video-api-showcase/sendNotification",
+    "source": "generated",
+    "contentPath": "video-api-showcase/sendNotification.md"
+  }
+]

package/src/components/docs/integrations/IntegrationsElevenLabsPage.tsx

@@ -64,8 +64,8 @@ outputs:
       </div>
 
       <div className="flex items-center gap-4 pt-4">
-        <Link href="/docs/integrations/openai" className="btn-ghost">
-          Previous: OpenAI
+        <Link href="/docs/integrations/mistral" className="btn-ghost">
+          Previous: Mistral
         </Link>
         <Link href="/docs/integrations/qdrant" className="btn-primary">
           Next: Qdrant <ChevronRight size={16} />

package/src/components/docs/integrations/IntegrationsGithubPage.tsx

@@ -0,0 +1,90 @@
+import Link from '@contractspec/lib.ui-link';
+import { ChevronRight } from 'lucide-react';
+
+export function IntegrationsGithubPage() {
+  return (
+    <div className="space-y-8">
+      <div className="space-y-4">
+        <h1 className="text-4xl font-bold">GitHub Messaging</h1>
+        <p className="text-muted-foreground">
+          Use GitHub issue and pull request comments as an AI-native messaging
+          channel with webhook verification, policy checks, and reliable
+          outbound dispatch.
+        </p>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Required secrets and config</h2>
+        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
+          <pre>{`// secret payload
+{
+  "token": "ghp_...",
+  "webhookSecret": "..."
+}
+
+// optional connection config
+{
+  "defaultOwner": "lssm-tech",
+  "defaultRepo": "contractspec",
+  "apiBaseUrl": "https://api.github.com"
+}`}</pre>
+        </div>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Webhook ingress</h2>
+        <ul className="text-muted-foreground list-inside list-disc space-y-2">
+          <li>
+            Inbound GitHub events are accepted on{' '}
+            <code className="bg-background/50 rounded px-2 py-1">
+              /webhooks/github/events
+            </code>
+            .
+          </li>
+          <li>
+            Signatures are checked using{' '}
+            <code className="bg-background/50 rounded px-2 py-1">
+              x-hub-signature-256
+            </code>{' '}
+            and the configured webhook secret.
+          </li>
+          <li>
+            Current normalization focuses on issue comment workflows and durable
+            comment dispatch.
+          </li>
+        </ul>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Workspace mapping</h2>
+        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
+          <pre>{`CHANNEL_WORKSPACE_MAP_GITHUB={"lssm-tech/contractspec":"workspace-acme"}
+
+# Optional dev fallback (off by default)
+CHANNEL_ALLOW_UNMAPPED_WORKSPACE=0`}</pre>
+        </div>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Best practices</h2>
+        <ul className="text-muted-foreground list-inside list-disc space-y-2">
+          <li>Use a least-privileged token scoped for comment operations.</li>
+          <li>
+            Route repositories explicitly with workspace maps in multi-tenant
+            environments.
+          </li>
+          <li>Keep dispatch endpoints protected with token or bearer auth.</li>
+        </ul>
+      </div>
+
+      <div className="flex items-center gap-4 pt-4">
+        <Link href="/docs/integrations/slack" className="btn-ghost">
+          Previous: Slack Messaging
+        </Link>
+        <Link href="/docs/integrations/whatsapp-meta" className="btn-primary">
+          Next: WhatsApp Meta <ChevronRight size={16} />
+        </Link>
+      </div>
+    </div>
+  );
+}

package/src/components/docs/integrations/IntegrationsHealthRoutingPage.tsx

@@ -0,0 +1,112 @@
+import Link from '@contractspec/lib.ui-link';
+
+export function IntegrationsHealthRoutingPage() {
+  return (
+    <div className="space-y-8">
+      <div className="space-y-4">
+        <h1 className="text-4xl font-bold">Health Routing Strategy</h1>
+        <p className="text-muted-foreground">
+          Health integrations resolve providers through deterministic transport
+          strategy order with explicit capability gating and unofficial-route
+          controls.
+        </p>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Connection config fields</h2>
+        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
+          <pre>{`{
+  "defaultTransport": "official-api",
+  "strategyOrder": [
+    "official-api",
+    "official-mcp",
+    "aggregator-api",
+    "aggregator-mcp",
+    "unofficial"
+  ],
+  "allowUnofficial": false,
+  "unofficialAllowList": ["health.peloton"],
+  "apiBaseUrl": "https://api.provider.example",
+  "mcpUrl": "https://mcp.provider.example",
+  "oauthTokenUrl": "https://api.provider.example/oauth/token"
+}`}</pre>
+        </div>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Secret payload fields</h2>
+        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
+          <pre>{`{
+  "apiKey": "...",
+  "accessToken": "...",
+  "refreshToken": "...",
+  "clientId": "...",
+  "clientSecret": "...",
+  "tokenExpiresAt": "2026-02-01T00:00:00.000Z",
+  "mcpAccessToken": "...",
+  "webhookSecret": "..."
+}`}</pre>
+        </div>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Routing behavior</h2>
+        <ul className="text-muted-foreground list-inside list-disc space-y-2">
+          <li>
+            Unsupported strategies are skipped per provider capability matrix.
+          </li>
+          <li>
+            Missing credentials fail closed and fall through only when a later
+            strategy is valid.
+          </li>
+          <li>
+            Unofficial routes are disabled unless
+            <code className="bg-background/50 ml-1 rounded px-2 py-1">
+              allowUnofficial
+            </code>
+            is true.
+          </li>
+          <li>
+            When
+            <code className="bg-background/50 ml-1 rounded px-2 py-1">
+              unofficialAllowList
+            </code>
+            is set, only listed provider keys can route unofficially.
+          </li>
+          <li>
+            OAuth refresh uses
+            <code className="bg-background/50 ml-1 rounded px-2 py-1">
+              oauthTokenUrl
+            </code>
+            with refresh/client credentials when APIs return 401.
+          </li>
+        </ul>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Provider guidance</h2>
+        <ul className="text-muted-foreground list-inside list-disc space-y-2">
+          <li>
+            Use official APIs when available (Whoop, Oura, Strava, Fitbit).
+          </li>
+          <li>
+            Use aggregator routing for providers without stable official APIs
+            (Garmin, MyFitnessPal, Eight Sleep, Peloton).
+          </li>
+          <li>
+            Keep unofficial automation opt-in and auditable for production.
+          </li>
+        </ul>
+      </div>
+
+      <div className="flex items-center gap-4 pt-4">
+        <Link href="/docs/integrations/whatsapp-twilio" className="btn-ghost">
+          Previous: WhatsApp Twilio
+        </Link>
+        <Link href="/docs/integrations" className="btn-primary">
+          Back to Integrations
+        </Link>
+      </div>
+    </div>
+  );
+}

package/src/components/docs/integrations/IntegrationsMistralPage.tsx

@@ -0,0 +1,133 @@
+import Link from '@contractspec/lib.ui-link';
+import { ChevronRight } from 'lucide-react';
+
+export function IntegrationsMistralPage() {
+  return (
+    <div className="space-y-8">
+      <div className="space-y-4">
+        <h1 className="text-4xl font-bold">Mistral</h1>
+        <p className="text-muted-foreground">
+          Integrate Mistral models for chat, reasoning, embeddings,
+          speech-to-text, and conversational voice workflows. ContractSpec ships
+          first-class Mistral support across contracts, provider runtime wiring,
+          and CLI provider selection.
+        </p>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Setup</h2>
+        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
+          <pre>{`# .env
+MISTRAL_API_KEY=...`}</pre>
+        </div>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Chat and reasoning</h2>
+        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
+          <pre>{`capabilityId: mistral-chat
+provider:
+  type: mistral
+  operation: chatCompletion
+
+inputs:
+  messages:
+    type: array
+  model:
+    type: string
+    default: "mistral-large-latest"
+  temperature:
+    type: number
+    optional: true
+
+outputs:
+  content:
+    type: string
+  usage:
+    type: object`}</pre>
+        </div>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Embeddings</h2>
+        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
+          <pre>{`capabilityId: mistral-embeddings
+provider:
+  type: mistral
+  operation: createEmbedding
+
+inputs:
+  text:
+    type: string
+  model:
+    type: string
+    default: "mistral-embed"
+
+outputs:
+  embedding:
+    type: array
+    items:
+      type: number`}</pre>
+        </div>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Speech-to-Text (Voxtral)</h2>
+        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
+          <pre>{`capabilityId: mistral-stt
+provider:
+  type: mistral
+  operation: transcribe
+
+inputs:
+  audio:
+    type: bytes
+  format:
+    type: string
+  language:
+    type: string
+    optional: true
+
+outputs:
+  text:
+    type: string
+  segments:
+    type: array
+  language:
+    type: string`}</pre>
+        </div>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Conversational voice sessions</h2>
+        <p className="text-muted-foreground">
+          Use the conversational provider for session-based realtime voice flows
+          (turn handling, events, and interruption-safe streaming).
+        </p>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Best practices</h2>
+        <ul className="text-muted-foreground list-inside list-disc space-y-2">
+          <li>
+            Choose model families by workload: coding, reasoning, or speech
+          </li>
+          <li>
+            Persist session IDs for conversational continuity across turns
+          </li>
+          <li>Capture token and latency telemetry for provider-level tuning</li>
+          <li>Set explicit fallbacks for network and rate-limit failures</li>
+        </ul>
+      </div>
+
+      <div className="flex items-center gap-4 pt-4">
+        <Link href="/docs/integrations/openai" className="btn-ghost">
+          Previous: OpenAI
+        </Link>
+        <Link href="/docs/integrations/elevenlabs" className="btn-primary">
+          Next: ElevenLabs <ChevronRight size={16} />
+        </Link>
+      </div>
+    </div>
+  );
+}

package/src/components/docs/integrations/IntegrationsOpenAIPage.tsx

@@ -121,8 +121,8 @@ outputs:
         <Link href="/docs/integrations/google-calendar" className="btn-ghost">
           Previous: Google Calendar
         </Link>
-        <Link href="/docs/integrations/elevenlabs" className="btn-primary">
-          Next: ElevenLabs <ChevronRight size={16} />
+        <Link href="/docs/integrations/mistral" className="btn-primary">
+          Next: Mistral <ChevronRight size={16} />
         </Link>
       </div>
     </div>