@adcp/sdk 12.1.1 → 13.0.0-rc.0

package/dist/lib/core/AsyncHandler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/core/AsyncHandler.ts"],"sourcesContent":["/**\n * Structured async handler for AdCP webhook responses\n * Provides type-safe callbacks for each AdCP tool completion\n */\n\nimport type { IdempotencyBackend } from '../server/idempotency/store';\nimport type {\n  ListCreativeFormatsResponse,\n  ListCreativesResponse,\n  PreviewCreativeResponse,\n  BuildCreativeResponse,\n  GetMediaBuysResponse,\n  GetMediaBuyDeliveryResponse,\n  ProvidePerformanceFeedbackResponse,\n  GetSignalsResponse,\n  ActivateSignalResponse,\n  ListAccountsResponse,\n  SyncAccountsResponse,\n  SyncAudiencesResponse,\n  CreatePropertyListResponse,\n  GetPropertyListResponse,\n  UpdatePropertyListResponse,\n  ListPropertyListsResponse,\n  DeletePropertyListResponse,\n  ListContentStandardsResponse,\n  GetContentStandardsResponse,\n  CalibrateContentResponse,\n  ValidateContentDeliveryResponse,\n  SIGetOfferingResponse,\n  SIInitiateSessionResponse,\n  SISendMessageResponse,\n  SITerminateSessionResponse,\n} from '../types/tools.generated';\n\nimport type {\n  AdCPAsyncResponseData,\n  CreateMediaBuyAsyncInputRequired,\n  CreateMediaBuyAsyncSubmitted,\n  CreateMediaBuyAsyncWorking,\n  CreateMediaBuyResponse,\n  GetProductsAsyncInputRequired,\n  GetProductsAsyncSubmitted,\n  GetProductsAsyncWorking,\n  GetProductsResponse,\n  SyncCreativesAsyncInputRequired,\n  SyncCreativesAsyncSubmitted,\n  SyncCreativesAsyncWorking,\n  SyncCreativesResponse,\n  TaskStatus,\n  TaskType,\n  UpdateMediaBuyAsyncInputRequired,\n  UpdateMediaBuyAsyncSubmitted,\n  UpdateMediaBuyAsyncWorking,\n  UpdateMediaBuyResponse,\n} from '../types/core.generated';\nimport type { TaskResultMetadata } from './ConversationTypes';\nimport {\n  CreateMediaBuyAsyncResponseData,\n  GetProductsAsyncResponseData,\n  SyncCreativesAsyncResponseData,\n  UpdateMediaBuyAsyncResponseData,\n} from '../types';\n\n/**\n * Metadata provided with webhook responses\n */\nexport interface WebhookMetadata {\n  /** Client-provided operation ID */\n  operation_id: string;\n  /** Server's task ID */\n  task_id: string;\n  /** Agent ID */\n  agent_id: string;\n  /** Task type/tool name */\n  task_type: string;\n  /** Task status (completed, failed, needs_input, working, etc) */\n  status: TaskStatus;\n  /** Server's context ID */\n  context_id?: string;\n  /** Human-readable context about the status change */\n  message?: string;\n  /** Timestamp */\n  timestamp: string;\n  /** raw HTTP payload */\n  rawHTTPPayload?: any;\n  /**\n   * Wire protocol that delivered this webhook. Useful for handler code\n   * that needs to treat MCP and A2A transports differently (e.g.,\n   * `idempotency_key` is only present on MCP payloads).\n   */\n  protocol?: 'mcp' | 'a2a';\n  /**\n   * Sender-generated key stable across retries of the same webhook event\n   * (MCP envelope only — A2A webhooks do not carry this field). Use this\n   * as the canonical dedup key; see `AsyncHandlerConfig.webhookDedup`.\n   */\n  idempotency_key?: string;\n  /**\n   * Buyer-side product property policy evaluation for completed get_products\n   * webhooks. Present when the client filters, audits, or rejects a webhook\n   * result before dispatching it to handlers.\n   */\n  productPropertyPolicy?: TaskResultMetadata['productPropertyPolicy'];\n  /**\n   * Buyer-side pricing-options enforcement summary for completed get_products\n   * webhooks. Present when the client drops products that arrived without a\n   * usable `pricing_options[]` array before dispatching to handlers.\n   */\n  productPricingPolicy?: TaskResultMetadata['productPricingPolicy'];\n}\n\n/**\n * Metadata for agent-initiated notifications\n * Same as WebhookMetadata but includes notification-specific fields\n */\nexport interface NotificationMetadata extends WebhookMetadata {\n  /** Notification type */\n  notification_type: 'scheduled' | 'final' | 'delayed';\n  /** Sequence number of this notification */\n  sequence_number?: number;\n  /** When next notification is expected (not present for 'final') */\n  next_expected_at?: string;\n}\n\n// Simple union-typed handlers for webhook status changes\nexport type GetProductsStatusChangeHandler = (\n  response: GetProductsResponse | GetProductsAsyncSubmitted | GetProductsAsyncWorking | GetProductsAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type CreateMediaBuyStatusChangeHandler = (\n  response:\n    | CreateMediaBuyResponse\n    | CreateMediaBuyAsyncSubmitted\n    | CreateMediaBuyAsyncWorking\n    | CreateMediaBuyAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type UpdateMediaBuyStatusChangeHandler = (\n  response:\n    | UpdateMediaBuyResponse\n    | UpdateMediaBuyAsyncSubmitted\n    | UpdateMediaBuyAsyncWorking\n    | UpdateMediaBuyAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type SyncCreativesStatusChangeHandler = (\n  response:\n    | SyncCreativesResponse\n    | SyncCreativesAsyncSubmitted\n    | SyncCreativesAsyncWorking\n    | SyncCreativesAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\n/**\n * Media buy delivery notification payload (PR #81)\n * Agent-initiated periodic reporting, not tied to any client operation\n */\nexport interface MediaBuyDeliveryNotification {\n  /** Type of notification */\n  notification_type: 'scheduled' | 'final' | 'delayed';\n  /** Sequential notification number (starts at 1) */\n  sequence_number?: number;\n  /** When next notification is expected (omitted for 'final') */\n  next_expected_at?: string;\n  /** Reporting period for this notification */\n  reporting_period?: {\n    start: string;\n    end: string;\n  };\n  /** Currency used for financial metrics */\n  currency?: string;\n  /** Array of media buy deliveries being reported */\n  media_buy_deliveries?: Array<{\n    media_buy_id: string;\n    impressions?: number;\n    clicks?: number;\n    spend?: number;\n    conversions?: number;\n    [key: string]: any;\n  }>;\n}\n\n/**\n * Activity event for logging/observability\n */\nexport interface Activity {\n  type:\n    | 'protocol_request'\n    | 'protocol_response'\n    | 'status_change'\n    | 'webhook_received'\n    | 'webhook_duplicate'\n    | 'governance_check'\n    | 'governance_outcome';\n  operation_id: string;\n  agent_id: string;\n  context_id?: string;\n  task_id?: string;\n  task_type: string;\n  status?: string;\n  /**\n   * Full AdCP response payload. Populated on `webhook_received` and\n   * protocol/status events. INTENTIONALLY omitted on `webhook_duplicate`\n   * to avoid re-logging potentially-sensitive data on every retry — the\n   * originating `webhook_received` event already carries it. Correlate\n   * the two via `idempotency_key`.\n   */\n  payload?: any;\n  /**\n   * Webhook idempotency key when available. Present on `webhook_received`\n   * and `webhook_duplicate` events from MCP envelopes, enabling\n   * correlation between a first delivery and its retry echoes.\n   */\n  idempotency_key?: string;\n  timestamp: string;\n}\n\n/**\n * Configuration for async handler with typed callbacks\n */\nexport interface AsyncHandlerConfig {\n  // AdCP tool status change handlers - called for ALL status changes (completed, failed, working, input-required, submitted)\n  onGetProductsStatusChange?: GetProductsStatusChangeHandler;\n  onListCreativeFormatsStatusChange?: (\n    data: ListCreativeFormatsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onCreateMediaBuyStatusChange?: CreateMediaBuyStatusChangeHandler;\n  onUpdateMediaBuyStatusChange?: UpdateMediaBuyStatusChangeHandler;\n  onSyncCreativesStatusChange?: SyncCreativesStatusChangeHandler;\n  onListCreativesStatusChange?: (response: ListCreativesResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onPreviewCreativeStatusChange?: (\n    response: PreviewCreativeResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetMediaBuysStatusChange?: (response: GetMediaBuysResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onGetMediaBuyDeliveryStatusChange?: (\n    response: GetMediaBuyDeliveryResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onProvidePerformanceFeedbackStatusChange?: (\n    response: ProvidePerformanceFeedbackResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetSignalsStatusChange?: (response: GetSignalsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onActivateSignalStatusChange?: (response: ActivateSignalResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onBuildCreativeStatusChange?: (response: BuildCreativeResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onListAccountsStatusChange?: (response: ListAccountsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSyncAccountsStatusChange?: (response: SyncAccountsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSyncAudiencesStatusChange?: (response: SyncAudiencesResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onCreatePropertyListStatusChange?: (\n    response: CreatePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetPropertyListStatusChange?: (\n    response: GetPropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onUpdatePropertyListStatusChange?: (\n    response: UpdatePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListPropertyListsStatusChange?: (\n    response: ListPropertyListsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onDeletePropertyListStatusChange?: (\n    response: DeletePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListContentStandardsStatusChange?: (\n    response: ListContentStandardsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetContentStandardsStatusChange?: (\n    response: GetContentStandardsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onCalibrateContentStatusChange?: (\n    response: CalibrateContentResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onValidateContentDeliveryStatusChange?: (\n    response: ValidateContentDeliveryResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onSIGetOfferingStatusChange?: (response: SIGetOfferingResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSIInitiateSessionStatusChange?: (\n    response: SIInitiateSessionResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onSISendMessageStatusChange?: (response: SISendMessageResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSITerminateSessionStatusChange?: (\n    response: SITerminateSessionResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n\n  // Fallback handler for any task status change\n  onTaskStatusChange?: (response: any, metadata: WebhookMetadata) => void | Promise<void>;\n\n  // Activity logging (low-level protocol events)\n  onActivity?: (activity: Activity) => void | Promise<void>;\n\n  /**\n   * Receiver-side deduplication of webhook payloads by `idempotency_key`.\n   *\n   * AdCP webhooks use at-least-once delivery — publishers retry until they\n   * see a 2xx, so the same event may arrive more than once. When configured,\n   * the first delivery for a given `(agent_id, idempotency_key)` tuple\n   * dispatches to handlers; subsequent deliveries are dropped and surface\n   * as a `webhook_duplicate` activity.\n   *\n   * Reuses `IdempotencyBackend` from `@adcp/sdk/server` — you can share\n   * the same backend across request-side and webhook-side dedup, or use a\n   * dedicated one. Scope is per-agent so keys from different senders are\n   * independent, matching the spec's \"scoped to authenticated sender\n   * identity\" rule.\n   *\n   * If a payload arrives without `idempotency_key` (non-conforming sender,\n   * or A2A transport which does not carry the field), dispatch proceeds\n   * without dedup and a warning is logged.\n   */\n  webhookDedup?: {\n    backend: IdempotencyBackend;\n    /** Retention for dedup keys. Defaults to 86_400 (24h). */\n    ttlSeconds?: number;\n  };\n\n  // Notification handlers (agent-initiated, no operation_id)\n  onMediaBuyDeliveryNotification?: (\n    notification: MediaBuyDeliveryNotification,\n    metadata: NotificationMetadata\n  ) => void | Promise<void>;\n}\n\n/**\n * Async handler class\n */\nexport class AsyncHandler {\n  constructor(private config: AsyncHandlerConfig) {}\n\n  /**\n   * Handle incoming webhook payload (both task completions and notifications)\n   */\n  async handleWebhook({\n    result,\n    metadata,\n  }: {\n    result: AdCPAsyncResponseData | undefined;\n    metadata: WebhookMetadata;\n  }): Promise<void> {\n    if (await this.isDuplicate(metadata)) {\n      await this.emitActivity({\n        type: 'webhook_duplicate',\n        operation_id: metadata.operation_id,\n        agent_id: metadata.agent_id,\n        context_id: metadata.context_id,\n        task_id: metadata.task_id,\n        task_type: metadata.task_type,\n        status: metadata.status,\n        idempotency_key: metadata.idempotency_key,\n        timestamp: metadata.timestamp,\n      });\n      return;\n    }\n\n    // Emit activity\n    await this.emitActivity({\n      type: 'webhook_received',\n      idempotency_key: metadata.idempotency_key,\n      operation_id: metadata.operation_id,\n      agent_id: metadata.agent_id,\n      context_id: metadata.context_id,\n      task_id: metadata.task_id,\n      task_type: metadata.task_type,\n      status: metadata.status,\n      payload: metadata.rawHTTPPayload?.result ?? result,\n      timestamp: metadata.timestamp,\n    });\n\n    // Check if this is a notification (media_buy_delivery with notification_type)\n    // Notifications are treated like status updates for an ongoing \"get delivery report\" operation\n    // The operation_id (from URL) groups all reports for the same agent + month\n    if (\n      metadata.task_type === 'media_buy_delivery' &&\n      result &&\n      typeof result === 'object' &&\n      'notification_type' in result\n    ) {\n      const notificationPayload = result as unknown as MediaBuyDeliveryNotification;\n\n      // Build notification metadata\n      // operation_id comes from webhook URL and was lazily generated from agent + month\n      const notificationMetadata: NotificationMetadata = {\n        ...metadata,\n        notification_type: notificationPayload.notification_type,\n        sequence_number: notificationPayload.sequence_number,\n        next_expected_at: notificationPayload.next_expected_at,\n      };\n\n      await this.config.onMediaBuyDeliveryNotification?.(notificationPayload, notificationMetadata);\n      return;\n    }\n\n    // All status changes go through the specific handler\n    // The handler receives metadata with status and can act accordingly\n    await this.handleCompletion(metadata.task_type, result, metadata);\n  }\n\n  /**\n   * Handle task completion - route to specific handler\n   */\n  private async handleCompletion(\n    taskType: string,\n    result: AdCPAsyncResponseData | undefined,\n    metadata: WebhookMetadata\n  ): Promise<void> {\n    let handler: ((result: any, metadata: any) => void | Promise<void>) | undefined;\n\n    // Route to specific handler based on task type\n    switch (taskType) {\n      case 'get_products':\n        handler = this.config.onGetProductsStatusChange;\n        break;\n\n      case 'list_creative_formats':\n        handler = this.config.onListCreativeFormatsStatusChange;\n        break;\n\n      case 'create_media_buy':\n        handler = this.config.onCreateMediaBuyStatusChange;\n        break;\n\n      case 'update_media_buy':\n        handler = this.config.onUpdateMediaBuyStatusChange;\n        break;\n\n      case 'sync_creatives':\n        handler = this.config.onSyncCreativesStatusChange;\n        break;\n\n      case 'list_creatives':\n        handler = this.config.onListCreativesStatusChange;\n        break;\n\n      case 'get_media_buys':\n        handler = this.config.onGetMediaBuysStatusChange;\n        break;\n\n      case 'get_media_buy_delivery':\n        handler = this.config.onGetMediaBuyDeliveryStatusChange;\n        break;\n\n      case 'provide_performance_feedback':\n        handler = this.config.onProvidePerformanceFeedbackStatusChange;\n        break;\n\n      case 'get_signals':\n        handler = this.config.onGetSignalsStatusChange;\n        break;\n\n      case 'activate_signal':\n        handler = this.config.onActivateSignalStatusChange;\n        break;\n    }\n\n    // Call specific handler if configured, otherwise fallback to generic handler\n    const handlerToCall = handler || this.config.onTaskStatusChange;\n\n    if (handlerToCall) {\n      try {\n        await handlerToCall(result, metadata);\n      } catch (error) {\n        // Log error but don't crash webhook processing\n        console.error(\n          `Error in handler for task ${taskType}:`,\n          error instanceof Error ? error.message : 'unknown error'\n        );\n      }\n    }\n  }\n\n  /**\n   * Emit activity event\n   */\n  private async emitActivity(activity: Activity): Promise<void> {\n    await this.config.onActivity?.(activity);\n  }\n\n  /**\n   * Claim the webhook for processing, returning true if the event has\n   * already been delivered for this `(agent_id, idempotency_key)` tuple.\n   *\n   * Uses `IdempotencyBackend.putIfAbsent` so concurrent retries race on a\n   * single claim: exactly one caller gets `true` and proceeds, the rest\n   * observe the existing entry and return.\n   */\n  private async isDuplicate(metadata: WebhookMetadata): Promise<boolean> {\n    const dedup = this.config.webhookDedup;\n    if (!dedup) return false;\n\n    const key = metadata.idempotency_key;\n    if (!key || !IDEMPOTENCY_KEY_PATTERN.test(key)) {\n      // No valid key. MCP senders MUST emit one per AdCP 3.0; A2A\n      // transport doesn't carry the field at all. Warn MCP (so\n      // integrators notice non-conforming publishers) and stay quiet\n      // for A2A (expected and unactionable).\n      if (metadata.protocol !== 'a2a') {\n        console.warn(\n          `[AdCP] webhookDedup enabled but webhook from agent=${metadata.agent_id} task=${metadata.task_id} has ${\n            key ? 'an invalid' : 'no'\n          } idempotency_key. Expected format: ${IDEMPOTENCY_KEY_PATTERN.source}. ` +\n            'Dispatching without dedup — duplicate deliveries from this sender will re-trigger handlers. ' +\n            'See docs/guides/PUSH-NOTIFICATION-CONFIG.md#deduplication'\n        );\n      }\n      return false;\n    }\n\n    const ttlSeconds = dedup.ttlSeconds ?? 86_400;\n    // Reserved prefix `adcp\\u001fwebhook\\u001fv1\\u001f...` namespaces the\n    // claim so webhook dedup entries can coexist with request-side\n    // idempotency entries in a shared backend — a request-side principal\n    // can never produce a scoped key with this prefix because the\n    // principal regex excludes U+001F.\n    const scopedKey = `adcp\\u001fwebhook\\u001fv1\\u001f${metadata.agent_id}\\u001f${key}`;\n    const expiresAt = Math.floor(Date.now() / 1000) + ttlSeconds;\n\n    const claimed = await dedup.backend.putIfAbsent(scopedKey, {\n      payloadHash: '',\n      response: null,\n      expiresAt,\n    });\n    return !claimed;\n  }\n}\n\n// AdCP spec: `^[A-Za-z0-9_.:-]{16,255}$`. Any key not matching this\n// pattern is malformed — treat as missing rather than forming a scoped\n// key from arbitrary sender-supplied bytes.\nconst IDEMPOTENCY_KEY_PATTERN = /^[A-Za-z0-9_.:-]{16,255}$/;\n\n/**\n * Factory function to create async handler\n */\nexport function createAsyncHandler(config: AsyncHandlerConfig): AsyncHandler {\n  return new AsyncHandler(config);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/lib/core/AsyncHandler.ts"],"sourcesContent":["/**\n * Structured async handler for AdCP webhook responses\n * Provides type-safe callbacks for each AdCP tool completion\n */\n\nimport type { IdempotencyBackend } from '../server/idempotency/store';\nimport type {\n  ListCreativeFormatsResponse,\n  ListCreativesResponse,\n  PreviewCreativeResponse,\n  BuildCreativeResponse,\n  GetMediaBuysResponse,\n  GetMediaBuyDeliveryResponse,\n  GetCreativeDeliveryResponse,\n  ProvidePerformanceFeedbackResponse,\n  GetSignalsResponse,\n  ActivateSignalResponse,\n  ListAccountsResponse,\n  SyncAccountsResponse,\n  SyncAudiencesResponse,\n  CreatePropertyListResponse,\n  GetPropertyListResponse,\n  UpdatePropertyListResponse,\n  ListPropertyListsResponse,\n  DeletePropertyListResponse,\n  ListContentStandardsResponse,\n  GetContentStandardsResponse,\n  CalibrateContentResponse,\n  ValidateContentDeliveryResponse,\n  SIGetOfferingResponse,\n  SIInitiateSessionResponse,\n  SISendMessageResponse,\n  SITerminateSessionResponse,\n} from '../types/tools.generated';\n\nimport type {\n  AdCPAsyncResponseData,\n  CreateMediaBuyAsyncInputRequired,\n  CreateMediaBuyAsyncSubmitted,\n  CreateMediaBuyAsyncWorking,\n  CreateMediaBuyResponse,\n  GetProductsAsyncInputRequired,\n  GetProductsAsyncSubmitted,\n  GetProductsAsyncWorking,\n  GetProductsResponse,\n  SyncCreativesAsyncInputRequired,\n  SyncCreativesAsyncSubmitted,\n  SyncCreativesAsyncWorking,\n  SyncCreativesResponse,\n  TaskStatus,\n  TaskType,\n  UpdateMediaBuyAsyncInputRequired,\n  UpdateMediaBuyAsyncSubmitted,\n  UpdateMediaBuyAsyncWorking,\n  UpdateMediaBuyResponse,\n} from '../types/core.generated';\nimport type { TaskResultMetadata } from './ConversationTypes';\nimport {\n  CreateMediaBuyAsyncResponseData,\n  GetProductsAsyncResponseData,\n  SyncCreativesAsyncResponseData,\n  UpdateMediaBuyAsyncResponseData,\n} from '../types';\nimport type {\n  CanonicalCreativeResponse,\n  CanonicalGetProductsResponse,\n  CanonicalListCreativesResponse,\n} from '../v2/projection/creative-delivery';\n\n/**\n * Metadata provided with webhook responses\n */\nexport interface WebhookMetadata {\n  /** Client-provided operation ID */\n  operation_id: string;\n  /** Server's task ID */\n  task_id: string;\n  /** Agent ID */\n  agent_id: string;\n  /** Task type/tool name */\n  task_type: string;\n  /** Task status (completed, failed, needs_input, working, etc) */\n  status: TaskStatus;\n  /** Server's context ID */\n  context_id?: string;\n  /** Human-readable context about the status change */\n  message?: string;\n  /** Timestamp */\n  timestamp: string;\n  /** raw HTTP payload */\n  rawHTTPPayload?: any;\n  /**\n   * Wire protocol that delivered this webhook. Useful for handler code\n   * that needs to treat MCP and A2A transports differently (e.g.,\n   * `idempotency_key` is only present on MCP payloads).\n   */\n  protocol?: 'mcp' | 'a2a';\n  /**\n   * Sender-generated key stable across retries of the same webhook event\n   * (MCP envelope only — A2A webhooks do not carry this field). Use this\n   * as the canonical dedup key; see `AsyncHandlerConfig.webhookDedup`.\n   */\n  idempotency_key?: string;\n  /**\n   * Buyer-side product property policy evaluation for completed get_products\n   * webhooks. Present when the client filters, audits, or rejects a webhook\n   * result before dispatching it to handlers.\n   */\n  productPropertyPolicy?: TaskResultMetadata['productPropertyPolicy'];\n  /**\n   * Buyer-side pricing-options enforcement summary for completed get_products\n   * webhooks. Present when the client drops products that arrived without a\n   * usable `pricing_options[]` array before dispatching to handlers.\n   */\n  productPricingPolicy?: TaskResultMetadata['productPricingPolicy'];\n}\n\n/**\n * Metadata for agent-initiated notifications\n * Same as WebhookMetadata but includes notification-specific fields\n */\nexport interface NotificationMetadata extends WebhookMetadata {\n  /** Notification type */\n  notification_type: 'scheduled' | 'final' | 'delayed';\n  /** Sequence number of this notification */\n  sequence_number?: number;\n  /** When next notification is expected (not present for 'final') */\n  next_expected_at?: string;\n}\n\n// Simple union-typed handlers for webhook status changes\nexport type GetProductsStatusChangeHandler = (\n  response:\n    | CanonicalGetProductsResponse\n    | GetProductsAsyncSubmitted\n    | GetProductsAsyncWorking\n    | GetProductsAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type CreateMediaBuyStatusChangeHandler = (\n  response: CanonicalCreativeResponse<\n    | CreateMediaBuyResponse\n    | CreateMediaBuyAsyncSubmitted\n    | CreateMediaBuyAsyncWorking\n    | CreateMediaBuyAsyncInputRequired\n  >,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type UpdateMediaBuyStatusChangeHandler = (\n  response: CanonicalCreativeResponse<\n    | UpdateMediaBuyResponse\n    | UpdateMediaBuyAsyncSubmitted\n    | UpdateMediaBuyAsyncWorking\n    | UpdateMediaBuyAsyncInputRequired\n  >,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type SyncCreativesStatusChangeHandler = (\n  response: CanonicalCreativeResponse<\n    SyncCreativesResponse | SyncCreativesAsyncSubmitted | SyncCreativesAsyncWorking | SyncCreativesAsyncInputRequired\n  >,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\n/**\n * Media buy delivery notification payload (PR #81)\n * Agent-initiated periodic reporting, not tied to any client operation\n */\nexport interface MediaBuyDeliveryNotification {\n  /** Type of notification */\n  notification_type: 'scheduled' | 'final' | 'delayed';\n  /** Sequential notification number (starts at 1) */\n  sequence_number?: number;\n  /** When next notification is expected (omitted for 'final') */\n  next_expected_at?: string;\n  /** Reporting period for this notification */\n  reporting_period?: {\n    start: string;\n    end: string;\n  };\n  /** Currency used for financial metrics */\n  currency?: string;\n  /** Array of media buy deliveries being reported */\n  media_buy_deliveries?: Array<{\n    media_buy_id: string;\n    impressions?: number;\n    clicks?: number;\n    spend?: number;\n    conversions?: number;\n    [key: string]: any;\n  }>;\n}\n\n/**\n * Activity event for logging/observability\n */\nexport interface Activity {\n  type:\n    | 'protocol_request'\n    | 'protocol_response'\n    | 'status_change'\n    | 'webhook_received'\n    | 'webhook_duplicate'\n    | 'governance_check'\n    | 'governance_outcome';\n  operation_id: string;\n  agent_id: string;\n  context_id?: string;\n  task_id?: string;\n  task_type: string;\n  status?: string;\n  /**\n   * Full AdCP response payload. Populated on `webhook_received` and\n   * protocol/status events. INTENTIONALLY omitted on `webhook_duplicate`\n   * to avoid re-logging potentially-sensitive data on every retry — the\n   * originating `webhook_received` event already carries it. Correlate\n   * the two via `idempotency_key`.\n   */\n  payload?: any;\n  /**\n   * Webhook idempotency key when available. Present on `webhook_received`\n   * and `webhook_duplicate` events from MCP envelopes, enabling\n   * correlation between a first delivery and its retry echoes.\n   */\n  idempotency_key?: string;\n  timestamp: string;\n}\n\n/**\n * Configuration for async handler with typed callbacks\n */\nexport interface AsyncHandlerConfig {\n  // AdCP tool status change handlers - called for ALL status changes (completed, failed, working, input-required, submitted)\n  onGetProductsStatusChange?: GetProductsStatusChangeHandler;\n  onListCreativeFormatsLegacyStatusChange?: (\n    data: ListCreativeFormatsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onCreateMediaBuyStatusChange?: CreateMediaBuyStatusChangeHandler;\n  onUpdateMediaBuyStatusChange?: UpdateMediaBuyStatusChangeHandler;\n  onSyncCreativesStatusChange?: SyncCreativesStatusChangeHandler;\n  onListCreativesStatusChange?: (\n    response: CanonicalListCreativesResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onPreviewCreativeLegacyStatusChange?: (\n    response: PreviewCreativeResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetMediaBuysStatusChange?: (\n    response: CanonicalCreativeResponse<GetMediaBuysResponse>,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetMediaBuyDeliveryStatusChange?: (\n    response: CanonicalCreativeResponse<GetMediaBuyDeliveryResponse>,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetCreativeDeliveryStatusChange?: (\n    response: CanonicalCreativeResponse<GetCreativeDeliveryResponse>,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onProvidePerformanceFeedbackStatusChange?: (\n    response: ProvidePerformanceFeedbackResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetSignalsStatusChange?: (response: GetSignalsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onActivateSignalStatusChange?: (response: ActivateSignalResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onBuildCreativeLegacyStatusChange?: (\n    response: BuildCreativeResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListAccountsStatusChange?: (response: ListAccountsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSyncAccountsStatusChange?: (response: SyncAccountsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSyncAudiencesStatusChange?: (response: SyncAudiencesResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onCreatePropertyListStatusChange?: (\n    response: CreatePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetPropertyListStatusChange?: (\n    response: GetPropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onUpdatePropertyListStatusChange?: (\n    response: UpdatePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListPropertyListsStatusChange?: (\n    response: ListPropertyListsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onDeletePropertyListStatusChange?: (\n    response: DeletePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListContentStandardsLegacyStatusChange?: (\n    response: ListContentStandardsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetContentStandardsLegacyStatusChange?: (\n    response: GetContentStandardsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onCalibrateContentLegacyStatusChange?: (\n    response: CalibrateContentResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onValidateContentDeliveryLegacyStatusChange?: (\n    response: ValidateContentDeliveryResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onSIGetOfferingStatusChange?: (response: SIGetOfferingResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSIInitiateSessionStatusChange?: (\n    response: SIInitiateSessionResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onSISendMessageStatusChange?: (response: SISendMessageResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSITerminateSessionStatusChange?: (\n    response: SITerminateSessionResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n\n  // Fallback handler for any task status change\n  onTaskStatusChange?: (response: any, metadata: WebhookMetadata) => void | Promise<void>;\n\n  // Activity logging (low-level protocol events)\n  onActivity?: (activity: Activity) => void | Promise<void>;\n\n  /**\n   * Receiver-side deduplication of webhook payloads by `idempotency_key`.\n   *\n   * AdCP webhooks use at-least-once delivery — publishers retry until they\n   * see a 2xx, so the same event may arrive more than once. When configured,\n   * the first delivery for a given `(agent_id, idempotency_key)` tuple\n   * dispatches to handlers; subsequent deliveries are dropped and surface\n   * as a `webhook_duplicate` activity.\n   *\n   * Reuses `IdempotencyBackend` from `@adcp/sdk/server` — you can share\n   * the same backend across request-side and webhook-side dedup, or use a\n   * dedicated one. Scope is per-agent so keys from different senders are\n   * independent, matching the spec's \"scoped to authenticated sender\n   * identity\" rule.\n   *\n   * If a payload arrives without `idempotency_key` (non-conforming sender,\n   * or A2A transport which does not carry the field), dispatch proceeds\n   * without dedup and a warning is logged.\n   */\n  webhookDedup?: {\n    backend: IdempotencyBackend;\n    /** Retention for dedup keys. Defaults to 86_400 (24h). */\n    ttlSeconds?: number;\n  };\n\n  // Notification handlers (agent-initiated, no operation_id)\n  onMediaBuyDeliveryNotification?: (\n    notification: MediaBuyDeliveryNotification,\n    metadata: NotificationMetadata\n  ) => void | Promise<void>;\n}\n\n/**\n * Async handler class\n */\nexport class AsyncHandler {\n  constructor(private config: AsyncHandlerConfig) {}\n\n  /**\n   * Handle incoming webhook payload (both task completions and notifications)\n   */\n  async handleWebhook({\n    result,\n    metadata,\n  }: {\n    result: AdCPAsyncResponseData | undefined;\n    metadata: WebhookMetadata;\n  }): Promise<void> {\n    if (await this.isDuplicate(metadata)) {\n      await this.emitActivity({\n        type: 'webhook_duplicate',\n        operation_id: metadata.operation_id,\n        agent_id: metadata.agent_id,\n        context_id: metadata.context_id,\n        task_id: metadata.task_id,\n        task_type: metadata.task_type,\n        status: metadata.status,\n        idempotency_key: metadata.idempotency_key,\n        timestamp: metadata.timestamp,\n      });\n      return;\n    }\n\n    // Emit activity\n    await this.emitActivity({\n      type: 'webhook_received',\n      idempotency_key: metadata.idempotency_key,\n      operation_id: metadata.operation_id,\n      agent_id: metadata.agent_id,\n      context_id: metadata.context_id,\n      task_id: metadata.task_id,\n      task_type: metadata.task_type,\n      status: metadata.status,\n      payload: metadata.rawHTTPPayload?.result ?? result,\n      timestamp: metadata.timestamp,\n    });\n\n    // Check if this is a notification (media_buy_delivery with notification_type)\n    // Notifications are treated like status updates for an ongoing \"get delivery report\" operation\n    // The operation_id (from URL) groups all reports for the same agent + month\n    if (\n      metadata.task_type === 'media_buy_delivery' &&\n      result &&\n      typeof result === 'object' &&\n      'notification_type' in result\n    ) {\n      const notificationPayload = result as unknown as MediaBuyDeliveryNotification;\n\n      // Build notification metadata\n      // operation_id comes from webhook URL and was lazily generated from agent + month\n      const notificationMetadata: NotificationMetadata = {\n        ...metadata,\n        notification_type: notificationPayload.notification_type,\n        sequence_number: notificationPayload.sequence_number,\n        next_expected_at: notificationPayload.next_expected_at,\n      };\n\n      await this.config.onMediaBuyDeliveryNotification?.(notificationPayload, notificationMetadata);\n      return;\n    }\n\n    // All status changes go through the specific handler\n    // The handler receives metadata with status and can act accordingly\n    await this.handleCompletion(metadata.task_type, result, metadata);\n  }\n\n  /**\n   * Handle task completion - route to specific handler\n   */\n  private async handleCompletion(\n    taskType: string,\n    result: AdCPAsyncResponseData | undefined,\n    metadata: WebhookMetadata\n  ): Promise<void> {\n    let handler: ((result: any, metadata: any) => void | Promise<void>) | undefined;\n\n    // Route to specific handler based on task type\n    switch (taskType) {\n      case 'get_products':\n        handler = this.config.onGetProductsStatusChange;\n        break;\n\n      case 'list_creative_formats':\n        handler = this.config.onListCreativeFormatsLegacyStatusChange;\n        break;\n\n      case 'preview_creative':\n        handler = this.config.onPreviewCreativeLegacyStatusChange;\n        break;\n\n      case 'build_creative':\n        handler = this.config.onBuildCreativeLegacyStatusChange;\n        break;\n\n      case 'create_media_buy':\n        handler = this.config.onCreateMediaBuyStatusChange;\n        break;\n\n      case 'update_media_buy':\n        handler = this.config.onUpdateMediaBuyStatusChange;\n        break;\n\n      case 'sync_creatives':\n        handler = this.config.onSyncCreativesStatusChange;\n        break;\n\n      case 'list_creatives':\n        handler = this.config.onListCreativesStatusChange;\n        break;\n\n      case 'get_media_buys':\n        handler = this.config.onGetMediaBuysStatusChange;\n        break;\n\n      case 'get_media_buy_delivery':\n        handler = this.config.onGetMediaBuyDeliveryStatusChange;\n        break;\n\n      case 'get_creative_delivery':\n        handler = this.config.onGetCreativeDeliveryStatusChange;\n        break;\n\n      case 'provide_performance_feedback':\n        handler = this.config.onProvidePerformanceFeedbackStatusChange;\n        break;\n\n      case 'get_signals':\n        handler = this.config.onGetSignalsStatusChange;\n        break;\n\n      case 'activate_signal':\n        handler = this.config.onActivateSignalStatusChange;\n        break;\n\n      case 'list_content_standards':\n        handler = this.config.onListContentStandardsLegacyStatusChange;\n        break;\n\n      case 'get_content_standards':\n        handler = this.config.onGetContentStandardsLegacyStatusChange;\n        break;\n\n      case 'calibrate_content':\n        handler = this.config.onCalibrateContentLegacyStatusChange;\n        break;\n\n      case 'validate_content_delivery':\n        handler = this.config.onValidateContentDeliveryLegacyStatusChange;\n        break;\n    }\n\n    // Call specific handler if configured, otherwise fallback to generic handler\n    const handlerToCall = handler || this.config.onTaskStatusChange;\n\n    if (handlerToCall) {\n      try {\n        await handlerToCall(result, metadata);\n      } catch (error) {\n        // Log error but don't crash webhook processing\n        console.error(\n          `Error in handler for task ${taskType}:`,\n          error instanceof Error ? error.message : 'unknown error'\n        );\n      }\n    }\n  }\n\n  /**\n   * Emit activity event\n   */\n  private async emitActivity(activity: Activity): Promise<void> {\n    await this.config.onActivity?.(activity);\n  }\n\n  /**\n   * Claim the webhook for processing, returning true if the event has\n   * already been delivered for this `(agent_id, idempotency_key)` tuple.\n   *\n   * Uses `IdempotencyBackend.putIfAbsent` so concurrent retries race on a\n   * single claim: exactly one caller gets `true` and proceeds, the rest\n   * observe the existing entry and return.\n   */\n  private async isDuplicate(metadata: WebhookMetadata): Promise<boolean> {\n    const dedup = this.config.webhookDedup;\n    if (!dedup) return false;\n\n    const key = metadata.idempotency_key;\n    if (!key || !IDEMPOTENCY_KEY_PATTERN.test(key)) {\n      // No valid key. MCP senders MUST emit one per AdCP 3.0; A2A\n      // transport doesn't carry the field at all. Warn MCP (so\n      // integrators notice non-conforming publishers) and stay quiet\n      // for A2A (expected and unactionable).\n      if (metadata.protocol !== 'a2a') {\n        console.warn(\n          `[AdCP] webhookDedup enabled but webhook from agent=${metadata.agent_id} task=${metadata.task_id} has ${\n            key ? 'an invalid' : 'no'\n          } idempotency_key. Expected format: ${IDEMPOTENCY_KEY_PATTERN.source}. ` +\n            'Dispatching without dedup — duplicate deliveries from this sender will re-trigger handlers. ' +\n            'See docs/guides/PUSH-NOTIFICATION-CONFIG.md#deduplication'\n        );\n      }\n      return false;\n    }\n\n    const ttlSeconds = dedup.ttlSeconds ?? 86_400;\n    // Reserved prefix `adcp\\u001fwebhook\\u001fv1\\u001f...` namespaces the\n    // claim so webhook dedup entries can coexist with request-side\n    // idempotency entries in a shared backend — a request-side principal\n    // can never produce a scoped key with this prefix because the\n    // principal regex excludes U+001F.\n    const scopedKey = `adcp\\u001fwebhook\\u001fv1\\u001f${metadata.agent_id}\\u001f${key}`;\n    const expiresAt = Math.floor(Date.now() / 1000) + ttlSeconds;\n\n    const claimed = await dedup.backend.putIfAbsent(scopedKey, {\n      payloadHash: '',\n      response: null,\n      expiresAt,\n    });\n    return !claimed;\n  }\n}\n\n// AdCP spec: `^[A-Za-z0-9_.:-]{16,255}$`. Any key not matching this\n// pattern is malformed — treat as missing rather than forming a scoped\n// key from arbitrary sender-supplied bytes.\nconst IDEMPOTENCY_KEY_PATTERN = /^[A-Za-z0-9_.:-]{16,255}$/;\n\n/**\n * Factory function to create async handler\n */\nexport function createAsyncHandler(config: AsyncHandlerConfig): AsyncHandler {\n  return new AsyncHandler(config);\n}\n"],"mappings":"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","names":[]}

package/dist/lib/core/AsyncHandler.mjs

@@ -59,7 +59,13 @@ class AsyncHandler {
         handler = this.config.onGetProductsStatusChange;
         break;
       case "list_creative_formats":
-        handler = this.config.onListCreativeFormatsStatusChange;
+        handler = this.config.onListCreativeFormatsLegacyStatusChange;
+        break;
+      case "preview_creative":
+        handler = this.config.onPreviewCreativeLegacyStatusChange;
+        break;
+      case "build_creative":
+        handler = this.config.onBuildCreativeLegacyStatusChange;
         break;
       case "create_media_buy":
         handler = this.config.onCreateMediaBuyStatusChange;
@@ -79,6 +85,9 @@ class AsyncHandler {
       case "get_media_buy_delivery":
         handler = this.config.onGetMediaBuyDeliveryStatusChange;
         break;
+      case "get_creative_delivery":
+        handler = this.config.onGetCreativeDeliveryStatusChange;
+        break;
       case "provide_performance_feedback":
         handler = this.config.onProvidePerformanceFeedbackStatusChange;
         break;
@@ -88,6 +97,18 @@ class AsyncHandler {
       case "activate_signal":
         handler = this.config.onActivateSignalStatusChange;
         break;
+      case "list_content_standards":
+        handler = this.config.onListContentStandardsLegacyStatusChange;
+        break;
+      case "get_content_standards":
+        handler = this.config.onGetContentStandardsLegacyStatusChange;
+        break;
+      case "calibrate_content":
+        handler = this.config.onCalibrateContentLegacyStatusChange;
+        break;
+      case "validate_content_delivery":
+        handler = this.config.onValidateContentDeliveryLegacyStatusChange;
+        break;
     }
     const handlerToCall = handler || this.config.onTaskStatusChange;
     if (handlerToCall) {

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/core/AsyncHandler.ts"],"sourcesContent":["/**\n * Structured async handler for AdCP webhook responses\n * Provides type-safe callbacks for each AdCP tool completion\n */\n\nimport type { IdempotencyBackend } from '../server/idempotency/store';\nimport type {\n  ListCreativeFormatsResponse,\n  ListCreativesResponse,\n  PreviewCreativeResponse,\n  BuildCreativeResponse,\n  GetMediaBuysResponse,\n  GetMediaBuyDeliveryResponse,\n  ProvidePerformanceFeedbackResponse,\n  GetSignalsResponse,\n  ActivateSignalResponse,\n  ListAccountsResponse,\n  SyncAccountsResponse,\n  SyncAudiencesResponse,\n  CreatePropertyListResponse,\n  GetPropertyListResponse,\n  UpdatePropertyListResponse,\n  ListPropertyListsResponse,\n  DeletePropertyListResponse,\n  ListContentStandardsResponse,\n  GetContentStandardsResponse,\n  CalibrateContentResponse,\n  ValidateContentDeliveryResponse,\n  SIGetOfferingResponse,\n  SIInitiateSessionResponse,\n  SISendMessageResponse,\n  SITerminateSessionResponse,\n} from '../types/tools.generated';\n\nimport type {\n  AdCPAsyncResponseData,\n  CreateMediaBuyAsyncInputRequired,\n  CreateMediaBuyAsyncSubmitted,\n  CreateMediaBuyAsyncWorking,\n  CreateMediaBuyResponse,\n  GetProductsAsyncInputRequired,\n  GetProductsAsyncSubmitted,\n  GetProductsAsyncWorking,\n  GetProductsResponse,\n  SyncCreativesAsyncInputRequired,\n  SyncCreativesAsyncSubmitted,\n  SyncCreativesAsyncWorking,\n  SyncCreativesResponse,\n  TaskStatus,\n  TaskType,\n  UpdateMediaBuyAsyncInputRequired,\n  UpdateMediaBuyAsyncSubmitted,\n  UpdateMediaBuyAsyncWorking,\n  UpdateMediaBuyResponse,\n} from '../types/core.generated';\nimport type { TaskResultMetadata } from './ConversationTypes';\nimport {\n  CreateMediaBuyAsyncResponseData,\n  GetProductsAsyncResponseData,\n  SyncCreativesAsyncResponseData,\n  UpdateMediaBuyAsyncResponseData,\n} from '../types';\n\n/**\n * Metadata provided with webhook responses\n */\nexport interface WebhookMetadata {\n  /** Client-provided operation ID */\n  operation_id: string;\n  /** Server's task ID */\n  task_id: string;\n  /** Agent ID */\n  agent_id: string;\n  /** Task type/tool name */\n  task_type: string;\n  /** Task status (completed, failed, needs_input, working, etc) */\n  status: TaskStatus;\n  /** Server's context ID */\n  context_id?: string;\n  /** Human-readable context about the status change */\n  message?: string;\n  /** Timestamp */\n  timestamp: string;\n  /** raw HTTP payload */\n  rawHTTPPayload?: any;\n  /**\n   * Wire protocol that delivered this webhook. Useful for handler code\n   * that needs to treat MCP and A2A transports differently (e.g.,\n   * `idempotency_key` is only present on MCP payloads).\n   */\n  protocol?: 'mcp' | 'a2a';\n  /**\n   * Sender-generated key stable across retries of the same webhook event\n   * (MCP envelope only — A2A webhooks do not carry this field). Use this\n   * as the canonical dedup key; see `AsyncHandlerConfig.webhookDedup`.\n   */\n  idempotency_key?: string;\n  /**\n   * Buyer-side product property policy evaluation for completed get_products\n   * webhooks. Present when the client filters, audits, or rejects a webhook\n   * result before dispatching it to handlers.\n   */\n  productPropertyPolicy?: TaskResultMetadata['productPropertyPolicy'];\n  /**\n   * Buyer-side pricing-options enforcement summary for completed get_products\n   * webhooks. Present when the client drops products that arrived without a\n   * usable `pricing_options[]` array before dispatching to handlers.\n   */\n  productPricingPolicy?: TaskResultMetadata['productPricingPolicy'];\n}\n\n/**\n * Metadata for agent-initiated notifications\n * Same as WebhookMetadata but includes notification-specific fields\n */\nexport interface NotificationMetadata extends WebhookMetadata {\n  /** Notification type */\n  notification_type: 'scheduled' | 'final' | 'delayed';\n  /** Sequence number of this notification */\n  sequence_number?: number;\n  /** When next notification is expected (not present for 'final') */\n  next_expected_at?: string;\n}\n\n// Simple union-typed handlers for webhook status changes\nexport type GetProductsStatusChangeHandler = (\n  response: GetProductsResponse | GetProductsAsyncSubmitted | GetProductsAsyncWorking | GetProductsAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type CreateMediaBuyStatusChangeHandler = (\n  response:\n    | CreateMediaBuyResponse\n    | CreateMediaBuyAsyncSubmitted\n    | CreateMediaBuyAsyncWorking\n    | CreateMediaBuyAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type UpdateMediaBuyStatusChangeHandler = (\n  response:\n    | UpdateMediaBuyResponse\n    | UpdateMediaBuyAsyncSubmitted\n    | UpdateMediaBuyAsyncWorking\n    | UpdateMediaBuyAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type SyncCreativesStatusChangeHandler = (\n  response:\n    | SyncCreativesResponse\n    | SyncCreativesAsyncSubmitted\n    | SyncCreativesAsyncWorking\n    | SyncCreativesAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\n/**\n * Media buy delivery notification payload (PR #81)\n * Agent-initiated periodic reporting, not tied to any client operation\n */\nexport interface MediaBuyDeliveryNotification {\n  /** Type of notification */\n  notification_type: 'scheduled' | 'final' | 'delayed';\n  /** Sequential notification number (starts at 1) */\n  sequence_number?: number;\n  /** When next notification is expected (omitted for 'final') */\n  next_expected_at?: string;\n  /** Reporting period for this notification */\n  reporting_period?: {\n    start: string;\n    end: string;\n  };\n  /** Currency used for financial metrics */\n  currency?: string;\n  /** Array of media buy deliveries being reported */\n  media_buy_deliveries?: Array<{\n    media_buy_id: string;\n    impressions?: number;\n    clicks?: number;\n    spend?: number;\n    conversions?: number;\n    [key: string]: any;\n  }>;\n}\n\n/**\n * Activity event for logging/observability\n */\nexport interface Activity {\n  type:\n    | 'protocol_request'\n    | 'protocol_response'\n    | 'status_change'\n    | 'webhook_received'\n    | 'webhook_duplicate'\n    | 'governance_check'\n    | 'governance_outcome';\n  operation_id: string;\n  agent_id: string;\n  context_id?: string;\n  task_id?: string;\n  task_type: string;\n  status?: string;\n  /**\n   * Full AdCP response payload. Populated on `webhook_received` and\n   * protocol/status events. INTENTIONALLY omitted on `webhook_duplicate`\n   * to avoid re-logging potentially-sensitive data on every retry — the\n   * originating `webhook_received` event already carries it. Correlate\n   * the two via `idempotency_key`.\n   */\n  payload?: any;\n  /**\n   * Webhook idempotency key when available. Present on `webhook_received`\n   * and `webhook_duplicate` events from MCP envelopes, enabling\n   * correlation between a first delivery and its retry echoes.\n   */\n  idempotency_key?: string;\n  timestamp: string;\n}\n\n/**\n * Configuration for async handler with typed callbacks\n */\nexport interface AsyncHandlerConfig {\n  // AdCP tool status change handlers - called for ALL status changes (completed, failed, working, input-required, submitted)\n  onGetProductsStatusChange?: GetProductsStatusChangeHandler;\n  onListCreativeFormatsStatusChange?: (\n    data: ListCreativeFormatsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onCreateMediaBuyStatusChange?: CreateMediaBuyStatusChangeHandler;\n  onUpdateMediaBuyStatusChange?: UpdateMediaBuyStatusChangeHandler;\n  onSyncCreativesStatusChange?: SyncCreativesStatusChangeHandler;\n  onListCreativesStatusChange?: (response: ListCreativesResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onPreviewCreativeStatusChange?: (\n    response: PreviewCreativeResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetMediaBuysStatusChange?: (response: GetMediaBuysResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onGetMediaBuyDeliveryStatusChange?: (\n    response: GetMediaBuyDeliveryResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onProvidePerformanceFeedbackStatusChange?: (\n    response: ProvidePerformanceFeedbackResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetSignalsStatusChange?: (response: GetSignalsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onActivateSignalStatusChange?: (response: ActivateSignalResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onBuildCreativeStatusChange?: (response: BuildCreativeResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onListAccountsStatusChange?: (response: ListAccountsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSyncAccountsStatusChange?: (response: SyncAccountsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSyncAudiencesStatusChange?: (response: SyncAudiencesResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onCreatePropertyListStatusChange?: (\n    response: CreatePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetPropertyListStatusChange?: (\n    response: GetPropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onUpdatePropertyListStatusChange?: (\n    response: UpdatePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListPropertyListsStatusChange?: (\n    response: ListPropertyListsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onDeletePropertyListStatusChange?: (\n    response: DeletePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListContentStandardsStatusChange?: (\n    response: ListContentStandardsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetContentStandardsStatusChange?: (\n    response: GetContentStandardsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onCalibrateContentStatusChange?: (\n    response: CalibrateContentResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onValidateContentDeliveryStatusChange?: (\n    response: ValidateContentDeliveryResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onSIGetOfferingStatusChange?: (response: SIGetOfferingResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSIInitiateSessionStatusChange?: (\n    response: SIInitiateSessionResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onSISendMessageStatusChange?: (response: SISendMessageResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSITerminateSessionStatusChange?: (\n    response: SITerminateSessionResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n\n  // Fallback handler for any task status change\n  onTaskStatusChange?: (response: any, metadata: WebhookMetadata) => void | Promise<void>;\n\n  // Activity logging (low-level protocol events)\n  onActivity?: (activity: Activity) => void | Promise<void>;\n\n  /**\n   * Receiver-side deduplication of webhook payloads by `idempotency_key`.\n   *\n   * AdCP webhooks use at-least-once delivery — publishers retry until they\n   * see a 2xx, so the same event may arrive more than once. When configured,\n   * the first delivery for a given `(agent_id, idempotency_key)` tuple\n   * dispatches to handlers; subsequent deliveries are dropped and surface\n   * as a `webhook_duplicate` activity.\n   *\n   * Reuses `IdempotencyBackend` from `@adcp/sdk/server` — you can share\n   * the same backend across request-side and webhook-side dedup, or use a\n   * dedicated one. Scope is per-agent so keys from different senders are\n   * independent, matching the spec's \"scoped to authenticated sender\n   * identity\" rule.\n   *\n   * If a payload arrives without `idempotency_key` (non-conforming sender,\n   * or A2A transport which does not carry the field), dispatch proceeds\n   * without dedup and a warning is logged.\n   */\n  webhookDedup?: {\n    backend: IdempotencyBackend;\n    /** Retention for dedup keys. Defaults to 86_400 (24h). */\n    ttlSeconds?: number;\n  };\n\n  // Notification handlers (agent-initiated, no operation_id)\n  onMediaBuyDeliveryNotification?: (\n    notification: MediaBuyDeliveryNotification,\n    metadata: NotificationMetadata\n  ) => void | Promise<void>;\n}\n\n/**\n * Async handler class\n */\nexport class AsyncHandler {\n  constructor(private config: AsyncHandlerConfig) {}\n\n  /**\n   * Handle incoming webhook payload (both task completions and notifications)\n   */\n  async handleWebhook({\n    result,\n    metadata,\n  }: {\n    result: AdCPAsyncResponseData | undefined;\n    metadata: WebhookMetadata;\n  }): Promise<void> {\n    if (await this.isDuplicate(metadata)) {\n      await this.emitActivity({\n        type: 'webhook_duplicate',\n        operation_id: metadata.operation_id,\n        agent_id: metadata.agent_id,\n        context_id: metadata.context_id,\n        task_id: metadata.task_id,\n        task_type: metadata.task_type,\n        status: metadata.status,\n        idempotency_key: metadata.idempotency_key,\n        timestamp: metadata.timestamp,\n      });\n      return;\n    }\n\n    // Emit activity\n    await this.emitActivity({\n      type: 'webhook_received',\n      idempotency_key: metadata.idempotency_key,\n      operation_id: metadata.operation_id,\n      agent_id: metadata.agent_id,\n      context_id: metadata.context_id,\n      task_id: metadata.task_id,\n      task_type: metadata.task_type,\n      status: metadata.status,\n      payload: metadata.rawHTTPPayload?.result ?? result,\n      timestamp: metadata.timestamp,\n    });\n\n    // Check if this is a notification (media_buy_delivery with notification_type)\n    // Notifications are treated like status updates for an ongoing \"get delivery report\" operation\n    // The operation_id (from URL) groups all reports for the same agent + month\n    if (\n      metadata.task_type === 'media_buy_delivery' &&\n      result &&\n      typeof result === 'object' &&\n      'notification_type' in result\n    ) {\n      const notificationPayload = result as unknown as MediaBuyDeliveryNotification;\n\n      // Build notification metadata\n      // operation_id comes from webhook URL and was lazily generated from agent + month\n      const notificationMetadata: NotificationMetadata = {\n        ...metadata,\n        notification_type: notificationPayload.notification_type,\n        sequence_number: notificationPayload.sequence_number,\n        next_expected_at: notificationPayload.next_expected_at,\n      };\n\n      await this.config.onMediaBuyDeliveryNotification?.(notificationPayload, notificationMetadata);\n      return;\n    }\n\n    // All status changes go through the specific handler\n    // The handler receives metadata with status and can act accordingly\n    await this.handleCompletion(metadata.task_type, result, metadata);\n  }\n\n  /**\n   * Handle task completion - route to specific handler\n   */\n  private async handleCompletion(\n    taskType: string,\n    result: AdCPAsyncResponseData | undefined,\n    metadata: WebhookMetadata\n  ): Promise<void> {\n    let handler: ((result: any, metadata: any) => void | Promise<void>) | undefined;\n\n    // Route to specific handler based on task type\n    switch (taskType) {\n      case 'get_products':\n        handler = this.config.onGetProductsStatusChange;\n        break;\n\n      case 'list_creative_formats':\n        handler = this.config.onListCreativeFormatsStatusChange;\n        break;\n\n      case 'create_media_buy':\n        handler = this.config.onCreateMediaBuyStatusChange;\n        break;\n\n      case 'update_media_buy':\n        handler = this.config.onUpdateMediaBuyStatusChange;\n        break;\n\n      case 'sync_creatives':\n        handler = this.config.onSyncCreativesStatusChange;\n        break;\n\n      case 'list_creatives':\n        handler = this.config.onListCreativesStatusChange;\n        break;\n\n      case 'get_media_buys':\n        handler = this.config.onGetMediaBuysStatusChange;\n        break;\n\n      case 'get_media_buy_delivery':\n        handler = this.config.onGetMediaBuyDeliveryStatusChange;\n        break;\n\n      case 'provide_performance_feedback':\n        handler = this.config.onProvidePerformanceFeedbackStatusChange;\n        break;\n\n      case 'get_signals':\n        handler = this.config.onGetSignalsStatusChange;\n        break;\n\n      case 'activate_signal':\n        handler = this.config.onActivateSignalStatusChange;\n        break;\n    }\n\n    // Call specific handler if configured, otherwise fallback to generic handler\n    const handlerToCall = handler || this.config.onTaskStatusChange;\n\n    if (handlerToCall) {\n      try {\n        await handlerToCall(result, metadata);\n      } catch (error) {\n        // Log error but don't crash webhook processing\n        console.error(\n          `Error in handler for task ${taskType}:`,\n          error instanceof Error ? error.message : 'unknown error'\n        );\n      }\n    }\n  }\n\n  /**\n   * Emit activity event\n   */\n  private async emitActivity(activity: Activity): Promise<void> {\n    await this.config.onActivity?.(activity);\n  }\n\n  /**\n   * Claim the webhook for processing, returning true if the event has\n   * already been delivered for this `(agent_id, idempotency_key)` tuple.\n   *\n   * Uses `IdempotencyBackend.putIfAbsent` so concurrent retries race on a\n   * single claim: exactly one caller gets `true` and proceeds, the rest\n   * observe the existing entry and return.\n   */\n  private async isDuplicate(metadata: WebhookMetadata): Promise<boolean> {\n    const dedup = this.config.webhookDedup;\n    if (!dedup) return false;\n\n    const key = metadata.idempotency_key;\n    if (!key || !IDEMPOTENCY_KEY_PATTERN.test(key)) {\n      // No valid key. MCP senders MUST emit one per AdCP 3.0; A2A\n      // transport doesn't carry the field at all. Warn MCP (so\n      // integrators notice non-conforming publishers) and stay quiet\n      // for A2A (expected and unactionable).\n      if (metadata.protocol !== 'a2a') {\n        console.warn(\n          `[AdCP] webhookDedup enabled but webhook from agent=${metadata.agent_id} task=${metadata.task_id} has ${\n            key ? 'an invalid' : 'no'\n          } idempotency_key. Expected format: ${IDEMPOTENCY_KEY_PATTERN.source}. ` +\n            'Dispatching without dedup — duplicate deliveries from this sender will re-trigger handlers. ' +\n            'See docs/guides/PUSH-NOTIFICATION-CONFIG.md#deduplication'\n        );\n      }\n      return false;\n    }\n\n    const ttlSeconds = dedup.ttlSeconds ?? 86_400;\n    // Reserved prefix `adcp\\u001fwebhook\\u001fv1\\u001f...` namespaces the\n    // claim so webhook dedup entries can coexist with request-side\n    // idempotency entries in a shared backend — a request-side principal\n    // can never produce a scoped key with this prefix because the\n    // principal regex excludes U+001F.\n    const scopedKey = `adcp\\u001fwebhook\\u001fv1\\u001f${metadata.agent_id}\\u001f${key}`;\n    const expiresAt = Math.floor(Date.now() / 1000) + ttlSeconds;\n\n    const claimed = await dedup.backend.putIfAbsent(scopedKey, {\n      payloadHash: '',\n      response: null,\n      expiresAt,\n    });\n    return !claimed;\n  }\n}\n\n// AdCP spec: `^[A-Za-z0-9_.:-]{16,255}$`. Any key not matching this\n// pattern is malformed — treat as missing rather than forming a scoped\n// key from arbitrary sender-supplied bytes.\nconst IDEMPOTENCY_KEY_PATTERN = /^[A-Za-z0-9_.:-]{16,255}$/;\n\n/**\n * Factory function to create async handler\n */\nexport function createAsyncHandler(config: AsyncHandlerConfig): AsyncHandler {\n  return new AsyncHandler(config);\n}\n"],"mappings":"AAsVO,MAAM,aAAa;AAAA,EACxB,YAAoB,QAA4B;AAA5B;AAAA,EAA6B;AAAA,EAA7B;AAAA;AAAA;AAAA;AAAA,EAKpB,MAAM,cAAc;AAAA,IAClB;AAAA,IACA;AAAA,EACF,GAGkB;AAChB,QAAI,MAAM,KAAK,YAAY,QAAQ,GAAG;AACpC,YAAM,KAAK,aAAa;AAAA,QACtB,MAAM;AAAA,QACN,cAAc,SAAS;AAAA,QACvB,UAAU,SAAS;AAAA,QACnB,YAAY,SAAS;AAAA,QACrB,SAAS,SAAS;AAAA,QAClB,WAAW,SAAS;AAAA,QACpB,QAAQ,SAAS;AAAA,QACjB,iBAAiB,SAAS;AAAA,QAC1B,WAAW,SAAS;AAAA,MACtB,CAAC;AACD;AAAA,IACF;AAGA,UAAM,KAAK,aAAa;AAAA,MACtB,MAAM;AAAA,MACN,iBAAiB,SAAS;AAAA,MAC1B,cAAc,SAAS;AAAA,MACvB,UAAU,SAAS;AAAA,MACnB,YAAY,SAAS;AAAA,MACrB,SAAS,SAAS;AAAA,MAClB,WAAW,SAAS;AAAA,MACpB,QAAQ,SAAS;AAAA,MACjB,SAAS,SAAS,gBAAgB,UAAU;AAAA,MAC5C,WAAW,SAAS;AAAA,IACtB,CAAC;AAKD,QACE,SAAS,cAAc,wBACvB,UACA,OAAO,WAAW,YAClB,uBAAuB,QACvB;AACA,YAAM,sBAAsB;AAI5B,YAAM,uBAA6C;AAAA,QACjD,GAAG;AAAA,QACH,mBAAmB,oBAAoB;AAAA,QACvC,iBAAiB,oBAAoB;AAAA,QACrC,kBAAkB,oBAAoB;AAAA,MACxC;AAEA,YAAM,KAAK,OAAO,iCAAiC,qBAAqB,oBAAoB;AAC5F;AAAA,IACF;AAIA,UAAM,KAAK,iBAAiB,SAAS,WAAW,QAAQ,QAAQ;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,iBACZ,UACA,QACA,UACe;AACf,QAAI;AAGJ,YAAQ,UAAU;AAAA,MAChB,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,MAEF,KAAK;AACH,kBAAU,KAAK,OAAO;AACtB;AAAA,IACJ;AAGA,UAAM,gBAAgB,WAAW,KAAK,OAAO;AAE7C,QAAI,eAAe;AACjB,UAAI;AACF,cAAM,cAAc,QAAQ,QAAQ;AAAA,MACtC,SAAS,OAAO;AAEd,gBAAQ;AAAA,UACN,6BAA6B,QAAQ;AAAA,UACrC,iBAAiB,QAAQ,MAAM,UAAU;AAAA,QAC3C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,aAAa,UAAmC;AAC5D,UAAM,KAAK,OAAO,aAAa,QAAQ;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAc,YAAY,UAA6C;AACrE,UAAM,QAAQ,KAAK,OAAO;AAC1B,QAAI,CAAC,MAAO,QAAO;AAEnB,UAAM,MAAM,SAAS;AACrB,QAAI,CAAC,OAAO,CAAC,wBAAwB,KAAK,GAAG,GAAG;AAK9C,UAAI,SAAS,aAAa,OAAO;AAC/B,gBAAQ;AAAA,UACN,sDAAsD,SAAS,QAAQ,SAAS,SAAS,OAAO,QAC9F,MAAM,eAAe,IACvB,sCAAsC,wBAAwB,MAAM;AAAA,QAGtE;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,MAAM,cAAc;AAMvC,UAAM,YAAY,mBAAkC,SAAS,QAAQ,IAAS,GAAG;AACjF,UAAM,YAAY,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI,IAAI;AAElD,UAAM,UAAU,MAAM,MAAM,QAAQ,YAAY,WAAW;AAAA,MACzD,aAAa;AAAA,MACb,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,WAAO,CAAC;AAAA,EACV;AACF;AAKA,MAAM,0BAA0B;AAKzB,SAAS,mBAAmB,QAA0C;AAC3E,SAAO,IAAI,aAAa,MAAM;AAChC;","names":[]}
+{"version":3,"sources":["../../../src/lib/core/AsyncHandler.ts"],"sourcesContent":["/**\n * Structured async handler for AdCP webhook responses\n * Provides type-safe callbacks for each AdCP tool completion\n */\n\nimport type { IdempotencyBackend } from '../server/idempotency/store';\nimport type {\n  ListCreativeFormatsResponse,\n  ListCreativesResponse,\n  PreviewCreativeResponse,\n  BuildCreativeResponse,\n  GetMediaBuysResponse,\n  GetMediaBuyDeliveryResponse,\n  GetCreativeDeliveryResponse,\n  ProvidePerformanceFeedbackResponse,\n  GetSignalsResponse,\n  ActivateSignalResponse,\n  ListAccountsResponse,\n  SyncAccountsResponse,\n  SyncAudiencesResponse,\n  CreatePropertyListResponse,\n  GetPropertyListResponse,\n  UpdatePropertyListResponse,\n  ListPropertyListsResponse,\n  DeletePropertyListResponse,\n  ListContentStandardsResponse,\n  GetContentStandardsResponse,\n  CalibrateContentResponse,\n  ValidateContentDeliveryResponse,\n  SIGetOfferingResponse,\n  SIInitiateSessionResponse,\n  SISendMessageResponse,\n  SITerminateSessionResponse,\n} from '../types/tools.generated';\n\nimport type {\n  AdCPAsyncResponseData,\n  CreateMediaBuyAsyncInputRequired,\n  CreateMediaBuyAsyncSubmitted,\n  CreateMediaBuyAsyncWorking,\n  CreateMediaBuyResponse,\n  GetProductsAsyncInputRequired,\n  GetProductsAsyncSubmitted,\n  GetProductsAsyncWorking,\n  GetProductsResponse,\n  SyncCreativesAsyncInputRequired,\n  SyncCreativesAsyncSubmitted,\n  SyncCreativesAsyncWorking,\n  SyncCreativesResponse,\n  TaskStatus,\n  TaskType,\n  UpdateMediaBuyAsyncInputRequired,\n  UpdateMediaBuyAsyncSubmitted,\n  UpdateMediaBuyAsyncWorking,\n  UpdateMediaBuyResponse,\n} from '../types/core.generated';\nimport type { TaskResultMetadata } from './ConversationTypes';\nimport {\n  CreateMediaBuyAsyncResponseData,\n  GetProductsAsyncResponseData,\n  SyncCreativesAsyncResponseData,\n  UpdateMediaBuyAsyncResponseData,\n} from '../types';\nimport type {\n  CanonicalCreativeResponse,\n  CanonicalGetProductsResponse,\n  CanonicalListCreativesResponse,\n} from '../v2/projection/creative-delivery';\n\n/**\n * Metadata provided with webhook responses\n */\nexport interface WebhookMetadata {\n  /** Client-provided operation ID */\n  operation_id: string;\n  /** Server's task ID */\n  task_id: string;\n  /** Agent ID */\n  agent_id: string;\n  /** Task type/tool name */\n  task_type: string;\n  /** Task status (completed, failed, needs_input, working, etc) */\n  status: TaskStatus;\n  /** Server's context ID */\n  context_id?: string;\n  /** Human-readable context about the status change */\n  message?: string;\n  /** Timestamp */\n  timestamp: string;\n  /** raw HTTP payload */\n  rawHTTPPayload?: any;\n  /**\n   * Wire protocol that delivered this webhook. Useful for handler code\n   * that needs to treat MCP and A2A transports differently (e.g.,\n   * `idempotency_key` is only present on MCP payloads).\n   */\n  protocol?: 'mcp' | 'a2a';\n  /**\n   * Sender-generated key stable across retries of the same webhook event\n   * (MCP envelope only — A2A webhooks do not carry this field). Use this\n   * as the canonical dedup key; see `AsyncHandlerConfig.webhookDedup`.\n   */\n  idempotency_key?: string;\n  /**\n   * Buyer-side product property policy evaluation for completed get_products\n   * webhooks. Present when the client filters, audits, or rejects a webhook\n   * result before dispatching it to handlers.\n   */\n  productPropertyPolicy?: TaskResultMetadata['productPropertyPolicy'];\n  /**\n   * Buyer-side pricing-options enforcement summary for completed get_products\n   * webhooks. Present when the client drops products that arrived without a\n   * usable `pricing_options[]` array before dispatching to handlers.\n   */\n  productPricingPolicy?: TaskResultMetadata['productPricingPolicy'];\n}\n\n/**\n * Metadata for agent-initiated notifications\n * Same as WebhookMetadata but includes notification-specific fields\n */\nexport interface NotificationMetadata extends WebhookMetadata {\n  /** Notification type */\n  notification_type: 'scheduled' | 'final' | 'delayed';\n  /** Sequence number of this notification */\n  sequence_number?: number;\n  /** When next notification is expected (not present for 'final') */\n  next_expected_at?: string;\n}\n\n// Simple union-typed handlers for webhook status changes\nexport type GetProductsStatusChangeHandler = (\n  response:\n    | CanonicalGetProductsResponse\n    | GetProductsAsyncSubmitted\n    | GetProductsAsyncWorking\n    | GetProductsAsyncInputRequired,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type CreateMediaBuyStatusChangeHandler = (\n  response: CanonicalCreativeResponse<\n    | CreateMediaBuyResponse\n    | CreateMediaBuyAsyncSubmitted\n    | CreateMediaBuyAsyncWorking\n    | CreateMediaBuyAsyncInputRequired\n  >,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type UpdateMediaBuyStatusChangeHandler = (\n  response: CanonicalCreativeResponse<\n    | UpdateMediaBuyResponse\n    | UpdateMediaBuyAsyncSubmitted\n    | UpdateMediaBuyAsyncWorking\n    | UpdateMediaBuyAsyncInputRequired\n  >,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\nexport type SyncCreativesStatusChangeHandler = (\n  response: CanonicalCreativeResponse<\n    SyncCreativesResponse | SyncCreativesAsyncSubmitted | SyncCreativesAsyncWorking | SyncCreativesAsyncInputRequired\n  >,\n  metadata: WebhookMetadata\n) => void | Promise<void>;\n\n/**\n * Media buy delivery notification payload (PR #81)\n * Agent-initiated periodic reporting, not tied to any client operation\n */\nexport interface MediaBuyDeliveryNotification {\n  /** Type of notification */\n  notification_type: 'scheduled' | 'final' | 'delayed';\n  /** Sequential notification number (starts at 1) */\n  sequence_number?: number;\n  /** When next notification is expected (omitted for 'final') */\n  next_expected_at?: string;\n  /** Reporting period for this notification */\n  reporting_period?: {\n    start: string;\n    end: string;\n  };\n  /** Currency used for financial metrics */\n  currency?: string;\n  /** Array of media buy deliveries being reported */\n  media_buy_deliveries?: Array<{\n    media_buy_id: string;\n    impressions?: number;\n    clicks?: number;\n    spend?: number;\n    conversions?: number;\n    [key: string]: any;\n  }>;\n}\n\n/**\n * Activity event for logging/observability\n */\nexport interface Activity {\n  type:\n    | 'protocol_request'\n    | 'protocol_response'\n    | 'status_change'\n    | 'webhook_received'\n    | 'webhook_duplicate'\n    | 'governance_check'\n    | 'governance_outcome';\n  operation_id: string;\n  agent_id: string;\n  context_id?: string;\n  task_id?: string;\n  task_type: string;\n  status?: string;\n  /**\n   * Full AdCP response payload. Populated on `webhook_received` and\n   * protocol/status events. INTENTIONALLY omitted on `webhook_duplicate`\n   * to avoid re-logging potentially-sensitive data on every retry — the\n   * originating `webhook_received` event already carries it. Correlate\n   * the two via `idempotency_key`.\n   */\n  payload?: any;\n  /**\n   * Webhook idempotency key when available. Present on `webhook_received`\n   * and `webhook_duplicate` events from MCP envelopes, enabling\n   * correlation between a first delivery and its retry echoes.\n   */\n  idempotency_key?: string;\n  timestamp: string;\n}\n\n/**\n * Configuration for async handler with typed callbacks\n */\nexport interface AsyncHandlerConfig {\n  // AdCP tool status change handlers - called for ALL status changes (completed, failed, working, input-required, submitted)\n  onGetProductsStatusChange?: GetProductsStatusChangeHandler;\n  onListCreativeFormatsLegacyStatusChange?: (\n    data: ListCreativeFormatsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onCreateMediaBuyStatusChange?: CreateMediaBuyStatusChangeHandler;\n  onUpdateMediaBuyStatusChange?: UpdateMediaBuyStatusChangeHandler;\n  onSyncCreativesStatusChange?: SyncCreativesStatusChangeHandler;\n  onListCreativesStatusChange?: (\n    response: CanonicalListCreativesResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onPreviewCreativeLegacyStatusChange?: (\n    response: PreviewCreativeResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetMediaBuysStatusChange?: (\n    response: CanonicalCreativeResponse<GetMediaBuysResponse>,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetMediaBuyDeliveryStatusChange?: (\n    response: CanonicalCreativeResponse<GetMediaBuyDeliveryResponse>,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetCreativeDeliveryStatusChange?: (\n    response: CanonicalCreativeResponse<GetCreativeDeliveryResponse>,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onProvidePerformanceFeedbackStatusChange?: (\n    response: ProvidePerformanceFeedbackResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetSignalsStatusChange?: (response: GetSignalsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onActivateSignalStatusChange?: (response: ActivateSignalResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onBuildCreativeLegacyStatusChange?: (\n    response: BuildCreativeResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListAccountsStatusChange?: (response: ListAccountsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSyncAccountsStatusChange?: (response: SyncAccountsResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSyncAudiencesStatusChange?: (response: SyncAudiencesResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onCreatePropertyListStatusChange?: (\n    response: CreatePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetPropertyListStatusChange?: (\n    response: GetPropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onUpdatePropertyListStatusChange?: (\n    response: UpdatePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListPropertyListsStatusChange?: (\n    response: ListPropertyListsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onDeletePropertyListStatusChange?: (\n    response: DeletePropertyListResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onListContentStandardsLegacyStatusChange?: (\n    response: ListContentStandardsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onGetContentStandardsLegacyStatusChange?: (\n    response: GetContentStandardsResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onCalibrateContentLegacyStatusChange?: (\n    response: CalibrateContentResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onValidateContentDeliveryLegacyStatusChange?: (\n    response: ValidateContentDeliveryResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onSIGetOfferingStatusChange?: (response: SIGetOfferingResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSIInitiateSessionStatusChange?: (\n    response: SIInitiateSessionResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n  onSISendMessageStatusChange?: (response: SISendMessageResponse, metadata: WebhookMetadata) => void | Promise<void>;\n  onSITerminateSessionStatusChange?: (\n    response: SITerminateSessionResponse,\n    metadata: WebhookMetadata\n  ) => void | Promise<void>;\n\n  // Fallback handler for any task status change\n  onTaskStatusChange?: (response: any, metadata: WebhookMetadata) => void | Promise<void>;\n\n  // Activity logging (low-level protocol events)\n  onActivity?: (activity: Activity) => void | Promise<void>;\n\n  /**\n   * Receiver-side deduplication of webhook payloads by `idempotency_key`.\n   *\n   * AdCP webhooks use at-least-once delivery — publishers retry until they\n   * see a 2xx, so the same event may arrive more than once. When configured,\n   * the first delivery for a given `(agent_id, idempotency_key)` tuple\n   * dispatches to handlers; subsequent deliveries are dropped and surface\n   * as a `webhook_duplicate` activity.\n   *\n   * Reuses `IdempotencyBackend` from `@adcp/sdk/server` — you can share\n   * the same backend across request-side and webhook-side dedup, or use a\n   * dedicated one. Scope is per-agent so keys from different senders are\n   * independent, matching the spec's \"scoped to authenticated sender\n   * identity\" rule.\n   *\n   * If a payload arrives without `idempotency_key` (non-conforming sender,\n   * or A2A transport which does not carry the field), dispatch proceeds\n   * without dedup and a warning is logged.\n   */\n  webhookDedup?: {\n    backend: IdempotencyBackend;\n    /** Retention for dedup keys. Defaults to 86_400 (24h). */\n    ttlSeconds?: number;\n  };\n\n  // Notification handlers (agent-initiated, no operation_id)\n  onMediaBuyDeliveryNotification?: (\n    notification: MediaBuyDeliveryNotification,\n    metadata: NotificationMetadata\n  ) => void | Promise<void>;\n}\n\n/**\n * Async handler class\n */\nexport class AsyncHandler {\n  constructor(private config: AsyncHandlerConfig) {}\n\n  /**\n   * Handle incoming webhook payload (both task completions and notifications)\n   */\n  async handleWebhook({\n    result,\n    metadata,\n  }: {\n    result: AdCPAsyncResponseData | undefined;\n    metadata: WebhookMetadata;\n  }): Promise<void> {\n    if (await this.isDuplicate(metadata)) {\n      await this.emitActivity({\n        type: 'webhook_duplicate',\n        operation_id: metadata.operation_id,\n        agent_id: metadata.agent_id,\n        context_id: metadata.context_id,\n        task_id: metadata.task_id,\n        task_type: metadata.task_type,\n        status: metadata.status,\n        idempotency_key: metadata.idempotency_key,\n        timestamp: metadata.timestamp,\n      });\n      return;\n    }\n\n    // Emit activity\n    await this.emitActivity({\n      type: 'webhook_received',\n      idempotency_key: metadata.idempotency_key,\n      operation_id: metadata.operation_id,\n      agent_id: metadata.agent_id,\n      context_id: metadata.context_id,\n      task_id: metadata.task_id,\n      task_type: metadata.task_type,\n      status: metadata.status,\n      payload: metadata.rawHTTPPayload?.result ?? result,\n      timestamp: metadata.timestamp,\n    });\n\n    // Check if this is a notification (media_buy_delivery with notification_type)\n    // Notifications are treated like status updates for an ongoing \"get delivery report\" operation\n    // The operation_id (from URL) groups all reports for the same agent + month\n    if (\n      metadata.task_type === 'media_buy_delivery' &&\n      result &&\n      typeof result === 'object' &&\n      'notification_type' in result\n    ) {\n      const notificationPayload = result as unknown as MediaBuyDeliveryNotification;\n\n      // Build notification metadata\n      // operation_id comes from webhook URL and was lazily generated from agent + month\n      const notificationMetadata: NotificationMetadata = {\n        ...metadata,\n        notification_type: notificationPayload.notification_type,\n        sequence_number: notificationPayload.sequence_number,\n        next_expected_at: notificationPayload.next_expected_at,\n      };\n\n      await this.config.onMediaBuyDeliveryNotification?.(notificationPayload, notificationMetadata);\n      return;\n    }\n\n    // All status changes go through the specific handler\n    // The handler receives metadata with status and can act accordingly\n    await this.handleCompletion(metadata.task_type, result, metadata);\n  }\n\n  /**\n   * Handle task completion - route to specific handler\n   */\n  private async handleCompletion(\n    taskType: string,\n    result: AdCPAsyncResponseData | undefined,\n    metadata: WebhookMetadata\n  ): Promise<void> {\n    let handler: ((result: any, metadata: any) => void | Promise<void>) | undefined;\n\n    // Route to specific handler based on task type\n    switch (taskType) {\n      case 'get_products':\n        handler = this.config.onGetProductsStatusChange;\n        break;\n\n      case 'list_creative_formats':\n        handler = this.config.onListCreativeFormatsLegacyStatusChange;\n        break;\n\n      case 'preview_creative':\n        handler = this.config.onPreviewCreativeLegacyStatusChange;\n        break;\n\n      case 'build_creative':\n        handler = this.config.onBuildCreativeLegacyStatusChange;\n        break;\n\n      case 'create_media_buy':\n        handler = this.config.onCreateMediaBuyStatusChange;\n        break;\n\n      case 'update_media_buy':\n        handler = this.config.onUpdateMediaBuyStatusChange;\n        break;\n\n      case 'sync_creatives':\n        handler = this.config.onSyncCreativesStatusChange;\n        break;\n\n      case 'list_creatives':\n        handler = this.config.onListCreativesStatusChange;\n        break;\n\n      case 'get_media_buys':\n        handler = this.config.onGetMediaBuysStatusChange;\n        break;\n\n      case 'get_media_buy_delivery':\n        handler = this.config.onGetMediaBuyDeliveryStatusChange;\n        break;\n\n      case 'get_creative_delivery':\n        handler = this.config.onGetCreativeDeliveryStatusChange;\n        break;\n\n      case 'provide_performance_feedback':\n        handler = this.config.onProvidePerformanceFeedbackStatusChange;\n        break;\n\n      case 'get_signals':\n        handler = this.config.onGetSignalsStatusChange;\n        break;\n\n      case 'activate_signal':\n        handler = this.config.onActivateSignalStatusChange;\n        break;\n\n      case 'list_content_standards':\n        handler = this.config.onListContentStandardsLegacyStatusChange;\n        break;\n\n      case 'get_content_standards':\n        handler = this.config.onGetContentStandardsLegacyStatusChange;\n        break;\n\n      case 'calibrate_content':\n        handler = this.config.onCalibrateContentLegacyStatusChange;\n        break;\n\n      case 'validate_content_delivery':\n        handler = this.config.onValidateContentDeliveryLegacyStatusChange;\n        break;\n    }\n\n    // Call specific handler if configured, otherwise fallback to generic handler\n    const handlerToCall = handler || this.config.onTaskStatusChange;\n\n    if (handlerToCall) {\n      try {\n        await handlerToCall(result, metadata);\n      } catch (error) {\n        // Log error but don't crash webhook processing\n        console.error(\n          `Error in handler for task ${taskType}:`,\n          error instanceof Error ? error.message : 'unknown error'\n        );\n      }\n    }\n  }\n\n  /**\n   * Emit activity event\n   */\n  private async emitActivity(activity: Activity): Promise<void> {\n    await this.config.onActivity?.(activity);\n  }\n\n  /**\n   * Claim the webhook for processing, returning true if the event has\n   * already been delivered for this `(agent_id, idempotency_key)` tuple.\n   *\n   * Uses `IdempotencyBackend.putIfAbsent` so concurrent retries race on a\n   * single claim: exactly one caller gets `true` and proceeds, the rest\n   * observe the existing entry and return.\n   */\n  private async isDuplicate(metadata: WebhookMetadata): Promise<boolean> {\n    const dedup = this.config.webhookDedup;\n    if (!dedup) return false;\n\n    const key = metadata.idempotency_key;\n    if (!key || !IDEMPOTENCY_KEY_PATTERN.test(key)) {\n      // No valid key. MCP senders MUST emit one per AdCP 3.0; A2A\n      // transport doesn't carry the field at all. Warn MCP (so\n      // integrators notice non-conforming publishers) and stay quiet\n      // for A2A (expected and unactionable).\n      if (metadata.protocol !== 'a2a') {\n        console.warn(\n          `[AdCP] webhookDedup enabled but webhook from agent=${metadata.agent_id} task=${metadata.task_id} has ${\n            key ? 'an invalid' : 'no'\n          } idempotency_key. Expected format: ${IDEMPOTENCY_KEY_PATTERN.source}. ` +\n            'Dispatching without dedup — duplicate deliveries from this sender will re-trigger handlers. ' +\n            'See docs/guides/PUSH-NOTIFICATION-CONFIG.md#deduplication'\n        );\n      }\n      return false;\n    }\n\n    const ttlSeconds = dedup.ttlSeconds ?? 86_400;\n    // Reserved prefix `adcp\\u001fwebhook\\u001fv1\\u001f...` namespaces the\n    // claim so webhook dedup entries can coexist with request-side\n    // idempotency entries in a shared backend — a request-side principal\n    // can never produce a scoped key with this prefix because the\n    // principal regex excludes U+001F.\n    const scopedKey = `adcp\\u001fwebhook\\u001fv1\\u001f${metadata.agent_id}\\u001f${key}`;\n    const expiresAt = Math.floor(Date.now() / 1000) + ttlSeconds;\n\n    const claimed = await dedup.backend.putIfAbsent(scopedKey, {\n      payloadHash: '',\n      response: null,\n      expiresAt,\n    });\n    return !claimed;\n  }\n}\n\n// AdCP spec: `^[A-Za-z0-9_.:-]{16,255}$`. Any key not matching this\n// pattern is malformed — treat as missing rather than forming a scoped\n// key from arbitrary sender-supplied bytes.\nconst IDEMPOTENCY_KEY_PATTERN = /^[A-Za-z0-9_.:-]{16,255}$/;\n\n/**\n * Factory function to create async handler\n */\nexport function createAsyncHandler(config: AsyncHandlerConfig): AsyncHandler {\n  return new AsyncHandler(config);\n}\n"],"mappings":"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","names":[]}

package/dist/lib/core/ConversationTypes.d.mts

@@ -161,8 +161,12 @@ export interface TaskState {
     taskId: string;
     /** Task name (tool name) */
     taskName: string;
-    /** Original parameters */
-    params: any;
+    /**
+     * Original parameters while the SDK is actively dispatching or resolving
+     * input. Redacted after a task becomes working, submitted, or terminal so
+     * lifecycle inspection does not retain request assets or credentials.
+     */
+    params?: any;
     /** Current status */
     status: TaskStatus;
     /** Message history */

package/dist/lib/core/ConversationTypes.d.ts

@@ -161,8 +161,12 @@ export interface TaskState {
     taskId: string;
     /** Task name (tool name) */
     taskName: string;
-    /** Original parameters */
-    params: any;
+    /**
+     * Original parameters while the SDK is actively dispatching or resolving
+     * input. Redacted after a task becomes working, submitted, or terminal so
+     * lifecycle inspection does not retain request assets or credentials.
+     */
+    params?: any;
     /** Current status */
     status: TaskStatus;
     /** Message history */

package/dist/lib/core/ConversationTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConversationTypes.d.ts","sourceRoot":"","sources":["../../../src/lib/core/ConversationTypes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConversationTypes.d.ts","sourceRoot":"","sources":["../../../src/lib/core/ConversationTypes.ts"],"names":[],"mappings":"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"}

package/dist/lib/core/ConversationTypes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/core/ConversationTypes.ts"],"sourcesContent":["// Core conversation types for ADCP client library\n// These types support the conversation and clarification pattern\n\nimport type { ProductPropertyPolicyDiagnostic, ProductPropertyPolicyMode } from '../media-buy/property-policy';\n\n/**\n * Represents a single message in a conversation with an agent\n */\nexport interface Message {\n  /** Unique identifier for this message */\n  id: string;\n  /** Role of the message sender */\n  role: 'user' | 'agent' | 'system';\n  /** Message content - can be structured or text */\n  content: any;\n  /** Timestamp when message was created */\n  timestamp: string;\n  /** Optional metadata about the message */\n  metadata?: {\n    /** Tool/task name if this message is tool-related */\n    toolName?: string;\n    /** Message type (request, response, clarification, etc.) */\n    type?: string;\n    /** Additional context data */\n    [key: string]: any;\n  };\n}\n\n/**\n * Request for input from the agent - sent when clarification is needed\n */\nexport interface InputRequest {\n  /** Human-readable question or prompt */\n  question: string;\n  /** Specific field being requested (if applicable) */\n  field?: string;\n  /** Expected type of response */\n  expectedType?: 'string' | 'number' | 'boolean' | 'object' | 'array';\n  /** Suggested values or options */\n  suggestions?: any[];\n  /** Whether this input is required */\n  required?: boolean;\n  /** Validation rules for the input */\n  validation?: {\n    min?: number;\n    max?: number;\n    pattern?: string;\n    enum?: any[];\n  };\n  /** Additional context about why this input is needed */\n  context?: string;\n}\n\n/**\n * Different types of responses an input handler can provide\n */\nexport type InputHandlerResponse =\n  | any // Direct answer\n  | Promise<any> // Async answer\n  | { defer: true; token: string } // Defer to human\n  | { abort: true; reason?: string } // Abort task\n  | never; // For control flow (abort() helper)\n\n/**\n * Function signature for input handlers\n */\nexport type InputHandler = (context: ConversationContext) => InputHandlerResponse;\n\n/**\n * Complete conversation context provided to input handlers\n */\nexport interface ConversationContext {\n  /** Full conversation history for this task */\n  messages: Message[];\n  /** Current input request from the agent */\n  inputRequest: InputRequest;\n  /** Unique task identifier */\n  taskId: string;\n  /** Agent configuration */\n  agent: {\n    id: string;\n    name: string;\n    protocol: 'mcp' | 'a2a';\n  };\n  /** Current clarification attempt number (1-based) */\n  attempt: number;\n  /** Maximum allowed clarification attempts */\n  maxAttempts: number;\n\n  /** Helper method to defer task to human */\n  deferToHuman(): Promise<{ defer: true; token: string }>;\n\n  /** Helper method to abort the task */\n  abort(reason?: string): never;\n\n  /** Get conversation summary for context */\n  getSummary(): string;\n\n  /** Check if a field was previously discussed */\n  wasFieldDiscussed(field: string): boolean;\n\n  /** Get previous response for a field */\n  getPreviousResponse(field: string): any;\n}\n\n/**\n * Status of a task execution\n */\nexport type TaskStatus =\n  | 'pending'\n  | 'running'\n  | 'working'\n  | 'needs_input'\n  | 'input-required'\n  | 'auth-required'\n  | 'completed'\n  | 'failed'\n  | 'rejected'\n  | 'canceled'\n  | 'deferred'\n  | 'aborted'\n  | 'submitted'\n  | 'governance-denied';\n\n/**\n * Predicate used by scoped webhook URL templates to decide which operations\n * receive protocol-level webhook URLs.\n */\nexport type WebhookToolPredicate = (toolName: string) => boolean;\n\n/**\n * Webhook URL template with macro substitution. A bare string preserves the\n * legacy behavior: every operation receives a generated webhook URL. The\n * object form scopes webhook URL generation to a tool allowlist or predicate.\n */\nexport type WebhookUrlTemplate =\n  | string\n  | {\n      template: string;\n      tools?: string[] | WebhookToolPredicate;\n    };\n\n/**\n * Options for task execution\n */\nexport interface TaskOptions {\n  /** Timeout for entire task (ms) */\n  timeout?: number;\n  /**\n   * Caller-owned cancellation signal for the read path and in-flight protocol\n   * call. Aborting this signal cancels discovery probes (`getAgentInfo`,\n   * `getCapabilities`, feature/version preflight) and the tool request where\n   * the underlying official protocol client supports it.\n   */\n  signal?: AbortSignal;\n  /** Maximum clarification rounds before failing */\n  maxClarifications?: number;\n  /**\n   * A2A `contextId` that binds this call to a server-side conversation.\n   * When set, the client sends it on the A2A Message envelope so the server\n   * can route to the existing session instead of starting a new one.\n   * Retained automatically across calls on the same `AgentClient`.\n   */\n  contextId?: string;\n  /**\n   * A2A `taskId` of a non-terminal task to resume (HITL / approval flows).\n   * When set, the client sends it on the A2A Message envelope so the server\n   * continues the same task rather than opening a new one.\n   */\n  taskId?: string;\n  /** Enable debug logging for this task */\n  debug?: boolean;\n  /** Suppress automatic webhook URL generation for this call. */\n  disableWebhook?: boolean;\n  /** Additional metadata to include */\n  metadata?: Record<string, any>;\n  /**\n   * INTERNAL — compliance-test-only escape hatch.\n   *\n   * Suppresses the client's automatic `idempotency_key` generation on\n   * mutating requests. The sole caller is the storyboard runner, which\n   * needs to exercise servers' missing-key validation. Auto-injection\n   * is the retry-safety contract for every real buyer — bypassing it\n   * in production breaks at-most-once semantics on network retries.\n   *\n   * @internal Do not set in production buyer code.\n   */\n  skipIdempotencyAutoInject?: boolean;\n  /**\n   * INTERNAL — compliance-test-only escape hatch.\n   *\n   * Suppresses the client's `account`-required validation on\n   * `create_media_buy` requests. The sole caller is the storyboard runner,\n   * which needs to exercise servers' missing-account validation without the\n   * SDK throwing client-side before the wire call.\n   *\n   * @internal Do not set in production buyer code.\n   */\n  skipAccountValidation?: boolean;\n  /**\n   * Transport-level safeguards for this call. Overrides the matching field\n   * on the client constructor's `transport` option. Use to lift or tighten\n   * `maxResponseBytes` per call when an agent legitimately publishes large\n   * catalogs (e.g., `list_creative_formats` on a generative seller).\n   */\n  transport?: import('../protocols').TransportOptions;\n}\n\n/**\n * Internal task state for tracking execution\n */\nexport interface TaskState {\n  /** Unique task identifier */\n  taskId: string;\n  /** Task name (tool name) */\n  taskName: string;\n  /** Original parameters */\n  params: any;\n  /** Current status */\n  status: TaskStatus;\n  /** Message history */\n  messages: Message[];\n  /** Current input request (if waiting for input) */\n  pendingInput?: InputRequest;\n  /** Start time */\n  startTime: number;\n  /** Current attempt number */\n  attempt: number;\n  /** Maximum attempts allowed */\n  maxAttempts: number;\n  /** Task options */\n  options: TaskOptions;\n  /** Agent configuration */\n  agent: {\n    id: string;\n    name: string;\n    protocol: 'mcp' | 'a2a';\n  };\n  /**\n   * Idempotency key for this task, when the tool is mutating. Tracked on\n   * state so internal retries reuse the same key (the whole point of the\n   * envelope — a re-generated key defeats retry safety).\n   */\n  idempotencyKey?: string;\n}\n\n/**\n * Task tracking information from tasks/get endpoint (PR #78)\n */\nexport interface TaskInfo {\n  /** Task ID */\n  taskId: string;\n  /** Current status */\n  status: string;\n  /** Task type/name */\n  taskType: string;\n  /** Creation timestamp */\n  createdAt: number;\n  /** Last update timestamp */\n  updatedAt: number;\n  /** Task result (if completed) */\n  result?: any;\n  /** Error message (if failed) */\n  error?: string;\n  /** Human-readable message from agent (alternative to error field) */\n  message?: string;\n  /** Webhook URL (if applicable) */\n  webhookUrl?: string;\n}\n\n/**\n * Continuation for deferred client tasks (client needs time)\n */\nexport interface DeferredContinuation<T> {\n  /** Token for resuming the task */\n  token: string;\n  /** Question that triggered the deferral */\n  question?: string;\n  /** Resume the task with user input */\n  resume: (input: any) => Promise<TaskResult<T>>;\n}\n\n/**\n * Continuation for submitted server tasks (server needs time).\n *\n * Returned in `TaskResult.submitted` when the seller signals an AdCP\n * `submitted` arm (long-running work that won't complete inside the\n * transport call). The buyer either polls via {@link waitForCompletion}\n * / {@link track} or waits for the seller's webhook callback at\n * {@link webhookUrl}.\n */\nexport interface SubmittedContinuation<T> {\n  /**\n   * Server-assigned task handle — the value the seller emitted in\n   * `response.task_id` (AdCP submitted-arm wire field) or surfaced via\n   * the A2A response Task. This is the identifier the seller knows; it\n   * is what the SDK passes to subsequent `tasks/get` polling calls.\n   *\n   * NOT the same as the SDK's runner-side correlation id (`TaskState.taskId`,\n   * a local UUID generated at request time and used internally for\n   * `activeTasks` map indexing and the `{operation_id}` webhook URL macro).\n   * The runner-side id never reaches the seller.\n   *\n   * If the seller violated the spec and didn't include a task handle on\n   * the submitted-arm response, this falls back to the runner-side\n   * correlation id — pollers won't be able to locate the work, but\n   * callers at least get a non-undefined value to log.\n   */\n  taskId: string;\n  /** Webhook URL where server will notify completion */\n  webhookUrl?: string;\n  /** Get current task status. Pass `transport` to override the executor-constructor cap for this poll. */\n  track: (transport?: import('../protocols').TransportOptions) => Promise<TaskInfo>;\n  /**\n   * Wait for completion with polling. Transport cap is fixed at task-submission time; use `track` for per-poll override.\n   * Pass `signal` to cancel the polling loop early (e.g. `AbortSignal.timeout(ms)`); the loop exits cleanly on abort\n   * rather than continuing to issue `tasks/get` requests after the caller has moved on. (adcp-client#1612)\n   * On abort with an A2A seller, a `tasks/cancel` is also dispatched as a protocol courtesy (A2A 0.3.0 §7.4)\n   * — fire-and-forget; the buyer does not wait for acknowledgment and the outcome does not affect the returned `TaskResult`.\n   */\n  waitForCompletion: (pollInterval?: number, signal?: AbortSignal) => Promise<TaskResult<T>>;\n}\n\n/**\n * A single validation failure from an AdCP VALIDATION_ERROR response.\n *\n * `pointer` uses RFC 6901 JSON Pointer format (e.g. `/packages/0/targeting`),\n * which differs from the top-level `AdcpErrorInfo.field` that uses JSONPath-lite\n * (`packages[0].targeting`). For LLM self-correction: read `keyword` first —\n * `'required'` means add the missing field, `'enum'` means pick a valid value,\n * `'type'` means fix the value type.\n */\nexport interface AdcpValidationIssue {\n  /** RFC 6901 JSON Pointer to the offending field (e.g. `/packages/0/targeting`). */\n  pointer: string;\n  /** Human-readable reason this field was rejected. */\n  message: string;\n  /** JSON Schema keyword that caused rejection (e.g. `'required'`, `'type'`, `'enum'`). */\n  keyword: string;\n  /**\n   * Path inside the schema that rejected the payload. Sellers SHOULD NOT emit on\n   * production endpoints — it leaks oneOf branch selection and is a fingerprinting\n   * oracle for adversarial callers. May appear in dev/sandbox mode.\n   */\n  schemaPath?: string;\n}\n\n/**\n * Structured AdCP error information extracted from a failed task response.\n * Present on `TaskResult.adcpError` when the agent returns a recognized error.\n */\nexport interface AdcpErrorInfo {\n  /** AdCP error code (e.g., 'RATE_LIMITED', 'PRODUCT_NOT_FOUND') */\n  code: string;\n  /** Human-readable error message. **Sellers:** do not embed tokens, account IDs, or internal paths — this field is forwarded to `ComplianceResult.failures[].adcp_error` and is grader-visible beyond the request lifetime. */\n  message: string;\n  /** Recovery classification: retry, fix the request, or give up */\n  recovery?: 'transient' | 'correctable' | 'terminal';\n  /** Field that caused the error */\n  field?: string;\n  /** Suggested fix from the agent. Untrusted — sanitize before rendering in HTML. */\n  suggestion?: string;\n  /** Seconds to wait before retrying (transient errors). See also `retryAfterMs`. */\n  retry_after?: number;\n  /** Milliseconds to wait before retrying — convenience conversion of `retry_after * 1000`. */\n  retryAfterMs?: number;\n  /** Additional error details. Untrusted agent-controlled content — sanitize before rendering. **Sellers:** do not embed tokens, account IDs, or internal paths — this field is forwarded to `ComplianceResult.failures[].adcp_error` and is grader-visible beyond the request lifetime. */\n  details?: Record<string, unknown>;\n  /**\n   * Structured validation failures. Present on `VALIDATION_ERROR` when the seller\n   * identifies multiple offending fields. Each item's `pointer` is RFC 6901 format\n   * (e.g. `/packages/0/targeting`) — differs from the top-level `field` which uses\n   * JSONPath-lite. For LLM self-correction, read `keyword` first: `'required'` → add\n   * the field, `'enum'` → pick a valid value, `'type'` → fix the value type.\n   */\n  issues?: AdcpValidationIssue[];\n  /** True when the SDK inferred this error from unstructured text (L1 compliance) */\n  synthetic?: boolean;\n}\n\n/**\n * Task execution metadata, shared across all result variants.\n */\nexport interface TaskResultMetadata {\n  /**\n   * Client-minted correlation id for this specific request attempt. Used\n   * for internal tracking (activeTasks map, webhook URL macros, debug\n   * logs) and retried/refired across attempts — NOT the A2A task id the\n   * server is tracking. For the server-side id, use {@link serverTaskId}.\n   */\n  taskId: string;\n  /**\n   * Server-returned A2A `contextId` / AdCP `context_id` that binds this\n   * response to a server-side conversation. Present when the server surfaced\n   * one; `undefined` otherwise (e.g., fire-and-forget MCP completions).\n   *\n   * Buyers who persist conversation across process restarts should save this\n   * and seed it into `AgentClient.resetContext(id)` on rehydration.\n   */\n  contextId?: string;\n  /**\n   * A2A `taskId` of the server-tracked task for this response. Populated\n   * from A2A Task / Message responses; `undefined` for MCP and for A2A\n   * responses that carry no task binding. Distinct from {@link taskId},\n   * which is the client-minted correlation id.\n   */\n  serverTaskId?: string;\n  taskName: string;\n  agent: { id: string; name: string; protocol: 'mcp' | 'a2a' };\n  /** Total execution time in milliseconds */\n  responseTimeMs: number;\n  /** ISO timestamp of completion */\n  timestamp: string;\n  /** Number of clarification rounds */\n  clarificationRounds: number;\n  /** Final status */\n  status: TaskStatus;\n  /** Input request details (for input-required status) */\n  inputRequest?: InputRequest;\n  /**\n   * Idempotency key used for this request, when the tool is mutating. Auto-\n   * generated by the SDK when the caller doesn't supply one. Surfaced for\n   * logging, correlation, and BYOK flows where the caller persists the key\n   * alongside the resource it creates.\n   */\n  idempotency_key?: string;\n  /**\n   * True when the response was a cached replay from the seller's idempotency\n   * store (i.e., an earlier request with the same key already succeeded).\n   *\n   * Callers with side effects on response — \"campaign created!\" notifications,\n   * LLM memory writes, downstream tool calls — MUST check this flag before\n   * acting, or retries will re-fire side effects.\n   */\n  replayed?: boolean;\n  /**\n   * Seller-served, release-precision AdCP version echoed on the response\n   * envelope. Present when the seller emits `adcp_version` (3.1+). Compare\n   * with the request's wire-normalized version, not a raw full-semver\n   * configuration pin, when detecting same-major downshift.\n   */\n  adcpVersion?: string;\n  /**\n   * Buyer-side product property policy enforcement summary for `get_products`.\n   * Present when the client evaluates a configured product property policy or\n   * enforces the request's `property_list` reference against the response.\n   */\n  productPropertyPolicy?: {\n    mode: ProductPropertyPolicyMode;\n    ok: boolean;\n    accepted_count: number;\n    rejected_count: number;\n    flagged_count: number;\n    message?: string;\n    request_property_list?: {\n      list_id: string;\n      agent_url: string;\n      identifier_count?: number;\n      cache_valid_until?: string;\n      resolution_error?: string;\n    };\n    diagnostics: ProductPropertyPolicyDiagnostic[];\n  };\n  /**\n   * Buyer-side pricing-options enforcement summary for `get_products`. Present\n   * when the client drops one or more products that arrived without a usable\n   * `pricing_options[]` array (a required, non-empty field in AdCP 3.1).\n   */\n  productPricingPolicy?: {\n    ok: boolean;\n    accepted_count: number;\n    rejected_count: number;\n    rejected_products: Array<{ index: number; product_id?: string }>;\n  };\n}\n\n/** Fields shared across all TaskResult variants. */\ninterface TaskResultBase<T = any> {\n  metadata: TaskResultMetadata;\n  /** Governance check result (present when governance is configured) */\n  governance?: import('./GovernanceTypes').GovernanceCheckResult;\n  /** Governance outcome (present after successful execution with governance) */\n  governanceOutcome?: import('./GovernanceTypes').GovernanceOutcome;\n  /** Error message when governance outcome reporting failed */\n  governanceOutcomeError?: string;\n  /** Full conversation history */\n  conversation?: Message[];\n  /** Debug logs (if debug enabled) */\n  debug_logs?: any[];\n  /**\n   * Exhaustive pattern match on the result's `status`. Prefer this method\n   * form — it autocompletes alongside the other `TaskResult` accessors.\n   *\n   * The free function {@link import('./match').match} is also exported for\n   * compositional use (e.g., point-free style or when the result type is\n   * not yet narrowed).\n   *\n   * Attached non-enumerably by the client when the result is returned\n   * from `executeTask`. Results constructed by hand (e.g., in test\n   * fixtures or custom middleware) will not have this method — use the\n   * free function, or call `attachMatch(result)` first.\n   */\n  match?: <R>(handlers: import('./match').MatchHandlers<T, R> | import('./match').PartialMatchHandlers<T, R>) => R;\n}\n\n/** Successful completion — `data` is always present. */\nexport interface TaskResultCompleted<T> extends TaskResultBase<T> {\n  success: true;\n  status: 'completed';\n  data: T;\n  error?: undefined;\n  adcpError?: undefined;\n  errorInstance?: undefined;\n  correlationId?: undefined;\n  deferred?: undefined;\n  submitted?: undefined;\n}\n\n/** Task is still progressing (working, submitted, input-required, deferred). */\nexport interface TaskResultIntermediate<T> extends TaskResultBase<T> {\n  success: true;\n  /**\n   * Task is progressing but not yet final. `'auth-required'` and\n   * `'input-required'` are paused states surfaced by the polling\n   * cycle (`pollTaskCompletion`) — the buyer must satisfy the\n   * paused condition (refresh auth / supply input) and retry the\n   * original tool call. Polling alone won't advance them.\n   */\n  status: 'working' | 'submitted' | 'input-required' | 'auth-required' | 'deferred';\n  data?: T;\n  error?: undefined;\n  adcpError?: undefined;\n  errorInstance?: undefined;\n  correlationId?: undefined;\n  /** Deferred continuation (client needs time for input) */\n  deferred?: DeferredContinuation<T>;\n  /** Submitted continuation (server needs time for processing) */\n  submitted?: SubmittedContinuation<T>;\n}\n\n/** Task failed — `error` is always present. */\nexport interface TaskResultFailure<T> extends TaskResultBase<T> {\n  success: false;\n  status: 'failed' | 'governance-denied';\n  /** Response payload with structured error details (adcp_error, context, ext) */\n  data?: T;\n  /** Human-readable error message */\n  error: string;\n  /** Structured AdCP error (code, recovery, suggestion, retryAfterMs) */\n  adcpError?: AdcpErrorInfo;\n  /**\n   * Typed `ADCPError` subclass instance when the seller's error code has a\n   * dedicated class — currently `IdempotencyConflictError` and\n   * `IdempotencyExpiredError`. Lets callers write\n   * `if (result.errorInstance instanceof IdempotencyConflictError)` instead of\n   * switching on `adcpError.code` strings. Absent for codes without a typed\n   * mapping.\n   */\n  errorInstance?: import('../errors').ADCPError;\n  /** Correlation ID from the error response context, for tracing across agents */\n  correlationId?: string;\n  deferred?: undefined;\n  submitted?: undefined;\n}\n\n/**\n * Result of a task execution.\n *\n * Discriminated union on `success`:\n * - `success: true` + `status: 'completed'` → `data` is `T`\n * - `success: true` + intermediate status → task is progressing, `data` may be partial\n * - `success: false` → `error` is always a string, `adcpError` has structured details\n */\nexport type TaskResult<T = any> = TaskResultCompleted<T> | TaskResultIntermediate<T> | TaskResultFailure<T>;\n\n/**\n * Configuration for conversation management\n */\nexport interface ConversationConfig {\n  /** Maximum messages to keep in history */\n  maxHistorySize?: number;\n  /** Whether to persist conversations */\n  persistConversations?: boolean;\n  /** Timeout for 'working' status (max 120s per PR #78) */\n  workingTimeout?: number;\n  /** Default max clarifications */\n  defaultMaxClarifications?: number;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../../src/lib/core/ConversationTypes.ts"],"sourcesContent":["// Core conversation types for ADCP client library\n// These types support the conversation and clarification pattern\n\nimport type { ProductPropertyPolicyDiagnostic, ProductPropertyPolicyMode } from '../media-buy/property-policy';\n\n/**\n * Represents a single message in a conversation with an agent\n */\nexport interface Message {\n  /** Unique identifier for this message */\n  id: string;\n  /** Role of the message sender */\n  role: 'user' | 'agent' | 'system';\n  /** Message content - can be structured or text */\n  content: any;\n  /** Timestamp when message was created */\n  timestamp: string;\n  /** Optional metadata about the message */\n  metadata?: {\n    /** Tool/task name if this message is tool-related */\n    toolName?: string;\n    /** Message type (request, response, clarification, etc.) */\n    type?: string;\n    /** Additional context data */\n    [key: string]: any;\n  };\n}\n\n/**\n * Request for input from the agent - sent when clarification is needed\n */\nexport interface InputRequest {\n  /** Human-readable question or prompt */\n  question: string;\n  /** Specific field being requested (if applicable) */\n  field?: string;\n  /** Expected type of response */\n  expectedType?: 'string' | 'number' | 'boolean' | 'object' | 'array';\n  /** Suggested values or options */\n  suggestions?: any[];\n  /** Whether this input is required */\n  required?: boolean;\n  /** Validation rules for the input */\n  validation?: {\n    min?: number;\n    max?: number;\n    pattern?: string;\n    enum?: any[];\n  };\n  /** Additional context about why this input is needed */\n  context?: string;\n}\n\n/**\n * Different types of responses an input handler can provide\n */\nexport type InputHandlerResponse =\n  | any // Direct answer\n  | Promise<any> // Async answer\n  | { defer: true; token: string } // Defer to human\n  | { abort: true; reason?: string } // Abort task\n  | never; // For control flow (abort() helper)\n\n/**\n * Function signature for input handlers\n */\nexport type InputHandler = (context: ConversationContext) => InputHandlerResponse;\n\n/**\n * Complete conversation context provided to input handlers\n */\nexport interface ConversationContext {\n  /** Full conversation history for this task */\n  messages: Message[];\n  /** Current input request from the agent */\n  inputRequest: InputRequest;\n  /** Unique task identifier */\n  taskId: string;\n  /** Agent configuration */\n  agent: {\n    id: string;\n    name: string;\n    protocol: 'mcp' | 'a2a';\n  };\n  /** Current clarification attempt number (1-based) */\n  attempt: number;\n  /** Maximum allowed clarification attempts */\n  maxAttempts: number;\n\n  /** Helper method to defer task to human */\n  deferToHuman(): Promise<{ defer: true; token: string }>;\n\n  /** Helper method to abort the task */\n  abort(reason?: string): never;\n\n  /** Get conversation summary for context */\n  getSummary(): string;\n\n  /** Check if a field was previously discussed */\n  wasFieldDiscussed(field: string): boolean;\n\n  /** Get previous response for a field */\n  getPreviousResponse(field: string): any;\n}\n\n/**\n * Status of a task execution\n */\nexport type TaskStatus =\n  | 'pending'\n  | 'running'\n  | 'working'\n  | 'needs_input'\n  | 'input-required'\n  | 'auth-required'\n  | 'completed'\n  | 'failed'\n  | 'rejected'\n  | 'canceled'\n  | 'deferred'\n  | 'aborted'\n  | 'submitted'\n  | 'governance-denied';\n\n/**\n * Predicate used by scoped webhook URL templates to decide which operations\n * receive protocol-level webhook URLs.\n */\nexport type WebhookToolPredicate = (toolName: string) => boolean;\n\n/**\n * Webhook URL template with macro substitution. A bare string preserves the\n * legacy behavior: every operation receives a generated webhook URL. The\n * object form scopes webhook URL generation to a tool allowlist or predicate.\n */\nexport type WebhookUrlTemplate =\n  | string\n  | {\n      template: string;\n      tools?: string[] | WebhookToolPredicate;\n    };\n\n/**\n * Options for task execution\n */\nexport interface TaskOptions {\n  /** Timeout for entire task (ms) */\n  timeout?: number;\n  /**\n   * Caller-owned cancellation signal for the read path and in-flight protocol\n   * call. Aborting this signal cancels discovery probes (`getAgentInfo`,\n   * `getCapabilities`, feature/version preflight) and the tool request where\n   * the underlying official protocol client supports it.\n   */\n  signal?: AbortSignal;\n  /** Maximum clarification rounds before failing */\n  maxClarifications?: number;\n  /**\n   * A2A `contextId` that binds this call to a server-side conversation.\n   * When set, the client sends it on the A2A Message envelope so the server\n   * can route to the existing session instead of starting a new one.\n   * Retained automatically across calls on the same `AgentClient`.\n   */\n  contextId?: string;\n  /**\n   * A2A `taskId` of a non-terminal task to resume (HITL / approval flows).\n   * When set, the client sends it on the A2A Message envelope so the server\n   * continues the same task rather than opening a new one.\n   */\n  taskId?: string;\n  /** Enable debug logging for this task */\n  debug?: boolean;\n  /** Suppress automatic webhook URL generation for this call. */\n  disableWebhook?: boolean;\n  /** Additional metadata to include */\n  metadata?: Record<string, any>;\n  /**\n   * INTERNAL — compliance-test-only escape hatch.\n   *\n   * Suppresses the client's automatic `idempotency_key` generation on\n   * mutating requests. The sole caller is the storyboard runner, which\n   * needs to exercise servers' missing-key validation. Auto-injection\n   * is the retry-safety contract for every real buyer — bypassing it\n   * in production breaks at-most-once semantics on network retries.\n   *\n   * @internal Do not set in production buyer code.\n   */\n  skipIdempotencyAutoInject?: boolean;\n  /**\n   * INTERNAL — compliance-test-only escape hatch.\n   *\n   * Suppresses the client's `account`-required validation on\n   * `create_media_buy` requests. The sole caller is the storyboard runner,\n   * which needs to exercise servers' missing-account validation without the\n   * SDK throwing client-side before the wire call.\n   *\n   * @internal Do not set in production buyer code.\n   */\n  skipAccountValidation?: boolean;\n  /**\n   * Transport-level safeguards for this call. Overrides the matching field\n   * on the client constructor's `transport` option. Use to lift or tighten\n   * `maxResponseBytes` per call when an agent legitimately publishes large\n   * catalogs (e.g., `list_creative_formats` on a generative seller).\n   */\n  transport?: import('../protocols').TransportOptions;\n}\n\n/**\n * Internal task state for tracking execution\n */\nexport interface TaskState {\n  /** Unique task identifier */\n  taskId: string;\n  /** Task name (tool name) */\n  taskName: string;\n  /**\n   * Original parameters while the SDK is actively dispatching or resolving\n   * input. Redacted after a task becomes working, submitted, or terminal so\n   * lifecycle inspection does not retain request assets or credentials.\n   */\n  params?: any;\n  /** Current status */\n  status: TaskStatus;\n  /** Message history */\n  messages: Message[];\n  /** Current input request (if waiting for input) */\n  pendingInput?: InputRequest;\n  /** Start time */\n  startTime: number;\n  /** Current attempt number */\n  attempt: number;\n  /** Maximum attempts allowed */\n  maxAttempts: number;\n  /** Task options */\n  options: TaskOptions;\n  /** Agent configuration */\n  agent: {\n    id: string;\n    name: string;\n    protocol: 'mcp' | 'a2a';\n  };\n  /**\n   * Idempotency key for this task, when the tool is mutating. Tracked on\n   * state so internal retries reuse the same key (the whole point of the\n   * envelope — a re-generated key defeats retry safety).\n   */\n  idempotencyKey?: string;\n}\n\n/**\n * Task tracking information from tasks/get endpoint (PR #78)\n */\nexport interface TaskInfo {\n  /** Task ID */\n  taskId: string;\n  /** Current status */\n  status: string;\n  /** Task type/name */\n  taskType: string;\n  /** Creation timestamp */\n  createdAt: number;\n  /** Last update timestamp */\n  updatedAt: number;\n  /** Task result (if completed) */\n  result?: any;\n  /** Error message (if failed) */\n  error?: string;\n  /** Human-readable message from agent (alternative to error field) */\n  message?: string;\n  /** Webhook URL (if applicable) */\n  webhookUrl?: string;\n}\n\n/**\n * Continuation for deferred client tasks (client needs time)\n */\nexport interface DeferredContinuation<T> {\n  /** Token for resuming the task */\n  token: string;\n  /** Question that triggered the deferral */\n  question?: string;\n  /** Resume the task with user input */\n  resume: (input: any) => Promise<TaskResult<T>>;\n}\n\n/**\n * Continuation for submitted server tasks (server needs time).\n *\n * Returned in `TaskResult.submitted` when the seller signals an AdCP\n * `submitted` arm (long-running work that won't complete inside the\n * transport call). The buyer either polls via {@link waitForCompletion}\n * / {@link track} or waits for the seller's webhook callback at\n * {@link webhookUrl}.\n */\nexport interface SubmittedContinuation<T> {\n  /**\n   * Server-assigned task handle — the value the seller emitted in\n   * `response.task_id` (AdCP submitted-arm wire field) or surfaced via\n   * the A2A response Task. This is the identifier the seller knows; it\n   * is what the SDK passes to subsequent `tasks/get` polling calls.\n   *\n   * NOT the same as the SDK's runner-side correlation id (`TaskState.taskId`,\n   * a local UUID generated at request time and used internally for\n   * `activeTasks` map indexing and the `{operation_id}` webhook URL macro).\n   * The runner-side id never reaches the seller.\n   *\n   * If the seller violated the spec and didn't include a task handle on\n   * the submitted-arm response, this falls back to the runner-side\n   * correlation id — pollers won't be able to locate the work, but\n   * callers at least get a non-undefined value to log.\n   */\n  taskId: string;\n  /** Webhook URL where server will notify completion */\n  webhookUrl?: string;\n  /** Get current task status. Pass `transport` to override the executor-constructor cap for this poll. */\n  track: (transport?: import('../protocols').TransportOptions) => Promise<TaskInfo>;\n  /**\n   * Wait for completion with polling. Transport cap is fixed at task-submission time; use `track` for per-poll override.\n   * Pass `signal` to cancel the polling loop early (e.g. `AbortSignal.timeout(ms)`); the loop exits cleanly on abort\n   * rather than continuing to issue `tasks/get` requests after the caller has moved on. (adcp-client#1612)\n   * On abort with an A2A seller, a `tasks/cancel` is also dispatched as a protocol courtesy (A2A 0.3.0 §7.4)\n   * — fire-and-forget; the buyer does not wait for acknowledgment and the outcome does not affect the returned `TaskResult`.\n   */\n  waitForCompletion: (pollInterval?: number, signal?: AbortSignal) => Promise<TaskResult<T>>;\n}\n\n/**\n * A single validation failure from an AdCP VALIDATION_ERROR response.\n *\n * `pointer` uses RFC 6901 JSON Pointer format (e.g. `/packages/0/targeting`),\n * which differs from the top-level `AdcpErrorInfo.field` that uses JSONPath-lite\n * (`packages[0].targeting`). For LLM self-correction: read `keyword` first —\n * `'required'` means add the missing field, `'enum'` means pick a valid value,\n * `'type'` means fix the value type.\n */\nexport interface AdcpValidationIssue {\n  /** RFC 6901 JSON Pointer to the offending field (e.g. `/packages/0/targeting`). */\n  pointer: string;\n  /** Human-readable reason this field was rejected. */\n  message: string;\n  /** JSON Schema keyword that caused rejection (e.g. `'required'`, `'type'`, `'enum'`). */\n  keyword: string;\n  /**\n   * Path inside the schema that rejected the payload. Sellers SHOULD NOT emit on\n   * production endpoints — it leaks oneOf branch selection and is a fingerprinting\n   * oracle for adversarial callers. May appear in dev/sandbox mode.\n   */\n  schemaPath?: string;\n}\n\n/**\n * Structured AdCP error information extracted from a failed task response.\n * Present on `TaskResult.adcpError` when the agent returns a recognized error.\n */\nexport interface AdcpErrorInfo {\n  /** AdCP error code (e.g., 'RATE_LIMITED', 'PRODUCT_NOT_FOUND') */\n  code: string;\n  /** Human-readable error message. **Sellers:** do not embed tokens, account IDs, or internal paths — this field is forwarded to `ComplianceResult.failures[].adcp_error` and is grader-visible beyond the request lifetime. */\n  message: string;\n  /** Recovery classification: retry, fix the request, or give up */\n  recovery?: 'transient' | 'correctable' | 'terminal';\n  /** Field that caused the error */\n  field?: string;\n  /** Suggested fix from the agent. Untrusted — sanitize before rendering in HTML. */\n  suggestion?: string;\n  /** Seconds to wait before retrying (transient errors). See also `retryAfterMs`. */\n  retry_after?: number;\n  /** Milliseconds to wait before retrying — convenience conversion of `retry_after * 1000`. */\n  retryAfterMs?: number;\n  /** Additional error details. Untrusted agent-controlled content — sanitize before rendering. **Sellers:** do not embed tokens, account IDs, or internal paths — this field is forwarded to `ComplianceResult.failures[].adcp_error` and is grader-visible beyond the request lifetime. */\n  details?: Record<string, unknown>;\n  /**\n   * Structured validation failures. Present on `VALIDATION_ERROR` when the seller\n   * identifies multiple offending fields. Each item's `pointer` is RFC 6901 format\n   * (e.g. `/packages/0/targeting`) — differs from the top-level `field` which uses\n   * JSONPath-lite. For LLM self-correction, read `keyword` first: `'required'` → add\n   * the field, `'enum'` → pick a valid value, `'type'` → fix the value type.\n   */\n  issues?: AdcpValidationIssue[];\n  /** True when the SDK inferred this error from unstructured text (L1 compliance) */\n  synthetic?: boolean;\n}\n\n/**\n * Task execution metadata, shared across all result variants.\n */\nexport interface TaskResultMetadata {\n  /**\n   * Client-minted correlation id for this specific request attempt. Used\n   * for internal tracking (activeTasks map, webhook URL macros, debug\n   * logs) and retried/refired across attempts — NOT the A2A task id the\n   * server is tracking. For the server-side id, use {@link serverTaskId}.\n   */\n  taskId: string;\n  /**\n   * Server-returned A2A `contextId` / AdCP `context_id` that binds this\n   * response to a server-side conversation. Present when the server surfaced\n   * one; `undefined` otherwise (e.g., fire-and-forget MCP completions).\n   *\n   * Buyers who persist conversation across process restarts should save this\n   * and seed it into `AgentClient.resetContext(id)` on rehydration.\n   */\n  contextId?: string;\n  /**\n   * A2A `taskId` of the server-tracked task for this response. Populated\n   * from A2A Task / Message responses; `undefined` for MCP and for A2A\n   * responses that carry no task binding. Distinct from {@link taskId},\n   * which is the client-minted correlation id.\n   */\n  serverTaskId?: string;\n  taskName: string;\n  agent: { id: string; name: string; protocol: 'mcp' | 'a2a' };\n  /** Total execution time in milliseconds */\n  responseTimeMs: number;\n  /** ISO timestamp of completion */\n  timestamp: string;\n  /** Number of clarification rounds */\n  clarificationRounds: number;\n  /** Final status */\n  status: TaskStatus;\n  /** Input request details (for input-required status) */\n  inputRequest?: InputRequest;\n  /**\n   * Idempotency key used for this request, when the tool is mutating. Auto-\n   * generated by the SDK when the caller doesn't supply one. Surfaced for\n   * logging, correlation, and BYOK flows where the caller persists the key\n   * alongside the resource it creates.\n   */\n  idempotency_key?: string;\n  /**\n   * True when the response was a cached replay from the seller's idempotency\n   * store (i.e., an earlier request with the same key already succeeded).\n   *\n   * Callers with side effects on response — \"campaign created!\" notifications,\n   * LLM memory writes, downstream tool calls — MUST check this flag before\n   * acting, or retries will re-fire side effects.\n   */\n  replayed?: boolean;\n  /**\n   * Seller-served, release-precision AdCP version echoed on the response\n   * envelope. Present when the seller emits `adcp_version` (3.1+). Compare\n   * with the request's wire-normalized version, not a raw full-semver\n   * configuration pin, when detecting same-major downshift.\n   */\n  adcpVersion?: string;\n  /**\n   * Buyer-side product property policy enforcement summary for `get_products`.\n   * Present when the client evaluates a configured product property policy or\n   * enforces the request's `property_list` reference against the response.\n   */\n  productPropertyPolicy?: {\n    mode: ProductPropertyPolicyMode;\n    ok: boolean;\n    accepted_count: number;\n    rejected_count: number;\n    flagged_count: number;\n    message?: string;\n    request_property_list?: {\n      list_id: string;\n      agent_url: string;\n      identifier_count?: number;\n      cache_valid_until?: string;\n      resolution_error?: string;\n    };\n    diagnostics: ProductPropertyPolicyDiagnostic[];\n  };\n  /**\n   * Buyer-side pricing-options enforcement summary for `get_products`. Present\n   * when the client drops one or more products that arrived without a usable\n   * `pricing_options[]` array (a required, non-empty field in AdCP 3.1).\n   */\n  productPricingPolicy?: {\n    ok: boolean;\n    accepted_count: number;\n    rejected_count: number;\n    rejected_products: Array<{ index: number; product_id?: string }>;\n  };\n}\n\n/** Fields shared across all TaskResult variants. */\ninterface TaskResultBase<T = any> {\n  metadata: TaskResultMetadata;\n  /** Governance check result (present when governance is configured) */\n  governance?: import('./GovernanceTypes').GovernanceCheckResult;\n  /** Governance outcome (present after successful execution with governance) */\n  governanceOutcome?: import('./GovernanceTypes').GovernanceOutcome;\n  /** Error message when governance outcome reporting failed */\n  governanceOutcomeError?: string;\n  /** Full conversation history */\n  conversation?: Message[];\n  /** Debug logs (if debug enabled) */\n  debug_logs?: any[];\n  /**\n   * Exhaustive pattern match on the result's `status`. Prefer this method\n   * form — it autocompletes alongside the other `TaskResult` accessors.\n   *\n   * The free function {@link import('./match').match} is also exported for\n   * compositional use (e.g., point-free style or when the result type is\n   * not yet narrowed).\n   *\n   * Attached non-enumerably by the client when the result is returned\n   * from `executeTask`. Results constructed by hand (e.g., in test\n   * fixtures or custom middleware) will not have this method — use the\n   * free function, or call `attachMatch(result)` first.\n   */\n  match?: <R>(handlers: import('./match').MatchHandlers<T, R> | import('./match').PartialMatchHandlers<T, R>) => R;\n}\n\n/** Successful completion — `data` is always present. */\nexport interface TaskResultCompleted<T> extends TaskResultBase<T> {\n  success: true;\n  status: 'completed';\n  data: T;\n  error?: undefined;\n  adcpError?: undefined;\n  errorInstance?: undefined;\n  correlationId?: undefined;\n  deferred?: undefined;\n  submitted?: undefined;\n}\n\n/** Task is still progressing (working, submitted, input-required, deferred). */\nexport interface TaskResultIntermediate<T> extends TaskResultBase<T> {\n  success: true;\n  /**\n   * Task is progressing but not yet final. `'auth-required'` and\n   * `'input-required'` are paused states surfaced by the polling\n   * cycle (`pollTaskCompletion`) — the buyer must satisfy the\n   * paused condition (refresh auth / supply input) and retry the\n   * original tool call. Polling alone won't advance them.\n   */\n  status: 'working' | 'submitted' | 'input-required' | 'auth-required' | 'deferred';\n  data?: T;\n  error?: undefined;\n  adcpError?: undefined;\n  errorInstance?: undefined;\n  correlationId?: undefined;\n  /** Deferred continuation (client needs time for input) */\n  deferred?: DeferredContinuation<T>;\n  /** Submitted continuation (server needs time for processing) */\n  submitted?: SubmittedContinuation<T>;\n}\n\n/** Task failed — `error` is always present. */\nexport interface TaskResultFailure<T> extends TaskResultBase<T> {\n  success: false;\n  status: 'failed' | 'governance-denied';\n  /** Response payload with structured error details (adcp_error, context, ext) */\n  data?: T;\n  /** Human-readable error message */\n  error: string;\n  /** Structured AdCP error (code, recovery, suggestion, retryAfterMs) */\n  adcpError?: AdcpErrorInfo;\n  /**\n   * Typed `ADCPError` subclass instance when the seller's error code has a\n   * dedicated class — currently `IdempotencyConflictError` and\n   * `IdempotencyExpiredError`. Lets callers write\n   * `if (result.errorInstance instanceof IdempotencyConflictError)` instead of\n   * switching on `adcpError.code` strings. Absent for codes without a typed\n   * mapping.\n   */\n  errorInstance?: import('../errors').ADCPError;\n  /** Correlation ID from the error response context, for tracing across agents */\n  correlationId?: string;\n  deferred?: undefined;\n  submitted?: undefined;\n}\n\n/**\n * Result of a task execution.\n *\n * Discriminated union on `success`:\n * - `success: true` + `status: 'completed'` → `data` is `T`\n * - `success: true` + intermediate status → task is progressing, `data` may be partial\n * - `success: false` → `error` is always a string, `adcpError` has structured details\n */\nexport type TaskResult<T = any> = TaskResultCompleted<T> | TaskResultIntermediate<T> | TaskResultFailure<T>;\n\n/**\n * Configuration for conversation management\n */\nexport interface ConversationConfig {\n  /** Maximum messages to keep in history */\n  maxHistorySize?: number;\n  /** Whether to persist conversations */\n  persistConversations?: boolean;\n  /** Timeout for 'working' status (max 120s per PR #78) */\n  workingTimeout?: number;\n  /** Default max clarifications */\n  defaultMaxClarifications?: number;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}