@contractspec/lib.ai-agent 1.57.0 → 1.59.0

package/dist/schema/json-schema-to-zod.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"json-schema-to-zod.js","names":[],"sources":["../../src/schema/json-schema-to-zod.ts"],"sourcesContent":["import { z, type ZodType } from 'zod';\n\n/**\n * JSON Schema type definitions for conversion.\n */\ninterface JsonSchema {\n  type?: string;\n  properties?: Record<string, JsonSchema>;\n  required?: string[];\n  items?: JsonSchema;\n  enum?: (string | number | boolean)[];\n  const?: unknown;\n  anyOf?: JsonSchema[];\n  oneOf?: JsonSchema[];\n  allOf?: JsonSchema[];\n  description?: string;\n  default?: unknown;\n  minimum?: number;\n  maximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n  format?: string;\n  nullable?: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * Convert a JSON Schema to a Zod schema.\n *\n * Supports common JSON Schema types and constraints:\n * - string, number, integer, boolean, null\n * - object with properties and required\n * - array with items\n * - enum and const\n * - anyOf, oneOf, allOf\n * - format constraints (email, uri, uuid, date-time)\n * - numeric constraints (minimum, maximum)\n * - string constraints (minLength, maxLength, pattern)\n *\n * @param schema - JSON Schema object\n * @returns Zod schema\n */\nexport function jsonSchemaToZod(\n  schema: JsonSchema | Record<string, unknown>\n): ZodType {\n  const s = schema as JsonSchema;\n\n  // Handle nullable\n  const makeNullable = (zodSchema: ZodType): ZodType => {\n    return s.nullable ? z.union([zodSchema, z.null()]) : zodSchema;\n  };\n\n  // Handle const\n  if (s.const !== undefined) {\n    return z.literal(s.const as string | number | boolean);\n  }\n\n  // Handle enum\n  if (s.enum) {\n    const values = s.enum as [\n      string | number | boolean,\n      ...(string | number | boolean)[],\n    ];\n    return makeNullable(z.enum(values.map(String) as [string, ...string[]]));\n  }\n\n  // Handle anyOf\n  if (s.anyOf && s.anyOf.length > 0) {\n    const schemas = s.anyOf.map((sub) => jsonSchemaToZod(sub));\n    if (schemas.length === 1) return schemas[0] ?? z.unknown();\n    return z.union([\n      schemas[0] ?? z.unknown(),\n      schemas[1] ?? z.unknown(),\n      ...schemas.slice(2),\n    ]);\n  }\n\n  // Handle oneOf (same as anyOf for Zod purposes)\n  if (s.oneOf && s.oneOf.length > 0) {\n    const schemas = s.oneOf.map((sub) => jsonSchemaToZod(sub));\n    if (schemas.length === 1) return schemas[0] ?? z.unknown();\n    return z.union([\n      schemas[0] ?? z.unknown(),\n      schemas[1] ?? z.unknown(),\n      ...schemas.slice(2),\n    ]);\n  }\n\n  // Handle allOf (intersection)\n  if (s.allOf && s.allOf.length > 0) {\n    const schemas = s.allOf.map((sub) => jsonSchemaToZod(sub));\n    return schemas.reduce((acc, curr) => z.intersection(acc, curr));\n  }\n\n  // Handle type\n  switch (s.type) {\n    case 'string':\n      return makeNullable(buildStringSchema(s));\n    case 'number':\n    case 'integer':\n      return makeNullable(buildNumberSchema(s));\n    case 'boolean':\n      return makeNullable(z.boolean());\n    case 'null':\n      return z.null();\n    case 'array':\n      return makeNullable(buildArraySchema(s));\n    case 'object':\n      return makeNullable(buildObjectSchema(s));\n    default:\n      // Unknown type, accept anything\n      return z.unknown();\n  }\n}\n\nfunction buildStringSchema(schema: JsonSchema): ZodType {\n  let zodSchema = z.string();\n\n  if (schema.description) {\n    zodSchema = zodSchema.describe(schema.description);\n  }\n\n  // Format constraints\n  switch (schema.format) {\n    case 'email':\n      zodSchema = zodSchema.email();\n      break;\n    case 'uri':\n    case 'url':\n      zodSchema = zodSchema.url();\n      break;\n    case 'uuid':\n      zodSchema = zodSchema.uuid();\n      break;\n    case 'date-time':\n      zodSchema = zodSchema.datetime();\n      break;\n    case 'date':\n      zodSchema = zodSchema.date();\n      break;\n  }\n\n  // Length constraints\n  if (schema.minLength !== undefined) {\n    zodSchema = zodSchema.min(schema.minLength);\n  }\n  if (schema.maxLength !== undefined) {\n    zodSchema = zodSchema.max(schema.maxLength);\n  }\n\n  // Pattern constraint\n  if (schema.pattern) {\n    zodSchema = zodSchema.regex(new RegExp(schema.pattern));\n  }\n\n  return zodSchema;\n}\n\nfunction buildNumberSchema(schema: JsonSchema): ZodType {\n  let zodSchema = schema.type === 'integer' ? z.number().int() : z.number();\n\n  if (schema.description) {\n    zodSchema = zodSchema.describe(schema.description);\n  }\n\n  if (schema.minimum !== undefined) {\n    zodSchema = zodSchema.min(schema.minimum);\n  }\n  if (schema.maximum !== undefined) {\n    zodSchema = zodSchema.max(schema.maximum);\n  }\n\n  return zodSchema;\n}\n\nfunction buildArraySchema(schema: JsonSchema): ZodType {\n  const itemsSchema = schema.items\n    ? jsonSchemaToZod(schema.items)\n    : z.unknown();\n  let zodSchema = z.array(itemsSchema);\n\n  if (schema.description) {\n    zodSchema = zodSchema.describe(schema.description);\n  }\n\n  return zodSchema;\n}\n\nfunction buildObjectSchema(schema: JsonSchema): ZodType {\n  const properties = schema.properties ?? {};\n  const required = new Set(schema.required ?? []);\n\n  const shape: Record<string, ZodType> = {};\n  for (const [key, propSchema] of Object.entries(properties)) {\n    const zodProp = jsonSchemaToZod(propSchema);\n    shape[key] = required.has(key) ? zodProp : zodProp.optional();\n  }\n\n  let zodSchema = z.object(shape);\n\n  if (schema.description) {\n    zodSchema = zodSchema.describe(schema.description);\n  }\n\n  return zodSchema;\n}\n\n/**\n * Convert a JSON Schema to a Zod schema with a default empty object fallback.\n *\n * @param schema - Optional JSON Schema object\n * @returns Zod schema (defaults to empty object schema)\n */\nexport function jsonSchemaToZodSafe(schema?: Record<string, unknown>): ZodType {\n  if (!schema || Object.keys(schema).length === 0) {\n    return z.object({});\n  }\n  return jsonSchemaToZod(schema);\n}\n"],"mappings":"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"}

package/dist/schema/schema-output.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-output.js","names":[],"sources":["../../src/schema/schema-output.ts"],"sourcesContent":["import { Output } from 'ai';\nimport { type ZodType } from 'zod';\nimport { jsonSchemaToZod } from './json-schema-to-zod';\n\n/**\n * Bridge between ContractSpec SchemaModel and AI SDK Output.\n *\n * This module provides utilities to convert ContractSpec schema definitions\n * to AI SDK v6 Output.* structured output configurations.\n */\n\n// Extract return types from Output functions for explicit type annotations\ntype ObjectOutputReturn = ReturnType<typeof Output.object>;\ntype ArrayOutputReturn = ReturnType<typeof Output.array>;\ntype ChoiceOutputReturn = ReturnType<typeof Output.choice>;\ntype TextOutputReturn = ReturnType<typeof Output.text>;\n\n/**\n * Create an AI SDK Output.object from a JSON Schema.\n *\n * @param schema - JSON Schema object\n * @returns AI SDK Output configuration\n */\nexport function jsonSchemaToOutput(\n  schema: Record<string, unknown>\n): ObjectOutputReturn {\n  const zodSchema = jsonSchemaToZod(schema);\n  return Output.object({\n    schema: zodSchema,\n  });\n}\n\n/**\n * Create an AI SDK Output.array from a JSON Schema items definition.\n *\n * @param itemSchema - JSON Schema for array items\n * @returns AI SDK Output configuration\n */\nexport function jsonSchemaToArrayOutput(\n  itemSchema: Record<string, unknown>\n): ArrayOutputReturn {\n  const zodSchema = jsonSchemaToZod(itemSchema);\n  return Output.array({\n    element: zodSchema,\n  });\n}\n\n/**\n * Create an AI SDK Output.choice from enum values.\n *\n * @param choices - Array of choice values\n * @returns AI SDK Output configuration\n */\nexport function enumToChoiceOutput(choices: string[]): ChoiceOutputReturn {\n  return Output.choice({\n    options: choices as [string, ...string[]],\n  });\n}\n\n/**\n * Create an AI SDK Output from a Zod schema directly.\n *\n * @param schema - Zod schema\n * @returns AI SDK Output configuration\n */\nexport function zodToOutput<T extends ZodType>(schema: T): ObjectOutputReturn {\n  return Output.object({\n    schema,\n  });\n}\n\n/**\n * Create a simple text output configuration.\n *\n * @returns AI SDK Output configuration for text\n */\nexport function textOutput(): TextOutputReturn {\n  return Output.text();\n}\n\n/**\n * Output builder that can be used fluently.\n */\nexport const SchemaOutput = {\n  /**\n   * Create an object output from JSON Schema.\n   */\n  fromJsonSchema: jsonSchemaToOutput,\n\n  /**\n   * Create an array output from JSON Schema.\n   */\n  arrayFromJsonSchema: jsonSchemaToArrayOutput,\n\n  /**\n   * Create a choice output from enum.\n   */\n  fromEnum: enumToChoiceOutput,\n\n  /**\n   * Create an output from Zod schema.\n   */\n  fromZod: zodToOutput,\n\n  /**\n   * Create a text output.\n   */\n  text: textOutput,\n} as const;\n"],"mappings":";;;;;;;;;;;AAuBA,SAAgB,mBACd,QACoB;CACpB,MAAM,YAAY,gBAAgB,OAAO;AACzC,QAAO,OAAO,OAAO,EACnB,QAAQ,WACT,CAAC;;;;;;;;AASJ,SAAgB,wBACd,YACmB;CACnB,MAAM,YAAY,gBAAgB,WAAW;AAC7C,QAAO,OAAO,MAAM,EAClB,SAAS,WACV,CAAC;;;;;;;;AASJ,SAAgB,mBAAmB,SAAuC;AACxE,QAAO,OAAO,OAAO,EACnB,SAAS,SACV,CAAC;;;;;;;;AASJ,SAAgB,YAA+B,QAA+B;AAC5E,QAAO,OAAO,OAAO,EACnB,QACD,CAAC;;;;;;;AAQJ,SAAgB,aAA+B;AAC7C,QAAO,OAAO,MAAM;;;;;AAMtB,MAAa,eAAe;CAI1B,gBAAgB;CAKhB,qBAAqB;CAKrB,UAAU;CAKV,SAAS;CAKT,MAAM;CACP"}

package/dist/session/store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.js","names":[],"sources":["../../src/session/store.ts"],"sourcesContent":["import type { ModelMessage, StepResult, ToolSet } from 'ai';\nimport type { AgentSessionState } from '../types';\n\n/**\n * Interface for persisting agent session state.\n *\n * Implementations can use in-memory storage, databases,\n * or external services like Redis.\n */\nexport interface AgentSessionStore {\n  /**\n   * Get a session by ID.\n   */\n  get(sessionId: string): Promise<AgentSessionState | null>;\n\n  /**\n   * Create a new session.\n   */\n  create(\n    session: Omit<AgentSessionState, 'createdAt' | 'updatedAt'>\n  ): Promise<AgentSessionState>;\n\n  /**\n   * Append a step to a session.\n   */\n  appendStep(sessionId: string, step: StepResult<ToolSet>): Promise<void>;\n\n  /**\n   * Append a message to a session.\n   */\n  appendMessage(sessionId: string, message: ModelMessage): Promise<void>;\n\n  /**\n   * Update session properties.\n   */\n  update(\n    sessionId: string,\n    updates: Partial<Pick<AgentSessionState, 'status' | 'metadata'>>\n  ): Promise<void>;\n\n  /**\n   * Delete a session.\n   */\n  delete(sessionId: string): Promise<boolean>;\n\n  /**\n   * List sessions by agent ID.\n   */\n  listByAgent(agentId: string, limit?: number): Promise<AgentSessionState[]>;\n\n  /**\n   * List sessions by tenant ID.\n   */\n  listByTenant(tenantId: string, limit?: number): Promise<AgentSessionState[]>;\n}\n\n/**\n * In-memory session store for development and testing.\n */\nexport class InMemorySessionStore implements AgentSessionStore {\n  private readonly sessions = new Map<string, AgentSessionState>();\n\n  async get(sessionId: string): Promise<AgentSessionState | null> {\n    return this.sessions.get(sessionId) ?? null;\n  }\n\n  async create(\n    session: Omit<AgentSessionState, 'createdAt' | 'updatedAt'>\n  ): Promise<AgentSessionState> {\n    const now = new Date();\n    const fullSession: AgentSessionState = {\n      ...session,\n      createdAt: now,\n      updatedAt: now,\n    };\n    this.sessions.set(session.sessionId, fullSession);\n    return fullSession;\n  }\n\n  async appendStep(\n    sessionId: string,\n    step: StepResult<ToolSet>\n  ): Promise<void> {\n    const session = this.sessions.get(sessionId);\n    if (session) {\n      session.steps.push(step);\n      session.updatedAt = new Date();\n    }\n  }\n\n  async appendMessage(sessionId: string, message: ModelMessage): Promise<void> {\n    const session = this.sessions.get(sessionId);\n    if (session) {\n      session.messages.push(message);\n      session.updatedAt = new Date();\n    }\n  }\n\n  async update(\n    sessionId: string,\n    updates: Partial<Pick<AgentSessionState, 'status' | 'metadata'>>\n  ): Promise<void> {\n    const session = this.sessions.get(sessionId);\n    if (session) {\n      Object.assign(session, updates, { updatedAt: new Date() });\n    }\n  }\n\n  async delete(sessionId: string): Promise<boolean> {\n    return this.sessions.delete(sessionId);\n  }\n\n  async listByAgent(\n    agentId: string,\n    limit = 100\n  ): Promise<AgentSessionState[]> {\n    const results: AgentSessionState[] = [];\n    for (const session of this.sessions.values()) {\n      if (session.agentId === agentId) {\n        results.push(session);\n        if (results.length >= limit) break;\n      }\n    }\n    return results.sort(\n      (a, b) => b.updatedAt.getTime() - a.updatedAt.getTime()\n    );\n  }\n\n  async listByTenant(\n    tenantId: string,\n    limit = 100\n  ): Promise<AgentSessionState[]> {\n    const results: AgentSessionState[] = [];\n    for (const session of this.sessions.values()) {\n      if (session.tenantId === tenantId) {\n        results.push(session);\n        if (results.length >= limit) break;\n      }\n    }\n    return results.sort(\n      (a, b) => b.updatedAt.getTime() - a.updatedAt.getTime()\n    );\n  }\n\n  /**\n   * Clear all sessions (for testing).\n   */\n  clear(): void {\n    this.sessions.clear();\n  }\n}\n\n/**\n * Create an in-memory session store.\n */\nexport function createInMemorySessionStore(): AgentSessionStore {\n  return new InMemorySessionStore();\n}\n\n/**\n * Generate a unique session ID.\n */\nexport function generateSessionId(): string {\n  return `sess_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;\n}\n"],"mappings":";;;;AA2DA,IAAa,uBAAb,MAA+D;CAC7D,AAAiB,2BAAW,IAAI,KAAgC;CAEhE,MAAM,IAAI,WAAsD;AAC9D,SAAO,KAAK,SAAS,IAAI,UAAU,IAAI;;CAGzC,MAAM,OACJ,SAC4B;EAC5B,MAAM,sBAAM,IAAI,MAAM;EACtB,MAAM,cAAiC;GACrC,GAAG;GACH,WAAW;GACX,WAAW;GACZ;AACD,OAAK,SAAS,IAAI,QAAQ,WAAW,YAAY;AACjD,SAAO;;CAGT,MAAM,WACJ,WACA,MACe;EACf,MAAM,UAAU,KAAK,SAAS,IAAI,UAAU;AAC5C,MAAI,SAAS;AACX,WAAQ,MAAM,KAAK,KAAK;AACxB,WAAQ,4BAAY,IAAI,MAAM;;;CAIlC,MAAM,cAAc,WAAmB,SAAsC;EAC3E,MAAM,UAAU,KAAK,SAAS,IAAI,UAAU;AAC5C,MAAI,SAAS;AACX,WAAQ,SAAS,KAAK,QAAQ;AAC9B,WAAQ,4BAAY,IAAI,MAAM;;;CAIlC,MAAM,OACJ,WACA,SACe;EACf,MAAM,UAAU,KAAK,SAAS,IAAI,UAAU;AAC5C,MAAI,QACF,QAAO,OAAO,SAAS,SAAS,EAAE,2BAAW,IAAI,MAAM,EAAE,CAAC;;CAI9D,MAAM,OAAO,WAAqC;AAChD,SAAO,KAAK,SAAS,OAAO,UAAU;;CAGxC,MAAM,YACJ,SACA,QAAQ,KACsB;EAC9B,MAAM,UAA+B,EAAE;AACvC,OAAK,MAAM,WAAW,KAAK,SAAS,QAAQ,CAC1C,KAAI,QAAQ,YAAY,SAAS;AAC/B,WAAQ,KAAK,QAAQ;AACrB,OAAI,QAAQ,UAAU,MAAO;;AAGjC,SAAO,QAAQ,MACZ,GAAG,MAAM,EAAE,UAAU,SAAS,GAAG,EAAE,UAAU,SAAS,CACxD;;CAGH,MAAM,aACJ,UACA,QAAQ,KACsB;EAC9B,MAAM,UAA+B,EAAE;AACvC,OAAK,MAAM,WAAW,KAAK,SAAS,QAAQ,CAC1C,KAAI,QAAQ,aAAa,UAAU;AACjC,WAAQ,KAAK,QAAQ;AACrB,OAAI,QAAQ,UAAU,MAAO;;AAGjC,SAAO,QAAQ,MACZ,GAAG,MAAM,EAAE,UAAU,SAAS,GAAG,EAAE,UAAU,SAAS,CACxD;;;;;CAMH,QAAc;AACZ,OAAK,SAAS,OAAO;;;;;;AAOzB,SAAgB,6BAAgD;AAC9D,QAAO,IAAI,sBAAsB;;;;;AAMnC,SAAgB,oBAA4B;AAC1C,QAAO,QAAQ,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG"}

package/dist/spec/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../../src/spec/registry.ts"],"sourcesContent":["import type { AgentSpec } from './spec';\nimport { compareVersions } from 'compare-versions';\nimport { SpecContractRegistry } from '@contractspec/lib.contracts/registry';\n\n/**\n * Registry for managing agent specifications.\n *\n * Provides registration, lookup, and version management for agent specs.\n */\nexport class AgentRegistry extends SpecContractRegistry<'agent', AgentSpec> {\n  public constructor(items?: AgentSpec[]) {\n    super('agent', items);\n  }\n\n  /**\n   * List all unique agent names (without versions).\n   */\n  listNames(): string[] {\n    const names = new Set<string>();\n    for (const spec of this.items.values()) {\n      names.add(spec.meta.key);\n    }\n    return [...names];\n  }\n\n  /**\n   * Get an agent specification or throw if not found.\n   *\n   * @param name - Agent name\n   * @param version - Optional version\n   * @returns The agent spec\n   * @throws Error if the spec is not found\n   */\n  require(name: string, version?: string): AgentSpec {\n    const spec = this.get(name, version);\n    if (!spec) {\n      throw new Error(\n        `Agent spec not found for ${name}${version != null ? `.v${version}` : ''}`\n      );\n    }\n    return spec;\n  }\n\n  /**\n   * Check if an agent is registered.\n   *\n   * @param name - Agent name\n   * @param version - Optional version\n   */\n  has(name: string, version?: string): boolean {\n    return this.get(name, version) !== undefined;\n  }\n\n  /**\n   * Get all versions of an agent.\n   *\n   * @param name - Agent name\n   * @returns Array of specs sorted by version (ascending)\n   */\n  getVersions(name: string): AgentSpec[] {\n    const versions: AgentSpec[] = [];\n    for (const spec of this.items.values()) {\n      if (spec.meta.key === name) {\n        versions.push(spec);\n      }\n    }\n    return versions.sort((a, b) =>\n      compareVersions(a.meta.version, b.meta.version)\n    );\n  }\n}\n\n/**\n * Create a new agent registry.\n */\nexport function createAgentRegistry(): AgentRegistry {\n  return new AgentRegistry();\n}\n"],"mappings":";;;;;;;;;AASA,IAAa,gBAAb,cAAmC,qBAAyC;CAC1E,AAAO,YAAY,OAAqB;AACtC,QAAM,SAAS,MAAM;;;;;CAMvB,YAAsB;EACpB,MAAM,wBAAQ,IAAI,KAAa;AAC/B,OAAK,MAAM,QAAQ,KAAK,MAAM,QAAQ,CACpC,OAAM,IAAI,KAAK,KAAK,IAAI;AAE1B,SAAO,CAAC,GAAG,MAAM;;;;;;;;;;CAWnB,QAAQ,MAAc,SAA6B;EACjD,MAAM,OAAO,KAAK,IAAI,MAAM,QAAQ;AACpC,MAAI,CAAC,KACH,OAAM,IAAI,MACR,4BAA4B,OAAO,WAAW,OAAO,KAAK,YAAY,KACvE;AAEH,SAAO;;;;;;;;CAST,IAAI,MAAc,SAA2B;AAC3C,SAAO,KAAK,IAAI,MAAM,QAAQ,KAAK;;;;;;;;CASrC,YAAY,MAA2B;EACrC,MAAM,WAAwB,EAAE;AAChC,OAAK,MAAM,QAAQ,KAAK,MAAM,QAAQ,CACpC,KAAI,KAAK,KAAK,QAAQ,KACpB,UAAS,KAAK,KAAK;AAGvB,SAAO,SAAS,MAAM,GAAG,MACvB,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,CAChD;;;;;;AAOL,SAAgB,sBAAqC;AACnD,QAAO,IAAI,eAAe"}

package/dist/spec/spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec.js","names":[],"sources":["../../src/spec/spec.ts"],"sourcesContent":["import type { OwnerShipMeta } from '@contractspec/lib.contracts/ownership';\nimport type { KnowledgeCategory } from '@contractspec/lib.contracts/knowledge/spec';\nimport type { PolicyRef } from '@contractspec/lib.contracts/policy/spec';\n\n/**\n * Metadata for an agent specification.\n */\nexport type AgentMeta = OwnerShipMeta;\n\n/**\n * Configuration for a tool that an agent can use.\n */\nexport interface AgentToolConfig {\n  /** Tool name (unique within the agent) */\n  name: string;\n  /** Human-readable description for the LLM */\n  description?: string;\n  /** JSON Schema fragment for tool parameters */\n  schema?: Record<string, unknown>;\n  /** Optional cooldown in milliseconds between invocations */\n  cooldownMs?: number;\n  /** Maximum execution time before timeout */\n  timeoutMs?: number;\n  /** Whether the tool can be executed without human approval (AI SDK needsApproval = !automationSafe) */\n  automationSafe?: boolean;\n  /** Explicit approval requirement (overrides automationSafe) */\n  requiresApproval?: boolean;\n  /** Optional policy guard that must evaluate to allow the tool call */\n  policy?: PolicyRef;\n}\n\n/**\n * Reference to a knowledge space that the agent can access.\n */\nexport interface AgentKnowledgeRef {\n  /** Knowledge space key */\n  key: string;\n  /** Optional specific version */\n  version?: number;\n  /** Filter by knowledge category */\n  category?: KnowledgeCategory;\n  /** Whether the knowledge is required (static injection) or optional (dynamic RAG) */\n  required?: boolean;\n  /** Additional instructions appended when the space is available */\n  instructions?: string;\n}\n\n/**\n * Memory configuration for agent session persistence.\n */\nexport interface AgentMemoryConfig {\n  /** Maximum entries to keep in memory */\n  maxEntries?: number;\n  /** Time-to-live in minutes */\n  ttlMinutes?: number;\n  /** Number of messages before triggering summarization */\n  summaryTrigger?: number;\n  /** Whether to persist to long-term storage */\n  persistLongTerm?: boolean;\n}\n\n/**\n * Confidence policy for agent responses.\n */\nexport interface AgentConfidencePolicy {\n  /** Minimum acceptable confidence before escalation. Defaults to 0.7 */\n  min?: number;\n  /** Default value used when provider does not report confidence */\n  default?: number;\n}\n\n/**\n * Escalation policy for handling uncertain or failed agent responses.\n */\nexport interface AgentEscalationPolicy {\n  /** Auto escalate when confidence < threshold */\n  confidenceThreshold?: number;\n  /** Escalate when a tool throws irrecoverable errors */\n  onToolFailure?: boolean;\n  /** Escalate when iteration budget exceeded */\n  onTimeout?: boolean;\n  /** Optional human approval workflow ID */\n  approvalWorkflow?: string;\n}\n\n/**\n * Combined policy configuration for an agent.\n */\nexport interface AgentPolicy {\n  confidence?: AgentConfidencePolicy;\n  escalation?: AgentEscalationPolicy;\n  /** Feature flags to apply to this agent */\n  flags?: string[];\n}\n\n/**\n * Complete specification for a ContractSpec agent.\n */\nexport interface AgentSpec {\n  meta: AgentMeta;\n  /** System instructions for the agent */\n  instructions: string;\n  /** Human-readable description */\n  description?: string;\n  /** Tags for categorization */\n  tags?: string[];\n  /** Tools the agent can use */\n  tools: AgentToolConfig[];\n  /** Memory/session configuration */\n  memory?: AgentMemoryConfig;\n  /** Knowledge spaces the agent can access */\n  knowledge?: AgentKnowledgeRef[];\n  /** Policy configuration */\n  policy?: AgentPolicy;\n  /** Maximum steps per generation (defaults to 10) */\n  maxSteps?: number;\n}\n\n/**\n * Define and validate an agent specification.\n *\n * @param spec - The agent specification\n * @returns The frozen, validated specification\n * @throws Error if the specification is invalid\n */\nexport function defineAgent(spec: AgentSpec): AgentSpec {\n  if (!spec.meta?.key) {\n    throw new Error('Agent key is required');\n  }\n  if (typeof spec.meta.version !== 'string') {\n    throw new Error(`Agent ${spec.meta.key} is missing a string version`);\n  }\n  if (!spec.instructions?.trim()) {\n    throw new Error(`Agent ${spec.meta.key} requires instructions`);\n  }\n  if (!spec.tools?.length) {\n    throw new Error(`Agent ${spec.meta.key} must expose at least one tool`);\n  }\n\n  // Validate tool names are unique\n  const toolNames = new Set<string>();\n  for (const tool of spec.tools) {\n    if (toolNames.has(tool.name)) {\n      throw new Error(\n        `Agent ${spec.meta.key} has duplicate tool name: ${tool.name}`\n      );\n    }\n    toolNames.add(tool.name);\n  }\n\n  return Object.freeze(spec);\n}\n\n/**\n * Generate a unique key for an agent spec.\n */\nexport function agentKey(meta: AgentMeta): string {\n  return `${meta.key}.v${meta.version}`;\n}\n"],"mappings":";;;;;;;;AA6HA,SAAgB,YAAY,MAA4B;AACtD,KAAI,CAAC,KAAK,MAAM,IACd,OAAM,IAAI,MAAM,wBAAwB;AAE1C,KAAI,OAAO,KAAK,KAAK,YAAY,SAC/B,OAAM,IAAI,MAAM,SAAS,KAAK,KAAK,IAAI,8BAA8B;AAEvE,KAAI,CAAC,KAAK,cAAc,MAAM,CAC5B,OAAM,IAAI,MAAM,SAAS,KAAK,KAAK,IAAI,wBAAwB;AAEjE,KAAI,CAAC,KAAK,OAAO,OACf,OAAM,IAAI,MAAM,SAAS,KAAK,KAAK,IAAI,gCAAgC;CAIzE,MAAM,4BAAY,IAAI,KAAa;AACnC,MAAK,MAAM,QAAQ,KAAK,OAAO;AAC7B,MAAI,UAAU,IAAI,KAAK,KAAK,CAC1B,OAAM,IAAI,MACR,SAAS,KAAK,KAAK,IAAI,4BAA4B,KAAK,OACzD;AAEH,YAAU,IAAI,KAAK,KAAK;;AAG1B,QAAO,OAAO,OAAO,KAAK;;;;;AAM5B,SAAgB,SAAS,MAAyB;AAChD,QAAO,GAAG,KAAK,IAAI,IAAI,KAAK"}

package/dist/telemetry/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","names":[],"sources":["../../src/telemetry/adapter.ts"],"sourcesContent":["import type { StepResult, ToolSet } from 'ai';\n\n/**\n * Metric sample compatible with @contractspec/lib.evolution OperationMetricSample.\n */\nexport interface OperationMetricSample {\n  operation: { name: string; version: string };\n  durationMs: number;\n  success: boolean;\n  timestamp: Date;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Interface for collecting telemetry metrics.\n *\n * Implementations can send metrics to:\n * - @contractspec/lib.evolution for self-improvement\n * - PostHog for analytics\n * - Custom monitoring systems\n */\nexport interface TelemetryCollector {\n  /**\n   * Collect a metric sample.\n   */\n  collect(sample: OperationMetricSample): Promise<void>;\n}\n\n/**\n * Parse agent ID into name and version.\n */\nfunction parseAgentId(agentId: string): { name: string; version: string } {\n  const match = agentId.match(/^(.+)\\.v(\\s+)$/);\n  if (match) {\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    return { name: match[1]!, version: match[2]! };\n  }\n  return { name: agentId, version: '1.0.0' };\n}\n\n/**\n * Track an agent step for telemetry.\n *\n * Called from ContractSpecAgent.onStepFinish to feed metrics\n * to the evolution engine.\n *\n * @param collector - Telemetry collector\n * @param agentId - Agent identifier (e.g., \"support.bot.v1\")\n * @param step - AI SDK step result\n * @param durationMs - Optional step duration in milliseconds\n */\nexport async function trackAgentStep(\n  collector: TelemetryCollector,\n  agentId: string,\n  step: StepResult<ToolSet>,\n  durationMs?: number\n): Promise<void> {\n  const { name, version } = parseAgentId(agentId);\n\n  // Track tool invocations\n  for (const toolCall of step.toolCalls ?? []) {\n    const toolSample: OperationMetricSample = {\n      operation: { name: `${name}.${toolCall.toolName}`, version },\n      durationMs: durationMs ?? 0,\n      success:\n        step.toolResults?.some(\n          (r) => r.toolCallId === toolCall.toolCallId && r.output !== undefined\n        ) ?? false,\n      timestamp: new Date(),\n      metadata: {\n        agentId,\n        toolName: toolCall.toolName,\n        finishReason: step.finishReason,\n      },\n    };\n    await collector.collect(toolSample);\n  }\n\n  // Track overall step\n  const stepSample: OperationMetricSample = {\n    operation: { name, version },\n    durationMs: durationMs ?? 0,\n    success: step.finishReason !== 'error',\n    timestamp: new Date(),\n    metadata: {\n      agentId,\n      finishReason: step.finishReason,\n      tokenUsage: step.usage,\n      toolCallCount: step.toolCalls?.length ?? 0,\n    },\n  };\n  await collector.collect(stepSample);\n}\n\n/**\n * In-memory telemetry collector for testing.\n */\nexport class InMemoryTelemetryCollector implements TelemetryCollector {\n  private readonly samples: OperationMetricSample[] = [];\n\n  async collect(sample: OperationMetricSample): Promise<void> {\n    this.samples.push(sample);\n  }\n\n  /**\n   * Get all collected samples.\n   */\n  getSamples(): OperationMetricSample[] {\n    return [...this.samples];\n  }\n\n  /**\n   * Get samples for a specific operation.\n   */\n  getSamplesForOperation(operationName: string): OperationMetricSample[] {\n    return this.samples.filter((s) => s.operation.name === operationName);\n  }\n\n  /**\n   * Clear all samples.\n   */\n  clear(): void {\n    this.samples.length = 0;\n  }\n}\n\n/**\n * Create an in-memory telemetry collector.\n */\nexport function createInMemoryTelemetryCollector(): InMemoryTelemetryCollector {\n  return new InMemoryTelemetryCollector();\n}\n\n/**\n * No-op telemetry collector that discards all metrics.\n */\nexport const noopTelemetryCollector: TelemetryCollector = {\n  collect: async () => {\n    /* noop */\n  },\n};\n"],"mappings":";;;;AA+BA,SAAS,aAAa,SAAoD;CACxE,MAAM,QAAQ,QAAQ,MAAM,iBAAiB;AAC7C,KAAI,MAEF,QAAO;EAAE,MAAM,MAAM;EAAK,SAAS,MAAM;EAAK;AAEhD,QAAO;EAAE,MAAM;EAAS,SAAS;EAAS;;;;;;;;;;;;;AAc5C,eAAsB,eACpB,WACA,SACA,MACA,YACe;CACf,MAAM,EAAE,MAAM,YAAY,aAAa,QAAQ;AAG/C,MAAK,MAAM,YAAY,KAAK,aAAa,EAAE,EAAE;EAC3C,MAAM,aAAoC;GACxC,WAAW;IAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAAY;IAAS;GAC5D,YAAY,cAAc;GAC1B,SACE,KAAK,aAAa,MACf,MAAM,EAAE,eAAe,SAAS,cAAc,EAAE,WAAW,OAC7D,IAAI;GACP,2BAAW,IAAI,MAAM;GACrB,UAAU;IACR;IACA,UAAU,SAAS;IACnB,cAAc,KAAK;IACpB;GACF;AACD,QAAM,UAAU,QAAQ,WAAW;;CAIrC,MAAM,aAAoC;EACxC,WAAW;GAAE;GAAM;GAAS;EAC5B,YAAY,cAAc;EAC1B,SAAS,KAAK,iBAAiB;EAC/B,2BAAW,IAAI,MAAM;EACrB,UAAU;GACR;GACA,cAAc,KAAK;GACnB,YAAY,KAAK;GACjB,eAAe,KAAK,WAAW,UAAU;GAC1C;EACF;AACD,OAAM,UAAU,QAAQ,WAAW;;;;;AAMrC,IAAa,6BAAb,MAAsE;CACpE,AAAiB,UAAmC,EAAE;CAEtD,MAAM,QAAQ,QAA8C;AAC1D,OAAK,QAAQ,KAAK,OAAO;;;;;CAM3B,aAAsC;AACpC,SAAO,CAAC,GAAG,KAAK,QAAQ;;;;;CAM1B,uBAAuB,eAAgD;AACrE,SAAO,KAAK,QAAQ,QAAQ,MAAM,EAAE,UAAU,SAAS,cAAc;;;;;CAMvE,QAAc;AACZ,OAAK,QAAQ,SAAS;;;;;;AAO1B,SAAgB,mCAA+D;AAC7E,QAAO,IAAI,4BAA4B;;;;;AAMzC,MAAa,yBAA6C,EACxD,SAAS,YAAY,IAGtB"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-tool.js","names":["z"],"sources":["../../src/tools/knowledge-tool.ts"],"sourcesContent":["import { tool, type Tool } from 'ai';\nimport * as z from 'zod';\nimport type { KnowledgeRetriever } from '@contractspec/lib.knowledge/retriever';\nimport type { AgentKnowledgeRef } from '../spec/spec';\n\n/**\n * Create a knowledge query tool for dynamic RAG.\n *\n * This tool allows the agent to query optional knowledge spaces\n * at runtime. Required knowledge is injected statically via\n * the knowledge injector.\n *\n * @param retriever - The knowledge retriever to use\n * @param knowledgeRefs - Knowledge references from the agent spec\n * @returns AI SDK CoreTool for knowledge queries\n */\nexport function createKnowledgeQueryTool(\n  retriever: KnowledgeRetriever,\n  knowledgeRefs: AgentKnowledgeRef[]\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Tool<any, any> | null {\n  // Only include optional (non-required) knowledge spaces\n  const optionalSpaces = knowledgeRefs\n    .filter((k) => !k.required)\n    .map((k) => k.key)\n    .filter((key) => retriever.supportsSpace(key));\n\n  if (optionalSpaces.length === 0) {\n    return null;\n  }\n\n  // Build space descriptions for the tool\n  const spaceDescriptions = knowledgeRefs\n    .filter((k) => !k.required && retriever.supportsSpace(k.key))\n    .map((k) => `- ${k.key}: ${k.instructions ?? 'Knowledge space'}`)\n    .join('\\n');\n\n  return tool({\n    description: `Query knowledge bases for relevant information. Use this tool when you need to look up specific information that may not be in your context.\n\nAvailable knowledge spaces:\n${spaceDescriptions}`,\n    // AI SDK v6 uses inputSchema instead of parameters\n    inputSchema: z.object({\n      query: z\n        .string()\n        .describe('The question or search query to find relevant information'),\n      spaceKey: z\n        .enum(optionalSpaces as [string, ...string[]])\n        .optional()\n        .describe(\n          'Specific knowledge space to query. If omitted, searches all available spaces.'\n        ),\n      topK: z\n        .number()\n        .optional()\n        .default(5)\n        .describe('Maximum number of results to return'),\n    }),\n    execute: async ({ query, spaceKey, topK }) => {\n      const spacesToSearch = spaceKey ? [spaceKey] : optionalSpaces;\n      const allResults: { space: string; content: string; score: number }[] =\n        [];\n\n      for (const space of spacesToSearch) {\n        try {\n          const results = await retriever.retrieve(query, {\n            spaceKey: space,\n            topK: topK ?? 5,\n          });\n\n          for (const result of results) {\n            allResults.push({\n              space,\n              content: result.content,\n              score: result.score,\n            });\n          }\n        } catch (error) {\n          // Log but don't fail on individual space errors\n          console.warn(`Failed to query knowledge space ${space}:`, error);\n        }\n      }\n\n      if (allResults.length === 0) {\n        return 'No relevant information found in the knowledge bases.';\n      }\n\n      // Sort by score and format results\n      allResults.sort((a, b) => b.score - a.score);\n      const topResults = allResults.slice(0, topK ?? 5);\n\n      return topResults\n        .map(\n          (r, i) =>\n            `[Source ${i + 1} - ${r.space}] (relevance: ${(r.score * 100).toFixed(0)}%)\\n${r.content}`\n        )\n        .join('\\n\\n---\\n\\n');\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,yBACd,WACA,eAEuB;CAEvB,MAAM,iBAAiB,cACpB,QAAQ,MAAM,CAAC,EAAE,SAAS,CAC1B,KAAK,MAAM,EAAE,IAAI,CACjB,QAAQ,QAAQ,UAAU,cAAc,IAAI,CAAC;AAEhD,KAAI,eAAe,WAAW,EAC5B,QAAO;AAST,QAAO,KAAK;EACV,aAAa;;;EANW,cACvB,QAAQ,MAAM,CAAC,EAAE,YAAY,UAAU,cAAc,EAAE,IAAI,CAAC,CAC5D,KAAK,MAAM,KAAK,EAAE,IAAI,IAAI,EAAE,gBAAgB,oBAAoB,CAChE,KAAK,KAAK;EAQX,aAAaA,IAAE,OAAO;GACpB,OAAOA,IACJ,QAAQ,CACR,SAAS,4DAA4D;GACxE,UAAUA,IACP,KAAK,eAAwC,CAC7C,UAAU,CACV,SACC,gFACD;GACH,MAAMA,IACH,QAAQ,CACR,UAAU,CACV,QAAQ,EAAE,CACV,SAAS,sCAAsC;GACnD,CAAC;EACF,SAAS,OAAO,EAAE,OAAO,UAAU,WAAW;GAC5C,MAAM,iBAAiB,WAAW,CAAC,SAAS,GAAG;GAC/C,MAAM,aACJ,EAAE;AAEJ,QAAK,MAAM,SAAS,eAClB,KAAI;IACF,MAAM,UAAU,MAAM,UAAU,SAAS,OAAO;KAC9C,UAAU;KACV,MAAM,QAAQ;KACf,CAAC;AAEF,SAAK,MAAM,UAAU,QACnB,YAAW,KAAK;KACd;KACA,SAAS,OAAO;KAChB,OAAO,OAAO;KACf,CAAC;YAEG,OAAO;AAEd,YAAQ,KAAK,mCAAmC,MAAM,IAAI,MAAM;;AAIpE,OAAI,WAAW,WAAW,EACxB,QAAO;AAIT,cAAW,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM;AAG5C,UAFmB,WAAW,MAAM,GAAG,QAAQ,EAAE,CAG9C,KACE,GAAG,MACF,WAAW,IAAI,EAAE,KAAK,EAAE,MAAM,iBAAiB,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC,MAAM,EAAE,UACpF,CACA,KAAK,cAAc;;EAEzB,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-client.js","names":["StdioClientTransport"],"sources":["../../src/tools/mcp-client.ts"],"sourcesContent":["import { experimental_createMCPClient } from '@ai-sdk/mcp';\nimport { Experimental_StdioMCPTransport as StdioClientTransport } from '@ai-sdk/mcp/mcp-stdio';\nimport type { Tool } from 'ai';\n\n/**\n * Configuration for connecting to an MCP server.\n */\nexport interface McpClientConfig {\n  /** Display name for the MCP server */\n  name: string;\n  /** Command to spawn the MCP server process */\n  command: string;\n  /** Arguments to pass to the command */\n  args?: string[];\n  /** Environment variables for the process */\n  env?: Record<string, string>;\n}\n\n/**\n * Result of creating an MCP client with tools.\n */\nexport interface McpClientResult {\n  /** AI SDK tools from the MCP server */\n  tools: Record<string, Tool<unknown, unknown>>;\n  /** Cleanup function to close the connection */\n  cleanup: () => Promise<void>;\n}\n\n/**\n * Create AI SDK tools from an MCP server.\n *\n * This adapter allows ContractSpec agents to consume tools\n * from external MCP servers (e.g., filesystem, database, etc.).\n *\n * @param config - MCP server configuration\n * @returns Tools and cleanup function\n *\n * @example\n * ```typescript\n * const { tools, cleanup } = await mcpServerToTools({\n *   name: 'filesystem',\n *   command: 'npx',\n *   args: ['-y', '@modelcontextprotocol/server-filesystem', '/path'],\n * });\n *\n * // Use tools in agent...\n *\n * await cleanup();\n * ```\n */\nexport async function mcpServerToTools(\n  config: McpClientConfig\n): Promise<McpClientResult> {\n  const transport = new StdioClientTransport({\n    command: config.command,\n    args: config.args,\n    env: config.env,\n  });\n\n  const client = await experimental_createMCPClient({ transport });\n  const tools = await client.tools();\n\n  return {\n    tools: tools as Record<string, Tool<unknown, unknown>>,\n    cleanup: () => client.close(),\n  };\n}\n\n/**\n * Create multiple MCP tool sets from configurations.\n *\n * @param configs - Array of MCP server configurations\n * @returns Combined tools and cleanup function\n */\nexport async function createMcpToolsets(\n  configs: McpClientConfig[]\n): Promise<McpClientResult> {\n  const results = await Promise.all(configs.map(mcpServerToTools));\n\n  const combinedTools: Record<string, Tool<unknown, unknown>> = {};\n  for (const result of results) {\n    Object.assign(combinedTools, result.tools);\n  }\n\n  return {\n    tools: combinedTools,\n    cleanup: async () => {\n      await Promise.all(results.map((r) => r.cleanup()));\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,eAAsB,iBACpB,QAC0B;CAO1B,MAAM,SAAS,MAAM,6BAA6B,EAAE,WANlC,IAAIA,+BAAqB;EACzC,SAAS,OAAO;EAChB,MAAM,OAAO;EACb,KAAK,OAAO;EACb,CAAC,EAE6D,CAAC;AAGhE,QAAO;EACL,OAHY,MAAM,OAAO,OAAO;EAIhC,eAAe,OAAO,OAAO;EAC9B;;;;;;;;AASH,eAAsB,kBACpB,SAC0B;CAC1B,MAAM,UAAU,MAAM,QAAQ,IAAI,QAAQ,IAAI,iBAAiB,CAAC;CAEhE,MAAM,gBAAwD,EAAE;AAChE,MAAK,MAAM,UAAU,QACnB,QAAO,OAAO,eAAe,OAAO,MAAM;AAG5C,QAAO;EACL,OAAO;EACP,SAAS,YAAY;AACnB,SAAM,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE,SAAS,CAAC,CAAC;;EAErD"}

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

@@ -1 +0,0 @@
-{"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.js.map

@@ -1 +0,0 @@
-{"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"}