@contractspec/bundle.library 2.9.1 → 3.0.0

package/dist/node/components/docs/integrations/IntegrationsElevenLabsPage.js

@@ -99,9 +99,9 @@ outputs:
         className: "flex items-center gap-4 pt-4",
         children: [
           /* @__PURE__ */ jsxDEV(Link, {
-            href: "/docs/integrations/openai",
+            href: "/docs/integrations/mistral",
             className: "btn-ghost",
-            children: "Previous: OpenAI"
+            children: "Previous: Mistral"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV(Link, {
             href: "/docs/integrations/qdrant",

package/dist/node/components/docs/integrations/IntegrationsGithubPage.js

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

package/dist/node/components/docs/integrations/IntegrationsHealthRoutingPage.js

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

package/dist/node/components/docs/integrations/IntegrationsMistralPage.js

@@ -0,0 +1,202 @@
+// src/components/docs/integrations/IntegrationsMistralPage.tsx
+import Link from "@contractspec/lib.ui-link";
+import { ChevronRight } from "lucide-react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+function IntegrationsMistralPage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "Mistral"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground",
+            children: "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."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Setup"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+            children: /* @__PURE__ */ jsxDEV("pre", {
+              children: `# .env
+MISTRAL_API_KEY=...`
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Chat and reasoning"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+            children: /* @__PURE__ */ jsxDEV("pre", {
+              children: `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`
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Embeddings"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+            children: /* @__PURE__ */ jsxDEV("pre", {
+              children: `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`
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Speech-to-Text (Voxtral)"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+            children: /* @__PURE__ */ jsxDEV("pre", {
+              children: `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`
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Conversational voice sessions"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground",
+            children: "Use the conversational provider for session-based realtime voice flows (turn handling, events, and interruption-safe streaming)."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Best practices"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("ul", {
+            className: "text-muted-foreground list-inside list-disc space-y-2",
+            children: [
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Choose model families by workload: coding, reasoning, or speech"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Persist session IDs for conversational continuity across turns"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Capture token and latency telemetry for provider-level tuning"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Set explicit fallbacks for network and rate-limit failures"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/integrations/openai",
+            className: "btn-ghost",
+            children: "Previous: OpenAI"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/integrations/elevenlabs",
+            className: "btn-primary",
+            children: [
+              "Next: ElevenLabs ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  IntegrationsMistralPage
+};

package/dist/node/components/docs/integrations/IntegrationsOpenAIPage.js

@@ -176,10 +176,10 @@ outputs:
             children: "Previous: Google Calendar"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV(Link, {
-            href: "/docs/integrations/elevenlabs",
+            href: "/docs/integrations/mistral",
             className: "btn-primary",
             children: [
-              "Next: ElevenLabs ",
+              "Next: Mistral ",
               /* @__PURE__ */ jsxDEV(ChevronRight, {
                 size: 16
               }, undefined, false, undefined, this)