@witqq/agent-sdk 0.6.1 → 0.8.0

package/dist/chat/core.js

@@ -0,0 +1,282 @@
+// src/chat/types.ts
+function createChatId() {
+  return crypto.randomUUID();
+}
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function toChatId(value) {
+  if (!UUID_RE.test(value)) {
+    throw new TypeError(`Invalid ChatId: "${value}" is not a valid UUID`);
+  }
+  return value;
+}
+function createTextMessage(text, role = "user") {
+  return {
+    id: createChatId(),
+    role,
+    parts: [{ type: "text", text, status: "complete" }],
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    status: "complete"
+  };
+}
+function isObservableSession(session) {
+  return "subscribe" in session && typeof session.subscribe === "function" && "getSnapshot" in session && typeof session.getSnapshot === "function";
+}
+
+// src/chat/chat-utils.ts
+function getMessageText(message) {
+  return message.parts.filter((p) => p.type === "text").map((p) => p.text).join("");
+}
+function getMessageToolCalls(message) {
+  return message.parts.filter((p) => p.type === "tool_call");
+}
+function getMessageReasoning(message) {
+  return message.parts.filter((p) => p.type === "reasoning").map((p) => p.text).join("");
+}
+
+// src/chat/guards.ts
+function isChatMessage(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return typeof obj.id === "string" && typeof obj.role === "string" && (obj.role === "user" || obj.role === "assistant" || obj.role === "system") && Array.isArray(obj.parts) && typeof obj.createdAt === "string" && typeof obj.status === "string";
+}
+function isChatSession(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return typeof obj.id === "string" && Array.isArray(obj.messages) && typeof obj.config === "object" && obj.config !== null && typeof obj.createdAt === "string" && typeof obj.updatedAt === "string" && typeof obj.status === "string";
+}
+function isMessagePart(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return typeof obj.type === "string" && (obj.type === "text" || obj.type === "reasoning" || obj.type === "tool_call" || obj.type === "source" || obj.type === "file");
+}
+function isTextPart(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return obj.type === "text" && typeof obj.text === "string";
+}
+function isToolCallPart(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return obj.type === "tool_call" && typeof obj.toolCallId === "string" && typeof obj.name === "string";
+}
+function isReasoningPart(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return obj.type === "reasoning" && typeof obj.text === "string";
+}
+function isSourcePart(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return obj.type === "source" && typeof obj.url === "string";
+}
+function isFilePart(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return obj.type === "file" && typeof obj.name === "string" && typeof obj.mimeType === "string";
+}
+function isChatEvent(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  const validTypes = [
+    "message:start",
+    "message:delta",
+    "message:complete",
+    "tool:start",
+    "tool:complete",
+    "thinking:start",
+    "thinking:delta",
+    "thinking:end",
+    "permission:request",
+    "permission:response",
+    "usage",
+    "session:created",
+    "session:updated",
+    "error",
+    "typing:start",
+    "typing:end",
+    "heartbeat",
+    "done"
+  ];
+  return validTypes.includes(obj.type);
+}
+
+// src/chat/bridge.ts
+function agentEventToChatEvent(event, messageId) {
+  switch (event.type) {
+    case "text_delta":
+      return { type: "message:delta", messageId, text: event.text };
+    case "thinking_start":
+      return { type: "thinking:start", messageId };
+    case "thinking_delta":
+      return { type: "thinking:delta", messageId, text: event.text };
+    case "thinking_end":
+      return { type: "thinking:end", messageId };
+    case "tool_call_start":
+      return {
+        type: "tool:start",
+        messageId,
+        toolCallId: event.toolCallId,
+        toolName: event.toolName,
+        args: event.args
+      };
+    case "tool_call_end":
+      return {
+        type: "tool:complete",
+        messageId,
+        toolCallId: event.toolCallId,
+        toolName: event.toolName,
+        result: event.result
+      };
+    case "permission_request":
+      return {
+        type: "permission:request",
+        messageId,
+        toolName: event.request.toolName,
+        toolArgs: event.request.toolArgs
+      };
+    case "permission_response":
+      return {
+        type: "permission:response",
+        messageId,
+        toolName: event.toolName,
+        allowed: event.decision.allowed
+      };
+    case "usage_update":
+      return {
+        type: "usage",
+        promptTokens: event.promptTokens,
+        completionTokens: event.completionTokens,
+        model: event.model
+      };
+    case "error":
+      return {
+        type: "error",
+        error: event.error,
+        recoverable: event.recoverable,
+        code: event.code,
+        messageId
+      };
+    case "heartbeat":
+      return { type: "heartbeat" };
+    case "ask_user":
+    case "ask_user_response":
+    case "session_info":
+    case "done":
+      return null;
+    default:
+      return null;
+  }
+}
+async function* adaptAgentEvents(events, messageId) {
+  for await (const event of events) {
+    const chatEvent = agentEventToChatEvent(event, messageId);
+    if (chatEvent !== null) {
+      yield chatEvent;
+    }
+  }
+}
+function chatEventToAgentEvent(event) {
+  switch (event.type) {
+    case "message:delta":
+      return { type: "text_delta", text: event.text };
+    case "thinking:start":
+      return { type: "thinking_start" };
+    case "thinking:delta":
+      return { type: "thinking_delta", text: event.text };
+    case "thinking:end":
+      return { type: "thinking_end" };
+    case "tool:start":
+      return {
+        type: "tool_call_start",
+        toolCallId: event.toolCallId,
+        toolName: event.toolName,
+        args: event.args
+      };
+    case "tool:complete":
+      return {
+        type: "tool_call_end",
+        toolCallId: event.toolCallId,
+        toolName: event.toolName,
+        result: event.result
+      };
+    case "error":
+      return { type: "error", error: event.error, recoverable: event.recoverable, code: event.code };
+    default:
+      return null;
+  }
+}
+
+// src/chat/conversion.ts
+function toAgentMessage(message) {
+  const textContent = getMessageText(message);
+  const toolCallParts = getMessageToolCalls(message);
+  switch (message.role) {
+    case "user":
+      return { role: "user", content: textContent };
+    case "assistant": {
+      const toolCalls = toolCallParts.length > 0 ? toolCallParts.map((p) => ({ id: p.toolCallId, name: p.name, args: p.args })) : void 0;
+      return {
+        role: "assistant",
+        content: textContent,
+        toolCalls
+      };
+    }
+    case "system":
+      return { role: "system", content: textContent };
+  }
+}
+function fromAgentMessage(message, id) {
+  const chatId = id ?? createChatId();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const parts = [];
+  const textContent = typeof message.content === "string" ? message.content : Array.isArray(message.content) ? message.content.filter((part) => part.type === "text").map((part) => part.text).join("\n") : message.content ?? "";
+  if (textContent) {
+    parts.push({ type: "text", text: textContent, status: "complete" });
+  }
+  if (message.role === "assistant" && message.toolCalls) {
+    for (const tc of message.toolCalls) {
+      parts.push({
+        type: "tool_call",
+        toolCallId: tc.id,
+        name: tc.name,
+        args: tc.args,
+        status: "complete"
+      });
+    }
+  }
+  if (message.role === "tool" && message.toolResults) {
+    for (const tr of message.toolResults) {
+      parts.push({
+        type: "tool_call",
+        toolCallId: tr.toolCallId,
+        name: tr.name,
+        args: {},
+        result: tr.result,
+        status: "complete"
+      });
+    }
+  }
+  if (parts.length === 0) {
+    parts.push({ type: "text", text: "", status: "complete" });
+  }
+  const role = message.role === "tool" ? "assistant" : message.role;
+  return {
+    id: chatId,
+    role,
+    parts,
+    createdAt: now,
+    status: "complete"
+  };
+}
+function extractToolResults(message) {
+  return getMessageToolCalls(message).filter((p) => p.result !== void 0).map((p) => ({
+    toolCallId: p.toolCallId,
+    name: p.name,
+    result: p.result,
+    isError: p.status === "error" ? true : void 0
+  }));
+}
+
+export { adaptAgentEvents, agentEventToChatEvent, chatEventToAgentEvent, createChatId, createTextMessage, extractToolResults, fromAgentMessage, getMessageReasoning, getMessageText, getMessageToolCalls, isChatEvent, isChatMessage, isChatSession, isFilePart, isMessagePart, isObservableSession, isReasoningPart, isSourcePart, isTextPart, isToolCallPart, toAgentMessage, toChatId };
+//# sourceMappingURL=core.js.map
+//# sourceMappingURL=core.js.map

package/dist/chat/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/chat/types.ts","../../src/chat/chat-utils.ts","../../src/chat/guards.ts","../../src/chat/bridge.ts","../../src/chat/conversion.ts"],"names":[],"mappings":"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","file":"core.js","sourcesContent":["/**\n * @witqq/agent-sdk — Chat domain types\n *\n * All type definitions and interfaces for the chat layer.\n * Pure types + ChatId generation (tightly coupled to branded type).\n */\n\nimport type { UsageData, ToolDefinition, ErrorCode } from \"../types.js\";\nimport type { AuthToken } from \"../auth/types.js\";\n\n// ─── Unique ID ─────────────────────────────────────────────────\n\n/** Branded type for unique identifiers */\nexport type ChatId = string & { readonly __brand: \"ChatId\" };\n\n/**\n * Generate a new unique ChatId (crypto.randomUUID-based)\n * @returns Branded ChatId string\n */\nexport function createChatId(): ChatId {\n  return crypto.randomUUID() as ChatId;\n}\n\n/** UUID v4 pattern for ChatId validation */\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\n/**\n * Cast a string to ChatId with UUID format validation.\n * Use this instead of manual `as ChatId` type assertions.\n *\n * @param value - String to validate and cast\n * @returns Branded ChatId\n * @throws {TypeError} If value is not a valid UUID v4 format\n */\nexport function toChatId(value: string): ChatId {\n  if (!UUID_RE.test(value)) {\n    throw new TypeError(`Invalid ChatId: \"${value}\" is not a valid UUID`);\n  }\n  return value as ChatId;\n}\n\n/**\n * Accepts either a plain string or branded ChatId for API convenience.\n * Use this in public API signatures so consumers don't need `as ChatId` casts.\n */\nexport type ChatIdLike = string | ChatId;\n\n// ─── Status Types ──────────────────────────────────────────────\n\n/** Lifecycle status of a message part (text, reasoning, etc.) */\nexport type PartStatus = \"pending\" | \"streaming\" | \"complete\" | \"error\";\n/** Lifecycle status of a tool call within a message */\nexport type ToolCallStatus = \"pending\" | \"running\" | \"requires_approval\" | \"complete\" | \"error\" | \"denied\";\n/** Lifecycle status of an entire message */\nexport type MessageStatus = \"pending\" | \"streaming\" | \"complete\" | \"error\" | \"cancelled\";\n/** Lifecycle status of a chat session */\nexport type SessionStatus = \"active\";\n/** Lifecycle status of the chat runtime */\nexport type RuntimeStatus = \"idle\" | \"streaming\" | \"error\" | \"disposed\";\n\n// ─── Message Parts (union) ─────────────────────────────────────\n\n/** Plain text content part */\nexport interface TextPart { type: \"text\"; text: string; status: PartStatus; }\n/** Model reasoning/thinking content part */\nexport interface ReasoningPart { type: \"reasoning\"; text: string; status: PartStatus; }\n/** Tool invocation part with call ID, arguments, optional result */\nexport interface ToolCallPart { type: \"tool_call\"; toolCallId: string; name: string; args: unknown; result?: unknown; status: ToolCallStatus; error?: string; }\n/** Source reference part (URL citation) */\nexport interface SourcePart { type: \"source\"; url: string; title?: string; status: PartStatus; }\n/** File attachment part (base64-encoded data) */\nexport interface FilePart { type: \"file\"; name: string; mimeType: string; data: string; status: PartStatus; }\n/** Union of all message part types */\nexport type MessagePart = TextPart | ReasoningPart | ToolCallPart | SourcePart | FilePart;\n\n// ─── Chat Message ──────────────────────────────────────────────\n\n/** Role of message author */\nexport type ChatRole = \"user\" | \"assistant\" | \"system\";\n\n/** Metadata attached to messages — useful preset for the TMetadata generic */\nexport interface ChatMessageMetadata {\n  model?: string;\n  backend?: string;\n  usage?: UsageData;\n  isSummary?: boolean;\n  estimatedTokens?: number;\n  custom?: Record<string, unknown>;\n}\n\n/** Message status */\nexport type ChatMessageStatus = MessageStatus;\n\n/** A single chat message — the fundamental unit of conversation */\nexport interface ChatMessage<TMetadata = unknown> {\n  id: ChatId;\n  role: ChatRole;\n  parts: MessagePart[];\n  metadata?: TMetadata;\n  createdAt: string;\n  updatedAt?: string;\n  status: MessageStatus;\n}\n\n// ─── Supporting Types ──────────────────────────────────────────\n\n// ─── Chat Session ──────────────────────────────────────────────\n\n/** Session configuration snapshot */\nexport interface ChatSessionConfig {\n  model: string;\n  backend: string;\n  systemPrompt?: string;\n  temperature?: number;\n  maxTokens?: number;\n}\n\n/**\n * Session metadata tracking usage statistics and custom extensions.\n *\n * Updated automatically by session stores on each `addMessage()` call.\n * The generic `TCustom` parameter allows type-safe application-specific\n * metadata via the `custom` field.\n *\n * @typeParam TCustom - Shape of the `custom` field (defaults to `Record<string, unknown>`)\n */\nexport interface ChatSessionMetadata<TCustom extends Record<string, unknown> = Record<string, unknown>> {\n  /** Number of messages in the session (updated by session store) */\n  messageCount: number;\n  /** Total token count across all messages in the session */\n  totalTokens: number;\n  /** Optional tags for session categorization and filtering */\n  tags?: string[];\n  /** Application-specific metadata — typed via the TCustom generic parameter */\n  custom?: TCustom;\n}\n\n/** Chat session — a conversation with ordered messages (pure serializable data) */\nexport interface ChatSession<TCustom extends Record<string, unknown> = Record<string, unknown>> {\n  id: ChatId;\n  title?: string;\n  messages: ChatMessage[];\n  config: ChatSessionConfig;\n  metadata: ChatSessionMetadata<TCustom>;\n  status: SessionStatus;\n  createdAt: string;\n  updatedAt: string;\n  backendSessionId?: string;\n}\n\n/**\n * Reactive wrapper around ChatSession — provides subscribe/getSnapshot for\n * React useSyncExternalStore integration and lastMessage convenience getter.\n * Session stores may optionally return ObservableSession instances.\n */\nexport interface ObservableSession<TCustom extends Record<string, unknown> = Record<string, unknown>>\n  extends ChatSession<TCustom> {\n  /** Subscribe to session changes (for React useSyncExternalStore) */\n  subscribe(callback: () => void): () => void;\n  /** Get immutable snapshot of session state (for React useSyncExternalStore) */\n  getSnapshot(): ChatSession<TCustom>;\n  /** Last message in the session */\n  readonly lastMessage: ChatMessage | undefined;\n}\n\n/** Lightweight session info for listing (without full message array) */\nexport interface SessionInfo {\n  id: ChatId;\n  title?: string;\n  status: SessionStatus;\n  messageCount: number;\n  lastMessage?: ChatMessage;\n  createdAt: string;\n  updatedAt: string;\n}\n\n// ─── Chat Events ───────────────────────────────────────────────\n\n/** Events emitted during chat operation */\nexport type ChatEvent =\n  | { type: \"message:start\"; messageId: ChatId; role: ChatRole }\n  | { type: \"message:delta\"; messageId: ChatId; text: string }\n  | { type: \"message:complete\"; messageId: ChatId; message: ChatMessage }\n  | {\n      type: \"tool:start\";\n      messageId: ChatId;\n      toolCallId: string;\n      toolName: string;\n      args: Record<string, unknown>;\n    }\n  | {\n      type: \"tool:complete\";\n      messageId: ChatId;\n      toolCallId: string;\n      toolName: string;\n      result: unknown;\n      isError?: boolean;\n    }\n  | { type: \"thinking:start\"; messageId: ChatId }\n  | { type: \"thinking:delta\"; messageId: ChatId; text: string }\n  | { type: \"thinking:end\"; messageId: ChatId }\n  | {\n      type: \"permission:request\";\n      messageId: ChatId;\n      toolName: string;\n      toolArgs: Record<string, unknown>;\n    }\n  | {\n      type: \"permission:response\";\n      messageId: ChatId;\n      toolName: string;\n      allowed: boolean;\n    }\n  | {\n      type: \"usage\";\n      promptTokens: number;\n      completionTokens: number;\n      model?: string;\n    }\n  | { type: \"session:created\"; sessionId: ChatId }\n  | { type: \"session:updated\"; sessionId: ChatId }\n  | {\n      type: \"error\";\n      error: string;\n      recoverable: boolean;\n      code?: ErrorCode;\n      messageId?: ChatId;\n    }\n  | { type: \"typing:start\" }\n  | { type: \"typing:end\" }\n  | { type: \"heartbeat\" }\n  | { type: \"done\"; finalOutput?: string };\n\n/** All possible ChatEvent type strings */\nexport type ChatEventType = ChatEvent[\"type\"];\n\n// ─── Chat Middleware ───────────────────────────────────────────\n\n/** Context passed to ChatMiddleware hooks */\nexport interface ChatMiddlewareContext {\n  sessionId: ChatId;\n  signal: AbortSignal;\n}\n\n/** Runtime-level middleware for the send/receive lifecycle.\n *  Different from EventMiddleware which operates at the event bus level. */\nexport interface ChatMiddleware {\n  /** Transform message before sending to backend. Return null to reject the send. */\n  onBeforeSend?(message: ChatMessage, context: ChatMiddlewareContext): ChatMessage | null | Promise<ChatMessage | null>;\n  /** Transform/intercept stream events */\n  onEvent?(event: ChatEvent, context: ChatMiddlewareContext): ChatEvent | null | Promise<ChatEvent | null>;\n  /** Transform completed message after receiving from backend */\n  onAfterReceive?(message: ChatMessage, context: ChatMiddlewareContext): ChatMessage | Promise<ChatMessage>;\n  /** Intercept errors — return null to suppress, return error to propagate */\n  onError?(error: Error, context: ChatMiddlewareContext): Error | null | Promise<Error | null>;\n}\n\n// ─── Chat Provider Abstraction ─────────────────────────────────\n\n/** Options for sending a message to a provider */\nexport interface SendMessageOptions {\n  signal?: AbortSignal;\n  /** Model to use for this request. Required for server-side runtime.send(). */\n  model?: string;\n  /** Per-call system prompt override (forwarded to the backend agent) */\n  systemPrompt?: string;\n  context?: Record<string, unknown>;\n  /** Additional tools to include in this request */\n  tools?: ToolDefinition[];\n}\n\n/** Options for runtime.send() — requires backend routing info */\nexport interface RuntimeSendOptions {\n  /** Backend to route this request to (key in backends map) */\n  backend: string;\n  /** Authentication credentials for the backend factory */\n  credentials: AuthToken;\n  /** Model to use for this request */\n  model: string;\n  /** Per-call system prompt override (forwarded to the backend agent) */\n  systemPrompt?: string;\n  /** Abort signal */\n  signal?: AbortSignal;\n  /** Request-scoped context */\n  context?: Record<string, unknown>;\n  /** Additional tools */\n  tools?: ToolDefinition[];\n}\n\n/**\n * @deprecated IChatProvider has been inlined into IChatBackend.\n * Import IChatBackend from \"@witqq/agent-sdk/chat/backends\" instead.\n * Kept as type alias for backward compatibility.\n */\nexport type IChatProvider = import(\"./backends/types.js\").IChatBackend;\n\n// ─── Factory Functions ─────────────────────────────────────────\n\n/**\n * Create a simple text ChatMessage.\n *\n * @param text - Message text content\n * @param role - Message role (default: \"user\")\n * @returns A complete ChatMessage with a single TextPart\n */\nexport function createTextMessage(text: string, role: ChatRole = \"user\"): ChatMessage {\n  return {\n    id: createChatId(),\n    role,\n    parts: [{ type: \"text\", text, status: \"complete\" }],\n    createdAt: new Date().toISOString(),\n    status: \"complete\",\n  };\n}\n\n/** Type guard: checks if a session has reactive API (subscribe/getSnapshot) */\nexport function isObservableSession<TCustom extends Record<string, unknown> = Record<string, unknown>>(\n  session: ChatSession<TCustom>,\n): session is ObservableSession<TCustom> {\n  return \"subscribe\" in session && typeof (session as ObservableSession<TCustom>).subscribe === \"function\"\n    && \"getSnapshot\" in session && typeof (session as ObservableSession<TCustom>).getSnapshot === \"function\";\n}\n","/**\n * @witqq/agent-sdk — Chat utility functions\n */\n\nimport type { ChatMessage, TextPart, ToolCallPart, ReasoningPart } from \"./types.js\";\nexport { createChatId, toChatId } from \"./types.js\";\n\n/**\n * Join all TextPart texts in a message\n */\nexport function getMessageText(message: ChatMessage): string {\n  return message.parts\n    .filter((p): p is TextPart => p.type === \"text\")\n    .map((p) => p.text)\n    .join(\"\");\n}\n\n/**\n * Filter all ToolCallParts from a message\n */\nexport function getMessageToolCalls(message: ChatMessage): ToolCallPart[] {\n  return message.parts.filter((p): p is ToolCallPart => p.type === \"tool_call\");\n}\n\n/**\n * Join all ReasoningPart texts in a message\n */\nexport function getMessageReasoning(message: ChatMessage): string {\n  return message.parts\n    .filter((p): p is ReasoningPart => p.type === \"reasoning\")\n    .map((p) => p.text)\n    .join(\"\");\n}\n","/**\n * @witqq/agent-sdk — Chat type guards\n */\n\nimport type {\n  ChatMessage,\n  ChatSession,\n  MessagePart,\n  TextPart,\n  ToolCallPart,\n  ReasoningPart,\n  SourcePart,\n  FilePart,\n  ChatEvent,\n  ChatEventType,\n} from \"./types.js\";\n\n/** Check if a value is a ChatMessage */\nexport function isChatMessage(value: unknown): value is ChatMessage {\n  if (typeof value !== \"object\" || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return (\n    typeof obj.id === \"string\" &&\n    typeof obj.role === \"string\" &&\n    (obj.role === \"user\" || obj.role === \"assistant\" || obj.role === \"system\") &&\n    Array.isArray(obj.parts) &&\n    typeof obj.createdAt === \"string\" &&\n    typeof obj.status === \"string\"\n  );\n}\n\n/** Check if a value is a ChatSession */\nexport function isChatSession(value: unknown): value is ChatSession {\n  if (typeof value !== \"object\" || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return (\n    typeof obj.id === \"string\" &&\n    Array.isArray(obj.messages) &&\n    typeof obj.config === \"object\" &&\n    obj.config !== null &&\n    typeof obj.createdAt === \"string\" &&\n    typeof obj.updatedAt === \"string\" &&\n    typeof obj.status === \"string\"\n  );\n}\n\n/** Check if a value is a MessagePart */\nexport function isMessagePart(value: unknown): value is MessagePart {\n  if (typeof value !== \"object\" || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return (\n    typeof obj.type === \"string\" &&\n    (obj.type === \"text\" || obj.type === \"reasoning\" || obj.type === \"tool_call\" || obj.type === \"source\" || obj.type === \"file\")\n  );\n}\n\n/** Check if a value is a TextPart */\nexport function isTextPart(value: unknown): value is TextPart {\n  if (typeof value !== \"object\" || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return obj.type === \"text\" && typeof obj.text === \"string\";\n}\n\n/** Check if a value is a ToolCallPart */\nexport function isToolCallPart(value: unknown): value is ToolCallPart {\n  if (typeof value !== \"object\" || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return obj.type === \"tool_call\" && typeof obj.toolCallId === \"string\" && typeof obj.name === \"string\";\n}\n\n/** Check if a value is a ReasoningPart */\nexport function isReasoningPart(value: unknown): value is ReasoningPart {\n  if (typeof value !== \"object\" || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return obj.type === \"reasoning\" && typeof obj.text === \"string\";\n}\n\n/** Check if a value is a SourcePart */\nexport function isSourcePart(value: unknown): value is SourcePart {\n  if (typeof value !== \"object\" || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return obj.type === \"source\" && typeof obj.url === \"string\";\n}\n\n/** Check if a value is a FilePart */\nexport function isFilePart(value: unknown): value is FilePart {\n  if (typeof value !== \"object\" || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return obj.type === \"file\" && typeof obj.name === \"string\" && typeof obj.mimeType === \"string\";\n}\n\n/** Check if a value is a ChatEvent */\nexport function isChatEvent(value: unknown): value is ChatEvent {\n  if (typeof value !== \"object\" || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  const validTypes: ChatEventType[] = [\n    \"message:start\", \"message:delta\", \"message:complete\",\n    \"tool:start\", \"tool:complete\",\n    \"thinking:start\", \"thinking:delta\", \"thinking:end\",\n    \"permission:request\", \"permission:response\",\n    \"usage\", \"session:created\", \"session:updated\",\n    \"error\", \"typing:start\", \"typing:end\", \"heartbeat\", \"done\",\n  ];\n  return validTypes.includes(obj.type as ChatEventType);\n}\n","/**\n * @witqq/agent-sdk — AgentEvent ↔ ChatEvent bridge\n */\n\nimport type { AgentEvent, JSONValue } from \"../types.js\";\nimport type { ChatId, ChatEvent } from \"./types.js\";\n\n/**\n * Map a single AgentEvent to a ChatEvent (or null if no mapping)\n */\nexport function agentEventToChatEvent(\n  event: AgentEvent,\n  messageId: ChatId,\n): ChatEvent | null {\n  switch (event.type) {\n    case \"text_delta\":\n      return { type: \"message:delta\", messageId, text: event.text };\n    case \"thinking_start\":\n      return { type: \"thinking:start\", messageId };\n    case \"thinking_delta\":\n      return { type: \"thinking:delta\", messageId, text: event.text };\n    case \"thinking_end\":\n      return { type: \"thinking:end\", messageId };\n    case \"tool_call_start\":\n      return {\n        type: \"tool:start\",\n        messageId,\n        toolCallId: event.toolCallId,\n        toolName: event.toolName,\n        args: event.args as Record<string, unknown>,\n      };\n    case \"tool_call_end\":\n      return {\n        type: \"tool:complete\",\n        messageId,\n        toolCallId: event.toolCallId,\n        toolName: event.toolName,\n        result: event.result,\n      };\n    case \"permission_request\":\n      return {\n        type: \"permission:request\",\n        messageId,\n        toolName: event.request.toolName,\n        toolArgs: event.request.toolArgs,\n      };\n    case \"permission_response\":\n      return {\n        type: \"permission:response\",\n        messageId,\n        toolName: event.toolName,\n        allowed: event.decision.allowed,\n      };\n    case \"usage_update\":\n      return {\n        type: \"usage\",\n        promptTokens: event.promptTokens,\n        completionTokens: event.completionTokens,\n        model: event.model,\n      };\n    case \"error\":\n      return {\n        type: \"error\",\n        error: event.error,\n        recoverable: event.recoverable,\n        code: event.code,\n        messageId,\n      };\n    case \"heartbeat\":\n      return { type: \"heartbeat\" };\n    case \"ask_user\":\n    case \"ask_user_response\":\n    case \"session_info\":\n    case \"done\":\n      return null;\n    default:\n      return null;\n  }\n}\n\n/**\n * Convert AgentEvent async iterable to ChatEvent async iterable\n */\nexport async function* adaptAgentEvents(\n  events: AsyncIterable<AgentEvent>,\n  messageId: ChatId,\n): AsyncIterable<ChatEvent> {\n  for await (const event of events) {\n    const chatEvent = agentEventToChatEvent(event, messageId);\n    if (chatEvent !== null) {\n      yield chatEvent;\n    }\n  }\n}\n\n/**\n * Map a ChatEvent back to an AgentEvent for accumulator consumption.\n * Returns null for events that don't map to accumulator-relevant AgentEvents.\n */\nexport function chatEventToAgentEvent(event: ChatEvent): AgentEvent | null {\n  switch (event.type) {\n    case \"message:delta\":\n      return { type: \"text_delta\", text: event.text };\n    case \"thinking:start\":\n      return { type: \"thinking_start\" };\n    case \"thinking:delta\":\n      return { type: \"thinking_delta\", text: event.text };\n    case \"thinking:end\":\n      return { type: \"thinking_end\" };\n    case \"tool:start\":\n      return {\n        type: \"tool_call_start\",\n        toolCallId: event.toolCallId,\n        toolName: event.toolName,\n        args: event.args as JSONValue,\n      };\n    case \"tool:complete\":\n      return {\n        type: \"tool_call_end\",\n        toolCallId: event.toolCallId,\n        toolName: event.toolName,\n        result: event.result as JSONValue,\n      };\n    case \"error\":\n      return { type: \"error\", error: event.error, recoverable: event.recoverable, code: event.code };\n    default:\n      return null;\n  }\n}\n","/**\n * @witqq/agent-sdk — ChatMessage ↔ agent-sdk Message conversion\n */\n\nimport type { Message, ToolCall, ToolResult, JSONValue } from \"../types.js\";\nimport type { ChatId, ChatMessage, ChatRole, MessagePart } from \"./types.js\";\nimport { createChatId, getMessageText, getMessageToolCalls } from \"./chat-utils.js\";\n\n/**\n * Convert a ChatMessage to agent-sdk Message format\n */\nexport function toAgentMessage(message: ChatMessage): Message {\n  const textContent = getMessageText(message);\n  const toolCallParts = getMessageToolCalls(message);\n\n  switch (message.role) {\n    case \"user\":\n      return { role: \"user\", content: textContent };\n    case \"assistant\": {\n      const toolCalls: ToolCall[] | undefined = toolCallParts.length > 0\n        ? toolCallParts.map((p) => ({ id: p.toolCallId, name: p.name, args: p.args as JSONValue }))\n        : undefined;\n      return {\n        role: \"assistant\",\n        content: textContent,\n        toolCalls,\n      };\n    }\n    case \"system\":\n      return { role: \"system\", content: textContent };\n  }\n}\n\n/**\n * Convert an agent-sdk Message to ChatMessage\n */\nexport function fromAgentMessage(message: Message, id?: ChatId): ChatMessage {\n  const chatId = id ?? createChatId();\n  const now = new Date().toISOString();\n\n  const parts: MessagePart[] = [];\n\n  const textContent =\n    typeof message.content === \"string\"\n      ? message.content\n      : Array.isArray(message.content)\n        ? message.content\n            .filter((part) => part.type === \"text\")\n            .map((part) => part.text)\n            .join(\"\\n\")\n        : (message.content ?? \"\");\n\n  if (textContent) {\n    parts.push({ type: \"text\", text: textContent, status: \"complete\" });\n  }\n\n  if (message.role === \"assistant\" && message.toolCalls) {\n    for (const tc of message.toolCalls) {\n      parts.push({\n        type: \"tool_call\",\n        toolCallId: tc.id,\n        name: tc.name,\n        args: tc.args,\n        status: \"complete\",\n      });\n    }\n  }\n\n  if (message.role === \"tool\" && message.toolResults) {\n    for (const tr of message.toolResults) {\n      parts.push({\n        type: \"tool_call\",\n        toolCallId: tr.toolCallId,\n        name: tr.name,\n        args: {},\n        result: tr.result,\n        status: \"complete\",\n      });\n    }\n  }\n\n  if (parts.length === 0) {\n    parts.push({ type: \"text\", text: \"\", status: \"complete\" });\n  }\n\n  const role: ChatRole = message.role === \"tool\" ? \"assistant\" : message.role;\n\n  return {\n    id: chatId,\n    role,\n    parts,\n    createdAt: now,\n    status: \"complete\",\n  };\n}\n\n/**\n * Extract ToolResults from ToolCallParts that have results\n */\nexport function extractToolResults(message: ChatMessage): ToolResult[] {\n  return getMessageToolCalls(message)\n    .filter((p) => p.result !== undefined)\n    .map((p) => ({\n      toolCallId: p.toolCallId,\n      name: p.name,\n      result: p.result as JSONValue,\n      isError: p.status === \"error\" ? true : undefined,\n    }));\n}\n"]}

package/dist/chat/errors.cjs

@@ -0,0 +1,273 @@
+'use strict';
+
+// 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 }
+    );
+  });
+}
+
+exports.ChatError = ChatError;
+exports.ErrorCode = ErrorCode;
+exports.ExponentialBackoffStrategy = ExponentialBackoffStrategy;
+exports.classifyError = classifyError;
+exports.isRetryable = isRetryable;
+exports.withRetry = withRetry;
+//# sourceMappingURL=errors.cjs.map
+//# sourceMappingURL=errors.cjs.map