@adcp/sdk 12.0.0 → 12.0.2

package/dist/lib/core/ResponseValidator.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/core/ResponseValidator.ts"],"sourcesContent":["/**\n * Response validator for agent responses\n *\n * Validates that agent responses match expected structures for both\n * MCP and A2A protocols, and validates data against AdCP schemas.\n */\n\nimport { z } from 'zod';\nimport { getBestUnionErrors } from '../utils/union-errors';\nimport { prepareResponseForSchemaValidation, TOOL_RESPONSE_SCHEMAS } from '../utils/response-schemas';\nimport { injectLegacyEnvelopeStatus } from '../utils/envelope-status-compat';\nimport { getLatestA2ADataPartFromResponse } from '../utils/a2a-artifacts';\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n  protocol?: 'mcp' | 'a2a' | 'unknown';\n  schemaErrors?: z.ZodIssue[];\n}\n\nexport interface ValidationOptions {\n  /** Enable strict mode - fail on warnings */\n  strict?: boolean;\n  /** Expected data fields (e.g., ['products'] for get_products) */\n  expectedFields?: string[];\n  /** Allow empty responses */\n  allowEmpty?: boolean;\n  /** Validate against AdCP Zod schemas */\n  validateSchema?: boolean;\n  /** Server-declared AdCP version for response-shape compatibility. */\n  responseAdcpVersion?: string;\n}\n\nexport class ResponseValidator {\n  /**\n   * Validate an agent response structure\n   */\n  validate(response: any, toolName?: string, options: ValidationOptions = {}): ValidationResult {\n    const errors: string[] = [];\n    const warnings: string[] = [];\n    let protocol: 'mcp' | 'a2a' | 'unknown' = 'unknown';\n\n    if (!response) {\n      errors.push('Response is null or undefined');\n      return { valid: false, errors, warnings, protocol };\n    }\n\n    // Detect protocol\n    // A2A responses have either result.artifacts or error at top level\n    if (response.result || response.error || response.jsonrpc) {\n      protocol = 'a2a';\n      this.validateA2AResponse(response, errors, warnings);\n    } else if (response.structuredContent || response.content) {\n      protocol = 'mcp';\n      this.validateMCPResponse(response, errors, warnings);\n    } else if (response.data) {\n      warnings.push('Response has data field but unknown protocol');\n    } else {\n      warnings.push('Response does not match MCP or A2A structure');\n    }\n\n    // Check for expected fields if provided\n    if (options.expectedFields && options.expectedFields.length > 0) {\n      this.validateExpectedFields(response, options.expectedFields, protocol, errors, warnings);\n    }\n\n    // Check for empty responses\n    if (!options.allowEmpty) {\n      this.validateNotEmpty(response, protocol, warnings);\n    }\n\n    // Schema validation if enabled\n    let schemaErrors: z.ZodIssue[] | undefined;\n    if (options.validateSchema !== false && toolName) {\n      const schemaResult = this.validateWithSchema(response, toolName, protocol, options.responseAdcpVersion);\n      if (schemaResult) {\n        schemaErrors = schemaResult.issues;\n\n        // Union schemas produce a single unhelpful \"(root): Invalid input\" error.\n        // Drill into variants to find the closest match's specific field errors.\n        const isUnionError =\n          schemaResult.issues.length === 1 &&\n          schemaResult.issues[0]?.code === 'invalid_union' &&\n          schemaResult.issues[0]?.path.length === 0;\n\n        if (isUnionError) {\n          const schema = this.getSchemaForTool(toolName);\n          const data = this.extractDataForValidation(response, protocol);\n          if (schema && data) {\n            const betterErrors = getBestUnionErrors(schema, data);\n            if (betterErrors && betterErrors.length > 0) {\n              betterErrors.forEach(v => {\n                errors.push(`Schema validation: ${v.path}: ${v.message}`);\n              });\n              return { valid: false, errors, warnings, protocol, schemaErrors };\n            }\n          }\n        }\n\n        schemaResult.issues.forEach(issue => {\n          const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';\n          errors.push(`Schema validation: ${path}: ${issue.message}`);\n        });\n      }\n    }\n\n    const valid = errors.length === 0 && (!options.strict || warnings.length === 0);\n    return { valid, errors, warnings, protocol, schemaErrors };\n  }\n\n  /**\n   * Validate MCP response structure\n   */\n  private validateMCPResponse(response: any, errors: string[], warnings: string[]): void {\n    // Check for error indicator\n    if (response.isError === true) {\n      errors.push('MCP response indicates error (isError: true)');\n    }\n\n    // Validate structuredContent if present\n    if (response.structuredContent) {\n      if (typeof response.structuredContent !== 'object') {\n        errors.push('MCP structuredContent must be an object');\n      }\n    }\n\n    // Validate content array if present\n    if (response.content) {\n      if (!Array.isArray(response.content)) {\n        errors.push('MCP content must be an array');\n      } else {\n        response.content.forEach((item: any, index: number) => {\n          if (!item.type) {\n            warnings.push(`MCP content[${index}] missing type field`);\n          }\n        });\n      }\n    }\n\n    // Should have either content or structuredContent\n    if (!response.content && !response.structuredContent) {\n      warnings.push('MCP response has neither content nor structuredContent');\n    }\n  }\n\n  /**\n   * Validate A2A response structure\n   */\n  private validateA2AResponse(response: any, errors: string[], warnings: string[]): void {\n    // Check for JSON-RPC error\n    if (response.error) {\n      const errorMsg = response.error.message || JSON.stringify(response.error);\n      errors.push(`A2A JSON-RPC error: ${errorMsg}`);\n      return;\n    }\n\n    // Validate result structure\n    if (!response.result) {\n      errors.push('A2A response missing result field');\n      return;\n    }\n\n    // Validate artifacts\n    if (!response.result.artifacts) {\n      errors.push('A2A response missing result.artifacts field');\n      return;\n    }\n\n    if (!Array.isArray(response.result.artifacts)) {\n      errors.push('A2A result.artifacts must be an array');\n      return;\n    }\n\n    if (response.result.artifacts.length === 0) {\n      warnings.push('A2A artifacts array is empty');\n      return;\n    }\n\n    // Validate latest artifact structure. A2A conversational tasks append\n    // artifacts over time, and the final artifact is authoritative.\n    const latestArtifact = response.result.artifacts[response.result.artifacts.length - 1];\n    if (!latestArtifact || typeof latestArtifact !== 'object') {\n      errors.push('A2A response must have at least one artifact');\n      return;\n    }\n\n    if (!latestArtifact.parts) {\n      errors.push('A2A artifact missing parts field');\n      return;\n    }\n\n    if (!Array.isArray(latestArtifact.parts)) {\n      errors.push('A2A artifact.parts must be an array');\n      return;\n    }\n\n    if (latestArtifact.parts.length === 0) {\n      warnings.push('A2A artifact parts array is empty');\n      return;\n    }\n\n    const hasDataPart = getLatestA2ADataPartFromResponse(response) !== undefined;\n    if (!hasDataPart) {\n      warnings.push('A2A artifact missing DataPart with data field');\n    }\n  }\n\n  /**\n   * Validate expected fields are present in the response\n   */\n  private validateExpectedFields(\n    response: any,\n    expectedFields: string[],\n    protocol: string,\n    errors: string[],\n    warnings: string[]\n  ): void {\n    let data: any;\n\n    // Extract data based on protocol\n    if (protocol === 'mcp') {\n      data = response.structuredContent;\n    } else if (protocol === 'a2a') {\n      data = getLatestA2ADataPartFromResponse(response)?.data;\n    } else {\n      data = response.data || response;\n    }\n\n    if (!data) {\n      errors.push('Cannot validate fields: no data extracted');\n      return;\n    }\n\n    // Check each expected field\n    expectedFields.forEach(field => {\n      if (!(field in data)) {\n        errors.push(`Missing expected field: ${field}`);\n      } else if (Array.isArray(data[field]) && data[field].length === 0) {\n        warnings.push(`Field ${field} is an empty array`);\n      }\n    });\n  }\n\n  /**\n   * Validate response is not empty\n   */\n  private validateNotEmpty(response: any, protocol: string, warnings: string[]): void {\n    if (protocol === 'mcp' && response.structuredContent) {\n      const keys = Object.keys(response.structuredContent);\n      if (keys.length === 0) {\n        warnings.push('MCP structuredContent is empty object');\n      }\n    }\n\n    if (protocol === 'a2a') {\n      const data = getLatestA2ADataPartFromResponse(response)?.data;\n      if (!data) return;\n      const keys = Object.keys(data);\n      if (keys.length === 0) {\n        warnings.push('A2A data is empty object');\n      }\n    }\n  }\n\n  /**\n   * Quick validation helper - returns true if valid, throws if invalid\n   */\n  validateOrThrow(response: any, toolName?: string, options: ValidationOptions = {}): void {\n    const result = this.validate(response, toolName, options);\n    if (!result.valid) {\n      const errorMsg = result.errors.join('; ');\n      throw new Error(`Response validation failed: ${errorMsg}`);\n    }\n  }\n\n  /**\n   * Check if a response looks like a valid protocol response\n   */\n  isValidProtocolResponse(response: any): boolean {\n    if (!response || typeof response !== 'object') {\n      return false;\n    }\n\n    // MCP indicators\n    if (response.structuredContent || response.content) {\n      return true;\n    }\n\n    // A2A indicators\n    if (response.result?.artifacts) {\n      return true;\n    }\n\n    // Generic data response\n    if (response.data) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Extract response data based on protocol for validation.\n   */\n  private extractDataForValidation(response: any, protocol: string): any {\n    if (protocol === 'mcp') {\n      return response.structuredContent;\n    } else if (protocol === 'a2a') {\n      return getLatestA2ADataPartFromResponse(response)?.data;\n    } else {\n      return response.data || response;\n    }\n  }\n\n  /**\n   * Validate response data against AdCP Zod schema\n   */\n  private validateWithSchema(\n    response: any,\n    toolName: string,\n    protocol: string,\n    responseAdcpVersion?: string\n  ): z.ZodError | null {\n    const data = this.extractDataForValidation(response, protocol);\n\n    if (!data) {\n      return null; // No data to validate\n    }\n\n    // Get schema for tool\n    const schema = this.getSchemaForTool(toolName);\n    if (!schema) {\n      return null; // No schema available for this tool\n    }\n\n    // 3.0.x back-compat: synthesize envelope `status` when the payload\n    // declares itself as 3.0.x. See `utils/envelope-status-compat.ts`.\n    const validatePayload =\n      data && typeof data === 'object' && !Array.isArray(data)\n        ? injectLegacyEnvelopeStatus(data as Record<string, unknown>, { toolName })\n        : data;\n\n    // Validate\n    const result = schema.safeParse(prepareResponseForSchemaValidation(toolName, validatePayload, responseAdcpVersion));\n    return result.success ? null : result.error;\n  }\n\n  /**\n   * Get Zod schema for a given tool\n   */\n  private getSchemaForTool(toolName: string): z.ZodSchema | null {\n    return TOOL_RESPONSE_SCHEMAS[toolName] || null;\n  }\n}\n\n// Export singleton instance\nexport const responseValidator = new ResponseValidator();\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/lib/core/ResponseValidator.ts"],"sourcesContent":["/**\n * Response validator for agent responses\n *\n * Validates that agent responses match expected structures for both\n * MCP and A2A protocols, and validates data against AdCP schemas.\n */\n\nimport { z } from 'zod';\nimport { getBestUnionErrors } from '../utils/union-errors';\nimport { prepareResponseForSchemaValidation, TOOL_RESPONSE_SCHEMAS } from '../utils/response-schemas';\nimport { injectLegacyEnvelopeStatus } from '../utils/envelope-status-compat';\nimport { getLatestA2ADataPartFromResponse } from '../utils/a2a-artifacts';\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n  protocol?: 'mcp' | 'a2a' | 'unknown';\n  schemaErrors?: z.ZodIssue[];\n}\n\nexport interface ValidationOptions {\n  /** Enable strict mode - fail on warnings */\n  strict?: boolean;\n  /** Expected data fields (e.g., ['products'] for get_products) */\n  expectedFields?: string[];\n  /** Allow empty responses */\n  allowEmpty?: boolean;\n  /** Validate against AdCP Zod schemas */\n  validateSchema?: boolean;\n  /** Server-declared AdCP version for response-shape compatibility. */\n  responseAdcpVersion?: string;\n}\n\nexport class ResponseValidator {\n  /**\n   * Validate an agent response structure\n   */\n  validate(response: any, toolName?: string, options: ValidationOptions = {}): ValidationResult {\n    const errors: string[] = [];\n    const warnings: string[] = [];\n    let protocol: 'mcp' | 'a2a' | 'unknown' = 'unknown';\n\n    if (!response) {\n      errors.push('Response is null or undefined');\n      return { valid: false, errors, warnings, protocol };\n    }\n\n    // Detect protocol\n    // A2A responses have either result.artifacts or error at top level\n    if (response.result || response.error || response.jsonrpc) {\n      protocol = 'a2a';\n      this.validateA2AResponse(response, errors, warnings);\n    } else if (response.structuredContent || response.content) {\n      protocol = 'mcp';\n      this.validateMCPResponse(response, errors, warnings);\n    } else if (response.data) {\n      warnings.push('Response has data field but unknown protocol');\n    } else {\n      warnings.push('Response does not match MCP or A2A structure');\n    }\n\n    // Check for expected fields if provided\n    if (options.expectedFields && options.expectedFields.length > 0) {\n      this.validateExpectedFields(response, options.expectedFields, protocol, errors, warnings);\n    }\n\n    // Check for empty responses\n    if (!options.allowEmpty) {\n      this.validateNotEmpty(response, protocol, warnings);\n    }\n\n    // Schema validation if enabled\n    let schemaErrors: z.ZodIssue[] | undefined;\n    if (options.validateSchema !== false && toolName) {\n      const schemaResult = this.validateWithSchema(response, toolName, protocol, options.responseAdcpVersion);\n      if (schemaResult) {\n        schemaErrors = schemaResult.issues;\n\n        // Union schemas produce a single unhelpful \"(root): Invalid input\" error.\n        // Drill into variants to find the closest match's specific field errors.\n        const isUnionError =\n          schemaResult.issues.length === 1 &&\n          schemaResult.issues[0]?.code === 'invalid_union' &&\n          schemaResult.issues[0]?.path.length === 0;\n\n        if (isUnionError) {\n          const schema = this.getSchemaForTool(toolName);\n          const data = this.extractDataForValidation(response, protocol);\n          if (schema && data) {\n            const betterErrors = getBestUnionErrors(schema, data);\n            if (betterErrors && betterErrors.length > 0) {\n              betterErrors.forEach(v => {\n                errors.push(`Schema validation: ${v.path}: ${v.message}`);\n              });\n              return { valid: false, errors, warnings, protocol, schemaErrors };\n            }\n          }\n        }\n\n        schemaResult.issues.forEach(issue => {\n          const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';\n          errors.push(`Schema validation: ${path}: ${issue.message}`);\n        });\n      }\n    }\n\n    const valid = errors.length === 0 && (!options.strict || warnings.length === 0);\n    return { valid, errors, warnings, protocol, schemaErrors };\n  }\n\n  /**\n   * Validate MCP response structure\n   */\n  private validateMCPResponse(response: any, errors: string[], warnings: string[]): void {\n    // Check for error indicator\n    if (response.isError === true) {\n      errors.push('MCP response indicates error (isError: true)');\n    }\n\n    // Validate structuredContent if present\n    if (response.structuredContent) {\n      if (typeof response.structuredContent !== 'object') {\n        errors.push('MCP structuredContent must be an object');\n      }\n    }\n\n    // Validate content array if present\n    if (response.content) {\n      if (!Array.isArray(response.content)) {\n        errors.push('MCP content must be an array');\n      } else {\n        response.content.forEach((item: any, index: number) => {\n          if (!item.type) {\n            warnings.push(`MCP content[${index}] missing type field`);\n          }\n        });\n      }\n    }\n\n    // Should have either content or structuredContent\n    if (!response.content && !response.structuredContent) {\n      warnings.push('MCP response has neither content nor structuredContent');\n    }\n  }\n\n  /**\n   * Validate A2A response structure\n   */\n  private validateA2AResponse(response: any, errors: string[], warnings: string[]): void {\n    // Check for JSON-RPC error\n    if (response.error) {\n      const errorMsg = response.error.message || JSON.stringify(response.error);\n      errors.push(`A2A JSON-RPC error: ${errorMsg}`);\n      return;\n    }\n\n    // Validate result structure\n    if (!response.result) {\n      errors.push('A2A response missing result field');\n      return;\n    }\n\n    // Validate artifacts\n    if (!response.result.artifacts) {\n      errors.push('A2A response missing result.artifacts field');\n      return;\n    }\n\n    if (!Array.isArray(response.result.artifacts)) {\n      errors.push('A2A result.artifacts must be an array');\n      return;\n    }\n\n    if (response.result.artifacts.length === 0) {\n      warnings.push('A2A artifacts array is empty');\n      return;\n    }\n\n    // Validate latest artifact structure. A2A conversational tasks append\n    // artifacts over time, and the final artifact is authoritative.\n    const latestArtifact = response.result.artifacts[response.result.artifacts.length - 1];\n    if (!latestArtifact || typeof latestArtifact !== 'object') {\n      errors.push('A2A response must have at least one artifact');\n      return;\n    }\n\n    if (!latestArtifact.parts) {\n      errors.push('A2A artifact missing parts field');\n      return;\n    }\n\n    if (!Array.isArray(latestArtifact.parts)) {\n      errors.push('A2A artifact.parts must be an array');\n      return;\n    }\n\n    if (latestArtifact.parts.length === 0) {\n      warnings.push('A2A artifact parts array is empty');\n      return;\n    }\n\n    const hasDataPart = getLatestA2ADataPartFromResponse(response) !== undefined;\n    if (!hasDataPart) {\n      warnings.push('A2A artifact missing DataPart with data field');\n    }\n  }\n\n  /**\n   * Validate expected fields are present in the response\n   */\n  private validateExpectedFields(\n    response: any,\n    expectedFields: string[],\n    protocol: string,\n    errors: string[],\n    warnings: string[]\n  ): void {\n    let data: any;\n\n    // Extract data based on protocol\n    if (protocol === 'mcp') {\n      data = response.structuredContent;\n    } else if (protocol === 'a2a') {\n      data = getLatestA2ADataPartFromResponse(response)?.data;\n    } else {\n      data = response.data || response;\n    }\n\n    if (!data) {\n      errors.push('Cannot validate fields: no data extracted');\n      return;\n    }\n\n    // Check each expected field\n    expectedFields.forEach(field => {\n      if (!(field in data)) {\n        errors.push(`Missing expected field: ${field}`);\n      } else if (Array.isArray(data[field]) && data[field].length === 0) {\n        warnings.push(`Field ${field} is an empty array`);\n      }\n    });\n  }\n\n  /**\n   * Validate response is not empty\n   */\n  private validateNotEmpty(response: any, protocol: string, warnings: string[]): void {\n    if (protocol === 'mcp' && response.structuredContent) {\n      const keys = Object.keys(response.structuredContent);\n      if (keys.length === 0) {\n        warnings.push('MCP structuredContent is empty object');\n      }\n    }\n\n    if (protocol === 'a2a') {\n      const data = getLatestA2ADataPartFromResponse(response)?.data;\n      if (!data) return;\n      const keys = Object.keys(data);\n      if (keys.length === 0) {\n        warnings.push('A2A data is empty object');\n      }\n    }\n  }\n\n  /**\n   * Quick validation helper - returns true if valid, throws if invalid\n   */\n  validateOrThrow(response: any, toolName?: string, options: ValidationOptions = {}): void {\n    const result = this.validate(response, toolName, options);\n    if (!result.valid) {\n      const errorMsg = result.errors.join('; ');\n      throw new Error(`Response validation failed: ${errorMsg}`);\n    }\n  }\n\n  /**\n   * Check if a response looks like a valid protocol response\n   */\n  isValidProtocolResponse(response: any): boolean {\n    if (!response || typeof response !== 'object') {\n      return false;\n    }\n\n    // MCP indicators\n    if (response.structuredContent || response.content) {\n      return true;\n    }\n\n    // A2A indicators\n    if (response.result?.artifacts) {\n      return true;\n    }\n\n    // Generic data response\n    if (response.data) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Extract response data based on protocol for validation.\n   */\n  private extractDataForValidation(response: any, protocol: string): any {\n    if (protocol === 'mcp') {\n      return response.structuredContent;\n    } else if (protocol === 'a2a') {\n      return getLatestA2ADataPartFromResponse(response)?.data;\n    } else {\n      return response.data || response;\n    }\n  }\n\n  /**\n   * Validate response data against AdCP Zod schema\n   */\n  private validateWithSchema(\n    response: any,\n    toolName: string,\n    protocol: string,\n    responseAdcpVersion?: string\n  ): z.ZodError | null {\n    const data = this.extractDataForValidation(response, protocol);\n\n    if (!data) {\n      return null; // No data to validate\n    }\n\n    // Get schema for tool\n    const schema = this.getSchemaForTool(toolName);\n    if (!schema) {\n      return null; // No schema available for this tool\n    }\n\n    // 3.0.x back-compat: synthesize envelope `status` when the payload\n    // declares itself as 3.0.x. See `utils/envelope-status-compat.ts`.\n    const validatePayload =\n      data && typeof data === 'object' && !Array.isArray(data)\n        ? injectLegacyEnvelopeStatus(data as Record<string, unknown>, { toolName })\n        : data;\n\n    // Validate\n    const result = schema.safeParse(prepareResponseForSchemaValidation(toolName, validatePayload, responseAdcpVersion));\n    return result.success ? null : result.error;\n  }\n\n  /**\n   * Get Zod schema for a given tool\n   */\n  private getSchemaForTool(toolName: string): z.ZodSchema | null {\n    return TOOL_RESPONSE_SCHEMAS[toolName] || null;\n  }\n}\n\n// Export singleton instance\nexport const responseValidator = new ResponseValidator();\n"],"mappings":"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","names":[]}

package/dist/lib/core/SingleAgentClient.mjs

@@ -1,9 +1,3 @@
-import { fileURLToPath as __adcpFileURLToPath } from 'node:url';
-import { dirname as __adcpDirname } from 'node:path';
-import { createRequire as __adcpCreateRequire } from 'node:module';
-const __filename = __adcpFileURLToPath(import.meta.url);
-const __dirname = __adcpDirname(__filename);
-const require = __adcpCreateRequire(import.meta.url);
 import { z } from "zod";
 import * as schemas from "../types/schemas.generated.mjs";
 import { ADCP_ENVELOPE_FIELDS } from "../types/adcp.mjs";