@adcp/sdk 16.0.0 → 16.2.0

package/README.md

@@ -204,6 +204,58 @@ if (result.status === 'submitted') {
 }
 ```
 
+### Tracking a seller task after a restart
+
+Persist `result.metadata.serverTaskId`, the original tool name, and
+`result.metadata.taskId` (the buyer's operation ID) when a seller returns
+`submitted` or `working`. A new client can reconstruct the polling handle:
+
+```typescript
+const tracked = await agent.trackTask({
+  taskId: saved.serverTaskId,
+  taskType: saved.taskType,
+  operationId: saved.operationId,
+});
+
+const status = await tracked.track(); // One status check
+const completed = await tracked.waitForCompletion(1000, AbortSignal.timeout(60_000));
+```
+
+Each poll uses AdCP `tasks_get` (MCP) or `tasks/get` (A2A) with
+`{ task_id, include_result: true }`. Polls do not create separate
+`protocol_request` / `protocol_response` activity records. Terminal
+`status_change` activity carries the stable `operation_id` and the seller's
+`server_task_id`; existing `task_id` fields retain their current meaning.
+`TaskInfo` from the handle also carries `operationId` and `serverTaskId`.
+The SDK checks the returned task ID and tool name before exposing a result.
+
+Omitting `operationId` generates a UUID, available as `tracked.operationId`.
+Reuse the handle within a client, or call `trackTask` again with the same
+operation ID, seller task ID, and tool name to rebuild it. You can pin the ID before submitting work
+with `TaskOptions.operationId`, for example
+`agent.executeCustomTask('extension_task', params, undefined, { operationId })`.
+Use a globally unique, opaque operation ID per dispatch (UUID recommended),
+including across clients and tenants sharing persistence or webhook receivers.
+Reuse it for tracking. To retry a dispatch after a crash, use a new operation ID
+and the same `idempotency_key`. Operation IDs correlate observations;
+`idempotency_key` provides retry safety. The SDK rejects local collisions;
+uniqueness across processes is the caller's responsibility. Avoid sensitive
+information in these IDs because webhook registration sends them to the seller.
+They accept 1–255 letters, digits, underscores, periods, colons, or hyphens.
+Dot-only IDs and the `delivery_route:` prefix are reserved.
+
+Tracking returns the seller's original tool response shape and emits lifecycle
+activity. It does not restore the original request's policy/projection context
+or invoke inline tool completion handlers. Handle the returned result in the
+caller. Pass `transport` or `signal` in the tracking request to configure the
+polling lifetime; `track(transport)` overrides transport options for one poll.
+Local cancellation, identity mismatches, missing tasks, and malformed poll
+responses return or throw observation errors without publishing seller failure
+events. Rebuild the handle with a fresh signal to resume after cancellation.
+For A2A, stopping observation leaves seller work running by default. Set both
+`cancelOnAbort: true` and `a2aTaskId` to request cancellation of seller work
+when polling aborts; `a2aTaskId` must be the separate A2A transport task ID.
+
 ### Handling Clarifications (input-required)
 
 When an agent needs more information, you can continue the conversation:

package/bin/adcp-identity.js

@@ -4,7 +4,7 @@ const { parseStrictJson } = require('../dist/lib/signing/agent-resolver/strict-j
 const {
   createSignedSignatureDirectory,
   createSignedOriginRevocationList,
-  validateTrustRecord,
+  assertPublishableTrustRecord,
 } = require('../dist/lib/identity-3.3/index.js');
 
 async function handleIdentityCommand(args) {
@@ -17,7 +17,8 @@ async function handleIdentityCommand(args) {
     if (!args[1]) throw new Error('Usage: adcp identity trust-validate trust.json');
     const bytes = readFileSync(args[1]);
     if (bytes.length > 2 * 1024 * 1024) throw new Error('trust.json exceeds 2 MiB');
-    validateTrustRecord(parseStrictJson(new TextDecoder('utf-8', { fatal: true }).decode(bytes), 32));
+    // Publication rules, not only the schema: a non-registrable grantee grants nothing.
+    assertPublishableTrustRecord(parseStrictJson(new TextDecoder('utf-8', { fatal: true }).decode(bytes), 32));
     process.stdout.write('Valid experimental trust v1 record\n');
     return;
   }

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

@@ -4,7 +4,7 @@ export { ADCPMultiAgentClient, createADCPMultiAgentClient, type MultiAgentWebhoo
 export { CreativeAgentClient, createCreativeAgentClient, STANDARD_CREATIVE_AGENTS, type CreativeAgentClientConfig, type CreativeAgentListTaskOptions, type LegacyCreativeFormat, } from '../core/CreativeAgentClient.mjs';
 export { ConfigurationManager } from '../core/ConfigurationManager.mjs';
 export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStoreOptions, type WebhookAuthenticationMode, type WebhookRegistration, type WebhookRegistrationStore, } from '../core/webhook-registration.mjs';
-export type { ConversationConfig, ConversationContext, InputHandler, InputHandlerResponse, InputRequest, Message, TaskInfo, TaskOptions, TaskResult, TaskResultCompleted, TaskResultFailure, TaskResultIntermediate, TaskResultMetadata, } from '../core/ConversationTypes.mjs';
+export type { ConversationConfig, ConversationContext, InputHandler, InputHandlerResponse, InputRequest, Message, TaskInfo, TaskOptions, TrackTaskRequest, TrackedTask, SubmittedContinuation, TaskResult, TaskResultCompleted, TaskResultFailure, TaskResultIntermediate, TaskResultMetadata, } from '../core/ConversationTypes.mjs';
 export type { AgentConfig } from '../types/adcp.mjs';
 export type { ResolveAccountOptions, ResolveAccountResult, ListedAccount } from '../core/account-resolution.mjs';
 export type { CreativeFormatWireMode } from '../v2/projection/creative-delivery.mjs';

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

@@ -4,7 +4,7 @@ export { ADCPMultiAgentClient, createADCPMultiAgentClient, type MultiAgentWebhoo
 export { CreativeAgentClient, createCreativeAgentClient, STANDARD_CREATIVE_AGENTS, type CreativeAgentClientConfig, type CreativeAgentListTaskOptions, type LegacyCreativeFormat, } from '../core/CreativeAgentClient';
 export { ConfigurationManager } from '../core/ConfigurationManager';
 export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStoreOptions, type WebhookAuthenticationMode, type WebhookRegistration, type WebhookRegistrationStore, } from '../core/webhook-registration';
-export type { ConversationConfig, ConversationContext, InputHandler, InputHandlerResponse, InputRequest, Message, TaskInfo, TaskOptions, TaskResult, TaskResultCompleted, TaskResultFailure, TaskResultIntermediate, TaskResultMetadata, } from '../core/ConversationTypes';
+export type { ConversationConfig, ConversationContext, InputHandler, InputHandlerResponse, InputRequest, Message, TaskInfo, TaskOptions, TrackTaskRequest, TrackedTask, SubmittedContinuation, TaskResult, TaskResultCompleted, TaskResultFailure, TaskResultIntermediate, TaskResultMetadata, } from '../core/ConversationTypes';
 export type { AgentConfig } from '../types/adcp';
 export type { ResolveAccountOptions, ResolveAccountResult, ListedAccount } from '../core/account-resolution';
 export type { CreativeFormatWireMode } from '../v2/projection/creative-delivery';

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

@@ -4,7 +4,7 @@ import type { ResolveAccountOptions, ResolveAccountResult } from './account-reso
 import type { MCPWebhookPayload, GetBrandIdentityRequest, GetBrandIdentityResponse, ContextMatchRequest, ContextMatchResponse, IdentityMatchRequest, IdentityMatchResponseRouterPublisher } from '../types/core.generated.mjs';
 import type { Task as A2ATask, TaskStatusUpdateEvent } from '@a2a-js/sdk';
 import { type CapabilityEvidenceScope, type CapabilityEvidenceSnapshot, type CanonicalReadTaskOptions, type CreativeDeliveryTaskOptions, type SingleAgentClientConfig, type SyncCreativesTaskOptions, type VerifyAndParseWebhookOptions, type WebhookHandlerAdapter, type WebhookParseResult, type WebhookRequestContext } from './SingleAgentClient.mjs';
-import type { InputHandler, TaskOptions, TaskResult, TaskInfo, Message, DirectPauseRecoveryRequest } from './ConversationTypes.mjs';
+import type { InputHandler, TaskOptions, TaskResult, TaskInfo, Message, DirectPauseRecoveryRequest, TrackTaskRequest, TrackedTask } from './ConversationTypes.mjs';
 import type { AdcpCapabilities } from '../utils/capabilities.mjs';
 import type { WebhookHeaderValue } from '../webhooks/index.mjs';
 import type { ListProductsResponseWithSupplyPath } from '../supply-path/index.mjs';
@@ -794,6 +794,13 @@ export declare class AgentClient {
      * Get active tasks for this agent
      */
     getActiveTasks(): import("./ConversationTypes.mjs").TaskState[];
+    /**
+     * Rebuild a polling handle for a persisted seller task. Reuse operationId
+     * from the original TaskResult.metadata.taskId to correlate its lifecycle.
+     * The handle provides track() and waitForCompletion(); polling itself does
+     * not create new protocol activity records. Results retain seller tool shapes.
+     */
+    trackTask<T = unknown>(request: TrackTaskRequest): Promise<TrackedTask<T>>;
     /**
      * Execute any ADCP task by name with full type safety
      *

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

@@ -4,7 +4,7 @@ import type { ResolveAccountOptions, ResolveAccountResult } from './account-reso
 import type { MCPWebhookPayload, GetBrandIdentityRequest, GetBrandIdentityResponse, ContextMatchRequest, ContextMatchResponse, IdentityMatchRequest, IdentityMatchResponseRouterPublisher } from '../types/core.generated';
 import type { Task as A2ATask, TaskStatusUpdateEvent } from '@a2a-js/sdk';
 import { type CapabilityEvidenceScope, type CapabilityEvidenceSnapshot, type CanonicalReadTaskOptions, type CreativeDeliveryTaskOptions, type SingleAgentClientConfig, type SyncCreativesTaskOptions, type VerifyAndParseWebhookOptions, type WebhookHandlerAdapter, type WebhookParseResult, type WebhookRequestContext } from './SingleAgentClient';
-import type { InputHandler, TaskOptions, TaskResult, TaskInfo, Message, DirectPauseRecoveryRequest } from './ConversationTypes';
+import type { InputHandler, TaskOptions, TaskResult, TaskInfo, Message, DirectPauseRecoveryRequest, TrackTaskRequest, TrackedTask } from './ConversationTypes';
 import type { AdcpCapabilities } from '../utils/capabilities';
 import type { WebhookHeaderValue } from '../webhooks';
 import type { ListProductsResponseWithSupplyPath } from '../supply-path';
@@ -794,6 +794,13 @@ export declare class AgentClient {
      * Get active tasks for this agent
      */
     getActiveTasks(): import("./ConversationTypes").TaskState[];
+    /**
+     * Rebuild a polling handle for a persisted seller task. Reuse operationId
+     * from the original TaskResult.metadata.taskId to correlate its lifecycle.
+     * The handle provides track() and waitForCompletion(); polling itself does
+     * not create new protocol activity records. Results retain seller tool shapes.
+     */
+    trackTask<T = unknown>(request: TrackTaskRequest): Promise<TrackedTask<T>>;
     /**
      * Execute any ADCP task by name with full type safety
      *

package/dist/lib/core/AgentClient.js

@@ -1254,6 +1254,16 @@ class AgentClient {
   getActiveTasks() {
     return this.client.getActiveTasks().map(import_request_proposals_guard.assertNativeRequestProposalsTask);
   }
+  // ====== GENERIC TASK EXECUTION ======
+  /**
+   * Rebuild a polling handle for a persisted seller task. Reuse operationId
+   * from the original TaskResult.metadata.taskId to correlate its lifecycle.
+   * The handle provides track() and waitForCompletion(); polling itself does
+   * not create new protocol activity records. Results retain seller tool shapes.
+   */
+  trackTask(request) {
+    return this.client.trackTask(request);
+  }
   async executeTask(taskName, params, inputHandler, options) {
     switch (taskName) {
       case "get_products":

package/dist/lib/core/AgentClient.mjs

@@ -1222,6 +1222,16 @@ class AgentClient {
   getActiveTasks() {
     return this.client.getActiveTasks().map(assertNativeRequestProposalsTask);
   }
+  // ====== GENERIC TASK EXECUTION ======
+  /**
+   * Rebuild a polling handle for a persisted seller task. Reuse operationId
+   * from the original TaskResult.metadata.taskId to correlate its lifecycle.
+   * The handle provides track() and waitForCompletion(); polling itself does
+   * not create new protocol activity records. Results retain seller tool shapes.
+   */
+  trackTask(request) {
+    return this.client.trackTask(request);
+  }
   async executeTask(taskName, params, inputHandler, options) {
     switch (taskName) {
       case "get_products":

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

@@ -118,6 +118,8 @@ export interface Activity {
     agent_id: string;
     context_id?: string;
     task_id?: string;
+    /** Seller's AdCP work handle; operation_id remains the runner correlation id. */
+    server_task_id?: string;
     task_type: string;
     status?: string;
     /**

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

@@ -118,6 +118,8 @@ export interface Activity {
     agent_id: string;
     context_id?: string;
     task_id?: string;
+    /** Seller's AdCP work handle; operation_id remains the runner correlation id. */
+    server_task_id?: string;
     task_type: string;
     status?: string;
     /**

package/dist/lib/core/AsyncHandler.js

@@ -403,7 +403,7 @@ class AsyncHandler {
    * Emit activity event
    */
   async emitActivity(activity) {
-    await this.config.onActivity?.(activity);
+    await this.config.onActivity?.({ ...activity, server_task_id: activity.server_task_id ?? activity.task_id });
   }
   /**
    * Claim the webhook for processing. A failed dispatch rolls this claim

package/dist/lib/core/AsyncHandler.mjs

@@ -376,7 +376,7 @@ class AsyncHandler {
    * Emit activity event
    */
   async emitActivity(activity) {
-    await this.config.onActivity?.(activity);
+    await this.config.onActivity?.({ ...activity, server_task_id: activity.server_task_id ?? activity.task_id });
   }
   /**
    * Claim the webhook for processing. A failed dispatch rolls this claim

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

@@ -121,6 +121,16 @@ export type WebhookUrlTemplate = string | {
  * Options for task execution
  */
 export interface TaskOptions {
+    /**
+     * Caller-supplied operation correlation id. Defaults to a generated UUID.
+     * Persist it with metadata.serverTaskId to resume tracking after a restart.
+     * Use a globally unique opaque id per dispatch (UUID recommended), including
+     * across tenants sharing persistence or webhook receivers. Reuse it for tracking,
+     * not resubmission; retry dispatches use a new id and the same idempotency_key.
+     * Accepts 1–255 letters, digits, underscores, periods, colons, or hyphens.
+     * Dot-only IDs and the delivery_route: prefix are reserved.
+     */
+    operationId?: string;
     /**
      * Skip inline completion status handlers for this call and its continuations.
      * Defaults to false. Independently delivered webhook handlers are unaffected.
@@ -202,6 +212,8 @@ export interface TaskOptions {
 export interface TaskState {
     /** Unique task identifier */
     taskId: string;
+    /** Seller work handle, distinct from the local operation id. */
+    serverTaskId?: string;
     /** Task name (tool name) */
     taskName: string;
     /**
@@ -247,6 +259,10 @@ export interface TaskState {
 export interface TaskInfo {
     /** Task ID */
     taskId: string;
+    /** Local operation id when observed through an SDK continuation or lifecycle event. */
+    operationId?: string;
+    /** Seller work handle when known. Existing taskId semantics are preserved. */
+    serverTaskId?: string;
     /** Current status */
     status: string;
     /** Task type/name */
@@ -292,6 +308,22 @@ export interface DirectPauseRecoveryRequest {
     recoveryKey: string;
     ownerScope: string;
 }
+/** Persisted seller work to observe without submitting a new task. */
+export interface TrackTaskRequest extends Pick<TaskOptions, 'operationId' | 'transport' | 'signal'> {
+    /** Seller's AdCP task_id (TaskResult.metadata.serverTaskId). */
+    taskId: string;
+    /** Original tool name, used to verify the seller's task identity. */
+    taskType: string;
+    /** Actual A2A transport Task.id, if known. Distinct from the AdCP taskId. */
+    a2aTaskId?: string;
+    /** Request cancellation of seller work on polling abort. Requires a2aTaskId; defaults to false. */
+    cancelOnAbort?: boolean;
+}
+/** Polling handle for persisted seller work. */
+export interface TrackedTask<T = unknown> extends SubmittedContinuation<T> {
+    /** Stable runner operation id. Save this when the SDK generates it. */
+    operationId: string;
+}
 /**
  * Continuation for submitted server tasks (server needs time).
  *

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

@@ -121,6 +121,16 @@ export type WebhookUrlTemplate = string | {
  * Options for task execution
  */
 export interface TaskOptions {
+    /**
+     * Caller-supplied operation correlation id. Defaults to a generated UUID.
+     * Persist it with metadata.serverTaskId to resume tracking after a restart.
+     * Use a globally unique opaque id per dispatch (UUID recommended), including
+     * across tenants sharing persistence or webhook receivers. Reuse it for tracking,
+     * not resubmission; retry dispatches use a new id and the same idempotency_key.
+     * Accepts 1–255 letters, digits, underscores, periods, colons, or hyphens.
+     * Dot-only IDs and the delivery_route: prefix are reserved.
+     */
+    operationId?: string;
     /**
      * Skip inline completion status handlers for this call and its continuations.
      * Defaults to false. Independently delivered webhook handlers are unaffected.
@@ -202,6 +212,8 @@ export interface TaskOptions {
 export interface TaskState {
     /** Unique task identifier */
     taskId: string;
+    /** Seller work handle, distinct from the local operation id. */
+    serverTaskId?: string;
     /** Task name (tool name) */
     taskName: string;
     /**
@@ -247,6 +259,10 @@ export interface TaskState {
 export interface TaskInfo {
     /** Task ID */
     taskId: string;
+    /** Local operation id when observed through an SDK continuation or lifecycle event. */
+    operationId?: string;
+    /** Seller work handle when known. Existing taskId semantics are preserved. */
+    serverTaskId?: string;
     /** Current status */
     status: string;
     /** Task type/name */
@@ -292,6 +308,22 @@ export interface DirectPauseRecoveryRequest {
     recoveryKey: string;
     ownerScope: string;
 }
+/** Persisted seller work to observe without submitting a new task. */
+export interface TrackTaskRequest extends Pick<TaskOptions, 'operationId' | 'transport' | 'signal'> {
+    /** Seller's AdCP task_id (TaskResult.metadata.serverTaskId). */
+    taskId: string;
+    /** Original tool name, used to verify the seller's task identity. */
+    taskType: string;
+    /** Actual A2A transport Task.id, if known. Distinct from the AdCP taskId. */
+    a2aTaskId?: string;
+    /** Request cancellation of seller work on polling abort. Requires a2aTaskId; defaults to false. */
+    cancelOnAbort?: boolean;
+}
+/** Polling handle for persisted seller work. */
+export interface TrackedTask<T = unknown> extends SubmittedContinuation<T> {
+    /** Stable runner operation id. Save this when the SDK generates it. */
+    operationId: string;
+}
 /**
  * Continuation for submitted server tasks (server needs time).
  *

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

@@ -6,7 +6,7 @@ import { type MutatingRequestInput } from '../utils/idempotency.mjs';
 import type { MCPWebhookPayload, TaskStatus } from '../types/core.generated.mjs';
 type A2ATask = Record<string, any>;
 type TaskStatusUpdateEvent = Record<string, any>;
-import type { InputHandler, Message, TaskOptions, TaskResult, ConversationConfig, TaskInfo, TaskState, WebhookUrlTemplate, DirectPauseRecoveryRequest } from './ConversationTypes.mjs';
+import type { InputHandler, Message, TaskOptions, TaskResult, ConversationConfig, TaskInfo, TaskState, WebhookUrlTemplate, DirectPauseRecoveryRequest, TrackTaskRequest, TrackedTask } from './ConversationTypes.mjs';
 import type { AdcpTaskName, TaskRequestFor, TaskResponseTypeMap } from './AgentClient.mjs';
 import type { DeferredTaskStorage } from '../storage/interfaces.mjs';
 import type { Activity, AsyncHandlerConfig, WebhookMetadata } from './AsyncHandler.mjs';
@@ -638,6 +638,16 @@ export declare class SingleAgentClient {
      * version. Wire-shape adapters key off this method in subsequent stages.
      */
     getAdcpVersion(): string;
+    /**
+     * Observe a persisted seller task using the continuation polling path.
+     * Does not submit work or emit protocol_request/protocol_response activity
+     * for each poll. Terminal status_change activity carries operation_id and
+     * server_task_id. Results use the seller's original tool response shape.
+     * Persist the returned operationId if none was supplied. Polling handles
+     * are local to this client; matching identities can reattach to existing work.
+     * Local observation failures do not publish seller terminal lifecycle events.
+     */
+    trackTask<T = unknown>(request: TrackTaskRequest): Promise<TrackedTask<T>>;
     /** Recover the current generation of an opt-in direct mutation pause. */
     recoverDirectPauseContinuation<T>(request: DirectPauseRecoveryRequest): Promise<TaskResult<T>>;
     private recoverDurableSettlement;

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

@@ -6,7 +6,7 @@ import { type MutatingRequestInput } from '../utils/idempotency';
 import type { MCPWebhookPayload, TaskStatus } from '../types/core.generated';
 type A2ATask = Record<string, any>;
 type TaskStatusUpdateEvent = Record<string, any>;
-import type { InputHandler, Message, TaskOptions, TaskResult, ConversationConfig, TaskInfo, TaskState, WebhookUrlTemplate, DirectPauseRecoveryRequest } from './ConversationTypes';
+import type { InputHandler, Message, TaskOptions, TaskResult, ConversationConfig, TaskInfo, TaskState, WebhookUrlTemplate, DirectPauseRecoveryRequest, TrackTaskRequest, TrackedTask } from './ConversationTypes';
 import type { AdcpTaskName, TaskRequestFor, TaskResponseTypeMap } from './AgentClient';
 import type { DeferredTaskStorage } from '../storage/interfaces';
 import type { Activity, AsyncHandlerConfig, WebhookMetadata } from './AsyncHandler';
@@ -638,6 +638,16 @@ export declare class SingleAgentClient {
      * version. Wire-shape adapters key off this method in subsequent stages.
      */
     getAdcpVersion(): string;
+    /**
+     * Observe a persisted seller task using the continuation polling path.
+     * Does not submit work or emit protocol_request/protocol_response activity
+     * for each poll. Terminal status_change activity carries operation_id and
+     * server_task_id. Results use the seller's original tool response shape.
+     * Persist the returned operationId if none was supplied. Polling handles
+     * are local to this client; matching identities can reattach to existing work.
+     * Local observation failures do not publish seller terminal lifecycle events.
+     */
+    trackTask<T = unknown>(request: TrackTaskRequest): Promise<TrackedTask<T>>;
     /** Recover the current generation of an opt-in direct mutation pause. */
     recoverDirectPauseContinuation<T>(request: DirectPauseRecoveryRequest): Promise<TaskResult<T>>;
     private recoverDurableSettlement;

package/dist/lib/core/SingleAgentClient.js

@@ -992,7 +992,7 @@ class SingleAgentClient {
           const result = await this.listAccounts(
             { account: { account_id: accountId }, ...cursor && { pagination: { cursor } } },
             void 0,
-            { ...options, [SKIP_ACCOUNT_REGISTRY_OBSERVATION]: true }
+            { ...(0, import_task_deadline.childTaskOptions)(options), [SKIP_ACCOUNT_REGISTRY_OBSERVATION]: true }
           );
           if (!result.success || result.status !== "completed" || !result.data || !("accounts" in result.data))
             throw new Error("Account status reconciliation failed.");
@@ -1693,6 +1693,22 @@ class SingleAgentClient {
   getAdcpVersion() {
     return this.resolvedAdcpVersion;
   }
+  /**
+   * Observe a persisted seller task using the continuation polling path.
+   * Does not submit work or emit protocol_request/protocol_response activity
+   * for each poll. Terminal status_change activity carries operation_id and
+   * server_task_id. Results use the seller's original tool response shape.
+   * Persist the returned operationId if none was supplied. Polling handles
+   * are local to this client; matching identities can reattach to existing work.
+   * Local observation failures do not publish seller terminal lifecycle events.
+   */
+  async trackTask(request) {
+    const snapshot = { ...request, transport: request.transport && { ...request.transport } };
+    (0, import_task_deadline.getTaskOperationId)(snapshot);
+    (0, import_abort2.throwIfAborted)(snapshot.signal);
+    const agent = this.normalizedAgent.protocol === "a2a" ? await this.ensureCanonicalUrlResolved(snapshot) : await this.ensureEndpointDiscovered(snapshot);
+    return this.executor.trackTask(agent, snapshot);
+  }
   /** Poll through the same discovered/canonical protocol endpoint used for dispatch. @internal */
   async getTaskStatus(taskId, transport, signal, wireOptions) {
     const transportSnapshot = transport === void 0 ? void 0 : { ...transport };
@@ -1759,6 +1775,7 @@ class SingleAgentClient {
       operation_id: metadata.operation_id,
       agent_id: metadata.agent_id,
       task_id: metadata.task_id,
+      server_task_id: metadata.task_id,
       task_type: metadata.task_type,
       status: metadata.status,
       payload: args.result,
@@ -2987,6 +3004,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
               agent_id: metadata.agent_id,
               context_id: metadata.context_id,
               task_id: metadata.task_id,
+              server_task_id: metadata.task_id,
               task_type: metadata.task_type,
               status: metadata.status,
               idempotency_key: metadata.idempotency_key,
@@ -3013,6 +3031,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
               agent_id: metadata.agent_id,
               context_id: metadata.context_id,
               task_id: metadata.task_id,
+              server_task_id: metadata.task_id,
               task_type: metadata.task_type,
               status: metadata.status,
               payload: webhookResult,
@@ -3101,6 +3120,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
             agent_id: metadata.agent_id,
             context_id: metadata.context_id,
             task_id: metadata.task_id,
+            server_task_id: metadata.task_id,
             task_type: metadata.task_type,
             status: metadata.status,
             idempotency_key: metadata.idempotency_key,
@@ -4806,8 +4826,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
         if (cachedResult.success && cachedResult.status === "completed") {
           if (!skipCacheRead && cacheParams.if_wholesale_feed_version === void 0 && cacheParams.if_pricing_version === void 0 && cachedResult.data.unchanged === true) {
             return this.getProducts(params, inputHandler, {
-              ...options,
-              ...effectiveOptions,
+              ...(0, import_task_deadline.childTaskOptions)({ ...options, ...effectiveOptions }),
               [SKIP_PRODUCT_CACHE]: true
             });
           }
@@ -5773,7 +5792,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
               ...cursor !== void 0 && { pagination: { cursor } }
             },
             void 0,
-            effectiveOptions
+            (0, import_task_deadline.childTaskOptions)(effectiveOptions)
           );
           onTaskResult?.(result);
           if (!result.success || result.status !== "completed" || !result.data || !("accounts" in result.data) || !Array.isArray(result.data.accounts)) {
@@ -5867,7 +5886,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
             ]
           },
           void 0,
-          effectiveOptions
+          (0, import_task_deadline.childTaskOptions)(effectiveOptions)
         );
         onTaskResult?.(result);
         if (!result.success || result.status !== "completed" || !result.data || !("accounts" in result.data) || !Array.isArray(result.data.accounts)) {
@@ -5939,7 +5958,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
             paymentTerms: hints.paymentTerms,
             billingEntity: hints.billingEntity
           },
-          effectiveOptions,
+          (0, import_task_deadline.childTaskOptions)(effectiveOptions),
           onTaskResult
         );
       } catch (error) {

package/dist/lib/core/SingleAgentClient.mjs

@@ -51,7 +51,7 @@ import {
   assertNativeRequestProposalsTask,
   guardNativeRequestProposalsCompletion
 } from "./request-proposals-guard.mjs";
-import { withTaskDeadline } from "./task-deadline.mjs";
+import { childTaskOptions, getTaskOperationId, withTaskDeadline } from "./task-deadline.mjs";
 import { createMCPRequestHeaders } from "../auth/index.mjs";
 import { isAbortOrTimeoutError } from "../protocols/abort.mjs";
 import { getSignedRequestRejection } from "../protocols/signedRequestRejection.mjs";
@@ -1089,7 +1089,7 @@ class SingleAgentClient {
           const result = await this.listAccounts(
             { account: { account_id: accountId }, ...cursor && { pagination: { cursor } } },
             void 0,
-            { ...options, [SKIP_ACCOUNT_REGISTRY_OBSERVATION]: true }
+            { ...childTaskOptions(options), [SKIP_ACCOUNT_REGISTRY_OBSERVATION]: true }
           );
           if (!result.success || result.status !== "completed" || !result.data || !("accounts" in result.data))
             throw new Error("Account status reconciliation failed.");
@@ -1790,6 +1790,22 @@ class SingleAgentClient {
   getAdcpVersion() {
     return this.resolvedAdcpVersion;
   }
+  /**
+   * Observe a persisted seller task using the continuation polling path.
+   * Does not submit work or emit protocol_request/protocol_response activity
+   * for each poll. Terminal status_change activity carries operation_id and
+   * server_task_id. Results use the seller's original tool response shape.
+   * Persist the returned operationId if none was supplied. Polling handles
+   * are local to this client; matching identities can reattach to existing work.
+   * Local observation failures do not publish seller terminal lifecycle events.
+   */
+  async trackTask(request) {
+    const snapshot = { ...request, transport: request.transport && { ...request.transport } };
+    getTaskOperationId(snapshot);
+    throwIfAborted(snapshot.signal);
+    const agent = this.normalizedAgent.protocol === "a2a" ? await this.ensureCanonicalUrlResolved(snapshot) : await this.ensureEndpointDiscovered(snapshot);
+    return this.executor.trackTask(agent, snapshot);
+  }
   /** Poll through the same discovered/canonical protocol endpoint used for dispatch. @internal */
   async getTaskStatus(taskId, transport, signal, wireOptions) {
     const transportSnapshot = transport === void 0 ? void 0 : { ...transport };
@@ -1856,6 +1872,7 @@ class SingleAgentClient {
       operation_id: metadata.operation_id,
       agent_id: metadata.agent_id,
       task_id: metadata.task_id,
+      server_task_id: metadata.task_id,
       task_type: metadata.task_type,
       status: metadata.status,
       payload: args.result,
@@ -3084,6 +3101,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
               agent_id: metadata.agent_id,
               context_id: metadata.context_id,
               task_id: metadata.task_id,
+              server_task_id: metadata.task_id,
               task_type: metadata.task_type,
               status: metadata.status,
               idempotency_key: metadata.idempotency_key,
@@ -3110,6 +3128,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
               agent_id: metadata.agent_id,
               context_id: metadata.context_id,
               task_id: metadata.task_id,
+              server_task_id: metadata.task_id,
               task_type: metadata.task_type,
               status: metadata.status,
               payload: webhookResult,
@@ -3198,6 +3217,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
             agent_id: metadata.agent_id,
             context_id: metadata.context_id,
             task_id: metadata.task_id,
+            server_task_id: metadata.task_id,
             task_type: metadata.task_type,
             status: metadata.status,
             idempotency_key: metadata.idempotency_key,
@@ -4903,8 +4923,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
         if (cachedResult.success && cachedResult.status === "completed") {
           if (!skipCacheRead && cacheParams.if_wholesale_feed_version === void 0 && cacheParams.if_pricing_version === void 0 && cachedResult.data.unchanged === true) {
             return this.getProducts(params, inputHandler, {
-              ...options,
-              ...effectiveOptions,
+              ...childTaskOptions({ ...options, ...effectiveOptions }),
               [SKIP_PRODUCT_CACHE]: true
             });
           }
@@ -5870,7 +5889,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
               ...cursor !== void 0 && { pagination: { cursor } }
             },
             void 0,
-            effectiveOptions
+            childTaskOptions(effectiveOptions)
           );
           onTaskResult?.(result);
           if (!result.success || result.status !== "completed" || !result.data || !("accounts" in result.data) || !Array.isArray(result.data.accounts)) {
@@ -5964,7 +5983,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
             ]
           },
           void 0,
-          effectiveOptions
+          childTaskOptions(effectiveOptions)
         );
         onTaskResult?.(result);
         if (!result.success || result.status !== "completed" || !result.data || !("accounts" in result.data) || !Array.isArray(result.data.accounts)) {
@@ -6036,7 +6055,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
             paymentTerms: hints.paymentTerms,
             billingEntity: hints.billingEntity
           },
-          effectiveOptions,
+          childTaskOptions(effectiveOptions),
           onTaskResult
         );
       } catch (error) {

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

@@ -2,7 +2,7 @@ import type { AgentConfig } from '../types/index.mjs';
 import type { DeferredTaskStorage } from '../storage/interfaces.mjs';
 import { type ValidationHookConfig } from '../validation/client-hooks.mjs';
 import type { AdcpCapabilities } from '../utils/capabilities.mjs';
-import type { Message, InputHandler, TaskOptions, TaskResult, TaskState, TaskStatus, TaskInfo, DirectPauseRecoveryRequest, WebhookUrlTemplate } from './ConversationTypes.mjs';
+import type { Message, InputHandler, TaskOptions, TaskResult, TaskState, TaskStatus, TaskInfo, DirectPauseRecoveryRequest, TrackTaskRequest, TrackedTask, WebhookUrlTemplate } from './ConversationTypes.mjs';
 import type { Activity } from './AsyncHandler.mjs';
 import { GovernanceMiddleware } from './GovernanceMiddleware.mjs';
 import type { GovernanceConfig } from './GovernanceTypes.mjs';
@@ -279,6 +279,8 @@ export declare class TaskExecutor {
      * Set up submitted task with webhook
      */
     private setupSubmittedTask;
+    /** Rebuild the polling continuation for seller work persisted by the caller. */
+    trackTask<T = unknown>(agent: AgentConfig, request: TrackTaskRequest): TrackedTask<T>;
     /** Build polling closures around one authoritative seller work handle. */
     private createSubmittedContinuation;
     /**

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

@@ -2,7 +2,7 @@ import type { AgentConfig } from '../types';
 import type { DeferredTaskStorage } from '../storage/interfaces';
 import { type ValidationHookConfig } from '../validation/client-hooks';
 import type { AdcpCapabilities } from '../utils/capabilities';
-import type { Message, InputHandler, TaskOptions, TaskResult, TaskState, TaskStatus, TaskInfo, DirectPauseRecoveryRequest, WebhookUrlTemplate } from './ConversationTypes';
+import type { Message, InputHandler, TaskOptions, TaskResult, TaskState, TaskStatus, TaskInfo, DirectPauseRecoveryRequest, TrackTaskRequest, TrackedTask, WebhookUrlTemplate } from './ConversationTypes';
 import type { Activity } from './AsyncHandler';
 import { GovernanceMiddleware } from './GovernanceMiddleware';
 import type { GovernanceConfig } from './GovernanceTypes';
@@ -279,6 +279,8 @@ export declare class TaskExecutor {
      * Set up submitted task with webhook
      */
     private setupSubmittedTask;
+    /** Rebuild the polling continuation for seller work persisted by the caller. */
+    trackTask<T = unknown>(agent: AgentConfig, request: TrackTaskRequest): TrackedTask<T>;
     /** Build polling closures around one authoritative seller work handle. */
     private createSubmittedContinuation;
     /**