Type Alias RetryDecision

Type Declaration

• {
      action: "retry";
      delayMs: number;
      attemptCap: number;
      sameIdempotencyKey: true;
      reason: string;
  }

  • action: "retry"

  • delayMs: number

    Delay before the retry, in milliseconds. Honors error.retry_after when present.

  • attemptCap: number

    Maximum attempts (including the original) before escalating.

  • sameIdempotencyKey: true

    Caller MUST replay with the same idempotency_key.

  • reason: string

• {
      action: "mutate-and-retry";
      delayMs: number;
      attemptCap: number;
      sameIdempotencyKey: false;
      reason:
          | "redirect"
          | "budget"
          | "requote"
          | "validation"
          | "capability"
          | "state";
      field?: string;
      suggestion?: string;
  }

  • action: "mutate-and-retry"

  • delayMs: number

    Suggested pre-retry delay in milliseconds. Lightweight jitter so fleet operators don't all hit the seller in the same instant after a correlated storm (e.g., PROPOSAL_EXPIRED across thousands of campaigns at once).

  • attemptCap: number

    Maximum attempts (including the original) before escalating.

  • sameIdempotencyKey: false

    Caller MUST mint a fresh idempotency_key because the payload changes.

  • reason: "redirect" | "budget" | "requote" | "validation" | "capability" | "state"

  • Optionalfield?: string

    The field the seller flagged. Mirrors error.field.

  • Optionalsuggestion?: string

    The seller's correction hint. Mirrors error.suggestion.

• {
      action: "escalate";
      reason:
          | "commercial"
          | "auth"
          | "governance_unreachable"
          | "idempotency_check_required"
          | "capability"
          | "terminal"
          | "attempts_exhausted"
          | "unknown";
      message: string;
      details?: Record<string, unknown>;
      missing_connections?: unknown[];
      authorization_url?: string;
      authorization_instructions?: string;
  }

  • action: "escalate"

  • reason:
        | "commercial"
        | "auth"
        | "governance_unreachable"
        | "idempotency_check_required"
        | "capability"
        | "terminal"
        | "attempts_exhausted"
        | "unknown"

  • message: string

    Human-facing message. Mirrors error.message.

  • Optionaldetails?: Record<string, unknown>

    Safe code-specific details for UX routing. Currently populated for AUTHORIZATION_REQUIRED after the same allowlist/sanitizer used on server error envelopes.

  • Optionalmissing_connections?: unknown[]

    Convenience mirror of details.missing_connections for auth UX handoffs.

  • Optionalauthorization_url?: string

    Convenience auth URL, from top-level details or the first missing connection that provides one.

  • Optionalauthorization_instructions?: string

    Convenience auth instructions, from top-level details or the first missing connection that provides them.