@adcp/sdk 12.0.0 → 12.0.2

package/dist/lib/core/TaskEventTypes.mjs

@@ -1,9 +1,3 @@
-import { fileURLToPath as __adcpFileURLToPath } from 'node:url';
-import { dirname as __adcpDirname } from 'node:path';
-import { createRequire as __adcpCreateRequire } from 'node:module';
-const __filename = __adcpFileURLToPath(import.meta.url);
-const __dirname = __adcpDirname(__filename);
-const require = __adcpCreateRequire(import.meta.url);
 function createOperationId() {
   return `op_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
 }

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/core/TaskEventTypes.ts"],"sourcesContent":["/**\n * Unified event types for task execution tracking\n * All events are emitted with operation_id for grouping multi-agent operations\n */\n\n/**\n * Base event structure - all events share these fields\n *\n * Key identifiers:\n * - operationId + agentId = YOUR unique identifier for this work\n * - contextId = server's conversation identifier (server creates this)\n * - taskId = server's work identifier (server creates this, only for async)\n */\nexport interface BaseTaskEvent {\n  /** Client-generated operation ID - groups related work across multiple agents */\n  operationId: string;\n  /** Agent ID - which agent is handling this */\n  agentId: string;\n  /** Context ID from server - created by agent on first response */\n  contextId?: string;\n  /** Task ID from server - only present for async operations */\n  taskId?: string;\n  /** Task/tool name */\n  taskType: string;\n  /** Event timestamp */\n  timestamp: string;\n}\n\n/**\n * Protocol request event - emitted when request is sent\n */\nexport interface ProtocolRequestEvent extends BaseTaskEvent {\n  eventType: 'protocol_request';\n  protocol: 'a2a' | 'mcp';\n  method: string;\n  payload: {\n    params: Record<string, any>;\n    headers?: Record<string, string>;\n  };\n}\n\n/**\n * Protocol response event - emitted when response is received\n */\nexport interface ProtocolResponseEvent extends BaseTaskEvent {\n  eventType: 'protocol_response';\n  protocol: 'a2a' | 'mcp';\n  method: string;\n  payload: any;\n  /** Response status from server */\n  status: string;\n}\n\n/**\n * Task status update event - emitted on status changes\n */\nexport interface TaskStatusEvent extends BaseTaskEvent {\n  eventType: 'status_update';\n  /** New status */\n  status: 'submitted' | 'working' | 'input-required' | 'completed' | 'failed' | 'rejected' | 'canceled';\n  /** Previous status (if applicable) */\n  previousStatus?: string;\n  /** Result data (for completed) */\n  result?: any;\n  /** Error details (for failed) */\n  error?: string;\n}\n\n/**\n * Object tracking event - for tracking individual objects (creatives, products, etc)\n */\nexport interface ObjectEvent {\n  /** Client-generated operation ID */\n  operationId: string;\n  /** Agent ID */\n  agentId: string;\n  /** Context ID from server (if applicable) */\n  contextId?: string;\n  /** Task ID from server (if applicable) */\n  taskId?: string;\n  /** Type of object */\n  objectType: 'product' | 'creative' | 'media_buy' | 'signal' | string;\n  /** Object identifier */\n  objectId?: string;\n  /** Target entity (agent ID, platform, etc) */\n  targetEntity: string;\n  /** Object status */\n  status: string;\n  /** Object payload/data */\n  payload?: any;\n  /** Event timestamp */\n  timestamp: string;\n}\n\n/**\n * Union type of all task events\n */\nexport type TaskEvent = ProtocolRequestEvent | ProtocolResponseEvent | TaskStatusEvent;\n\n/**\n * Webhook-compatible task status event\n * This is what you'd receive from a webhook AND from the event emitter\n * Covers ALL status changes (submitted, working, completed, etc)\n *\n * Identifiers:\n * - operationId + agentId = YOUR unique key for this work\n * - contextId = server gave you this (store it for reconciliation)\n * - taskId = server gave you this (store it for async tracking)\n */\nexport interface TaskStatusUpdateEvent {\n  /** Client-generated operation ID */\n  operationId: string;\n  /** Agent ID */\n  agentId: string;\n  /** Context ID from server (server creates this on first response) */\n  contextId?: string;\n  /** Task ID from server (only for async operations) */\n  taskId?: string;\n  /** Task type/tool name */\n  taskType: string;\n  /** Current status */\n  status: 'submitted' | 'working' | 'input-required' | 'completed' | 'failed' | 'rejected' | 'canceled';\n  /** Previous status (for tracking transitions) */\n  previousStatus?: string;\n  /** Result data (if completed) */\n  result?: any;\n  /** Error message (if failed) */\n  error?: string;\n  /** Message from server (for working/input-required states) */\n  message?: string;\n  /** Question for user (if input-required) */\n  question?: string;\n  /** Expected input type (if input-required) */\n  expectedInput?: {\n    field?: string;\n    type?: string;\n    suggestions?: any[];\n  };\n  /** Webhook URL (if registered) */\n  webhookUrl?: string;\n  /** Timestamp */\n  timestamp: string;\n}\n\n/**\n * Webhook-compatible task completion event (convenience type for completed/failed)\n * @deprecated Use TaskStatusUpdateEvent instead\n */\nexport type TaskCompletionEvent = TaskStatusUpdateEvent & {\n  status: 'completed' | 'failed' | 'rejected' | 'canceled';\n};\n\n/**\n * Event listener callback signatures\n * For OBSERVABILITY only - not for control flow!\n * Use these to log, record, or update UI - NOT to handle responses\n */\nexport interface TaskEventCallbacks {\n  /**\n   * Called for protocol requests (when request is sent to agent)\n   * Use for: logging, UI updates, recording to database\n   */\n  onProtocolRequest?: (event: ProtocolRequestEvent) => void;\n\n  /**\n   * Called for protocol responses (when response received from agent)\n   * Use for: logging, UI updates, recording to database\n   */\n  onProtocolResponse?: (event: ProtocolResponseEvent) => void;\n\n  /**\n   * Called for ALL status changes (submitted, working, completed, etc)\n   * Use for: progress tracking, UI updates, event recording\n   * NOTE: This fires during synchronous execution - don't block!\n   */\n  onStatusChange?: (event: TaskStatusUpdateEvent) => void;\n\n  /**\n   * Called for object events (products received, creatives synced, etc)\n   * Use for: tracking granular object status\n   */\n  onObjectEvent?: (event: ObjectEvent) => void;\n}\n\n/**\n * Helper to create operation ID\n * Used to group related work across multiple agents\n * Example: \"Sync 5 creatives to 3 agents\" = 1 operation ID\n */\nexport function createOperationId(): string {\n  return `op_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n}\n\n/**\n * Server identifier tracking (DEPRECATED - use webhook URL path instead)\n *\n * Previously needed to map server IDs back to operation_id.\n * Now superseded by encoding operation_id in webhook URL:\n * /webhook/{agent_id}/{operation_id}\n *\n * @deprecated Use webhook URL path parameters instead\n */\nexport class ServerIdentifierMapper {\n  private contextToKey = new Map<string, { operationId: string; agentId: string }>();\n  private taskToKey = new Map<string, { operationId: string; agentId: string }>();\n\n  /**\n   * Register server identifiers when you get them from first response\n   */\n  register(operationId: string, agentId: string, contextId?: string, taskId?: string): void {\n    const key = { operationId, agentId };\n\n    if (contextId) {\n      this.contextToKey.set(contextId, key);\n    }\n    if (taskId) {\n      this.taskToKey.set(taskId, key);\n    }\n  }\n\n  /**\n   * Look up your operation+agent from webhook context_id\n   */\n  lookupByContext(contextId: string): { operationId: string; agentId: string } | undefined {\n    return this.contextToKey.get(contextId);\n  }\n\n  /**\n   * Look up your operation+agent from webhook task_id\n   */\n  lookupByTask(taskId: string): { operationId: string; agentId: string } | undefined {\n    return this.taskToKey.get(taskId);\n  }\n\n  /**\n   * Clean up completed operation\n   */\n  remove(operationId: string, agentId: string): void {\n    // Remove all mappings for this operation+agent\n    for (const [contextId, key] of this.contextToKey) {\n      if (key.operationId === operationId && key.agentId === agentId) {\n        this.contextToKey.delete(contextId);\n      }\n    }\n    for (const [taskId, key] of this.taskToKey) {\n      if (key.operationId === operationId && key.agentId === agentId) {\n        this.taskToKey.delete(taskId);\n      }\n    }\n  }\n\n  /**\n   * Get statistics\n   */\n  getStats(): {\n    totalContexts: number;\n    totalTasks: number;\n  } {\n    return {\n      totalContexts: this.contextToKey.size,\n      totalTasks: this.taskToKey.size,\n    };\n  }\n}\n"],"mappings":";;;;;;AA6LO,SAAS,oBAA4B;AAC1C,SAAO,MAAM,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,GAAG,CAAC,CAAC;AACpE;AAWO,MAAM,uBAAuB;AAAA,EAC1B,eAAe,oBAAI,IAAsD;AAAA,EACzE,YAAY,oBAAI,IAAsD;AAAA;AAAA;AAAA;AAAA,EAK9E,SAAS,aAAqB,SAAiB,WAAoB,QAAuB;AACxF,UAAM,MAAM,EAAE,aAAa,QAAQ;AAEnC,QAAI,WAAW;AACb,WAAK,aAAa,IAAI,WAAW,GAAG;AAAA,IACtC;AACA,QAAI,QAAQ;AACV,WAAK,UAAU,IAAI,QAAQ,GAAG;AAAA,IAChC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,WAAyE;AACvF,WAAO,KAAK,aAAa,IAAI,SAAS;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,QAAsE;AACjF,WAAO,KAAK,UAAU,IAAI,MAAM;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,aAAqB,SAAuB;AAEjD,eAAW,CAAC,WAAW,GAAG,KAAK,KAAK,cAAc;AAChD,UAAI,IAAI,gBAAgB,eAAe,IAAI,YAAY,SAAS;AAC9D,aAAK,aAAa,OAAO,SAAS;AAAA,MACpC;AAAA,IACF;AACA,eAAW,CAAC,QAAQ,GAAG,KAAK,KAAK,WAAW;AAC1C,UAAI,IAAI,gBAAgB,eAAe,IAAI,YAAY,SAAS;AAC9D,aAAK,UAAU,OAAO,MAAM;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,WAGE;AACA,WAAO;AAAA,MACL,eAAe,KAAK,aAAa;AAAA,MACjC,YAAY,KAAK,UAAU;AAAA,IAC7B;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../src/lib/core/TaskEventTypes.ts"],"sourcesContent":["/**\n * Unified event types for task execution tracking\n * All events are emitted with operation_id for grouping multi-agent operations\n */\n\n/**\n * Base event structure - all events share these fields\n *\n * Key identifiers:\n * - operationId + agentId = YOUR unique identifier for this work\n * - contextId = server's conversation identifier (server creates this)\n * - taskId = server's work identifier (server creates this, only for async)\n */\nexport interface BaseTaskEvent {\n  /** Client-generated operation ID - groups related work across multiple agents */\n  operationId: string;\n  /** Agent ID - which agent is handling this */\n  agentId: string;\n  /** Context ID from server - created by agent on first response */\n  contextId?: string;\n  /** Task ID from server - only present for async operations */\n  taskId?: string;\n  /** Task/tool name */\n  taskType: string;\n  /** Event timestamp */\n  timestamp: string;\n}\n\n/**\n * Protocol request event - emitted when request is sent\n */\nexport interface ProtocolRequestEvent extends BaseTaskEvent {\n  eventType: 'protocol_request';\n  protocol: 'a2a' | 'mcp';\n  method: string;\n  payload: {\n    params: Record<string, any>;\n    headers?: Record<string, string>;\n  };\n}\n\n/**\n * Protocol response event - emitted when response is received\n */\nexport interface ProtocolResponseEvent extends BaseTaskEvent {\n  eventType: 'protocol_response';\n  protocol: 'a2a' | 'mcp';\n  method: string;\n  payload: any;\n  /** Response status from server */\n  status: string;\n}\n\n/**\n * Task status update event - emitted on status changes\n */\nexport interface TaskStatusEvent extends BaseTaskEvent {\n  eventType: 'status_update';\n  /** New status */\n  status: 'submitted' | 'working' | 'input-required' | 'completed' | 'failed' | 'rejected' | 'canceled';\n  /** Previous status (if applicable) */\n  previousStatus?: string;\n  /** Result data (for completed) */\n  result?: any;\n  /** Error details (for failed) */\n  error?: string;\n}\n\n/**\n * Object tracking event - for tracking individual objects (creatives, products, etc)\n */\nexport interface ObjectEvent {\n  /** Client-generated operation ID */\n  operationId: string;\n  /** Agent ID */\n  agentId: string;\n  /** Context ID from server (if applicable) */\n  contextId?: string;\n  /** Task ID from server (if applicable) */\n  taskId?: string;\n  /** Type of object */\n  objectType: 'product' | 'creative' | 'media_buy' | 'signal' | string;\n  /** Object identifier */\n  objectId?: string;\n  /** Target entity (agent ID, platform, etc) */\n  targetEntity: string;\n  /** Object status */\n  status: string;\n  /** Object payload/data */\n  payload?: any;\n  /** Event timestamp */\n  timestamp: string;\n}\n\n/**\n * Union type of all task events\n */\nexport type TaskEvent = ProtocolRequestEvent | ProtocolResponseEvent | TaskStatusEvent;\n\n/**\n * Webhook-compatible task status event\n * This is what you'd receive from a webhook AND from the event emitter\n * Covers ALL status changes (submitted, working, completed, etc)\n *\n * Identifiers:\n * - operationId + agentId = YOUR unique key for this work\n * - contextId = server gave you this (store it for reconciliation)\n * - taskId = server gave you this (store it for async tracking)\n */\nexport interface TaskStatusUpdateEvent {\n  /** Client-generated operation ID */\n  operationId: string;\n  /** Agent ID */\n  agentId: string;\n  /** Context ID from server (server creates this on first response) */\n  contextId?: string;\n  /** Task ID from server (only for async operations) */\n  taskId?: string;\n  /** Task type/tool name */\n  taskType: string;\n  /** Current status */\n  status: 'submitted' | 'working' | 'input-required' | 'completed' | 'failed' | 'rejected' | 'canceled';\n  /** Previous status (for tracking transitions) */\n  previousStatus?: string;\n  /** Result data (if completed) */\n  result?: any;\n  /** Error message (if failed) */\n  error?: string;\n  /** Message from server (for working/input-required states) */\n  message?: string;\n  /** Question for user (if input-required) */\n  question?: string;\n  /** Expected input type (if input-required) */\n  expectedInput?: {\n    field?: string;\n    type?: string;\n    suggestions?: any[];\n  };\n  /** Webhook URL (if registered) */\n  webhookUrl?: string;\n  /** Timestamp */\n  timestamp: string;\n}\n\n/**\n * Webhook-compatible task completion event (convenience type for completed/failed)\n * @deprecated Use TaskStatusUpdateEvent instead\n */\nexport type TaskCompletionEvent = TaskStatusUpdateEvent & {\n  status: 'completed' | 'failed' | 'rejected' | 'canceled';\n};\n\n/**\n * Event listener callback signatures\n * For OBSERVABILITY only - not for control flow!\n * Use these to log, record, or update UI - NOT to handle responses\n */\nexport interface TaskEventCallbacks {\n  /**\n   * Called for protocol requests (when request is sent to agent)\n   * Use for: logging, UI updates, recording to database\n   */\n  onProtocolRequest?: (event: ProtocolRequestEvent) => void;\n\n  /**\n   * Called for protocol responses (when response received from agent)\n   * Use for: logging, UI updates, recording to database\n   */\n  onProtocolResponse?: (event: ProtocolResponseEvent) => void;\n\n  /**\n   * Called for ALL status changes (submitted, working, completed, etc)\n   * Use for: progress tracking, UI updates, event recording\n   * NOTE: This fires during synchronous execution - don't block!\n   */\n  onStatusChange?: (event: TaskStatusUpdateEvent) => void;\n\n  /**\n   * Called for object events (products received, creatives synced, etc)\n   * Use for: tracking granular object status\n   */\n  onObjectEvent?: (event: ObjectEvent) => void;\n}\n\n/**\n * Helper to create operation ID\n * Used to group related work across multiple agents\n * Example: \"Sync 5 creatives to 3 agents\" = 1 operation ID\n */\nexport function createOperationId(): string {\n  return `op_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n}\n\n/**\n * Server identifier tracking (DEPRECATED - use webhook URL path instead)\n *\n * Previously needed to map server IDs back to operation_id.\n * Now superseded by encoding operation_id in webhook URL:\n * /webhook/{agent_id}/{operation_id}\n *\n * @deprecated Use webhook URL path parameters instead\n */\nexport class ServerIdentifierMapper {\n  private contextToKey = new Map<string, { operationId: string; agentId: string }>();\n  private taskToKey = new Map<string, { operationId: string; agentId: string }>();\n\n  /**\n   * Register server identifiers when you get them from first response\n   */\n  register(operationId: string, agentId: string, contextId?: string, taskId?: string): void {\n    const key = { operationId, agentId };\n\n    if (contextId) {\n      this.contextToKey.set(contextId, key);\n    }\n    if (taskId) {\n      this.taskToKey.set(taskId, key);\n    }\n  }\n\n  /**\n   * Look up your operation+agent from webhook context_id\n   */\n  lookupByContext(contextId: string): { operationId: string; agentId: string } | undefined {\n    return this.contextToKey.get(contextId);\n  }\n\n  /**\n   * Look up your operation+agent from webhook task_id\n   */\n  lookupByTask(taskId: string): { operationId: string; agentId: string } | undefined {\n    return this.taskToKey.get(taskId);\n  }\n\n  /**\n   * Clean up completed operation\n   */\n  remove(operationId: string, agentId: string): void {\n    // Remove all mappings for this operation+agent\n    for (const [contextId, key] of this.contextToKey) {\n      if (key.operationId === operationId && key.agentId === agentId) {\n        this.contextToKey.delete(contextId);\n      }\n    }\n    for (const [taskId, key] of this.taskToKey) {\n      if (key.operationId === operationId && key.agentId === agentId) {\n        this.taskToKey.delete(taskId);\n      }\n    }\n  }\n\n  /**\n   * Get statistics\n   */\n  getStats(): {\n    totalContexts: number;\n    totalTasks: number;\n  } {\n    return {\n      totalContexts: this.contextToKey.size,\n      totalTasks: this.taskToKey.size,\n    };\n  }\n}\n"],"mappings":"AA6LO,SAAS,oBAA4B;AAC1C,SAAO,MAAM,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,GAAG,CAAC,CAAC;AACpE;AAWO,MAAM,uBAAuB;AAAA,EAC1B,eAAe,oBAAI,IAAsD;AAAA,EACzE,YAAY,oBAAI,IAAsD;AAAA;AAAA;AAAA;AAAA,EAK9E,SAAS,aAAqB,SAAiB,WAAoB,QAAuB;AACxF,UAAM,MAAM,EAAE,aAAa,QAAQ;AAEnC,QAAI,WAAW;AACb,WAAK,aAAa,IAAI,WAAW,GAAG;AAAA,IACtC;AACA,QAAI,QAAQ;AACV,WAAK,UAAU,IAAI,QAAQ,GAAG;AAAA,IAChC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,WAAyE;AACvF,WAAO,KAAK,aAAa,IAAI,SAAS;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,QAAsE;AACjF,WAAO,KAAK,UAAU,IAAI,MAAM;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,aAAqB,SAAuB;AAEjD,eAAW,CAAC,WAAW,GAAG,KAAK,KAAK,cAAc;AAChD,UAAI,IAAI,gBAAgB,eAAe,IAAI,YAAY,SAAS;AAC9D,aAAK,aAAa,OAAO,SAAS;AAAA,MACpC;AAAA,IACF;AACA,eAAW,CAAC,QAAQ,GAAG,KAAK,KAAK,WAAW;AAC1C,UAAI,IAAI,gBAAgB,eAAe,IAAI,YAAY,SAAS;AAC9D,aAAK,UAAU,OAAO,MAAM;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,WAGE;AACA,WAAO;AAAA,MACL,eAAe,KAAK,aAAa;AAAA,MACjC,YAAY,KAAK,UAAU;AAAA,IAC7B;AAAA,EACF;AACF;","names":[]}

package/dist/lib/core/TaskExecutor.mjs

@@ -1,9 +1,3 @@
-import { fileURLToPath as __adcpFileURLToPath } from 'node:url';
-import { dirname as __adcpDirname } from 'node:path';
-import { createRequire as __adcpCreateRequire } from 'node:module';
-const __filename = __adcpFileURLToPath(import.meta.url);
-const __dirname = __adcpDirname(__filename);
-const require = __adcpCreateRequire(import.meta.url);
 import { randomUUID } from "crypto";
 import { ProtocolClient } from "../protocols/index.mjs";
 import { listMCPTasks } from "../protocols/mcp-tasks.mjs";