@contractspec/bundle.library 3.8.2 → 3.8.5

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

@@ -18,7 +18,7 @@
 	{
 		"id": "platform.integrations/ai-llm.mistral",
 		"title": "ai-llm.mistral",
-		"summary": "Mistral integration providing chat completions and embedding generation.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: ai, llm, embeddings\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/mistral.ts`",
+		"summary": "Mistral integration providing chat completions and embedding generation.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: ai, llm, embeddings\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/mistral.ts`",
 		"route": "/docs/reference/platform.integrations/ai-llm.mistral",
 		"source": "generated",
 		"contentPath": "platform.integrations/ai-llm.mistral.md"
@@ -58,7 +58,7 @@
 	{
 		"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, stt\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-integrations/src/integrations/providers/elevenlabs.ts`",
 		"route": "/docs/reference/platform.integrations/ai-voice.elevenlabs",
 		"source": "generated",
 		"contentPath": "platform.integrations/ai-voice.elevenlabs.md"
@@ -66,7 +66,7 @@
 	{
 		"id": "platform.integrations/ai-voice.fal",
 		"title": "ai-voice.fal",
-		"summary": "Fal integration for voice synthesis using Chatterbox text-to-speech models.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, tts, chatterbox\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/fal.ts`",
+		"summary": "Fal integration for voice synthesis using Chatterbox text-to-speech models.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, tts, chatterbox\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/fal.ts`",
 		"route": "/docs/reference/platform.integrations/ai-voice.fal",
 		"source": "generated",
 		"contentPath": "platform.integrations/ai-voice.fal.md"
@@ -74,7 +74,7 @@
 	{
 		"id": "platform.integrations/ai-voice.gradium",
 		"title": "ai-voice.gradium",
-		"summary": "Gradium integration for low-latency voice synthesis and voice catalog access.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, tts, realtime\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/gradium.ts`",
+		"summary": "Gradium integration for low-latency voice synthesis and voice catalog access.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: voice, tts, realtime\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/gradium.ts`",
 		"route": "/docs/reference/platform.integrations/ai-voice.gradium",
 		"source": "generated",
 		"contentPath": "platform.integrations/ai-voice.gradium.md"
@@ -106,7 +106,7 @@
 	{
 		"id": "platform.integrations/email.gmail",
 		"title": "email.gmail",
-		"summary": "Gmail integration supporting inbound thread ingestion and outbound transactional email.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: email, gmail\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/gmail.ts`",
+		"summary": "Gmail integration supporting inbound thread ingestion and outbound transactional email.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: email, gmail\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/gmail.ts`",
 		"route": "/docs/reference/platform.integrations/email.gmail",
 		"source": "generated",
 		"contentPath": "platform.integrations/email.gmail.md"
@@ -114,7 +114,7 @@
 	{
 		"id": "platform.integrations/email.postmark",
 		"title": "email.postmark",
-		"summary": "Postmark integration for transactional email delivery.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: email, transactional\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/postmark.ts`",
+		"summary": "Postmark integration for transactional email delivery.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: email, transactional\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/postmark.ts`",
 		"route": "/docs/reference/platform.integrations/email.postmark",
 		"source": "generated",
 		"contentPath": "platform.integrations/email.postmark.md"
@@ -130,7 +130,7 @@
 	{
 		"id": "platform.integrations/integrations",
 		"title": "integrations",
-		"summary": "Core integrations capability for third-party connections\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: @platform.core\n- **Tags**: integrations, platform\n- **File**: `packages/libs/contracts-spec/src/integrations/integrations.capability.ts`",
+		"summary": "Core integrations capability for third-party connections\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: @platform.core\n- **Tags**: integrations, platform\n- **File**: `packages/libs/contracts-integrations/src/integrations/integrations.capability.ts`",
 		"route": "/docs/reference/platform.integrations/integrations",
 		"source": "generated",
 		"contentPath": "platform.integrations/integrations.md"
@@ -146,7 +146,7 @@
 	{
 		"id": "platform.integrations/integrations.connection.delete",
 		"title": "integrations.connection.delete",
-		"summary": "Delete an integration connection for a tenant.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: integration, connections\n- **File**: `packages/libs/contracts-spec/src/integrations/operations.ts`",
+		"summary": "Delete an integration connection for a tenant.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: integration, connections\n- **File**: `packages/libs/contracts-integrations/src/integrations/operations.ts`",
 		"route": "/docs/reference/platform.integrations/integrations.connection.delete",
 		"source": "generated",
 		"contentPath": "platform.integrations/integrations.connection.delete.md"
@@ -154,7 +154,7 @@
 	{
 		"id": "platform.integrations/integrations.connection.list",
 		"title": "integrations.connection.list",
-		"summary": "List integration connections for a tenant.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: integration, connections\n- **File**: `packages/libs/contracts-spec/src/integrations/operations.ts`",
+		"summary": "List integration connections for a tenant.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: integration, connections\n- **File**: `packages/libs/contracts-integrations/src/integrations/operations.ts`",
 		"route": "/docs/reference/platform.integrations/integrations.connection.list",
 		"source": "generated",
 		"contentPath": "platform.integrations/integrations.connection.list.md"
@@ -223,6 +223,14 @@
 		"source": "generated",
 		"contentPath": "platform.integrations/messaging.slack.md"
 	},
+	{
+		"id": "platform.integrations/messaging.telegram",
+		"title": "messaging.telegram",
+		"summary": "Telegram messaging integration for inbound webhook updates, threaded topic messages, and outbound bot replies.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: messaging, telegram",
+		"route": "/docs/reference/platform.integrations/messaging.telegram",
+		"source": "generated",
+		"contentPath": "platform.integrations/messaging.telegram.md"
+	},
 	{
 		"id": "platform.integrations/messaging.whatsapp.meta",
 		"title": "messaging.whatsapp.meta",
@@ -250,7 +258,7 @@
 	{
 		"id": "platform.integrations/payments.stripe",
 		"title": "payments.stripe",
-		"summary": "Stripe integration for payment processing, charges, and payouts.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.payments\n- **Tags**: payments, psp\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/stripe.ts`",
+		"summary": "Stripe integration for payment processing, charges, and payouts.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.payments\n- **Tags**: payments, psp\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/stripe.ts`",
 		"route": "/docs/reference/platform.integrations/payments.stripe",
 		"source": "generated",
 		"contentPath": "platform.integrations/payments.stripe.md"
@@ -266,7 +274,7 @@
 	{
 		"id": "platform.integrations/project-management.jira",
 		"title": "project-management.jira",
-		"summary": "Jira Cloud integration for creating and tracking work items.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: @platform.integrations\n- **Tags**: project-management, jira\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/jira.ts`",
+		"summary": "Jira Cloud integration for creating and tracking work items.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: @platform.integrations\n- **Tags**: project-management, jira\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/jira.ts`",
 		"route": "/docs/reference/platform.integrations/project-management.jira",
 		"source": "generated",
 		"contentPath": "platform.integrations/project-management.jira.md"
@@ -290,7 +298,7 @@
 	{
 		"id": "platform.integrations/sms.twilio",
 		"title": "sms.twilio",
-		"summary": "Twilio SMS integration for transactional and notification messaging.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: sms, messaging\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/twilio-sms.ts`",
+		"summary": "Twilio SMS integration for transactional and notification messaging.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.messaging\n- **Tags**: sms, messaging\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/twilio-sms.ts`",
 		"route": "/docs/reference/platform.integrations/sms.twilio",
 		"source": "generated",
 		"contentPath": "platform.integrations/sms.twilio.md"
@@ -298,7 +306,7 @@
 	{
 		"id": "platform.integrations/storage.gcs",
 		"title": "storage.gcs",
-		"summary": "Google Cloud Storage integration for object storage and retrieval.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.infrastructure\n- **Tags**: storage, gcs, google-cloud\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/gcs-storage.ts`",
+		"summary": "Google Cloud Storage integration for object storage and retrieval.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.infrastructure\n- **Tags**: storage, gcs, google-cloud\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/gcs-storage.ts`",
 		"route": "/docs/reference/platform.integrations/storage.gcs",
 		"source": "generated",
 		"contentPath": "platform.integrations/storage.gcs.md"
@@ -306,7 +314,7 @@
 	{
 		"id": "platform.integrations/vectordb.qdrant",
 		"title": "vectordb.qdrant",
-		"summary": "Qdrant integration for vector search and embeddings storage.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: vector-db, search\n- **File**: `packages/libs/contracts-spec/src/integrations/providers/qdrant.ts`",
+		"summary": "Qdrant integration for vector search and embeddings storage.\n- **Type**: integration (integration)\n- **Version**: 1.0.0\n- **Owners**: platform.ai\n- **Tags**: vector-db, search\n- **File**: `packages/libs/contracts-integrations/src/integrations/providers/qdrant.ts`",
 		"route": "/docs/reference/platform.integrations/vectordb.qdrant",
 		"source": "generated",
 		"contentPath": "platform.integrations/vectordb.qdrant.md"

package/src/components/docs/generated/docs-index.visualization-showcase.json

@@ -0,0 +1,18 @@
+[
+	{
+		"id": "visualization-showcase/visualization-showcase",
+		"title": "visualization-showcase",
+		"summary": "ContractSpec visualization primitives rendered through shared design-system wrappers.\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.core\n- **Tags**: visualization, charts, showcase",
+		"route": "/docs/reference/visualization-showcase/visualization-showcase",
+		"source": "generated",
+		"contentPath": "visualization-showcase/visualization-showcase.md"
+	},
+	{
+		"id": "visualization-showcase/visualization-showcase.gallery",
+		"title": "visualization-showcase.gallery",
+		"summary": "Focused showcase of ContractSpec visualization primitives.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Owners**: @platform.core\n- **Tags**: visualization, charts, showcase\n- **File**: `packages/examples/visualization-showcase/src/visualization-showcase.presentation.ts`",
+		"route": "/docs/reference/visualization-showcase/visualization-showcase.gallery",
+		"source": "generated",
+		"contentPath": "visualization-showcase/visualization-showcase.gallery.md"
+	}
+]

package/src/components/docs/libraries/LibrariesAiAgentPage.tsx

@@ -23,10 +23,17 @@ export function LibrariesAiAgentPage() {
 				<h2 className="font-bold text-2xl">Define & register</h2>
 				<CodeBlock
 					language="typescript"
-					code={`import { defineAgent, AgentRegistry } from '@contractspec/lib.ai-agent';
+					code={`import { defineAgent, AgentRegistry } from '@contractspec/lib.contracts-spec/agent';
 
 const SupportBot = defineAgent({
-  meta: { name: 'support.bot', version: '1.0.0' },
+  meta: {
+    key: 'support.bot',
+    version: '1.0.0',
+    description: 'Resolve tickets and escalate low-confidence decisions.',
+    owners: ['support'],
+    tags: ['support'],
+    stability: 'experimental',
+  },
   instructions: 'Resolve tickets. Escalate when confidence < 0.75.',
   tools: [{ name: 'support_resolve_ticket' }],
   policy: {
@@ -43,19 +50,17 @@ const registry = new AgentRegistry().register(SupportBot);`}
 				<h2 className="font-bold text-2xl">Run with approvals</h2>
 				<CodeBlock
 					language="typescript"
-					code={`import { AgentRunner, ToolExecutor, ApprovalWorkflow } from '@contractspec/lib.ai-agent';
+					code={`import { createUnifiedAgent, ApprovalWorkflow } from '@contractspec/lib.ai-agent';
 
-const runner = new AgentRunner({
-  registry,
-  llm: mistralProvider,
-  toolExecutor: new ToolExecutor({ tools: supportTools }),
-  approvalWorkflow: new ApprovalWorkflow(),
+const approvals = new ApprovalWorkflow();
+const agent = createUnifiedAgent(SupportBot, {
+  backend: 'ai-sdk',
+  tools: new Map([['support_resolve_ticket', async (input) => resolveTicket(input)]]),
 });
 
-const result = await runner.run({ agent: 'support.bot', input: ticket.body });
-if (result.approvalRequestId) {
-  // show in ApprovalQueue UI
-}`}
+const result = await agent.run(ticket.body);
+// Route low-confidence or manual-review flows through approvals when needed.
+`}
 				/>
 			</div>
 
@@ -63,12 +68,10 @@ if (result.approvalRequestId) {
 				<h2 className="font-bold text-2xl">What's inside</h2>
 				<ul className="list-inside list-disc space-y-2 text-muted-foreground">
 					<li>
-						<code>defineAgent</code>, <code>AgentRegistry</code>,{' '}
-						<code>AgentRunner</code>
-					</li>
-					<li>
-						<code>ToolExecutor</code> with schema-enforced tool definitions
+						<code>createUnifiedAgent</code>, <code>ContractSpecAgent</code>,{' '}
+						<code>UnifiedAgent</code>
 					</li>
+					<li>MCP, operation-backed, memory, and subagent tool adapters</li>
 					<li>
 						<code>InMemoryAgentMemory</code> plus interfaces for custom stores
 					</li>

package/src/components/docs/libraries/LibrariesSupportBotPage.tsx

@@ -40,10 +40,9 @@ const draft = await responder.draft(ticket, resolution, classification);`}
 				<CodeBlock
 					language="typescript"
 					code={`import { createSupportTools } from '@contractspec/lib.support-bot/bot';
-import { ToolExecutor } from '@contractspec/lib.ai-agent';
 
 const tools = createSupportTools({ resolver, classifier, responder });
-const executor = new ToolExecutor({ tools });`}
+// Pass these tools into your host runtime or agent adapter.`}
 				/>
 			</div>
 

package/src/components/templates/engine/index.ts

@@ -10,13 +10,13 @@
  * which handles the build order correctly.
  */
 
-import type { PresentationSpec } from '@contractspec/lib.contracts-spec/presentations';
 import {
 	createDefaultTransformEngine,
 	registerBasicValidation,
 	registerDefaultReactRenderer,
 	TransformEngine,
-} from '@contractspec/lib.contracts-spec/presentations/transform-engine';
+} from '@contractspec/lib.contracts-runtime-client-react/transform-engine';
+import type { PresentationSpec } from '@contractspec/lib.contracts-spec/presentations';
 
 /**
  * Create a configured TransformEngine for template rendering