@contractspec/lib.ai-agent 1.56.1 → 1.58.0

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

@@ -0,0 +1,205 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/schema/json-schema-to-zod.ts
+import { z } from "zod";
+function jsonSchemaToZod(schema) {
+  const s = schema;
+  const makeNullable = (zodSchema) => {
+    return s.nullable ? z.union([zodSchema, z.null()]) : zodSchema;
+  };
+  if (s.const !== undefined) {
+    return z.literal(s.const);
+  }
+  if (s.enum) {
+    const values = s.enum;
+    return makeNullable(z.enum(values.map(String)));
+  }
+  if (s.anyOf && s.anyOf.length > 0) {
+    const schemas = s.anyOf.map((sub) => jsonSchemaToZod(sub));
+    if (schemas.length === 1)
+      return schemas[0] ?? z.unknown();
+    return z.union([
+      schemas[0] ?? z.unknown(),
+      schemas[1] ?? z.unknown(),
+      ...schemas.slice(2)
+    ]);
+  }
+  if (s.oneOf && s.oneOf.length > 0) {
+    const schemas = s.oneOf.map((sub) => jsonSchemaToZod(sub));
+    if (schemas.length === 1)
+      return schemas[0] ?? z.unknown();
+    return z.union([
+      schemas[0] ?? z.unknown(),
+      schemas[1] ?? z.unknown(),
+      ...schemas.slice(2)
+    ]);
+  }
+  if (s.allOf && s.allOf.length > 0) {
+    const schemas = s.allOf.map((sub) => jsonSchemaToZod(sub));
+    return schemas.reduce((acc, curr) => z.intersection(acc, curr));
+  }
+  switch (s.type) {
+    case "string":
+      return makeNullable(buildStringSchema(s));
+    case "number":
+    case "integer":
+      return makeNullable(buildNumberSchema(s));
+    case "boolean":
+      return makeNullable(z.boolean());
+    case "null":
+      return z.null();
+    case "array":
+      return makeNullable(buildArraySchema(s));
+    case "object":
+      return makeNullable(buildObjectSchema(s));
+    default:
+      return z.unknown();
+  }
+}
+function buildStringSchema(schema) {
+  let zodSchema = z.string();
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  switch (schema.format) {
+    case "email":
+      zodSchema = zodSchema.email();
+      break;
+    case "uri":
+    case "url":
+      zodSchema = zodSchema.url();
+      break;
+    case "uuid":
+      zodSchema = zodSchema.uuid();
+      break;
+    case "date-time":
+      zodSchema = zodSchema.datetime();
+      break;
+    case "date":
+      zodSchema = zodSchema.date();
+      break;
+  }
+  if (schema.minLength !== undefined) {
+    zodSchema = zodSchema.min(schema.minLength);
+  }
+  if (schema.maxLength !== undefined) {
+    zodSchema = zodSchema.max(schema.maxLength);
+  }
+  if (schema.pattern) {
+    zodSchema = zodSchema.regex(new RegExp(schema.pattern));
+  }
+  return zodSchema;
+}
+function buildNumberSchema(schema) {
+  let zodSchema = schema.type === "integer" ? z.number().int() : z.number();
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  if (schema.minimum !== undefined) {
+    zodSchema = zodSchema.min(schema.minimum);
+  }
+  if (schema.maximum !== undefined) {
+    zodSchema = zodSchema.max(schema.maximum);
+  }
+  return zodSchema;
+}
+function buildArraySchema(schema) {
+  const itemsSchema = schema.items ? jsonSchemaToZod(schema.items) : z.unknown();
+  let zodSchema = z.array(itemsSchema);
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  return zodSchema;
+}
+function buildObjectSchema(schema) {
+  const properties = schema.properties ?? {};
+  const required = new Set(schema.required ?? []);
+  const shape = {};
+  for (const [key, propSchema] of Object.entries(properties)) {
+    const zodProp = jsonSchemaToZod(propSchema);
+    shape[key] = required.has(key) ? zodProp : zodProp.optional();
+  }
+  let zodSchema = z.object(shape);
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  return zodSchema;
+}
+function jsonSchemaToZodSafe(schema) {
+  if (!schema || Object.keys(schema).length === 0) {
+    return z.object({});
+  }
+  return jsonSchemaToZod(schema);
+}
+var init_json_schema_to_zod = () => {};
+
+// src/tools/mcp-server.ts
+init_json_schema_to_zod();
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import * as z2 from "zod";
+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: z2.object({
+      message: z2.string().describe("The message or query to send to the agent"),
+      sessionId: z2.string().optional().describe("Optional session ID to continue a conversation")
+    })
+  }, async (args) => {
+    const { message, sessionId } = args;
+    const result = await agent.generate({
+      prompt: message,
+      options: { sessionId }
+    });
+    return {
+      content: [
+        {
+          type: "text",
+          text: result.text
+        }
+      ]
+    };
+  });
+  for (const toolConfig of spec.tools) {
+    const inputSchema = toolConfig.schema ? jsonSchemaToZodSafe(toolConfig.schema) : z2.object({});
+    server.registerTool(`${spec.meta.key}.${toolConfig.name}`, {
+      description: toolConfig.description ?? `Execute ${toolConfig.name} tool`,
+      inputSchema
+    }, async (args) => {
+      const result = await agent.generate({
+        prompt: `Execute the ${toolConfig.name} tool with the following arguments: ${JSON.stringify(args)}`
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: result.text
+          }
+        ]
+      };
+    });
+  }
+  return server;
+}
+function createAgentMcpServer(config) {
+  return agentToMcpServer(config.agent, config.spec);
+}
+export {
+  createAgentMcpServer,
+  agentToMcpServer
+};

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

@@ -0,0 +1,197 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/schema/json-schema-to-zod.ts
+import { z } from "zod";
+function jsonSchemaToZod(schema) {
+  const s = schema;
+  const makeNullable = (zodSchema) => {
+    return s.nullable ? z.union([zodSchema, z.null()]) : zodSchema;
+  };
+  if (s.const !== undefined) {
+    return z.literal(s.const);
+  }
+  if (s.enum) {
+    const values = s.enum;
+    return makeNullable(z.enum(values.map(String)));
+  }
+  if (s.anyOf && s.anyOf.length > 0) {
+    const schemas = s.anyOf.map((sub) => jsonSchemaToZod(sub));
+    if (schemas.length === 1)
+      return schemas[0] ?? z.unknown();
+    return z.union([
+      schemas[0] ?? z.unknown(),
+      schemas[1] ?? z.unknown(),
+      ...schemas.slice(2)
+    ]);
+  }
+  if (s.oneOf && s.oneOf.length > 0) {
+    const schemas = s.oneOf.map((sub) => jsonSchemaToZod(sub));
+    if (schemas.length === 1)
+      return schemas[0] ?? z.unknown();
+    return z.union([
+      schemas[0] ?? z.unknown(),
+      schemas[1] ?? z.unknown(),
+      ...schemas.slice(2)
+    ]);
+  }
+  if (s.allOf && s.allOf.length > 0) {
+    const schemas = s.allOf.map((sub) => jsonSchemaToZod(sub));
+    return schemas.reduce((acc, curr) => z.intersection(acc, curr));
+  }
+  switch (s.type) {
+    case "string":
+      return makeNullable(buildStringSchema(s));
+    case "number":
+    case "integer":
+      return makeNullable(buildNumberSchema(s));
+    case "boolean":
+      return makeNullable(z.boolean());
+    case "null":
+      return z.null();
+    case "array":
+      return makeNullable(buildArraySchema(s));
+    case "object":
+      return makeNullable(buildObjectSchema(s));
+    default:
+      return z.unknown();
+  }
+}
+function buildStringSchema(schema) {
+  let zodSchema = z.string();
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  switch (schema.format) {
+    case "email":
+      zodSchema = zodSchema.email();
+      break;
+    case "uri":
+    case "url":
+      zodSchema = zodSchema.url();
+      break;
+    case "uuid":
+      zodSchema = zodSchema.uuid();
+      break;
+    case "date-time":
+      zodSchema = zodSchema.datetime();
+      break;
+    case "date":
+      zodSchema = zodSchema.date();
+      break;
+  }
+  if (schema.minLength !== undefined) {
+    zodSchema = zodSchema.min(schema.minLength);
+  }
+  if (schema.maxLength !== undefined) {
+    zodSchema = zodSchema.max(schema.maxLength);
+  }
+  if (schema.pattern) {
+    zodSchema = zodSchema.regex(new RegExp(schema.pattern));
+  }
+  return zodSchema;
+}
+function buildNumberSchema(schema) {
+  let zodSchema = schema.type === "integer" ? z.number().int() : z.number();
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  if (schema.minimum !== undefined) {
+    zodSchema = zodSchema.min(schema.minimum);
+  }
+  if (schema.maximum !== undefined) {
+    zodSchema = zodSchema.max(schema.maximum);
+  }
+  return zodSchema;
+}
+function buildArraySchema(schema) {
+  const itemsSchema = schema.items ? jsonSchemaToZod(schema.items) : z.unknown();
+  let zodSchema = z.array(itemsSchema);
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  return zodSchema;
+}
+function buildObjectSchema(schema) {
+  const properties = schema.properties ?? {};
+  const required = new Set(schema.required ?? []);
+  const shape = {};
+  for (const [key, propSchema] of Object.entries(properties)) {
+    const zodProp = jsonSchemaToZod(propSchema);
+    shape[key] = required.has(key) ? zodProp : zodProp.optional();
+  }
+  let zodSchema = z.object(shape);
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  return zodSchema;
+}
+function jsonSchemaToZodSafe(schema) {
+  if (!schema || Object.keys(schema).length === 0) {
+    return z.object({});
+  }
+  return jsonSchemaToZod(schema);
+}
+var init_json_schema_to_zod = () => {};
+
+// src/tools/tool-adapter.ts
+import { tool } from "ai";
+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);
+    }
+  });
+}
+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;
+}
+function createToolHandler(handler) {
+  return async (input, context) => {
+    return handler(input, context);
+  };
+}
+function buildToolHandlers(handlersObj) {
+  return new Map(Object.entries(handlersObj));
+}
+var init_tool_adapter = __esm(() => {
+  init_json_schema_to_zod();
+});
+init_tool_adapter();
+
+export {
+  specToolsToAISDKTools,
+  specToolToAISDKTool,
+  createToolHandler,
+  buildToolHandlers
+};

package/dist/providers/claude-agent-sdk/adapter.d.ts

@@ -1,58 +1,65 @@
-import { AgentSpec } from "../../spec/spec.js";
-import { ClaudeAgentSDKConfig, ExternalAgentContext, ExternalAgentProvider, ExternalExecuteParams, ExternalExecuteResult, ExternalStreamChunk } from "../types.js";
-
-//#region src/providers/claude-agent-sdk/adapter.d.ts
-
+/**
+ * Claude Agent SDK Provider
+ *
+ * Enables ContractSpec agents to leverage Claude's agentic capabilities:
+ * - Computer use (file editing, bash execution)
+ * - Extended thinking for complex reasoning
+ * - Agentic search and subagents
+ * - MCP server integration
+ *
+ * This adapter wraps @anthropic-ai/claude-agent-sdk to work as a backend
+ * for ContractSpec agents.
+ */
+import type { AgentSpec } from '../../spec/spec';
+import type { ExternalAgentProvider, ExternalAgentContext, ExternalExecuteParams, ExternalExecuteResult, ExternalStreamChunk, ClaudeAgentSDKConfig } from '../types';
 /**
  * Claude Agent SDK Provider implementation.
  */
-declare class ClaudeAgentSDKProvider implements ExternalAgentProvider {
-  readonly name = "claude-agent-sdk";
-  readonly version = "1.0.0";
-  private config;
-  private sdkAvailable;
-  constructor(config?: ClaudeAgentSDKConfig);
-  /**
-   * Check if Claude Agent SDK is available.
-   */
-  isAvailable(): boolean;
-  /**
-   * Create an execution context from an AgentSpec.
-   */
-  createContext(spec: AgentSpec): Promise<ExternalAgentContext>;
-  /**
-   * Execute a prompt using Claude Agent SDK.
-   */
-  execute(context: ExternalAgentContext, params: ExternalExecuteParams): Promise<ExternalExecuteResult>;
-  /**
-   * Stream execution with real-time updates.
-   */
-  stream(context: ExternalAgentContext, params: ExternalExecuteParams): AsyncIterable<ExternalStreamChunk>;
-  /**
-   * Load the Claude Agent SDK dynamically.
-   */
-  private loadSDK;
-  /**
-   * Prepare tools for Claude Agent SDK format.
-   */
-  private prepareToolsForSDK;
-  /**
-   * Execute a single tool.
-   */
-  private executeTool;
-  /**
-   * Execute multiple tools.
-   */
-  private executeTools;
-  /**
-   * Extract text content from response.
-   */
-  private extractTextContent;
-  /**
-   * Map Claude Agent SDK stop reason to ContractSpec finish reason.
-   */
-  private mapStopReason;
+export declare class ClaudeAgentSDKProvider implements ExternalAgentProvider {
+    readonly name = "claude-agent-sdk";
+    readonly version = "1.0.0";
+    private config;
+    private sdkAvailable;
+    constructor(config?: ClaudeAgentSDKConfig);
+    /**
+     * Check if Claude Agent SDK is available.
+     */
+    isAvailable(): boolean;
+    /**
+     * Create an execution context from an AgentSpec.
+     */
+    createContext(spec: AgentSpec): Promise<ExternalAgentContext>;
+    /**
+     * Execute a prompt using Claude Agent SDK.
+     */
+    execute(context: ExternalAgentContext, params: ExternalExecuteParams): Promise<ExternalExecuteResult>;
+    /**
+     * Stream execution with real-time updates.
+     */
+    stream(context: ExternalAgentContext, params: ExternalExecuteParams): AsyncIterable<ExternalStreamChunk>;
+    /**
+     * Load the Claude Agent SDK dynamically.
+     */
+    private loadSDK;
+    /**
+     * Prepare tools for Claude Agent SDK format.
+     */
+    private prepareToolsForSDK;
+    /**
+     * Execute a single tool.
+     */
+    private executeTool;
+    /**
+     * Execute multiple tools.
+     */
+    private executeTools;
+    /**
+     * Extract text content from response.
+     */
+    private extractTextContent;
+    /**
+     * Map Claude Agent SDK stop reason to ContractSpec finish reason.
+     */
+    private mapStopReason;
 }
-//#endregion
-export { ClaudeAgentSDKProvider };
 //# sourceMappingURL=adapter.d.ts.map

package/dist/providers/claude-agent-sdk/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","names":[],"sources":["../../../src/providers/claude-agent-sdk/adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAqD+C,cAAlC,sBAAA,YAAkC,qBAAA,CAAA;EAAqB,SAAA,IAAA,GAAA,kBAAA;;;;uBAO9C;;;;;;;;sBAoCM,YAAY,QAAQ;;;;mBAwDnC,8BACD,wBACP,QAAQ;;;;kBAuGA,8BACD,wBACP,cAAc"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-agent-sdk/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EAEnB,oBAAoB,EAErB,MAAM,UAAU,CAAC;AAyBlB;;GAEG;AACH,qBAAa,sBAAuB,YAAW,qBAAqB;IAClE,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAwB;gBAEhC,MAAM,GAAE,oBAAyB;IAW7C;;OAEG;IACH,WAAW,IAAI,OAAO;IAmBtB;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoDnE;;OAEG;IACG,OAAO,CACX,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAmGjC;;OAEG;IACI,MAAM,CACX,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,qBAAqB,GAC5B,aAAa,CAAC,mBAAmB,CAAC;IAkHrC;;OAEG;YACW,OAAO;IAarB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;YACW,WAAW;IA8BzB;;OAEG;YACW,YAAY;IAU1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,aAAa;CAetB"}