@witqq/agent-sdk 0.7.0 → 0.9.0

package/dist/chat/core.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/chat/core.ts"],"names":[],"mappings":"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","file":"core.cjs","sourcesContent":["/**\n * @witqq/agent-sdk/chat/core\n *\n * Foundational chat types and utilities: ChatMessage, ChatSession, ChatEvent,\n * IChatProvider, type guards, and AgentEvent↔ChatEvent bridge functions.\n */\n\nimport type {\n  AgentEvent,\n  Message,\n  ToolCall,\n  ToolResult,\n  ToolDefinition,\n  UsageData,\n  ModelInfo,\n  JSONValue,\n} from \"../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 *\n * @example\n * ```ts\n * const id = toChatId(\"550e8400-e29b-41d4-a716-446655440000\");\n * ```\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\" | \"archived\";\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  isArchived?: 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// ─── Convenience Getters ───────────────────────────────────────\n\n/**\n * Join all TextPart texts in a message\n * @param message - The chat message to extract text from\n * @returns Concatenated text content\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 * @param message - The chat message to extract tool calls from\n * @returns Array of ToolCallPart\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 * @param message - The chat message to extract reasoning from\n * @returns Concatenated reasoning content\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// ─── Supporting Types ──────────────────────────────────────────\n\n/** Options for sending a message */\nexport interface SendOpts { sessionId?: string; model?: string; signal?: AbortSignal; metadata?: Record<string, unknown>; }\n/** Options for creating a new session */\nexport interface CreateSessionOpts { id?: string; title?: string; model?: string; metadata?: Record<string, unknown>; }\n/** Options for listing sessions with pagination */\nexport interface ListOpts { limit?: number; offset?: number; status?: SessionStatus; }\n/** Options for backend execution (model, tokens, tools) */\nexport interface BackendOpts { model: string; signal?: AbortSignal; systemPrompt?: string; temperature?: number; maxTokens?: number; tools?: Record<string, unknown>; providerOptions?: Record<string, unknown>; }\n/** Context passed to tool execute functions */\nexport interface ToolContext { sessionId: string; userId?: string; signal: AbortSignal; }\n/** Configuration for creating a chat runtime */\nexport interface ChatRuntimeConfig { backend: string; model?: string; apiKey?: string; baseUrl?: string; context?: { maxTokens?: number; reserveTokens?: number; strategy?: \"sliding\" | \"summarize\" | \"truncate\"; }; retry?: { maxRetries?: number; initialDelay?: number; backoffFactor?: number; }; providerOptions?: Record<string, unknown>; }\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/** Session metadata */\nexport interface ChatSessionMetadata<TCustom extends Record<string, unknown> = Record<string, unknown>> {\n  messageCount: number;\n  totalTokens: number;\n  tags?: string[];\n  custom?: TCustom;\n}\n\n/** Chat session — a conversation with ordered messages */\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  /** 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;\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      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 */\n  onBeforeSend?(message: ChatMessage, context: ChatMiddlewareContext): ChatMessage | Promise<ChatMessage>;\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?: string;\n  context?: Record<string, unknown>;\n  /** Additional tools to include in this request */\n  tools?: ToolDefinition[];\n}\n\n/** Abstract chat provider — wraps an IAgentService for chat use */\nexport interface IChatProvider {\n  readonly name: string;\n  sendMessage(\n    session: ChatSession,\n    message: string,\n    options?: SendMessageOptions,\n  ): Promise<ChatMessage>;\n  streamMessage(\n    session: ChatSession,\n    message: string,\n    options?: SendMessageOptions,\n  ): AsyncIterable<ChatEvent>;\n  listModels(): Promise<ModelInfo[]>;\n  validate(): Promise<{ valid: boolean; errors: string[] }>;\n  dispose(): Promise<void>;\n}\n\n// ─── Type Guards ───────────────────────────────────────────────\n\n/**\n * Check if a value is a ChatMessage\n * @param value - Value to check\n * @returns True if value has ChatMessage shape\n */\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\" ||\n      obj.role === \"assistant\" ||\n      obj.role === \"system\") &&\n    Array.isArray(obj.parts) &&\n    typeof obj.createdAt === \"string\" &&\n    typeof obj.status === \"string\"\n  );\n}\n\n/**\n * Check if a value is a ChatSession\n * @param value - Value to check\n * @returns True if value has ChatSession shape\n */\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/**\n * Check if a value is a MessagePart\n * @param value - Value to check\n * @returns True if value has MessagePart shape\n */\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\" ||\n      obj.type === \"reasoning\" ||\n      obj.type === \"tool_call\" ||\n      obj.type === \"source\" ||\n      obj.type === \"file\")\n  );\n}\n\n/**\n * Check if a value is a TextPart\n * @param value - Value to check\n * @returns True if value is a TextPart\n */\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/**\n * Check if a value is a ToolCallPart\n * @param value - Value to check\n * @returns True if value is a ToolCallPart\n */\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/**\n * Check if a value is a ReasoningPart\n * @param value - Value to check\n * @returns True if value is a ReasoningPart\n */\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/**\n * Check if a value is a SourcePart\n * @param value - Value to check\n * @returns True if value is a SourcePart\n */\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/**\n * Check if a value is a FilePart\n * @param value - Value to check\n * @returns True if value is a FilePart\n */\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/**\n * Check if a value is a ChatEvent\n * @param value - Value to check\n * @returns True if value has a valid ChatEvent type\n */\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\",\n    \"message:delta\",\n    \"message:complete\",\n    \"tool:start\",\n    \"tool:complete\",\n    \"thinking:start\",\n    \"thinking:delta\",\n    \"thinking:end\",\n    \"permission:request\",\n    \"permission:response\",\n    \"usage\",\n    \"session:created\",\n    \"session:updated\",\n    \"error\",\n    \"typing:start\",\n    \"typing:end\",\n    \"heartbeat\",\n    \"done\",\n  ];\n  return validTypes.includes(obj.type as ChatEventType);\n}\n\n// ─── Agent Event Adapter ───────────────────────────────────────\n\n/**\n * Map a single AgentEvent to a ChatEvent (or null if no mapping)\n * @param event - The AgentEvent to convert\n * @param messageId - ChatId to associate with the event\n * @returns Corresponding ChatEvent or null if unmappable\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        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 * @param events - Source agent events\n * @param messageId - ChatId to associate with converted events\n * @returns Async iterable of ChatEvent (nulls filtered out)\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 * (e.g. message:start, message:complete, usage, permission:*, heartbeat).\n *\n * @param event - The ChatEvent to convert\n * @returns Corresponding AgentEvent or null if not accumulator-relevant\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 };\n    default:\n      return null;\n  }\n}\n\n// ─── Message Conversion ────────────────────────────────────────\n\n/**\n * Convert a ChatMessage to agent-sdk Message format\n * @param message - The ChatMessage to convert\n * @returns agent-sdk Message\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 * @param message - The agent-sdk Message to convert\n * @param id - Optional ChatId (auto-generated if omitted)\n * @returns ChatMessage with status \"complete\"\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  // Build text content\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  // Add tool calls from assistant messages\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  // Add tool results — map 'tool' role to 'assistant'\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  // Ensure at least an empty text part for empty messages\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 * @param message - The ChatMessage to extract results from\n * @returns Array of ToolResult for completed tool calls\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"]}
+{"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.cjs","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; finishReason?: 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} 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\nconst VALID_CHAT_EVENT_TYPES: ReadonlySet<string> = new Set([\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\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  return VALID_CHAT_EVENT_TYPES.has(obj.type as string);\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      return null;\n    case \"done\":\n      return { type: \"done\", finalOutput: event.finalOutput ?? undefined, finishReason: event.finishReason };\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 * @deprecated Use toAgentMessages() which correctly handles tool results.\n * This function drops tool results for assistant messages with completed tool calls.\n */\nexport function toAgentMessage(message: ChatMessage): Message {\n  return toAgentMessages(message)[0];\n}\n\n/**\n * Convert a ChatMessage to one or more agent-sdk Messages.\n * For assistant messages with completed tool calls, emits both:\n * 1. {role: \"assistant\", toolCalls: [...]} — the tool invocation\n * 2. {role: \"tool\", toolResults: [...]} — the tool results\n * This preserves tool results when replaying conversation history to backends.\n */\nexport function toAgentMessages(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      const assistantMsg: Message = {\n        role: \"assistant\",\n        content: textContent,\n        toolCalls,\n      };\n\n      // Emit tool results as a separate message if any tool calls have results\n      const toolResults = extractToolResults(message);\n      if (toolResults.length > 0) {\n        return [assistantMsg, { role: \"tool\", toolResults }];\n      }\n\n      return [assistantMsg];\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/core.d.cts

@@ -1,435 +1,94 @@
-import { T as ToolDefinition, d as ModelInfo, U as UsageData, A as AgentEvent, M as Message, e as ToolResult } from '../types-CqvUAYxt.cjs';
+import { c as ChatMessage, v as ToolCallPart, a as ChatEvent, g as ChatSession, F as FilePart, p as MessagePart, q as ReasoningPart, t as SourcePart, u as TextPart, b as ChatId } from '../types-DkSXALKg.cjs';
+export { C as ChatEventType, f as ChatIdLike, k as ChatMessageMetadata, l as ChatMessageStatus, e as ChatMiddleware, m as ChatMiddlewareContext, n as ChatRole, j as ChatSessionConfig, A as ChatSessionMetadata, o as IChatProvider, M as MessageStatus, O as ObservableSession, P as PartStatus, h as RuntimeSendOptions, R as RuntimeStatus, S as SendMessageOptions, r as SessionInfo, s as SessionStatus, T as ToolCallStatus, w as createChatId, x as createTextMessage, y as isObservableSession, z as toChatId } from '../types-DkSXALKg.cjs';
+import { A as AgentEvent, d as Message, e as ToolResult } from '../agent-C6H2CgJA.cjs';
+import '../errors-C-so0M4t.cjs';
+import '../types-4vbcmPTp.cjs';
+import '../errors-CmVvczxZ.cjs';
 import 'zod';
 
 /**
- * @witqq/agent-sdk/chat/core
- *
- * Foundational chat types and utilities: ChatMessage, ChatSession, ChatEvent,
- * IChatProvider, type guards, and AgentEvent↔ChatEvent bridge functions.
+ * @witqq/agent-sdk — Chat utility functions
  */
 
-/** Branded type for unique identifiers */
-type ChatId = string & {
-    readonly __brand: "ChatId";
-};
-/**
- * Generate a new unique ChatId (crypto.randomUUID-based)
- * @returns Branded ChatId string
- */
-declare function createChatId(): ChatId;
-/**
- * Cast a string to ChatId with UUID format validation.
- * Use this instead of manual `as ChatId` type assertions.
- *
- * @param value - String to validate and cast
- * @returns Branded ChatId
- * @throws {TypeError} If value is not a valid UUID v4 format
- *
- * @example
- * ```ts
- * const id = toChatId("550e8400-e29b-41d4-a716-446655440000");
- * ```
- */
-declare function toChatId(value: string): ChatId;
-/**
- * Accepts either a plain string or branded ChatId for API convenience.
- * Use this in public API signatures so consumers don't need `as ChatId` casts.
- */
-type ChatIdLike = string | ChatId;
-/** Lifecycle status of a message part (text, reasoning, etc.) */
-type PartStatus = "pending" | "streaming" | "complete" | "error";
-/** Lifecycle status of a tool call within a message */
-type ToolCallStatus = "pending" | "running" | "requires_approval" | "complete" | "error" | "denied";
-/** Lifecycle status of an entire message */
-type MessageStatus = "pending" | "streaming" | "complete" | "error" | "cancelled";
-/** Lifecycle status of a chat session */
-type SessionStatus = "active" | "archived";
-/** Lifecycle status of the chat runtime */
-type RuntimeStatus = "idle" | "streaming" | "error" | "disposed";
-/** Plain text content part */
-interface TextPart {
-    type: "text";
-    text: string;
-    status: PartStatus;
-}
-/** Model reasoning/thinking content part */
-interface ReasoningPart {
-    type: "reasoning";
-    text: string;
-    status: PartStatus;
-}
-/** Tool invocation part with call ID, arguments, optional result */
-interface ToolCallPart {
-    type: "tool_call";
-    toolCallId: string;
-    name: string;
-    args: unknown;
-    result?: unknown;
-    status: ToolCallStatus;
-    error?: string;
-}
-/** Source reference part (URL citation) */
-interface SourcePart {
-    type: "source";
-    url: string;
-    title?: string;
-    status: PartStatus;
-}
-/** File attachment part (base64-encoded data) */
-interface FilePart {
-    type: "file";
-    name: string;
-    mimeType: string;
-    data: string;
-    status: PartStatus;
-}
-/** Union of all message part types */
-type MessagePart = TextPart | ReasoningPart | ToolCallPart | SourcePart | FilePart;
-/** Role of message author */
-type ChatRole = "user" | "assistant" | "system";
-/** Metadata attached to messages — useful preset for the TMetadata generic */
-interface ChatMessageMetadata {
-    model?: string;
-    backend?: string;
-    usage?: UsageData;
-    isSummary?: boolean;
-    isArchived?: boolean;
-    estimatedTokens?: number;
-    custom?: Record<string, unknown>;
-}
-/** Message status */
-type ChatMessageStatus = MessageStatus;
-/** A single chat message — the fundamental unit of conversation */
-interface ChatMessage<TMetadata = unknown> {
-    id: ChatId;
-    role: ChatRole;
-    parts: MessagePart[];
-    metadata?: TMetadata;
-    createdAt: string;
-    updatedAt?: string;
-    status: MessageStatus;
-}
 /**
  * Join all TextPart texts in a message
- * @param message - The chat message to extract text from
- * @returns Concatenated text content
  */
 declare function getMessageText(message: ChatMessage): string;
 /**
  * Filter all ToolCallParts from a message
- * @param message - The chat message to extract tool calls from
- * @returns Array of ToolCallPart
  */
 declare function getMessageToolCalls(message: ChatMessage): ToolCallPart[];
 /**
  * Join all ReasoningPart texts in a message
- * @param message - The chat message to extract reasoning from
- * @returns Concatenated reasoning content
  */
 declare function getMessageReasoning(message: ChatMessage): string;
-/** Options for sending a message */
-interface SendOpts {
-    sessionId?: string;
-    model?: string;
-    signal?: AbortSignal;
-    metadata?: Record<string, unknown>;
-}
-/** Options for creating a new session */
-interface CreateSessionOpts {
-    id?: string;
-    title?: string;
-    model?: string;
-    metadata?: Record<string, unknown>;
-}
-/** Options for listing sessions with pagination */
-interface ListOpts {
-    limit?: number;
-    offset?: number;
-    status?: SessionStatus;
-}
-/** Options for backend execution (model, tokens, tools) */
-interface BackendOpts {
-    model: string;
-    signal?: AbortSignal;
-    systemPrompt?: string;
-    temperature?: number;
-    maxTokens?: number;
-    tools?: Record<string, unknown>;
-    providerOptions?: Record<string, unknown>;
-}
-/** Context passed to tool execute functions */
-interface ToolContext {
-    sessionId: string;
-    userId?: string;
-    signal: AbortSignal;
-}
-/** Configuration for creating a chat runtime */
-interface ChatRuntimeConfig {
-    backend: string;
-    model?: string;
-    apiKey?: string;
-    baseUrl?: string;
-    context?: {
-        maxTokens?: number;
-        reserveTokens?: number;
-        strategy?: "sliding" | "summarize" | "truncate";
-    };
-    retry?: {
-        maxRetries?: number;
-        initialDelay?: number;
-        backoffFactor?: number;
-    };
-    providerOptions?: Record<string, unknown>;
-}
-/** Session configuration snapshot */
-interface ChatSessionConfig {
-    model: string;
-    backend: string;
-    systemPrompt?: string;
-    temperature?: number;
-    maxTokens?: number;
-}
-/** Session metadata */
-interface ChatSessionMetadata<TCustom extends Record<string, unknown> = Record<string, unknown>> {
-    messageCount: number;
-    totalTokens: number;
-    tags?: string[];
-    custom?: TCustom;
-}
-/** Chat session — a conversation with ordered messages */
-interface ChatSession<TCustom extends Record<string, unknown> = Record<string, unknown>> {
-    id: ChatId;
-    title?: string;
-    messages: ChatMessage[];
-    config: ChatSessionConfig;
-    metadata: ChatSessionMetadata<TCustom>;
-    status: SessionStatus;
-    createdAt: string;
-    updatedAt: string;
-    backendSessionId?: string;
-    /** Subscribe to session changes (for React useSyncExternalStore) */
-    subscribe?(callback: () => void): () => void;
-    /** Get immutable snapshot of session state (for React useSyncExternalStore) */
-    getSnapshot?(): ChatSession<TCustom>;
-    /** Last message in the session */
-    readonly lastMessage?: ChatMessage;
-}
-/** Lightweight session info for listing (without full message array) */
-interface SessionInfo {
-    id: ChatId;
-    title?: string;
-    status: SessionStatus;
-    messageCount: number;
-    lastMessage?: ChatMessage;
-    createdAt: string;
-    updatedAt: string;
-}
-/** Events emitted during chat operation */
-type ChatEvent = {
-    type: "message:start";
-    messageId: ChatId;
-    role: ChatRole;
-} | {
-    type: "message:delta";
-    messageId: ChatId;
-    text: string;
-} | {
-    type: "message:complete";
-    messageId: ChatId;
-    message: ChatMessage;
-} | {
-    type: "tool:start";
-    messageId: ChatId;
-    toolCallId: string;
-    toolName: string;
-    args: Record<string, unknown>;
-} | {
-    type: "tool:complete";
-    messageId: ChatId;
-    toolCallId: string;
-    toolName: string;
-    result: unknown;
-    isError?: boolean;
-} | {
-    type: "thinking:start";
-    messageId: ChatId;
-} | {
-    type: "thinking:delta";
-    messageId: ChatId;
-    text: string;
-} | {
-    type: "thinking:end";
-    messageId: ChatId;
-} | {
-    type: "permission:request";
-    messageId: ChatId;
-    toolName: string;
-    toolArgs: Record<string, unknown>;
-} | {
-    type: "permission:response";
-    messageId: ChatId;
-    toolName: string;
-    allowed: boolean;
-} | {
-    type: "usage";
-    promptTokens: number;
-    completionTokens: number;
-    model?: string;
-} | {
-    type: "session:created";
-    sessionId: ChatId;
-} | {
-    type: "session:updated";
-    sessionId: ChatId;
-} | {
-    type: "error";
-    error: string;
-    recoverable: boolean;
-    messageId?: ChatId;
-} | {
-    type: "typing:start";
-} | {
-    type: "typing:end";
-} | {
-    type: "heartbeat";
-} | {
-    type: "done";
-    finalOutput?: string;
-};
-/** All possible ChatEvent type strings */
-type ChatEventType = ChatEvent["type"];
-/** Context passed to ChatMiddleware hooks */
-interface ChatMiddlewareContext {
-    sessionId: ChatId;
-    signal: AbortSignal;
-}
-/** Runtime-level middleware for the send/receive lifecycle.
- *  Different from EventMiddleware which operates at the event bus level. */
-interface ChatMiddleware {
-    /** Transform message before sending to backend */
-    onBeforeSend?(message: ChatMessage, context: ChatMiddlewareContext): ChatMessage | Promise<ChatMessage>;
-    /** Transform/intercept stream events */
-    onEvent?(event: ChatEvent, context: ChatMiddlewareContext): ChatEvent | null | Promise<ChatEvent | null>;
-    /** Transform completed message after receiving from backend */
-    onAfterReceive?(message: ChatMessage, context: ChatMiddlewareContext): ChatMessage | Promise<ChatMessage>;
-    /** Intercept errors — return null to suppress, return error to propagate */
-    onError?(error: Error, context: ChatMiddlewareContext): Error | null | Promise<Error | null>;
-}
-/** Options for sending a message to a provider */
-interface SendMessageOptions {
-    signal?: AbortSignal;
-    model?: string;
-    context?: Record<string, unknown>;
-    /** Additional tools to include in this request */
-    tools?: ToolDefinition[];
-}
-/** Abstract chat provider — wraps an IAgentService for chat use */
-interface IChatProvider {
-    readonly name: string;
-    sendMessage(session: ChatSession, message: string, options?: SendMessageOptions): Promise<ChatMessage>;
-    streamMessage(session: ChatSession, message: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
-    listModels(): Promise<ModelInfo[]>;
-    validate(): Promise<{
-        valid: boolean;
-        errors: string[];
-    }>;
-    dispose(): Promise<void>;
-}
+
 /**
- * Check if a value is a ChatMessage
- * @param value - Value to check
- * @returns True if value has ChatMessage shape
+ * @witqq/agent-sdk — Chat type guards
  */
+
+/** Check if a value is a ChatMessage */
 declare function isChatMessage(value: unknown): value is ChatMessage;
-/**
- * Check if a value is a ChatSession
- * @param value - Value to check
- * @returns True if value has ChatSession shape
- */
+/** Check if a value is a ChatSession */
 declare function isChatSession(value: unknown): value is ChatSession;
-/**
- * Check if a value is a MessagePart
- * @param value - Value to check
- * @returns True if value has MessagePart shape
- */
+/** Check if a value is a MessagePart */
 declare function isMessagePart(value: unknown): value is MessagePart;
-/**
- * Check if a value is a TextPart
- * @param value - Value to check
- * @returns True if value is a TextPart
- */
+/** Check if a value is a TextPart */
 declare function isTextPart(value: unknown): value is TextPart;
-/**
- * Check if a value is a ToolCallPart
- * @param value - Value to check
- * @returns True if value is a ToolCallPart
- */
+/** Check if a value is a ToolCallPart */
 declare function isToolCallPart(value: unknown): value is ToolCallPart;
-/**
- * Check if a value is a ReasoningPart
- * @param value - Value to check
- * @returns True if value is a ReasoningPart
- */
+/** Check if a value is a ReasoningPart */
 declare function isReasoningPart(value: unknown): value is ReasoningPart;
-/**
- * Check if a value is a SourcePart
- * @param value - Value to check
- * @returns True if value is a SourcePart
- */
+/** Check if a value is a SourcePart */
 declare function isSourcePart(value: unknown): value is SourcePart;
-/**
- * Check if a value is a FilePart
- * @param value - Value to check
- * @returns True if value is a FilePart
- */
+/** Check if a value is a FilePart */
 declare function isFilePart(value: unknown): value is FilePart;
+/** Check if a value is a ChatEvent */
+declare function isChatEvent(value: unknown): value is ChatEvent;
+
 /**
- * Check if a value is a ChatEvent
- * @param value - Value to check
- * @returns True if value has a valid ChatEvent type
+ * @witqq/agent-sdk — AgentEvent ↔ ChatEvent bridge
  */
-declare function isChatEvent(value: unknown): value is ChatEvent;
+
 /**
  * Map a single AgentEvent to a ChatEvent (or null if no mapping)
- * @param event - The AgentEvent to convert
- * @param messageId - ChatId to associate with the event
- * @returns Corresponding ChatEvent or null if unmappable
  */
 declare function agentEventToChatEvent(event: AgentEvent, messageId: ChatId): ChatEvent | null;
 /**
  * Convert AgentEvent async iterable to ChatEvent async iterable
- * @param events - Source agent events
- * @param messageId - ChatId to associate with converted events
- * @returns Async iterable of ChatEvent (nulls filtered out)
  */
 declare function adaptAgentEvents(events: AsyncIterable<AgentEvent>, messageId: ChatId): AsyncIterable<ChatEvent>;
 /**
  * Map a ChatEvent back to an AgentEvent for accumulator consumption.
- * Returns null for events that don't map to accumulator-relevant AgentEvents
- * (e.g. message:start, message:complete, usage, permission:*, heartbeat).
- *
- * @param event - The ChatEvent to convert
- * @returns Corresponding AgentEvent or null if not accumulator-relevant
+ * Returns null for events that don't map to accumulator-relevant AgentEvents.
  */
 declare function chatEventToAgentEvent(event: ChatEvent): AgentEvent | null;
+
+/**
+ * @witqq/agent-sdk — ChatMessage ↔ agent-sdk Message conversion
+ */
+
 /**
- * Convert a ChatMessage to agent-sdk Message format
- * @param message - The ChatMessage to convert
- * @returns agent-sdk Message
+ * Convert a ChatMessage to agent-sdk Message format.
+ * @deprecated Use toAgentMessages() which correctly handles tool results.
+ * This function drops tool results for assistant messages with completed tool calls.
  */
 declare function toAgentMessage(message: ChatMessage): Message;
+/**
+ * Convert a ChatMessage to one or more agent-sdk Messages.
+ * For assistant messages with completed tool calls, emits both:
+ * 1. {role: "assistant", toolCalls: [...]} — the tool invocation
+ * 2. {role: "tool", toolResults: [...]} — the tool results
+ * This preserves tool results when replaying conversation history to backends.
+ */
+declare function toAgentMessages(message: ChatMessage): Message[];
 /**
  * Convert an agent-sdk Message to ChatMessage
- * @param message - The agent-sdk Message to convert
- * @param id - Optional ChatId (auto-generated if omitted)
- * @returns ChatMessage with status "complete"
  */
 declare function fromAgentMessage(message: Message, id?: ChatId): ChatMessage;
 /**
  * Extract ToolResults from ToolCallParts that have results
- * @param message - The ChatMessage to extract results from
- * @returns Array of ToolResult for completed tool calls
  */
 declare function extractToolResults(message: ChatMessage): ToolResult[];
 
-export { type BackendOpts, type ChatEvent, type ChatEventType, type ChatId, type ChatIdLike, type ChatMessage, type ChatMessageMetadata, type ChatMessageStatus, type ChatMiddleware, type ChatMiddlewareContext, type ChatRole, type ChatRuntimeConfig, type ChatSession, type ChatSessionConfig, type ChatSessionMetadata, type CreateSessionOpts, type FilePart, type IChatProvider, type ListOpts, type MessagePart, type MessageStatus, type PartStatus, type ReasoningPart, type RuntimeStatus, type SendMessageOptions, type SendOpts, type SessionInfo, type SessionStatus, type SourcePart, type TextPart, type ToolCallPart, type ToolCallStatus, type ToolContext, adaptAgentEvents, agentEventToChatEvent, chatEventToAgentEvent, createChatId, extractToolResults, fromAgentMessage, getMessageReasoning, getMessageText, getMessageToolCalls, isChatEvent, isChatMessage, isChatSession, isFilePart, isMessagePart, isReasoningPart, isSourcePart, isTextPart, isToolCallPart, toAgentMessage, toChatId };
+export { ChatEvent, ChatId, ChatMessage, ChatSession, FilePart, MessagePart, ReasoningPart, SourcePart, TextPart, ToolCallPart, adaptAgentEvents, agentEventToChatEvent, chatEventToAgentEvent, extractToolResults, fromAgentMessage, getMessageReasoning, getMessageText, getMessageToolCalls, isChatEvent, isChatMessage, isChatSession, isFilePart, isMessagePart, isReasoningPart, isSourcePart, isTextPart, isToolCallPart, toAgentMessage, toAgentMessages };