@contractspec/lib.ai-agent 0.0.0-canary-20260113162409

package/dist/tools/mcp-server.d.ts

@@ -0,0 +1,46 @@
+import { AgentSpec } from "../spec/spec.js";
+import { ContractSpecAgent } from "../agent/contract-spec-agent.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/tools/mcp-server.d.ts
+
+/**
+ * Generate an MCP server that exposes a ContractSpec agent as a tool.
+ *
+ * This allows other AI agents (e.g., Claude Desktop, Cursor) to use
+ * your ContractSpec agents as tools, enabling agent-to-agent composition.
+ *
+ * @param agent - The ContractSpec agent to expose
+ * @param spec - The agent specification
+ * @returns MCP Server instance
+ *
+ * @example
+ * ```typescript
+ * const server = agentToMcpServer(myAgent, myAgentSpec);
+ *
+ * // Run via stdio transport
+ * const transport = new StdioServerTransport();
+ * await server.connect(transport);
+ * ```
+ */
+declare function agentToMcpServer(agent: ContractSpecAgent, spec: AgentSpec): McpServer;
+/**
+ * Configuration for running an agent as an MCP server.
+ */
+interface AgentMcpServerConfig {
+  /** The agent to expose */
+  agent: ContractSpecAgent;
+  /** The agent specification */
+  spec: AgentSpec;
+  /** Optional server name override */
+  name?: string;
+  /** Optional version override */
+  version?: string;
+}
+/**
+ * Create an MCP server from configuration.
+ */
+declare function createAgentMcpServer(config: AgentMcpServerConfig): McpServer;
+//#endregion
+export { AgentMcpServerConfig, agentToMcpServer, createAgentMcpServer };
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/tools/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","names":[],"sources":["../../src/tools/mcp-server.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAyBA;;;;;AA+EA;AAcA;;;;;;;;;;;iBA7FgB,gBAAA,QACP,yBACD,YACL;;;;UA4Ec,oBAAA;;SAER;;QAED;;;;;;;;;iBAUQ,oBAAA,SAA6B,uBAAuB"}

package/dist/tools/mcp-server.js

@@ -0,0 +1,69 @@
+import { jsonSchemaToZodSafe } from "../schema/json-schema-to-zod.js";
+import * as z$1 from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/tools/mcp-server.ts
+/**
+* Generate an MCP server that exposes a ContractSpec agent as a tool.
+*
+* This allows other AI agents (e.g., Claude Desktop, Cursor) to use
+* your ContractSpec agents as tools, enabling agent-to-agent composition.
+*
+* @param agent - The ContractSpec agent to expose
+* @param spec - The agent specification
+* @returns MCP Server instance
+*
+* @example
+* ```typescript
+* const server = agentToMcpServer(myAgent, myAgentSpec);
+*
+* // Run via stdio transport
+* const transport = new StdioServerTransport();
+* await server.connect(transport);
+* ```
+*/
+function agentToMcpServer(agent, spec) {
+	const server = new McpServer({
+		name: spec.meta.key,
+		version: `${spec.meta.version}`
+	});
+	server.registerTool(spec.meta.key, {
+		description: spec.description ?? `Interact with ${spec.meta.key} agent`,
+		inputSchema: z$1.object({
+			message: z$1.string().describe("The message or query to send to the agent"),
+			sessionId: z$1.string().optional().describe("Optional session ID to continue a conversation")
+		})
+	}, async (args) => {
+		const { message, sessionId } = args;
+		return { content: [{
+			type: "text",
+			text: (await agent.generate({
+				prompt: message,
+				options: { sessionId }
+			})).text
+		}] };
+	});
+	for (const toolConfig of spec.tools) {
+		const inputSchema = toolConfig.schema ? jsonSchemaToZodSafe(toolConfig.schema) : z$1.object({});
+		server.registerTool(`${spec.meta.key}.${toolConfig.name}`, {
+			description: toolConfig.description ?? `Execute ${toolConfig.name} tool`,
+			inputSchema
+		}, async (args) => {
+			return { content: [{
+				type: "text",
+				text: (await agent.generate({ prompt: `Execute the ${toolConfig.name} tool with the following arguments: ${JSON.stringify(args)}` })).text
+			}] };
+		});
+	}
+	return server;
+}
+/**
+* Create an MCP server from configuration.
+*/
+function createAgentMcpServer(config) {
+	return agentToMcpServer(config.agent, config.spec);
+}
+
+//#endregion
+export { agentToMcpServer, createAgentMcpServer };
+//# sourceMappingURL=mcp-server.js.map

package/dist/tools/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","names":["z"],"sources":["../../src/tools/mcp-server.ts"],"sourcesContent":["import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport * as z from 'zod';\nimport type { AgentSpec } from '../spec/spec';\nimport type { ContractSpecAgent } from '../agent/contract-spec-agent';\nimport { jsonSchemaToZodSafe } from '../schema/json-schema-to-zod';\n\n/**\n * Generate an MCP server that exposes a ContractSpec agent as a tool.\n *\n * This allows other AI agents (e.g., Claude Desktop, Cursor) to use\n * your ContractSpec agents as tools, enabling agent-to-agent composition.\n *\n * @param agent - The ContractSpec agent to expose\n * @param spec - The agent specification\n * @returns MCP Server instance\n *\n * @example\n * ```typescript\n * const server = agentToMcpServer(myAgent, myAgentSpec);\n *\n * // Run via stdio transport\n * const transport = new StdioServerTransport();\n * await server.connect(transport);\n * ```\n */\nexport function agentToMcpServer(\n  agent: ContractSpecAgent,\n  spec: AgentSpec\n): McpServer {\n  const server = new McpServer({\n    name: spec.meta.key,\n    version: `${spec.meta.version}`,\n  });\n\n  // Expose agent as a conversational tool using registerTool\n  server.registerTool(\n    spec.meta.key,\n    {\n      description: spec.description ?? `Interact with ${spec.meta.key} agent`,\n      inputSchema: z.object({\n        message: z\n          .string()\n          .describe('The message or query to send to the agent'),\n        sessionId: z\n          .string()\n          .optional()\n          .describe('Optional session ID to continue a conversation'),\n      }),\n    },\n    async (args) => {\n      const { message, sessionId } = args;\n\n      const result = await agent.generate({\n        prompt: message,\n        options: { sessionId },\n      });\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: result.text,\n          },\n        ],\n      };\n    }\n  );\n\n  // Expose individual tools from the agent spec\n  for (const toolConfig of spec.tools) {\n    const inputSchema = toolConfig.schema\n      ? jsonSchemaToZodSafe(toolConfig.schema)\n      : z.object({});\n\n    server.registerTool(\n      `${spec.meta.key}.${toolConfig.name}`,\n      {\n        description:\n          toolConfig.description ?? `Execute ${toolConfig.name} tool`,\n        inputSchema,\n      },\n      async (args) => {\n        const result = await agent.generate({\n          prompt: `Execute the ${toolConfig.name} tool with the following arguments: ${JSON.stringify(args)}`,\n        });\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: result.text,\n            },\n          ],\n        };\n      }\n    );\n  }\n\n  return server;\n}\n\n/**\n * Configuration for running an agent as an MCP server.\n */\nexport interface AgentMcpServerConfig {\n  /** The agent to expose */\n  agent: ContractSpecAgent;\n  /** The agent specification */\n  spec: AgentSpec;\n  /** Optional server name override */\n  name?: string;\n  /** Optional version override */\n  version?: string;\n}\n\n/**\n * Create an MCP server from configuration.\n */\nexport function createAgentMcpServer(config: AgentMcpServerConfig): McpServer {\n  return agentToMcpServer(config.agent, config.spec);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,iBACd,OACA,MACW;CACX,MAAM,SAAS,IAAI,UAAU;EAC3B,MAAM,KAAK,KAAK;EAChB,SAAS,GAAG,KAAK,KAAK;EACvB,CAAC;AAGF,QAAO,aACL,KAAK,KAAK,KACV;EACE,aAAa,KAAK,eAAe,iBAAiB,KAAK,KAAK,IAAI;EAChE,aAAaA,IAAE,OAAO;GACpB,SAASA,IACN,QAAQ,CACR,SAAS,4CAA4C;GACxD,WAAWA,IACR,QAAQ,CACR,UAAU,CACV,SAAS,iDAAiD;GAC9D,CAAC;EACH,EACD,OAAO,SAAS;EACd,MAAM,EAAE,SAAS,cAAc;AAO/B,SAAO,EACL,SAAS,CACP;GACE,MAAM;GACN,OATS,MAAM,MAAM,SAAS;IAClC,QAAQ;IACR,SAAS,EAAE,WAAW;IACvB,CAAC,EAMiB;GACd,CACF,EACF;GAEJ;AAGD,MAAK,MAAM,cAAc,KAAK,OAAO;EACnC,MAAM,cAAc,WAAW,SAC3B,oBAAoB,WAAW,OAAO,GACtCA,IAAE,OAAO,EAAE,CAAC;AAEhB,SAAO,aACL,GAAG,KAAK,KAAK,IAAI,GAAG,WAAW,QAC/B;GACE,aACE,WAAW,eAAe,WAAW,WAAW,KAAK;GACvD;GACD,EACD,OAAO,SAAS;AAKd,UAAO,EACL,SAAS,CACP;IACE,MAAM;IACN,OARS,MAAM,MAAM,SAAS,EAClC,QAAQ,eAAe,WAAW,KAAK,sCAAsC,KAAK,UAAU,KAAK,IAClG,CAAC,EAMiB;IACd,CACF,EACF;IAEJ;;AAGH,QAAO;;;;;AAoBT,SAAgB,qBAAqB,QAAyC;AAC5E,QAAO,iBAAiB,OAAO,OAAO,OAAO,KAAK"}

package/dist/tools/tool-adapter.d.ts

@@ -0,0 +1,50 @@
+import { AgentToolConfig } from "../spec/spec.js";
+import { ToolExecutionContext, ToolHandler } from "../types.js";
+import { Tool } from "ai";
+
+//#region src/tools/tool-adapter.d.ts
+
+/**
+ * Convert ContractSpec AgentToolConfig to AI SDK CoreTool.
+ *
+ * @param specTool - The tool configuration from AgentSpec
+ * @param handler - The handler function for the tool
+ * @param context - Partial context to inject into handler calls
+ * @returns AI SDK CoreTool
+ */
+declare function specToolToAISDKTool(specTool: AgentToolConfig, handler: ToolHandler, context?: Partial<ToolExecutionContext>): Tool<any, any>;
+/**
+ * Convert multiple ContractSpec tool configs to AI SDK tools.
+ *
+ * @param specTools - Array of tool configurations
+ * @param handlers - Map of tool name to handler function
+ * @param context - Partial context to inject into handler calls
+ * @returns Record of AI SDK tools keyed by name
+ */
+declare function specToolsToAISDKTools(specTools: AgentToolConfig[], handlers: Map<string, ToolHandler>, context?: Partial<ToolExecutionContext>): Record<string, Tool<any, any>>;
+/**
+ * Type-safe tool handler builder.
+ *
+ * @example
+ * ```typescript
+ * const handler = createToolHandler<{ query: string }>((input, ctx) => {
+ *   return `Searched for: ${input.query}`;
+ * });
+ * ```
+ */
+declare function createToolHandler<TInput = unknown, TOutput = string>(handler: (input: TInput, context: ToolExecutionContext) => Promise<TOutput> | TOutput): ToolHandler<TInput, TOutput>;
+/**
+ * Build a tool handlers map from an object.
+ *
+ * @example
+ * ```typescript
+ * const handlers = buildToolHandlers({
+ *   search: async (input: { query: string }) => `Found: ${input.query}`,
+ *   calculate: async (input: { a: number, b: number }) => `${input.a + input.b}`,
+ * });
+ * ```
+ */
+declare function buildToolHandlers(handlersObj: Record<string, ToolHandler>): Map<string, ToolHandler>;
+//#endregion
+export { buildToolHandlers, createToolHandler, specToolToAISDKTool, specToolsToAISDKTools };
+//# sourceMappingURL=tool-adapter.d.ts.map

package/dist/tools/tool-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-adapter.d.ts","names":[],"sources":["../../src/tools/tool-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAcA;;;;;;AAIO,iBAJS,mBAAA,CAIT,QAAA,EAHK,eAGL,EAAA,OAAA,EAFI,WAEJ,EAAA,OAAA,CAAA,EADI,OACJ,CADY,oBACZ,CAAA,CAAA,EAAJ,IAAI,CAAA,GAAA,EAAA,GAAA,CAAA;AA6BP;;;;;;;;AAIS,iBAJO,qBAAA,CAIP,SAAA,EAHI,eAGJ,EAAA,EAAA,QAAA,EAFG,GAEH,CAAA,MAAA,EAFe,WAEf,CAAA,EAAA,OAAA,CAAA,EADE,OACF,CADU,oBACV,CAAA,CAAA,EAAN,MAAM,CAAA,MAAA,EAAS,IAAT,CAAA,GAAA,EAAA,GAAA,CAAA,CAAA;AAyBT;;;;;;;;;;AAsBgB,iBAtBA,iBAsBiB,CAAA,SAAA,OAAA,EAAA,UAAA,MAAA,CAAA,CAAA,OAAA,EAAA,CAAA,KAAA,EApBtB,MAoBsB,EAAA,OAAA,EAnBpB,oBAmBoB,EAAA,GAlB1B,OAkB0B,CAlBlB,OAkBkB,CAAA,GAlBP,OAkBO,CAAA,EAjB9B,WAiB8B,CAjBlB,MAiBkB,EAjBV,OAiBU,CAAA;;;;;;;;;;;;iBAAjB,iBAAA,cACD,eAAe,eAC3B,YAAY"}

package/dist/tools/tool-adapter.js

@@ -0,0 +1,80 @@
+import { jsonSchemaToZodSafe } from "../schema/json-schema-to-zod.js";
+import { tool } from "ai";
+
+//#region src/tools/tool-adapter.ts
+/**
+* Convert ContractSpec AgentToolConfig to AI SDK CoreTool.
+*
+* @param specTool - The tool configuration from AgentSpec
+* @param handler - The handler function for the tool
+* @param context - Partial context to inject into handler calls
+* @returns AI SDK CoreTool
+*/
+function specToolToAISDKTool(specTool, handler, context = {}) {
+	return tool({
+		description: specTool.description ?? specTool.name,
+		inputSchema: jsonSchemaToZodSafe(specTool.schema),
+		needsApproval: specTool.requiresApproval ?? !specTool.automationSafe,
+		execute: async (input) => {
+			const result = await handler(input, {
+				agentId: context.agentId ?? "unknown",
+				sessionId: context.sessionId ?? "unknown",
+				tenantId: context.tenantId,
+				actorId: context.actorId,
+				metadata: context.metadata,
+				signal: context.signal
+			});
+			return typeof result === "string" ? result : JSON.stringify(result);
+		}
+	});
+}
+/**
+* Convert multiple ContractSpec tool configs to AI SDK tools.
+*
+* @param specTools - Array of tool configurations
+* @param handlers - Map of tool name to handler function
+* @param context - Partial context to inject into handler calls
+* @returns Record of AI SDK tools keyed by name
+*/
+function specToolsToAISDKTools(specTools, handlers, context = {}) {
+	const tools = {};
+	for (const specTool of specTools) {
+		const handler = handlers.get(specTool.name);
+		if (!handler) throw new Error(`Missing handler for tool: ${specTool.name}`);
+		tools[specTool.name] = specToolToAISDKTool(specTool, handler, context);
+	}
+	return tools;
+}
+/**
+* Type-safe tool handler builder.
+*
+* @example
+* ```typescript
+* const handler = createToolHandler<{ query: string }>((input, ctx) => {
+*   return `Searched for: ${input.query}`;
+* });
+* ```
+*/
+function createToolHandler(handler) {
+	return async (input, context) => {
+		return handler(input, context);
+	};
+}
+/**
+* Build a tool handlers map from an object.
+*
+* @example
+* ```typescript
+* const handlers = buildToolHandlers({
+*   search: async (input: { query: string }) => `Found: ${input.query}`,
+*   calculate: async (input: { a: number, b: number }) => `${input.a + input.b}`,
+* });
+* ```
+*/
+function buildToolHandlers(handlersObj) {
+	return new Map(Object.entries(handlersObj));
+}
+
+//#endregion
+export { buildToolHandlers, createToolHandler, specToolToAISDKTool, specToolsToAISDKTools };
+//# sourceMappingURL=tool-adapter.js.map

package/dist/tools/tool-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-adapter.js","names":[],"sources":["../../src/tools/tool-adapter.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { tool, type Tool } from 'ai';\nimport type { AgentToolConfig } from '../spec/spec';\nimport type { ToolExecutionContext, ToolHandler } from '../types';\nimport { jsonSchemaToZodSafe } from '../schema/json-schema-to-zod';\n\n/**\n * Convert ContractSpec AgentToolConfig to AI SDK CoreTool.\n *\n * @param specTool - The tool configuration from AgentSpec\n * @param handler - The handler function for the tool\n * @param context - Partial context to inject into handler calls\n * @returns AI SDK CoreTool\n */\nexport function specToolToAISDKTool(\n  specTool: AgentToolConfig,\n  handler: ToolHandler,\n  context: Partial<ToolExecutionContext> = {}\n): Tool<any, any> {\n  return tool({\n    description: specTool.description ?? specTool.name,\n    // AI SDK v6 uses inputSchema instead of parameters\n    inputSchema: jsonSchemaToZodSafe(specTool.schema),\n    // AI SDK v6 native approval support\n    needsApproval: specTool.requiresApproval ?? !specTool.automationSafe,\n    execute: async (input) => {\n      const result = await handler(input, {\n        agentId: context.agentId ?? 'unknown',\n        sessionId: context.sessionId ?? 'unknown',\n        tenantId: context.tenantId,\n        actorId: context.actorId,\n        metadata: context.metadata,\n        signal: context.signal,\n      });\n      return typeof result === 'string' ? result : JSON.stringify(result);\n    },\n  });\n}\n\n/**\n * Convert multiple ContractSpec tool configs to AI SDK tools.\n *\n * @param specTools - Array of tool configurations\n * @param handlers - Map of tool name to handler function\n * @param context - Partial context to inject into handler calls\n * @returns Record of AI SDK tools keyed by name\n */\nexport function specToolsToAISDKTools(\n  specTools: AgentToolConfig[],\n  handlers: Map<string, ToolHandler>,\n  context: Partial<ToolExecutionContext> = {}\n): Record<string, Tool<any, any>> {\n  const tools: Record<string, Tool<any, any>> = {};\n\n  for (const specTool of specTools) {\n    const handler = handlers.get(specTool.name);\n    if (!handler) {\n      throw new Error(`Missing handler for tool: ${specTool.name}`);\n    }\n\n    tools[specTool.name] = specToolToAISDKTool(specTool, handler, context);\n  }\n\n  return tools;\n}\n\n/**\n * Type-safe tool handler builder.\n *\n * @example\n * ```typescript\n * const handler = createToolHandler<{ query: string }>((input, ctx) => {\n *   return `Searched for: ${input.query}`;\n * });\n * ```\n */\nexport function createToolHandler<TInput = unknown, TOutput = string>(\n  handler: (\n    input: TInput,\n    context: ToolExecutionContext\n  ) => Promise<TOutput> | TOutput\n): ToolHandler<TInput, TOutput> {\n  return async (input, context) => {\n    return handler(input as TInput, context);\n  };\n}\n\n/**\n * Build a tool handlers map from an object.\n *\n * @example\n * ```typescript\n * const handlers = buildToolHandlers({\n *   search: async (input: { query: string }) => `Found: ${input.query}`,\n *   calculate: async (input: { a: number, b: number }) => `${input.a + input.b}`,\n * });\n * ```\n */\nexport function buildToolHandlers(\n  handlersObj: Record<string, ToolHandler>\n): Map<string, ToolHandler> {\n  return new Map(Object.entries(handlersObj));\n}\n"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,oBACd,UACA,SACA,UAAyC,EAAE,EAC3B;AAChB,QAAO,KAAK;EACV,aAAa,SAAS,eAAe,SAAS;EAE9C,aAAa,oBAAoB,SAAS,OAAO;EAEjD,eAAe,SAAS,oBAAoB,CAAC,SAAS;EACtD,SAAS,OAAO,UAAU;GACxB,MAAM,SAAS,MAAM,QAAQ,OAAO;IAClC,SAAS,QAAQ,WAAW;IAC5B,WAAW,QAAQ,aAAa;IAChC,UAAU,QAAQ;IAClB,SAAS,QAAQ;IACjB,UAAU,QAAQ;IAClB,QAAQ,QAAQ;IACjB,CAAC;AACF,UAAO,OAAO,WAAW,WAAW,SAAS,KAAK,UAAU,OAAO;;EAEtE,CAAC;;;;;;;;;;AAWJ,SAAgB,sBACd,WACA,UACA,UAAyC,EAAE,EACX;CAChC,MAAM,QAAwC,EAAE;AAEhD,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,UAAU,SAAS,IAAI,SAAS,KAAK;AAC3C,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,6BAA6B,SAAS,OAAO;AAG/D,QAAM,SAAS,QAAQ,oBAAoB,UAAU,SAAS,QAAQ;;AAGxE,QAAO;;;;;;;;;;;;AAaT,SAAgB,kBACd,SAI8B;AAC9B,QAAO,OAAO,OAAO,YAAY;AAC/B,SAAO,QAAQ,OAAiB,QAAQ;;;;;;;;;;;;;;AAe5C,SAAgB,kBACd,aAC0B;AAC1B,QAAO,IAAI,IAAI,OAAO,QAAQ,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,146 @@
+import { LanguageModelUsage, ModelMessage, StepResult, ToolSet } from "ai";
+
+//#region src/types.d.ts
+
+/**
+ * Simplified tool call type for ContractSpec usage.
+ * Compatible with AI SDK v6 TypedToolCall.
+ */
+interface ToolCallInfo {
+  type: 'tool-call';
+  toolCallId: string;
+  toolName: string;
+  args: unknown;
+}
+/**
+ * Simplified tool result type for ContractSpec usage.
+ * Compatible with AI SDK v6 TypedToolResult.
+ */
+interface ToolResultInfo {
+  type: 'tool-result';
+  toolCallId: string;
+  toolName: string;
+  output: unknown;
+}
+/**
+ * Extended message type that adds metadata support to ModelMessage.
+ * Used for session memory tracking.
+ */
+interface AgentMessage {
+  role: 'user' | 'assistant' | 'system' | 'tool';
+  content: string | {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+  }[];
+  metadata?: Record<string, string>;
+}
+type AgentStatus = 'idle' | 'running' | 'waiting' | 'completed' | 'failed' | 'escalated';
+type AgentEventName = 'agent.session.created' | 'agent.session.updated' | 'agent.step.started' | 'agent.step.completed' | 'agent.tool.called' | 'agent.tool.completed' | 'agent.tool.failed' | 'agent.tool.approval_requested' | 'agent.escalated' | 'agent.completed' | 'agent.failed';
+type AgentFinishReason = 'stop' | 'tool-calls' | 'length' | 'content-filter' | 'error' | 'other' | 'unknown';
+interface AgentEventPayload {
+  sessionId: string;
+  agentId: string;
+  tenantId?: string;
+  stepIndex?: number;
+  toolName?: string;
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Runtime context passed to agent calls via AI SDK v6 callOptionsSchema.
+ * Maps to ContractSpec's tenant/actor system.
+ */
+interface AgentCallOptions {
+  /** Tenant scoping for guardrails and data isolation */
+  tenantId?: string;
+  /** Unique end-user identifier (for personalization) */
+  actorId?: string;
+  /** Session to resume; new session created when omitted */
+  sessionId?: string;
+  /** Arbitrary metadata forwarded to events and tool handlers */
+  metadata?: Record<string, string>;
+}
+interface AgentSessionState {
+  sessionId: string;
+  agentId: string;
+  tenantId?: string;
+  actorId?: string;
+  status: AgentStatus;
+  messages: ModelMessage[];
+  steps: StepResult<ToolSet>[];
+  createdAt: Date;
+  updatedAt: Date;
+  metadata?: Record<string, string>;
+}
+interface AgentGenerateParams {
+  /** User prompt or message */
+  prompt: string;
+  /** System prompt override (appended to agent instructions) */
+  systemOverride?: string;
+  /** Runtime context options */
+  options?: AgentCallOptions;
+  /** Maximum number of steps/iterations */
+  maxSteps?: number;
+  /** Abort signal for cancellation */
+  signal?: AbortSignal;
+}
+interface AgentStreamParams extends AgentGenerateParams {
+  /** Called when a step completes */
+  onStepFinish?: (step: StepResult<ToolSet>) => void | Promise<void>;
+}
+interface AgentGenerateResult<TOutput = string> {
+  /** The final text response */
+  text: string;
+  /** Structured output if configured */
+  output?: TOutput;
+  /** All steps taken during generation */
+  steps: StepResult<ToolSet>[];
+  /** All tool calls made during generation */
+  toolCalls: ToolCallInfo[];
+  /** All tool results */
+  toolResults: ToolResultInfo[];
+  /** Reason generation finished */
+  finishReason: AgentFinishReason;
+  /** Token usage statistics */
+  usage?: LanguageModelUsage;
+  /** Updated session state */
+  session?: AgentSessionState;
+  /** Whether approval is pending for a tool call */
+  pendingApproval?: {
+    toolName: string;
+    toolCallId: string;
+    args: unknown;
+  };
+}
+/**
+ * Context provided to tool handlers during execution.
+ */
+interface ToolExecutionContext {
+  agentId: string;
+  sessionId: string;
+  tenantId?: string;
+  actorId?: string;
+  metadata?: Record<string, string>;
+  signal?: AbortSignal;
+}
+/**
+ * Handler function for a tool.
+ */
+type ToolHandler<TInput = unknown, TOutput = string> = (input: TInput, context: ToolExecutionContext) => Promise<TOutput>;
+interface AgentStepMetrics {
+  agentId: string;
+  stepIndex: number;
+  toolCalls: {
+    toolName: string;
+    durationMs?: number;
+    success: boolean;
+    error?: string;
+  }[];
+  finishReason: string;
+  usage?: LanguageModelUsage;
+  timestamp: Date;
+}
+type AgentEventEmitter = (event: AgentEventName, payload: AgentEventPayload) => void | Promise<void>;
+//#endregion
+export { AgentCallOptions, AgentEventEmitter, AgentEventName, AgentEventPayload, AgentFinishReason, AgentGenerateParams, AgentGenerateResult, AgentMessage, AgentSessionState, AgentStatus, AgentStepMetrics, AgentStreamParams, type LanguageModelUsage, ToolCallInfo, ToolExecutionContext, ToolHandler, ToolResultInfo };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;AAWA;AAWA;AAeA;AAUY,UApCK,YAAA,CAoCM;EAQX,IAAA,EAAA,WAAc;EAad,UAAA,EAAA,MAAA;EASK,QAAA,EAAA,MAAA;EAiBA,IAAA,EAAA,OAAA;AAejB;;;;;AAQa,UA/FI,cAAA,CA+FJ;EACA,IAAA,EAAA,aAAA;EACA,UAAA,EAAA,MAAA;EAAM,QAAA,EAAA,MAAA;EAOF,MAAA,EAAA,OAAA;AAajB;;;;;AAA8D,UAtG7C,YAAA,CAsG6C;EAS7C,IAAA,EAAA,MAAA,GAAA,WAAmB,GAAA,QAAA,GAAA,MAAA;EAIzB,OAAA,EAAA,MAAA,GAAA;IAES,IAAA,EAAA,MAAA;IAAX,IAAA,CAAA,EAAA,MAAA;IAEI,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;EAEE,CAAA,EAAA;EAEC,QAAA,CAAA,EAxHH,MAwHG,CAAA,MAAA,EAAA,MAAA,CAAA;;AAIJ,KArHA,WAAA,GAqHA,MAAA,GAAA,SAAA,GAAA,SAAA,GAAA,WAAA,GAAA,QAAA,GAAA,WAAA;AAAiB,KA7GjB,cAAA,GA6GiB,uBAAA,GAAA,uBAAA,GAAA,oBAAA,GAAA,sBAAA,GAAA,mBAAA,GAAA,sBAAA,GAAA,mBAAA,GAAA,+BAAA,GAAA,iBAAA,GAAA,iBAAA,GAAA,cAAA;AAgBZ,KAhHL,iBAAA,GAgHyB,MAAA,GAKxB,YACF,GAAA,QAAW,GAAA,gBAAA,GAAA,OAAA,GAAA,OAAA,GAAA,SAAA;AAMV,UAnHK,iBAAA,CAmHM;EACd,SAAA,EAAA,MAAA;EACE,OAAA,EAAA,MAAA;EACE,QAAA,CAAA,EAAA,MAAA;EAAR,SAAA,CAAA,EAAA,MAAA;EAAO,QAAA,CAAA,EAAA,MAAA;EAMK,QAAA,CAAA,EAtHJ,MAsHI,CAAA,MAAgB,EAAA,OAUvB,CAAA;AAQV;;;;;UA7HiB,gBAAA;;;;;;;;aAQJ;;UAOI,iBAAA;;;;;UAKP;YACE;SACH,WAAW;aACP;aACA;aACA;;UAOI,mBAAA;;;;;;YAML;;;;WAID;;UAGM,iBAAA,SAA0B;;wBAEnB,WAAW,oBAAoB;;UAOtC;;;;WAIN;;SAEF,WAAW;;aAEP;;eAEE;;gBAEC;;UAEN;;YAEE;;;;;;;;;;;UAgBK,oBAAA;;;;;aAKJ;WACF;;;;;KAMC,0DACH,iBACE,yBACN,QAAQ;UAMI,gBAAA;;;;;;;;;;UAUP;aACG;;KAOD,iBAAA,WACH,yBACE,6BACC"}

package/package.json

@@ -0,0 +1,155 @@
+{
+  "name": "@contractspec/lib.ai-agent",
+  "version": "0.0.0-canary-20260113162409",
+  "description": "AI agent orchestration with MCP and tool support",
+  "keywords": [
+    "contractspec",
+    "ai",
+    "agents",
+    "llm",
+    "mcp",
+    "tools",
+    "typescript"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "ai": "6.0.29",
+    "@ai-sdk/mcp": "1.0.5",
+    "@ai-sdk/anthropic": "3.0.11",
+    "@ai-sdk/google": "3.0.6",
+    "@ai-sdk/mistral": "3.0.5",
+    "@ai-sdk/openai": "3.0.8",
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113162409",
+    "@contractspec/lib.knowledge": "0.0.0-canary-20260113162409",
+    "compare-versions": "^6.1.1",
+    "zod": "^4.3.5"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": ">=0.1.0",
+    "@opencode-ai/sdk": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
+    },
+    "@opencode-ai/sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113162409",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113162409",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./agent": "./dist/agent/index.js",
+    "./agent/agent-factory": "./dist/agent/agent-factory.js",
+    "./agent/contract-spec-agent": "./dist/agent/contract-spec-agent.js",
+    "./agent/unified-agent": "./dist/agent/unified-agent.js",
+    "./approval": "./dist/approval/index.js",
+    "./approval/workflow": "./dist/approval/workflow.js",
+    "./exporters": "./dist/exporters/index.js",
+    "./exporters/claude-agent-exporter": "./dist/exporters/claude-agent-exporter.js",
+    "./exporters/opencode-exporter": "./dist/exporters/opencode-exporter.js",
+    "./exporters/types": "./dist/exporters/types.js",
+    "./interop": "./dist/interop/index.js",
+    "./interop/spec-consumer": "./dist/interop/spec-consumer.js",
+    "./interop/tool-consumer": "./dist/interop/tool-consumer.js",
+    "./interop/types": "./dist/interop/types.js",
+    "./knowledge": "./dist/knowledge/index.js",
+    "./knowledge/injector": "./dist/knowledge/injector.js",
+    "./memory": "./dist/memory/index.js",
+    "./memory/in-memory": "./dist/memory/in-memory.js",
+    "./memory/manager": "./dist/memory/manager.js",
+    "./providers": "./dist/providers/index.js",
+    "./providers/claude-agent-sdk": "./dist/providers/claude-agent-sdk/index.js",
+    "./providers/claude-agent-sdk/adapter": "./dist/providers/claude-agent-sdk/adapter.js",
+    "./providers/claude-agent-sdk/session-bridge": "./dist/providers/claude-agent-sdk/session-bridge.js",
+    "./providers/claude-agent-sdk/tool-bridge": "./dist/providers/claude-agent-sdk/tool-bridge.js",
+    "./providers/opencode-sdk": "./dist/providers/opencode-sdk/index.js",
+    "./providers/opencode-sdk/adapter": "./dist/providers/opencode-sdk/adapter.js",
+    "./providers/opencode-sdk/agent-bridge": "./dist/providers/opencode-sdk/agent-bridge.js",
+    "./providers/opencode-sdk/tool-bridge": "./dist/providers/opencode-sdk/tool-bridge.js",
+    "./providers/registry": "./dist/providers/registry.js",
+    "./providers/types": "./dist/providers/types.js",
+    "./schema": "./dist/schema/index.js",
+    "./schema/json-schema-to-zod": "./dist/schema/json-schema-to-zod.js",
+    "./schema/schema-output": "./dist/schema/schema-output.js",
+    "./session": "./dist/session/index.js",
+    "./session/store": "./dist/session/store.js",
+    "./spec": "./dist/spec/index.js",
+    "./spec/registry": "./dist/spec/registry.js",
+    "./spec/spec": "./dist/spec/spec.js",
+    "./telemetry": "./dist/telemetry/index.js",
+    "./telemetry/adapter": "./dist/telemetry/adapter.js",
+    "./tools": "./dist/tools/index.js",
+    "./tools/knowledge-tool": "./dist/tools/knowledge-tool.js",
+    "./tools/mcp-client": "./dist/tools/mcp-client.js",
+    "./tools/mcp-server": "./dist/tools/mcp-server.js",
+    "./tools/tool-adapter": "./dist/tools/tool-adapter.js",
+    "./types": "./dist/types.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./agent": "./dist/agent/index.js",
+      "./agent/agent-factory": "./dist/agent/agent-factory.js",
+      "./agent/contract-spec-agent": "./dist/agent/contract-spec-agent.js",
+      "./approval": "./dist/approval/index.js",
+      "./approval/workflow": "./dist/approval/workflow.js",
+      "./knowledge": "./dist/knowledge/index.js",
+      "./knowledge/injector": "./dist/knowledge/injector.js",
+      "./memory": "./dist/memory/index.js",
+      "./memory/in-memory": "./dist/memory/in-memory.js",
+      "./memory/manager": "./dist/memory/manager.js",
+      "./schema": "./dist/schema/index.js",
+      "./schema/json-schema-to-zod": "./dist/schema/json-schema-to-zod.js",
+      "./schema/schema-output": "./dist/schema/schema-output.js",
+      "./session": "./dist/session/index.js",
+      "./session/store": "./dist/session/store.js",
+      "./spec": "./dist/spec/index.js",
+      "./spec/registry": "./dist/spec/registry.js",
+      "./spec/spec": "./dist/spec/spec.js",
+      "./telemetry": "./dist/telemetry/index.js",
+      "./telemetry/adapter": "./dist/telemetry/adapter.js",
+      "./tools": "./dist/tools/index.js",
+      "./tools/knowledge-tool": "./dist/tools/knowledge-tool.js",
+      "./tools/mcp-client": "./dist/tools/mcp-client.js",
+      "./tools/mcp-server": "./dist/tools/mcp-server.js",
+      "./tools/tool-adapter": "./dist/tools/tool-adapter.js",
+      "./types": "./dist/types.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/ai-agent"
+  },
+  "homepage": "https://contractspec.io"
+}