@witqq/agent-sdk 0.6.1 → 0.7.0

package/dist/chat/errors.js

@@ -0,0 +1,243 @@
+// src/errors.ts
+var AgentSDKError = class extends Error {
+  /** @internal Marker for cross-bundle identity checks */
+  _agentSDKError = true;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "AgentSDKError";
+  }
+  /** 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 ChatErrorCode = /* @__PURE__ */ ((ChatErrorCode2) => {
+  ChatErrorCode2["NETWORK"] = "NETWORK";
+  ChatErrorCode2["TIMEOUT"] = "TIMEOUT";
+  ChatErrorCode2["AUTH_EXPIRED"] = "AUTH_EXPIRED";
+  ChatErrorCode2["AUTH_INVALID"] = "AUTH_INVALID";
+  ChatErrorCode2["RATE_LIMIT"] = "RATE_LIMIT";
+  ChatErrorCode2["PROVIDER_ERROR"] = "PROVIDER_ERROR";
+  ChatErrorCode2["MODEL_NOT_FOUND"] = "MODEL_NOT_FOUND";
+  ChatErrorCode2["MODEL_OVERLOADED"] = "MODEL_OVERLOADED";
+  ChatErrorCode2["CONTEXT_OVERFLOW"] = "CONTEXT_OVERFLOW";
+  ChatErrorCode2["INVALID_INPUT"] = "INVALID_INPUT";
+  ChatErrorCode2["INVALID_RESPONSE"] = "INVALID_RESPONSE";
+  ChatErrorCode2["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+  ChatErrorCode2["BACKEND_NOT_INSTALLED"] = "BACKEND_NOT_INSTALLED";
+  ChatErrorCode2["SESSION_NOT_FOUND"] = "SESSION_NOT_FOUND";
+  ChatErrorCode2["STORAGE_ERROR"] = "STORAGE_ERROR";
+  ChatErrorCode2["SESSION_EXPIRED"] = "SESSION_EXPIRED";
+  ChatErrorCode2["DISPOSED"] = "DISPOSED";
+  ChatErrorCode2["ABORTED"] = "ABORTED";
+  ChatErrorCode2["INVALID_TRANSITION"] = "INVALID_TRANSITION";
+  ChatErrorCode2["REENTRANCY"] = "REENTRANCY";
+  return ChatErrorCode2;
+})(ChatErrorCode || {});
+var ChatError = class extends AgentSDKError {
+  code;
+  retryable;
+  retryAfter;
+  timestamp;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    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, ChatErrorCode, ChatError as ChatSDKError, 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/errors.ts","../../src/chat/errors.ts"],"names":["ChatErrorCode"],"mappings":"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","file":"errors.js","sourcesContent":["/** 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\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AgentSDKError\";\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    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    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    );\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);\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    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.\");\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);\n    this.name = \"ToolExecutionError\";\n    this.toolName = toolName;\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);\n    this.name = \"StructuredOutputError\";\n  }\n}\n","/**\n * @witqq/agent-sdk/chat/errors\n *\n * Flat error taxonomy with ChatErrorCode enum, unified 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\";\n\n// ─── Error Code Enum ───────────────────────────────────────────\n\n/** Error codes for chat-specific errors — used by classifyError() and ChatError */\nexport enum ChatErrorCode {\n  NETWORK = \"NETWORK\",\n  TIMEOUT = \"TIMEOUT\",\n  AUTH_EXPIRED = \"AUTH_EXPIRED\",\n  AUTH_INVALID = \"AUTH_INVALID\",\n  RATE_LIMIT = \"RATE_LIMIT\",\n  PROVIDER_ERROR = \"PROVIDER_ERROR\",\n  MODEL_NOT_FOUND = \"MODEL_NOT_FOUND\",\n  MODEL_OVERLOADED = \"MODEL_OVERLOADED\",\n  CONTEXT_OVERFLOW = \"CONTEXT_OVERFLOW\",\n  INVALID_INPUT = \"INVALID_INPUT\",\n  INVALID_RESPONSE = \"INVALID_RESPONSE\",\n  PERMISSION_DENIED = \"PERMISSION_DENIED\",\n  BACKEND_NOT_INSTALLED = \"BACKEND_NOT_INSTALLED\",\n  SESSION_NOT_FOUND = \"SESSION_NOT_FOUND\",\n  STORAGE_ERROR = \"STORAGE_ERROR\",\n  SESSION_EXPIRED = \"SESSION_EXPIRED\",\n  DISPOSED = \"DISPOSED\",\n  ABORTED = \"ABORTED\",\n  INVALID_TRANSITION = \"INVALID_TRANSITION\",\n  REENTRANCY = \"REENTRANCY\",\n}\n\n// ─── Error Options ─────────────────────────────────────────────\n\n/** Options for constructing a ChatError */\nexport interface ChatErrorOptions {\n  /** Machine-readable error code */\n  code: ChatErrorCode;\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/** @deprecated Use ChatErrorOptions */\nexport type ChatSDKErrorOptions = ChatErrorOptions;\n\n// ─── Unified Error Class ───────────────────────────────────────\n\n/** Unified error class for all chat SDK errors */\nexport class ChatError extends AgentSDKError {\n  readonly code: ChatErrorCode;\n  readonly retryable: boolean;\n  readonly retryAfter?: number;\n  readonly timestamp: string;\n\n  constructor(message: string, options: ChatErrorOptions) {\n    super(message, { cause: options.cause });\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/** @deprecated Use ChatError */\nexport { ChatError as ChatSDKError };\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: ChatErrorCode.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: ChatErrorCode.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: ChatErrorCode.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: ChatErrorCode.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: ChatErrorCode.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: ChatErrorCode.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: ChatErrorCode.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: ChatErrorCode.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: ChatErrorCode.INVALID_INPUT,\n      retryable: false,\n      cause: error,\n    });\n  }\n  return new ChatError(error.message, {\n    code: ChatErrorCode.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 === ChatErrorCode.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: ChatErrorCode.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: ChatErrorCode.ABORTED }));\n      },\n      { once: true },\n    );\n  });\n}\n"]}

package/dist/chat/events.cjs

@@ -0,0 +1,203 @@
+'use strict';
+
+// src/chat/events.ts
+var TypedEventEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  /**
+   * Subscribe to an event.
+   * @param event - Event name
+   * @param listener - Callback receiving the event payload
+   * @returns Unsubscribe function
+   */
+  on(event, listener) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(event, set);
+    }
+    const fn = listener;
+    set.add(fn);
+    return () => {
+      set.delete(fn);
+      if (set.size === 0) {
+        this.listeners.delete(event);
+      }
+    };
+  }
+  /**
+   * Subscribe to an event, firing the listener at most once.
+   * @param event - Event name
+   * @param listener - Callback receiving the event payload
+   * @returns Unsubscribe function
+   */
+  once(event, listener) {
+    const unsub = this.on(event, (payload) => {
+      unsub();
+      listener(payload);
+    });
+    return unsub;
+  }
+  /**
+   * Remove a specific listener from an event.
+   * @param event - Event name
+   * @param listener - The listener to remove
+   */
+  off(event, listener) {
+    const set = this.listeners.get(event);
+    if (!set) return;
+    set.delete(listener);
+    if (set.size === 0) {
+      this.listeners.delete(event);
+    }
+  }
+  /**
+   * Emit an event, calling all registered listeners synchronously.
+   * @param event - Event name
+   * @param payload - Event payload
+   */
+  emit(event, payload) {
+    const set = this.listeners.get(event);
+    if (!set) return;
+    for (const fn of [...set]) {
+      fn(payload);
+    }
+  }
+  /**
+   * Remove all listeners for a specific event, or all events if no event specified.
+   * @param event - Optional event name
+   */
+  removeAllListeners(event) {
+    if (event !== void 0) {
+      this.listeners.delete(event);
+    } else {
+      this.listeners.clear();
+    }
+  }
+  /**
+   * Get the number of listeners for a specific event.
+   * @param event - Event name
+   * @returns Number of listeners
+   */
+  listenerCount(event) {
+    const set = this.listeners.get(event);
+    return set ? set.size : 0;
+  }
+  /**
+   * Get all event names that have at least one listener.
+   * @returns Array of event names
+   */
+  eventNames() {
+    return [...this.listeners.keys()];
+  }
+};
+var ChatEventBus = class extends TypedEventEmitter {
+  middlewares = [];
+  /**
+   * Register a middleware function. Middleware runs in registration order.
+   * @param middleware - Middleware function
+   * @returns Unsubscribe function to remove the middleware
+   */
+  use(middleware) {
+    this.middlewares.push(middleware);
+    return () => {
+      const idx = this.middlewares.indexOf(middleware);
+      if (idx !== -1) {
+        this.middlewares.splice(idx, 1);
+      }
+    };
+  }
+  /**
+   * Emit a chat event through the middleware pipeline, then to listeners.
+   *
+   * @param event - ChatEvent type string
+   * @param payload - The full ChatEvent object
+   */
+  emit(event, payload) {
+    if (this.middlewares.length === 0) {
+      super.emit(event, payload);
+      return;
+    }
+    let suppressed = false;
+    let currentEvent = payload;
+    let index = 0;
+    const runNext = () => {
+      if (suppressed) return;
+      if (index >= this.middlewares.length) {
+        super.emit(
+          currentEvent.type,
+          currentEvent
+        );
+        return;
+      }
+      const mw = this.middlewares[index++];
+      const ctx = {
+        event: currentEvent,
+        next: () => {
+          currentEvent = ctx.event;
+          runNext();
+        },
+        suppress: () => {
+          suppressed = true;
+        }
+      };
+      mw(ctx);
+    };
+    runNext();
+  }
+  /**
+   * Replace the event in the middleware context.
+   * Middleware should mutate ctx.event or create a new MiddlewareContext
+   * to transform events passing through the pipeline.
+   */
+  /**
+   * Remove all middleware functions.
+   */
+  clearMiddleware() {
+    this.middlewares.length = 0;
+  }
+  /**
+   * Get the number of registered middleware functions.
+   * @returns Number of middleware
+   */
+  middlewareCount() {
+    return this.middlewares.length;
+  }
+};
+function eventFilter(...types) {
+  const allowed = new Set(types);
+  return (event) => allowed.has(event.type);
+}
+async function* filterEvents(source, ...types) {
+  const pred = eventFilter(...types);
+  for await (const event of source) {
+    if (pred(event)) {
+      yield event;
+    }
+  }
+}
+async function* mapEvents(source, transform) {
+  for await (const event of source) {
+    const result = transform(event);
+    if (result !== null) {
+      yield result;
+    }
+  }
+}
+async function collectText(source) {
+  const parts = [];
+  for await (const event of source) {
+    if (event.type === "message:delta") {
+      parts.push(event.text);
+    }
+  }
+  return parts.join("");
+}
+
+exports.ChatEventBus = ChatEventBus;
+exports.TypedEventEmitter = TypedEventEmitter;
+exports.collectText = collectText;
+exports.eventFilter = eventFilter;
+exports.filterEvents = filterEvents;
+exports.mapEvents = mapEvents;
+//# sourceMappingURL=events.cjs.map
+//# sourceMappingURL=events.cjs.map

package/dist/chat/events.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/chat/events.ts"],"names":[],"mappings":"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","file":"events.cjs","sourcesContent":["/**\n * @witqq/agent-sdk/chat/events\n *\n * Type-safe event emitter, chat event bus, and middleware pipeline.\n * Generic TypedEventEmitter<EventMap> for arbitrary typed event maps.\n * ChatEventBus specializing TypedEventEmitter for ChatEvent types.\n * Middleware support for event interception, transformation, and suppression.\n * Utility functions for filtering and mapping event streams.\n */\n\nimport type { ChatEvent, ChatEventType } from \"./core.js\";\n\n// ─── EventMap constraint ──────────────────────────────────────\n\n/** Constraint for event maps: keys are strings, values are payloads */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventMap = Record<string, any>;\n\n// ─── Listener types ───────────────────────────────────────────\n\n/** Listener callback for a specific event */\nexport type Listener<T> = (payload: T) => void;\n\n/** Unsubscribe function returned by on/once */\nexport type Unsubscribe = () => void;\n\n// ─── TypedEventEmitter ────────────────────────────────────────\n\n/**\n * Generic type-safe event emitter parameterized by an EventMap.\n *\n * @typeParam T - Map of event names to payload types\n *\n * @example\n * ```typescript\n * type MyEvents = {\n *   message: string;\n *   count: number;\n *   done: void;\n * };\n * const emitter = new TypedEventEmitter<MyEvents>();\n * emitter.on(\"message\", (text) => console.log(text));\n * emitter.emit(\"message\", \"hello\");\n * ```\n */\nexport class TypedEventEmitter<T extends EventMap> {\n  private readonly listeners = new Map<keyof T, Set<Listener<unknown>>>();\n\n  /**\n   * Subscribe to an event.\n   * @param event - Event name\n   * @param listener - Callback receiving the event payload\n   * @returns Unsubscribe function\n   */\n  on<K extends keyof T>(event: K, listener: Listener<T[K]>): Unsubscribe {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    const fn = listener as Listener<unknown>;\n    set.add(fn);\n    return () => {\n      set!.delete(fn);\n      if (set!.size === 0) {\n        this.listeners.delete(event);\n      }\n    };\n  }\n\n  /**\n   * Subscribe to an event, firing the listener at most once.\n   * @param event - Event name\n   * @param listener - Callback receiving the event payload\n   * @returns Unsubscribe function\n   */\n  once<K extends keyof T>(event: K, listener: Listener<T[K]>): Unsubscribe {\n    const unsub = this.on(event, (payload) => {\n      unsub();\n      listener(payload);\n    });\n    return unsub;\n  }\n\n  /**\n   * Remove a specific listener from an event.\n   * @param event - Event name\n   * @param listener - The listener to remove\n   */\n  off<K extends keyof T>(event: K, listener: Listener<T[K]>): void {\n    const set = this.listeners.get(event);\n    if (!set) return;\n    set.delete(listener as Listener<unknown>);\n    if (set.size === 0) {\n      this.listeners.delete(event);\n    }\n  }\n\n  /**\n   * Emit an event, calling all registered listeners synchronously.\n   * @param event - Event name\n   * @param payload - Event payload\n   */\n  emit<K extends keyof T>(event: K, payload: T[K]): void {\n    const set = this.listeners.get(event);\n    if (!set) return;\n    for (const fn of [...set]) {\n      fn(payload);\n    }\n  }\n\n  /**\n   * Remove all listeners for a specific event, or all events if no event specified.\n   * @param event - Optional event name\n   */\n  removeAllListeners<K extends keyof T>(event?: K): void {\n    if (event !== undefined) {\n      this.listeners.delete(event);\n    } else {\n      this.listeners.clear();\n    }\n  }\n\n  /**\n   * Get the number of listeners for a specific event.\n   * @param event - Event name\n   * @returns Number of listeners\n   */\n  listenerCount<K extends keyof T>(event: K): number {\n    const set = this.listeners.get(event);\n    return set ? set.size : 0;\n  }\n\n  /**\n   * Get all event names that have at least one listener.\n   * @returns Array of event names\n   */\n  eventNames(): Array<keyof T> {\n    return [...this.listeners.keys()];\n  }\n}\n\n// ─── ChatEventMap ─────────────────────────────────────────────\n\n/**\n * Map of ChatEvent type strings to their corresponding ChatEvent payloads.\n * Used to parameterize TypedEventEmitter for chat events.\n */\nexport type ChatEventMap = {\n  [K in ChatEventType]: Extract<ChatEvent, { type: K }>;\n};\n\n// ─── Middleware ────────────────────────────────────────────────\n\n/**\n * Context passed to middleware functions.\n * Contains the event and control methods for the middleware pipeline.\n */\nexport interface MiddlewareContext {\n  /** The current event (may be transformed by prior middleware) */\n  event: ChatEvent;\n  /** Call the next middleware in the chain, or deliver to listeners if last */\n  next: () => void;\n  /** Suppress the event — do not deliver to listeners or subsequent middleware */\n  suppress: () => void;\n}\n\n/**\n * Middleware function for intercepting, transforming, or suppressing events.\n *\n * @param ctx - Middleware context with event, next(), and suppress()\n *\n * @example\n * ```typescript\n * // Logging middleware\n * const logger: EventMiddleware = (ctx) => {\n *   console.log(`Event: ${ctx.event.type}`);\n *   ctx.next();\n * };\n *\n * // Suppressing middleware\n * const filter: EventMiddleware = (ctx) => {\n *   if (ctx.event.type === \"heartbeat\") {\n *     ctx.suppress();\n *   } else {\n *     ctx.next();\n *   }\n * };\n * ```\n */\nexport type EventMiddleware = (ctx: MiddlewareContext) => void;\n\n// ─── ChatEventBus ─────────────────────────────────────────────\n\n/**\n * Chat event bus: a typed event emitter specialized for ChatEvent types\n * with middleware pipeline support.\n *\n * Events pass through the middleware pipeline before reaching listeners.\n * Middleware can inspect, transform, or suppress events.\n *\n * @example\n * ```typescript\n * const bus = new ChatEventBus();\n *\n * // Add middleware\n * bus.use((ctx) => {\n *   console.log(`[${ctx.event.type}]`);\n *   ctx.next();\n * });\n *\n * // Listen for events\n * bus.on(\"message:delta\", (event) => {\n *   console.log(event.text);\n * });\n *\n * // Emit events\n * bus.emit(\"message:delta\", { type: \"message:delta\", messageId: id, text: \"hi\" });\n * ```\n */\nexport class ChatEventBus extends TypedEventEmitter<ChatEventMap> {\n  private readonly middlewares: EventMiddleware[] = [];\n\n  /**\n   * Register a middleware function. Middleware runs in registration order.\n   * @param middleware - Middleware function\n   * @returns Unsubscribe function to remove the middleware\n   */\n  use(middleware: EventMiddleware): Unsubscribe {\n    this.middlewares.push(middleware);\n    return () => {\n      const idx = this.middlewares.indexOf(middleware);\n      if (idx !== -1) {\n        this.middlewares.splice(idx, 1);\n      }\n    };\n  }\n\n  /**\n   * Emit a chat event through the middleware pipeline, then to listeners.\n   *\n   * @param event - ChatEvent type string\n   * @param payload - The full ChatEvent object\n   */\n  override emit<K extends ChatEventType>(\n    event: K,\n    payload: ChatEventMap[K],\n  ): void {\n    if (this.middlewares.length === 0) {\n      super.emit(event, payload);\n      return;\n    }\n\n    let suppressed = false;\n    let currentEvent: ChatEvent = payload;\n    let index = 0;\n\n    const runNext = (): void => {\n      if (suppressed) return;\n\n      if (index >= this.middlewares.length) {\n        super.emit(\n          currentEvent.type as K,\n          currentEvent as ChatEventMap[K],\n        );\n        return;\n      }\n\n      const mw = this.middlewares[index++];\n      const ctx: MiddlewareContext = {\n        event: currentEvent,\n        next: () => {\n          currentEvent = ctx.event;\n          runNext();\n        },\n        suppress: () => {\n          suppressed = true;\n        },\n      };\n      mw(ctx);\n    };\n\n    runNext();\n  }\n\n  /**\n   * Replace the event in the middleware context.\n   * Middleware should mutate ctx.event or create a new MiddlewareContext\n   * to transform events passing through the pipeline.\n   */\n\n  /**\n   * Remove all middleware functions.\n   */\n  clearMiddleware(): void {\n    this.middlewares.length = 0;\n  }\n\n  /**\n   * Get the number of registered middleware functions.\n   * @returns Number of middleware\n   */\n  middlewareCount(): number {\n    return this.middlewares.length;\n  }\n}\n\n// ─── Utility: Event Filtering ─────────────────────────────────\n\n/**\n * Create a filter function that passes only events of specified types.\n *\n * @param types - Event types to allow through\n * @returns Predicate function for filtering ChatEvents\n *\n * @example\n * ```typescript\n * const isTextEvent = eventFilter(\"message:start\", \"message:delta\", \"message:complete\");\n * const textEvents = allEvents.filter(isTextEvent);\n * ```\n */\nexport function eventFilter(\n  ...types: ChatEventType[]\n): (event: ChatEvent) => boolean {\n  const allowed = new Set<string>(types);\n  return (event: ChatEvent) => allowed.has(event.type);\n}\n\n/**\n * Filter an async iterable of ChatEvents to only specified types.\n *\n * @param source - Async iterable of ChatEvents\n * @param types - Event types to keep\n * @returns Async iterable of filtered ChatEvents\n *\n * @example\n * ```typescript\n * for await (const event of filterEvents(stream, \"message:delta\", \"message:complete\")) {\n *   // only message:delta and message:complete events\n * }\n * ```\n */\nexport async function* filterEvents(\n  source: AsyncIterable<ChatEvent>,\n  ...types: ChatEventType[]\n): AsyncIterable<ChatEvent> {\n  const pred = eventFilter(...types);\n  for await (const event of source) {\n    if (pred(event)) {\n      yield event;\n    }\n  }\n}\n\n// ─── Utility: Event Mapping ───────────────────────────────────\n\n/**\n * Map/transform events from an async iterable.\n *\n * @param source - Async iterable of ChatEvents\n * @param transform - Function to transform each event (return null to skip)\n * @returns Async iterable of transformed values\n *\n * @example\n * ```typescript\n * // Extract text from message:delta events\n * const texts = mapEvents(stream, (event) =>\n *   event.type === \"message:delta\" ? event.text : null\n * );\n * ```\n */\nexport async function* mapEvents<R>(\n  source: AsyncIterable<ChatEvent>,\n  transform: (event: ChatEvent) => R | null,\n): AsyncIterable<R> {\n  for await (const event of source) {\n    const result = transform(event);\n    if (result !== null) {\n      yield result;\n    }\n  }\n}\n\n/**\n * Collect text from message:delta events into a single string.\n *\n * @param source - Async iterable of ChatEvents\n * @returns Complete text assembled from message:delta payloads\n *\n * @example\n * ```typescript\n * const fullText = await collectText(stream);\n * ```\n */\nexport async function collectText(\n  source: AsyncIterable<ChatEvent>,\n): Promise<string> {\n  const parts: string[] = [];\n  for await (const event of source) {\n    if (event.type === \"message:delta\") {\n      parts.push(event.text);\n    }\n  }\n  return parts.join(\"\");\n}\n"]}