@adcp/sdk 12.0.0 → 12.0.1

package/dist/lib/enums.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/enums.ts"],"sourcesContent":["// Lean, zero-dependency entry point for AdCP enum value arrays.\n//\n// Both re-exported modules are pure `as const` string-literal arrays with no\n// imports (codegen output), so importing from `@adcp/sdk/enums` pulls in only\n// the arrays a consumer names: no `./types` barrel, no zod. This is the safe\n// entry for zod-free consumers (e.g. browser bundles) that want an AdCP enum\n// as their single source of truth.\n//\n//   import { EventTypeValues } from '@adcp/sdk/enums';\n//\n// enums.generated exposes `NameValues` arrays for named string-literal unions;\n// inline-enums.generated exposes `Parent_PropertyValues` arrays for anonymous\n// per-field unions.\nexport * from './types/enums.generated';\nexport * from './types/inline-enums.generated';\n"],"mappings":";;;;;;AAaA,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../../src/lib/enums.ts"],"sourcesContent":["// Lean, zero-dependency entry point for AdCP enum value arrays.\n//\n// Both re-exported modules are pure `as const` string-literal arrays with no\n// imports (codegen output), so importing from `@adcp/sdk/enums` pulls in only\n// the arrays a consumer names: no `./types` barrel, no zod. This is the safe\n// entry for zod-free consumers (e.g. browser bundles) that want an AdCP enum\n// as their single source of truth.\n//\n//   import { EventTypeValues } from '@adcp/sdk/enums';\n//\n// enums.generated exposes `NameValues` arrays for named string-literal unions;\n// inline-enums.generated exposes `Parent_PropertyValues` arrays for anonymous\n// per-field unions.\nexport * from './types/enums.generated';\nexport * from './types/inline-enums.generated';\n"],"mappings":"AAaA,cAAc;AACd,cAAc;","names":[]}

package/dist/lib/errors/index.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);
 class ADCPError extends Error {
   constructor(message, details) {
     super(message);

package/dist/lib/errors/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/errors/index.ts"],"sourcesContent":["// Custom error classes for ADCP client library\n\n/**\n * Base class for all ADCP client errors\n */\nexport abstract class ADCPError extends Error {\n  abstract readonly code: string;\n\n  constructor(\n    message: string,\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = this.constructor.name;\n  }\n}\n\n/**\n * Error thrown when a task times out\n */\nexport class TaskTimeoutError extends ADCPError {\n  readonly code = 'TASK_TIMEOUT';\n\n  constructor(\n    public readonly taskId: string,\n    public readonly timeout: number\n  ) {\n    super(`Task ${taskId} timed out after ${timeout}ms`);\n  }\n}\n\n/**\n * Error thrown when maximum clarification attempts are exceeded\n */\nexport class MaxClarificationError extends ADCPError {\n  readonly code = 'MAX_CLARIFICATIONS';\n\n  constructor(\n    public readonly taskId: string,\n    public readonly maxAttempts: number\n  ) {\n    super(`Task ${taskId} exceeded maximum clarification attempts: ${maxAttempts}`);\n  }\n}\n\n/**\n * Error thrown when a task is deferred to human\n * Contains the token needed to resume the task\n */\nexport class DeferredTaskError extends ADCPError {\n  readonly code = 'TASK_DEFERRED';\n\n  constructor(public readonly token: string) {\n    super(`Task deferred with token: ${token}`);\n  }\n}\n\n/**\n * Error thrown when a task is aborted\n */\nexport class TaskAbortedError extends ADCPError {\n  readonly code = 'TASK_ABORTED';\n\n  constructor(\n    public readonly taskId: string,\n    public readonly reason?: string\n  ) {\n    super(`Task ${taskId} aborted: ${reason || 'No reason provided'}`);\n  }\n}\n\n/**\n * Error thrown when an agent is not found\n */\nexport class AgentNotFoundError extends ADCPError {\n  readonly code = 'AGENT_NOT_FOUND';\n\n  constructor(\n    public readonly agentId: string,\n    public readonly availableAgents: string[]\n  ) {\n    super(`Agent '${agentId}' not found. Available agents: ${availableAgents.join(', ')}`);\n  }\n}\n\n/**\n * Error thrown when an agent doesn't support a task\n */\nexport class UnsupportedTaskError extends ADCPError {\n  readonly code = 'UNSUPPORTED_TASK';\n\n  constructor(\n    public readonly agentId: string,\n    public readonly taskName: string,\n    public readonly supportedTasks?: string[]\n  ) {\n    const tasksMsg = supportedTasks ? ` Supported tasks: ${supportedTasks.join(', ')}` : '';\n    super(`Agent '${agentId}' does not support task '${taskName}'.${tasksMsg}`);\n  }\n}\n\n/**\n * Error thrown when protocol communication fails\n */\nexport class ProtocolError extends ADCPError {\n  readonly code = 'PROTOCOL_ERROR';\n\n  constructor(\n    public readonly protocol: 'mcp' | 'a2a',\n    message: string,\n    public readonly originalError?: Error\n  ) {\n    super(`${protocol.toUpperCase()} protocol error: ${message}`);\n    this.details = { originalError };\n  }\n}\n\n/**\n * Error thrown when validation fails\n */\nexport class ValidationError extends ADCPError {\n  readonly code = 'VALIDATION_ERROR';\n\n  constructor(\n    public readonly field: string,\n    public readonly value: unknown,\n    public readonly constraint: string\n  ) {\n    super(`Validation failed for field '${field}': ${constraint}`);\n    this.details = { field, value, constraint };\n  }\n}\n\n/**\n * Error thrown when input handler is missing but required\n */\nexport class MissingInputHandlerError extends ADCPError {\n  readonly code = 'MISSING_INPUT_HANDLER';\n\n  constructor(\n    public readonly taskId: string,\n    public readonly question: string\n  ) {\n    super(`Agent requested input but no handler provided. Task: ${taskId}, Question: ${question}`);\n  }\n}\n\n/**\n * Error thrown when conversation context is invalid\n */\nexport class InvalidContextError extends ADCPError {\n  readonly code = 'INVALID_CONTEXT';\n\n  constructor(\n    public readonly contextId: string,\n    reason: string\n  ) {\n    super(`Invalid conversation context '${contextId}': ${reason}`);\n  }\n}\n\n/**\n * Error thrown when configuration is invalid\n */\nexport class ConfigurationError extends ADCPError {\n  readonly code = 'CONFIGURATION_ERROR';\n\n  constructor(\n    message: string,\n    public readonly configField?: string\n  ) {\n    super(`Configuration error: ${message}`);\n    this.details = { configField };\n  }\n}\n\n/**\n * OAuth metadata for authentication guidance\n */\nexport interface OAuthMetadataInfo {\n  /** URL of the authorization endpoint */\n  authorization_endpoint: string;\n  /** URL of the token endpoint */\n  token_endpoint: string;\n  /** URL of the dynamic client registration endpoint (optional) */\n  registration_endpoint?: string;\n  /** Issuer identifier */\n  issuer?: string;\n}\n\n/**\n * Subset of the parsed `WWW-Authenticate` challenge surfaced on\n * {@link AuthenticationRequiredError}. Mirrors the public shape of\n * `WWWAuthenticateChallenge` from `@adcp/sdk/auth/oauth` without forcing the\n * errors module to depend on the auth subtree (the dependency would invert\n * the build graph).\n *\n * `scheme` is lowercased per RFC 9110 §11.6.1.\n */\nexport interface AuthChallengeInfo {\n  scheme: string;\n  realm?: string;\n  scope?: string;\n  error?: string;\n  error_description?: string;\n}\n\n/**\n * Error thrown when authentication is required to access an MCP endpoint\n *\n * This error is thrown during MCP endpoint discovery when the server returns\n * a 401 Unauthorized response. The shape of the remediation depends on what\n * the 401 disclosed:\n *\n * - OAuth metadata (RFC 9728 PRM walk succeeded) → `oauthMetadata` set,\n *   message points at the authorization endpoint.\n * - A `WWW-Authenticate` challenge with a non-Bearer scheme (e.g. Basic\n *   behind an Apigee/Kong/AWS API GW gateway) → `challenge` set, message\n *   names the scheme and the SDK / CLI surface that configures it.\n * - Plain 401 with no metadata → fallback \"provide auth_token\" message.\n *\n * Consumers branching on `error.challenge?.scheme === 'basic'` can route\n * straight to `auth: { type: 'basic', username, password }` instead of\n * retrying Bearer indefinitely.\n *\n * @example\n * ```typescript\n * try {\n *   await client.getProducts({ brief: 'test' });\n * } catch (error) {\n *   if (error instanceof AuthenticationRequiredError) {\n *     if (error.challenge?.scheme === 'basic') {\n *       // Gateway-fronted agent — configure HTTP Basic\n *       reconnect({ auth: { type: 'basic', username, password } });\n *     } else if (error.oauthMetadata) {\n *       // Redirect user to OAuth flow\n *       const authUrl = error.oauthMetadata.authorization_endpoint;\n *       console.log(`Please authenticate at: ${authUrl}`);\n *     } else {\n *       console.log('Authentication required but no scheme metadata available');\n *     }\n *   }\n * }\n * ```\n */\nexport class AuthenticationRequiredError extends ADCPError {\n  readonly code = 'AUTHENTICATION_REQUIRED';\n\n  constructor(\n    public readonly agentUrl: string,\n    public readonly oauthMetadata?: OAuthMetadataInfo,\n    message?: string,\n    public readonly challenge?: AuthChallengeInfo\n  ) {\n    const defaultMessage = buildAuthRequiredMessage(agentUrl, oauthMetadata, challenge);\n    super(message || defaultMessage);\n    // `details` is serialized through error envelopes; surfacing the challenge\n    // here lets non-CLI consumers (LLM agents, dashboards, programmatic\n    // callers) branch on the scheme without instanceof-checking.\n    this.details = { agentUrl, oauthMetadata, challenge };\n  }\n\n  /**\n   * Check if OAuth authentication is available\n   */\n  get hasOAuth(): boolean {\n    return this.oauthMetadata !== undefined;\n  }\n\n  /**\n   * Get the authorization URL if OAuth is available\n   */\n  get authorizationUrl(): string | undefined {\n    return this.oauthMetadata?.authorization_endpoint;\n  }\n\n  /**\n   * Lowercased scheme from the `WWW-Authenticate` challenge, when present.\n   * `'basic'` is the common non-OAuth case — gateway-fronted agents speaking\n   * RFC 7617.\n   */\n  get suggestedScheme(): string | undefined {\n    return this.challenge?.scheme;\n  }\n}\n\n/**\n * Build the default error message. Branches on what the 401 disclosed:\n * - non-Bearer challenge (Basic, Digest, …) → scheme-specific remediation\n * - OAuth metadata → point at the authorization endpoint\n * - nothing → fallback \"provide auth_token\"\n *\n * The Basic branch names both the SDK shape (`createTestClient({ auth: …\n * type: 'basic' })`) and the CLI shape (`--auth user:pass --auth-scheme\n * basic`) so the same error envelope serves library and CLI consumers.\n */\nfunction buildAuthRequiredMessage(\n  agentUrl: string,\n  oauthMetadata: OAuthMetadataInfo | undefined,\n  challenge: AuthChallengeInfo | undefined\n): string {\n  if (challenge && challenge.scheme !== 'bearer') {\n    if (challenge.scheme === 'basic') {\n      return (\n        `Authentication required for ${agentUrl}. Agent (or its fronting gateway) speaks HTTP Basic ` +\n        `(RFC 7617). Configure via createTestClient({ auth: { type: 'basic', username, password } }) ` +\n        `— or from the CLI, --auth <user:pass> --auth-scheme basic.`\n      );\n    }\n    // Digest / Negotiate / NTLM / vendor schemes: we don't have first-class\n    // support but the scheme name in the message saves a discovery round-trip.\n    const realmHint = challenge.realm ? ` (realm: ${challenge.realm})` : '';\n    return (\n      `Authentication required for ${agentUrl}. Agent speaks ${challenge.scheme}${realmHint}, ` +\n      `which is not natively supported by @adcp/sdk. Configure auth at the transport layer ` +\n      `(custom fetch wrapper, reverse-proxy header injection) or contact the agent operator ` +\n      `about Bearer / Basic / OAuth support.`\n    );\n  }\n  if (oauthMetadata) {\n    return `Authentication required for ${agentUrl}. OAuth available at: ${oauthMetadata.authorization_endpoint}`;\n  }\n  return `Authentication required for ${agentUrl}. No OAuth metadata available - provide auth_token in agent config.`;\n}\n\n/**\n * Error thrown when a request reused an `idempotency_key` with a different\n * canonical payload within the seller's replay window.\n *\n * Recovery: `correctable` — the caller either reused a key by mistake (mint\n * a fresh UUID v4 for the new request) or re-planned with a different payload\n * (an agent whose LLM re-ran and emitted a different request must treat that\n * as a new intent, not a retry).\n *\n * @example\n * ```typescript\n * try {\n *   await client.createMediaBuy({...});\n * } catch (error) {\n *   if (error instanceof IdempotencyConflictError) {\n *     // Either the key was reused by mistake, or the agent re-planned with\n *     // a different payload. Mint a fresh key and try again.\n *   }\n * }\n * ```\n */\nexport class IdempotencyConflictError extends ADCPError {\n  readonly code = 'IDEMPOTENCY_CONFLICT';\n\n  // Exposed via the getter so `console.log(err)` and JSON.stringify don't\n  // leak the key (it's a retry-pattern oracle within the seller's TTL).\n  // Callers reading `err.idempotencyKey` get it normally.\n  readonly idempotencyKey: string | undefined;\n\n  constructor(idempotencyKey: string | undefined, message?: string) {\n    super(\n      message ||\n        'idempotency_key was used earlier with a different canonical payload. ' +\n          'Use a fresh UUID v4 for the new request, or resend the exact original payload to get the cached response.'\n    );\n    Object.defineProperty(this, 'idempotencyKey', {\n      value: idempotencyKey,\n      enumerable: false,\n      writable: false,\n      configurable: false,\n    });\n  }\n}\n\n/**\n * Error thrown when a request carries an `idempotency_key` that is past the\n * seller's declared replay window (plus clock-skew tolerance).\n *\n * Recovery: `correctable`. If the caller knows the prior call succeeded\n * (e.g., they saw the response once, then crashed), they SHOULD fall back\n * to a natural-key lookup (e.g., `get_media_buys` by\n * `context.internal_campaign_id`) rather than minting a new key — otherwise\n * the seller treats the new request as fresh and silently creates a duplicate.\n *\n * If the caller doesn't know whether the prior call succeeded, a fresh key\n * is safe.\n */\nexport class IdempotencyExpiredError extends ADCPError {\n  readonly code = 'IDEMPOTENCY_EXPIRED';\n\n  // Non-enumerable so `console.log(err)` / JSON.stringify don't leak it —\n  // same reasoning as IdempotencyConflictError.idempotencyKey.\n  readonly idempotencyKey: string | undefined;\n\n  constructor(idempotencyKey: string | undefined, message?: string) {\n    super(\n      message ||\n        \"idempotency_key is past the seller's replay window. \" +\n          'If you know the prior call succeeded, look up the resource by natural key before retrying. Otherwise, mint a fresh UUID v4.'\n    );\n    Object.defineProperty(this, 'idempotencyKey', {\n      value: idempotencyKey,\n      enumerable: false,\n      writable: false,\n      configurable: false,\n    });\n  }\n}\n\nexport interface FeatureUnsupportedErrorOptions {\n  message?: string;\n  details?: Record<string, unknown>;\n}\n\nexport type ClientPreflightAdcpErrorRecovery = 'transient' | 'correctable' | 'terminal';\n\n/**\n * Protocol-shaped error metadata attached to SDK-local preflight throws.\n * Mirrors the public `TaskResult.adcpError` fields without importing core\n * task types into the errors module.\n */\nexport interface ClientPreflightAdcpErrorInfo {\n  code: string;\n  message: string;\n  recovery?: ClientPreflightAdcpErrorRecovery;\n  field?: string;\n  suggestion?: string;\n  details?: Record<string, unknown>;\n}\n\nexport interface ProtocolFeatureUnsupportedErrorOptions extends FeatureUnsupportedErrorOptions {\n  field?: string;\n  suggestion?: string;\n  recovery?: ClientPreflightAdcpErrorRecovery;\n}\n\nexport const SDK_ERROR_TO_PROTOCOL_ERROR_CODE = {\n  FEATURE_UNSUPPORTED: 'UNSUPPORTED_FEATURE',\n} as const;\n\nexport function mapSdkErrorCodeToProtocolErrorCode(code: string): string | undefined {\n  return SDK_ERROR_TO_PROTOCOL_ERROR_CODE[code as keyof typeof SDK_ERROR_TO_PROTOCOL_ERROR_CODE];\n}\n\n/**\n * Error thrown when a required feature is not supported by the seller or by\n * the configured AdCP version.\n */\nexport class FeatureUnsupportedError extends ADCPError {\n  readonly code: string = 'FEATURE_UNSUPPORTED';\n\n  constructor(\n    public readonly unsupportedFeatures: string[],\n    public readonly declaredFeatures: string[],\n    public readonly agentUrl?: string,\n    options: FeatureUnsupportedErrorOptions = {}\n  ) {\n    const missing = unsupportedFeatures.join(', ');\n    const declared = declaredFeatures.length > 0 ? declaredFeatures.join(', ') : '(none)';\n    const urlPart = agentUrl ? ` at ${agentUrl}` : '';\n    super(options.message ?? `Seller${urlPart} does not support: ${missing}\\n  Declared features: ${declared}`);\n    this.details = {\n      unsupported_features: unsupportedFeatures,\n      declared_features: declaredFeatures,\n      ...(options.details ?? {}),\n    };\n  }\n}\n\n/**\n * Version-gate error for requests that use a protocol feature outside the\n * configured AdCP release. Kept as a FeatureUnsupportedError subclass so\n * existing catch sites keep working, while `code` carries the AdCP wire code\n * expected by probe/recovery layers.\n */\nexport class ProtocolFeatureUnsupportedError extends FeatureUnsupportedError {\n  readonly code: string = 'UNSUPPORTED_FEATURE';\n\n  readonly adcpError: ClientPreflightAdcpErrorInfo;\n\n  constructor(\n    unsupportedFeatures: string[],\n    declaredFeatures: string[],\n    agentUrl?: string,\n    options: ProtocolFeatureUnsupportedErrorOptions = {}\n  ) {\n    super(unsupportedFeatures, declaredFeatures, agentUrl, options);\n    this.adcpError = {\n      code: this.code,\n      message: this.message,\n      recovery: options.recovery ?? 'correctable',\n      ...(options.field && { field: options.field }),\n      ...(options.suggestion && { suggestion: options.suggestion }),\n      ...(isRecord(this.details) && { details: this.details }),\n    };\n  }\n}\n\nexport function getClientPreflightAdcpError(error: unknown): ClientPreflightAdcpErrorInfo | undefined {\n  if (error instanceof ProtocolFeatureUnsupportedError) {\n    return error.adcpError;\n  }\n  return undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Error thrown when a response body exceeds the configured `maxResponseBytes`\n * cap on the transport. Surfaced when crawling untrusted agents (registries,\n * federated discovery layers) to prevent a hostile vendor from buffering a\n * large reply before schema validation runs.\n *\n * Recovery: `terminal` from the SDK's view — repeating the call against the\n * same agent will hit the same cap. The buyer's options are to widen the\n * cap (per-call `transport.maxResponseBytes`) when the agent's payload is\n * legitimately large, or to flag the agent as misbehaving.\n */\nexport class ResponseTooLargeError extends ADCPError {\n  readonly code = 'RESPONSE_TOO_LARGE';\n\n  constructor(\n    public readonly limit: number,\n    public readonly bytesRead: number,\n    public readonly url: string,\n    /**\n     * The parsed value of the `Content-Length` response header when the cap\n     * was tripped on the pre-check (before any body bytes were read). Undefined\n     * when the response was streamed and exceeded the cap mid-flight, or when\n     * the server omitted the header.\n     */\n    public readonly contentLengthHeader?: number\n  ) {\n    super(\n      contentLengthHeader !== undefined\n        ? `Response body declared ${contentLengthHeader} bytes, exceeds maxResponseBytes cap of ${limit} (${url})`\n        : `Response body exceeded maxResponseBytes cap of ${limit} after reading ${bytesRead} bytes (${url})`\n    );\n    this.details = { limit, bytesRead, url, contentLengthHeader };\n  }\n}\n\n/**\n * Error thrown when an `update_media_buy` request is rejected because the\n * action it maps to isn't currently allowed on the buy (AdCP 3.1, RFC #4480).\n *\n * Typed `details` payload follows `error-details/action-not-allowed.json`:\n * `attempted_action`, `reason`, optional `currently_available_actions[]`.\n *\n * Recovery branches on `reason`:\n *  - `wrong_status`: transition the buy (or wait) to an allowed status.\n *  - `not_supported_on_product`: terminal for this buy; pick a different\n *    product for future buys that need the action.\n *  - `not_supported_on_buy`: terminal; renegotiate buy terms.\n *  - `mode_mismatch`: `recovery` is set to a typed hint indicating the\n *    required flow (`createProposal`, `waitForApproval`, `reissueAsDirect`)\n *    instead of a plain retry.\n */\nexport class ActionNotAllowedError extends ADCPError {\n  readonly code = 'ACTION_NOT_ALLOWED';\n\n  readonly attemptedAction: ActionNotAllowedErrorDetails['attempted_action'];\n  readonly reason: ActionNotAllowedErrorDetails['reason'];\n  readonly currentlyAvailableActions: ReadonlyArray<ActionNotAllowedAvailableAction>;\n  readonly recovery?: ActionNotAllowedRecovery;\n\n  constructor(detailsPayload: ActionNotAllowedErrorDetails, message?: string) {\n    super(message ?? buildActionNotAllowedMessage(detailsPayload));\n    this.attemptedAction = detailsPayload.attempted_action;\n    this.reason = detailsPayload.reason;\n    this.currentlyAvailableActions = detailsPayload.currently_available_actions ?? [];\n    this.recovery = detailsPayload.reason === 'mode_mismatch' ? buildModeMismatchRecovery(detailsPayload) : undefined;\n    this.details = detailsPayload;\n  }\n}\n\n/**\n * Inline copy of the structured payload - duplicated here rather than\n * imported from `media-buy/types` to keep the errors module free of\n * cross-module imports (matches the convention used for the other typed\n * errors in this file).\n */\nexport interface ActionNotAllowedErrorDetails {\n  attempted_action: ActionNotAllowedAttemptedAction;\n  reason: ActionNotAllowedReasonValue;\n  currently_available_actions?: ActionNotAllowedAvailableAction[];\n}\n\nexport type ActionNotAllowedReasonValue =\n  | 'wrong_status'\n  | 'not_supported_on_product'\n  | 'not_supported_on_buy'\n  | 'mode_mismatch';\n\nexport type ActionNotAllowedAttemptedAction = string;\n\nexport interface ActionNotAllowedAvailableAction {\n  action: ActionNotAllowedAttemptedAction;\n  mode: 'self_serve' | 'conditional_self_serve' | 'requires_proposal' | 'requires_approval';\n  sla?: unknown;\n  terms_ref?: string;\n}\n\nexport type ActionNotAllowedRecovery =\n  | { kind: 'createProposal'; message: string }\n  | { kind: 'waitForApproval'; message: string }\n  | { kind: 'reissueAsDirect'; message: string };\n\nfunction buildActionNotAllowedMessage(details: ActionNotAllowedErrorDetails): string {\n  const prefix = `update_media_buy rejected: \\`${details.attempted_action}\\` not allowed (${details.reason}).`;\n  switch (details.reason) {\n    case 'wrong_status':\n      return `${prefix} transition the buy to an allowed status before retrying.`;\n    case 'not_supported_on_product':\n      return `${prefix} product does not declare this action; pick a different product for future buys needing it.`;\n    case 'not_supported_on_buy':\n      return `${prefix} buy was negotiated without this capability; renegotiate buy terms.`;\n    case 'mode_mismatch':\n      return `${prefix} mode shifted between preflight and dispatch; re-issue through the appropriate flow indicated by available_actions.`;\n  }\n}\n\nfunction buildModeMismatchRecovery(details: ActionNotAllowedErrorDetails): ActionNotAllowedRecovery | undefined {\n  const match = details.currently_available_actions?.find(a => a.action === details.attempted_action);\n  if (!match) return undefined;\n  switch (match.mode) {\n    case 'requires_proposal':\n      return {\n        kind: 'createProposal',\n        message:\n          `seller now resolves \\`${details.attempted_action}\\` as requires_proposal. ` +\n          'reissue via the proposal lifecycle (`create_proposal` / `finalize_proposal`).',\n      };\n    case 'requires_approval':\n      return {\n        kind: 'waitForApproval',\n        message:\n          `seller now resolves \\`${details.attempted_action}\\` as requires_approval. ` +\n          'expect an async approval callback rather than a direct response.',\n      };\n    case 'conditional_self_serve':\n      return {\n        kind: 'reissueAsDirect',\n        message:\n          `seller resolves \\`${details.attempted_action}\\` as conditional_self_serve: ` +\n          'small mutations clear automatically, larger ones queue. retry; expect a possible async escalation.',\n      };\n    case 'self_serve':\n      return {\n        kind: 'reissueAsDirect',\n        message: `seller resolves \\`${details.attempted_action}\\` as self_serve. retry the same request.`,\n      };\n  }\n}\n\n/**\n * Reason the v3 guard refused a mutating dispatch.\n * - `version`: seller's `major_versions` does not include 3\n * - `idempotency`: seller reports v3 but omits the required\n *   `adcp.idempotency.replay_ttl_seconds` declaration\n * - `synthetic`: @deprecated — kept in the union for downstream\n *   consumers that pattern-match on the union literal, but the SDK no\n *   longer emits it. Sellers whose capabilities are synthesized from\n *   `tools/list` are routed through the v2 adapter with a one-time\n *   warning; gate retry behavior on `SingleAgentClient.isSyntheticV2()`.\n */\nexport type VersionUnsupportedReason =\n  | 'version'\n  | 'idempotency'\n  /** @deprecated SDK no longer emits this reason. See union JSDoc. */\n  | 'synthetic';\n\n/**\n * Error thrown when a mutating call would dispatch to a seller whose\n * capabilities cannot be corroborated as v3. Provides an explicit\n * pre-flight signal so callers don't silently mutate state on agents\n * that have not negotiated the expected major version.\n *\n * Agent URL is exposed on the instance (`agentUrl`) but omitted from the\n * default message to avoid leaking seller identity into shared log sinks.\n */\nexport class VersionUnsupportedError extends ADCPError {\n  readonly code = 'VERSION_UNSUPPORTED';\n\n  constructor(\n    public readonly taskType: string,\n    public readonly reason: VersionUnsupportedReason,\n    public readonly actualVersion: 'v2' | 'v3',\n    public readonly agentUrl?: string\n  ) {\n    super(\n      `Refusing to dispatch mutating task '${taskType}': ` +\n        VersionUnsupportedError.explain(reason, actualVersion) +\n        ` Pass allowV2: true or requireV3ForMutations: false to override.`\n    );\n  }\n\n  private static explain(reason: VersionUnsupportedReason, actualVersion: 'v2' | 'v3'): string {\n    switch (reason) {\n      case 'version':\n        return `seller advertises major version '${actualVersion}' but v3 is required.`;\n      case 'idempotency':\n        return `seller reports v3 but omits adcp.idempotency.replay_ttl_seconds (required by spec).`;\n      case 'synthetic':\n        return `capabilities were synthesized from a tool list, v3 claim is unverifiable.`;\n    }\n  }\n}\n\n/**\n * Check if an error indicates a 401 Unauthorized response\n *\n * This helper centralizes the fragile logic of detecting 401 errors from\n * various sources (HTTP status codes, error messages, wrapped errors).\n * Used during endpoint discovery to detect authentication requirements.\n *\n * @param error - The error to check\n * @param got401Flag - Optional flag that was set by tracking HTTP responses\n * @returns true if the error appears to be a 401 authentication error\n */\nexport function is401Error(error: unknown, got401Flag = false): boolean {\n  if (got401Flag) {\n    return true;\n  }\n\n  if (!error) {\n    return false;\n  }\n\n  // Check for status property (common in HTTP errors). MCP SDK's\n  // `StreamableHTTPClientTransport` throws errors with the HTTP status on\n  // `.code`, so we check that too.\n  const errorObj = error as Record<string, unknown>;\n  const status =\n    (errorObj as { status?: number })?.status ||\n    (errorObj as { response?: { status?: number } })?.response?.status ||\n    (errorObj as { cause?: { status?: number } })?.cause?.status ||\n    (errorObj as { code?: unknown })?.code;\n  if (status === 401) {\n    return true;\n  }\n\n  // Fall back to string matching in error message. Use word boundaries so\n  // we don't misidentify things like \"product prod-401-xyz\" as an HTTP 401,\n  // and require \"Unauthorized\" as a whole word rather than as a substring.\n  const message = (errorObj as { message?: string })?.message || '';\n  return /\\b401\\b/.test(message) || /\\bunauthorized\\b/i.test(message);\n}\n\n/**\n * Map a structured AdCP error (code + message) to a typed ADCPError subclass\n * when the code has a dedicated class. Returns `undefined` for codes that\n * don't have a typed mapping — callers should continue to use the untyped\n * `AdcpErrorInfo` for those.\n *\n * Pass the `idempotencyKey` the SDK sent so the constructed error carries it\n * for the caller's recovery logic. The server intentionally omits the key\n * from error bodies (it's a read-oracle), so the transport-layer caller is\n * the authoritative source.\n */\nexport function adcpErrorToTypedError(\n  adcpError: { code: string; message?: string; details?: unknown },\n  idempotencyKey?: string\n): ADCPError | undefined {\n  switch (adcpError.code) {\n    case 'IDEMPOTENCY_CONFLICT':\n      return new IdempotencyConflictError(idempotencyKey, adcpError.message);\n    case 'IDEMPOTENCY_EXPIRED':\n      return new IdempotencyExpiredError(idempotencyKey, adcpError.message);\n    case 'ACTION_NOT_ALLOWED': {\n      const parsed = parseActionNotAllowedDetails(adcpError.details);\n      if (!parsed) return undefined;\n      return new ActionNotAllowedError(parsed, adcpError.message);\n    }\n    default:\n      return undefined;\n  }\n}\n\nfunction parseActionNotAllowedDetails(raw: unknown): ActionNotAllowedErrorDetails | undefined {\n  if (!raw || typeof raw !== 'object') return undefined;\n  const obj = raw as Record<string, unknown>;\n  const attempted = obj['attempted_action'];\n  const reason = obj['reason'];\n  if (typeof attempted !== 'string' || typeof reason !== 'string') return undefined;\n  if (!isActionNotAllowedReason(reason)) return undefined;\n\n  const rawList = obj['currently_available_actions'];\n  let currently: ActionNotAllowedAvailableAction[] | undefined;\n  if (Array.isArray(rawList)) {\n    currently = [];\n    for (const entry of rawList) {\n      if (!entry || typeof entry !== 'object') continue;\n      const e = entry as Record<string, unknown>;\n      const action = e['action'];\n      const mode = e['mode'];\n      if (typeof action !== 'string' || typeof mode !== 'string') continue;\n      if (!isActionMode(mode)) continue;\n      const parsedEntry: ActionNotAllowedAvailableAction = { action, mode };\n      if (typeof e['terms_ref'] === 'string') parsedEntry.terms_ref = e['terms_ref'];\n      if (e['sla'] !== undefined) parsedEntry.sla = e['sla'];\n      currently.push(parsedEntry);\n    }\n  }\n\n  return {\n    attempted_action: attempted,\n    reason,\n    currently_available_actions: currently,\n  };\n}\n\nfunction isActionNotAllowedReason(value: string): value is ActionNotAllowedReasonValue {\n  return (\n    value === 'wrong_status' ||\n    value === 'not_supported_on_product' ||\n    value === 'not_supported_on_buy' ||\n    value === 'mode_mismatch'\n  );\n}\n\nfunction isActionMode(value: string): value is ActionNotAllowedAvailableAction['mode'] {\n  return (\n    value === 'self_serve' ||\n    value === 'conditional_self_serve' ||\n    value === 'requires_proposal' ||\n    value === 'requires_approval'\n  );\n}\n\n/**\n * Type guard to check if an error is an ADCP error\n */\nexport function isADCPError(error: unknown): error is ADCPError {\n  return error instanceof ADCPError;\n}\n\n/**\n * Type guard to check if an error is a specific ADCP error type\n */\nexport function isErrorOfType<T extends ADCPError>(error: unknown, ErrorClass: new (...args: any[]) => T): error is T {\n  return error instanceof ErrorClass;\n}\n\n/**\n * Utility to extract error information for logging/debugging\n */\nexport function extractErrorInfo(error: unknown): {\n  message: string;\n  code?: string;\n  details?: unknown;\n  stack?: string;\n} {\n  if (isADCPError(error)) {\n    return {\n      message: error.message,\n      code: error.code,\n      details: error.details,\n      stack: error.stack,\n    };\n  }\n\n  if (error instanceof Error) {\n    return {\n      message: error.message,\n      stack: error.stack,\n    };\n  }\n\n  return {\n    message: String(error),\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/lib/errors/index.ts"],"sourcesContent":["// Custom error classes for ADCP client library\n\n/**\n * Base class for all ADCP client errors\n */\nexport abstract class ADCPError extends Error {\n  abstract readonly code: string;\n\n  constructor(\n    message: string,\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = this.constructor.name;\n  }\n}\n\n/**\n * Error thrown when a task times out\n */\nexport class TaskTimeoutError extends ADCPError {\n  readonly code = 'TASK_TIMEOUT';\n\n  constructor(\n    public readonly taskId: string,\n    public readonly timeout: number\n  ) {\n    super(`Task ${taskId} timed out after ${timeout}ms`);\n  }\n}\n\n/**\n * Error thrown when maximum clarification attempts are exceeded\n */\nexport class MaxClarificationError extends ADCPError {\n  readonly code = 'MAX_CLARIFICATIONS';\n\n  constructor(\n    public readonly taskId: string,\n    public readonly maxAttempts: number\n  ) {\n    super(`Task ${taskId} exceeded maximum clarification attempts: ${maxAttempts}`);\n  }\n}\n\n/**\n * Error thrown when a task is deferred to human\n * Contains the token needed to resume the task\n */\nexport class DeferredTaskError extends ADCPError {\n  readonly code = 'TASK_DEFERRED';\n\n  constructor(public readonly token: string) {\n    super(`Task deferred with token: ${token}`);\n  }\n}\n\n/**\n * Error thrown when a task is aborted\n */\nexport class TaskAbortedError extends ADCPError {\n  readonly code = 'TASK_ABORTED';\n\n  constructor(\n    public readonly taskId: string,\n    public readonly reason?: string\n  ) {\n    super(`Task ${taskId} aborted: ${reason || 'No reason provided'}`);\n  }\n}\n\n/**\n * Error thrown when an agent is not found\n */\nexport class AgentNotFoundError extends ADCPError {\n  readonly code = 'AGENT_NOT_FOUND';\n\n  constructor(\n    public readonly agentId: string,\n    public readonly availableAgents: string[]\n  ) {\n    super(`Agent '${agentId}' not found. Available agents: ${availableAgents.join(', ')}`);\n  }\n}\n\n/**\n * Error thrown when an agent doesn't support a task\n */\nexport class UnsupportedTaskError extends ADCPError {\n  readonly code = 'UNSUPPORTED_TASK';\n\n  constructor(\n    public readonly agentId: string,\n    public readonly taskName: string,\n    public readonly supportedTasks?: string[]\n  ) {\n    const tasksMsg = supportedTasks ? ` Supported tasks: ${supportedTasks.join(', ')}` : '';\n    super(`Agent '${agentId}' does not support task '${taskName}'.${tasksMsg}`);\n  }\n}\n\n/**\n * Error thrown when protocol communication fails\n */\nexport class ProtocolError extends ADCPError {\n  readonly code = 'PROTOCOL_ERROR';\n\n  constructor(\n    public readonly protocol: 'mcp' | 'a2a',\n    message: string,\n    public readonly originalError?: Error\n  ) {\n    super(`${protocol.toUpperCase()} protocol error: ${message}`);\n    this.details = { originalError };\n  }\n}\n\n/**\n * Error thrown when validation fails\n */\nexport class ValidationError extends ADCPError {\n  readonly code = 'VALIDATION_ERROR';\n\n  constructor(\n    public readonly field: string,\n    public readonly value: unknown,\n    public readonly constraint: string\n  ) {\n    super(`Validation failed for field '${field}': ${constraint}`);\n    this.details = { field, value, constraint };\n  }\n}\n\n/**\n * Error thrown when input handler is missing but required\n */\nexport class MissingInputHandlerError extends ADCPError {\n  readonly code = 'MISSING_INPUT_HANDLER';\n\n  constructor(\n    public readonly taskId: string,\n    public readonly question: string\n  ) {\n    super(`Agent requested input but no handler provided. Task: ${taskId}, Question: ${question}`);\n  }\n}\n\n/**\n * Error thrown when conversation context is invalid\n */\nexport class InvalidContextError extends ADCPError {\n  readonly code = 'INVALID_CONTEXT';\n\n  constructor(\n    public readonly contextId: string,\n    reason: string\n  ) {\n    super(`Invalid conversation context '${contextId}': ${reason}`);\n  }\n}\n\n/**\n * Error thrown when configuration is invalid\n */\nexport class ConfigurationError extends ADCPError {\n  readonly code = 'CONFIGURATION_ERROR';\n\n  constructor(\n    message: string,\n    public readonly configField?: string\n  ) {\n    super(`Configuration error: ${message}`);\n    this.details = { configField };\n  }\n}\n\n/**\n * OAuth metadata for authentication guidance\n */\nexport interface OAuthMetadataInfo {\n  /** URL of the authorization endpoint */\n  authorization_endpoint: string;\n  /** URL of the token endpoint */\n  token_endpoint: string;\n  /** URL of the dynamic client registration endpoint (optional) */\n  registration_endpoint?: string;\n  /** Issuer identifier */\n  issuer?: string;\n}\n\n/**\n * Subset of the parsed `WWW-Authenticate` challenge surfaced on\n * {@link AuthenticationRequiredError}. Mirrors the public shape of\n * `WWWAuthenticateChallenge` from `@adcp/sdk/auth/oauth` without forcing the\n * errors module to depend on the auth subtree (the dependency would invert\n * the build graph).\n *\n * `scheme` is lowercased per RFC 9110 §11.6.1.\n */\nexport interface AuthChallengeInfo {\n  scheme: string;\n  realm?: string;\n  scope?: string;\n  error?: string;\n  error_description?: string;\n}\n\n/**\n * Error thrown when authentication is required to access an MCP endpoint\n *\n * This error is thrown during MCP endpoint discovery when the server returns\n * a 401 Unauthorized response. The shape of the remediation depends on what\n * the 401 disclosed:\n *\n * - OAuth metadata (RFC 9728 PRM walk succeeded) → `oauthMetadata` set,\n *   message points at the authorization endpoint.\n * - A `WWW-Authenticate` challenge with a non-Bearer scheme (e.g. Basic\n *   behind an Apigee/Kong/AWS API GW gateway) → `challenge` set, message\n *   names the scheme and the SDK / CLI surface that configures it.\n * - Plain 401 with no metadata → fallback \"provide auth_token\" message.\n *\n * Consumers branching on `error.challenge?.scheme === 'basic'` can route\n * straight to `auth: { type: 'basic', username, password }` instead of\n * retrying Bearer indefinitely.\n *\n * @example\n * ```typescript\n * try {\n *   await client.getProducts({ brief: 'test' });\n * } catch (error) {\n *   if (error instanceof AuthenticationRequiredError) {\n *     if (error.challenge?.scheme === 'basic') {\n *       // Gateway-fronted agent — configure HTTP Basic\n *       reconnect({ auth: { type: 'basic', username, password } });\n *     } else if (error.oauthMetadata) {\n *       // Redirect user to OAuth flow\n *       const authUrl = error.oauthMetadata.authorization_endpoint;\n *       console.log(`Please authenticate at: ${authUrl}`);\n *     } else {\n *       console.log('Authentication required but no scheme metadata available');\n *     }\n *   }\n * }\n * ```\n */\nexport class AuthenticationRequiredError extends ADCPError {\n  readonly code = 'AUTHENTICATION_REQUIRED';\n\n  constructor(\n    public readonly agentUrl: string,\n    public readonly oauthMetadata?: OAuthMetadataInfo,\n    message?: string,\n    public readonly challenge?: AuthChallengeInfo\n  ) {\n    const defaultMessage = buildAuthRequiredMessage(agentUrl, oauthMetadata, challenge);\n    super(message || defaultMessage);\n    // `details` is serialized through error envelopes; surfacing the challenge\n    // here lets non-CLI consumers (LLM agents, dashboards, programmatic\n    // callers) branch on the scheme without instanceof-checking.\n    this.details = { agentUrl, oauthMetadata, challenge };\n  }\n\n  /**\n   * Check if OAuth authentication is available\n   */\n  get hasOAuth(): boolean {\n    return this.oauthMetadata !== undefined;\n  }\n\n  /**\n   * Get the authorization URL if OAuth is available\n   */\n  get authorizationUrl(): string | undefined {\n    return this.oauthMetadata?.authorization_endpoint;\n  }\n\n  /**\n   * Lowercased scheme from the `WWW-Authenticate` challenge, when present.\n   * `'basic'` is the common non-OAuth case — gateway-fronted agents speaking\n   * RFC 7617.\n   */\n  get suggestedScheme(): string | undefined {\n    return this.challenge?.scheme;\n  }\n}\n\n/**\n * Build the default error message. Branches on what the 401 disclosed:\n * - non-Bearer challenge (Basic, Digest, …) → scheme-specific remediation\n * - OAuth metadata → point at the authorization endpoint\n * - nothing → fallback \"provide auth_token\"\n *\n * The Basic branch names both the SDK shape (`createTestClient({ auth: …\n * type: 'basic' })`) and the CLI shape (`--auth user:pass --auth-scheme\n * basic`) so the same error envelope serves library and CLI consumers.\n */\nfunction buildAuthRequiredMessage(\n  agentUrl: string,\n  oauthMetadata: OAuthMetadataInfo | undefined,\n  challenge: AuthChallengeInfo | undefined\n): string {\n  if (challenge && challenge.scheme !== 'bearer') {\n    if (challenge.scheme === 'basic') {\n      return (\n        `Authentication required for ${agentUrl}. Agent (or its fronting gateway) speaks HTTP Basic ` +\n        `(RFC 7617). Configure via createTestClient({ auth: { type: 'basic', username, password } }) ` +\n        `— or from the CLI, --auth <user:pass> --auth-scheme basic.`\n      );\n    }\n    // Digest / Negotiate / NTLM / vendor schemes: we don't have first-class\n    // support but the scheme name in the message saves a discovery round-trip.\n    const realmHint = challenge.realm ? ` (realm: ${challenge.realm})` : '';\n    return (\n      `Authentication required for ${agentUrl}. Agent speaks ${challenge.scheme}${realmHint}, ` +\n      `which is not natively supported by @adcp/sdk. Configure auth at the transport layer ` +\n      `(custom fetch wrapper, reverse-proxy header injection) or contact the agent operator ` +\n      `about Bearer / Basic / OAuth support.`\n    );\n  }\n  if (oauthMetadata) {\n    return `Authentication required for ${agentUrl}. OAuth available at: ${oauthMetadata.authorization_endpoint}`;\n  }\n  return `Authentication required for ${agentUrl}. No OAuth metadata available - provide auth_token in agent config.`;\n}\n\n/**\n * Error thrown when a request reused an `idempotency_key` with a different\n * canonical payload within the seller's replay window.\n *\n * Recovery: `correctable` — the caller either reused a key by mistake (mint\n * a fresh UUID v4 for the new request) or re-planned with a different payload\n * (an agent whose LLM re-ran and emitted a different request must treat that\n * as a new intent, not a retry).\n *\n * @example\n * ```typescript\n * try {\n *   await client.createMediaBuy({...});\n * } catch (error) {\n *   if (error instanceof IdempotencyConflictError) {\n *     // Either the key was reused by mistake, or the agent re-planned with\n *     // a different payload. Mint a fresh key and try again.\n *   }\n * }\n * ```\n */\nexport class IdempotencyConflictError extends ADCPError {\n  readonly code = 'IDEMPOTENCY_CONFLICT';\n\n  // Exposed via the getter so `console.log(err)` and JSON.stringify don't\n  // leak the key (it's a retry-pattern oracle within the seller's TTL).\n  // Callers reading `err.idempotencyKey` get it normally.\n  readonly idempotencyKey: string | undefined;\n\n  constructor(idempotencyKey: string | undefined, message?: string) {\n    super(\n      message ||\n        'idempotency_key was used earlier with a different canonical payload. ' +\n          'Use a fresh UUID v4 for the new request, or resend the exact original payload to get the cached response.'\n    );\n    Object.defineProperty(this, 'idempotencyKey', {\n      value: idempotencyKey,\n      enumerable: false,\n      writable: false,\n      configurable: false,\n    });\n  }\n}\n\n/**\n * Error thrown when a request carries an `idempotency_key` that is past the\n * seller's declared replay window (plus clock-skew tolerance).\n *\n * Recovery: `correctable`. If the caller knows the prior call succeeded\n * (e.g., they saw the response once, then crashed), they SHOULD fall back\n * to a natural-key lookup (e.g., `get_media_buys` by\n * `context.internal_campaign_id`) rather than minting a new key — otherwise\n * the seller treats the new request as fresh and silently creates a duplicate.\n *\n * If the caller doesn't know whether the prior call succeeded, a fresh key\n * is safe.\n */\nexport class IdempotencyExpiredError extends ADCPError {\n  readonly code = 'IDEMPOTENCY_EXPIRED';\n\n  // Non-enumerable so `console.log(err)` / JSON.stringify don't leak it —\n  // same reasoning as IdempotencyConflictError.idempotencyKey.\n  readonly idempotencyKey: string | undefined;\n\n  constructor(idempotencyKey: string | undefined, message?: string) {\n    super(\n      message ||\n        \"idempotency_key is past the seller's replay window. \" +\n          'If you know the prior call succeeded, look up the resource by natural key before retrying. Otherwise, mint a fresh UUID v4.'\n    );\n    Object.defineProperty(this, 'idempotencyKey', {\n      value: idempotencyKey,\n      enumerable: false,\n      writable: false,\n      configurable: false,\n    });\n  }\n}\n\nexport interface FeatureUnsupportedErrorOptions {\n  message?: string;\n  details?: Record<string, unknown>;\n}\n\nexport type ClientPreflightAdcpErrorRecovery = 'transient' | 'correctable' | 'terminal';\n\n/**\n * Protocol-shaped error metadata attached to SDK-local preflight throws.\n * Mirrors the public `TaskResult.adcpError` fields without importing core\n * task types into the errors module.\n */\nexport interface ClientPreflightAdcpErrorInfo {\n  code: string;\n  message: string;\n  recovery?: ClientPreflightAdcpErrorRecovery;\n  field?: string;\n  suggestion?: string;\n  details?: Record<string, unknown>;\n}\n\nexport interface ProtocolFeatureUnsupportedErrorOptions extends FeatureUnsupportedErrorOptions {\n  field?: string;\n  suggestion?: string;\n  recovery?: ClientPreflightAdcpErrorRecovery;\n}\n\nexport const SDK_ERROR_TO_PROTOCOL_ERROR_CODE = {\n  FEATURE_UNSUPPORTED: 'UNSUPPORTED_FEATURE',\n} as const;\n\nexport function mapSdkErrorCodeToProtocolErrorCode(code: string): string | undefined {\n  return SDK_ERROR_TO_PROTOCOL_ERROR_CODE[code as keyof typeof SDK_ERROR_TO_PROTOCOL_ERROR_CODE];\n}\n\n/**\n * Error thrown when a required feature is not supported by the seller or by\n * the configured AdCP version.\n */\nexport class FeatureUnsupportedError extends ADCPError {\n  readonly code: string = 'FEATURE_UNSUPPORTED';\n\n  constructor(\n    public readonly unsupportedFeatures: string[],\n    public readonly declaredFeatures: string[],\n    public readonly agentUrl?: string,\n    options: FeatureUnsupportedErrorOptions = {}\n  ) {\n    const missing = unsupportedFeatures.join(', ');\n    const declared = declaredFeatures.length > 0 ? declaredFeatures.join(', ') : '(none)';\n    const urlPart = agentUrl ? ` at ${agentUrl}` : '';\n    super(options.message ?? `Seller${urlPart} does not support: ${missing}\\n  Declared features: ${declared}`);\n    this.details = {\n      unsupported_features: unsupportedFeatures,\n      declared_features: declaredFeatures,\n      ...(options.details ?? {}),\n    };\n  }\n}\n\n/**\n * Version-gate error for requests that use a protocol feature outside the\n * configured AdCP release. Kept as a FeatureUnsupportedError subclass so\n * existing catch sites keep working, while `code` carries the AdCP wire code\n * expected by probe/recovery layers.\n */\nexport class ProtocolFeatureUnsupportedError extends FeatureUnsupportedError {\n  readonly code: string = 'UNSUPPORTED_FEATURE';\n\n  readonly adcpError: ClientPreflightAdcpErrorInfo;\n\n  constructor(\n    unsupportedFeatures: string[],\n    declaredFeatures: string[],\n    agentUrl?: string,\n    options: ProtocolFeatureUnsupportedErrorOptions = {}\n  ) {\n    super(unsupportedFeatures, declaredFeatures, agentUrl, options);\n    this.adcpError = {\n      code: this.code,\n      message: this.message,\n      recovery: options.recovery ?? 'correctable',\n      ...(options.field && { field: options.field }),\n      ...(options.suggestion && { suggestion: options.suggestion }),\n      ...(isRecord(this.details) && { details: this.details }),\n    };\n  }\n}\n\nexport function getClientPreflightAdcpError(error: unknown): ClientPreflightAdcpErrorInfo | undefined {\n  if (error instanceof ProtocolFeatureUnsupportedError) {\n    return error.adcpError;\n  }\n  return undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Error thrown when a response body exceeds the configured `maxResponseBytes`\n * cap on the transport. Surfaced when crawling untrusted agents (registries,\n * federated discovery layers) to prevent a hostile vendor from buffering a\n * large reply before schema validation runs.\n *\n * Recovery: `terminal` from the SDK's view — repeating the call against the\n * same agent will hit the same cap. The buyer's options are to widen the\n * cap (per-call `transport.maxResponseBytes`) when the agent's payload is\n * legitimately large, or to flag the agent as misbehaving.\n */\nexport class ResponseTooLargeError extends ADCPError {\n  readonly code = 'RESPONSE_TOO_LARGE';\n\n  constructor(\n    public readonly limit: number,\n    public readonly bytesRead: number,\n    public readonly url: string,\n    /**\n     * The parsed value of the `Content-Length` response header when the cap\n     * was tripped on the pre-check (before any body bytes were read). Undefined\n     * when the response was streamed and exceeded the cap mid-flight, or when\n     * the server omitted the header.\n     */\n    public readonly contentLengthHeader?: number\n  ) {\n    super(\n      contentLengthHeader !== undefined\n        ? `Response body declared ${contentLengthHeader} bytes, exceeds maxResponseBytes cap of ${limit} (${url})`\n        : `Response body exceeded maxResponseBytes cap of ${limit} after reading ${bytesRead} bytes (${url})`\n    );\n    this.details = { limit, bytesRead, url, contentLengthHeader };\n  }\n}\n\n/**\n * Error thrown when an `update_media_buy` request is rejected because the\n * action it maps to isn't currently allowed on the buy (AdCP 3.1, RFC #4480).\n *\n * Typed `details` payload follows `error-details/action-not-allowed.json`:\n * `attempted_action`, `reason`, optional `currently_available_actions[]`.\n *\n * Recovery branches on `reason`:\n *  - `wrong_status`: transition the buy (or wait) to an allowed status.\n *  - `not_supported_on_product`: terminal for this buy; pick a different\n *    product for future buys that need the action.\n *  - `not_supported_on_buy`: terminal; renegotiate buy terms.\n *  - `mode_mismatch`: `recovery` is set to a typed hint indicating the\n *    required flow (`createProposal`, `waitForApproval`, `reissueAsDirect`)\n *    instead of a plain retry.\n */\nexport class ActionNotAllowedError extends ADCPError {\n  readonly code = 'ACTION_NOT_ALLOWED';\n\n  readonly attemptedAction: ActionNotAllowedErrorDetails['attempted_action'];\n  readonly reason: ActionNotAllowedErrorDetails['reason'];\n  readonly currentlyAvailableActions: ReadonlyArray<ActionNotAllowedAvailableAction>;\n  readonly recovery?: ActionNotAllowedRecovery;\n\n  constructor(detailsPayload: ActionNotAllowedErrorDetails, message?: string) {\n    super(message ?? buildActionNotAllowedMessage(detailsPayload));\n    this.attemptedAction = detailsPayload.attempted_action;\n    this.reason = detailsPayload.reason;\n    this.currentlyAvailableActions = detailsPayload.currently_available_actions ?? [];\n    this.recovery = detailsPayload.reason === 'mode_mismatch' ? buildModeMismatchRecovery(detailsPayload) : undefined;\n    this.details = detailsPayload;\n  }\n}\n\n/**\n * Inline copy of the structured payload - duplicated here rather than\n * imported from `media-buy/types` to keep the errors module free of\n * cross-module imports (matches the convention used for the other typed\n * errors in this file).\n */\nexport interface ActionNotAllowedErrorDetails {\n  attempted_action: ActionNotAllowedAttemptedAction;\n  reason: ActionNotAllowedReasonValue;\n  currently_available_actions?: ActionNotAllowedAvailableAction[];\n}\n\nexport type ActionNotAllowedReasonValue =\n  | 'wrong_status'\n  | 'not_supported_on_product'\n  | 'not_supported_on_buy'\n  | 'mode_mismatch';\n\nexport type ActionNotAllowedAttemptedAction = string;\n\nexport interface ActionNotAllowedAvailableAction {\n  action: ActionNotAllowedAttemptedAction;\n  mode: 'self_serve' | 'conditional_self_serve' | 'requires_proposal' | 'requires_approval';\n  sla?: unknown;\n  terms_ref?: string;\n}\n\nexport type ActionNotAllowedRecovery =\n  | { kind: 'createProposal'; message: string }\n  | { kind: 'waitForApproval'; message: string }\n  | { kind: 'reissueAsDirect'; message: string };\n\nfunction buildActionNotAllowedMessage(details: ActionNotAllowedErrorDetails): string {\n  const prefix = `update_media_buy rejected: \\`${details.attempted_action}\\` not allowed (${details.reason}).`;\n  switch (details.reason) {\n    case 'wrong_status':\n      return `${prefix} transition the buy to an allowed status before retrying.`;\n    case 'not_supported_on_product':\n      return `${prefix} product does not declare this action; pick a different product for future buys needing it.`;\n    case 'not_supported_on_buy':\n      return `${prefix} buy was negotiated without this capability; renegotiate buy terms.`;\n    case 'mode_mismatch':\n      return `${prefix} mode shifted between preflight and dispatch; re-issue through the appropriate flow indicated by available_actions.`;\n  }\n}\n\nfunction buildModeMismatchRecovery(details: ActionNotAllowedErrorDetails): ActionNotAllowedRecovery | undefined {\n  const match = details.currently_available_actions?.find(a => a.action === details.attempted_action);\n  if (!match) return undefined;\n  switch (match.mode) {\n    case 'requires_proposal':\n      return {\n        kind: 'createProposal',\n        message:\n          `seller now resolves \\`${details.attempted_action}\\` as requires_proposal. ` +\n          'reissue via the proposal lifecycle (`create_proposal` / `finalize_proposal`).',\n      };\n    case 'requires_approval':\n      return {\n        kind: 'waitForApproval',\n        message:\n          `seller now resolves \\`${details.attempted_action}\\` as requires_approval. ` +\n          'expect an async approval callback rather than a direct response.',\n      };\n    case 'conditional_self_serve':\n      return {\n        kind: 'reissueAsDirect',\n        message:\n          `seller resolves \\`${details.attempted_action}\\` as conditional_self_serve: ` +\n          'small mutations clear automatically, larger ones queue. retry; expect a possible async escalation.',\n      };\n    case 'self_serve':\n      return {\n        kind: 'reissueAsDirect',\n        message: `seller resolves \\`${details.attempted_action}\\` as self_serve. retry the same request.`,\n      };\n  }\n}\n\n/**\n * Reason the v3 guard refused a mutating dispatch.\n * - `version`: seller's `major_versions` does not include 3\n * - `idempotency`: seller reports v3 but omits the required\n *   `adcp.idempotency.replay_ttl_seconds` declaration\n * - `synthetic`: @deprecated — kept in the union for downstream\n *   consumers that pattern-match on the union literal, but the SDK no\n *   longer emits it. Sellers whose capabilities are synthesized from\n *   `tools/list` are routed through the v2 adapter with a one-time\n *   warning; gate retry behavior on `SingleAgentClient.isSyntheticV2()`.\n */\nexport type VersionUnsupportedReason =\n  | 'version'\n  | 'idempotency'\n  /** @deprecated SDK no longer emits this reason. See union JSDoc. */\n  | 'synthetic';\n\n/**\n * Error thrown when a mutating call would dispatch to a seller whose\n * capabilities cannot be corroborated as v3. Provides an explicit\n * pre-flight signal so callers don't silently mutate state on agents\n * that have not negotiated the expected major version.\n *\n * Agent URL is exposed on the instance (`agentUrl`) but omitted from the\n * default message to avoid leaking seller identity into shared log sinks.\n */\nexport class VersionUnsupportedError extends ADCPError {\n  readonly code = 'VERSION_UNSUPPORTED';\n\n  constructor(\n    public readonly taskType: string,\n    public readonly reason: VersionUnsupportedReason,\n    public readonly actualVersion: 'v2' | 'v3',\n    public readonly agentUrl?: string\n  ) {\n    super(\n      `Refusing to dispatch mutating task '${taskType}': ` +\n        VersionUnsupportedError.explain(reason, actualVersion) +\n        ` Pass allowV2: true or requireV3ForMutations: false to override.`\n    );\n  }\n\n  private static explain(reason: VersionUnsupportedReason, actualVersion: 'v2' | 'v3'): string {\n    switch (reason) {\n      case 'version':\n        return `seller advertises major version '${actualVersion}' but v3 is required.`;\n      case 'idempotency':\n        return `seller reports v3 but omits adcp.idempotency.replay_ttl_seconds (required by spec).`;\n      case 'synthetic':\n        return `capabilities were synthesized from a tool list, v3 claim is unverifiable.`;\n    }\n  }\n}\n\n/**\n * Check if an error indicates a 401 Unauthorized response\n *\n * This helper centralizes the fragile logic of detecting 401 errors from\n * various sources (HTTP status codes, error messages, wrapped errors).\n * Used during endpoint discovery to detect authentication requirements.\n *\n * @param error - The error to check\n * @param got401Flag - Optional flag that was set by tracking HTTP responses\n * @returns true if the error appears to be a 401 authentication error\n */\nexport function is401Error(error: unknown, got401Flag = false): boolean {\n  if (got401Flag) {\n    return true;\n  }\n\n  if (!error) {\n    return false;\n  }\n\n  // Check for status property (common in HTTP errors). MCP SDK's\n  // `StreamableHTTPClientTransport` throws errors with the HTTP status on\n  // `.code`, so we check that too.\n  const errorObj = error as Record<string, unknown>;\n  const status =\n    (errorObj as { status?: number })?.status ||\n    (errorObj as { response?: { status?: number } })?.response?.status ||\n    (errorObj as { cause?: { status?: number } })?.cause?.status ||\n    (errorObj as { code?: unknown })?.code;\n  if (status === 401) {\n    return true;\n  }\n\n  // Fall back to string matching in error message. Use word boundaries so\n  // we don't misidentify things like \"product prod-401-xyz\" as an HTTP 401,\n  // and require \"Unauthorized\" as a whole word rather than as a substring.\n  const message = (errorObj as { message?: string })?.message || '';\n  return /\\b401\\b/.test(message) || /\\bunauthorized\\b/i.test(message);\n}\n\n/**\n * Map a structured AdCP error (code + message) to a typed ADCPError subclass\n * when the code has a dedicated class. Returns `undefined` for codes that\n * don't have a typed mapping — callers should continue to use the untyped\n * `AdcpErrorInfo` for those.\n *\n * Pass the `idempotencyKey` the SDK sent so the constructed error carries it\n * for the caller's recovery logic. The server intentionally omits the key\n * from error bodies (it's a read-oracle), so the transport-layer caller is\n * the authoritative source.\n */\nexport function adcpErrorToTypedError(\n  adcpError: { code: string; message?: string; details?: unknown },\n  idempotencyKey?: string\n): ADCPError | undefined {\n  switch (adcpError.code) {\n    case 'IDEMPOTENCY_CONFLICT':\n      return new IdempotencyConflictError(idempotencyKey, adcpError.message);\n    case 'IDEMPOTENCY_EXPIRED':\n      return new IdempotencyExpiredError(idempotencyKey, adcpError.message);\n    case 'ACTION_NOT_ALLOWED': {\n      const parsed = parseActionNotAllowedDetails(adcpError.details);\n      if (!parsed) return undefined;\n      return new ActionNotAllowedError(parsed, adcpError.message);\n    }\n    default:\n      return undefined;\n  }\n}\n\nfunction parseActionNotAllowedDetails(raw: unknown): ActionNotAllowedErrorDetails | undefined {\n  if (!raw || typeof raw !== 'object') return undefined;\n  const obj = raw as Record<string, unknown>;\n  const attempted = obj['attempted_action'];\n  const reason = obj['reason'];\n  if (typeof attempted !== 'string' || typeof reason !== 'string') return undefined;\n  if (!isActionNotAllowedReason(reason)) return undefined;\n\n  const rawList = obj['currently_available_actions'];\n  let currently: ActionNotAllowedAvailableAction[] | undefined;\n  if (Array.isArray(rawList)) {\n    currently = [];\n    for (const entry of rawList) {\n      if (!entry || typeof entry !== 'object') continue;\n      const e = entry as Record<string, unknown>;\n      const action = e['action'];\n      const mode = e['mode'];\n      if (typeof action !== 'string' || typeof mode !== 'string') continue;\n      if (!isActionMode(mode)) continue;\n      const parsedEntry: ActionNotAllowedAvailableAction = { action, mode };\n      if (typeof e['terms_ref'] === 'string') parsedEntry.terms_ref = e['terms_ref'];\n      if (e['sla'] !== undefined) parsedEntry.sla = e['sla'];\n      currently.push(parsedEntry);\n    }\n  }\n\n  return {\n    attempted_action: attempted,\n    reason,\n    currently_available_actions: currently,\n  };\n}\n\nfunction isActionNotAllowedReason(value: string): value is ActionNotAllowedReasonValue {\n  return (\n    value === 'wrong_status' ||\n    value === 'not_supported_on_product' ||\n    value === 'not_supported_on_buy' ||\n    value === 'mode_mismatch'\n  );\n}\n\nfunction isActionMode(value: string): value is ActionNotAllowedAvailableAction['mode'] {\n  return (\n    value === 'self_serve' ||\n    value === 'conditional_self_serve' ||\n    value === 'requires_proposal' ||\n    value === 'requires_approval'\n  );\n}\n\n/**\n * Type guard to check if an error is an ADCP error\n */\nexport function isADCPError(error: unknown): error is ADCPError {\n  return error instanceof ADCPError;\n}\n\n/**\n * Type guard to check if an error is a specific ADCP error type\n */\nexport function isErrorOfType<T extends ADCPError>(error: unknown, ErrorClass: new (...args: any[]) => T): error is T {\n  return error instanceof ErrorClass;\n}\n\n/**\n * Utility to extract error information for logging/debugging\n */\nexport function extractErrorInfo(error: unknown): {\n  message: string;\n  code?: string;\n  details?: unknown;\n  stack?: string;\n} {\n  if (isADCPError(error)) {\n    return {\n      message: error.message,\n      code: error.code,\n      details: error.details,\n      stack: error.stack,\n    };\n  }\n\n  if (error instanceof Error) {\n    return {\n      message: error.message,\n      stack: error.stack,\n    };\n  }\n\n  return {\n    message: String(error),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/lib/express-mcp/index.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);
 const JSON_TYPE = "application/json";
 const SSE_TYPE = "text/event-stream";
 function acceptsType(accept, type) {

package/dist/lib/express-mcp/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/express-mcp/index.ts"],"sourcesContent":["/**\n * Express middleware that normalizes the `Accept` header so requests reach\n * `StreamableHTTPServerTransport` without tripping its 406 check.\n *\n * The MCP SDK's POST handler requires both `application/json` and\n * `text/event-stream` in `Accept` even when constructed with\n * `enableJsonResponse: true` (pure request/response mode — no SSE in play).\n * Buyer agents and validators that send `Accept: application/json` hit a\n * 406 Not Acceptable.\n *\n * This middleware rewrites `Accept: application/json` (JSON alone) to\n * `application/json, text/event-stream` on the incoming request, so the\n * transport's strict check passes. Headers that already advertise both,\n * or don't advertise JSON, are left alone.\n *\n * The rewrite touches BOTH `req.headers.accept` AND the matching entries in\n * `req.rawHeaders`. `StreamableHTTPServerTransport.handleRequest` runs the\n * incoming `IncomingMessage` through `@hono/node-server`'s\n * `newHeadersFromIncoming`, which rebuilds the Fetch `Headers` from\n * `rawHeaders` and ignores `req.headers`. Patching only the parsed map\n * leaves the transport reading the original unmodified value and the 406\n * still fires — the pair has to move together.\n *\n * **Edge case, intentionally NOT auto-synthesized:** if `req.headers.accept`\n * exists but `req.rawHeaders` has no Accept entry (some reverse proxies\n * mutate `req.headers` without rebuilding `rawHeaders`), the middleware\n * still patches `req.headers.accept` but leaves `rawHeaders` as-is. The\n * transport then sees no Accept at all on the `rawHeaders` rebuild and\n * falls through to its missing-Accept path. Adding a phantom `['Accept',\n * '…']` pair would diverge `req.rawHeaders` from the wire-level headers\n * and can confuse other middleware (RFC 9421 verifiers, request-signing\n * canonicalizers) that use `rawHeaders` as authoritative. If you hit\n * this divergence in practice, fix the upstream proxy — don't monkey-\n * patch here.\n *\n * Mount BEFORE the MCP transport handler:\n *\n * ```ts\n * import express from 'express';\n * import { mcpAcceptHeaderMiddleware } from '@adcp/sdk/express-mcp';\n *\n * const app = express();\n * app.use('/mcp', mcpAcceptHeaderMiddleware());\n * // then mount the MCP transport (StreamableHTTPServerTransport.handleRequest)\n * ```\n *\n * This is a local escape hatch pending upstream SDK fix\n * (https://github.com/modelcontextprotocol/typescript-sdk/issues/1944).\n * Remove once the SDK loosens the Accept check for `enableJsonResponse: true`.\n */\n\nimport type { IncomingMessage, ServerResponse } from 'http';\n\n/** Minimal next callback shape — avoids a dependency on `@types/express`. */\ntype NextFn = (err?: unknown) => void;\n\n/** Minimal Express-compatible handler signature. */\nexport type McpAcceptHeaderHandler = (req: IncomingMessage, res: ServerResponse, next: NextFn) => void;\n\nconst JSON_TYPE = 'application/json';\nconst SSE_TYPE = 'text/event-stream';\n\n/**\n * Does the raw `Accept` value advertise `type`? Case-insensitive, tolerant\n * of parameters (`application/json;q=0.9`) and surrounding whitespace.\n */\nfunction acceptsType(accept: string, type: string): boolean {\n  const lower = accept.toLowerCase();\n  const target = type.toLowerCase();\n  for (const raw of lower.split(',')) {\n    const mediaType = raw.split(';')[0]?.trim();\n    if (mediaType === target) return true;\n  }\n  return false;\n}\n\n/**\n * Create the middleware. No options today; exported as a factory for\n * symmetry with Express convention and future extensibility.\n */\nexport function mcpAcceptHeaderMiddleware(): McpAcceptHeaderHandler {\n  return function mcpAcceptHeader(req, _res, next) {\n    const accept = req.headers.accept;\n\n    // No Accept header at all — leave it to the SDK to handle however it does.\n    if (typeof accept !== 'string' || accept.length === 0) {\n      next();\n      return;\n    }\n\n    const hasJson = acceptsType(accept, JSON_TYPE);\n    const hasSse = acceptsType(accept, SSE_TYPE);\n\n    // Only rewrite the JSON-only case. If the request already advertises\n    // both, or doesn't advertise JSON at all (e.g. `*/*`, a stray\n    // `text/plain`, or a malformed value), leave the header untouched and\n    // let the transport decide.\n    if (hasJson && !hasSse) {\n      const rewritten = `${JSON_TYPE}, ${SSE_TYPE}`;\n      req.headers.accept = rewritten;\n      rewriteRawAcceptHeader(req, rewritten);\n    }\n\n    next();\n  };\n}\n\n/**\n * Rewrite every `Accept` entry in `req.rawHeaders` to `rewritten`.\n *\n * `rawHeaders` is a flat `[name, value, name, value, ...]` array where\n * header names preserve the wire-level casing. The scan is case-insensitive\n * so `Accept` / `ACCEPT` / `accept` all match. Duplicates (rare, but\n * allowed by HTTP) are ALL rewritten so a later copy can't shadow the\n * patched one. If the header is absent we don't append — adding it here\n * would diverge from the pre-middleware request shape and could surprise\n * other middleware that reads `rawHeaders` directly.\n */\nfunction rewriteRawAcceptHeader(req: IncomingMessage, rewritten: string): void {\n  const raw = (req as { rawHeaders?: unknown }).rawHeaders;\n  if (!Array.isArray(raw)) return;\n  for (let i = 0; i < raw.length - 1; i += 2) {\n    const name = raw[i];\n    if (typeof name === 'string' && name.toLowerCase() === 'accept') {\n      raw[i + 1] = rewritten;\n    }\n  }\n}\n"],"mappings":";;;;;;AA2DA,MAAM,YAAY;AAClB,MAAM,WAAW;AAMjB,SAAS,YAAY,QAAgB,MAAuB;AAC1D,QAAM,QAAQ,OAAO,YAAY;AACjC,QAAM,SAAS,KAAK,YAAY;AAChC,aAAW,OAAO,MAAM,MAAM,GAAG,GAAG;AAClC,UAAM,YAAY,IAAI,MAAM,GAAG,EAAE,CAAC,GAAG,KAAK;AAC1C,QAAI,cAAc,OAAQ,QAAO;AAAA,EACnC;AACA,SAAO;AACT;AAMO,SAAS,4BAAoD;AAClE,SAAO,SAAS,gBAAgB,KAAK,MAAM,MAAM;AAC/C,UAAM,SAAS,IAAI,QAAQ;AAG3B,QAAI,OAAO,WAAW,YAAY,OAAO,WAAW,GAAG;AACrD,WAAK;AACL;AAAA,IACF;AAEA,UAAM,UAAU,YAAY,QAAQ,SAAS;AAC7C,UAAM,SAAS,YAAY,QAAQ,QAAQ;AAM3C,QAAI,WAAW,CAAC,QAAQ;AACtB,YAAM,YAAY,GAAG,SAAS,KAAK,QAAQ;AAC3C,UAAI,QAAQ,SAAS;AACrB,6BAAuB,KAAK,SAAS;AAAA,IACvC;AAEA,SAAK;AAAA,EACP;AACF;AAaA,SAAS,uBAAuB,KAAsB,WAAyB;AAC7E,QAAM,MAAO,IAAiC;AAC9C,MAAI,CAAC,MAAM,QAAQ,GAAG,EAAG;AACzB,WAAS,IAAI,GAAG,IAAI,IAAI,SAAS,GAAG,KAAK,GAAG;AAC1C,UAAM,OAAO,IAAI,CAAC;AAClB,QAAI,OAAO,SAAS,YAAY,KAAK,YAAY,MAAM,UAAU;AAC/D,UAAI,IAAI,CAAC,IAAI;AAAA,IACf;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../src/lib/express-mcp/index.ts"],"sourcesContent":["/**\n * Express middleware that normalizes the `Accept` header so requests reach\n * `StreamableHTTPServerTransport` without tripping its 406 check.\n *\n * The MCP SDK's POST handler requires both `application/json` and\n * `text/event-stream` in `Accept` even when constructed with\n * `enableJsonResponse: true` (pure request/response mode — no SSE in play).\n * Buyer agents and validators that send `Accept: application/json` hit a\n * 406 Not Acceptable.\n *\n * This middleware rewrites `Accept: application/json` (JSON alone) to\n * `application/json, text/event-stream` on the incoming request, so the\n * transport's strict check passes. Headers that already advertise both,\n * or don't advertise JSON, are left alone.\n *\n * The rewrite touches BOTH `req.headers.accept` AND the matching entries in\n * `req.rawHeaders`. `StreamableHTTPServerTransport.handleRequest` runs the\n * incoming `IncomingMessage` through `@hono/node-server`'s\n * `newHeadersFromIncoming`, which rebuilds the Fetch `Headers` from\n * `rawHeaders` and ignores `req.headers`. Patching only the parsed map\n * leaves the transport reading the original unmodified value and the 406\n * still fires — the pair has to move together.\n *\n * **Edge case, intentionally NOT auto-synthesized:** if `req.headers.accept`\n * exists but `req.rawHeaders` has no Accept entry (some reverse proxies\n * mutate `req.headers` without rebuilding `rawHeaders`), the middleware\n * still patches `req.headers.accept` but leaves `rawHeaders` as-is. The\n * transport then sees no Accept at all on the `rawHeaders` rebuild and\n * falls through to its missing-Accept path. Adding a phantom `['Accept',\n * '…']` pair would diverge `req.rawHeaders` from the wire-level headers\n * and can confuse other middleware (RFC 9421 verifiers, request-signing\n * canonicalizers) that use `rawHeaders` as authoritative. If you hit\n * this divergence in practice, fix the upstream proxy — don't monkey-\n * patch here.\n *\n * Mount BEFORE the MCP transport handler:\n *\n * ```ts\n * import express from 'express';\n * import { mcpAcceptHeaderMiddleware } from '@adcp/sdk/express-mcp';\n *\n * const app = express();\n * app.use('/mcp', mcpAcceptHeaderMiddleware());\n * // then mount the MCP transport (StreamableHTTPServerTransport.handleRequest)\n * ```\n *\n * This is a local escape hatch pending upstream SDK fix\n * (https://github.com/modelcontextprotocol/typescript-sdk/issues/1944).\n * Remove once the SDK loosens the Accept check for `enableJsonResponse: true`.\n */\n\nimport type { IncomingMessage, ServerResponse } from 'http';\n\n/** Minimal next callback shape — avoids a dependency on `@types/express`. */\ntype NextFn = (err?: unknown) => void;\n\n/** Minimal Express-compatible handler signature. */\nexport type McpAcceptHeaderHandler = (req: IncomingMessage, res: ServerResponse, next: NextFn) => void;\n\nconst JSON_TYPE = 'application/json';\nconst SSE_TYPE = 'text/event-stream';\n\n/**\n * Does the raw `Accept` value advertise `type`? Case-insensitive, tolerant\n * of parameters (`application/json;q=0.9`) and surrounding whitespace.\n */\nfunction acceptsType(accept: string, type: string): boolean {\n  const lower = accept.toLowerCase();\n  const target = type.toLowerCase();\n  for (const raw of lower.split(',')) {\n    const mediaType = raw.split(';')[0]?.trim();\n    if (mediaType === target) return true;\n  }\n  return false;\n}\n\n/**\n * Create the middleware. No options today; exported as a factory for\n * symmetry with Express convention and future extensibility.\n */\nexport function mcpAcceptHeaderMiddleware(): McpAcceptHeaderHandler {\n  return function mcpAcceptHeader(req, _res, next) {\n    const accept = req.headers.accept;\n\n    // No Accept header at all — leave it to the SDK to handle however it does.\n    if (typeof accept !== 'string' || accept.length === 0) {\n      next();\n      return;\n    }\n\n    const hasJson = acceptsType(accept, JSON_TYPE);\n    const hasSse = acceptsType(accept, SSE_TYPE);\n\n    // Only rewrite the JSON-only case. If the request already advertises\n    // both, or doesn't advertise JSON at all (e.g. `*/*`, a stray\n    // `text/plain`, or a malformed value), leave the header untouched and\n    // let the transport decide.\n    if (hasJson && !hasSse) {\n      const rewritten = `${JSON_TYPE}, ${SSE_TYPE}`;\n      req.headers.accept = rewritten;\n      rewriteRawAcceptHeader(req, rewritten);\n    }\n\n    next();\n  };\n}\n\n/**\n * Rewrite every `Accept` entry in `req.rawHeaders` to `rewritten`.\n *\n * `rawHeaders` is a flat `[name, value, name, value, ...]` array where\n * header names preserve the wire-level casing. The scan is case-insensitive\n * so `Accept` / `ACCEPT` / `accept` all match. Duplicates (rare, but\n * allowed by HTTP) are ALL rewritten so a later copy can't shadow the\n * patched one. If the header is absent we don't append — adding it here\n * would diverge from the pre-middleware request shape and could surprise\n * other middleware that reads `rawHeaders` directly.\n */\nfunction rewriteRawAcceptHeader(req: IncomingMessage, rewritten: string): void {\n  const raw = (req as { rawHeaders?: unknown }).rawHeaders;\n  if (!Array.isArray(raw)) return;\n  for (let i = 0; i < raw.length - 1; i += 2) {\n    const name = raw[i];\n    if (typeof name === 'string' && name.toLowerCase() === 'accept') {\n      raw[i + 1] = rewritten;\n    }\n  }\n}\n"],"mappings":"AA2DA,MAAM,YAAY;AAClB,MAAM,WAAW;AAMjB,SAAS,YAAY,QAAgB,MAAuB;AAC1D,QAAM,QAAQ,OAAO,YAAY;AACjC,QAAM,SAAS,KAAK,YAAY;AAChC,aAAW,OAAO,MAAM,MAAM,GAAG,GAAG;AAClC,UAAM,YAAY,IAAI,MAAM,GAAG,EAAE,CAAC,GAAG,KAAK;AAC1C,QAAI,cAAc,OAAQ,QAAO;AAAA,EACnC;AACA,SAAO;AACT;AAMO,SAAS,4BAAoD;AAClE,SAAO,SAAS,gBAAgB,KAAK,MAAM,MAAM;AAC/C,UAAM,SAAS,IAAI,QAAQ;AAG3B,QAAI,OAAO,WAAW,YAAY,OAAO,WAAW,GAAG;AACrD,WAAK;AACL;AAAA,IACF;AAEA,UAAM,UAAU,YAAY,QAAQ,SAAS;AAC7C,UAAM,SAAS,YAAY,QAAQ,QAAQ;AAM3C,QAAI,WAAW,CAAC,QAAQ;AACtB,YAAM,YAAY,GAAG,SAAS,KAAK,QAAQ;AAC3C,UAAI,QAAQ,SAAS;AACrB,6BAAuB,KAAK,SAAS;AAAA,IACvC;AAEA,SAAK;AAAA,EACP;AACF;AAaA,SAAS,uBAAuB,KAAsB,WAAyB;AAC7E,QAAM,MAAO,IAAiC;AAC9C,MAAI,CAAC,MAAM,QAAQ,GAAG,EAAG;AACzB,WAAS,IAAI,GAAG,IAAI,IAAI,SAAS,GAAG,KAAK,GAAG;AAC1C,UAAM,OAAO,IAAI,CAAC;AAClB,QAAI,OAAO,SAAS,YAAY,KAAK,YAAY,MAAM,UAAU;AAC/D,UAAI,IAAI,CAAC,IAAI;AAAA,IACf;AAAA,EACF;AACF;","names":[]}

package/dist/lib/governance/index.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);
 const REGULATED_HUMAN_REVIEW_CATEGORIES = Object.freeze([
   "fair_housing",
   "fair_lending",

package/dist/lib/governance/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/governance/index.ts"],"sourcesContent":["/**\n * Governance plan helpers — GDPR Art 22 / EU AI Act Annex III invariants.\n *\n * These helpers complement the Zod-generated request schemas by exposing\n * constraints that `datamodel-code-generator`-style codegen commonly drops\n * from `if/then` and `oneOf`:\n *  - budget reallocation autonomy is exactly one of `reallocation_threshold`\n *    or `reallocation_unlimited`\n *  - regulated-vertical `policy_categories` / Annex III `policy_ids` require\n *    `human_review_required: true`\n *\n * The helpers never mutate their inputs. The validator is intentionally\n * advisory — the authoritative check happens in the governance agent, which\n * resolves category synonyms and custom policies server-side.\n */\n\n/**\n * `policy_categories` values that MUST set `human_review_required: true`\n * under GDPR Art 22 / EU AI Act Annex III. Matches the schema's `if/then`\n * constraint on `sync-plans-request.json`. Governance agents resolve\n * synonyms and custom policies server-side; this list is the client-side\n * minimum for pre-submit validation.\n */\nexport const REGULATED_HUMAN_REVIEW_CATEGORIES = Object.freeze([\n  'fair_housing',\n  'fair_lending',\n  'fair_employment',\n  'pharmaceutical_advertising',\n] as const);\n\n/**\n * `policy_ids` values that MUST set `human_review_required: true`.\n * Client-enforced minimum; server-side resolution remains authoritative.\n */\nexport const ANNEX_III_POLICY_IDS = Object.freeze(['eu_ai_act_annex_iii'] as const);\n\n/**\n * Budget reallocation autonomy. Exactly one field must be set; the runtime\n * validator `validateGovernancePlan` is the source of truth. The structural\n * type does not enforce mutual exclusion because `PlanBudget` carries an\n * index signature for forward-compatibility with schema additions.\n */\nexport type ReallocationAutonomy = { reallocation_unlimited: true } | { reallocation_threshold: number };\n\nexport interface PlanBudget {\n  total: number;\n  currency: string;\n  reallocation_threshold?: number;\n  reallocation_unlimited?: boolean;\n  [k: string]: unknown;\n}\n\nexport interface DataSubjectContestation {\n  url?: string;\n  email?: string;\n  languages?: string[];\n  [k: string]: unknown;\n}\n\nexport interface HumanOverride {\n  reason: string;\n  approver: string;\n  approved_at: string;\n}\n\nexport interface GovernancePlan {\n  plan_id: string;\n  brand: { domain: string; [k: string]: unknown };\n  objectives: string;\n  budget: PlanBudget;\n  flight: { start: string; end: string; [k: string]: unknown };\n  policy_categories?: string[];\n  policy_ids?: string[];\n  human_review_required?: boolean;\n  human_override?: HumanOverride;\n  data_subject_contestation?: DataSubjectContestation;\n  [k: string]: unknown;\n}\n\nexport interface BuildHumanReviewPlanInput {\n  plan_id: string;\n  brand: { domain: string; [k: string]: unknown };\n  objectives: string;\n  budget: Omit<PlanBudget, 'reallocation_threshold' | 'reallocation_unlimited'> & ReallocationAutonomy;\n  flight: { start: string; end: string; [k: string]: unknown };\n  policy_categories?: string[];\n  policy_ids?: string[];\n  data_subject_contestation?: DataSubjectContestation;\n  [k: string]: unknown;\n}\n\n/**\n * Stamp `human_review_required: true` on a plan. The caller remains\n * responsible for declaring the reason for human review through\n * `policy_categories` (e.g. `'fair_lending'`) or `policy_ids` (e.g.\n * `'eu_ai_act_annex_iii'`). This helper does not infer or set either.\n *\n * Call `validateGovernancePlan` on the returned plan before `sync_plans`\n * to verify the reallocation autonomy and regulated-vertical invariants.\n */\nexport function buildHumanReviewPlan(input: BuildHumanReviewPlanInput): GovernancePlan {\n  return {\n    ...input,\n    human_review_required: true,\n  } as GovernancePlan;\n}\n\nexport interface BuildHumanOverrideInput {\n  reason: string;\n  approver: string;\n  approvedAt?: string | Date;\n}\n\nconst EMAIL_PATTERN = /^[^\\s@.]+(?:\\.[^\\s@.]+)*@[^\\s@.]+(?:\\.[^\\s@.]+)*\\.[^\\s@.]{2,}$/;\nconst CONTROL_CHAR_PATTERN = /[\\x00-\\x1F\\x7F]/;\nconst MIN_REASON_LENGTH = 20;\n\nfunction assertParseableIsoTimestamp(value: string, field: string): void {\n  const parsed = Date.parse(value);\n  if (Number.isNaN(parsed)) {\n    throw new Error(`${field} must be a parseable ISO 8601 timestamp (got \"${value}\")`);\n  }\n}\n\n/**\n * Build a `human_override` artifact for downgrading `human_review_required`\n * on a plan re-sync. Validates that the reason is substantive (≥20\n * characters after trimming edge whitespace), the approver is an email,\n * and no control characters appear in either field (audit-log safety).\n *\n * `approvedAt` defaults to the current ISO timestamp. Callers recording\n * a retroactive approval should pass the human's decision time explicitly.\n *\n * Throws `Error` with a descriptive message on invalid input.\n */\nexport function buildHumanOverride(input: BuildHumanOverrideInput): HumanOverride {\n  const reason = input.reason.trim();\n  if (reason.length < MIN_REASON_LENGTH) {\n    throw new Error(`human_override.reason must be at least ${MIN_REASON_LENGTH} characters (got ${reason.length})`);\n  }\n  if (CONTROL_CHAR_PATTERN.test(reason)) {\n    throw new Error('human_override.reason must not contain control characters');\n  }\n\n  const approver = input.approver.trim();\n  if (CONTROL_CHAR_PATTERN.test(approver)) {\n    throw new Error('human_override.approver must not contain control characters');\n  }\n  if (!EMAIL_PATTERN.test(approver)) {\n    throw new Error(`human_override.approver must be an email address (got \"${approver}\")`);\n  }\n\n  let approvedAt: string;\n  if (input.approvedAt instanceof Date) {\n    if (Number.isNaN(input.approvedAt.getTime())) {\n      throw new Error('human_override.approvedAt is an invalid Date');\n    }\n    approvedAt = input.approvedAt.toISOString();\n  } else if (typeof input.approvedAt === 'string') {\n    assertParseableIsoTimestamp(input.approvedAt, 'human_override.approvedAt');\n    approvedAt = input.approvedAt;\n  } else {\n    approvedAt = new Date().toISOString();\n  }\n\n  return { reason, approver, approved_at: approvedAt };\n}\n\nexport interface GovernanceValidationIssue {\n  code:\n    | 'budget.reallocation_both_set'\n    | 'budget.reallocation_missing'\n    | 'budget.reallocation_threshold_negative'\n    | 'plan.human_review_required_missing';\n  path: string;\n  message: string;\n}\n\n/**\n * Client-side check for plan-level invariants that generated types often\n * drop from `if/then` / `oneOf`. Complements the Zod request schema, which\n * covers structural validation (required fields, value types).\n *\n * Runs two checks:\n *\n *  - When `budget` is present: exactly one of `reallocation_threshold` /\n *    `reallocation_unlimited` must be set, and `reallocation_threshold`\n *    must be ≥ 0. Missing `budget` is **not** flagged — leave structural\n *    validation to the Zod schema.\n *  - When `policy_categories` includes a value in\n *    `REGULATED_HUMAN_REVIEW_CATEGORIES`, or `policy_ids` includes a value\n *    in `ANNEX_III_POLICY_IDS`, `human_review_required: true` is required.\n *    Governance agents resolve synonyms and custom policies server-side;\n *    this check is a best-effort pre-submit guard for the canonical names.\n *\n * Returns `[]` when no client-detectable invariants are violated. Callers\n * should still treat the governance agent as authoritative.\n */\nexport function validateGovernancePlan(plan: Partial<GovernancePlan>): GovernanceValidationIssue[] {\n  const issues: GovernanceValidationIssue[] = [];\n\n  if (plan.budget) {\n    const hasThreshold = typeof plan.budget.reallocation_threshold === 'number';\n    const hasUnlimited = plan.budget.reallocation_unlimited === true;\n\n    if (hasThreshold && hasUnlimited) {\n      issues.push({\n        code: 'budget.reallocation_both_set',\n        path: 'budget',\n        message: 'budget.reallocation_threshold and budget.reallocation_unlimited are mutually exclusive',\n      });\n    } else if (!hasThreshold && !hasUnlimited) {\n      issues.push({\n        code: 'budget.reallocation_missing',\n        path: 'budget',\n        message: 'budget must set exactly one of reallocation_threshold or reallocation_unlimited',\n      });\n    }\n\n    if (hasThreshold && (plan.budget.reallocation_threshold as number) < 0) {\n      issues.push({\n        code: 'budget.reallocation_threshold_negative',\n        path: 'budget.reallocation_threshold',\n        message: 'budget.reallocation_threshold must be ≥ 0',\n      });\n    }\n  }\n\n  const regulatedCategories = (plan.policy_categories ?? []).filter(c =>\n    (REGULATED_HUMAN_REVIEW_CATEGORIES as readonly string[]).includes(c)\n  );\n  const annexIIIIds = (plan.policy_ids ?? []).filter(id => (ANNEX_III_POLICY_IDS as readonly string[]).includes(id));\n\n  if ((regulatedCategories.length > 0 || annexIIIIds.length > 0) && plan.human_review_required !== true) {\n    const reasons: string[] = [];\n    if (regulatedCategories.length > 0) {\n      reasons.push(`policy_categories includes [${regulatedCategories.join(', ')}]`);\n    }\n    if (annexIIIIds.length > 0) {\n      reasons.push(`policy_ids includes [${annexIIIIds.join(', ')}]`);\n    }\n    issues.push({\n      code: 'plan.human_review_required_missing',\n      path: 'human_review_required',\n      message: `human_review_required must be true when ${reasons.join(' or ')}`,\n    });\n  }\n\n  return issues;\n}\n"],"mappings":";;;;;;AAuBO,MAAM,oCAAoC,OAAO,OAAO;AAAA,EAC7D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAU;AAMH,MAAM,uBAAuB,OAAO,OAAO,CAAC,qBAAqB,CAAU;AAkE3E,SAAS,qBAAqB,OAAkD;AACrF,SAAO;AAAA,IACL,GAAG;AAAA,IACH,uBAAuB;AAAA,EACzB;AACF;AAQA,MAAM,gBAAgB;AACtB,MAAM,uBAAuB;AAC7B,MAAM,oBAAoB;AAE1B,SAAS,4BAA4B,OAAe,OAAqB;AACvE,QAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,MAAI,OAAO,MAAM,MAAM,GAAG;AACxB,UAAM,IAAI,MAAM,GAAG,KAAK,iDAAiD,KAAK,IAAI;AAAA,EACpF;AACF;AAaO,SAAS,mBAAmB,OAA+C;AAChF,QAAM,SAAS,MAAM,OAAO,KAAK;AACjC,MAAI,OAAO,SAAS,mBAAmB;AACrC,UAAM,IAAI,MAAM,0CAA0C,iBAAiB,oBAAoB,OAAO,MAAM,GAAG;AAAA,EACjH;AACA,MAAI,qBAAqB,KAAK,MAAM,GAAG;AACrC,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AAEA,QAAM,WAAW,MAAM,SAAS,KAAK;AACrC,MAAI,qBAAqB,KAAK,QAAQ,GAAG;AACvC,UAAM,IAAI,MAAM,6DAA6D;AAAA,EAC/E;AACA,MAAI,CAAC,cAAc,KAAK,QAAQ,GAAG;AACjC,UAAM,IAAI,MAAM,0DAA0D,QAAQ,IAAI;AAAA,EACxF;AAEA,MAAI;AACJ,MAAI,MAAM,sBAAsB,MAAM;AACpC,QAAI,OAAO,MAAM,MAAM,WAAW,QAAQ,CAAC,GAAG;AAC5C,YAAM,IAAI,MAAM,8CAA8C;AAAA,IAChE;AACA,iBAAa,MAAM,WAAW,YAAY;AAAA,EAC5C,WAAW,OAAO,MAAM,eAAe,UAAU;AAC/C,gCAA4B,MAAM,YAAY,2BAA2B;AACzE,iBAAa,MAAM;AAAA,EACrB,OAAO;AACL,kBAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,EACtC;AAEA,SAAO,EAAE,QAAQ,UAAU,aAAa,WAAW;AACrD;AAgCO,SAAS,uBAAuB,MAA4D;AACjG,QAAM,SAAsC,CAAC;AAE7C,MAAI,KAAK,QAAQ;AACf,UAAM,eAAe,OAAO,KAAK,OAAO,2BAA2B;AACnE,UAAM,eAAe,KAAK,OAAO,2BAA2B;AAE5D,QAAI,gBAAgB,cAAc;AAChC,aAAO,KAAK;AAAA,QACV,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS;AAAA,MACX,CAAC;AAAA,IACH,WAAW,CAAC,gBAAgB,CAAC,cAAc;AACzC,aAAO,KAAK;AAAA,QACV,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AAEA,QAAI,gBAAiB,KAAK,OAAO,yBAAoC,GAAG;AACtE,aAAO,KAAK;AAAA,QACV,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,uBAAuB,KAAK,qBAAqB,CAAC,GAAG;AAAA,IAAO,OAC/D,kCAAwD,SAAS,CAAC;AAAA,EACrE;AACA,QAAM,eAAe,KAAK,cAAc,CAAC,GAAG,OAAO,QAAO,qBAA2C,SAAS,EAAE,CAAC;AAEjH,OAAK,oBAAoB,SAAS,KAAK,YAAY,SAAS,MAAM,KAAK,0BAA0B,MAAM;AACrG,UAAM,UAAoB,CAAC;AAC3B,QAAI,oBAAoB,SAAS,GAAG;AAClC,cAAQ,KAAK,+BAA+B,oBAAoB,KAAK,IAAI,CAAC,GAAG;AAAA,IAC/E;AACA,QAAI,YAAY,SAAS,GAAG;AAC1B,cAAQ,KAAK,wBAAwB,YAAY,KAAK,IAAI,CAAC,GAAG;AAAA,IAChE;AACA,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,MAAM;AAAA,MACN,SAAS,2CAA2C,QAAQ,KAAK,MAAM,CAAC;AAAA,IAC1E,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../src/lib/governance/index.ts"],"sourcesContent":["/**\n * Governance plan helpers — GDPR Art 22 / EU AI Act Annex III invariants.\n *\n * These helpers complement the Zod-generated request schemas by exposing\n * constraints that `datamodel-code-generator`-style codegen commonly drops\n * from `if/then` and `oneOf`:\n *  - budget reallocation autonomy is exactly one of `reallocation_threshold`\n *    or `reallocation_unlimited`\n *  - regulated-vertical `policy_categories` / Annex III `policy_ids` require\n *    `human_review_required: true`\n *\n * The helpers never mutate their inputs. The validator is intentionally\n * advisory — the authoritative check happens in the governance agent, which\n * resolves category synonyms and custom policies server-side.\n */\n\n/**\n * `policy_categories` values that MUST set `human_review_required: true`\n * under GDPR Art 22 / EU AI Act Annex III. Matches the schema's `if/then`\n * constraint on `sync-plans-request.json`. Governance agents resolve\n * synonyms and custom policies server-side; this list is the client-side\n * minimum for pre-submit validation.\n */\nexport const REGULATED_HUMAN_REVIEW_CATEGORIES = Object.freeze([\n  'fair_housing',\n  'fair_lending',\n  'fair_employment',\n  'pharmaceutical_advertising',\n] as const);\n\n/**\n * `policy_ids` values that MUST set `human_review_required: true`.\n * Client-enforced minimum; server-side resolution remains authoritative.\n */\nexport const ANNEX_III_POLICY_IDS = Object.freeze(['eu_ai_act_annex_iii'] as const);\n\n/**\n * Budget reallocation autonomy. Exactly one field must be set; the runtime\n * validator `validateGovernancePlan` is the source of truth. The structural\n * type does not enforce mutual exclusion because `PlanBudget` carries an\n * index signature for forward-compatibility with schema additions.\n */\nexport type ReallocationAutonomy = { reallocation_unlimited: true } | { reallocation_threshold: number };\n\nexport interface PlanBudget {\n  total: number;\n  currency: string;\n  reallocation_threshold?: number;\n  reallocation_unlimited?: boolean;\n  [k: string]: unknown;\n}\n\nexport interface DataSubjectContestation {\n  url?: string;\n  email?: string;\n  languages?: string[];\n  [k: string]: unknown;\n}\n\nexport interface HumanOverride {\n  reason: string;\n  approver: string;\n  approved_at: string;\n}\n\nexport interface GovernancePlan {\n  plan_id: string;\n  brand: { domain: string; [k: string]: unknown };\n  objectives: string;\n  budget: PlanBudget;\n  flight: { start: string; end: string; [k: string]: unknown };\n  policy_categories?: string[];\n  policy_ids?: string[];\n  human_review_required?: boolean;\n  human_override?: HumanOverride;\n  data_subject_contestation?: DataSubjectContestation;\n  [k: string]: unknown;\n}\n\nexport interface BuildHumanReviewPlanInput {\n  plan_id: string;\n  brand: { domain: string; [k: string]: unknown };\n  objectives: string;\n  budget: Omit<PlanBudget, 'reallocation_threshold' | 'reallocation_unlimited'> & ReallocationAutonomy;\n  flight: { start: string; end: string; [k: string]: unknown };\n  policy_categories?: string[];\n  policy_ids?: string[];\n  data_subject_contestation?: DataSubjectContestation;\n  [k: string]: unknown;\n}\n\n/**\n * Stamp `human_review_required: true` on a plan. The caller remains\n * responsible for declaring the reason for human review through\n * `policy_categories` (e.g. `'fair_lending'`) or `policy_ids` (e.g.\n * `'eu_ai_act_annex_iii'`). This helper does not infer or set either.\n *\n * Call `validateGovernancePlan` on the returned plan before `sync_plans`\n * to verify the reallocation autonomy and regulated-vertical invariants.\n */\nexport function buildHumanReviewPlan(input: BuildHumanReviewPlanInput): GovernancePlan {\n  return {\n    ...input,\n    human_review_required: true,\n  } as GovernancePlan;\n}\n\nexport interface BuildHumanOverrideInput {\n  reason: string;\n  approver: string;\n  approvedAt?: string | Date;\n}\n\nconst EMAIL_PATTERN = /^[^\\s@.]+(?:\\.[^\\s@.]+)*@[^\\s@.]+(?:\\.[^\\s@.]+)*\\.[^\\s@.]{2,}$/;\nconst CONTROL_CHAR_PATTERN = /[\\x00-\\x1F\\x7F]/;\nconst MIN_REASON_LENGTH = 20;\n\nfunction assertParseableIsoTimestamp(value: string, field: string): void {\n  const parsed = Date.parse(value);\n  if (Number.isNaN(parsed)) {\n    throw new Error(`${field} must be a parseable ISO 8601 timestamp (got \"${value}\")`);\n  }\n}\n\n/**\n * Build a `human_override` artifact for downgrading `human_review_required`\n * on a plan re-sync. Validates that the reason is substantive (≥20\n * characters after trimming edge whitespace), the approver is an email,\n * and no control characters appear in either field (audit-log safety).\n *\n * `approvedAt` defaults to the current ISO timestamp. Callers recording\n * a retroactive approval should pass the human's decision time explicitly.\n *\n * Throws `Error` with a descriptive message on invalid input.\n */\nexport function buildHumanOverride(input: BuildHumanOverrideInput): HumanOverride {\n  const reason = input.reason.trim();\n  if (reason.length < MIN_REASON_LENGTH) {\n    throw new Error(`human_override.reason must be at least ${MIN_REASON_LENGTH} characters (got ${reason.length})`);\n  }\n  if (CONTROL_CHAR_PATTERN.test(reason)) {\n    throw new Error('human_override.reason must not contain control characters');\n  }\n\n  const approver = input.approver.trim();\n  if (CONTROL_CHAR_PATTERN.test(approver)) {\n    throw new Error('human_override.approver must not contain control characters');\n  }\n  if (!EMAIL_PATTERN.test(approver)) {\n    throw new Error(`human_override.approver must be an email address (got \"${approver}\")`);\n  }\n\n  let approvedAt: string;\n  if (input.approvedAt instanceof Date) {\n    if (Number.isNaN(input.approvedAt.getTime())) {\n      throw new Error('human_override.approvedAt is an invalid Date');\n    }\n    approvedAt = input.approvedAt.toISOString();\n  } else if (typeof input.approvedAt === 'string') {\n    assertParseableIsoTimestamp(input.approvedAt, 'human_override.approvedAt');\n    approvedAt = input.approvedAt;\n  } else {\n    approvedAt = new Date().toISOString();\n  }\n\n  return { reason, approver, approved_at: approvedAt };\n}\n\nexport interface GovernanceValidationIssue {\n  code:\n    | 'budget.reallocation_both_set'\n    | 'budget.reallocation_missing'\n    | 'budget.reallocation_threshold_negative'\n    | 'plan.human_review_required_missing';\n  path: string;\n  message: string;\n}\n\n/**\n * Client-side check for plan-level invariants that generated types often\n * drop from `if/then` / `oneOf`. Complements the Zod request schema, which\n * covers structural validation (required fields, value types).\n *\n * Runs two checks:\n *\n *  - When `budget` is present: exactly one of `reallocation_threshold` /\n *    `reallocation_unlimited` must be set, and `reallocation_threshold`\n *    must be ≥ 0. Missing `budget` is **not** flagged — leave structural\n *    validation to the Zod schema.\n *  - When `policy_categories` includes a value in\n *    `REGULATED_HUMAN_REVIEW_CATEGORIES`, or `policy_ids` includes a value\n *    in `ANNEX_III_POLICY_IDS`, `human_review_required: true` is required.\n *    Governance agents resolve synonyms and custom policies server-side;\n *    this check is a best-effort pre-submit guard for the canonical names.\n *\n * Returns `[]` when no client-detectable invariants are violated. Callers\n * should still treat the governance agent as authoritative.\n */\nexport function validateGovernancePlan(plan: Partial<GovernancePlan>): GovernanceValidationIssue[] {\n  const issues: GovernanceValidationIssue[] = [];\n\n  if (plan.budget) {\n    const hasThreshold = typeof plan.budget.reallocation_threshold === 'number';\n    const hasUnlimited = plan.budget.reallocation_unlimited === true;\n\n    if (hasThreshold && hasUnlimited) {\n      issues.push({\n        code: 'budget.reallocation_both_set',\n        path: 'budget',\n        message: 'budget.reallocation_threshold and budget.reallocation_unlimited are mutually exclusive',\n      });\n    } else if (!hasThreshold && !hasUnlimited) {\n      issues.push({\n        code: 'budget.reallocation_missing',\n        path: 'budget',\n        message: 'budget must set exactly one of reallocation_threshold or reallocation_unlimited',\n      });\n    }\n\n    if (hasThreshold && (plan.budget.reallocation_threshold as number) < 0) {\n      issues.push({\n        code: 'budget.reallocation_threshold_negative',\n        path: 'budget.reallocation_threshold',\n        message: 'budget.reallocation_threshold must be ≥ 0',\n      });\n    }\n  }\n\n  const regulatedCategories = (plan.policy_categories ?? []).filter(c =>\n    (REGULATED_HUMAN_REVIEW_CATEGORIES as readonly string[]).includes(c)\n  );\n  const annexIIIIds = (plan.policy_ids ?? []).filter(id => (ANNEX_III_POLICY_IDS as readonly string[]).includes(id));\n\n  if ((regulatedCategories.length > 0 || annexIIIIds.length > 0) && plan.human_review_required !== true) {\n    const reasons: string[] = [];\n    if (regulatedCategories.length > 0) {\n      reasons.push(`policy_categories includes [${regulatedCategories.join(', ')}]`);\n    }\n    if (annexIIIIds.length > 0) {\n      reasons.push(`policy_ids includes [${annexIIIIds.join(', ')}]`);\n    }\n    issues.push({\n      code: 'plan.human_review_required_missing',\n      path: 'human_review_required',\n      message: `human_review_required must be true when ${reasons.join(' or ')}`,\n    });\n  }\n\n  return issues;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/handlers/types.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);
 const autoApproveHandler = (context) => {
   return true;
 };

package/dist/lib/handlers/types.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/handlers/types.ts"],"sourcesContent":["// Input handler types and utilities for ADCP conversation flow\n\nimport type { InputHandler, InputHandlerResponse, ConversationContext } from '../core/ConversationTypes';\n\n/**\n * Pre-built input handler for automatic approval\n * Always returns true for any input request\n */\nexport const autoApproveHandler: InputHandler = (context: ConversationContext) => {\n  return true;\n};\n\n/**\n * Pre-built input handler that defers everything to humans\n * Useful for production scenarios where human oversight is required\n */\nexport const deferAllHandler: InputHandler = async (context: ConversationContext) => {\n  return context.deferToHuman();\n};\n\n/**\n * Field-specific handler configuration\n */\nexport interface FieldHandlerConfig {\n  [fieldName: string]: any | ((context: ConversationContext) => any);\n}\n\n/**\n * Create a field-specific handler that provides different responses based on the field being requested\n *\n * @param fieldMap - Map of field names to responses or response functions\n * @param defaultResponse - Default response for unmapped fields (defaults to defer)\n *\n * @example\n * ```typescript\n * const handler = createFieldHandler({\n *   budget: 50000,\n *   targeting: ['US', 'CA'],\n *   approval: (context) => context.attempt === 1 ? true : false\n * });\n * ```\n */\nexport function createFieldHandler(fieldMap: FieldHandlerConfig, defaultResponse?: any | InputHandler): InputHandler {\n  return async (context: ConversationContext) => {\n    const field = context.inputRequest.field;\n\n    if (field && field in fieldMap) {\n      const response = fieldMap[field];\n      if (typeof response === 'function') {\n        return response(context);\n      }\n      return response;\n    }\n\n    // Use default response or defer to human\n    if (defaultResponse !== undefined) {\n      if (typeof defaultResponse === 'function') {\n        return defaultResponse(context);\n      }\n      return defaultResponse;\n    }\n\n    return context.deferToHuman();\n  };\n}\n\n/**\n * Create a conditional handler that applies different logic based on context\n *\n * @param conditions - Array of condition/handler pairs\n * @param defaultHandler - Handler to use if no conditions match\n *\n * @example\n * ```typescript\n * const handler = createConditionalHandler([\n *   {\n *     condition: (ctx) => ctx.inputRequest.field === 'budget',\n *     handler: (ctx) => ctx.attempt === 1 ? 100000 : 50000\n *   },\n *   {\n *     condition: (ctx) => ctx.agent.name.includes('Premium'),\n *     handler: autoApproveHandler\n *   }\n * ], deferAllHandler);\n * ```\n */\nexport function createConditionalHandler(\n  conditions: Array<{\n    condition: (context: ConversationContext) => boolean;\n    handler: InputHandler;\n  }>,\n  defaultHandler: InputHandler = deferAllHandler\n): InputHandler {\n  return async (context: ConversationContext) => {\n    for (const { condition, handler } of conditions) {\n      if (condition(context)) {\n        return handler(context);\n      }\n    }\n    return defaultHandler(context);\n  };\n}\n\n/**\n * Create a retry handler that provides different responses based on attempt number\n *\n * @param responses - Array of responses for each attempt (1-indexed)\n * @param defaultResponse - Response to use for attempts beyond the array length\n *\n * @example\n * ```typescript\n * const handler = createRetryHandler([\n *   100000,  // First attempt\n *   50000,   // Second attempt\n *   25000    // Third attempt\n * ], deferAllHandler);\n * ```\n */\nexport function createRetryHandler(\n  responses: any[],\n  defaultResponse: any | InputHandler = deferAllHandler\n): InputHandler {\n  return async (context: ConversationContext) => {\n    const attemptIndex = context.attempt - 1;\n\n    if (attemptIndex < responses.length) {\n      const response = responses[attemptIndex];\n      if (typeof response === 'function') {\n        return response(context);\n      }\n      return response;\n    }\n\n    if (typeof defaultResponse === 'function') {\n      return defaultResponse(context);\n    }\n    return defaultResponse;\n  };\n}\n\n/**\n * Create a suggestion-based handler that uses agent suggestions when available\n *\n * @param suggestionIndex - Index of suggestion to use (0 = first, -1 = last)\n * @param fallbackHandler - Handler to use if no suggestions available\n *\n * @example\n * ```typescript\n * const handler = createSuggestionHandler(0, deferAllHandler); // Use first suggestion\n * ```\n */\nexport function createSuggestionHandler(\n  suggestionIndex: number = 0,\n  fallbackHandler: InputHandler = deferAllHandler\n): InputHandler {\n  return async (context: ConversationContext) => {\n    const suggestions = context.inputRequest.suggestions;\n\n    if (suggestions && suggestions.length > 0) {\n      if (suggestionIndex === -1) {\n        return suggestions[suggestions.length - 1];\n      }\n      if (suggestionIndex >= 0 && suggestionIndex < suggestions.length) {\n        return suggestions[suggestionIndex];\n      }\n    }\n\n    return fallbackHandler(context);\n  };\n}\n\n/**\n * Create a validation-aware handler that respects input validation rules\n *\n * @param value - Value to return\n * @param fallbackHandler - Handler to use if value doesn't pass validation\n */\nexport function createValidatedHandler(value: any, fallbackHandler: InputHandler = deferAllHandler): InputHandler {\n  return async (context: ConversationContext) => {\n    const validation = context.inputRequest.validation;\n\n    if (!validation) {\n      return value;\n    }\n\n    // Basic validation checks\n    if (validation.enum && !validation.enum.includes(value)) {\n      return fallbackHandler(context);\n    }\n\n    if (typeof value === 'number') {\n      if (validation.min !== undefined && value < validation.min) {\n        return fallbackHandler(context);\n      }\n      if (validation.max !== undefined && value > validation.max) {\n        return fallbackHandler(context);\n      }\n    }\n\n    if (typeof value === 'string' && validation.pattern) {\n      const regex = new RegExp(validation.pattern);\n      if (!regex.test(value)) {\n        return fallbackHandler(context);\n      }\n    }\n\n    return value;\n  };\n}\n\n/**\n * Combine multiple handlers with fallback logic\n * Tries each handler in order until one succeeds (doesn't defer or abort)\n *\n * @param handlers - Array of handlers to try in order\n * @param defaultHandler - Final fallback handler\n */\nexport function combineHandlers(\n  handlers: InputHandler[],\n  defaultHandler: InputHandler = deferAllHandler\n): InputHandler {\n  return async (context: ConversationContext) => {\n    for (const handler of handlers) {\n      try {\n        const result = await handler(context);\n\n        // If result is a defer object, try next handler\n        if (typeof result === 'object' && result?.defer === true) {\n          continue;\n        }\n\n        // If result is an abort object, try next handler\n        if (typeof result === 'object' && result?.abort === true) {\n          continue;\n        }\n\n        return result;\n      } catch (error) {\n        // If handler throws, try next one\n        continue;\n      }\n    }\n\n    return defaultHandler(context);\n  };\n}\n\n/**\n * Type guard to check if a response is a defer response\n */\nexport function isDeferResponse(response: any): response is { defer: true; token: string } {\n  return typeof response === 'object' && response?.defer === true && typeof response?.token === 'string';\n}\n\n/**\n * Type guard to check if a response is an abort response\n */\nexport function isAbortResponse(response: any): response is { abort: true; reason?: string } {\n  return typeof response === 'object' && response?.abort === true;\n}\n\n/**\n * Utility to normalize handler responses\n */\nexport async function normalizeHandlerResponse(\n  response: InputHandlerResponse,\n  context: ConversationContext\n): Promise<any> {\n  const resolved = await response;\n\n  if (isDeferResponse(resolved)) {\n    throw new Error(`Task deferred with token: ${resolved.token}`);\n  }\n\n  if (isAbortResponse(resolved)) {\n    throw new Error(`Task aborted: ${resolved.reason || 'No reason provided'}`);\n  }\n\n  return resolved;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/lib/handlers/types.ts"],"sourcesContent":["// Input handler types and utilities for ADCP conversation flow\n\nimport type { InputHandler, InputHandlerResponse, ConversationContext } from '../core/ConversationTypes';\n\n/**\n * Pre-built input handler for automatic approval\n * Always returns true for any input request\n */\nexport const autoApproveHandler: InputHandler = (context: ConversationContext) => {\n  return true;\n};\n\n/**\n * Pre-built input handler that defers everything to humans\n * Useful for production scenarios where human oversight is required\n */\nexport const deferAllHandler: InputHandler = async (context: ConversationContext) => {\n  return context.deferToHuman();\n};\n\n/**\n * Field-specific handler configuration\n */\nexport interface FieldHandlerConfig {\n  [fieldName: string]: any | ((context: ConversationContext) => any);\n}\n\n/**\n * Create a field-specific handler that provides different responses based on the field being requested\n *\n * @param fieldMap - Map of field names to responses or response functions\n * @param defaultResponse - Default response for unmapped fields (defaults to defer)\n *\n * @example\n * ```typescript\n * const handler = createFieldHandler({\n *   budget: 50000,\n *   targeting: ['US', 'CA'],\n *   approval: (context) => context.attempt === 1 ? true : false\n * });\n * ```\n */\nexport function createFieldHandler(fieldMap: FieldHandlerConfig, defaultResponse?: any | InputHandler): InputHandler {\n  return async (context: ConversationContext) => {\n    const field = context.inputRequest.field;\n\n    if (field && field in fieldMap) {\n      const response = fieldMap[field];\n      if (typeof response === 'function') {\n        return response(context);\n      }\n      return response;\n    }\n\n    // Use default response or defer to human\n    if (defaultResponse !== undefined) {\n      if (typeof defaultResponse === 'function') {\n        return defaultResponse(context);\n      }\n      return defaultResponse;\n    }\n\n    return context.deferToHuman();\n  };\n}\n\n/**\n * Create a conditional handler that applies different logic based on context\n *\n * @param conditions - Array of condition/handler pairs\n * @param defaultHandler - Handler to use if no conditions match\n *\n * @example\n * ```typescript\n * const handler = createConditionalHandler([\n *   {\n *     condition: (ctx) => ctx.inputRequest.field === 'budget',\n *     handler: (ctx) => ctx.attempt === 1 ? 100000 : 50000\n *   },\n *   {\n *     condition: (ctx) => ctx.agent.name.includes('Premium'),\n *     handler: autoApproveHandler\n *   }\n * ], deferAllHandler);\n * ```\n */\nexport function createConditionalHandler(\n  conditions: Array<{\n    condition: (context: ConversationContext) => boolean;\n    handler: InputHandler;\n  }>,\n  defaultHandler: InputHandler = deferAllHandler\n): InputHandler {\n  return async (context: ConversationContext) => {\n    for (const { condition, handler } of conditions) {\n      if (condition(context)) {\n        return handler(context);\n      }\n    }\n    return defaultHandler(context);\n  };\n}\n\n/**\n * Create a retry handler that provides different responses based on attempt number\n *\n * @param responses - Array of responses for each attempt (1-indexed)\n * @param defaultResponse - Response to use for attempts beyond the array length\n *\n * @example\n * ```typescript\n * const handler = createRetryHandler([\n *   100000,  // First attempt\n *   50000,   // Second attempt\n *   25000    // Third attempt\n * ], deferAllHandler);\n * ```\n */\nexport function createRetryHandler(\n  responses: any[],\n  defaultResponse: any | InputHandler = deferAllHandler\n): InputHandler {\n  return async (context: ConversationContext) => {\n    const attemptIndex = context.attempt - 1;\n\n    if (attemptIndex < responses.length) {\n      const response = responses[attemptIndex];\n      if (typeof response === 'function') {\n        return response(context);\n      }\n      return response;\n    }\n\n    if (typeof defaultResponse === 'function') {\n      return defaultResponse(context);\n    }\n    return defaultResponse;\n  };\n}\n\n/**\n * Create a suggestion-based handler that uses agent suggestions when available\n *\n * @param suggestionIndex - Index of suggestion to use (0 = first, -1 = last)\n * @param fallbackHandler - Handler to use if no suggestions available\n *\n * @example\n * ```typescript\n * const handler = createSuggestionHandler(0, deferAllHandler); // Use first suggestion\n * ```\n */\nexport function createSuggestionHandler(\n  suggestionIndex: number = 0,\n  fallbackHandler: InputHandler = deferAllHandler\n): InputHandler {\n  return async (context: ConversationContext) => {\n    const suggestions = context.inputRequest.suggestions;\n\n    if (suggestions && suggestions.length > 0) {\n      if (suggestionIndex === -1) {\n        return suggestions[suggestions.length - 1];\n      }\n      if (suggestionIndex >= 0 && suggestionIndex < suggestions.length) {\n        return suggestions[suggestionIndex];\n      }\n    }\n\n    return fallbackHandler(context);\n  };\n}\n\n/**\n * Create a validation-aware handler that respects input validation rules\n *\n * @param value - Value to return\n * @param fallbackHandler - Handler to use if value doesn't pass validation\n */\nexport function createValidatedHandler(value: any, fallbackHandler: InputHandler = deferAllHandler): InputHandler {\n  return async (context: ConversationContext) => {\n    const validation = context.inputRequest.validation;\n\n    if (!validation) {\n      return value;\n    }\n\n    // Basic validation checks\n    if (validation.enum && !validation.enum.includes(value)) {\n      return fallbackHandler(context);\n    }\n\n    if (typeof value === 'number') {\n      if (validation.min !== undefined && value < validation.min) {\n        return fallbackHandler(context);\n      }\n      if (validation.max !== undefined && value > validation.max) {\n        return fallbackHandler(context);\n      }\n    }\n\n    if (typeof value === 'string' && validation.pattern) {\n      const regex = new RegExp(validation.pattern);\n      if (!regex.test(value)) {\n        return fallbackHandler(context);\n      }\n    }\n\n    return value;\n  };\n}\n\n/**\n * Combine multiple handlers with fallback logic\n * Tries each handler in order until one succeeds (doesn't defer or abort)\n *\n * @param handlers - Array of handlers to try in order\n * @param defaultHandler - Final fallback handler\n */\nexport function combineHandlers(\n  handlers: InputHandler[],\n  defaultHandler: InputHandler = deferAllHandler\n): InputHandler {\n  return async (context: ConversationContext) => {\n    for (const handler of handlers) {\n      try {\n        const result = await handler(context);\n\n        // If result is a defer object, try next handler\n        if (typeof result === 'object' && result?.defer === true) {\n          continue;\n        }\n\n        // If result is an abort object, try next handler\n        if (typeof result === 'object' && result?.abort === true) {\n          continue;\n        }\n\n        return result;\n      } catch (error) {\n        // If handler throws, try next one\n        continue;\n      }\n    }\n\n    return defaultHandler(context);\n  };\n}\n\n/**\n * Type guard to check if a response is a defer response\n */\nexport function isDeferResponse(response: any): response is { defer: true; token: string } {\n  return typeof response === 'object' && response?.defer === true && typeof response?.token === 'string';\n}\n\n/**\n * Type guard to check if a response is an abort response\n */\nexport function isAbortResponse(response: any): response is { abort: true; reason?: string } {\n  return typeof response === 'object' && response?.abort === true;\n}\n\n/**\n * Utility to normalize handler responses\n */\nexport async function normalizeHandlerResponse(\n  response: InputHandlerResponse,\n  context: ConversationContext\n): Promise<any> {\n  const resolved = await response;\n\n  if (isDeferResponse(resolved)) {\n    throw new Error(`Task deferred with token: ${resolved.token}`);\n  }\n\n  if (isAbortResponse(resolved)) {\n    throw new Error(`Task aborted: ${resolved.reason || 'No reason provided'}`);\n  }\n\n  return resolved;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/index.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 {
   RegistryClient,
   RegistrySync,