@witqq/agent-sdk 0.6.1 → 0.8.0

package/dist/chat/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/errors.ts","../../src/errors.ts","../../src/chat/errors.ts"],"names":["ErrorCode"],"mappings":"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","file":"errors.cjs","sourcesContent":["// ─── Unified Error Code Enum ───────────────────────────────────\n\n/** Unified error codes for all SDK errors — single source of truth. */\nexport enum ErrorCode {\n  // Auth\n  AUTH_EXPIRED = \"AUTH_EXPIRED\",\n  AUTH_INVALID = \"AUTH_INVALID\",\n\n  // Rate limiting\n  RATE_LIMIT = \"RATE_LIMIT\",\n\n  // Network\n  NETWORK = \"NETWORK\",\n  TIMEOUT = \"TIMEOUT\",\n\n  // Provider\n  PROVIDER_ERROR = \"PROVIDER_ERROR\",\n  MODEL_NOT_FOUND = \"MODEL_NOT_FOUND\",\n  MODEL_OVERLOADED = \"MODEL_OVERLOADED\",\n  CONTEXT_OVERFLOW = \"CONTEXT_OVERFLOW\",\n\n  // Input / Response\n  INVALID_INPUT = \"INVALID_INPUT\",\n  INVALID_RESPONSE = \"INVALID_RESPONSE\",\n\n  // SDK internal\n  REENTRANCY = \"REENTRANCY\",\n  DISPOSED = \"DISPOSED\",\n  ABORTED = \"ABORTED\",\n  INVALID_TRANSITION = \"INVALID_TRANSITION\",\n  DEPENDENCY_MISSING = \"DEPENDENCY_MISSING\",\n  BACKEND_NOT_INSTALLED = \"BACKEND_NOT_INSTALLED\",\n\n  // Tool\n  TOOL_EXECUTION = \"TOOL_EXECUTION\",\n  PERMISSION_DENIED = \"PERMISSION_DENIED\",\n\n  // Session\n  SESSION_NOT_FOUND = \"SESSION_NOT_FOUND\",\n  SESSION_EXPIRED = \"SESSION_EXPIRED\",\n\n  // Provider resolution\n  PROVIDER_NOT_FOUND = \"PROVIDER_NOT_FOUND\",\n  AUTH_REQUIRED = \"AUTH_REQUIRED\",\n\n  // Storage (generic)\n  STORAGE_ERROR = \"STORAGE_ERROR\",\n  // Storage (specific)\n  STORAGE_NOT_FOUND = \"STORAGE_NOT_FOUND\",\n  STORAGE_DUPLICATE_KEY = \"STORAGE_DUPLICATE_KEY\",\n  STORAGE_IO_ERROR = \"STORAGE_IO_ERROR\",\n  STORAGE_SERIALIZATION_ERROR = \"STORAGE_SERIALIZATION_ERROR\",\n}\n\n// ─── Classification ────────────────────────────────────────────\n\n/** Error codes that are typically recoverable (retry-safe) */\nconst RECOVERABLE_CODES = new Set<ErrorCode>([\n  ErrorCode.TIMEOUT,\n  ErrorCode.RATE_LIMIT,\n  ErrorCode.NETWORK,\n  ErrorCode.TOOL_EXECUTION,\n  ErrorCode.MODEL_OVERLOADED,\n  ErrorCode.PROVIDER_ERROR,\n]);\n\n/** Check if an error code is recoverable */\nexport function isRecoverableErrorCode(code: ErrorCode): boolean {\n  return RECOVERABLE_CODES.has(code);\n}\n\n/** Classify an error message string into an ErrorCode */\nexport function classifyAgentError(error: string | Error): ErrorCode {\n  const msg = (error instanceof Error ? error.message : error).toLowerCase();\n\n  if (msg.includes(\"timeout\") || msg.includes(\"timed out\") || msg.includes(\"timedout\") || msg.includes(\"etimedout\")) {\n    return ErrorCode.TIMEOUT;\n  }\n\n  if (msg.includes(\"rate limit\") || msg.includes(\"rate_limit\") || msg.includes(\"429\") || msg.includes(\"too many requests\")) {\n    return ErrorCode.RATE_LIMIT;\n  }\n\n  if (msg.includes(\"unauthorized\") || msg.includes(\"401\") || msg.includes(\"auth\") && (msg.includes(\"expired\") || msg.includes(\"invalid\") || msg.includes(\"denied\") || msg.includes(\"failed\"))) {\n    return ErrorCode.AUTH_EXPIRED;\n  }\n\n  if (msg.includes(\"econnrefused\") || msg.includes(\"econnreset\") || msg.includes(\"enotfound\") || msg.includes(\"network\") || msg.includes(\"fetch failed\") || msg.includes(\"socket hang up\")) {\n    return ErrorCode.NETWORK;\n  }\n\n  if (msg.includes(\"subprocess\") || msg.includes(\"process exited\") || msg.includes(\"spawn\") || msg.includes(\"enoent\") || msg.includes(\"killed\")) {\n    return ErrorCode.DEPENDENCY_MISSING;\n  }\n\n  if (msg.includes(\"abort\") || msg.includes(\"cancel\")) {\n    return ErrorCode.ABORTED;\n  }\n\n  if (msg.includes(\"500\") || msg.includes(\"502\") || msg.includes(\"503\") || msg.includes(\"internal server error\") || msg.includes(\"service unavailable\") || msg.includes(\"bad gateway\") || msg.includes(\"overloaded\")) {\n    return ErrorCode.PROVIDER_ERROR;\n  }\n\n  return ErrorCode.PROVIDER_ERROR;\n}\n","import { ErrorCode } from \"./types/errors.js\";\n\n/** Options for constructing an AgentSDKError */\nexport interface AgentSDKErrorOptions extends ErrorOptions {\n  /** Machine-readable error code */\n  code?: string;\n  /** Whether this error is retryable (default: false) */\n  retryable?: boolean;\n  /** HTTP status code hint (e.g. 401, 429, 500) */\n  httpStatus?: number;\n}\n\n/** Base error class for agent-sdk.\n *\n * Use `AgentSDKError.is(err)` for reliable cross-module `instanceof` checks\n * (works across separately bundled entry points where `instanceof` may fail). */\nexport class AgentSDKError extends Error {\n  /** @internal Marker for cross-bundle identity checks */\n  readonly _agentSDKError = true as const;\n  /** Machine-readable error code. Prefer values from the ErrorCode enum. */\n  readonly code?: string;\n  /** Whether this error is safe to retry */\n  readonly retryable: boolean;\n  /** HTTP status code hint for error classification */\n  readonly httpStatus?: number;\n\n  constructor(message: string, options?: AgentSDKErrorOptions) {\n    super(message, options);\n    this.name = \"AgentSDKError\";\n    this.code = options?.code;\n    this.retryable = options?.retryable ?? false;\n    this.httpStatus = options?.httpStatus;\n  }\n\n  /** Check if an error is an AgentSDKError (works across bundled copies) */\n  static is(error: unknown): error is AgentSDKError {\n    return (\n      error instanceof Error &&\n      \"_agentSDKError\" in error &&\n      (error as AgentSDKError)._agentSDKError === true\n    );\n  }\n}\n\n/** Thrown when agent.run() is called while already running (M8 re-entrancy guard) */\nexport class ReentrancyError extends AgentSDKError {\n  constructor() {\n    super(\"Agent is already running. Await the current run before starting another.\", {\n      code: ErrorCode.REENTRANCY,\n    });\n    this.name = \"ReentrancyError\";\n  }\n}\n\n/** Thrown when an operation is attempted on a disposed agent/service */\nexport class DisposedError extends AgentSDKError {\n  constructor(entity: string) {\n    super(`${entity} has been disposed and cannot be used.`, {\n      code: ErrorCode.DISPOSED,\n    });\n    this.name = \"DisposedError\";\n  }\n}\n\n/** Thrown when a backend is not found in the registry */\nexport class BackendNotFoundError extends AgentSDKError {\n  constructor(backend: string) {\n    super(\n      `Unknown backend: \"${backend}\". ` +\n      `Built-in: copilot, claude, vercel-ai. ` +\n      `Custom: use registerBackend() first.`,\n      { code: ErrorCode.BACKEND_NOT_INSTALLED },\n    );\n    this.name = \"BackendNotFoundError\";\n  }\n}\n\n/** Thrown when a backend is already registered */\nexport class BackendAlreadyRegisteredError extends AgentSDKError {\n  constructor(backend: string) {\n    super(`Backend \"${backend}\" is already registered. Use a different name or unregister first.`);\n    this.name = \"BackendAlreadyRegisteredError\";\n  }\n}\n\n/** Thrown when subprocess management fails */\nexport class SubprocessError extends AgentSDKError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, { ...options, code: ErrorCode.DEPENDENCY_MISSING });\n    this.name = \"SubprocessError\";\n  }\n}\n\n/** Thrown when a required peer dependency is not installed */\nexport class DependencyError extends AgentSDKError {\n  public readonly packageName: string;\n\n  constructor(packageName: string) {\n    super(`${packageName} is not installed. Install it: npm install ${packageName}`, {\n      code: ErrorCode.DEPENDENCY_MISSING,\n    });\n    this.name = \"DependencyError\";\n    this.packageName = packageName;\n  }\n}\n\n/** Thrown when an agent run is aborted */\nexport class AbortError extends AgentSDKError {\n  constructor() {\n    super(\"Agent run was aborted.\", { code: ErrorCode.ABORTED });\n    this.name = \"AbortError\";\n  }\n}\n\n/** Thrown when a tool execution fails */\nexport class ToolExecutionError extends AgentSDKError {\n  public readonly toolName: string;\n\n  constructor(toolName: string, message: string, options?: ErrorOptions) {\n    super(`Tool \"${toolName}\" failed: ${message}`, { ...options, code: ErrorCode.TOOL_EXECUTION });\n    this.name = \"ToolExecutionError\";\n    this.toolName = toolName;\n  }\n}\n\n/** Thrown when a stream has no activity within the configured timeout */\nexport class ActivityTimeoutError extends AgentSDKError {\n  constructor(timeoutMs: number) {\n    super(`Stream activity timeout: no event received within ${timeoutMs}ms.`, {\n      code: ErrorCode.TIMEOUT,\n      retryable: true,\n    });\n    this.name = \"ActivityTimeoutError\";\n  }\n}\n\n/** Thrown when structured output parsing fails */\nexport class StructuredOutputError extends AgentSDKError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(`Structured output error: ${message}`, { ...options, code: ErrorCode.INVALID_RESPONSE });\n    this.name = \"StructuredOutputError\";\n  }\n}\n","/**\n * @witqq/agent-sdk/chat/errors\n *\n * Flat error taxonomy with unified ErrorCode enum, ChatError class,\n * pattern-matching classifier, retry strategies with exponential backoff.\n * Extends the existing AgentSDKError from @witqq/agent-sdk.\n */\n\nimport { AgentSDKError } from \"../errors.js\";\nimport { ErrorCode } from \"../types/errors.js\";\n\n// ─── Re-export ErrorCode ───────────────────────────────────────\n\nexport { ErrorCode };\n\n// ─── Error Options ─────────────────────────────────────────────\n\n/** Options for constructing a ChatError */\nexport interface ChatErrorOptions {\n  /** Machine-readable error code */\n  code: ErrorCode;\n  /** Whether this error is retryable (default: false) */\n  retryable?: boolean;\n  /** Retry delay hint in milliseconds */\n  retryAfter?: number;\n  /** Original cause, if wrapping another error */\n  cause?: unknown;\n}\n\n// ─── Unified Error Class ───────────────────────────────────────\n\n/** Unified error class for all chat SDK errors */\nexport class ChatError extends AgentSDKError {\n  readonly code: ErrorCode;\n  readonly retryable: boolean;\n  readonly retryAfter?: number;\n  readonly timestamp: string;\n\n  constructor(message: string, options: ChatErrorOptions) {\n    super(message, {\n      cause: options.cause,\n      code: options.code,\n      retryable: options.retryable,\n    });\n    this.name = \"ChatError\";\n    this.code = options.code;\n    this.retryable = options.retryable ?? false;\n    this.retryAfter = options.retryAfter;\n    this.timestamp = new Date().toISOString();\n  }\n}\n\n// ─── Classification ────────────────────────────────────────────\n\n/**\n * Classify an unknown thrown value into a ChatError with the appropriate code.\n * Pattern-matches against common error shapes:\n * - Already a ChatError → returned as-is\n * - Fetch/network errors (ECONNREFUSED, ETIMEDOUT, etc.)\n * - HTTP status codes (401→AUTH_INVALID, 429→RATE_LIMIT, 5xx→PROVIDER_ERROR)\n * - Timeout patterns\n * - Zod validation errors\n * - Context overflow patterns\n * - Unknown → wrapped as ChatError with PROVIDER_ERROR\n *\n * @param error - The thrown value to classify\n * @returns ChatError with appropriate error code and retryable flag\n */\nexport function classifyError(error: unknown): ChatError {\n  if (error instanceof ChatError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    const msg = error.message.toLowerCase();\n\n    // Network errors\n    if (isNetworkError(msg)) {\n      return new ChatError(error.message, {\n        code: ErrorCode.NETWORK,\n        retryable: true,\n        cause: error,\n      });\n    }\n\n    // Timeout errors\n    if (isTimeoutPattern(msg)) {\n      return new ChatError(error.message, {\n        code: ErrorCode.TIMEOUT,\n        retryable: true,\n        cause: error,\n      });\n    }\n\n    // Zod validation errors\n    if (isZodError(error)) {\n      return new ChatError(error.message, {\n        code: ErrorCode.INVALID_INPUT,\n        retryable: false,\n        cause: error,\n      });\n    }\n\n    // HTTP status code errors\n    const statusCode = extractStatusCode(error);\n    if (statusCode !== null) {\n      return classifyByStatusCode(statusCode, error);\n    }\n\n    // Context overflow patterns\n    if (isContextOverflow(msg)) {\n      return new ChatError(error.message, {\n        code: ErrorCode.CONTEXT_OVERFLOW,\n        retryable: false,\n        cause: error,\n      });\n    }\n  }\n\n  // Unknown errors\n  const message =\n    error instanceof Error ? error.message : String(error);\n  return new ChatError(message, {\n    code: ErrorCode.PROVIDER_ERROR,\n    retryable: false,\n    cause: error,\n  });\n}\n\n// ─── Classification Helpers ────────────────────────────────────\n\nconst NETWORK_PATTERNS = [\n  \"econnrefused\",\n  \"econnreset\",\n  \"enotfound\",\n  \"etimedout\",\n  \"enetunreach\",\n  \"epipe\",\n  \"fetch failed\",\n  \"network error\",\n  \"network request failed\",\n  \"failed to fetch\",\n  \"dns lookup failed\",\n] as const;\n\nfunction isNetworkError(msg: string): boolean {\n  return NETWORK_PATTERNS.some((p) => msg.includes(p));\n}\n\nfunction isTimeoutPattern(msg: string): boolean {\n  return (\n    msg.includes(\"timeout\") ||\n    msg.includes(\"timed out\") ||\n    msg.includes(\"deadline exceeded\") ||\n    msg.includes(\"aborted due to timeout\")\n  );\n}\n\nfunction isZodError(error: Error): boolean {\n  return (\n    error.name === \"ZodError\" ||\n    (\"issues\" in error && Array.isArray((error as unknown as Record<string, unknown>).issues))\n  );\n}\n\nfunction extractStatusCode(error: Error): number | null {\n  const errRecord = error as unknown as Record<string, unknown>;\n  if (typeof errRecord.status === \"number\") return errRecord.status;\n  if (typeof errRecord.statusCode === \"number\") return errRecord.statusCode;\n\n  // Check message for HTTP status codes\n  const match = error.message.match(/\\b(4\\d{2}|5\\d{2})\\b/);\n  return match ? parseInt(match[1], 10) : null;\n}\n\nfunction classifyByStatusCode(status: number, error: Error): ChatError {\n  if (status === 401 || status === 403) {\n    return new ChatError(error.message, {\n      code: ErrorCode.AUTH_INVALID,\n      retryable: false,\n      cause: error,\n    });\n  }\n  if (status === 429) {\n    const retryAfterSeconds = extractRetryAfter(error);\n    return new ChatError(error.message, {\n      code: ErrorCode.RATE_LIMIT,\n      retryable: true,\n      retryAfter: retryAfterSeconds != null ? retryAfterSeconds * 1000 : undefined,\n      cause: error,\n    });\n  }\n  if (status >= 500) {\n    return new ChatError(error.message, {\n      code: ErrorCode.PROVIDER_ERROR,\n      retryable: true,\n      cause: error,\n    });\n  }\n  // 4xx other than auth/rate-limit → invalid input\n  if (status >= 400 && status < 500) {\n    return new ChatError(error.message, {\n      code: ErrorCode.INVALID_INPUT,\n      retryable: false,\n      cause: error,\n    });\n  }\n  return new ChatError(error.message, {\n    code: ErrorCode.NETWORK,\n    retryable: true,\n    cause: error,\n  });\n}\n\nfunction extractRetryAfter(error: Error): number | undefined {\n  const errRecord = error as unknown as Record<string, unknown>;\n  if (typeof errRecord.retryAfter === \"number\") return errRecord.retryAfter;\n  const match = error.message.match(/retry.after[:\\s]*(\\d+)/i);\n  return match ? parseInt(match[1], 10) : undefined;\n}\n\nfunction isContextOverflow(msg: string): boolean {\n  return (\n    msg.includes(\"context length exceeded\") ||\n    msg.includes(\"maximum context length\") ||\n    msg.includes(\"context window\") ||\n    msg.includes(\"token limit\") ||\n    msg.includes(\"too many tokens\")\n  );\n}\n\n// ─── Retry Strategy ────────────────────────────────────────────\n\n/** Strategy for computing retry delays */\nexport interface RetryStrategy {\n  /** Return delay in ms for the given attempt (0-based), or null to stop */\n  nextDelay(attempt: number, error: ChatError): number | null;\n}\n\n/** Options for ExponentialBackoffStrategy */\nexport interface ExponentialBackoffOptions {\n  /** Base delay in ms (default: 1000) */\n  baseMs?: number;\n  /** Maximum delay in ms (default: 30000) */\n  maxMs?: number;\n  /** Maximum number of attempts (default: 3) */\n  maxAttempts?: number;\n  /** Jitter factor 0–1 (default: 0.1) */\n  jitter?: number;\n}\n\n/** Exponential backoff with optional jitter */\nexport class ExponentialBackoffStrategy implements RetryStrategy {\n  private readonly baseMs: number;\n  private readonly maxMs: number;\n  private readonly maxAttempts: number;\n  private readonly jitter: number;\n\n  constructor(options?: ExponentialBackoffOptions) {\n    this.baseMs = options?.baseMs ?? 1000;\n    this.maxMs = options?.maxMs ?? 30000;\n    this.maxAttempts = options?.maxAttempts ?? 3;\n    this.jitter = Math.max(0, Math.min(1, options?.jitter ?? 0.1));\n  }\n\n  nextDelay(attempt: number, error: ChatError): number | null {\n    if (attempt >= this.maxAttempts) return null;\n    if (!error.retryable) return null;\n\n    // Rate-limit errors with retryAfter (already in ms) take priority\n    if (error.code === ErrorCode.RATE_LIMIT && error.retryAfter) {\n      return error.retryAfter;\n    }\n\n    const delay = Math.min(this.baseMs * Math.pow(2, attempt), this.maxMs);\n    const jitterAmount = delay * this.jitter * (Math.random() * 2 - 1);\n    return Math.max(0, Math.round(delay + jitterAmount));\n  }\n}\n\n// ─── Retry Execution ───────────────────────────────────────────\n\n/** Options for withRetry execution */\nexport interface RetryOptions {\n  /** Abort signal to cancel retries */\n  signal?: AbortSignal;\n  /** Called before each retry with the error and delay */\n  onRetry?: (error: ChatError, attempt: number, delayMs: number) => void;\n}\n\n/**\n * Execute an async function with automatic retries using the provided strategy.\n * Respects ChatError.retryable and ChatError.retryAfter.\n * Classifies non-ChatError errors before deciding on retry.\n *\n * @param fn - Async function to execute\n * @param strategy - Retry strategy providing delay calculations\n * @param options - Optional abort signal and retry callback\n * @returns Result of fn on success\n * @throws ChatError when all retries exhausted or error is non-retryable\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  strategy: RetryStrategy,\n  options?: RetryOptions,\n): Promise<T> {\n  let attempt = 0;\n\n  for (;;) {\n    try {\n      return await fn();\n    } catch (raw) {\n      const error = classifyError(raw);\n      const delay = strategy.nextDelay(attempt, error);\n\n      if (delay === null) {\n        throw error;\n      }\n\n      if (options?.signal?.aborted) {\n        throw error;\n      }\n\n      options?.onRetry?.(error, attempt, delay);\n\n      await sleep(delay, options?.signal);\n      attempt++;\n    }\n  }\n}\n\n/**\n * Type guard: check if an error is retryable\n * @param error - The error to check\n * @returns True if error is a retryable ChatError\n */\nexport function isRetryable(error: unknown): boolean {\n  if (error instanceof ChatError) {\n    return error.retryable;\n  }\n  const classified = classifyError(error);\n  return classified.retryable;\n}\n\n// ─── Internal Helpers ──────────────────────────────────────────\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new ChatError(\"Retry aborted\", { code: ErrorCode.ABORTED }));\n      return;\n    }\n\n    const timer = setTimeout(resolve, ms);\n\n    signal?.addEventListener(\n      \"abort\",\n      () => {\n        clearTimeout(timer);\n        reject(new ChatError(\"Retry aborted\", { code: ErrorCode.ABORTED }));\n      },\n      { once: true },\n    );\n  });\n}\n"]}

package/dist/chat/errors.d.cts

@@ -0,0 +1,97 @@
+import { A as AgentSDKError } from '../errors-CmVvczxZ.cjs';
+import { E as ErrorCode } from '../errors-C-so0M4t.cjs';
+
+/**
+ * @witqq/agent-sdk/chat/errors
+ *
+ * Flat error taxonomy with unified ErrorCode enum, ChatError class,
+ * pattern-matching classifier, retry strategies with exponential backoff.
+ * Extends the existing AgentSDKError from @witqq/agent-sdk.
+ */
+
+/** Options for constructing a ChatError */
+interface ChatErrorOptions {
+    /** Machine-readable error code */
+    code: ErrorCode;
+    /** Whether this error is retryable (default: false) */
+    retryable?: boolean;
+    /** Retry delay hint in milliseconds */
+    retryAfter?: number;
+    /** Original cause, if wrapping another error */
+    cause?: unknown;
+}
+/** Unified error class for all chat SDK errors */
+declare class ChatError extends AgentSDKError {
+    readonly code: ErrorCode;
+    readonly retryable: boolean;
+    readonly retryAfter?: number;
+    readonly timestamp: string;
+    constructor(message: string, options: ChatErrorOptions);
+}
+/**
+ * Classify an unknown thrown value into a ChatError with the appropriate code.
+ * Pattern-matches against common error shapes:
+ * - Already a ChatError → returned as-is
+ * - Fetch/network errors (ECONNREFUSED, ETIMEDOUT, etc.)
+ * - HTTP status codes (401→AUTH_INVALID, 429→RATE_LIMIT, 5xx→PROVIDER_ERROR)
+ * - Timeout patterns
+ * - Zod validation errors
+ * - Context overflow patterns
+ * - Unknown → wrapped as ChatError with PROVIDER_ERROR
+ *
+ * @param error - The thrown value to classify
+ * @returns ChatError with appropriate error code and retryable flag
+ */
+declare function classifyError(error: unknown): ChatError;
+/** Strategy for computing retry delays */
+interface RetryStrategy {
+    /** Return delay in ms for the given attempt (0-based), or null to stop */
+    nextDelay(attempt: number, error: ChatError): number | null;
+}
+/** Options for ExponentialBackoffStrategy */
+interface ExponentialBackoffOptions {
+    /** Base delay in ms (default: 1000) */
+    baseMs?: number;
+    /** Maximum delay in ms (default: 30000) */
+    maxMs?: number;
+    /** Maximum number of attempts (default: 3) */
+    maxAttempts?: number;
+    /** Jitter factor 0–1 (default: 0.1) */
+    jitter?: number;
+}
+/** Exponential backoff with optional jitter */
+declare class ExponentialBackoffStrategy implements RetryStrategy {
+    private readonly baseMs;
+    private readonly maxMs;
+    private readonly maxAttempts;
+    private readonly jitter;
+    constructor(options?: ExponentialBackoffOptions);
+    nextDelay(attempt: number, error: ChatError): number | null;
+}
+/** Options for withRetry execution */
+interface RetryOptions {
+    /** Abort signal to cancel retries */
+    signal?: AbortSignal;
+    /** Called before each retry with the error and delay */
+    onRetry?: (error: ChatError, attempt: number, delayMs: number) => void;
+}
+/**
+ * Execute an async function with automatic retries using the provided strategy.
+ * Respects ChatError.retryable and ChatError.retryAfter.
+ * Classifies non-ChatError errors before deciding on retry.
+ *
+ * @param fn - Async function to execute
+ * @param strategy - Retry strategy providing delay calculations
+ * @param options - Optional abort signal and retry callback
+ * @returns Result of fn on success
+ * @throws ChatError when all retries exhausted or error is non-retryable
+ */
+declare function withRetry<T>(fn: () => Promise<T>, strategy: RetryStrategy, options?: RetryOptions): Promise<T>;
+/**
+ * Type guard: check if an error is retryable
+ * @param error - The error to check
+ * @returns True if error is a retryable ChatError
+ */
+declare function isRetryable(error: unknown): boolean;
+
+export { ChatError, type ChatErrorOptions, ErrorCode, type ExponentialBackoffOptions, ExponentialBackoffStrategy, type RetryOptions, type RetryStrategy, classifyError, isRetryable, withRetry };

package/dist/chat/errors.d.ts

@@ -0,0 +1,97 @@
+import { A as AgentSDKError } from '../errors-CmVvczxZ.js';
+import { E as ErrorCode } from '../errors-C-so0M4t.js';
+
+/**
+ * @witqq/agent-sdk/chat/errors
+ *
+ * Flat error taxonomy with unified ErrorCode enum, ChatError class,
+ * pattern-matching classifier, retry strategies with exponential backoff.
+ * Extends the existing AgentSDKError from @witqq/agent-sdk.
+ */
+
+/** Options for constructing a ChatError */
+interface ChatErrorOptions {
+    /** Machine-readable error code */
+    code: ErrorCode;
+    /** Whether this error is retryable (default: false) */
+    retryable?: boolean;
+    /** Retry delay hint in milliseconds */
+    retryAfter?: number;
+    /** Original cause, if wrapping another error */
+    cause?: unknown;
+}
+/** Unified error class for all chat SDK errors */
+declare class ChatError extends AgentSDKError {
+    readonly code: ErrorCode;
+    readonly retryable: boolean;
+    readonly retryAfter?: number;
+    readonly timestamp: string;
+    constructor(message: string, options: ChatErrorOptions);
+}
+/**
+ * Classify an unknown thrown value into a ChatError with the appropriate code.
+ * Pattern-matches against common error shapes:
+ * - Already a ChatError → returned as-is
+ * - Fetch/network errors (ECONNREFUSED, ETIMEDOUT, etc.)
+ * - HTTP status codes (401→AUTH_INVALID, 429→RATE_LIMIT, 5xx→PROVIDER_ERROR)
+ * - Timeout patterns
+ * - Zod validation errors
+ * - Context overflow patterns
+ * - Unknown → wrapped as ChatError with PROVIDER_ERROR
+ *
+ * @param error - The thrown value to classify
+ * @returns ChatError with appropriate error code and retryable flag
+ */
+declare function classifyError(error: unknown): ChatError;
+/** Strategy for computing retry delays */
+interface RetryStrategy {
+    /** Return delay in ms for the given attempt (0-based), or null to stop */
+    nextDelay(attempt: number, error: ChatError): number | null;
+}
+/** Options for ExponentialBackoffStrategy */
+interface ExponentialBackoffOptions {
+    /** Base delay in ms (default: 1000) */
+    baseMs?: number;
+    /** Maximum delay in ms (default: 30000) */
+    maxMs?: number;
+    /** Maximum number of attempts (default: 3) */
+    maxAttempts?: number;
+    /** Jitter factor 0–1 (default: 0.1) */
+    jitter?: number;
+}
+/** Exponential backoff with optional jitter */
+declare class ExponentialBackoffStrategy implements RetryStrategy {
+    private readonly baseMs;
+    private readonly maxMs;
+    private readonly maxAttempts;
+    private readonly jitter;
+    constructor(options?: ExponentialBackoffOptions);
+    nextDelay(attempt: number, error: ChatError): number | null;
+}
+/** Options for withRetry execution */
+interface RetryOptions {
+    /** Abort signal to cancel retries */
+    signal?: AbortSignal;
+    /** Called before each retry with the error and delay */
+    onRetry?: (error: ChatError, attempt: number, delayMs: number) => void;
+}
+/**
+ * Execute an async function with automatic retries using the provided strategy.
+ * Respects ChatError.retryable and ChatError.retryAfter.
+ * Classifies non-ChatError errors before deciding on retry.
+ *
+ * @param fn - Async function to execute
+ * @param strategy - Retry strategy providing delay calculations
+ * @param options - Optional abort signal and retry callback
+ * @returns Result of fn on success
+ * @throws ChatError when all retries exhausted or error is non-retryable
+ */
+declare function withRetry<T>(fn: () => Promise<T>, strategy: RetryStrategy, options?: RetryOptions): Promise<T>;
+/**
+ * Type guard: check if an error is retryable
+ * @param error - The error to check
+ * @returns True if error is a retryable ChatError
+ */
+declare function isRetryable(error: unknown): boolean;
+
+export { ChatError, type ChatErrorOptions, ErrorCode, type ExponentialBackoffOptions, ExponentialBackoffStrategy, type RetryOptions, type RetryStrategy, classifyError, isRetryable, withRetry };

package/dist/chat/errors.js

@@ -0,0 +1,266 @@
+// src/types/errors.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["AUTH_EXPIRED"] = "AUTH_EXPIRED";
+  ErrorCode2["AUTH_INVALID"] = "AUTH_INVALID";
+  ErrorCode2["RATE_LIMIT"] = "RATE_LIMIT";
+  ErrorCode2["NETWORK"] = "NETWORK";
+  ErrorCode2["TIMEOUT"] = "TIMEOUT";
+  ErrorCode2["PROVIDER_ERROR"] = "PROVIDER_ERROR";
+  ErrorCode2["MODEL_NOT_FOUND"] = "MODEL_NOT_FOUND";
+  ErrorCode2["MODEL_OVERLOADED"] = "MODEL_OVERLOADED";
+  ErrorCode2["CONTEXT_OVERFLOW"] = "CONTEXT_OVERFLOW";
+  ErrorCode2["INVALID_INPUT"] = "INVALID_INPUT";
+  ErrorCode2["INVALID_RESPONSE"] = "INVALID_RESPONSE";
+  ErrorCode2["REENTRANCY"] = "REENTRANCY";
+  ErrorCode2["DISPOSED"] = "DISPOSED";
+  ErrorCode2["ABORTED"] = "ABORTED";
+  ErrorCode2["INVALID_TRANSITION"] = "INVALID_TRANSITION";
+  ErrorCode2["DEPENDENCY_MISSING"] = "DEPENDENCY_MISSING";
+  ErrorCode2["BACKEND_NOT_INSTALLED"] = "BACKEND_NOT_INSTALLED";
+  ErrorCode2["TOOL_EXECUTION"] = "TOOL_EXECUTION";
+  ErrorCode2["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+  ErrorCode2["SESSION_NOT_FOUND"] = "SESSION_NOT_FOUND";
+  ErrorCode2["SESSION_EXPIRED"] = "SESSION_EXPIRED";
+  ErrorCode2["PROVIDER_NOT_FOUND"] = "PROVIDER_NOT_FOUND";
+  ErrorCode2["AUTH_REQUIRED"] = "AUTH_REQUIRED";
+  ErrorCode2["STORAGE_ERROR"] = "STORAGE_ERROR";
+  ErrorCode2["STORAGE_NOT_FOUND"] = "STORAGE_NOT_FOUND";
+  ErrorCode2["STORAGE_DUPLICATE_KEY"] = "STORAGE_DUPLICATE_KEY";
+  ErrorCode2["STORAGE_IO_ERROR"] = "STORAGE_IO_ERROR";
+  ErrorCode2["STORAGE_SERIALIZATION_ERROR"] = "STORAGE_SERIALIZATION_ERROR";
+  return ErrorCode2;
+})(ErrorCode || {});
+
+// src/errors.ts
+var AgentSDKError = class extends Error {
+  /** @internal Marker for cross-bundle identity checks */
+  _agentSDKError = true;
+  /** Machine-readable error code. Prefer values from the ErrorCode enum. */
+  code;
+  /** Whether this error is safe to retry */
+  retryable;
+  /** HTTP status code hint for error classification */
+  httpStatus;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "AgentSDKError";
+    this.code = options?.code;
+    this.retryable = options?.retryable ?? false;
+    this.httpStatus = options?.httpStatus;
+  }
+  /** Check if an error is an AgentSDKError (works across bundled copies) */
+  static is(error) {
+    return error instanceof Error && "_agentSDKError" in error && error._agentSDKError === true;
+  }
+};
+
+// src/chat/errors.ts
+var ChatError = class extends AgentSDKError {
+  code;
+  retryable;
+  retryAfter;
+  timestamp;
+  constructor(message, options) {
+    super(message, {
+      cause: options.cause,
+      code: options.code,
+      retryable: options.retryable
+    });
+    this.name = "ChatError";
+    this.code = options.code;
+    this.retryable = options.retryable ?? false;
+    this.retryAfter = options.retryAfter;
+    this.timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  }
+};
+function classifyError(error) {
+  if (error instanceof ChatError) {
+    return error;
+  }
+  if (error instanceof Error) {
+    const msg = error.message.toLowerCase();
+    if (isNetworkError(msg)) {
+      return new ChatError(error.message, {
+        code: "NETWORK" /* NETWORK */,
+        retryable: true,
+        cause: error
+      });
+    }
+    if (isTimeoutPattern(msg)) {
+      return new ChatError(error.message, {
+        code: "TIMEOUT" /* TIMEOUT */,
+        retryable: true,
+        cause: error
+      });
+    }
+    if (isZodError(error)) {
+      return new ChatError(error.message, {
+        code: "INVALID_INPUT" /* INVALID_INPUT */,
+        retryable: false,
+        cause: error
+      });
+    }
+    const statusCode = extractStatusCode(error);
+    if (statusCode !== null) {
+      return classifyByStatusCode(statusCode, error);
+    }
+    if (isContextOverflow(msg)) {
+      return new ChatError(error.message, {
+        code: "CONTEXT_OVERFLOW" /* CONTEXT_OVERFLOW */,
+        retryable: false,
+        cause: error
+      });
+    }
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  return new ChatError(message, {
+    code: "PROVIDER_ERROR" /* PROVIDER_ERROR */,
+    retryable: false,
+    cause: error
+  });
+}
+var NETWORK_PATTERNS = [
+  "econnrefused",
+  "econnreset",
+  "enotfound",
+  "etimedout",
+  "enetunreach",
+  "epipe",
+  "fetch failed",
+  "network error",
+  "network request failed",
+  "failed to fetch",
+  "dns lookup failed"
+];
+function isNetworkError(msg) {
+  return NETWORK_PATTERNS.some((p) => msg.includes(p));
+}
+function isTimeoutPattern(msg) {
+  return msg.includes("timeout") || msg.includes("timed out") || msg.includes("deadline exceeded") || msg.includes("aborted due to timeout");
+}
+function isZodError(error) {
+  return error.name === "ZodError" || "issues" in error && Array.isArray(error.issues);
+}
+function extractStatusCode(error) {
+  const errRecord = error;
+  if (typeof errRecord.status === "number") return errRecord.status;
+  if (typeof errRecord.statusCode === "number") return errRecord.statusCode;
+  const match = error.message.match(/\b(4\d{2}|5\d{2})\b/);
+  return match ? parseInt(match[1], 10) : null;
+}
+function classifyByStatusCode(status, error) {
+  if (status === 401 || status === 403) {
+    return new ChatError(error.message, {
+      code: "AUTH_INVALID" /* AUTH_INVALID */,
+      retryable: false,
+      cause: error
+    });
+  }
+  if (status === 429) {
+    const retryAfterSeconds = extractRetryAfter(error);
+    return new ChatError(error.message, {
+      code: "RATE_LIMIT" /* RATE_LIMIT */,
+      retryable: true,
+      retryAfter: retryAfterSeconds != null ? retryAfterSeconds * 1e3 : void 0,
+      cause: error
+    });
+  }
+  if (status >= 500) {
+    return new ChatError(error.message, {
+      code: "PROVIDER_ERROR" /* PROVIDER_ERROR */,
+      retryable: true,
+      cause: error
+    });
+  }
+  if (status >= 400 && status < 500) {
+    return new ChatError(error.message, {
+      code: "INVALID_INPUT" /* INVALID_INPUT */,
+      retryable: false,
+      cause: error
+    });
+  }
+  return new ChatError(error.message, {
+    code: "NETWORK" /* NETWORK */,
+    retryable: true,
+    cause: error
+  });
+}
+function extractRetryAfter(error) {
+  const errRecord = error;
+  if (typeof errRecord.retryAfter === "number") return errRecord.retryAfter;
+  const match = error.message.match(/retry.after[:\s]*(\d+)/i);
+  return match ? parseInt(match[1], 10) : void 0;
+}
+function isContextOverflow(msg) {
+  return msg.includes("context length exceeded") || msg.includes("maximum context length") || msg.includes("context window") || msg.includes("token limit") || msg.includes("too many tokens");
+}
+var ExponentialBackoffStrategy = class {
+  baseMs;
+  maxMs;
+  maxAttempts;
+  jitter;
+  constructor(options) {
+    this.baseMs = options?.baseMs ?? 1e3;
+    this.maxMs = options?.maxMs ?? 3e4;
+    this.maxAttempts = options?.maxAttempts ?? 3;
+    this.jitter = Math.max(0, Math.min(1, options?.jitter ?? 0.1));
+  }
+  nextDelay(attempt, error) {
+    if (attempt >= this.maxAttempts) return null;
+    if (!error.retryable) return null;
+    if (error.code === "RATE_LIMIT" /* RATE_LIMIT */ && error.retryAfter) {
+      return error.retryAfter;
+    }
+    const delay = Math.min(this.baseMs * Math.pow(2, attempt), this.maxMs);
+    const jitterAmount = delay * this.jitter * (Math.random() * 2 - 1);
+    return Math.max(0, Math.round(delay + jitterAmount));
+  }
+};
+async function withRetry(fn, strategy, options) {
+  let attempt = 0;
+  for (; ; ) {
+    try {
+      return await fn();
+    } catch (raw) {
+      const error = classifyError(raw);
+      const delay = strategy.nextDelay(attempt, error);
+      if (delay === null) {
+        throw error;
+      }
+      if (options?.signal?.aborted) {
+        throw error;
+      }
+      options?.onRetry?.(error, attempt, delay);
+      await sleep(delay, options?.signal);
+      attempt++;
+    }
+  }
+}
+function isRetryable(error) {
+  if (error instanceof ChatError) {
+    return error.retryable;
+  }
+  const classified = classifyError(error);
+  return classified.retryable;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(new ChatError("Retry aborted", { code: "ABORTED" /* ABORTED */ }));
+      return;
+    }
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(timer);
+        reject(new ChatError("Retry aborted", { code: "ABORTED" /* ABORTED */ }));
+      },
+      { once: true }
+    );
+  });
+}
+
+export { ChatError, ErrorCode, ExponentialBackoffStrategy, classifyError, isRetryable, withRetry };
+//# sourceMappingURL=errors.js.map
+//# sourceMappingURL=errors.js.map

package/dist/chat/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/errors.ts","../../src/errors.ts","../../src/chat/errors.ts"],"names":["ErrorCode"],"mappings":"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","file":"errors.js","sourcesContent":["// ─── Unified Error Code Enum ───────────────────────────────────\n\n/** Unified error codes for all SDK errors — single source of truth. */\nexport enum ErrorCode {\n  // Auth\n  AUTH_EXPIRED = \"AUTH_EXPIRED\",\n  AUTH_INVALID = \"AUTH_INVALID\",\n\n  // Rate limiting\n  RATE_LIMIT = \"RATE_LIMIT\",\n\n  // Network\n  NETWORK = \"NETWORK\",\n  TIMEOUT = \"TIMEOUT\",\n\n  // Provider\n  PROVIDER_ERROR = \"PROVIDER_ERROR\",\n  MODEL_NOT_FOUND = \"MODEL_NOT_FOUND\",\n  MODEL_OVERLOADED = \"MODEL_OVERLOADED\",\n  CONTEXT_OVERFLOW = \"CONTEXT_OVERFLOW\",\n\n  // Input / Response\n  INVALID_INPUT = \"INVALID_INPUT\",\n  INVALID_RESPONSE = \"INVALID_RESPONSE\",\n\n  // SDK internal\n  REENTRANCY = \"REENTRANCY\",\n  DISPOSED = \"DISPOSED\",\n  ABORTED = \"ABORTED\",\n  INVALID_TRANSITION = \"INVALID_TRANSITION\",\n  DEPENDENCY_MISSING = \"DEPENDENCY_MISSING\",\n  BACKEND_NOT_INSTALLED = \"BACKEND_NOT_INSTALLED\",\n\n  // Tool\n  TOOL_EXECUTION = \"TOOL_EXECUTION\",\n  PERMISSION_DENIED = \"PERMISSION_DENIED\",\n\n  // Session\n  SESSION_NOT_FOUND = \"SESSION_NOT_FOUND\",\n  SESSION_EXPIRED = \"SESSION_EXPIRED\",\n\n  // Provider resolution\n  PROVIDER_NOT_FOUND = \"PROVIDER_NOT_FOUND\",\n  AUTH_REQUIRED = \"AUTH_REQUIRED\",\n\n  // Storage (generic)\n  STORAGE_ERROR = \"STORAGE_ERROR\",\n  // Storage (specific)\n  STORAGE_NOT_FOUND = \"STORAGE_NOT_FOUND\",\n  STORAGE_DUPLICATE_KEY = \"STORAGE_DUPLICATE_KEY\",\n  STORAGE_IO_ERROR = \"STORAGE_IO_ERROR\",\n  STORAGE_SERIALIZATION_ERROR = \"STORAGE_SERIALIZATION_ERROR\",\n}\n\n// ─── Classification ────────────────────────────────────────────\n\n/** Error codes that are typically recoverable (retry-safe) */\nconst RECOVERABLE_CODES = new Set<ErrorCode>([\n  ErrorCode.TIMEOUT,\n  ErrorCode.RATE_LIMIT,\n  ErrorCode.NETWORK,\n  ErrorCode.TOOL_EXECUTION,\n  ErrorCode.MODEL_OVERLOADED,\n  ErrorCode.PROVIDER_ERROR,\n]);\n\n/** Check if an error code is recoverable */\nexport function isRecoverableErrorCode(code: ErrorCode): boolean {\n  return RECOVERABLE_CODES.has(code);\n}\n\n/** Classify an error message string into an ErrorCode */\nexport function classifyAgentError(error: string | Error): ErrorCode {\n  const msg = (error instanceof Error ? error.message : error).toLowerCase();\n\n  if (msg.includes(\"timeout\") || msg.includes(\"timed out\") || msg.includes(\"timedout\") || msg.includes(\"etimedout\")) {\n    return ErrorCode.TIMEOUT;\n  }\n\n  if (msg.includes(\"rate limit\") || msg.includes(\"rate_limit\") || msg.includes(\"429\") || msg.includes(\"too many requests\")) {\n    return ErrorCode.RATE_LIMIT;\n  }\n\n  if (msg.includes(\"unauthorized\") || msg.includes(\"401\") || msg.includes(\"auth\") && (msg.includes(\"expired\") || msg.includes(\"invalid\") || msg.includes(\"denied\") || msg.includes(\"failed\"))) {\n    return ErrorCode.AUTH_EXPIRED;\n  }\n\n  if (msg.includes(\"econnrefused\") || msg.includes(\"econnreset\") || msg.includes(\"enotfound\") || msg.includes(\"network\") || msg.includes(\"fetch failed\") || msg.includes(\"socket hang up\")) {\n    return ErrorCode.NETWORK;\n  }\n\n  if (msg.includes(\"subprocess\") || msg.includes(\"process exited\") || msg.includes(\"spawn\") || msg.includes(\"enoent\") || msg.includes(\"killed\")) {\n    return ErrorCode.DEPENDENCY_MISSING;\n  }\n\n  if (msg.includes(\"abort\") || msg.includes(\"cancel\")) {\n    return ErrorCode.ABORTED;\n  }\n\n  if (msg.includes(\"500\") || msg.includes(\"502\") || msg.includes(\"503\") || msg.includes(\"internal server error\") || msg.includes(\"service unavailable\") || msg.includes(\"bad gateway\") || msg.includes(\"overloaded\")) {\n    return ErrorCode.PROVIDER_ERROR;\n  }\n\n  return ErrorCode.PROVIDER_ERROR;\n}\n","import { ErrorCode } from \"./types/errors.js\";\n\n/** Options for constructing an AgentSDKError */\nexport interface AgentSDKErrorOptions extends ErrorOptions {\n  /** Machine-readable error code */\n  code?: string;\n  /** Whether this error is retryable (default: false) */\n  retryable?: boolean;\n  /** HTTP status code hint (e.g. 401, 429, 500) */\n  httpStatus?: number;\n}\n\n/** Base error class for agent-sdk.\n *\n * Use `AgentSDKError.is(err)` for reliable cross-module `instanceof` checks\n * (works across separately bundled entry points where `instanceof` may fail). */\nexport class AgentSDKError extends Error {\n  /** @internal Marker for cross-bundle identity checks */\n  readonly _agentSDKError = true as const;\n  /** Machine-readable error code. Prefer values from the ErrorCode enum. */\n  readonly code?: string;\n  /** Whether this error is safe to retry */\n  readonly retryable: boolean;\n  /** HTTP status code hint for error classification */\n  readonly httpStatus?: number;\n\n  constructor(message: string, options?: AgentSDKErrorOptions) {\n    super(message, options);\n    this.name = \"AgentSDKError\";\n    this.code = options?.code;\n    this.retryable = options?.retryable ?? false;\n    this.httpStatus = options?.httpStatus;\n  }\n\n  /** Check if an error is an AgentSDKError (works across bundled copies) */\n  static is(error: unknown): error is AgentSDKError {\n    return (\n      error instanceof Error &&\n      \"_agentSDKError\" in error &&\n      (error as AgentSDKError)._agentSDKError === true\n    );\n  }\n}\n\n/** Thrown when agent.run() is called while already running (M8 re-entrancy guard) */\nexport class ReentrancyError extends AgentSDKError {\n  constructor() {\n    super(\"Agent is already running. Await the current run before starting another.\", {\n      code: ErrorCode.REENTRANCY,\n    });\n    this.name = \"ReentrancyError\";\n  }\n}\n\n/** Thrown when an operation is attempted on a disposed agent/service */\nexport class DisposedError extends AgentSDKError {\n  constructor(entity: string) {\n    super(`${entity} has been disposed and cannot be used.`, {\n      code: ErrorCode.DISPOSED,\n    });\n    this.name = \"DisposedError\";\n  }\n}\n\n/** Thrown when a backend is not found in the registry */\nexport class BackendNotFoundError extends AgentSDKError {\n  constructor(backend: string) {\n    super(\n      `Unknown backend: \"${backend}\". ` +\n      `Built-in: copilot, claude, vercel-ai. ` +\n      `Custom: use registerBackend() first.`,\n      { code: ErrorCode.BACKEND_NOT_INSTALLED },\n    );\n    this.name = \"BackendNotFoundError\";\n  }\n}\n\n/** Thrown when a backend is already registered */\nexport class BackendAlreadyRegisteredError extends AgentSDKError {\n  constructor(backend: string) {\n    super(`Backend \"${backend}\" is already registered. Use a different name or unregister first.`);\n    this.name = \"BackendAlreadyRegisteredError\";\n  }\n}\n\n/** Thrown when subprocess management fails */\nexport class SubprocessError extends AgentSDKError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, { ...options, code: ErrorCode.DEPENDENCY_MISSING });\n    this.name = \"SubprocessError\";\n  }\n}\n\n/** Thrown when a required peer dependency is not installed */\nexport class DependencyError extends AgentSDKError {\n  public readonly packageName: string;\n\n  constructor(packageName: string) {\n    super(`${packageName} is not installed. Install it: npm install ${packageName}`, {\n      code: ErrorCode.DEPENDENCY_MISSING,\n    });\n    this.name = \"DependencyError\";\n    this.packageName = packageName;\n  }\n}\n\n/** Thrown when an agent run is aborted */\nexport class AbortError extends AgentSDKError {\n  constructor() {\n    super(\"Agent run was aborted.\", { code: ErrorCode.ABORTED });\n    this.name = \"AbortError\";\n  }\n}\n\n/** Thrown when a tool execution fails */\nexport class ToolExecutionError extends AgentSDKError {\n  public readonly toolName: string;\n\n  constructor(toolName: string, message: string, options?: ErrorOptions) {\n    super(`Tool \"${toolName}\" failed: ${message}`, { ...options, code: ErrorCode.TOOL_EXECUTION });\n    this.name = \"ToolExecutionError\";\n    this.toolName = toolName;\n  }\n}\n\n/** Thrown when a stream has no activity within the configured timeout */\nexport class ActivityTimeoutError extends AgentSDKError {\n  constructor(timeoutMs: number) {\n    super(`Stream activity timeout: no event received within ${timeoutMs}ms.`, {\n      code: ErrorCode.TIMEOUT,\n      retryable: true,\n    });\n    this.name = \"ActivityTimeoutError\";\n  }\n}\n\n/** Thrown when structured output parsing fails */\nexport class StructuredOutputError extends AgentSDKError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(`Structured output error: ${message}`, { ...options, code: ErrorCode.INVALID_RESPONSE });\n    this.name = \"StructuredOutputError\";\n  }\n}\n","/**\n * @witqq/agent-sdk/chat/errors\n *\n * Flat error taxonomy with unified ErrorCode enum, ChatError class,\n * pattern-matching classifier, retry strategies with exponential backoff.\n * Extends the existing AgentSDKError from @witqq/agent-sdk.\n */\n\nimport { AgentSDKError } from \"../errors.js\";\nimport { ErrorCode } from \"../types/errors.js\";\n\n// ─── Re-export ErrorCode ───────────────────────────────────────\n\nexport { ErrorCode };\n\n// ─── Error Options ─────────────────────────────────────────────\n\n/** Options for constructing a ChatError */\nexport interface ChatErrorOptions {\n  /** Machine-readable error code */\n  code: ErrorCode;\n  /** Whether this error is retryable (default: false) */\n  retryable?: boolean;\n  /** Retry delay hint in milliseconds */\n  retryAfter?: number;\n  /** Original cause, if wrapping another error */\n  cause?: unknown;\n}\n\n// ─── Unified Error Class ───────────────────────────────────────\n\n/** Unified error class for all chat SDK errors */\nexport class ChatError extends AgentSDKError {\n  readonly code: ErrorCode;\n  readonly retryable: boolean;\n  readonly retryAfter?: number;\n  readonly timestamp: string;\n\n  constructor(message: string, options: ChatErrorOptions) {\n    super(message, {\n      cause: options.cause,\n      code: options.code,\n      retryable: options.retryable,\n    });\n    this.name = \"ChatError\";\n    this.code = options.code;\n    this.retryable = options.retryable ?? false;\n    this.retryAfter = options.retryAfter;\n    this.timestamp = new Date().toISOString();\n  }\n}\n\n// ─── Classification ────────────────────────────────────────────\n\n/**\n * Classify an unknown thrown value into a ChatError with the appropriate code.\n * Pattern-matches against common error shapes:\n * - Already a ChatError → returned as-is\n * - Fetch/network errors (ECONNREFUSED, ETIMEDOUT, etc.)\n * - HTTP status codes (401→AUTH_INVALID, 429→RATE_LIMIT, 5xx→PROVIDER_ERROR)\n * - Timeout patterns\n * - Zod validation errors\n * - Context overflow patterns\n * - Unknown → wrapped as ChatError with PROVIDER_ERROR\n *\n * @param error - The thrown value to classify\n * @returns ChatError with appropriate error code and retryable flag\n */\nexport function classifyError(error: unknown): ChatError {\n  if (error instanceof ChatError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    const msg = error.message.toLowerCase();\n\n    // Network errors\n    if (isNetworkError(msg)) {\n      return new ChatError(error.message, {\n        code: ErrorCode.NETWORK,\n        retryable: true,\n        cause: error,\n      });\n    }\n\n    // Timeout errors\n    if (isTimeoutPattern(msg)) {\n      return new ChatError(error.message, {\n        code: ErrorCode.TIMEOUT,\n        retryable: true,\n        cause: error,\n      });\n    }\n\n    // Zod validation errors\n    if (isZodError(error)) {\n      return new ChatError(error.message, {\n        code: ErrorCode.INVALID_INPUT,\n        retryable: false,\n        cause: error,\n      });\n    }\n\n    // HTTP status code errors\n    const statusCode = extractStatusCode(error);\n    if (statusCode !== null) {\n      return classifyByStatusCode(statusCode, error);\n    }\n\n    // Context overflow patterns\n    if (isContextOverflow(msg)) {\n      return new ChatError(error.message, {\n        code: ErrorCode.CONTEXT_OVERFLOW,\n        retryable: false,\n        cause: error,\n      });\n    }\n  }\n\n  // Unknown errors\n  const message =\n    error instanceof Error ? error.message : String(error);\n  return new ChatError(message, {\n    code: ErrorCode.PROVIDER_ERROR,\n    retryable: false,\n    cause: error,\n  });\n}\n\n// ─── Classification Helpers ────────────────────────────────────\n\nconst NETWORK_PATTERNS = [\n  \"econnrefused\",\n  \"econnreset\",\n  \"enotfound\",\n  \"etimedout\",\n  \"enetunreach\",\n  \"epipe\",\n  \"fetch failed\",\n  \"network error\",\n  \"network request failed\",\n  \"failed to fetch\",\n  \"dns lookup failed\",\n] as const;\n\nfunction isNetworkError(msg: string): boolean {\n  return NETWORK_PATTERNS.some((p) => msg.includes(p));\n}\n\nfunction isTimeoutPattern(msg: string): boolean {\n  return (\n    msg.includes(\"timeout\") ||\n    msg.includes(\"timed out\") ||\n    msg.includes(\"deadline exceeded\") ||\n    msg.includes(\"aborted due to timeout\")\n  );\n}\n\nfunction isZodError(error: Error): boolean {\n  return (\n    error.name === \"ZodError\" ||\n    (\"issues\" in error && Array.isArray((error as unknown as Record<string, unknown>).issues))\n  );\n}\n\nfunction extractStatusCode(error: Error): number | null {\n  const errRecord = error as unknown as Record<string, unknown>;\n  if (typeof errRecord.status === \"number\") return errRecord.status;\n  if (typeof errRecord.statusCode === \"number\") return errRecord.statusCode;\n\n  // Check message for HTTP status codes\n  const match = error.message.match(/\\b(4\\d{2}|5\\d{2})\\b/);\n  return match ? parseInt(match[1], 10) : null;\n}\n\nfunction classifyByStatusCode(status: number, error: Error): ChatError {\n  if (status === 401 || status === 403) {\n    return new ChatError(error.message, {\n      code: ErrorCode.AUTH_INVALID,\n      retryable: false,\n      cause: error,\n    });\n  }\n  if (status === 429) {\n    const retryAfterSeconds = extractRetryAfter(error);\n    return new ChatError(error.message, {\n      code: ErrorCode.RATE_LIMIT,\n      retryable: true,\n      retryAfter: retryAfterSeconds != null ? retryAfterSeconds * 1000 : undefined,\n      cause: error,\n    });\n  }\n  if (status >= 500) {\n    return new ChatError(error.message, {\n      code: ErrorCode.PROVIDER_ERROR,\n      retryable: true,\n      cause: error,\n    });\n  }\n  // 4xx other than auth/rate-limit → invalid input\n  if (status >= 400 && status < 500) {\n    return new ChatError(error.message, {\n      code: ErrorCode.INVALID_INPUT,\n      retryable: false,\n      cause: error,\n    });\n  }\n  return new ChatError(error.message, {\n    code: ErrorCode.NETWORK,\n    retryable: true,\n    cause: error,\n  });\n}\n\nfunction extractRetryAfter(error: Error): number | undefined {\n  const errRecord = error as unknown as Record<string, unknown>;\n  if (typeof errRecord.retryAfter === \"number\") return errRecord.retryAfter;\n  const match = error.message.match(/retry.after[:\\s]*(\\d+)/i);\n  return match ? parseInt(match[1], 10) : undefined;\n}\n\nfunction isContextOverflow(msg: string): boolean {\n  return (\n    msg.includes(\"context length exceeded\") ||\n    msg.includes(\"maximum context length\") ||\n    msg.includes(\"context window\") ||\n    msg.includes(\"token limit\") ||\n    msg.includes(\"too many tokens\")\n  );\n}\n\n// ─── Retry Strategy ────────────────────────────────────────────\n\n/** Strategy for computing retry delays */\nexport interface RetryStrategy {\n  /** Return delay in ms for the given attempt (0-based), or null to stop */\n  nextDelay(attempt: number, error: ChatError): number | null;\n}\n\n/** Options for ExponentialBackoffStrategy */\nexport interface ExponentialBackoffOptions {\n  /** Base delay in ms (default: 1000) */\n  baseMs?: number;\n  /** Maximum delay in ms (default: 30000) */\n  maxMs?: number;\n  /** Maximum number of attempts (default: 3) */\n  maxAttempts?: number;\n  /** Jitter factor 0–1 (default: 0.1) */\n  jitter?: number;\n}\n\n/** Exponential backoff with optional jitter */\nexport class ExponentialBackoffStrategy implements RetryStrategy {\n  private readonly baseMs: number;\n  private readonly maxMs: number;\n  private readonly maxAttempts: number;\n  private readonly jitter: number;\n\n  constructor(options?: ExponentialBackoffOptions) {\n    this.baseMs = options?.baseMs ?? 1000;\n    this.maxMs = options?.maxMs ?? 30000;\n    this.maxAttempts = options?.maxAttempts ?? 3;\n    this.jitter = Math.max(0, Math.min(1, options?.jitter ?? 0.1));\n  }\n\n  nextDelay(attempt: number, error: ChatError): number | null {\n    if (attempt >= this.maxAttempts) return null;\n    if (!error.retryable) return null;\n\n    // Rate-limit errors with retryAfter (already in ms) take priority\n    if (error.code === ErrorCode.RATE_LIMIT && error.retryAfter) {\n      return error.retryAfter;\n    }\n\n    const delay = Math.min(this.baseMs * Math.pow(2, attempt), this.maxMs);\n    const jitterAmount = delay * this.jitter * (Math.random() * 2 - 1);\n    return Math.max(0, Math.round(delay + jitterAmount));\n  }\n}\n\n// ─── Retry Execution ───────────────────────────────────────────\n\n/** Options for withRetry execution */\nexport interface RetryOptions {\n  /** Abort signal to cancel retries */\n  signal?: AbortSignal;\n  /** Called before each retry with the error and delay */\n  onRetry?: (error: ChatError, attempt: number, delayMs: number) => void;\n}\n\n/**\n * Execute an async function with automatic retries using the provided strategy.\n * Respects ChatError.retryable and ChatError.retryAfter.\n * Classifies non-ChatError errors before deciding on retry.\n *\n * @param fn - Async function to execute\n * @param strategy - Retry strategy providing delay calculations\n * @param options - Optional abort signal and retry callback\n * @returns Result of fn on success\n * @throws ChatError when all retries exhausted or error is non-retryable\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  strategy: RetryStrategy,\n  options?: RetryOptions,\n): Promise<T> {\n  let attempt = 0;\n\n  for (;;) {\n    try {\n      return await fn();\n    } catch (raw) {\n      const error = classifyError(raw);\n      const delay = strategy.nextDelay(attempt, error);\n\n      if (delay === null) {\n        throw error;\n      }\n\n      if (options?.signal?.aborted) {\n        throw error;\n      }\n\n      options?.onRetry?.(error, attempt, delay);\n\n      await sleep(delay, options?.signal);\n      attempt++;\n    }\n  }\n}\n\n/**\n * Type guard: check if an error is retryable\n * @param error - The error to check\n * @returns True if error is a retryable ChatError\n */\nexport function isRetryable(error: unknown): boolean {\n  if (error instanceof ChatError) {\n    return error.retryable;\n  }\n  const classified = classifyError(error);\n  return classified.retryable;\n}\n\n// ─── Internal Helpers ──────────────────────────────────────────\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new ChatError(\"Retry aborted\", { code: ErrorCode.ABORTED }));\n      return;\n    }\n\n    const timer = setTimeout(resolve, ms);\n\n    signal?.addEventListener(\n      \"abort\",\n      () => {\n        clearTimeout(timer);\n        reject(new ChatError(\"Retry aborted\", { code: ErrorCode.ABORTED }));\n      },\n      { once: true },\n    );\n  });\n}\n"]}