@contractspec/bundle.library 3.8.2 → 3.8.4

package/.turbo/turbo-build.log

@@ -3,7 +3,7 @@ $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
 [contractspec-bun-build] transpile target=bun root=src entries=300 noBundle=false
-Bundled 300 modules in 95ms
+Bundled 300 modules in 120ms
 
   application/context-storage/index.js                                                                     1.0 KB     (entry point)
   presentation/features/templates/types.js                                                                 8 bytes    (entry point)
@@ -169,7 +169,7 @@ Bundled 300 modules in 95ms
   components/docs/ops/DistributedTracingOpsPage.js                                                         2.39 KB    (entry point)
   components/docs/libraries/index.js                                                                       162.31 KB  (entry point)
   components/docs/libraries/LibrariesSchemaPage.js                                                         10.75 KB   (entry point)
-  components/docs/libraries/LibrariesSupportBotPage.js                                                     4.96 KB    (entry point)
+  components/docs/libraries/LibrariesSupportBotPage.js                                                     4.91 KB    (entry point)
   components/docs/libraries/LibrariesTestingPage.js                                                        4.98 KB    (entry point)
   components/docs/libraries/LibrariesUIKitPage.js                                                          8.28 KB    (entry point)
   components/docs/libraries/LibrariesWorkflowComposerPage.js                                               3.19 KB    (entry point)
@@ -195,7 +195,7 @@ Bundled 300 modules in 95ms
   components/docs/knowledge/KnowledgeSourcesPage.js                                                        16.77 KB   (entry point)
   components/docs/knowledge/KnowledgeSpacesPage.js                                                         13.52 KB   (entry point)
   components/docs/libraries/LibrariesAccessibilityPage.js                                                  7.45 KB    (entry point)
-  components/docs/libraries/LibrariesAiAgentPage.js                                                        5.43 KB    (entry point)
+  components/docs/libraries/LibrariesAiAgentPage.js                                                        5.48 KB    (entry point)
   components/docs/libraries/LibrariesAnalyticsPage.js                                                      3.22 KB    (entry point)
   components/docs/libraries/LibrariesContentGenPage.js                                                     4.1 KB     (entry point)
   components/docs/libraries/LibrariesContractsPage.js                                                      10.41 KB   (entry point)
@@ -307,7 +307,7 @@ Bundled 300 modules in 95ms
   application/mcp/contractsMcpTypes.js                                                                     8 bytes    (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=300 noBundle=false
-Bundled 300 modules in 115ms
+Bundled 300 modules in 127ms
 
   application/context-storage/index.js                                                                     0.99 KB    (entry point)
   presentation/features/templates/types.js                                                                 0 KB       (entry point)
@@ -473,7 +473,7 @@ Bundled 300 modules in 115ms
   components/docs/ops/DistributedTracingOpsPage.js                                                         2.38 KB    (entry point)
   components/docs/libraries/index.js                                                                       162.29 KB  (entry point)
   components/docs/libraries/LibrariesSchemaPage.js                                                         10.75 KB   (entry point)
-  components/docs/libraries/LibrariesSupportBotPage.js                                                     4.95 KB    (entry point)
+  components/docs/libraries/LibrariesSupportBotPage.js                                                     4.90 KB    (entry point)
   components/docs/libraries/LibrariesTestingPage.js                                                        4.97 KB    (entry point)
   components/docs/libraries/LibrariesUIKitPage.js                                                          8.27 KB    (entry point)
   components/docs/libraries/LibrariesWorkflowComposerPage.js                                               3.18 KB    (entry point)
@@ -499,7 +499,7 @@ Bundled 300 modules in 115ms
   components/docs/knowledge/KnowledgeSourcesPage.js                                                        16.76 KB   (entry point)
   components/docs/knowledge/KnowledgeSpacesPage.js                                                         13.51 KB   (entry point)
   components/docs/libraries/LibrariesAccessibilityPage.js                                                  7.44 KB    (entry point)
-  components/docs/libraries/LibrariesAiAgentPage.js                                                        5.42 KB    (entry point)
+  components/docs/libraries/LibrariesAiAgentPage.js                                                        5.47 KB    (entry point)
   components/docs/libraries/LibrariesAnalyticsPage.js                                                      3.21 KB    (entry point)
   components/docs/libraries/LibrariesContentGenPage.js                                                     4.1 KB     (entry point)
   components/docs/libraries/LibrariesContractsPage.js                                                      10.40 KB   (entry point)

package/CHANGELOG.md

@@ -1,5 +1,79 @@
 # @contractspec/bundle.library
 
+## 3.8.4
+
+### Patch Changes
+
+- 81256ea: Split agent definition contracts out of `@contractspec/lib.ai-agent` and make
+  `@contractspec/lib.contracts-spec` the source of truth for agent declaration APIs.
+
+  Major changes:
+
+  - Move `AgentSpec`, `AgentToolConfig`, `AgentPolicy`, `AgentRegistry`,
+    `createAgentRegistry`, `defineAgent`, and related definition-only types into
+    `@contractspec/lib.contracts-spec/agent`.
+  - Add `@contractspec/lib.contracts-spec/agent/spec` and
+    `@contractspec/lib.contracts-spec/agent/registry` export subpaths.
+  - Remove `@contractspec/lib.ai-agent/spec`,
+    `@contractspec/lib.ai-agent/spec/spec`, and
+    `@contractspec/lib.ai-agent/spec/registry`.
+  - Remove the spec layer from the `@contractspec/lib.ai-agent` root barrel so it
+    is runtime-focused.
+
+  Workspace consumers were migrated to import agent-definition contracts from
+  `@contractspec/lib.contracts-spec/agent`, and packages that only needed the
+  contract layer dropped their direct dependency on `@contractspec/lib.ai-agent`.
+
+- Updated dependencies [81256ea]
+- Updated dependencies [2619dd8]
+- Updated dependencies [6de2f1c]
+- Updated dependencies [81256ea]
+- Updated dependencies [a4489bb]
+- Updated dependencies [9cb304e]
+  - @contractspec/lib.contracts-spec@5.0.0
+  - @contractspec/lib.contracts-runtime-client-react@3.8.0
+  - @contractspec/lib.contracts-runtime-server-mcp@3.7.12
+  - @contractspec/lib.contracts-integrations@3.8.4
+  - @contractspec/lib.schema@3.7.10
+  - @contractspec/lib.content-gen@3.7.12
+  - @contractspec/lib.contracts-library@3.7.12
+  - @contractspec/lib.contracts-runtime-server-graphql@3.7.12
+  - @contractspec/lib.contracts-runtime-server-rest@3.7.12
+  - @contractspec/lib.design-system@3.8.5
+  - @contractspec/lib.example-shared-ui@6.0.12
+  - @contractspec/lib.knowledge@3.7.12
+  - @contractspec/lib.surface-runtime@0.5.12
+  - @contractspec/lib.ui-kit-web@3.9.4
+  - @contractspec/module.examples@3.8.4
+  - @contractspec/module.context-storage@0.7.12
+
+## 3.8.3
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-runtime-server-graphql@3.7.11
+  - @contractspec/lib.contracts-runtime-server-rest@3.7.11
+  - @contractspec/lib.contracts-runtime-server-mcp@3.7.11
+  - @contractspec/lib.contracts-integrations@3.8.3
+  - @contractspec/module.context-storage@0.7.11
+  - @contractspec/lib.contracts-library@3.7.11
+  - @contractspec/lib.example-shared-ui@6.0.11
+  - @contractspec/lib.provider-ranking@0.7.9
+  - @contractspec/lib.runtime-sandbox@2.7.10
+  - @contractspec/lib.surface-runtime@0.5.11
+  - @contractspec/lib.contracts-spec@4.1.3
+  - @contractspec/lib.design-system@3.8.4
+  - @contractspec/lib.ai-providers@3.7.9
+  - @contractspec/lib.content-gen@3.7.11
+  - @contractspec/module.examples@3.8.3
+  - @contractspec/lib.ui-kit-web@3.9.3
+  - @contractspec/lib.knowledge@3.7.11
+  - @contractspec/lib.ui-link@3.7.9
+  - @contractspec/lib.logger@3.7.9
+  - @contractspec/lib.schema@3.7.9
+
 ## 3.8.2
 
 ### Patch Changes

package/dist/components/docs/generated/docs-index.generated.d.ts

@@ -1,5 +1,5 @@
 export type DocsIndexSource = 'generated' | 'docblock';
-export interface DocsIndexEntry {
+export type DocsIndexEntry = {
     id: string;
     title: string;
     summary?: string;
@@ -11,17 +11,17 @@ export interface DocsIndexEntry {
     visibility?: string;
     version?: string;
     owners?: string[];
-}
-export interface DocsIndexChunk {
+};
+export type DocsIndexChunk = {
     key: string;
     file: string;
     total: number;
-}
-export interface DocsIndexManifest {
+};
+export type DocsIndexManifest = {
     generatedAt: string;
     total: number;
     version: string | null;
     contentRoot: string | null;
     chunks: DocsIndexChunk[];
-}
+};
 export declare const DOCS_INDEX_MANIFEST = "docs-index.manifest.json";

package/dist/components/docs/index.js

@@ -19320,10 +19320,17 @@ function LibrariesAiAgentPage() {
           }),
           /* @__PURE__ */ jsx76(CodeBlock35, {
             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: {
@@ -19345,19 +19352,17 @@ const registry = new AgentRegistry().register(SupportBot);`
           }),
           /* @__PURE__ */ jsx76(CodeBlock35, {
             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.
+`
           })
         ]
       }),
@@ -19374,26 +19379,21 @@ if (result.approvalRequestId) {
               /* @__PURE__ */ jsxs76("li", {
                 children: [
                   /* @__PURE__ */ jsx76("code", {
-                    children: "defineAgent"
+                    children: "createUnifiedAgent"
                   }),
                   ", ",
                   /* @__PURE__ */ jsx76("code", {
-                    children: "AgentRegistry"
+                    children: "ContractSpecAgent"
                   }),
                   ",",
                   " ",
                   /* @__PURE__ */ jsx76("code", {
-                    children: "AgentRunner"
+                    children: "UnifiedAgent"
                   })
                 ]
               }),
-              /* @__PURE__ */ jsxs76("li", {
-                children: [
-                  /* @__PURE__ */ jsx76("code", {
-                    children: "ToolExecutor"
-                  }),
-                  " with schema-enforced tool definitions"
-                ]
+              /* @__PURE__ */ jsx76("li", {
+                children: "MCP, operation-backed, memory, and subagent tool adapters"
               }),
               /* @__PURE__ */ jsxs76("li", {
                 children: [
@@ -22935,10 +22935,9 @@ const draft = await responder.draft(ticket, resolution, classification);`
           /* @__PURE__ */ jsx97(CodeBlock55, {
             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.`
           })
         ]
       }),

package/dist/components/docs/libraries/LibrariesAiAgentPage.js

@@ -42,10 +42,17 @@ function LibrariesAiAgentPage() {
           }),
           /* @__PURE__ */ jsx(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: {
@@ -67,19 +74,17 @@ const registry = new AgentRegistry().register(SupportBot);`
           }),
           /* @__PURE__ */ jsx(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.
+`
           })
         ]
       }),
@@ -96,26 +101,21 @@ if (result.approvalRequestId) {
               /* @__PURE__ */ jsxs("li", {
                 children: [
                   /* @__PURE__ */ jsx("code", {
-                    children: "defineAgent"
+                    children: "createUnifiedAgent"
                   }),
                   ", ",
                   /* @__PURE__ */ jsx("code", {
-                    children: "AgentRegistry"
+                    children: "ContractSpecAgent"
                   }),
                   ",",
                   " ",
                   /* @__PURE__ */ jsx("code", {
-                    children: "AgentRunner"
+                    children: "UnifiedAgent"
                   })
                 ]
               }),
-              /* @__PURE__ */ jsxs("li", {
-                children: [
-                  /* @__PURE__ */ jsx("code", {
-                    children: "ToolExecutor"
-                  }),
-                  " with schema-enforced tool definitions"
-                ]
+              /* @__PURE__ */ jsx("li", {
+                children: "MCP, operation-backed, memory, and subagent tool adapters"
               }),
               /* @__PURE__ */ jsxs("li", {
                 children: [

package/dist/components/docs/libraries/LibrariesSupportBotPage.js

@@ -64,10 +64,9 @@ const draft = await responder.draft(ticket, resolution, classification);`
           /* @__PURE__ */ jsx(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.`
           })
         ]
       }),

package/dist/components/docs/libraries/index.js

@@ -267,10 +267,17 @@ function LibrariesAiAgentPage() {
           }),
           /* @__PURE__ */ jsx2(CodeBlock2, {
             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: {
@@ -292,19 +299,17 @@ const registry = new AgentRegistry().register(SupportBot);`
           }),
           /* @__PURE__ */ jsx2(CodeBlock2, {
             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.
+`
           })
         ]
       }),
@@ -321,26 +326,21 @@ if (result.approvalRequestId) {
               /* @__PURE__ */ jsxs2("li", {
                 children: [
                   /* @__PURE__ */ jsx2("code", {
-                    children: "defineAgent"
+                    children: "createUnifiedAgent"
                   }),
                   ", ",
                   /* @__PURE__ */ jsx2("code", {
-                    children: "AgentRegistry"
+                    children: "ContractSpecAgent"
                   }),
                   ",",
                   " ",
                   /* @__PURE__ */ jsx2("code", {
-                    children: "AgentRunner"
+                    children: "UnifiedAgent"
                   })
                 ]
               }),
-              /* @__PURE__ */ jsxs2("li", {
-                children: [
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "ToolExecutor"
-                  }),
-                  " with schema-enforced tool definitions"
-                ]
+              /* @__PURE__ */ jsx2("li", {
+                children: "MCP, operation-backed, memory, and subagent tool adapters"
               }),
               /* @__PURE__ */ jsxs2("li", {
                 children: [
@@ -3882,10 +3882,9 @@ const draft = await responder.draft(ticket, resolution, classification);`
           /* @__PURE__ */ jsx23(CodeBlock22, {
             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.`
           })
         ]
       }),

package/dist/components/templates/engine/index.d.ts

@@ -9,8 +9,8 @@
  * Import presentations dynamically or use the main templates/engine.ts
  * which handles the build order correctly.
  */
+import { TransformEngine } from '@contractspec/lib.contracts-runtime-client-react/transform-engine';
 import type { PresentationSpec } from '@contractspec/lib.contracts-spec/presentations';
-import { TransformEngine } from '@contractspec/lib.contracts-spec/presentations/transform-engine';
 /**
  * Create a configured TransformEngine for template rendering
  */

package/dist/components/templates/engine/index.js

@@ -4,7 +4,7 @@ import {
   createDefaultTransformEngine,
   registerBasicValidation,
   registerDefaultReactRenderer
-} from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+} from "@contractspec/lib.contracts-runtime-client-react/transform-engine";
 function createTemplateTransformEngine() {
   const engine = createDefaultTransformEngine();
   registerDefaultReactRenderer(engine);

package/dist/index.js

@@ -19329,10 +19329,17 @@ function LibrariesAiAgentPage() {
           }),
           /* @__PURE__ */ jsx76(CodeBlock35, {
             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: {
@@ -19354,19 +19361,17 @@ const registry = new AgentRegistry().register(SupportBot);`
           }),
           /* @__PURE__ */ jsx76(CodeBlock35, {
             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.
+`
           })
         ]
       }),
@@ -19383,26 +19388,21 @@ if (result.approvalRequestId) {
               /* @__PURE__ */ jsxs76("li", {
                 children: [
                   /* @__PURE__ */ jsx76("code", {
-                    children: "defineAgent"
+                    children: "createUnifiedAgent"
                   }),
                   ", ",
                   /* @__PURE__ */ jsx76("code", {
-                    children: "AgentRegistry"
+                    children: "ContractSpecAgent"
                   }),
                   ",",
                   " ",
                   /* @__PURE__ */ jsx76("code", {
-                    children: "AgentRunner"
+                    children: "UnifiedAgent"
                   })
                 ]
               }),
-              /* @__PURE__ */ jsxs76("li", {
-                children: [
-                  /* @__PURE__ */ jsx76("code", {
-                    children: "ToolExecutor"
-                  }),
-                  " with schema-enforced tool definitions"
-                ]
+              /* @__PURE__ */ jsx76("li", {
+                children: "MCP, operation-backed, memory, and subagent tool adapters"
               }),
               /* @__PURE__ */ jsxs76("li", {
                 children: [
@@ -22944,10 +22944,9 @@ const draft = await responder.draft(ticket, resolution, classification);`
           /* @__PURE__ */ jsx97(CodeBlock55, {
             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.`
           })
         ]
       }),

package/dist/node/components/docs/index.js

@@ -19319,10 +19319,17 @@ function LibrariesAiAgentPage() {
           }),
           /* @__PURE__ */ jsx76(CodeBlock35, {
             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: {
@@ -19344,19 +19351,17 @@ const registry = new AgentRegistry().register(SupportBot);`
           }),
           /* @__PURE__ */ jsx76(CodeBlock35, {
             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.
+`
           })
         ]
       }),
@@ -19373,26 +19378,21 @@ if (result.approvalRequestId) {
               /* @__PURE__ */ jsxs76("li", {
                 children: [
                   /* @__PURE__ */ jsx76("code", {
-                    children: "defineAgent"
+                    children: "createUnifiedAgent"
                   }),
                   ", ",
                   /* @__PURE__ */ jsx76("code", {
-                    children: "AgentRegistry"
+                    children: "ContractSpecAgent"
                   }),
                   ",",
                   " ",
                   /* @__PURE__ */ jsx76("code", {
-                    children: "AgentRunner"
+                    children: "UnifiedAgent"
                   })
                 ]
               }),
-              /* @__PURE__ */ jsxs76("li", {
-                children: [
-                  /* @__PURE__ */ jsx76("code", {
-                    children: "ToolExecutor"
-                  }),
-                  " with schema-enforced tool definitions"
-                ]
+              /* @__PURE__ */ jsx76("li", {
+                children: "MCP, operation-backed, memory, and subagent tool adapters"
               }),
               /* @__PURE__ */ jsxs76("li", {
                 children: [
@@ -22934,10 +22934,9 @@ const draft = await responder.draft(ticket, resolution, classification);`
           /* @__PURE__ */ jsx97(CodeBlock55, {
             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.`
           })
         ]
       }),