@adcp/sdk 15.2.1 → 15.3.0

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

@@ -121,6 +121,11 @@ export type WebhookUrlTemplate = string | {
  * Options for task execution
  */
 export interface TaskOptions {
+    /**
+     * Skip inline completion status handlers for this call and its continuations.
+     * Defaults to false. Independently delivered webhook handlers are unaffected.
+     */
+    skipStatusHandlers?: boolean;
     /**
      * Absolute wall-clock deadline for the entire SDK task call (ms), including
      * discovery and capability/version preflight. Unlike `workingTimeout`, this

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

@@ -121,6 +121,11 @@ export type WebhookUrlTemplate = string | {
  * Options for task execution
  */
 export interface TaskOptions {
+    /**
+     * Skip inline completion status handlers for this call and its continuations.
+     * Defaults to false. Independently delivered webhook handlers are unaffected.
+     */
+    skipStatusHandlers?: boolean;
     /**
      * Absolute wall-clock deadline for the entire SDK task call (ms), including
      * discovery and capability/version preflight. Unlike `workingTimeout`, this

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

@@ -9,7 +9,7 @@ type TaskStatusUpdateEvent = Record<string, any>;
 import type { InputHandler, Message, TaskOptions, TaskResult, ConversationConfig, TaskInfo, TaskState, WebhookUrlTemplate, DirectPauseRecoveryRequest } from './ConversationTypes.mjs';
 import type { AdcpTaskName, TaskRequestFor, TaskResponseTypeMap } from './AgentClient.mjs';
 import type { DeferredTaskStorage } from '../storage/interfaces.mjs';
-import type { Activity, AsyncHandlerConfig } from './AsyncHandler.mjs';
+import type { Activity, AsyncHandlerConfig, WebhookMetadata } from './AsyncHandler.mjs';
 import { type WebhookHeaderValue, type WebhookHeadersLike } from '../webhooks/index.mjs';
 import { type WebhookRegistration, type WebhookRegistrationStore } from './webhook-registration.mjs';
 import { type ReplayStore, type RevocationStore, type JwksResolver, type WebhookSignatureErrorCode, type ResolvedAgentJwksResolverOptions } from '../signing/server.mjs';
@@ -191,6 +191,11 @@ export declare class WebhookDispatchError extends Error {
     readonly cause?: unknown;
     constructor(code: WebhookParseErrorCode, message: string, cause?: unknown);
 }
+/** Context for an isolated inline completion status-handler failure. */
+export interface StatusHandlerErrorContext {
+    handlerName: keyof AsyncHandlerConfig;
+    metadata: WebhookMetadata;
+}
 /**
  * Configuration for SingleAgentClient (and multi-agent client)
  */
@@ -266,8 +271,21 @@ export interface SingleAgentClientConfig extends ConversationConfig {
      * For at-least-once webhook delivery, set `handlers.webhookDedup` to
      * drop duplicate retries by `idempotency_key`. See
      * `docs/guides/PUSH-NOTIFICATION-CONFIG.md#deduplication`.
+     * For per-call skipping and inline error isolation, see
+     * `docs/guides/PUSH-NOTIFICATION-CONFIG.md#inline-completion-handlers`.
      */
     handlers?: AsyncHandlerConfig;
+    /**
+     * Return successful completed results even if an inline status handler throws.
+     * Defaults to false, preserving handler rejection and durable finalization retry.
+     * Does not change webhook error handling or cancellation behavior.
+     */
+    isolateStatusHandlerErrors?: boolean;
+    /**
+     * Reports inline status-handler errors when isolateStatusHandlerErrors is true.
+     * Errors thrown by this observer are recorded as warnings and do not reject the task.
+     */
+    onStatusHandlerError?: (error: unknown, context: StatusHandlerErrorContext) => void | Promise<void>;
     /** Select legacy HMAC-SHA256 push verification. Omit to use RFC 9421. */
     webhookSecret?: string;
     /** Durable provenance for outbound push registrations. Defaults to process-local memory. */

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

@@ -9,7 +9,7 @@ type TaskStatusUpdateEvent = Record<string, any>;
 import type { InputHandler, Message, TaskOptions, TaskResult, ConversationConfig, TaskInfo, TaskState, WebhookUrlTemplate, DirectPauseRecoveryRequest } from './ConversationTypes';
 import type { AdcpTaskName, TaskRequestFor, TaskResponseTypeMap } from './AgentClient';
 import type { DeferredTaskStorage } from '../storage/interfaces';
-import type { Activity, AsyncHandlerConfig } from './AsyncHandler';
+import type { Activity, AsyncHandlerConfig, WebhookMetadata } from './AsyncHandler';
 import { type WebhookHeaderValue, type WebhookHeadersLike } from '../webhooks';
 import { type WebhookRegistration, type WebhookRegistrationStore } from './webhook-registration';
 import { type ReplayStore, type RevocationStore, type JwksResolver, type WebhookSignatureErrorCode, type ResolvedAgentJwksResolverOptions } from '../signing/server';
@@ -191,6 +191,11 @@ export declare class WebhookDispatchError extends Error {
     readonly cause?: unknown;
     constructor(code: WebhookParseErrorCode, message: string, cause?: unknown);
 }
+/** Context for an isolated inline completion status-handler failure. */
+export interface StatusHandlerErrorContext {
+    handlerName: keyof AsyncHandlerConfig;
+    metadata: WebhookMetadata;
+}
 /**
  * Configuration for SingleAgentClient (and multi-agent client)
  */
@@ -266,8 +271,21 @@ export interface SingleAgentClientConfig extends ConversationConfig {
      * For at-least-once webhook delivery, set `handlers.webhookDedup` to
      * drop duplicate retries by `idempotency_key`. See
      * `docs/guides/PUSH-NOTIFICATION-CONFIG.md#deduplication`.
+     * For per-call skipping and inline error isolation, see
+     * `docs/guides/PUSH-NOTIFICATION-CONFIG.md#inline-completion-handlers`.
      */
     handlers?: AsyncHandlerConfig;
+    /**
+     * Return successful completed results even if an inline status handler throws.
+     * Defaults to false, preserving handler rejection and durable finalization retry.
+     * Does not change webhook error handling or cancellation behavior.
+     */
+    isolateStatusHandlerErrors?: boolean;
+    /**
+     * Reports inline status-handler errors when isolateStatusHandlerErrors is true.
+     * Errors thrown by this observer are recorded as warnings and do not reject the task.
+     */
+    onStatusHandlerError?: (error: unknown, context: StatusHandlerErrorContext) => void | Promise<void>;
     /** Select legacy HMAC-SHA256 push verification. Omit to use RFC 9421. */
     webhookSecret?: string;
     /** Durable provenance for outbound push registrations. Defaults to process-local memory. */

package/dist/lib/core/SingleAgentClient.js

@@ -240,7 +240,7 @@ const WEBHOOK_JWKS_RESOLVER_LIMIT = 1024;
 function isDeferredClientFinalizationContext(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return false;
   const context = value;
-  return context.kind === "single-agent" && typeof context.taskType === "string" && typeof context.canonical === "boolean" && !!context.productPolicyRequest && typeof context.productPolicyRequest === "object" && !Array.isArray(context.productPolicyRequest) && (context.serverVersion === void 0 || context.serverVersion === "v2" || context.serverVersion === "v3") && (context.serverVersionSynthetic === void 0 || typeof context.serverVersionSynthetic === "boolean") && (context.projectionCatalogs === void 0 || Array.isArray(context.projectionCatalogs)) && (context.handlerName === void 0 || typeof context.handlerName === "string");
+  return context.kind === "single-agent" && typeof context.taskType === "string" && typeof context.canonical === "boolean" && !!context.productPolicyRequest && typeof context.productPolicyRequest === "object" && !Array.isArray(context.productPolicyRequest) && (context.serverVersion === void 0 || context.serverVersion === "v2" || context.serverVersion === "v3") && (context.serverVersionSynthetic === void 0 || typeof context.serverVersionSynthetic === "boolean") && (context.projectionCatalogs === void 0 || Array.isArray(context.projectionCatalogs)) && (context.handlerName === void 0 || typeof context.handlerName === "string") && (context.skipStatusHandlers === void 0 || typeof context.skipStatusHandlers === "boolean");
 }
 const CANONICAL_PACKAGE_ROUTE_TASKS = /* @__PURE__ */ new Set(["create_media_buy", "update_media_buy", "get_media_buys"]);
 const canonicalCreativeRoutingSnapshots = /* @__PURE__ */ new WeakSet();
@@ -3189,7 +3189,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       ...projectionCatalogs !== void 0 && { projectionCatalogs },
       ...routingSnapshot !== void 0 && { routingSnapshot },
       ...effectiveOptions?.taskId !== void 0 && { optionTaskId: effectiveOptions.taskId },
-      ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId }
+      ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId },
+      ...effectiveOptions?.skipStatusHandlers !== void 0 && {
+        skipStatusHandlers: effectiveOptions.skipStatusHandlers
+      }
     };
     let result = await canonicalCreativeExecutionStorage.run(
       {
@@ -3300,7 +3303,8 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const resumedOptions = {
       ...options ?? {},
       ...context.optionTaskId !== void 0 && { taskId: context.optionTaskId },
-      ...context.optionContextId !== void 0 && { contextId: context.optionContextId }
+      ...context.optionContextId !== void 0 && { contextId: context.optionContextId },
+      ...context.skipStatusHandlers !== void 0 && { skipStatusHandlers: context.skipStatusHandlers }
     };
     const rawDeferredResume = result.deferred?.resume;
     const rawSubmittedWaitForCompletion = result.submitted?.waitForCompletion;
@@ -3390,11 +3394,12 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     return finalized;
   }
   async notifyCompletedStatusHandler(result, taskType, handlerName, options) {
-    if (result.status !== "completed" || !result.success || !this.asyncHandler) return;
+    if (options?.skipStatusHandlers === true || result.status !== "completed" || !result.success || !this.asyncHandler)
+      return;
     const handler = this.config.handlers?.[handlerName];
     if (!handler) return;
     (0, import_abort2.throwIfAborted)(options?.signal);
-    await handler(result.data, {
+    const metadata = {
       operation_id: options?.contextId || "sync",
       context_id: options?.contextId,
       task_id: result.metadata.taskId,
@@ -3402,7 +3407,30 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       task_type: taskType,
       status: result.status,
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    });
+    };
+    try {
+      await handler(result.data, metadata);
+    } catch (error) {
+      if (this.config.isolateStatusHandlerErrors !== true) throw error;
+      (0, import_abort2.throwIfAborted)(options?.signal);
+      result.debug_logs = [
+        ...result.debug_logs ?? [],
+        {
+          level: "warn",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: "Inline status handler failed. The seller operation completed; reconcile local post-processing."
+        }
+      ];
+      try {
+        await this.config.onStatusHandlerError?.(error, { handlerName, metadata });
+      } catch {
+        result.debug_logs.push({
+          level: "warn",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: "onStatusHandlerError observer failed. The seller operation completed."
+        });
+      }
+    }
     (0, import_abort2.throwIfAborted)(options?.signal);
   }
   canonicalCreativeInputHandler(taskType, inputHandler, canonical = CANONICAL_CREATIVE_ACTIVITY_TASKS.has(taskType)) {
@@ -5678,7 +5706,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
         productPolicyRequest: productPolicyRequestSnapshot(normalizedParams),
         accountRegistry: this.accountRegistryContext(taskName, normalizedParams, effectiveOptions),
         ...effectiveOptions?.taskId !== void 0 && { optionTaskId: effectiveOptions.taskId },
-        ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId }
+        ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId },
+        ...effectiveOptions?.skipStatusHandlers !== void 0 && {
+          skipStatusHandlers: effectiveOptions.skipStatusHandlers
+        }
       };
       let result = await this.executor.executeTask(
         agent,

package/dist/lib/core/SingleAgentClient.mjs

@@ -310,7 +310,7 @@ const WEBHOOK_JWKS_RESOLVER_LIMIT = 1024;
 function isDeferredClientFinalizationContext(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return false;
   const context = value;
-  return context.kind === "single-agent" && typeof context.taskType === "string" && typeof context.canonical === "boolean" && !!context.productPolicyRequest && typeof context.productPolicyRequest === "object" && !Array.isArray(context.productPolicyRequest) && (context.serverVersion === void 0 || context.serverVersion === "v2" || context.serverVersion === "v3") && (context.serverVersionSynthetic === void 0 || typeof context.serverVersionSynthetic === "boolean") && (context.projectionCatalogs === void 0 || Array.isArray(context.projectionCatalogs)) && (context.handlerName === void 0 || typeof context.handlerName === "string");
+  return context.kind === "single-agent" && typeof context.taskType === "string" && typeof context.canonical === "boolean" && !!context.productPolicyRequest && typeof context.productPolicyRequest === "object" && !Array.isArray(context.productPolicyRequest) && (context.serverVersion === void 0 || context.serverVersion === "v2" || context.serverVersion === "v3") && (context.serverVersionSynthetic === void 0 || typeof context.serverVersionSynthetic === "boolean") && (context.projectionCatalogs === void 0 || Array.isArray(context.projectionCatalogs)) && (context.handlerName === void 0 || typeof context.handlerName === "string") && (context.skipStatusHandlers === void 0 || typeof context.skipStatusHandlers === "boolean");
 }
 const CANONICAL_PACKAGE_ROUTE_TASKS = /* @__PURE__ */ new Set(["create_media_buy", "update_media_buy", "get_media_buys"]);
 const canonicalCreativeRoutingSnapshots = /* @__PURE__ */ new WeakSet();
@@ -3259,7 +3259,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       ...projectionCatalogs !== void 0 && { projectionCatalogs },
       ...routingSnapshot !== void 0 && { routingSnapshot },
       ...effectiveOptions?.taskId !== void 0 && { optionTaskId: effectiveOptions.taskId },
-      ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId }
+      ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId },
+      ...effectiveOptions?.skipStatusHandlers !== void 0 && {
+        skipStatusHandlers: effectiveOptions.skipStatusHandlers
+      }
     };
     let result = await canonicalCreativeExecutionStorage.run(
       {
@@ -3370,7 +3373,8 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const resumedOptions = {
       ...options ?? {},
       ...context.optionTaskId !== void 0 && { taskId: context.optionTaskId },
-      ...context.optionContextId !== void 0 && { contextId: context.optionContextId }
+      ...context.optionContextId !== void 0 && { contextId: context.optionContextId },
+      ...context.skipStatusHandlers !== void 0 && { skipStatusHandlers: context.skipStatusHandlers }
     };
     const rawDeferredResume = result.deferred?.resume;
     const rawSubmittedWaitForCompletion = result.submitted?.waitForCompletion;
@@ -3460,11 +3464,12 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     return finalized;
   }
   async notifyCompletedStatusHandler(result, taskType, handlerName, options) {
-    if (result.status !== "completed" || !result.success || !this.asyncHandler) return;
+    if (options?.skipStatusHandlers === true || result.status !== "completed" || !result.success || !this.asyncHandler)
+      return;
     const handler = this.config.handlers?.[handlerName];
     if (!handler) return;
     throwIfAborted(options?.signal);
-    await handler(result.data, {
+    const metadata = {
       operation_id: options?.contextId || "sync",
       context_id: options?.contextId,
       task_id: result.metadata.taskId,
@@ -3472,7 +3477,30 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       task_type: taskType,
       status: result.status,
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    });
+    };
+    try {
+      await handler(result.data, metadata);
+    } catch (error) {
+      if (this.config.isolateStatusHandlerErrors !== true) throw error;
+      throwIfAborted(options?.signal);
+      result.debug_logs = [
+        ...result.debug_logs ?? [],
+        {
+          level: "warn",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: "Inline status handler failed. The seller operation completed; reconcile local post-processing."
+        }
+      ];
+      try {
+        await this.config.onStatusHandlerError?.(error, { handlerName, metadata });
+      } catch {
+        result.debug_logs.push({
+          level: "warn",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: "onStatusHandlerError observer failed. The seller operation completed."
+        });
+      }
+    }
     throwIfAborted(options?.signal);
   }
   canonicalCreativeInputHandler(taskType, inputHandler, canonical = CANONICAL_CREATIVE_ACTIVITY_TASKS.has(taskType)) {
@@ -5748,7 +5776,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
         productPolicyRequest: productPolicyRequestSnapshot(normalizedParams),
         accountRegistry: this.accountRegistryContext(taskName, normalizedParams, effectiveOptions),
         ...effectiveOptions?.taskId !== void 0 && { optionTaskId: effectiveOptions.taskId },
-        ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId }
+        ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId },
+        ...effectiveOptions?.skipStatusHandlers !== void 0 && {
+          skipStatusHandlers: effectiveOptions.skipStatusHandlers
+        }
       };
       let result = await this.executor.executeTask(
         agent,

package/dist/lib/index.d.mts

@@ -14,7 +14,7 @@ export { resolveInlinePublisherProperties, resolveSingularInline, detectInlineFe
 export { fetchAgentAuthorizationsFromDirectory, type AgentAuthorizationsIterator, type FetchAgentAuthorizationsOptions, type DirectoryLookupPage, type DirectoryPublisherEntry, type DirectoryDiscoveryMethod, type DirectoryPublisherStatus, } from './discovery/agent-directory.mjs';
 export { validateAdAgents, parseManagerDomain, type DiscoveryMethod, type AdAgentsValidationResult, type ValidateAdAgentsOptions, } from './discovery/validate-adagents.mjs';
 export { SingleAgentClient, WebhookDispatchError, createSingleAgentClient, UnsupportedFeatureError, } from './core/SingleAgentClient.mjs';
-export type { CapabilityEvidenceScope, CapabilityEvidenceSnapshot, ClientProductPropertyPolicy, CreativeDeliveryTaskOptions, SingleAgentClientConfig, SyncCreativesTaskOptions, VerifyAndParseWebhookOptions, WebhookHandlerAdapter, WebhookHandlerRequest, WebhookRequestContext, WebhookParseErrorCode, WebhookParseFailure, WebhookParseResult, WebhookParseSuccess, WebhookVerificationConfig, } from './core/SingleAgentClient.mjs';
+export type { CapabilityEvidenceScope, CapabilityEvidenceSnapshot, ClientProductPropertyPolicy, CreativeDeliveryTaskOptions, SingleAgentClientConfig, StatusHandlerErrorContext, SyncCreativesTaskOptions, VerifyAndParseWebhookOptions, WebhookHandlerAdapter, WebhookHandlerRequest, WebhookRequestContext, WebhookParseErrorCode, WebhookParseFailure, WebhookParseResult, WebhookParseSuccess, WebhookVerificationConfig, } from './core/SingleAgentClient.mjs';
 export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStoreOptions, type WebhookAuthenticationMode, type WebhookRegistration, type WebhookRegistrationStore, } from './core/webhook-registration.mjs';
 export { pgWebhookRegistrationStore, getWebhookRegistrationMigration, WEBHOOK_REGISTRATION_MIGRATION, cleanupExpiredWebhookRegistrations, type PgWebhookRegistrationStoreOptions, type CleanupExpiredWebhookRegistrationsOptions, } from './core/postgres-webhook-registration-store.mjs';
 export { redisWebhookRegistrationStore, type RedisWebhookRegistrationStoreOptions, } from './core/redis-webhook-registration-store.mjs';

package/dist/lib/index.d.ts

@@ -14,7 +14,7 @@ export { resolveInlinePublisherProperties, resolveSingularInline, detectInlineFe
 export { fetchAgentAuthorizationsFromDirectory, type AgentAuthorizationsIterator, type FetchAgentAuthorizationsOptions, type DirectoryLookupPage, type DirectoryPublisherEntry, type DirectoryDiscoveryMethod, type DirectoryPublisherStatus, } from './discovery/agent-directory';
 export { validateAdAgents, parseManagerDomain, type DiscoveryMethod, type AdAgentsValidationResult, type ValidateAdAgentsOptions, } from './discovery/validate-adagents';
 export { SingleAgentClient, WebhookDispatchError, createSingleAgentClient, UnsupportedFeatureError, } from './core/SingleAgentClient';
-export type { CapabilityEvidenceScope, CapabilityEvidenceSnapshot, ClientProductPropertyPolicy, CreativeDeliveryTaskOptions, SingleAgentClientConfig, SyncCreativesTaskOptions, VerifyAndParseWebhookOptions, WebhookHandlerAdapter, WebhookHandlerRequest, WebhookRequestContext, WebhookParseErrorCode, WebhookParseFailure, WebhookParseResult, WebhookParseSuccess, WebhookVerificationConfig, } from './core/SingleAgentClient';
+export type { CapabilityEvidenceScope, CapabilityEvidenceSnapshot, ClientProductPropertyPolicy, CreativeDeliveryTaskOptions, SingleAgentClientConfig, StatusHandlerErrorContext, SyncCreativesTaskOptions, VerifyAndParseWebhookOptions, WebhookHandlerAdapter, WebhookHandlerRequest, WebhookRequestContext, WebhookParseErrorCode, WebhookParseFailure, WebhookParseResult, WebhookParseSuccess, WebhookVerificationConfig, } from './core/SingleAgentClient';
 export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStoreOptions, type WebhookAuthenticationMode, type WebhookRegistration, type WebhookRegistrationStore, } from './core/webhook-registration';
 export { pgWebhookRegistrationStore, getWebhookRegistrationMigration, WEBHOOK_REGISTRATION_MIGRATION, cleanupExpiredWebhookRegistrations, type PgWebhookRegistrationStoreOptions, type CleanupExpiredWebhookRegistrationsOptions, } from './core/postgres-webhook-registration-store';
 export { redisWebhookRegistrationStore, type RedisWebhookRegistrationStoreOptions, } from './core/redis-webhook-registration-store';

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -4,5 +4,5 @@
   "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
   "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
   "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-10-08T01:48:18.869Z"
+  "synced_at": "2026-10-08T14:21:02.333Z"
 }

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "15.2.1";
+export declare const RUNNER_CAPABILITY_VERSION = "15.3.0";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.d.ts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "15.2.1";
+export declare const RUNNER_CAPABILITY_VERSION = "15.3.0";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "15.2.1";
+export declare const LIBRARY_VERSION = "15.3.0";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "15.2.1";
+    readonly library: "15.3.0";
     readonly adcp: "3.2.3";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.2.1", "3.2", "3.2.2", "3.2.3"];
-    readonly generatedAt: "2026-10-08T00:38:32.684Z";
+    readonly generatedAt: "2026-10-08T13:30:50.878Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "15.2.1";
+export declare const LIBRARY_VERSION = "15.3.0";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "15.2.1";
+    readonly library: "15.3.0";
     readonly adcp: "3.2.3";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.2.1", "3.2", "3.2.2", "3.2.3"];
-    readonly generatedAt: "2026-10-08T00:38:32.684Z";
+    readonly generatedAt: "2026-10-08T13:30:50.878Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js

@@ -31,7 +31,7 @@ __export(version_exports, {
   toReleasePrecisionVersion: () => toReleasePrecisionVersion
 });
 module.exports = __toCommonJS(version_exports);
-const LIBRARY_VERSION = "15.2.1";
+const LIBRARY_VERSION = "15.3.0";
 const ADCP_VERSION = "3.2.3";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -97,10 +97,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2.3"
 ];
 const VERSION_INFO = {
-  library: "15.2.1",
+  library: "15.3.0",
   adcp: "3.2.3",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-08T00:38:32.684Z"
+  generatedAt: "2026-10-08T13:30:50.878Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/version.mjs

@@ -1,4 +1,4 @@
-const LIBRARY_VERSION = "15.2.1";
+const LIBRARY_VERSION = "15.3.0";
 const ADCP_VERSION = "3.2.3";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -64,10 +64,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2.3"
 ];
 const VERSION_INFO = {
-  library: "15.2.1",
+  library: "15.3.0",
   adcp: "3.2.3",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-08T00:38:32.684Z"
+  generatedAt: "2026-10-08T13:30:50.878Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/docs/TYPE-SUMMARY.md

@@ -1,7 +1,7 @@
 # AdCP Type Summary
 
 > Generated at: 2026-10-08
-> @adcp/sdk v15.2.1
+> @adcp/sdk v15.3.0
 
 Curated reference of the types that matter for using the AdCP client. For full generated types see `src/lib/types/tools.generated.ts` and `src/lib/types/core.generated.ts`.
 
@@ -57,6 +57,7 @@ interface TransportOptions {
 }
 
 interface TaskOptions {
+  skipStatusHandlers?: boolean; // Skip inline completion handlers, including continuations
   timeout?: number;             // Absolute whole-task deadline
   signal?: AbortSignal;         // Caller cancellation
   // Direct A2A mutation route, bound to authenticated principal + account scope.

package/docs/guides/PUSH-NOTIFICATION-CONFIG.md

@@ -39,6 +39,45 @@ the reporting webhook schema. A caller-provided reporting URL must always bring
 its own complete authentication block; the client never pairs `webhookSecret`
 with a caller-controlled endpoint.
 
+## Inline completion handlers
+
+Configured status handlers also run inline when a task call returns a successful
+completed result. By default, an inline handler error rejects that call. For a
+forwarding call whose caller will process the returned result, skip the inline
+handler for that call:
+
+```typescript
+const result = await agent.syncCreatives(params, undefined, { skipStatusHandlers: true });
+```
+
+The option follows submitted waits and deferred resumes, including stored
+continuations resumed after restart. Independently delivered webhook handlers
+still run; `skipStatusHandlers` does not disable webhook registration or delivery.
+
+To keep successful results when inline post-processing fails, opt in at client
+construction:
+
+```typescript
+const agent = new SingleAgentClient(sellerConfig, {
+  handlers: {
+    onSyncCreativesStatusChange: recordCreativeResults,
+  },
+  isolateStatusHandlerErrors: true,
+  onStatusHandlerError: async (error, { handlerName, metadata }) => {
+    await recordLocalFailure(error, handlerName, metadata.task_id);
+  },
+});
+```
+
+Isolation returns the completed `TaskResult` and allows settlement acknowledgement.
+The SDK adds a warning to `debug_logs` without including the handler's error text.
+The observer receives the original error and completion metadata, so keep secrets
+out of application logs. Observer errors add a warning and do not reject the task.
+The observer is awaited; keep its work bounded so it cannot stall local completion.
+Cancellation, response validation, settlement acknowledgement errors, and webhook
+error handling retain their existing behavior. With isolation disabled, durable
+handler failures remain retryable without redispatching the seller operation.
+
 ## Wire Payload
 
 The default RFC 9421 registration has no `authentication` block:

package/docs/llms.txt

@@ -1,7 +1,7 @@
 # Ad Context Protocol (AdCP)
 
 > Generated at: 2026-10-08
-> Library: @adcp/sdk v15.2.1
+> Library: @adcp/sdk v15.3.0
 > AdCP major version: 3
 > Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt
 > Note: the `Library` stamp reflects the package.json version at doc-generation time. The narrative below describes the surface that lands on the next-published minor — including any 6.7 helpers documented here ahead of the release tag.

package/docs/migration-14.x-rc-worksheet.md

@@ -11,8 +11,8 @@ below as the publication/deployment gate.
 
 | Fact | Value |
 | --- | --- |
-| Exact npm package | `@adcp/sdk@15.2.1` |
-| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@15.2.1 dist.integrity` |
+| Exact npm package | `@adcp/sdk@15.3.0` |
+| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@15.3.0 dist.integrity` |
 | Node.js runtime | `^20.19.0 || >=22.12.0` |
 | Default AdCP wire release | `3.2.3` |
 | Maintained wire releases | `v2.5`, `v2.6`, `v3`, `3.0.0`, `3.0`, `3.0.1`, `3.0.2`, `3.0.3`, `3.0.4`, `3.0.5`, `3.0.6`, `3.0.7`, `3.0.8`, `3.0.9`, `3.0.10`, `3.0.11`, `3.0.12`, `3.0.13`, `3.0.14`, `3.0.15`, `3.0.16`, `3.0.17`, `3.0.18`, `3.0.19`, `3.0.20`, `3.0.21`, `3.0.22`, `3.0.23`, `3.0.24`, `3.0.25`, `3.1.0`, `3.1`, `3.1.1`, `3.1.2`, `3.1.3`, `3.1.4`, `3.1.5`, `3.1.6`, `3.1.7`, `3.1.8`, `3.1.9`, `3.1.10`, `3.1.11`, `3.1.12`, `3.1.13`, `3.1.14`, `3.1.15`, `3.1.16`, `3.1.17`, `3.1.18`, `3.1.19`, `3.1.20`, `3.1.21`, `3.1.22`, `3.1.23`, `3.1.24`, `3.2.1`, `3.2`, `3.2.2`, `3.2.3` |
@@ -21,8 +21,8 @@ below as the publication/deployment gate.
 Install exact production inputs rather than a moving range or dist-tag:
 
 ```bash
-npm install --save-exact '@adcp/sdk@15.2.1'
-npm view '@adcp/sdk@15.2.1' dist.integrity
+npm install --save-exact '@adcp/sdk@15.3.0'
+npm view '@adcp/sdk@15.3.0' dist.integrity
 ```
 
 ### Required and optional peers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "15.2.1",
+  "version": "15.3.0",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",