@elqnt/chat 3.1.0 → 3.5.0

package/dist/api/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../api/index.ts","../../api/stream-api.ts","../../api/memory.ts"],"sourcesContent":["/**\n * Chat API\n *\n * API functions for chat operations.\n *\n * ## Browser API (uses @elqnt/api-client)\n * ```typescript\n * import { getChatHistoryApi, getChatApi } from \"@elqnt/chat/api\";\n *\n * const history = await getChatHistoryApi({ baseUrl, orgId, limit: 10 });\n * const chat = await getChatApi(chatKey, { baseUrl, orgId });\n * ```\n *\n * ## Stream API (direct HTTP calls)\n * ```typescript\n * import { createChat, sendChatMessage, loadChat } from \"@elqnt/chat/api\";\n *\n * const chatKey = await createChat({ baseUrl, orgId, userId });\n * await sendChatMessage({ baseUrl, orgId, chatKey, userId, content: \"Hello!\" });\n * ```\n */\n\nimport { browserApiRequest } from \"@elqnt/api-client/browser\";\nimport type { ApiResponse, ApiClientOptions } from \"@elqnt/api-client\";\nimport type { ResponseMetadata } from \"@elqnt/types\";\nimport type { ChatSummary, Chat } from \"../models\";\n\n// Re-export types from models\nexport type { ChatSummary, Chat } from \"../models\";\n\n// Re-export stream API functions\nexport {\n  createChat,\n  sendChatMessage,\n  loadChat,\n  endChat,\n  sendTypingIndicator,\n  sendEvent,\n} from \"./stream-api\";\n\nexport type {\n  StreamApiOptions,\n  StreamApiResponse,\n  CreateChatApiOptions,\n  CreateChatResponseData,\n  SendMessageApiOptions,\n  LoadChatApiOptions,\n  LoadChatResponseData,\n  EndChatApiOptions,\n  TypingApiOptions,\n  SendEventApiOptions,\n} from \"./stream-api\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface ChatHistoryResponse {\n  chats: ChatSummary[];\n  total: number;\n  hasMore: boolean;\n  metadata: ResponseMetadata;\n}\n\nexport interface ChatResponse {\n  chat: ChatSummary;\n  metadata: ResponseMetadata;\n}\n\nexport interface UpdateChatResponse {\n  chatKey: string;\n  title: string;\n  pinned: boolean;\n  metadata: ResponseMetadata;\n}\n\nexport interface ActiveChatsResponse {\n  chats: ChatSummary[];\n  metadata: ResponseMetadata;\n}\n\nexport interface ActiveChatsCountResponse {\n  count: number;\n  metadata: ResponseMetadata;\n}\n\nexport interface WaitingChatsCountResponse {\n  count: number;\n  metadata: ResponseMetadata;\n}\n\nexport interface QueueResponse {\n  queues: Queue[];\n  metadata: ResponseMetadata;\n}\n\nexport interface Queue {\n  id: string;\n  name: string;\n  agentId: string;\n  waitingCount: number;\n  activeCount: number;\n}\n\nexport interface AgentSession {\n  agentId: string;\n  userId: string;\n  userEmail: string;\n  status: string;\n  connectedAt: string;\n  lastActivityAt: string;\n}\n\nexport interface OnlineSessionsResponse {\n  sessions: AgentSession[];\n  metadata: ResponseMetadata;\n}\n\nexport interface AgentSessionResponse {\n  session: AgentSession;\n  metadata: ResponseMetadata;\n}\n\n// =============================================================================\n// CHAT HISTORY\n// =============================================================================\n\nexport async function getChatHistoryApi(\n  options: ApiClientOptions & { limit?: number; offset?: number; skipCache?: boolean }\n): Promise<ApiResponse<ChatHistoryResponse>> {\n  return browserApiRequest(\"/api/v1/chats\", {\n    method: \"POST\",\n    body: {\n      limit: options.limit || 15,\n      offset: options.offset || 0,\n      ...(options.skipCache ? { skipCache: true } : {}),\n    },\n    ...options,\n  });\n}\n\nexport async function getChatApi(\n  chatKey: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<ChatResponse>> {\n  return browserApiRequest(`/api/v1/chats/${chatKey}`, {\n    method: \"GET\",\n    ...options,\n  });\n}\n\nexport async function updateChatApi(\n  chatKey: string,\n  updates: { title?: string; pinned?: boolean },\n  options: ApiClientOptions\n): Promise<ApiResponse<UpdateChatResponse>> {\n  return browserApiRequest(`/api/v1/chats/${chatKey}`, {\n    method: \"PATCH\",\n    body: updates,\n    ...options,\n  });\n}\n\nexport async function deleteChatApi(\n  chatKey: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return browserApiRequest(`/api/v1/chats/${chatKey}`, {\n    method: \"DELETE\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// ACTIVE CHATS\n// =============================================================================\n\nexport async function getActiveChatsCountApi(\n  options: ApiClientOptions\n): Promise<ApiResponse<ActiveChatsCountResponse>> {\n  return browserApiRequest(\"/api/v1/chats/active/count\", {\n    method: \"GET\",\n    ...options,\n  });\n}\n\nexport async function getActiveChatsApi(\n  options: ApiClientOptions & { pastHours?: number }\n): Promise<ApiResponse<ActiveChatsResponse>> {\n  const params = new URLSearchParams();\n  if (options.pastHours) params.set(\"pastHours\", String(options.pastHours));\n  const queryString = params.toString();\n  return browserApiRequest(`/api/v1/chats/active${queryString ? `?${queryString}` : \"\"}`, {\n    method: \"GET\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// PROJECT CHATS\n// =============================================================================\n\nexport async function updateProjectChatTitleApi(\n  projectId: string,\n  chatKey: string,\n  title: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return browserApiRequest(`/api/v1/projects/${projectId}/chats/${chatKey}/title`, {\n    method: \"PUT\",\n    body: { title },\n    ...options,\n  });\n}\n\nexport async function addChatToProjectApi(\n  projectId: string,\n  chatKey: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return browserApiRequest(`/api/v1/projects/${projectId}/chats`, {\n    method: \"POST\",\n    body: { chatKey },\n    ...options,\n  });\n}\n\n// =============================================================================\n// WAITING CHATS\n// =============================================================================\n\nexport async function getWaitingChatsCountApi(\n  options: ApiClientOptions\n): Promise<ApiResponse<WaitingChatsCountResponse>> {\n  return browserApiRequest(\"/api/v1/chats/waiting/count\", {\n    method: \"GET\",\n    ...options,\n  });\n}\n\nexport async function getChatsByUserApi(\n  userEmail: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<ChatHistoryResponse>> {\n  return browserApiRequest(`/api/v1/chats/user/${encodeURIComponent(userEmail)}`, {\n    method: \"GET\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// QUEUES\n// =============================================================================\n\nexport async function listQueuesApi(\n  options: ApiClientOptions\n): Promise<ApiResponse<QueueResponse>> {\n  return browserApiRequest(\"/api/v1/queues\", {\n    method: \"GET\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// AGENT SESSIONS\n// =============================================================================\n\nexport async function getOnlineSessionsApi(\n  options: ApiClientOptions\n): Promise<ApiResponse<OnlineSessionsResponse>> {\n  return browserApiRequest(\"/api/v1/agents/sessions/online\", {\n    method: \"GET\",\n    ...options,\n  });\n}\n\nexport async function getAgentSessionApi(\n  agentId: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<AgentSessionResponse>> {\n  return browserApiRequest(`/api/v1/agents/sessions/${agentId}`, {\n    method: \"GET\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// MEMORY\n// =============================================================================\n\nexport {\n  getProfileApi,\n  patchProfileApi,\n  replaceProfileApi,\n  clearProfileApi,\n  deleteContactApi,\n  deleteNoteApi,\n  getSummaryApi,\n  clearSummaryApi,\n  regenerateSummaryApi,\n} from \"./memory\";\n\nexport type { SummaryView } from \"./memory\";\n","/**\n * Stream API\n *\n * Low-level functions for chat streaming operations.\n * These are used internally by the transport layer but can also\n * be used directly for custom implementations.\n *\n * @example\n * ```typescript\n * import { createChat, sendChatMessage, loadChat } from \"@elqnt/chat/api\";\n *\n * // Create a new chat\n * const chatKey = await createChat({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   userId: \"user-456\",\n * });\n *\n * // Send a message\n * await sendChatMessage({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey,\n *   userId: \"user-456\",\n *   content: \"Hello!\",\n * });\n * ```\n */\n\nimport type { Chat, ChatMessage } from \"../models\";\n\n/**\n * Base options for all stream API calls\n */\nexport interface StreamApiOptions {\n  /** Base URL for the chat server */\n  baseUrl: string;\n  /** Organization ID */\n  orgId: string;\n  /** User ID */\n  userId: string;\n}\n\n/**\n * Response from stream API calls\n */\nexport interface StreamApiResponse<T = unknown> {\n  success: boolean;\n  data?: T;\n  error?: string;\n}\n\n/**\n * Create chat options\n */\nexport interface CreateChatApiOptions extends StreamApiOptions {\n  /** Optional metadata for the new chat */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Create chat response data\n */\nexport interface CreateChatResponseData {\n  chatKey: string;\n}\n\n/**\n * Send message options\n */\nexport interface SendMessageApiOptions extends StreamApiOptions {\n  /** Chat key */\n  chatKey: string;\n  /** Message content */\n  content: string;\n  /** Optional attachments */\n  attachments?: unknown[];\n  /** Optional message metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Load chat options\n */\nexport interface LoadChatApiOptions extends StreamApiOptions {\n  /** Chat key to load */\n  chatKey: string;\n}\n\n/**\n * Load chat response data\n */\nexport interface LoadChatResponseData {\n  chat: Chat;\n}\n\n/**\n * End chat options\n */\nexport interface EndChatApiOptions extends StreamApiOptions {\n  /** Chat key to end */\n  chatKey: string;\n  /** Optional end reason */\n  reason?: string;\n}\n\n/**\n * Typing indicator options\n */\nexport interface TypingApiOptions extends StreamApiOptions {\n  /** Chat key */\n  chatKey: string;\n  /** Whether user is typing */\n  typing: boolean;\n}\n\n/**\n * Generic event options\n */\nexport interface SendEventApiOptions extends StreamApiOptions {\n  /** Chat key */\n  chatKey: string;\n  /** Event type */\n  type: string;\n  /** Event data */\n  data?: Record<string, unknown>;\n}\n\n/**\n * Internal fetch helper\n */\nasync function streamFetch<T>(\n  url: string,\n  body: Record<string, unknown>\n): Promise<StreamApiResponse<T>> {\n  const response = await fetch(url, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify(body),\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text();\n    return {\n      success: false,\n      error: `API error: ${response.status} - ${errorText}`,\n    };\n  }\n\n  const data = await response.json();\n  return { success: true, data };\n}\n\n/**\n * Create a new chat session\n *\n * @param options - Create chat options\n * @returns Chat key of the created chat\n *\n * @example\n * ```typescript\n * const chatKey = await createChat({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   userId: \"user-456\",\n *   metadata: { source: \"website\" },\n * });\n * ```\n */\nexport async function createChat(\n  options: CreateChatApiOptions\n): Promise<string> {\n  const { baseUrl, orgId, userId, metadata } = options;\n\n  const result = await streamFetch<CreateChatResponseData>(\n    `${baseUrl}/create`,\n    { orgId, userId, metadata }\n  );\n\n  if (!result.success || !result.data?.chatKey) {\n    throw new Error(result.error || \"Failed to create chat\");\n  }\n\n  return result.data.chatKey;\n}\n\n/**\n * Send a message in a chat\n *\n * @param options - Send message options\n *\n * @example\n * ```typescript\n * await sendChatMessage({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   content: \"Hello!\",\n * });\n * ```\n */\nexport async function sendChatMessage(\n  options: SendMessageApiOptions\n): Promise<void> {\n  const { baseUrl, orgId, chatKey, userId, content, attachments, metadata } =\n    options;\n\n  const message: Partial<ChatMessage> = {\n    id: `msg_${Date.now()}_${Math.random().toString(36).slice(2)}`,\n    role: \"user\",\n    content,\n    time: Date.now(),\n    status: \"sending\",\n    senderId: userId,\n    createdAt: Date.now(),\n    attachments: attachments as ChatMessage[\"attachments\"],\n  };\n\n  const result = await streamFetch(`${baseUrl}/send`, {\n    orgId,\n    chatKey,\n    userId,\n    message,\n    metadata,\n  });\n\n  if (!result.success) {\n    throw new Error(result.error || \"Failed to send message\");\n  }\n}\n\n/**\n * Load an existing chat\n *\n * @param options - Load chat options\n * @returns The loaded chat object\n *\n * @example\n * ```typescript\n * const chat = await loadChat({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n * });\n * ```\n */\nexport async function loadChat(options: LoadChatApiOptions): Promise<Chat> {\n  const { baseUrl, orgId, chatKey, userId } = options;\n\n  const result = await streamFetch<LoadChatResponseData>(`${baseUrl}/load`, {\n    orgId,\n    chatKey,\n    userId,\n  });\n\n  if (!result.success || !result.data?.chat) {\n    throw new Error(result.error || \"Failed to load chat\");\n  }\n\n  return result.data.chat;\n}\n\n/**\n * End a chat session\n *\n * @param options - End chat options\n *\n * @example\n * ```typescript\n * await endChat({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   reason: \"User closed chat\",\n * });\n * ```\n */\nexport async function endChat(options: EndChatApiOptions): Promise<void> {\n  const { baseUrl, orgId, chatKey, userId, reason } = options;\n\n  const result = await streamFetch(`${baseUrl}/end`, {\n    orgId,\n    chatKey,\n    userId,\n    data: reason ? { reason } : undefined,\n  });\n\n  if (!result.success) {\n    throw new Error(result.error || \"Failed to end chat\");\n  }\n}\n\n/**\n * Send typing indicator\n *\n * @param options - Typing indicator options\n *\n * @example\n * ```typescript\n * // User started typing\n * await sendTypingIndicator({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   typing: true,\n * });\n *\n * // User stopped typing\n * await sendTypingIndicator({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   typing: false,\n * });\n * ```\n */\nexport async function sendTypingIndicator(\n  options: TypingApiOptions\n): Promise<void> {\n  const { baseUrl, orgId, chatKey, userId, typing } = options;\n\n  const result = await streamFetch(`${baseUrl}/typing`, {\n    orgId,\n    chatKey,\n    userId,\n    typing,\n  });\n\n  if (!result.success) {\n    throw new Error(result.error || \"Failed to send typing indicator\");\n  }\n}\n\n/**\n * Send a generic event\n *\n * @param options - Event options\n *\n * @example\n * ```typescript\n * await sendEvent({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   type: \"skill_activate\",\n *   data: { skillId: \"research\" },\n * });\n * ```\n */\nexport async function sendEvent(options: SendEventApiOptions): Promise<void> {\n  const { baseUrl, orgId, chatKey, userId, type, data } = options;\n\n  const result = await streamFetch(`${baseUrl}/event`, {\n    type,\n    orgId,\n    chatKey,\n    userId,\n    data,\n  });\n\n  if (!result.success) {\n    throw new Error(result.error || \"Failed to send event\");\n  }\n}\n","import { browserApiRequest } from \"@elqnt/api-client/browser\";\nimport type { ApiClientOptions, ApiResponse } from \"@elqnt/api-client\";\nimport type { MemoryProfile } from \"../models\";\n\nexport interface SummaryView {\n  chatKey: string;\n  text: string;\n  updatedAt: string;\n}\n\nexport const getProfileApi = (o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(\"/api/v1/memory/profile\", { method: \"GET\", ...o });\n\nexport const patchProfileApi = (patch: Partial<MemoryProfile>, o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(\"/api/v1/memory/profile\", { method: \"PATCH\", body: patch, ...o });\n\nexport const replaceProfileApi = (p: MemoryProfile, o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(\"/api/v1/memory/profile\", { method: \"PUT\", body: p, ...o });\n\nexport const clearProfileApi = (o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(\"/api/v1/memory/profile\", { method: \"DELETE\", ...o });\n\nexport const deleteContactApi = (name: string, o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(`/api/v1/memory/profile/contacts/${encodeURIComponent(name)}`, { method: \"DELETE\", ...o });\n\nexport const deleteNoteApi = (index: number, o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(`/api/v1/memory/profile/notes/${index}`, { method: \"DELETE\", ...o });\n\nexport const getSummaryApi = (chatKey: string, o: ApiClientOptions): Promise<ApiResponse<SummaryView>> =>\n  browserApiRequest(`/api/v1/chats/${chatKey}/summary`, { method: \"GET\", ...o });\n\nexport const clearSummaryApi = (chatKey: string, o: ApiClientOptions): Promise<ApiResponse<void>> =>\n  browserApiRequest(`/api/v1/chats/${chatKey}/summary`, { method: \"DELETE\", ...o });\n\nexport const regenerateSummaryApi = (chatKey: string, o: ApiClientOptions): Promise<ApiResponse<SummaryView>> =>\n  browserApiRequest(`/api/v1/chats/${chatKey}/summary/regenerate`, { method: \"POST\", ...o });\n"],"mappings":"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","names":["browserApiRequest","browserApiRequest"]}
+{"version":3,"sources":["../../api/index.ts","../../api/stream-api.ts","../../api/memory.ts"],"sourcesContent":["/**\n * Chat API\n *\n * API functions for chat operations.\n *\n * ## Browser API (uses @elqnt/api-client)\n * ```typescript\n * import { getChatHistoryApi, getChatApi } from \"@elqnt/chat/api\";\n *\n * const history = await getChatHistoryApi({ baseUrl, orgId, limit: 10 });\n * const chat = await getChatApi(chatKey, { baseUrl, orgId });\n * ```\n *\n * ## Stream API (direct HTTP calls)\n * ```typescript\n * import { createChat, sendChatMessage, loadChat } from \"@elqnt/chat/api\";\n *\n * const chatKey = await createChat({ baseUrl, orgId, userId });\n * await sendChatMessage({ baseUrl, orgId, chatKey, userId, content: \"Hello!\" });\n * ```\n */\n\nimport { browserApiRequest } from \"@elqnt/api-client/browser\";\nimport type { ApiResponse, ApiClientOptions } from \"@elqnt/api-client\";\nimport type { ResponseMetadata } from \"@elqnt/types\";\nimport type { ChatSummary, Chat } from \"../models\";\n\n// Re-export types from models\nexport type { ChatSummary, Chat } from \"../models\";\n\n// Re-export stream API functions\nexport {\n  createChat,\n  sendChatMessage,\n  loadChat,\n  endChat,\n  sendTypingIndicator,\n  sendEvent,\n} from \"./stream-api\";\n\nexport type {\n  StreamApiOptions,\n  StreamApiResponse,\n  CreateChatApiOptions,\n  CreateChatResponseData,\n  SendMessageApiOptions,\n  LoadChatApiOptions,\n  LoadChatResponseData,\n  EndChatApiOptions,\n  TypingApiOptions,\n  SendEventApiOptions,\n} from \"./stream-api\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface ChatHistoryResponse {\n  chats: ChatSummary[];\n  total: number;\n  hasMore: boolean;\n  metadata: ResponseMetadata;\n}\n\nexport interface ChatResponse {\n  chat: ChatSummary;\n  metadata: ResponseMetadata;\n}\n\nexport interface UpdateChatResponse {\n  chatKey: string;\n  title: string;\n  pinned: boolean;\n  metadata: ResponseMetadata;\n}\n\nexport interface ActiveChatsResponse {\n  chats: ChatSummary[];\n  metadata: ResponseMetadata;\n}\n\nexport interface ActiveChatsCountResponse {\n  count: number;\n  metadata: ResponseMetadata;\n}\n\nexport interface WaitingChatsCountResponse {\n  count: number;\n  metadata: ResponseMetadata;\n}\n\nexport interface QueueResponse {\n  queues: Queue[];\n  metadata: ResponseMetadata;\n}\n\nexport interface Queue {\n  id: string;\n  name: string;\n  agentId: string;\n  waitingCount: number;\n  activeCount: number;\n}\n\nexport interface AgentSession {\n  agentId: string;\n  userId: string;\n  userEmail: string;\n  status: string;\n  connectedAt: string;\n  lastActivityAt: string;\n}\n\nexport interface OnlineSessionsResponse {\n  sessions: AgentSession[];\n  metadata: ResponseMetadata;\n}\n\nexport interface AgentSessionResponse {\n  session: AgentSession;\n  metadata: ResponseMetadata;\n}\n\n// =============================================================================\n// CHAT HISTORY\n// =============================================================================\n\nexport async function getChatHistoryApi(\n  options: ApiClientOptions & { limit?: number; offset?: number; skipCache?: boolean }\n): Promise<ApiResponse<ChatHistoryResponse>> {\n  return browserApiRequest(\"/api/v1/chats\", {\n    method: \"POST\",\n    body: {\n      limit: options.limit || 15,\n      offset: options.offset || 0,\n      ...(options.skipCache ? { skipCache: true } : {}),\n    },\n    ...options,\n  });\n}\n\nexport async function getChatApi(\n  chatKey: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<ChatResponse>> {\n  return browserApiRequest(`/api/v1/chats/${chatKey}`, {\n    method: \"GET\",\n    ...options,\n  });\n}\n\nexport async function updateChatApi(\n  chatKey: string,\n  updates: { title?: string; pinned?: boolean },\n  options: ApiClientOptions\n): Promise<ApiResponse<UpdateChatResponse>> {\n  return browserApiRequest(`/api/v1/chats/${chatKey}`, {\n    method: \"PATCH\",\n    body: updates,\n    ...options,\n  });\n}\n\nexport async function deleteChatApi(\n  chatKey: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return browserApiRequest(`/api/v1/chats/${chatKey}`, {\n    method: \"DELETE\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// ACTIVE CHATS\n// =============================================================================\n\nexport async function getActiveChatsCountApi(\n  options: ApiClientOptions\n): Promise<ApiResponse<ActiveChatsCountResponse>> {\n  return browserApiRequest(\"/api/v1/chats/active/count\", {\n    method: \"GET\",\n    ...options,\n  });\n}\n\nexport async function getActiveChatsApi(\n  options: ApiClientOptions & { pastHours?: number }\n): Promise<ApiResponse<ActiveChatsResponse>> {\n  const params = new URLSearchParams();\n  if (options.pastHours) params.set(\"pastHours\", String(options.pastHours));\n  const queryString = params.toString();\n  return browserApiRequest(`/api/v1/chats/active${queryString ? `?${queryString}` : \"\"}`, {\n    method: \"GET\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// PROJECT CHATS\n// =============================================================================\n\nexport async function updateProjectChatTitleApi(\n  projectId: string,\n  chatKey: string,\n  title: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return browserApiRequest(`/api/v1/projects/${projectId}/chats/${chatKey}/title`, {\n    method: \"PUT\",\n    body: { title },\n    ...options,\n  });\n}\n\nexport async function addChatToProjectApi(\n  projectId: string,\n  chatKey: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return browserApiRequest(`/api/v1/projects/${projectId}/chats`, {\n    method: \"POST\",\n    body: { chatKey },\n    ...options,\n  });\n}\n\n// =============================================================================\n// WAITING CHATS\n// =============================================================================\n\nexport async function getWaitingChatsCountApi(\n  options: ApiClientOptions\n): Promise<ApiResponse<WaitingChatsCountResponse>> {\n  return browserApiRequest(\"/api/v1/chats/waiting/count\", {\n    method: \"GET\",\n    ...options,\n  });\n}\n\nexport async function getChatsByUserApi(\n  userEmail: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<ChatHistoryResponse>> {\n  return browserApiRequest(`/api/v1/chats/user/${encodeURIComponent(userEmail)}`, {\n    method: \"GET\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// QUEUES\n// =============================================================================\n\nexport async function listQueuesApi(\n  options: ApiClientOptions\n): Promise<ApiResponse<QueueResponse>> {\n  return browserApiRequest(\"/api/v1/queues\", {\n    method: \"GET\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// AGENT SESSIONS\n// =============================================================================\n\nexport async function getOnlineSessionsApi(\n  options: ApiClientOptions\n): Promise<ApiResponse<OnlineSessionsResponse>> {\n  return browserApiRequest(\"/api/v1/agents/sessions/online\", {\n    method: \"GET\",\n    ...options,\n  });\n}\n\nexport async function getAgentSessionApi(\n  agentId: string,\n  options: ApiClientOptions\n): Promise<ApiResponse<AgentSessionResponse>> {\n  return browserApiRequest(`/api/v1/agents/sessions/${agentId}`, {\n    method: \"GET\",\n    ...options,\n  });\n}\n\n// =============================================================================\n// MEMORY\n// =============================================================================\n\nexport {\n  getProfileApi,\n  patchProfileApi,\n  replaceProfileApi,\n  clearProfileApi,\n  deleteContactApi,\n  deleteNoteApi,\n  getSummaryApi,\n  clearSummaryApi,\n  regenerateSummaryApi,\n} from \"./memory\";\n\nexport type { SummaryView } from \"./memory\";\n","/**\n * Stream API\n *\n * Low-level functions for chat streaming operations.\n * These are used internally by the transport layer but can also\n * be used directly for custom implementations.\n *\n * @example\n * ```typescript\n * import { createChat, sendChatMessage, loadChat } from \"@elqnt/chat/api\";\n *\n * // Create a new chat\n * const chatKey = await createChat({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   userId: \"user-456\",\n * });\n *\n * // Send a message\n * await sendChatMessage({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey,\n *   userId: \"user-456\",\n *   content: \"Hello!\",\n * });\n * ```\n */\n\nimport type { Chat, ChatMessage } from \"../models\";\n\n/**\n * Base options for all stream API calls\n */\nexport interface StreamApiOptions {\n  /** Base URL for the chat server */\n  baseUrl: string;\n  /** Organization ID */\n  orgId: string;\n  /** User ID */\n  userId: string;\n  /**\n   * Tier-2 signed token (REQUIRED in production). The chat service authorizes\n   * the request from this token and derives orgId/userId/product from its\n   * claims (the body orgId/userId are not trusted for authorization). Pass a\n   * static `token`, or a `getToken` provider that is awaited per call so\n   * short-lived tokens refresh. See SKILL.md and @elqnt/api-client/server's\n   * generateServerToken for the claim shape.\n   */\n  token?: string;\n  /** Token provider, awaited per call. Takes precedence over `token`. */\n  getToken?: () => Promise<string | null | undefined> | string | null | undefined;\n}\n\n/** Resolve a per-call token from a static value or provider (never throws). */\nasync function resolveToken(opts: {\n  token?: string;\n  getToken?: StreamApiOptions[\"getToken\"];\n}): Promise<string | undefined> {\n  if (opts.getToken) {\n    try {\n      return (await opts.getToken()) ?? undefined;\n    } catch {\n      return undefined;\n    }\n  }\n  return opts.token ?? undefined;\n}\n\n/**\n * Response from stream API calls\n */\nexport interface StreamApiResponse<T = unknown> {\n  success: boolean;\n  data?: T;\n  error?: string;\n}\n\n/**\n * Create chat options\n */\nexport interface CreateChatApiOptions extends StreamApiOptions {\n  /** Optional metadata for the new chat */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Create chat response data\n */\nexport interface CreateChatResponseData {\n  chatKey: string;\n}\n\n/**\n * Send message options\n */\nexport interface SendMessageApiOptions extends StreamApiOptions {\n  /** Chat key */\n  chatKey: string;\n  /** Message content */\n  content: string;\n  /** Optional attachments */\n  attachments?: unknown[];\n  /** Optional message metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Load chat options\n */\nexport interface LoadChatApiOptions extends StreamApiOptions {\n  /** Chat key to load */\n  chatKey: string;\n}\n\n/**\n * Load chat response data\n */\nexport interface LoadChatResponseData {\n  chat: Chat;\n}\n\n/**\n * End chat options\n */\nexport interface EndChatApiOptions extends StreamApiOptions {\n  /** Chat key to end */\n  chatKey: string;\n  /** Optional end reason */\n  reason?: string;\n}\n\n/**\n * Typing indicator options\n */\nexport interface TypingApiOptions extends StreamApiOptions {\n  /** Chat key */\n  chatKey: string;\n  /** Whether user is typing */\n  typing: boolean;\n}\n\n/**\n * Generic event options\n */\nexport interface SendEventApiOptions extends StreamApiOptions {\n  /** Chat key */\n  chatKey: string;\n  /** Event type */\n  type: string;\n  /** Event data */\n  data?: Record<string, unknown>;\n}\n\n/**\n * Internal fetch helper\n */\nasync function streamFetch<T>(\n  url: string,\n  body: Record<string, unknown>,\n  token?: string\n): Promise<StreamApiResponse<T>> {\n  const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n  if (token) headers[\"Authorization\"] = `Bearer ${token}`;\n\n  const response = await fetch(url, {\n    method: \"POST\",\n    headers,\n    body: JSON.stringify(body),\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text();\n    return {\n      success: false,\n      error: `API error: ${response.status} - ${errorText}`,\n    };\n  }\n\n  const data = await response.json();\n  return { success: true, data };\n}\n\n/**\n * Create a new chat session\n *\n * @param options - Create chat options\n * @returns Chat key of the created chat\n *\n * @example\n * ```typescript\n * const chatKey = await createChat({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   userId: \"user-456\",\n *   metadata: { source: \"website\" },\n * });\n * ```\n */\nexport async function createChat(\n  options: CreateChatApiOptions\n): Promise<string> {\n  const { baseUrl, orgId, userId, metadata } = options;\n  const token = await resolveToken(options);\n\n  const result = await streamFetch<CreateChatResponseData>(\n    `${baseUrl}/create`,\n    { orgId, userId, metadata },\n    token\n  );\n\n  if (!result.success || !result.data?.chatKey) {\n    throw new Error(result.error || \"Failed to create chat\");\n  }\n\n  return result.data.chatKey;\n}\n\n/**\n * Send a message in a chat\n *\n * @param options - Send message options\n *\n * @example\n * ```typescript\n * await sendChatMessage({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   content: \"Hello!\",\n * });\n * ```\n */\nexport async function sendChatMessage(\n  options: SendMessageApiOptions\n): Promise<void> {\n  const { baseUrl, orgId, chatKey, userId, content, attachments, metadata } =\n    options;\n  const token = await resolveToken(options);\n\n  const message: Partial<ChatMessage> = {\n    id: `msg_${Date.now()}_${Math.random().toString(36).slice(2)}`,\n    role: \"user\",\n    content,\n    time: Date.now(),\n    status: \"sending\",\n    senderId: userId,\n    createdAt: Date.now(),\n    attachments: attachments as ChatMessage[\"attachments\"],\n  };\n\n  const result = await streamFetch(`${baseUrl}/send`, {\n    orgId,\n    chatKey,\n    userId,\n    message,\n    metadata,\n  }, token);\n\n  if (!result.success) {\n    throw new Error(result.error || \"Failed to send message\");\n  }\n}\n\n/**\n * Load an existing chat\n *\n * @param options - Load chat options\n * @returns The loaded chat object\n *\n * @example\n * ```typescript\n * const chat = await loadChat({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n * });\n * ```\n */\nexport async function loadChat(options: LoadChatApiOptions): Promise<Chat> {\n  const { baseUrl, orgId, chatKey, userId } = options;\n  const token = await resolveToken(options);\n\n  const result = await streamFetch<LoadChatResponseData>(`${baseUrl}/load`, {\n    orgId,\n    chatKey,\n    userId,\n  }, token);\n\n  if (!result.success || !result.data?.chat) {\n    throw new Error(result.error || \"Failed to load chat\");\n  }\n\n  return result.data.chat;\n}\n\n/**\n * End a chat session\n *\n * @param options - End chat options\n *\n * @example\n * ```typescript\n * await endChat({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   reason: \"User closed chat\",\n * });\n * ```\n */\nexport async function endChat(options: EndChatApiOptions): Promise<void> {\n  const { baseUrl, orgId, chatKey, userId, reason } = options;\n  const token = await resolveToken(options);\n\n  const result = await streamFetch(`${baseUrl}/end`, {\n    orgId,\n    chatKey,\n    userId,\n    data: reason ? { reason } : undefined,\n  }, token);\n\n  if (!result.success) {\n    throw new Error(result.error || \"Failed to end chat\");\n  }\n}\n\n/**\n * Send typing indicator\n *\n * @param options - Typing indicator options\n *\n * @example\n * ```typescript\n * // User started typing\n * await sendTypingIndicator({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   typing: true,\n * });\n *\n * // User stopped typing\n * await sendTypingIndicator({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   typing: false,\n * });\n * ```\n */\nexport async function sendTypingIndicator(\n  options: TypingApiOptions\n): Promise<void> {\n  const { baseUrl, orgId, chatKey, userId, typing } = options;\n  const token = await resolveToken(options);\n\n  const result = await streamFetch(`${baseUrl}/typing`, {\n    orgId,\n    chatKey,\n    userId,\n    typing,\n  }, token);\n\n  if (!result.success) {\n    throw new Error(result.error || \"Failed to send typing indicator\");\n  }\n}\n\n/**\n * Send a generic event\n *\n * @param options - Event options\n *\n * @example\n * ```typescript\n * await sendEvent({\n *   baseUrl: \"https://api.example.com/chat\",\n *   orgId: \"org-123\",\n *   chatKey: \"chat-789\",\n *   userId: \"user-456\",\n *   type: \"skill_activate\",\n *   data: { skillId: \"research\" },\n * });\n * ```\n */\nexport async function sendEvent(options: SendEventApiOptions): Promise<void> {\n  const { baseUrl, orgId, chatKey, userId, type, data } = options;\n  const token = await resolveToken(options);\n\n  const result = await streamFetch(`${baseUrl}/event`, {\n    type,\n    orgId,\n    chatKey,\n    userId,\n    data,\n  }, token);\n\n  if (!result.success) {\n    throw new Error(result.error || \"Failed to send event\");\n  }\n}\n","import { browserApiRequest } from \"@elqnt/api-client/browser\";\nimport type { ApiClientOptions, ApiResponse } from \"@elqnt/api-client\";\nimport type { MemoryProfile } from \"../models\";\n\nexport interface SummaryView {\n  chatKey: string;\n  text: string;\n  updatedAt: string;\n}\n\nexport const getProfileApi = (o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(\"/api/v1/memory/profile\", { method: \"GET\", ...o });\n\nexport const patchProfileApi = (patch: Partial<MemoryProfile>, o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(\"/api/v1/memory/profile\", { method: \"PATCH\", body: patch, ...o });\n\nexport const replaceProfileApi = (p: MemoryProfile, o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(\"/api/v1/memory/profile\", { method: \"PUT\", body: p, ...o });\n\nexport const clearProfileApi = (o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(\"/api/v1/memory/profile\", { method: \"DELETE\", ...o });\n\nexport const deleteContactApi = (name: string, o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(`/api/v1/memory/profile/contacts/${encodeURIComponent(name)}`, { method: \"DELETE\", ...o });\n\nexport const deleteNoteApi = (index: number, o: ApiClientOptions): Promise<ApiResponse<MemoryProfile>> =>\n  browserApiRequest(`/api/v1/memory/profile/notes/${index}`, { method: \"DELETE\", ...o });\n\nexport const getSummaryApi = (chatKey: string, o: ApiClientOptions): Promise<ApiResponse<SummaryView>> =>\n  browserApiRequest(`/api/v1/chats/${chatKey}/summary`, { method: \"GET\", ...o });\n\nexport const clearSummaryApi = (chatKey: string, o: ApiClientOptions): Promise<ApiResponse<void>> =>\n  browserApiRequest(`/api/v1/chats/${chatKey}/summary`, { method: \"DELETE\", ...o });\n\nexport const regenerateSummaryApi = (chatKey: string, o: ApiClientOptions): Promise<ApiResponse<SummaryView>> =>\n  browserApiRequest(`/api/v1/chats/${chatKey}/summary/regenerate`, { method: \"POST\", ...o });\n"],"mappings":"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","names":["browserApiRequest","browserApiRequest"]}

package/dist/hooks/index.d.mts

@@ -1,8 +1,8 @@
-export { UseAsyncOptions, UseAsyncReturn, useApiAsync } from '@elqnt/api-client/hooks';
 import { ChatEvent, Chat, ChatMessage, ChatSummary, MemoryProfile } from '../models/index.mjs';
-import { C as ChatTransport, e as TransportError, g as TransportState, R as RetryConfig, b as ConnectionMetrics, U as Unsubscribe } from '../types-CQHtUQ6p.mjs';
+import { C as ChatTransport, e as TransportError, g as TransportState, R as RetryConfig, b as ConnectionMetrics, U as Unsubscribe } from '../types-CLtQA6Qq.mjs';
 import { ApiClientOptions } from '@elqnt/api-client';
 import { Queue, AgentSession, SummaryView } from '../api/index.mjs';
+export { UseAsyncOptions, UseAsyncReturn, useApiAsync } from '@elqnt/api-client/hooks';
 import '@elqnt/kg';
 import '@elqnt/types';
 import '@elqnt/docs';
@@ -33,6 +33,19 @@ interface UseChatOptions {
     retryConfig?: RetryConfig;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Tier-2 authorization (REQUIRED in production). Chat realtime reaches the
+     * chat service directly, bypassing the API gateway, so the service authorizes
+     * each connection from a signed token and derives orgId/userId/product from
+     * its claims. Provide `getToken` (preferred — awaited on every connect and
+     * REST send so short-lived tokens refresh over a long stream) or a static
+     * `token`. Mint it from a server route (e.g. /api/gateway-token or a
+     * dedicated chat-token route); the token's org/user MUST match this hook's
+     * orgId/userId. See packages/@elqnt/chat/SKILL.md.
+     */
+    getToken?: () => Promise<string | null | undefined> | string | null | undefined;
+    /** Static signed token. Ignored when `getToken` is provided. */
+    token?: string;
 }
 /**
  * Chat hook return type
@@ -50,8 +63,8 @@ interface UseChatReturn {
     startChat: (metadata?: Record<string, unknown>) => Promise<string>;
     /** Load an existing chat, returns the loaded chat */
     loadChat: (chatKey: string) => Promise<Chat>;
-    /** Send a text message */
-    sendMessage: (content: string, attachments?: unknown[]) => Promise<void>;
+    /** Send a text message. Optional `data` is forwarded to the backend (e.g. { saveAttachments: true }). */
+    sendMessage: (content: string, attachments?: unknown[], data?: Record<string, unknown>) => Promise<void>;
     /** Send a raw chat event (for custom event types) */
     sendEvent: (event: Omit<ChatEvent, "timestamp">) => Promise<void>;
     /** End the current chat */
@@ -89,41 +102,66 @@ interface ChatHistoryResult {
     hasMore: boolean;
 }
 /**
- * Hook for chat history CRUD operations
+ * Return surface of {@link useChatHistory}.
  *
- * @example
- * ```tsx
- * const { loading, error, getChatHistory, deleteChat } = useChatHistory({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- * });
- *
- * const { chats, total, hasMore } = await getChatHistory({ limit: 20 });
- * await deleteChat(chatKey);
- * ```
+ * Every verb is an imperative `execute` from `useApiAsync`: you `await` it for
+ * data, and it resolves to its default (`{ chats: [], total: 0, hasMore: false }`,
+ * `null`, `false`, `[]`) on failure rather than throwing — inspect `error` /
+ * the result instead of try/catch. Unlike `useChat` (realtime, no bearer), these
+ * hit `/api/v1/chats**` through `@elqnt/api-client` with the gateway JWT.
  */
-declare function useChatHistory(options: UseChatHistoryOptions): {
+interface UseChatHistoryReturn {
+    /** True while any history verb is in flight. */
     loading: boolean;
+    /** Last error from any history verb (string), or null. */
     error: string | null;
+    /** List the caller's chats (paged). `POST /api/v1/chats`. */
     getChatHistory: (params?: {
         limit?: number;
         offset?: number;
         skipCache?: boolean;
-    } | undefined) => Promise<{
-        chats: ChatSummary[];
-        total: number;
-        hasMore: boolean;
-    }>;
+    }) => Promise<ChatHistoryResult>;
+    /** Fetch one chat summary by key. `GET /api/v1/chats/{chatKey}`. */
     getChat: (chatKey: string) => Promise<ChatSummary | null>;
+    /** Rename / pin a chat. `PATCH /api/v1/chats/{chatKey}`. */
     updateChat: (chatKey: string, updates: {
         title?: string;
         pinned?: boolean;
     }) => Promise<boolean>;
+    /** Delete a chat. `DELETE /api/v1/chats/{chatKey}`. */
     deleteChat: (chatKey: string) => Promise<boolean>;
+    /** List a user's chats by email. `GET /api/v1/chats/user/{email}`. */
     getChatsByUser: (userEmail: string) => Promise<ChatSummary[]>;
-};
+}
+/**
+ * Hook for chat history CRUD operations
+ *
+ * @example
+ * ```tsx
+ * const { loading, error, getChatHistory, deleteChat } = useChatHistory({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: selectedOrgId,
+ * });
+ *
+ * const { chats, total, hasMore } = await getChatHistory({ limit: 20 });
+ * await deleteChat(chatKey);
+ * ```
+ */
+declare function useChatHistory(options: UseChatHistoryOptions): UseChatHistoryReturn;
 
 type UseChatMonitoringOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useChatMonitoring`. Imperative no-throw:
+ * each method resolves to a default on failure and sets `error`. See SKILL.md.
+ */
+interface UseChatMonitoringReturn {
+    loading: boolean;
+    error: string | null;
+    getActiveChats: (pastHours?: number) => Promise<ChatSummary[]>;
+    getActiveChatsCount: () => Promise<number>;
+    getWaitingChatsCount: () => Promise<number>;
+    listQueues: () => Promise<Queue[]>;
+}
 /**
  * Hook for monitoring active/waiting chats and queues
  *
@@ -138,16 +176,19 @@ type UseChatMonitoringOptions = ApiClientOptions;
  * const waitingCount = await getWaitingChatsCount();
  * ```
  */
-declare function useChatMonitoring(options: UseChatMonitoringOptions): {
-    loading: boolean;
-    error: string | null;
-    getActiveChats: (pastHours?: number | undefined) => Promise<ChatSummary[]>;
-    getActiveChatsCount: () => Promise<number>;
-    getWaitingChatsCount: () => Promise<number>;
-    listQueues: () => Promise<Queue[]>;
-};
+declare function useChatMonitoring(options: UseChatMonitoringOptions): UseChatMonitoringReturn;
 
 type UseHumanAgentSessionsOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useHumanAgentSessions`. Imperative
+ * no-throw: each method resolves to a default on failure and sets `error`.
+ */
+interface UseHumanAgentSessionsReturn {
+    loading: boolean;
+    error: string | null;
+    getOnlineSessions: () => Promise<AgentSession[]>;
+    getAgentSession: (agentId: string) => Promise<AgentSession | null>;
+}
 /**
  * Hook for human agent session management
  *
@@ -162,13 +203,10 @@ type UseHumanAgentSessionsOptions = ApiClientOptions;
  * const session = await getAgentSession(agentId);
  * ```
  */
-declare function useHumanAgentSessions(options: UseHumanAgentSessionsOptions): {
-    loading: boolean;
-    error: string | null;
-    getOnlineSessions: () => Promise<AgentSession[]>;
-    getAgentSession: (agentId: string) => Promise<AgentSession | null>;
-};
+declare function useHumanAgentSessions(options: UseHumanAgentSessionsOptions): UseHumanAgentSessionsReturn;
 
+/** Canonical SDK name for the memory hook's return surface (alias of UseMemoryResult). */
+type UseMemoryReturn = UseMemoryResult;
 interface UseMemoryResult {
     /** Current local copy of the user profile (null before first load/mutation) */
     profile: MemoryProfile | null;
@@ -211,4 +249,4 @@ declare function useMemory(options: ApiClientOptions, initialProfile?: MemoryPro
  */
 declare function useOptionsRef<T>(options: T): React.MutableRefObject<T>;
 
-export { type ChatHistoryResult, type UseChatHistoryOptions, type UseChatMonitoringOptions, type UseChatOptions, type UseChatReturn, type UseHumanAgentSessionsOptions, type UseMemoryResult, useChat, useChatHistory, useChatMonitoring, useHumanAgentSessions, useMemory, useOptionsRef };
+export { type ChatHistoryResult, type UseChatHistoryOptions, type UseChatHistoryReturn, type UseChatMonitoringOptions, type UseChatMonitoringReturn, type UseChatOptions, type UseChatReturn, type UseHumanAgentSessionsOptions, type UseHumanAgentSessionsReturn, type UseMemoryResult, type UseMemoryReturn, useChat, useChatHistory, useChatMonitoring, useHumanAgentSessions, useMemory, useOptionsRef };

package/dist/hooks/index.d.ts

@@ -1,8 +1,8 @@
-export { UseAsyncOptions, UseAsyncReturn, useApiAsync } from '@elqnt/api-client/hooks';
 import { ChatEvent, Chat, ChatMessage, ChatSummary, MemoryProfile } from '../models/index.js';
-import { C as ChatTransport, e as TransportError, g as TransportState, R as RetryConfig, b as ConnectionMetrics, U as Unsubscribe } from '../types-7UNI1iYv.js';
+import { C as ChatTransport, e as TransportError, g as TransportState, R as RetryConfig, b as ConnectionMetrics, U as Unsubscribe } from '../types-CxibhkqW.js';
 import { ApiClientOptions } from '@elqnt/api-client';
 import { Queue, AgentSession, SummaryView } from '../api/index.js';
+export { UseAsyncOptions, UseAsyncReturn, useApiAsync } from '@elqnt/api-client/hooks';
 import '@elqnt/kg';
 import '@elqnt/types';
 import '@elqnt/docs';
@@ -33,6 +33,19 @@ interface UseChatOptions {
     retryConfig?: RetryConfig;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Tier-2 authorization (REQUIRED in production). Chat realtime reaches the
+     * chat service directly, bypassing the API gateway, so the service authorizes
+     * each connection from a signed token and derives orgId/userId/product from
+     * its claims. Provide `getToken` (preferred — awaited on every connect and
+     * REST send so short-lived tokens refresh over a long stream) or a static
+     * `token`. Mint it from a server route (e.g. /api/gateway-token or a
+     * dedicated chat-token route); the token's org/user MUST match this hook's
+     * orgId/userId. See packages/@elqnt/chat/SKILL.md.
+     */
+    getToken?: () => Promise<string | null | undefined> | string | null | undefined;
+    /** Static signed token. Ignored when `getToken` is provided. */
+    token?: string;
 }
 /**
  * Chat hook return type
@@ -50,8 +63,8 @@ interface UseChatReturn {
     startChat: (metadata?: Record<string, unknown>) => Promise<string>;
     /** Load an existing chat, returns the loaded chat */
     loadChat: (chatKey: string) => Promise<Chat>;
-    /** Send a text message */
-    sendMessage: (content: string, attachments?: unknown[]) => Promise<void>;
+    /** Send a text message. Optional `data` is forwarded to the backend (e.g. { saveAttachments: true }). */
+    sendMessage: (content: string, attachments?: unknown[], data?: Record<string, unknown>) => Promise<void>;
     /** Send a raw chat event (for custom event types) */
     sendEvent: (event: Omit<ChatEvent, "timestamp">) => Promise<void>;
     /** End the current chat */
@@ -89,41 +102,66 @@ interface ChatHistoryResult {
     hasMore: boolean;
 }
 /**
- * Hook for chat history CRUD operations
+ * Return surface of {@link useChatHistory}.
  *
- * @example
- * ```tsx
- * const { loading, error, getChatHistory, deleteChat } = useChatHistory({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- * });
- *
- * const { chats, total, hasMore } = await getChatHistory({ limit: 20 });
- * await deleteChat(chatKey);
- * ```
+ * Every verb is an imperative `execute` from `useApiAsync`: you `await` it for
+ * data, and it resolves to its default (`{ chats: [], total: 0, hasMore: false }`,
+ * `null`, `false`, `[]`) on failure rather than throwing — inspect `error` /
+ * the result instead of try/catch. Unlike `useChat` (realtime, no bearer), these
+ * hit `/api/v1/chats**` through `@elqnt/api-client` with the gateway JWT.
  */
-declare function useChatHistory(options: UseChatHistoryOptions): {
+interface UseChatHistoryReturn {
+    /** True while any history verb is in flight. */
     loading: boolean;
+    /** Last error from any history verb (string), or null. */
     error: string | null;
+    /** List the caller's chats (paged). `POST /api/v1/chats`. */
     getChatHistory: (params?: {
         limit?: number;
         offset?: number;
         skipCache?: boolean;
-    } | undefined) => Promise<{
-        chats: ChatSummary[];
-        total: number;
-        hasMore: boolean;
-    }>;
+    }) => Promise<ChatHistoryResult>;
+    /** Fetch one chat summary by key. `GET /api/v1/chats/{chatKey}`. */
     getChat: (chatKey: string) => Promise<ChatSummary | null>;
+    /** Rename / pin a chat. `PATCH /api/v1/chats/{chatKey}`. */
     updateChat: (chatKey: string, updates: {
         title?: string;
         pinned?: boolean;
     }) => Promise<boolean>;
+    /** Delete a chat. `DELETE /api/v1/chats/{chatKey}`. */
     deleteChat: (chatKey: string) => Promise<boolean>;
+    /** List a user's chats by email. `GET /api/v1/chats/user/{email}`. */
     getChatsByUser: (userEmail: string) => Promise<ChatSummary[]>;
-};
+}
+/**
+ * Hook for chat history CRUD operations
+ *
+ * @example
+ * ```tsx
+ * const { loading, error, getChatHistory, deleteChat } = useChatHistory({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: selectedOrgId,
+ * });
+ *
+ * const { chats, total, hasMore } = await getChatHistory({ limit: 20 });
+ * await deleteChat(chatKey);
+ * ```
+ */
+declare function useChatHistory(options: UseChatHistoryOptions): UseChatHistoryReturn;
 
 type UseChatMonitoringOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useChatMonitoring`. Imperative no-throw:
+ * each method resolves to a default on failure and sets `error`. See SKILL.md.
+ */
+interface UseChatMonitoringReturn {
+    loading: boolean;
+    error: string | null;
+    getActiveChats: (pastHours?: number) => Promise<ChatSummary[]>;
+    getActiveChatsCount: () => Promise<number>;
+    getWaitingChatsCount: () => Promise<number>;
+    listQueues: () => Promise<Queue[]>;
+}
 /**
  * Hook for monitoring active/waiting chats and queues
  *
@@ -138,16 +176,19 @@ type UseChatMonitoringOptions = ApiClientOptions;
  * const waitingCount = await getWaitingChatsCount();
  * ```
  */
-declare function useChatMonitoring(options: UseChatMonitoringOptions): {
-    loading: boolean;
-    error: string | null;
-    getActiveChats: (pastHours?: number | undefined) => Promise<ChatSummary[]>;
-    getActiveChatsCount: () => Promise<number>;
-    getWaitingChatsCount: () => Promise<number>;
-    listQueues: () => Promise<Queue[]>;
-};
+declare function useChatMonitoring(options: UseChatMonitoringOptions): UseChatMonitoringReturn;
 
 type UseHumanAgentSessionsOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useHumanAgentSessions`. Imperative
+ * no-throw: each method resolves to a default on failure and sets `error`.
+ */
+interface UseHumanAgentSessionsReturn {
+    loading: boolean;
+    error: string | null;
+    getOnlineSessions: () => Promise<AgentSession[]>;
+    getAgentSession: (agentId: string) => Promise<AgentSession | null>;
+}
 /**
  * Hook for human agent session management
  *
@@ -162,13 +203,10 @@ type UseHumanAgentSessionsOptions = ApiClientOptions;
  * const session = await getAgentSession(agentId);
  * ```
  */
-declare function useHumanAgentSessions(options: UseHumanAgentSessionsOptions): {
-    loading: boolean;
-    error: string | null;
-    getOnlineSessions: () => Promise<AgentSession[]>;
-    getAgentSession: (agentId: string) => Promise<AgentSession | null>;
-};
+declare function useHumanAgentSessions(options: UseHumanAgentSessionsOptions): UseHumanAgentSessionsReturn;
 
+/** Canonical SDK name for the memory hook's return surface (alias of UseMemoryResult). */
+type UseMemoryReturn = UseMemoryResult;
 interface UseMemoryResult {
     /** Current local copy of the user profile (null before first load/mutation) */
     profile: MemoryProfile | null;
@@ -211,4 +249,4 @@ declare function useMemory(options: ApiClientOptions, initialProfile?: MemoryPro
  */
 declare function useOptionsRef<T>(options: T): React.MutableRefObject<T>;
 
-export { type ChatHistoryResult, type UseChatHistoryOptions, type UseChatMonitoringOptions, type UseChatOptions, type UseChatReturn, type UseHumanAgentSessionsOptions, type UseMemoryResult, useChat, useChatHistory, useChatMonitoring, useHumanAgentSessions, useMemory, useOptionsRef };
+export { type ChatHistoryResult, type UseChatHistoryOptions, type UseChatHistoryReturn, type UseChatMonitoringOptions, type UseChatMonitoringReturn, type UseChatOptions, type UseChatReturn, type UseHumanAgentSessionsOptions, type UseHumanAgentSessionsReturn, type UseMemoryResult, type UseMemoryReturn, useChat, useChatHistory, useChatMonitoring, useHumanAgentSessions, useMemory, useOptionsRef };