@adcp/sdk 13.0.0-rc.7 → 13.0.0-rc.8

package/dist/lib/core/task-deadline.d.mts

@@ -0,0 +1,20 @@
+import { TaskTimeoutError, type GovernanceOutcomeRecovery } from '../errors/index.mjs';
+import type { TaskOptions } from './ConversationTypes.mjs';
+declare const TASK_OPERATION_ID: unique symbol;
+declare const TASK_DEADLINE_ERROR: unique symbol;
+type DeadlineTaskOptions<TOptions extends TaskOptions = TaskOptions> = TOptions & {
+    [TASK_OPERATION_ID]: string;
+    [TASK_DEADLINE_ERROR]?: TaskTimeoutError;
+};
+export declare function getTaskOperationId(options: TaskOptions | undefined): string | undefined;
+export declare function attachTaskDeadlineIdempotencyKey(options: TaskOptions, idempotencyKey: string): void;
+export declare function attachTaskDeadlineGovernanceRecovery(options: TaskOptions, recovery: GovernanceOutcomeRecovery): void;
+/**
+ * Run one complete SDK task under the caller's absolute wall-clock deadline.
+ *
+ * The consumed timeout is removed from the nested options so lower layers do
+ * not start a second deadline. They still receive the composed signal, while
+ * `workingTimeout` remains the transport's separate resettable idle timeout.
+ */
+export declare function withTaskDeadline<T, TOptions extends TaskOptions = TaskOptions>(options: TOptions | undefined, run: (effectiveOptions: DeadlineTaskOptions<TOptions>) => Promise<T>): Promise<T>;
+export {};

package/dist/lib/core/task-deadline.d.ts

@@ -0,0 +1,21 @@
+import { TaskTimeoutError, type GovernanceOutcomeRecovery } from '../errors';
+import type { TaskOptions } from './ConversationTypes';
+declare const TASK_OPERATION_ID: unique symbol;
+declare const TASK_DEADLINE_ERROR: unique symbol;
+type DeadlineTaskOptions<TOptions extends TaskOptions = TaskOptions> = TOptions & {
+    [TASK_OPERATION_ID]: string;
+    [TASK_DEADLINE_ERROR]?: TaskTimeoutError;
+};
+export declare function getTaskOperationId(options: TaskOptions | undefined): string | undefined;
+export declare function attachTaskDeadlineIdempotencyKey(options: TaskOptions, idempotencyKey: string): void;
+export declare function attachTaskDeadlineGovernanceRecovery(options: TaskOptions, recovery: GovernanceOutcomeRecovery): void;
+/**
+ * Run one complete SDK task under the caller's absolute wall-clock deadline.
+ *
+ * The consumed timeout is removed from the nested options so lower layers do
+ * not start a second deadline. They still receive the composed signal, while
+ * `workingTimeout` remains the transport's separate resettable idle timeout.
+ */
+export declare function withTaskDeadline<T, TOptions extends TaskOptions = TaskOptions>(options: TOptions | undefined, run: (effectiveOptions: DeadlineTaskOptions<TOptions>) => Promise<T>): Promise<T>;
+export {};
+//# sourceMappingURL=task-deadline.d.ts.map

package/dist/lib/core/task-deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-deadline.d.ts","sourceRoot":"","sources":["../../../src/lib/core/task-deadline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,KAAK,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,QAAA,MAAM,iBAAiB,eAAiC,CAAC;AACzD,QAAA,MAAM,mBAAmB,eAAmC,CAAC;AAE7D,KAAK,mBAAmB,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW,IAAI,QAAQ,GAAG;IAChF,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC5B,CAAC,mBAAmB,CAAC,CAAC,EAAE,gBAAgB,CAAC;CAC1C,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEvF;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAKnG;AAED,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAGpH;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,SAAS,WAAW,GAAG,WAAW,EAClF,OAAO,EAAE,QAAQ,GAAG,SAAS,EAC7B,GAAG,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACnE,OAAO,CAAC,CAAC,CAAC,CAwBZ"}

package/dist/lib/core/task-deadline.js

@@ -0,0 +1,74 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var task_deadline_exports = {};
+__export(task_deadline_exports, {
+  attachTaskDeadlineGovernanceRecovery: () => attachTaskDeadlineGovernanceRecovery,
+  attachTaskDeadlineIdempotencyKey: () => attachTaskDeadlineIdempotencyKey,
+  getTaskOperationId: () => getTaskOperationId,
+  withTaskDeadline: () => withTaskDeadline
+});
+module.exports = __toCommonJS(task_deadline_exports);
+var import_node_crypto = require("node:crypto");
+var import_errors = require('../errors/index.js');
+var import_abort = require('../protocols/abort.js');
+const TASK_OPERATION_ID = /* @__PURE__ */ Symbol("adcp.taskOperationId");
+const TASK_DEADLINE_ERROR = /* @__PURE__ */ Symbol("adcp.taskDeadlineError");
+function getTaskOperationId(options) {
+  return options?.[TASK_OPERATION_ID];
+}
+function attachTaskDeadlineIdempotencyKey(options, idempotencyKey) {
+  const error = options[TASK_DEADLINE_ERROR];
+  if (!error) return;
+  error.idempotency_key = idempotencyKey;
+  error.idempotencyKey = idempotencyKey;
+}
+function attachTaskDeadlineGovernanceRecovery(options, recovery) {
+  const error = options[TASK_DEADLINE_ERROR];
+  if (error) error.governanceRecovery = recovery;
+}
+async function withTaskDeadline(options, run) {
+  const existing = options;
+  const taskId = existing?.[TASK_OPERATION_ID] ?? (0, import_node_crypto.randomUUID)();
+  const timeout = options?.timeout;
+  const baseOptions = { ...options, timeout: void 0, [TASK_OPERATION_ID]: taskId };
+  (0, import_abort.throwIfAborted)(options?.signal);
+  if (timeout === void 0 || timeout === 0) return run(baseOptions);
+  if (!Number.isFinite(timeout) || timeout < 0 || timeout > import_abort.MAX_TIMER_DELAY_MS) {
+    throw new RangeError(`timeout must be a finite non-negative number <= ${import_abort.MAX_TIMER_DELAY_MS}`);
+  }
+  const timeoutError = new import_errors.TaskTimeoutError(taskId, timeout);
+  return (0, import_abort.withAbortSignal)(
+    [options?.signal],
+    timeout,
+    (signal) => run({
+      ...baseOptions,
+      signal,
+      [TASK_DEADLINE_ERROR]: timeoutError
+    }),
+    { timeoutError }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  attachTaskDeadlineGovernanceRecovery,
+  attachTaskDeadlineIdempotencyKey,
+  getTaskOperationId,
+  withTaskDeadline
+});
+//# sourceMappingURL=task-deadline.js.map

package/dist/lib/core/task-deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/core/task-deadline.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { TaskTimeoutError, type GovernanceOutcomeRecovery } from '../errors';\nimport { MAX_TIMER_DELAY_MS, throwIfAborted, withAbortSignal } from '../protocols/abort';\nimport type { TaskOptions } from './ConversationTypes';\n\nconst TASK_OPERATION_ID = Symbol('adcp.taskOperationId');\nconst TASK_DEADLINE_ERROR = Symbol('adcp.taskDeadlineError');\n\ntype DeadlineTaskOptions<TOptions extends TaskOptions = TaskOptions> = TOptions & {\n  [TASK_OPERATION_ID]: string;\n  [TASK_DEADLINE_ERROR]?: TaskTimeoutError;\n};\n\nexport function getTaskOperationId(options: TaskOptions | undefined): string | undefined {\n  return (options as DeadlineTaskOptions | undefined)?.[TASK_OPERATION_ID];\n}\n\nexport function attachTaskDeadlineIdempotencyKey(options: TaskOptions, idempotencyKey: string): void {\n  const error = (options as DeadlineTaskOptions)[TASK_DEADLINE_ERROR];\n  if (!error) return;\n  error.idempotency_key = idempotencyKey;\n  error.idempotencyKey = idempotencyKey;\n}\n\nexport function attachTaskDeadlineGovernanceRecovery(options: TaskOptions, recovery: GovernanceOutcomeRecovery): void {\n  const error = (options as DeadlineTaskOptions)[TASK_DEADLINE_ERROR];\n  if (error) error.governanceRecovery = recovery;\n}\n\n/**\n * Run one complete SDK task under the caller's absolute wall-clock deadline.\n *\n * The consumed timeout is removed from the nested options so lower layers do\n * not start a second deadline. They still receive the composed signal, while\n * `workingTimeout` remains the transport's separate resettable idle timeout.\n */\nexport async function withTaskDeadline<T, TOptions extends TaskOptions = TaskOptions>(\n  options: TOptions | undefined,\n  run: (effectiveOptions: DeadlineTaskOptions<TOptions>) => Promise<T>\n): Promise<T> {\n  const existing = options as DeadlineTaskOptions<TOptions> | undefined;\n  const taskId = existing?.[TASK_OPERATION_ID] ?? randomUUID();\n  const timeout = options?.timeout;\n  const baseOptions = { ...options, timeout: undefined, [TASK_OPERATION_ID]: taskId } as DeadlineTaskOptions<TOptions>;\n  throwIfAborted(options?.signal);\n  if (timeout === undefined || timeout === 0) return run(baseOptions);\n\n  if (!Number.isFinite(timeout) || timeout < 0 || timeout > MAX_TIMER_DELAY_MS) {\n    throw new RangeError(`timeout must be a finite non-negative number <= ${MAX_TIMER_DELAY_MS}`);\n  }\n\n  const timeoutError = new TaskTimeoutError(taskId, timeout);\n  return withAbortSignal(\n    [options?.signal],\n    timeout,\n    signal =>\n      run({\n        ...baseOptions,\n        signal,\n        [TASK_DEADLINE_ERROR]: timeoutError,\n      }),\n    { timeoutError }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA2B;AAE3B,oBAAiE;AACjE,mBAAoE;AAGpE,MAAM,oBAAoB,uBAAO,sBAAsB;AACvD,MAAM,sBAAsB,uBAAO,wBAAwB;AAOpD,SAAS,mBAAmB,SAAsD;AACvF,SAAQ,UAA8C,iBAAiB;AACzE;AAEO,SAAS,iCAAiC,SAAsB,gBAA8B;AACnG,QAAM,QAAS,QAAgC,mBAAmB;AAClE,MAAI,CAAC,MAAO;AACZ,QAAM,kBAAkB;AACxB,QAAM,iBAAiB;AACzB;AAEO,SAAS,qCAAqC,SAAsB,UAA2C;AACpH,QAAM,QAAS,QAAgC,mBAAmB;AAClE,MAAI,MAAO,OAAM,qBAAqB;AACxC;AASA,eAAsB,iBACpB,SACA,KACY;AACZ,QAAM,WAAW;AACjB,QAAM,SAAS,WAAW,iBAAiB,SAAK,+BAAW;AAC3D,QAAM,UAAU,SAAS;AACzB,QAAM,cAAc,EAAE,GAAG,SAAS,SAAS,QAAW,CAAC,iBAAiB,GAAG,OAAO;AAClF,mCAAe,SAAS,MAAM;AAC9B,MAAI,YAAY,UAAa,YAAY,EAAG,QAAO,IAAI,WAAW;AAElE,MAAI,CAAC,OAAO,SAAS,OAAO,KAAK,UAAU,KAAK,UAAU,iCAAoB;AAC5E,UAAM,IAAI,WAAW,mDAAmD,+BAAkB,EAAE;AAAA,EAC9F;AAEA,QAAM,eAAe,IAAI,+BAAiB,QAAQ,OAAO;AACzD,aAAO;AAAA,IACL,CAAC,SAAS,MAAM;AAAA,IAChB;AAAA,IACA,YACE,IAAI;AAAA,MACF,GAAG;AAAA,MACH;AAAA,MACA,CAAC,mBAAmB,GAAG;AAAA,IACzB,CAAC;AAAA,IACH,EAAE,aAAa;AAAA,EACjB;AACF;","names":[]}

package/dist/lib/core/task-deadline.mjs

@@ -0,0 +1,47 @@
+import { randomUUID } from "node:crypto";
+import { TaskTimeoutError } from "../errors/index.mjs";
+import { MAX_TIMER_DELAY_MS, throwIfAborted, withAbortSignal } from "../protocols/abort.mjs";
+const TASK_OPERATION_ID = /* @__PURE__ */ Symbol("adcp.taskOperationId");
+const TASK_DEADLINE_ERROR = /* @__PURE__ */ Symbol("adcp.taskDeadlineError");
+function getTaskOperationId(options) {
+  return options?.[TASK_OPERATION_ID];
+}
+function attachTaskDeadlineIdempotencyKey(options, idempotencyKey) {
+  const error = options[TASK_DEADLINE_ERROR];
+  if (!error) return;
+  error.idempotency_key = idempotencyKey;
+  error.idempotencyKey = idempotencyKey;
+}
+function attachTaskDeadlineGovernanceRecovery(options, recovery) {
+  const error = options[TASK_DEADLINE_ERROR];
+  if (error) error.governanceRecovery = recovery;
+}
+async function withTaskDeadline(options, run) {
+  const existing = options;
+  const taskId = existing?.[TASK_OPERATION_ID] ?? randomUUID();
+  const timeout = options?.timeout;
+  const baseOptions = { ...options, timeout: void 0, [TASK_OPERATION_ID]: taskId };
+  throwIfAborted(options?.signal);
+  if (timeout === void 0 || timeout === 0) return run(baseOptions);
+  if (!Number.isFinite(timeout) || timeout < 0 || timeout > MAX_TIMER_DELAY_MS) {
+    throw new RangeError(`timeout must be a finite non-negative number <= ${MAX_TIMER_DELAY_MS}`);
+  }
+  const timeoutError = new TaskTimeoutError(taskId, timeout);
+  return withAbortSignal(
+    [options?.signal],
+    timeout,
+    (signal) => run({
+      ...baseOptions,
+      signal,
+      [TASK_DEADLINE_ERROR]: timeoutError
+    }),
+    { timeoutError }
+  );
+}
+export {
+  attachTaskDeadlineGovernanceRecovery,
+  attachTaskDeadlineIdempotencyKey,
+  getTaskOperationId,
+  withTaskDeadline
+};
+//# sourceMappingURL=task-deadline.mjs.map

package/dist/lib/core/task-deadline.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/core/task-deadline.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { TaskTimeoutError, type GovernanceOutcomeRecovery } from '../errors';\nimport { MAX_TIMER_DELAY_MS, throwIfAborted, withAbortSignal } from '../protocols/abort';\nimport type { TaskOptions } from './ConversationTypes';\n\nconst TASK_OPERATION_ID = Symbol('adcp.taskOperationId');\nconst TASK_DEADLINE_ERROR = Symbol('adcp.taskDeadlineError');\n\ntype DeadlineTaskOptions<TOptions extends TaskOptions = TaskOptions> = TOptions & {\n  [TASK_OPERATION_ID]: string;\n  [TASK_DEADLINE_ERROR]?: TaskTimeoutError;\n};\n\nexport function getTaskOperationId(options: TaskOptions | undefined): string | undefined {\n  return (options as DeadlineTaskOptions | undefined)?.[TASK_OPERATION_ID];\n}\n\nexport function attachTaskDeadlineIdempotencyKey(options: TaskOptions, idempotencyKey: string): void {\n  const error = (options as DeadlineTaskOptions)[TASK_DEADLINE_ERROR];\n  if (!error) return;\n  error.idempotency_key = idempotencyKey;\n  error.idempotencyKey = idempotencyKey;\n}\n\nexport function attachTaskDeadlineGovernanceRecovery(options: TaskOptions, recovery: GovernanceOutcomeRecovery): void {\n  const error = (options as DeadlineTaskOptions)[TASK_DEADLINE_ERROR];\n  if (error) error.governanceRecovery = recovery;\n}\n\n/**\n * Run one complete SDK task under the caller's absolute wall-clock deadline.\n *\n * The consumed timeout is removed from the nested options so lower layers do\n * not start a second deadline. They still receive the composed signal, while\n * `workingTimeout` remains the transport's separate resettable idle timeout.\n */\nexport async function withTaskDeadline<T, TOptions extends TaskOptions = TaskOptions>(\n  options: TOptions | undefined,\n  run: (effectiveOptions: DeadlineTaskOptions<TOptions>) => Promise<T>\n): Promise<T> {\n  const existing = options as DeadlineTaskOptions<TOptions> | undefined;\n  const taskId = existing?.[TASK_OPERATION_ID] ?? randomUUID();\n  const timeout = options?.timeout;\n  const baseOptions = { ...options, timeout: undefined, [TASK_OPERATION_ID]: taskId } as DeadlineTaskOptions<TOptions>;\n  throwIfAborted(options?.signal);\n  if (timeout === undefined || timeout === 0) return run(baseOptions);\n\n  if (!Number.isFinite(timeout) || timeout < 0 || timeout > MAX_TIMER_DELAY_MS) {\n    throw new RangeError(`timeout must be a finite non-negative number <= ${MAX_TIMER_DELAY_MS}`);\n  }\n\n  const timeoutError = new TaskTimeoutError(taskId, timeout);\n  return withAbortSignal(\n    [options?.signal],\n    timeout,\n    signal =>\n      run({\n        ...baseOptions,\n        signal,\n        [TASK_DEADLINE_ERROR]: timeoutError,\n      }),\n    { timeoutError }\n  );\n}\n"],"mappings":"AAAA,SAAS,kBAAkB;AAE3B,SAAS,wBAAwD;AACjE,SAAS,oBAAoB,gBAAgB,uBAAuB;AAGpE,MAAM,oBAAoB,uBAAO,sBAAsB;AACvD,MAAM,sBAAsB,uBAAO,wBAAwB;AAOpD,SAAS,mBAAmB,SAAsD;AACvF,SAAQ,UAA8C,iBAAiB;AACzE;AAEO,SAAS,iCAAiC,SAAsB,gBAA8B;AACnG,QAAM,QAAS,QAAgC,mBAAmB;AAClE,MAAI,CAAC,MAAO;AACZ,QAAM,kBAAkB;AACxB,QAAM,iBAAiB;AACzB;AAEO,SAAS,qCAAqC,SAAsB,UAA2C;AACpH,QAAM,QAAS,QAAgC,mBAAmB;AAClE,MAAI,MAAO,OAAM,qBAAqB;AACxC;AASA,eAAsB,iBACpB,SACA,KACY;AACZ,QAAM,WAAW;AACjB,QAAM,SAAS,WAAW,iBAAiB,KAAK,WAAW;AAC3D,QAAM,UAAU,SAAS;AACzB,QAAM,cAAc,EAAE,GAAG,SAAS,SAAS,QAAW,CAAC,iBAAiB,GAAG,OAAO;AAClF,iBAAe,SAAS,MAAM;AAC9B,MAAI,YAAY,UAAa,YAAY,EAAG,QAAO,IAAI,WAAW;AAElE,MAAI,CAAC,OAAO,SAAS,OAAO,KAAK,UAAU,KAAK,UAAU,oBAAoB;AAC5E,UAAM,IAAI,WAAW,mDAAmD,kBAAkB,EAAE;AAAA,EAC9F;AAEA,QAAM,eAAe,IAAI,iBAAiB,QAAQ,OAAO;AACzD,SAAO;AAAA,IACL,CAAC,SAAS,MAAM;AAAA,IAChB;AAAA,IACA,YACE,IAAI;AAAA,MACF,GAAG;AAAA,MACH;AAAA,MACA,CAAC,mBAAmB,GAAG;AAAA,IACzB,CAAC;AAAA,IACH,EAAE,aAAa;AAAA,EACjB;AACF;","names":[]}

package/dist/lib/errors/index.d.mts

@@ -9,10 +9,21 @@ export declare abstract class ADCPError extends Error {
 /**
  * Error thrown when a task times out
  */
+export interface GovernanceOutcomeRecovery {
+    checkId: string;
+    outcome?: 'completed' | 'failed';
+    outcomeIdempotencyKey?: string;
+}
 export declare class TaskTimeoutError extends ADCPError {
     readonly taskId: string;
     readonly timeout: number;
     readonly code = "TASK_TIMEOUT";
+    /** Retry-safety key for mutating requests that reached dispatch. */
+    idempotency_key?: string;
+    /** Camel-case compatibility alias for `idempotency_key`. */
+    idempotencyKey?: string;
+    /** Retry identity when the deadline expires during governance postflight. */
+    governanceRecovery?: GovernanceOutcomeRecovery;
     constructor(taskId: string, timeout: number);
 }
 /**

package/dist/lib/errors/index.d.ts

@@ -9,10 +9,21 @@ export declare abstract class ADCPError extends Error {
 /**
  * Error thrown when a task times out
  */
+export interface GovernanceOutcomeRecovery {
+    checkId: string;
+    outcome?: 'completed' | 'failed';
+    outcomeIdempotencyKey?: string;
+}
 export declare class TaskTimeoutError extends ADCPError {
     readonly taskId: string;
     readonly timeout: number;
     readonly code = "TASK_TIMEOUT";
+    /** Retry-safety key for mutating requests that reached dispatch. */
+    idempotency_key?: string;
+    /** Camel-case compatibility alias for `idempotency_key`. */
+    idempotencyKey?: string;
+    /** Retry identity when the deadline expires during governance postflight. */
+    governanceRecovery?: GovernanceOutcomeRecovery;
     constructor(taskId: string, timeout: number);
 }
 /**

package/dist/lib/errors/index.d.ts.map

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

package/dist/lib/errors/index.js

@@ -65,6 +65,12 @@ class TaskTimeoutError extends ADCPError {
   taskId;
   timeout;
   code = "TASK_TIMEOUT";
+  /** Retry-safety key for mutating requests that reached dispatch. */
+  idempotency_key;
+  /** Camel-case compatibility alias for `idempotency_key`. */
+  idempotencyKey;
+  /** Retry identity when the deadline expires during governance postflight. */
+  governanceRecovery;
 }
 class MaxClarificationError extends ADCPError {
   constructor(taskId, maxAttempts) {

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

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

package/dist/lib/errors/index.mjs

@@ -15,6 +15,12 @@ class TaskTimeoutError extends ADCPError {
   taskId;
   timeout;
   code = "TASK_TIMEOUT";
+  /** Retry-safety key for mutating requests that reached dispatch. */
+  idempotency_key;
+  /** Camel-case compatibility alias for `idempotency_key`. */
+  idempotencyKey;
+  /** Retry identity when the deadline expires during governance postflight. */
+  governanceRecovery;
 }
 class MaxClarificationError extends ADCPError {
   constructor(taskId, maxAttempts) {