npm - @octavus/react - Versions diffs - 4.0.0 → 4.2.0 - Mend

@octavus/react 4.0.0 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.cjs CHANGED Viewed

@@ -170,7 +170,12 @@ function useAutoScroll(options = {}) {
   const scrollRef = options.scrollRef ?? internalRef;
   const threshold = options.threshold ?? DEFAULT_THRESHOLD_PX;
   const shouldAutoScrollRef = (0, import_react2.useRef)(true);
+  const isProgrammaticScrollRef = (0, import_react2.useRef)(false);
   const handleScroll = (0, import_react2.useCallback)(() => {
+    if (isProgrammaticScrollRef.current) {
+      isProgrammaticScrollRef.current = false;
+      return;
+    }
     const el = scrollRef.current;
     if (!el) return;
     const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;
@@ -180,7 +185,11 @@ function useAutoScroll(options = {}) {
     const el = scrollRef.current;
     if (!el) return;
     if (shouldAutoScrollRef.current) {
+      const previousScrollTop = el.scrollTop;
       el.scrollTop = el.scrollHeight;
+      if (el.scrollTop !== previousScrollTop) {
+        isProgrammaticScrollRef.current = true;
+      }
       return;
     }
     const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts","../src/hooks/use-octavus-chat.ts","../src/hooks/use-auto-scroll.ts"],"sourcesContent":["export {\n useOctavusChat,\n type UseOctavusChatReturn,\n type OctavusChatOptions,\n type ChatStatus,\n type UserMessageInput,\n type ClientToolContext,\n type ClientToolHandler,\n type InteractiveTool,\n} from './hooks/use-octavus-chat';\n\nexport { useAutoScroll, type UseAutoScrollOptions } from './hooks/use-auto-scroll';\n\nexport type * from '@octavus/client-sdk';\nexport {\n // Chat\n OctavusChat,\n // Files\n uploadFiles,\n // Stream\n parseSSEStream,\n // Transports\n createHttpTransport,\n createSocketTransport,\n isSocketTransport,\n createPollingTransport,\n // Error classes\n AppError,\n NotFoundError,\n ValidationError,\n ConflictError,\n ForbiddenError,\n OctavusError,\n // Error type guards\n isRateLimitError,\n isAuthenticationError,\n isProviderError,\n isToolError,\n isRetryableError,\n isValidationError,\n // Error event helpers\n createErrorEvent,\n errorToStreamEvent,\n createInternalErrorEvent,\n createApiErrorEvent,\n // Utilities\n generateId,\n isAbortError,\n // Thread helpers\n MAIN_THREAD,\n resolveThread,\n isMainThread,\n threadForPart,\n isOtherThread,\n // Type guards\n isFileReference,\n isFileReferenceArray,\n // Safe parse helpers\n safeParseStreamEvent,\n safeParseUIMessage,\n safeParseUIMessages,\n // Skills\n OCTAVUS_SKILL_TOOLS,\n isOctavusSkillTool,\n getSkillSlugFromToolCall,\n} from '@octavus/client-sdk';\n","'use client';\n\nimport { useRef, useCallback, useSyncExternalStore, useState, useEffect } from 'react';\nimport {\n OctavusChat,\n type OctavusError,\n isSocketTransport,\n type OctavusChatOptions,\n type ChatStatus,\n type UserMessageInput,\n type UIMessage,\n type Transport,\n type ConnectionState,\n type FileReference,\n type UploadFilesOptions,\n type UploadUrlsResponse,\n type ClientToolContext,\n type ClientToolHandler,\n type InteractiveTool,\n} from '@octavus/client-sdk';\n\nexport type {\n OctavusChatOptions,\n ChatStatus,\n UserMessageInput,\n FileReference,\n UploadFilesOptions,\n UploadUrlsResponse,\n ClientToolContext,\n ClientToolHandler,\n InteractiveTool,\n};\n\nexport interface UseOctavusChatReturn {\n /** All messages including the currently streaming one /\n messages: UIMessage[];\n /* Current status of the chat /\n status: ChatStatus;\n /\n Error if status is 'error'.\n * Contains structured error information including type, source, and retryability.\n * Use type guards like `isRateLimitError()` or `isProviderError()` to check specific error types.\n /\n error: OctavusError \| null;\n /\n The current session/execution ID from the most recent `send()` call.\n * Updated when the server responds with a `start` event containing an execution ID.\n * Useful for tracking activity logs or debugging.\n \n For workers, this is the execution ID. For interactive sessions, this is the session ID.\n /\n sessionId: string \| null;\n /\n Socket connection state (socket transport only).\n * For HTTP transport, this is always `undefined`.\n \n - `disconnected`: Not connected (initial state before first send)\n * - `connecting`: Connection attempt in progress\n * - `connected`: Successfully connected\n * - `error`: Connection failed (check `connectionError`)\n /\n connectionState: ConnectionState \| undefined;\n /\n Connection error if `connectionState` is 'error'.\n /\n connectionError: Error \| undefined;\n /\n Pending interactive tool calls keyed by tool name.\n * Each tool has bound `submit()` and `cancel()` methods.\n \n @example\n * ```tsx\n * const feedbackTools = pendingClientTools['request-feedback'] ?? [];\n \n {feedbackTools.map(tool => (\n * <FeedbackModal\n * key={tool.toolCallId}\n * {...tool.args}\n * onSubmit={(result) => tool.submit(result)}\n * onCancel={() => tool.cancel()}\n * />\n * ))}\n * ```\n /\n pendingClientTools: Record<string, InteractiveTool[]>;\n /\n Trigger the agent and optionally add a user message to the chat.\n \n @param triggerName - The trigger name defined in the agent's protocol.yaml\n * @param input - Input parameters for the trigger (variable substitutions)\n * @param options.userMessage - If provided, adds a user message to the chat before triggering\n /\n send: (\n triggerName: string,\n input?: Record<string, unknown>,\n options?: { userMessage?: UserMessageInput },\n ) => Promise<void>;\n /* Stop the current streaming and finalize any partial message /\n stop: () => void;\n /\n Retry the last trigger from the same starting point.\n * Rolls back messages, re-adds the user message (if any), and re-executes.\n * No-op if no trigger has been sent yet.\n /\n retry: () => Promise<void>;\n /\n Observe an already-active execution without triggering a new one.\n * Only works with transports that support `observe()` (e.g., polling transport).\n * Use when the page loads and the session is already streaming.\n /\n observe: () => Promise<void>;\n /\n Replace the message list with externally-provided messages.\n * Use to sync with server-authoritative state (e.g., multi-observer scenarios).\n * Must NOT be called while streaming.\n /\n replaceMessages: (messages: UIMessage[]) => void;\n /\n Whether `retry()` can be called.\n * True when a trigger has been sent and the chat is not currently streaming or awaiting input.\n /\n canRetry: boolean;\n /\n Eagerly connect to the socket (socket transport only).\n * Returns a promise that resolves when connected or rejects on error.\n * Safe to call multiple times - subsequent calls resolve immediately if already connected.\n \n For HTTP transport, this is `undefined`.\n /\n connect: (() => Promise<void>) \| undefined;\n /\n Disconnect the socket (socket transport only).\n * The transport will reconnect automatically on next send().\n \n For HTTP transport, this is `undefined`.\n /\n disconnect: (() => void) \| undefined;\n /\n Upload files directly without sending a message.\n * Useful for showing upload progress before sending.\n \n @param files - Files to upload\n * @param onProgress - Optional progress callback\n * @returns Array of file references\n \n @example\n * ```typescript\n * const fileRefs = await uploadFiles(fileInput.files, (i, progress) => {\n * console.log(`File ${i}: ${progress}%`);\n * });\n * // Later...\n * await send('user-message', { FILES: fileRefs }, { userMessage: { files: fileRefs } });\n * ```\n /\n uploadFiles: (\n files: FileList \| File[],\n onProgress?: (fileIndex: number, progress: number) => void,\n ) => Promise<FileReference[]>;\n}\n\n/\n React hook for interacting with Octavus agents.\n * Provides chat state management and streaming support.\n \n When the transport changes (e.g., sessionId changes), the hook automatically\n * reinitializes with a fresh chat instance. Use `initialMessages` if you need\n * to preserve messages across transport changes.\n \n @example Basic usage with HTTP transport\n * ```tsx\n * import { useOctavusChat, createHttpTransport } from '@octavus/react';\n \n function Chat({ sessionId }) {\n * const transport = useMemo(\n * () => createHttpTransport({\n * request: (payload, options) =>\n * fetch('/api/trigger', {\n * method: 'POST',\n * headers: { 'Content-Type': 'application/json' },\n * body: JSON.stringify({ sessionId, ...payload }),\n * signal: options?.signal,\n * }),\n * }),\n * [sessionId],\n * );\n \n const { messages, status, send } = useOctavusChat({ transport });\n \n return (\n * <div>\n * {messages.map((msg) => (\n * <Message key={msg.id} message={msg} />\n * ))}\n * <button onClick={() => send('user-message', { USER_MESSAGE: 'Hello' })}>\n * Send\n * </button>\n * </div>\n * );\n * }\n * ```\n \n @example Socket transport with eager connection\n * ```tsx\n * import { useOctavusChat, createSocketTransport } from '@octavus/react';\n \n function Chat() {\n * const transport = useMemo(\n * () => createSocketTransport({\n * connect: () => new Promise((resolve, reject) => {\n * const sock = new SockJS('/octavus');\n * sock.onopen = () => resolve(sock);\n * sock.onerror = () => reject(new Error('Connection failed'));\n * }),\n * }),\n * [],\n * );\n \n const { messages, status, send, connectionState, connect, disconnect } =\n * useOctavusChat({ transport });\n \n // Eager connection on mount\n * useEffect(() => {\n * connect?.();\n * return () => disconnect?.();\n * }, [connect, disconnect]);\n \n return (\n * <div>\n * <StatusIndicator state={connectionState} />\n * {messages.map((msg) => <Message key={msg.id} message={msg} />)}\n * </div>\n * );\n * }\n * ```\n /\nexport function useOctavusChat(options: OctavusChatOptions): UseOctavusChatReturn {\n const chatRef = useRef<OctavusChat \| null>(null);\n const transportRef = useRef<Transport \| null>(null);\n const [sessionId, setSessionId] = useState<string \| null>(null);\n\n const sessionIdSetterRef = useRef(setSessionId);\n sessionIdSetterRef.current = setSessionId;\n\n if (transportRef.current !== options.transport) {\n chatRef.current?.stop();\n setSessionId(null);\n chatRef.current = new OctavusChat(options);\n transportRef.current = options.transport;\n }\n\n const chat = chatRef.current!;\n\n // Keep all mutable options (callbacks, tool handlers) fresh on every render.\n // This ensures handlers always reference the latest closures instead of going stale.\n chat.updateOptions({\n clientTools: options.clientTools,\n onError: options.onError,\n onFinish: options.onFinish,\n onStop: options.onStop,\n onResourceUpdate: options.onResourceUpdate,\n onStart: (id) => {\n sessionIdSetterRef.current(id);\n options.onStart?.(id);\n },\n requestUploadUrls: options.requestUploadUrls,\n uploadOptions: options.uploadOptions,\n });\n const transport = options.transport;\n\n const subscribe = useCallback((callback: () => void) => chat.subscribe(callback), [chat]);\n const getMessagesSnapshot = useCallback(() => chat.messages, [chat]);\n const getStatusSnapshot = useCallback(() => chat.status, [chat]);\n const getErrorSnapshot = useCallback(() => chat.error, [chat]);\n const getPendingClientToolsSnapshot = useCallback(() => chat.pendingClientTools, [chat]);\n const getCanRetrySnapshot = useCallback(() => chat.canRetry, [chat]);\n\n const messages = useSyncExternalStore(subscribe, getMessagesSnapshot, getMessagesSnapshot);\n const status = useSyncExternalStore(subscribe, getStatusSnapshot, getStatusSnapshot);\n const error = useSyncExternalStore(subscribe, getErrorSnapshot, getErrorSnapshot);\n const pendingClientTools = useSyncExternalStore(\n subscribe,\n getPendingClientToolsSnapshot,\n getPendingClientToolsSnapshot,\n );\n const canRetry = useSyncExternalStore(subscribe, getCanRetrySnapshot, getCanRetrySnapshot);\n\n const socketTransport = isSocketTransport(transport) ? transport : null;\n const [connectionState, setConnectionState] = useState<ConnectionState \| undefined>(\n socketTransport?.connectionState,\n );\n const [connectionError, setConnectionError] = useState<Error \| undefined>(undefined);\n\n useEffect(() => {\n if (!socketTransport) {\n setConnectionState(undefined);\n setConnectionError(undefined);\n return;\n }\n\n const unsubscribe = socketTransport.onConnectionStateChange((state, err) => {\n setConnectionState(state);\n setConnectionError(err);\n });\n\n return unsubscribe;\n }, [socketTransport]);\n\n const send = useCallback(\n (\n triggerName: string,\n input?: Record<string, unknown>,\n sendOptions?: { userMessage?: UserMessageInput },\n ) => chat.send(triggerName, input, sendOptions),\n [chat],\n );\n\n const stop = useCallback(() => chat.stop(), [chat]);\n const retry = useCallback(() => chat.retry(), [chat]);\n const observe = useCallback(() => chat.observe(), [chat]);\n const replaceMessages = useCallback((msgs: UIMessage[]) => chat.replaceMessages(msgs), [chat]);\n\n const uploadFiles = useCallback(\n (files: FileList \| File[], onProgress?: (fileIndex: number, progress: number) => void) =>\n chat.uploadFiles(files, onProgress),\n [chat],\n );\n\n // Stable references for connect/disconnect (socket transport only)\n const connect = useCallback(\n () => socketTransport?.connect() ?? Promise.resolve(),\n [socketTransport],\n );\n const disconnect = useCallback(() => socketTransport?.disconnect(), [socketTransport]);\n\n return {\n messages,\n status,\n error,\n sessionId,\n connectionState,\n connectionError,\n pendingClientTools,\n send,\n stop,\n retry,\n observe,\n replaceMessages,\n canRetry,\n connect: socketTransport ? connect : undefined,\n disconnect: socketTransport ? disconnect : undefined,\n uploadFiles,\n };\n}\n","'use client';\n\nimport { type RefObject, useRef, useCallback } from 'react';\n\nconst DEFAULT_THRESHOLD_PX = 80;\n\nexport interface UseAutoScrollOptions {\n /\n Provide your own ref if you need to share the scroll container\n * with other logic. When omitted, an internal ref is created.\n /\n scrollRef?: RefObject<HTMLDivElement \| null>;\n\n /\n Distance from the bottom (in pixels) within which auto-scroll\n * stays active. Defaults to 80.\n /\n threshold?: number;\n}\n\n/\n Smart auto-scroll for chat interfaces.\n \n Scrolls to bottom when new content arrives, but pauses if the user\n * has scrolled up to read earlier messages. Re-enables once the user\n * scrolls back near the bottom.\n \n @example\n * ```tsx\n * const { scrollRef, handleScroll, scrollOnUpdate, resetAutoScroll } = useAutoScroll();\n \n useEffect(() => {\n * const id = requestAnimationFrame(scrollOnUpdate);\n * return () => cancelAnimationFrame(id);\n * }, [messages, scrollOnUpdate]);\n \n <div ref={scrollRef} onScroll={handleScroll}>...</div>\n \n // On send: resetAutoScroll() to force-scroll on next update\n * ```\n */\nexport function useAutoScroll(options: UseAutoScrollOptions = {}) {\n const internalRef = useRef<HTMLDivElement>(null);\n const scrollRef = options.scrollRef ?? internalRef;\n const threshold = options.threshold ?? DEFAULT_THRESHOLD_PX;\n const shouldAutoScrollRef = useRef(true);\n\n const handleScroll = useCallback(() => {\n const el = scrollRef.current;\n if (!el) return;\n const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;\n shouldAutoScrollRef.current = distanceFromBottom <= threshold;\n }, [scrollRef, threshold]);\n\n const scrollOnUpdate = useCallback(() => {\n const el = scrollRef.current;\n if (!el) return;\n\n if (shouldAutoScrollRef.current) {\n el.scrollTop = el.scrollHeight;\n return;\n }\n\n const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;\n shouldAutoScrollRef.current = distanceFromBottom <= threshold;\n }, [scrollRef, threshold]);\n\n const resetAutoScroll = useCallback(() => {\n shouldAutoScrollRef.current = true;\n }, []);\n\n return { scrollRef, handleScroll, scrollOnUpdate, resetAutoScroll };\n}\n"],"mappings":"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","names":["uploadFiles","import_react","import_client_sdk"]}
1	+ {"version":3,"sources":["../src/index.ts","../src/hooks/use-octavus-chat.ts","../src/hooks/use-auto-scroll.ts"],"sourcesContent":["export {\n useOctavusChat,\n type UseOctavusChatReturn,\n type OctavusChatOptions,\n type ChatStatus,\n type UserMessageInput,\n type ClientToolContext,\n type ClientToolHandler,\n type InteractiveTool,\n} from './hooks/use-octavus-chat';\n\nexport { useAutoScroll, type UseAutoScrollOptions } from './hooks/use-auto-scroll';\n\nexport type * from '@octavus/client-sdk';\nexport {\n // Chat\n OctavusChat,\n // Files\n uploadFiles,\n // Stream\n parseSSEStream,\n // Transports\n createHttpTransport,\n createSocketTransport,\n isSocketTransport,\n createPollingTransport,\n // Error classes\n AppError,\n NotFoundError,\n ValidationError,\n ConflictError,\n ForbiddenError,\n OctavusError,\n // Error type guards\n isRateLimitError,\n isAuthenticationError,\n isProviderError,\n isToolError,\n isRetryableError,\n isValidationError,\n // Error event helpers\n createErrorEvent,\n errorToStreamEvent,\n createInternalErrorEvent,\n createApiErrorEvent,\n // Utilities\n generateId,\n isAbortError,\n // Thread helpers\n MAIN_THREAD,\n resolveThread,\n isMainThread,\n threadForPart,\n isOtherThread,\n // Type guards\n isFileReference,\n isFileReferenceArray,\n // Safe parse helpers\n safeParseStreamEvent,\n safeParseUIMessage,\n safeParseUIMessages,\n // Skills\n OCTAVUS_SKILL_TOOLS,\n isOctavusSkillTool,\n getSkillSlugFromToolCall,\n} from '@octavus/client-sdk';\n","'use client';\n\nimport { useRef, useCallback, useSyncExternalStore, useState, useEffect } from 'react';\nimport {\n OctavusChat,\n type OctavusError,\n isSocketTransport,\n type OctavusChatOptions,\n type ChatStatus,\n type UserMessageInput,\n type UIMessage,\n type Transport,\n type ConnectionState,\n type FileReference,\n type UploadFilesOptions,\n type UploadUrlsResponse,\n type ClientToolContext,\n type ClientToolHandler,\n type InteractiveTool,\n} from '@octavus/client-sdk';\n\nexport type {\n OctavusChatOptions,\n ChatStatus,\n UserMessageInput,\n FileReference,\n UploadFilesOptions,\n UploadUrlsResponse,\n ClientToolContext,\n ClientToolHandler,\n InteractiveTool,\n};\n\nexport interface UseOctavusChatReturn {\n /** All messages including the currently streaming one /\n messages: UIMessage[];\n /* Current status of the chat /\n status: ChatStatus;\n /\n Error if status is 'error'.\n * Contains structured error information including type, source, and retryability.\n * Use type guards like `isRateLimitError()` or `isProviderError()` to check specific error types.\n /\n error: OctavusError \| null;\n /\n The current session/execution ID from the most recent `send()` call.\n * Updated when the server responds with a `start` event containing an execution ID.\n * Useful for tracking activity logs or debugging.\n \n For workers, this is the execution ID. For interactive sessions, this is the session ID.\n /\n sessionId: string \| null;\n /\n Socket connection state (socket transport only).\n * For HTTP transport, this is always `undefined`.\n \n - `disconnected`: Not connected (initial state before first send)\n * - `connecting`: Connection attempt in progress\n * - `connected`: Successfully connected\n * - `error`: Connection failed (check `connectionError`)\n /\n connectionState: ConnectionState \| undefined;\n /\n Connection error if `connectionState` is 'error'.\n /\n connectionError: Error \| undefined;\n /\n Pending interactive tool calls keyed by tool name.\n * Each tool has bound `submit()` and `cancel()` methods.\n \n @example\n * ```tsx\n * const feedbackTools = pendingClientTools['request-feedback'] ?? [];\n \n {feedbackTools.map(tool => (\n * <FeedbackModal\n * key={tool.toolCallId}\n * {...tool.args}\n * onSubmit={(result) => tool.submit(result)}\n * onCancel={() => tool.cancel()}\n * />\n * ))}\n * ```\n /\n pendingClientTools: Record<string, InteractiveTool[]>;\n /\n Trigger the agent and optionally add a user message to the chat.\n \n @param triggerName - The trigger name defined in the agent's protocol.yaml\n * @param input - Input parameters for the trigger (variable substitutions)\n * @param options.userMessage - If provided, adds a user message to the chat before triggering\n /\n send: (\n triggerName: string,\n input?: Record<string, unknown>,\n options?: { userMessage?: UserMessageInput },\n ) => Promise<void>;\n /* Stop the current streaming and finalize any partial message /\n stop: () => void;\n /\n Retry the last trigger from the same starting point.\n * Rolls back messages, re-adds the user message (if any), and re-executes.\n * No-op if no trigger has been sent yet.\n /\n retry: () => Promise<void>;\n /\n Observe an already-active execution without triggering a new one.\n * Only works with transports that support `observe()` (e.g., polling transport).\n * Use when the page loads and the session is already streaming.\n /\n observe: () => Promise<void>;\n /\n Replace the message list with externally-provided messages.\n * Use to sync with server-authoritative state (e.g., multi-observer scenarios).\n * Must NOT be called while streaming.\n /\n replaceMessages: (messages: UIMessage[]) => void;\n /\n Whether `retry()` can be called.\n * True when a trigger has been sent and the chat is not currently streaming or awaiting input.\n /\n canRetry: boolean;\n /\n Eagerly connect to the socket (socket transport only).\n * Returns a promise that resolves when connected or rejects on error.\n * Safe to call multiple times - subsequent calls resolve immediately if already connected.\n \n For HTTP transport, this is `undefined`.\n /\n connect: (() => Promise<void>) \| undefined;\n /\n Disconnect the socket (socket transport only).\n * The transport will reconnect automatically on next send().\n \n For HTTP transport, this is `undefined`.\n /\n disconnect: (() => void) \| undefined;\n /\n Upload files directly without sending a message.\n * Useful for showing upload progress before sending.\n \n @param files - Files to upload\n * @param onProgress - Optional progress callback\n * @returns Array of file references\n \n @example\n * ```typescript\n * const fileRefs = await uploadFiles(fileInput.files, (i, progress) => {\n * console.log(`File ${i}: ${progress}%`);\n * });\n * // Later...\n * await send('user-message', { FILES: fileRefs }, { userMessage: { files: fileRefs } });\n * ```\n /\n uploadFiles: (\n files: FileList \| File[],\n onProgress?: (fileIndex: number, progress: number) => void,\n ) => Promise<FileReference[]>;\n}\n\n/\n React hook for interacting with Octavus agents.\n * Provides chat state management and streaming support.\n \n When the transport changes (e.g., sessionId changes), the hook automatically\n * reinitializes with a fresh chat instance. Use `initialMessages` if you need\n * to preserve messages across transport changes.\n \n @example Basic usage with HTTP transport\n * ```tsx\n * import { useOctavusChat, createHttpTransport } from '@octavus/react';\n \n function Chat({ sessionId }) {\n * const transport = useMemo(\n * () => createHttpTransport({\n * request: (payload, options) =>\n * fetch('/api/trigger', {\n * method: 'POST',\n * headers: { 'Content-Type': 'application/json' },\n * body: JSON.stringify({ sessionId, ...payload }),\n * signal: options?.signal,\n * }),\n * }),\n * [sessionId],\n * );\n \n const { messages, status, send } = useOctavusChat({ transport });\n \n return (\n * <div>\n * {messages.map((msg) => (\n * <Message key={msg.id} message={msg} />\n * ))}\n * <button onClick={() => send('user-message', { USER_MESSAGE: 'Hello' })}>\n * Send\n * </button>\n * </div>\n * );\n * }\n * ```\n \n @example Socket transport with eager connection\n * ```tsx\n * import { useOctavusChat, createSocketTransport } from '@octavus/react';\n \n function Chat() {\n * const transport = useMemo(\n * () => createSocketTransport({\n * connect: () => new Promise((resolve, reject) => {\n * const sock = new SockJS('/octavus');\n * sock.onopen = () => resolve(sock);\n * sock.onerror = () => reject(new Error('Connection failed'));\n * }),\n * }),\n * [],\n * );\n \n const { messages, status, send, connectionState, connect, disconnect } =\n * useOctavusChat({ transport });\n \n // Eager connection on mount\n * useEffect(() => {\n * connect?.();\n * return () => disconnect?.();\n * }, [connect, disconnect]);\n \n return (\n * <div>\n * <StatusIndicator state={connectionState} />\n * {messages.map((msg) => <Message key={msg.id} message={msg} />)}\n * </div>\n * );\n * }\n * ```\n /\nexport function useOctavusChat(options: OctavusChatOptions): UseOctavusChatReturn {\n const chatRef = useRef<OctavusChat \| null>(null);\n const transportRef = useRef<Transport \| null>(null);\n const [sessionId, setSessionId] = useState<string \| null>(null);\n\n const sessionIdSetterRef = useRef(setSessionId);\n sessionIdSetterRef.current = setSessionId;\n\n if (transportRef.current !== options.transport) {\n chatRef.current?.stop();\n setSessionId(null);\n chatRef.current = new OctavusChat(options);\n transportRef.current = options.transport;\n }\n\n const chat = chatRef.current!;\n\n // Keep all mutable options (callbacks, tool handlers) fresh on every render.\n // This ensures handlers always reference the latest closures instead of going stale.\n chat.updateOptions({\n clientTools: options.clientTools,\n onError: options.onError,\n onFinish: options.onFinish,\n onStop: options.onStop,\n onResourceUpdate: options.onResourceUpdate,\n onStart: (id) => {\n sessionIdSetterRef.current(id);\n options.onStart?.(id);\n },\n requestUploadUrls: options.requestUploadUrls,\n uploadOptions: options.uploadOptions,\n });\n const transport = options.transport;\n\n const subscribe = useCallback((callback: () => void) => chat.subscribe(callback), [chat]);\n const getMessagesSnapshot = useCallback(() => chat.messages, [chat]);\n const getStatusSnapshot = useCallback(() => chat.status, [chat]);\n const getErrorSnapshot = useCallback(() => chat.error, [chat]);\n const getPendingClientToolsSnapshot = useCallback(() => chat.pendingClientTools, [chat]);\n const getCanRetrySnapshot = useCallback(() => chat.canRetry, [chat]);\n\n const messages = useSyncExternalStore(subscribe, getMessagesSnapshot, getMessagesSnapshot);\n const status = useSyncExternalStore(subscribe, getStatusSnapshot, getStatusSnapshot);\n const error = useSyncExternalStore(subscribe, getErrorSnapshot, getErrorSnapshot);\n const pendingClientTools = useSyncExternalStore(\n subscribe,\n getPendingClientToolsSnapshot,\n getPendingClientToolsSnapshot,\n );\n const canRetry = useSyncExternalStore(subscribe, getCanRetrySnapshot, getCanRetrySnapshot);\n\n const socketTransport = isSocketTransport(transport) ? transport : null;\n const [connectionState, setConnectionState] = useState<ConnectionState \| undefined>(\n socketTransport?.connectionState,\n );\n const [connectionError, setConnectionError] = useState<Error \| undefined>(undefined);\n\n useEffect(() => {\n if (!socketTransport) {\n setConnectionState(undefined);\n setConnectionError(undefined);\n return;\n }\n\n const unsubscribe = socketTransport.onConnectionStateChange((state, err) => {\n setConnectionState(state);\n setConnectionError(err);\n });\n\n return unsubscribe;\n }, [socketTransport]);\n\n const send = useCallback(\n (\n triggerName: string,\n input?: Record<string, unknown>,\n sendOptions?: { userMessage?: UserMessageInput },\n ) => chat.send(triggerName, input, sendOptions),\n [chat],\n );\n\n const stop = useCallback(() => chat.stop(), [chat]);\n const retry = useCallback(() => chat.retry(), [chat]);\n const observe = useCallback(() => chat.observe(), [chat]);\n const replaceMessages = useCallback((msgs: UIMessage[]) => chat.replaceMessages(msgs), [chat]);\n\n const uploadFiles = useCallback(\n (files: FileList \| File[], onProgress?: (fileIndex: number, progress: number) => void) =>\n chat.uploadFiles(files, onProgress),\n [chat],\n );\n\n // Stable references for connect/disconnect (socket transport only)\n const connect = useCallback(\n () => socketTransport?.connect() ?? Promise.resolve(),\n [socketTransport],\n );\n const disconnect = useCallback(() => socketTransport?.disconnect(), [socketTransport]);\n\n return {\n messages,\n status,\n error,\n sessionId,\n connectionState,\n connectionError,\n pendingClientTools,\n send,\n stop,\n retry,\n observe,\n replaceMessages,\n canRetry,\n connect: socketTransport ? connect : undefined,\n disconnect: socketTransport ? disconnect : undefined,\n uploadFiles,\n };\n}\n","'use client';\n\nimport { type RefObject, useRef, useCallback } from 'react';\n\nconst DEFAULT_THRESHOLD_PX = 80;\n\nexport interface UseAutoScrollOptions {\n /\n Provide your own ref if you need to share the scroll container\n * with other logic. When omitted, an internal ref is created.\n /\n scrollRef?: RefObject<HTMLDivElement \| null>;\n\n /\n Distance from the bottom (in pixels) within which auto-scroll\n * stays active. Defaults to 80.\n /\n threshold?: number;\n}\n\n/\n Smart auto-scroll for chat interfaces.\n \n Scrolls to bottom when new content arrives, but pauses if the user\n * has scrolled up to read earlier messages. Re-enables once the user\n * scrolls back near the bottom.\n \n @example\n * ```tsx\n * const { scrollRef, handleScroll, scrollOnUpdate, resetAutoScroll } = useAutoScroll();\n \n useEffect(() => {\n * const id = requestAnimationFrame(scrollOnUpdate);\n * return () => cancelAnimationFrame(id);\n * }, [messages, scrollOnUpdate]);\n \n <div ref={scrollRef} onScroll={handleScroll}>...</div>\n \n // On send: resetAutoScroll() to force-scroll on next update\n * ```\n */\nexport function useAutoScroll(options: UseAutoScrollOptions = {}) {\n const internalRef = useRef<HTMLDivElement>(null);\n const scrollRef = options.scrollRef ?? internalRef;\n const threshold = options.threshold ?? DEFAULT_THRESHOLD_PX;\n const shouldAutoScrollRef = useRef(true);\n // Swallows the async scroll event from a programmatic scrollTop write so it\n // can't falsely disable auto-scroll when content height grows between the\n // write and the event.\n const isProgrammaticScrollRef = useRef(false);\n\n const handleScroll = useCallback(() => {\n if (isProgrammaticScrollRef.current) {\n isProgrammaticScrollRef.current = false;\n return;\n }\n const el = scrollRef.current;\n if (!el) return;\n const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;\n shouldAutoScrollRef.current = distanceFromBottom <= threshold;\n }, [scrollRef, threshold]);\n\n const scrollOnUpdate = useCallback(() => {\n const el = scrollRef.current;\n if (!el) return;\n\n if (shouldAutoScrollRef.current) {\n // Only set the guard when the assignment actually moves scrollTop.\n // If we're already at the bottom, the browser fires no scroll event\n // and a stale `true` would swallow the next genuine user scroll.\n const previousScrollTop = el.scrollTop;\n el.scrollTop = el.scrollHeight;\n if (el.scrollTop !== previousScrollTop) {\n isProgrammaticScrollRef.current = true;\n }\n return;\n }\n\n const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;\n shouldAutoScrollRef.current = distanceFromBottom <= threshold;\n }, [scrollRef, threshold]);\n\n const resetAutoScroll = useCallback(() => {\n shouldAutoScrollRef.current = true;\n }, []);\n\n return { scrollRef, handleScroll, scrollOnUpdate, resetAutoScroll };\n}\n"],"mappings":"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","names":["uploadFiles","import_react","import_client_sdk"]}

package/dist/index.js CHANGED Viewed

@@ -108,7 +108,12 @@ function useAutoScroll(options = {}) {
   const scrollRef = options.scrollRef ?? internalRef;
   const threshold = options.threshold ?? DEFAULT_THRESHOLD_PX;
   const shouldAutoScrollRef = useRef2(true);
+  const isProgrammaticScrollRef = useRef2(false);
   const handleScroll = useCallback2(() => {
+    if (isProgrammaticScrollRef.current) {
+      isProgrammaticScrollRef.current = false;
+      return;
+    }
     const el = scrollRef.current;
     if (!el) return;
     const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;
@@ -118,7 +123,11 @@ function useAutoScroll(options = {}) {
     const el = scrollRef.current;
     if (!el) return;
     if (shouldAutoScrollRef.current) {
+      const previousScrollTop = el.scrollTop;
       el.scrollTop = el.scrollHeight;
+      if (el.scrollTop !== previousScrollTop) {
+        isProgrammaticScrollRef.current = true;
+      }
       return;
     }
     const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/hooks/use-octavus-chat.ts","../src/hooks/use-auto-scroll.ts","../src/index.ts"],"sourcesContent":["'use client';\n\nimport { useRef, useCallback, useSyncExternalStore, useState, useEffect } from 'react';\nimport {\n OctavusChat,\n type OctavusError,\n isSocketTransport,\n type OctavusChatOptions,\n type ChatStatus,\n type UserMessageInput,\n type UIMessage,\n type Transport,\n type ConnectionState,\n type FileReference,\n type UploadFilesOptions,\n type UploadUrlsResponse,\n type ClientToolContext,\n type ClientToolHandler,\n type InteractiveTool,\n} from '@octavus/client-sdk';\n\nexport type {\n OctavusChatOptions,\n ChatStatus,\n UserMessageInput,\n FileReference,\n UploadFilesOptions,\n UploadUrlsResponse,\n ClientToolContext,\n ClientToolHandler,\n InteractiveTool,\n};\n\nexport interface UseOctavusChatReturn {\n /** All messages including the currently streaming one /\n messages: UIMessage[];\n /* Current status of the chat /\n status: ChatStatus;\n /\n Error if status is 'error'.\n * Contains structured error information including type, source, and retryability.\n * Use type guards like `isRateLimitError()` or `isProviderError()` to check specific error types.\n /\n error: OctavusError \| null;\n /\n The current session/execution ID from the most recent `send()` call.\n * Updated when the server responds with a `start` event containing an execution ID.\n * Useful for tracking activity logs or debugging.\n \n For workers, this is the execution ID. For interactive sessions, this is the session ID.\n /\n sessionId: string \| null;\n /\n Socket connection state (socket transport only).\n * For HTTP transport, this is always `undefined`.\n \n - `disconnected`: Not connected (initial state before first send)\n * - `connecting`: Connection attempt in progress\n * - `connected`: Successfully connected\n * - `error`: Connection failed (check `connectionError`)\n /\n connectionState: ConnectionState \| undefined;\n /\n Connection error if `connectionState` is 'error'.\n /\n connectionError: Error \| undefined;\n /\n Pending interactive tool calls keyed by tool name.\n * Each tool has bound `submit()` and `cancel()` methods.\n \n @example\n * ```tsx\n * const feedbackTools = pendingClientTools['request-feedback'] ?? [];\n \n {feedbackTools.map(tool => (\n * <FeedbackModal\n * key={tool.toolCallId}\n * {...tool.args}\n * onSubmit={(result) => tool.submit(result)}\n * onCancel={() => tool.cancel()}\n * />\n * ))}\n * ```\n /\n pendingClientTools: Record<string, InteractiveTool[]>;\n /\n Trigger the agent and optionally add a user message to the chat.\n \n @param triggerName - The trigger name defined in the agent's protocol.yaml\n * @param input - Input parameters for the trigger (variable substitutions)\n * @param options.userMessage - If provided, adds a user message to the chat before triggering\n /\n send: (\n triggerName: string,\n input?: Record<string, unknown>,\n options?: { userMessage?: UserMessageInput },\n ) => Promise<void>;\n /* Stop the current streaming and finalize any partial message /\n stop: () => void;\n /\n Retry the last trigger from the same starting point.\n * Rolls back messages, re-adds the user message (if any), and re-executes.\n * No-op if no trigger has been sent yet.\n /\n retry: () => Promise<void>;\n /\n Observe an already-active execution without triggering a new one.\n * Only works with transports that support `observe()` (e.g., polling transport).\n * Use when the page loads and the session is already streaming.\n /\n observe: () => Promise<void>;\n /\n Replace the message list with externally-provided messages.\n * Use to sync with server-authoritative state (e.g., multi-observer scenarios).\n * Must NOT be called while streaming.\n /\n replaceMessages: (messages: UIMessage[]) => void;\n /\n Whether `retry()` can be called.\n * True when a trigger has been sent and the chat is not currently streaming or awaiting input.\n /\n canRetry: boolean;\n /\n Eagerly connect to the socket (socket transport only).\n * Returns a promise that resolves when connected or rejects on error.\n * Safe to call multiple times - subsequent calls resolve immediately if already connected.\n \n For HTTP transport, this is `undefined`.\n /\n connect: (() => Promise<void>) \| undefined;\n /\n Disconnect the socket (socket transport only).\n * The transport will reconnect automatically on next send().\n \n For HTTP transport, this is `undefined`.\n /\n disconnect: (() => void) \| undefined;\n /\n Upload files directly without sending a message.\n * Useful for showing upload progress before sending.\n \n @param files - Files to upload\n * @param onProgress - Optional progress callback\n * @returns Array of file references\n \n @example\n * ```typescript\n * const fileRefs = await uploadFiles(fileInput.files, (i, progress) => {\n * console.log(`File ${i}: ${progress}%`);\n * });\n * // Later...\n * await send('user-message', { FILES: fileRefs }, { userMessage: { files: fileRefs } });\n * ```\n /\n uploadFiles: (\n files: FileList \| File[],\n onProgress?: (fileIndex: number, progress: number) => void,\n ) => Promise<FileReference[]>;\n}\n\n/\n React hook for interacting with Octavus agents.\n * Provides chat state management and streaming support.\n \n When the transport changes (e.g., sessionId changes), the hook automatically\n * reinitializes with a fresh chat instance. Use `initialMessages` if you need\n * to preserve messages across transport changes.\n \n @example Basic usage with HTTP transport\n * ```tsx\n * import { useOctavusChat, createHttpTransport } from '@octavus/react';\n \n function Chat({ sessionId }) {\n * const transport = useMemo(\n * () => createHttpTransport({\n * request: (payload, options) =>\n * fetch('/api/trigger', {\n * method: 'POST',\n * headers: { 'Content-Type': 'application/json' },\n * body: JSON.stringify({ sessionId, ...payload }),\n * signal: options?.signal,\n * }),\n * }),\n * [sessionId],\n * );\n \n const { messages, status, send } = useOctavusChat({ transport });\n \n return (\n * <div>\n * {messages.map((msg) => (\n * <Message key={msg.id} message={msg} />\n * ))}\n * <button onClick={() => send('user-message', { USER_MESSAGE: 'Hello' })}>\n * Send\n * </button>\n * </div>\n * );\n * }\n * ```\n \n @example Socket transport with eager connection\n * ```tsx\n * import { useOctavusChat, createSocketTransport } from '@octavus/react';\n \n function Chat() {\n * const transport = useMemo(\n * () => createSocketTransport({\n * connect: () => new Promise((resolve, reject) => {\n * const sock = new SockJS('/octavus');\n * sock.onopen = () => resolve(sock);\n * sock.onerror = () => reject(new Error('Connection failed'));\n * }),\n * }),\n * [],\n * );\n \n const { messages, status, send, connectionState, connect, disconnect } =\n * useOctavusChat({ transport });\n \n // Eager connection on mount\n * useEffect(() => {\n * connect?.();\n * return () => disconnect?.();\n * }, [connect, disconnect]);\n \n return (\n * <div>\n * <StatusIndicator state={connectionState} />\n * {messages.map((msg) => <Message key={msg.id} message={msg} />)}\n * </div>\n * );\n * }\n * ```\n /\nexport function useOctavusChat(options: OctavusChatOptions): UseOctavusChatReturn {\n const chatRef = useRef<OctavusChat \| null>(null);\n const transportRef = useRef<Transport \| null>(null);\n const [sessionId, setSessionId] = useState<string \| null>(null);\n\n const sessionIdSetterRef = useRef(setSessionId);\n sessionIdSetterRef.current = setSessionId;\n\n if (transportRef.current !== options.transport) {\n chatRef.current?.stop();\n setSessionId(null);\n chatRef.current = new OctavusChat(options);\n transportRef.current = options.transport;\n }\n\n const chat = chatRef.current!;\n\n // Keep all mutable options (callbacks, tool handlers) fresh on every render.\n // This ensures handlers always reference the latest closures instead of going stale.\n chat.updateOptions({\n clientTools: options.clientTools,\n onError: options.onError,\n onFinish: options.onFinish,\n onStop: options.onStop,\n onResourceUpdate: options.onResourceUpdate,\n onStart: (id) => {\n sessionIdSetterRef.current(id);\n options.onStart?.(id);\n },\n requestUploadUrls: options.requestUploadUrls,\n uploadOptions: options.uploadOptions,\n });\n const transport = options.transport;\n\n const subscribe = useCallback((callback: () => void) => chat.subscribe(callback), [chat]);\n const getMessagesSnapshot = useCallback(() => chat.messages, [chat]);\n const getStatusSnapshot = useCallback(() => chat.status, [chat]);\n const getErrorSnapshot = useCallback(() => chat.error, [chat]);\n const getPendingClientToolsSnapshot = useCallback(() => chat.pendingClientTools, [chat]);\n const getCanRetrySnapshot = useCallback(() => chat.canRetry, [chat]);\n\n const messages = useSyncExternalStore(subscribe, getMessagesSnapshot, getMessagesSnapshot);\n const status = useSyncExternalStore(subscribe, getStatusSnapshot, getStatusSnapshot);\n const error = useSyncExternalStore(subscribe, getErrorSnapshot, getErrorSnapshot);\n const pendingClientTools = useSyncExternalStore(\n subscribe,\n getPendingClientToolsSnapshot,\n getPendingClientToolsSnapshot,\n );\n const canRetry = useSyncExternalStore(subscribe, getCanRetrySnapshot, getCanRetrySnapshot);\n\n const socketTransport = isSocketTransport(transport) ? transport : null;\n const [connectionState, setConnectionState] = useState<ConnectionState \| undefined>(\n socketTransport?.connectionState,\n );\n const [connectionError, setConnectionError] = useState<Error \| undefined>(undefined);\n\n useEffect(() => {\n if (!socketTransport) {\n setConnectionState(undefined);\n setConnectionError(undefined);\n return;\n }\n\n const unsubscribe = socketTransport.onConnectionStateChange((state, err) => {\n setConnectionState(state);\n setConnectionError(err);\n });\n\n return unsubscribe;\n }, [socketTransport]);\n\n const send = useCallback(\n (\n triggerName: string,\n input?: Record<string, unknown>,\n sendOptions?: { userMessage?: UserMessageInput },\n ) => chat.send(triggerName, input, sendOptions),\n [chat],\n );\n\n const stop = useCallback(() => chat.stop(), [chat]);\n const retry = useCallback(() => chat.retry(), [chat]);\n const observe = useCallback(() => chat.observe(), [chat]);\n const replaceMessages = useCallback((msgs: UIMessage[]) => chat.replaceMessages(msgs), [chat]);\n\n const uploadFiles = useCallback(\n (files: FileList \| File[], onProgress?: (fileIndex: number, progress: number) => void) =>\n chat.uploadFiles(files, onProgress),\n [chat],\n );\n\n // Stable references for connect/disconnect (socket transport only)\n const connect = useCallback(\n () => socketTransport?.connect() ?? Promise.resolve(),\n [socketTransport],\n );\n const disconnect = useCallback(() => socketTransport?.disconnect(), [socketTransport]);\n\n return {\n messages,\n status,\n error,\n sessionId,\n connectionState,\n connectionError,\n pendingClientTools,\n send,\n stop,\n retry,\n observe,\n replaceMessages,\n canRetry,\n connect: socketTransport ? connect : undefined,\n disconnect: socketTransport ? disconnect : undefined,\n uploadFiles,\n };\n}\n","'use client';\n\nimport { type RefObject, useRef, useCallback } from 'react';\n\nconst DEFAULT_THRESHOLD_PX = 80;\n\nexport interface UseAutoScrollOptions {\n /\n Provide your own ref if you need to share the scroll container\n * with other logic. When omitted, an internal ref is created.\n /\n scrollRef?: RefObject<HTMLDivElement \| null>;\n\n /\n Distance from the bottom (in pixels) within which auto-scroll\n * stays active. Defaults to 80.\n /\n threshold?: number;\n}\n\n/\n Smart auto-scroll for chat interfaces.\n \n Scrolls to bottom when new content arrives, but pauses if the user\n * has scrolled up to read earlier messages. Re-enables once the user\n * scrolls back near the bottom.\n \n @example\n * ```tsx\n * const { scrollRef, handleScroll, scrollOnUpdate, resetAutoScroll } = useAutoScroll();\n \n useEffect(() => {\n * const id = requestAnimationFrame(scrollOnUpdate);\n * return () => cancelAnimationFrame(id);\n * }, [messages, scrollOnUpdate]);\n \n <div ref={scrollRef} onScroll={handleScroll}>...</div>\n \n // On send: resetAutoScroll() to force-scroll on next update\n * ```\n /\nexport function useAutoScroll(options: UseAutoScrollOptions = {}) {\n const internalRef = useRef<HTMLDivElement>(null);\n const scrollRef = options.scrollRef ?? internalRef;\n const threshold = options.threshold ?? DEFAULT_THRESHOLD_PX;\n const shouldAutoScrollRef = useRef(true);\n\n const handleScroll = useCallback(() => {\n const el = scrollRef.current;\n if (!el) return;\n const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;\n shouldAutoScrollRef.current = distanceFromBottom <= threshold;\n }, [scrollRef, threshold]);\n\n const scrollOnUpdate = useCallback(() => {\n const el = scrollRef.current;\n if (!el) return;\n\n if (shouldAutoScrollRef.current) {\n el.scrollTop = el.scrollHeight;\n return;\n }\n\n const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;\n shouldAutoScrollRef.current = distanceFromBottom <= threshold;\n }, [scrollRef, threshold]);\n\n const resetAutoScroll = useCallback(() => {\n shouldAutoScrollRef.current = true;\n }, []);\n\n return { scrollRef, handleScroll, scrollOnUpdate, resetAutoScroll };\n}\n","export {\n useOctavusChat,\n type UseOctavusChatReturn,\n type OctavusChatOptions,\n type ChatStatus,\n type UserMessageInput,\n type ClientToolContext,\n type ClientToolHandler,\n type InteractiveTool,\n} from './hooks/use-octavus-chat';\n\nexport { useAutoScroll, type UseAutoScrollOptions } from './hooks/use-auto-scroll';\n\nexport type from '@octavus/client-sdk';\nexport {\n // Chat\n OctavusChat,\n // Files\n uploadFiles,\n // Stream\n parseSSEStream,\n // Transports\n createHttpTransport,\n createSocketTransport,\n isSocketTransport,\n createPollingTransport,\n // Error classes\n AppError,\n NotFoundError,\n ValidationError,\n ConflictError,\n ForbiddenError,\n OctavusError,\n // Error type guards\n isRateLimitError,\n isAuthenticationError,\n isProviderError,\n isToolError,\n isRetryableError,\n isValidationError,\n // Error event helpers\n createErrorEvent,\n errorToStreamEvent,\n createInternalErrorEvent,\n createApiErrorEvent,\n // Utilities\n generateId,\n isAbortError,\n // Thread helpers\n MAIN_THREAD,\n resolveThread,\n isMainThread,\n threadForPart,\n isOtherThread,\n // Type guards\n isFileReference,\n isFileReferenceArray,\n // Safe parse helpers\n safeParseStreamEvent,\n safeParseUIMessage,\n safeParseUIMessages,\n // Skills\n OCTAVUS_SKILL_TOOLS,\n isOctavusSkillTool,\n getSkillSlugFromToolCall,\n} from '@octavus/client-sdk';\n"],"mappings":"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","names":["uploadFiles","useRef","useCallback","OctavusChat","isSocketTransport"]}
1	+ {"version":3,"sources":["../src/hooks/use-octavus-chat.ts","../src/hooks/use-auto-scroll.ts","../src/index.ts"],"sourcesContent":["'use client';\n\nimport { useRef, useCallback, useSyncExternalStore, useState, useEffect } from 'react';\nimport {\n OctavusChat,\n type OctavusError,\n isSocketTransport,\n type OctavusChatOptions,\n type ChatStatus,\n type UserMessageInput,\n type UIMessage,\n type Transport,\n type ConnectionState,\n type FileReference,\n type UploadFilesOptions,\n type UploadUrlsResponse,\n type ClientToolContext,\n type ClientToolHandler,\n type InteractiveTool,\n} from '@octavus/client-sdk';\n\nexport type {\n OctavusChatOptions,\n ChatStatus,\n UserMessageInput,\n FileReference,\n UploadFilesOptions,\n UploadUrlsResponse,\n ClientToolContext,\n ClientToolHandler,\n InteractiveTool,\n};\n\nexport interface UseOctavusChatReturn {\n /** All messages including the currently streaming one /\n messages: UIMessage[];\n /* Current status of the chat /\n status: ChatStatus;\n /\n Error if status is 'error'.\n * Contains structured error information including type, source, and retryability.\n * Use type guards like `isRateLimitError()` or `isProviderError()` to check specific error types.\n /\n error: OctavusError \| null;\n /\n The current session/execution ID from the most recent `send()` call.\n * Updated when the server responds with a `start` event containing an execution ID.\n * Useful for tracking activity logs or debugging.\n \n For workers, this is the execution ID. For interactive sessions, this is the session ID.\n /\n sessionId: string \| null;\n /\n Socket connection state (socket transport only).\n * For HTTP transport, this is always `undefined`.\n \n - `disconnected`: Not connected (initial state before first send)\n * - `connecting`: Connection attempt in progress\n * - `connected`: Successfully connected\n * - `error`: Connection failed (check `connectionError`)\n /\n connectionState: ConnectionState \| undefined;\n /\n Connection error if `connectionState` is 'error'.\n /\n connectionError: Error \| undefined;\n /\n Pending interactive tool calls keyed by tool name.\n * Each tool has bound `submit()` and `cancel()` methods.\n \n @example\n * ```tsx\n * const feedbackTools = pendingClientTools['request-feedback'] ?? [];\n \n {feedbackTools.map(tool => (\n * <FeedbackModal\n * key={tool.toolCallId}\n * {...tool.args}\n * onSubmit={(result) => tool.submit(result)}\n * onCancel={() => tool.cancel()}\n * />\n * ))}\n * ```\n /\n pendingClientTools: Record<string, InteractiveTool[]>;\n /\n Trigger the agent and optionally add a user message to the chat.\n \n @param triggerName - The trigger name defined in the agent's protocol.yaml\n * @param input - Input parameters for the trigger (variable substitutions)\n * @param options.userMessage - If provided, adds a user message to the chat before triggering\n /\n send: (\n triggerName: string,\n input?: Record<string, unknown>,\n options?: { userMessage?: UserMessageInput },\n ) => Promise<void>;\n /* Stop the current streaming and finalize any partial message /\n stop: () => void;\n /\n Retry the last trigger from the same starting point.\n * Rolls back messages, re-adds the user message (if any), and re-executes.\n * No-op if no trigger has been sent yet.\n /\n retry: () => Promise<void>;\n /\n Observe an already-active execution without triggering a new one.\n * Only works with transports that support `observe()` (e.g., polling transport).\n * Use when the page loads and the session is already streaming.\n /\n observe: () => Promise<void>;\n /\n Replace the message list with externally-provided messages.\n * Use to sync with server-authoritative state (e.g., multi-observer scenarios).\n * Must NOT be called while streaming.\n /\n replaceMessages: (messages: UIMessage[]) => void;\n /\n Whether `retry()` can be called.\n * True when a trigger has been sent and the chat is not currently streaming or awaiting input.\n /\n canRetry: boolean;\n /\n Eagerly connect to the socket (socket transport only).\n * Returns a promise that resolves when connected or rejects on error.\n * Safe to call multiple times - subsequent calls resolve immediately if already connected.\n \n For HTTP transport, this is `undefined`.\n /\n connect: (() => Promise<void>) \| undefined;\n /\n Disconnect the socket (socket transport only).\n * The transport will reconnect automatically on next send().\n \n For HTTP transport, this is `undefined`.\n /\n disconnect: (() => void) \| undefined;\n /\n Upload files directly without sending a message.\n * Useful for showing upload progress before sending.\n \n @param files - Files to upload\n * @param onProgress - Optional progress callback\n * @returns Array of file references\n \n @example\n * ```typescript\n * const fileRefs = await uploadFiles(fileInput.files, (i, progress) => {\n * console.log(`File ${i}: ${progress}%`);\n * });\n * // Later...\n * await send('user-message', { FILES: fileRefs }, { userMessage: { files: fileRefs } });\n * ```\n /\n uploadFiles: (\n files: FileList \| File[],\n onProgress?: (fileIndex: number, progress: number) => void,\n ) => Promise<FileReference[]>;\n}\n\n/\n React hook for interacting with Octavus agents.\n * Provides chat state management and streaming support.\n \n When the transport changes (e.g., sessionId changes), the hook automatically\n * reinitializes with a fresh chat instance. Use `initialMessages` if you need\n * to preserve messages across transport changes.\n \n @example Basic usage with HTTP transport\n * ```tsx\n * import { useOctavusChat, createHttpTransport } from '@octavus/react';\n \n function Chat({ sessionId }) {\n * const transport = useMemo(\n * () => createHttpTransport({\n * request: (payload, options) =>\n * fetch('/api/trigger', {\n * method: 'POST',\n * headers: { 'Content-Type': 'application/json' },\n * body: JSON.stringify({ sessionId, ...payload }),\n * signal: options?.signal,\n * }),\n * }),\n * [sessionId],\n * );\n \n const { messages, status, send } = useOctavusChat({ transport });\n \n return (\n * <div>\n * {messages.map((msg) => (\n * <Message key={msg.id} message={msg} />\n * ))}\n * <button onClick={() => send('user-message', { USER_MESSAGE: 'Hello' })}>\n * Send\n * </button>\n * </div>\n * );\n * }\n * ```\n \n @example Socket transport with eager connection\n * ```tsx\n * import { useOctavusChat, createSocketTransport } from '@octavus/react';\n \n function Chat() {\n * const transport = useMemo(\n * () => createSocketTransport({\n * connect: () => new Promise((resolve, reject) => {\n * const sock = new SockJS('/octavus');\n * sock.onopen = () => resolve(sock);\n * sock.onerror = () => reject(new Error('Connection failed'));\n * }),\n * }),\n * [],\n * );\n \n const { messages, status, send, connectionState, connect, disconnect } =\n * useOctavusChat({ transport });\n \n // Eager connection on mount\n * useEffect(() => {\n * connect?.();\n * return () => disconnect?.();\n * }, [connect, disconnect]);\n \n return (\n * <div>\n * <StatusIndicator state={connectionState} />\n * {messages.map((msg) => <Message key={msg.id} message={msg} />)}\n * </div>\n * );\n * }\n * ```\n /\nexport function useOctavusChat(options: OctavusChatOptions): UseOctavusChatReturn {\n const chatRef = useRef<OctavusChat \| null>(null);\n const transportRef = useRef<Transport \| null>(null);\n const [sessionId, setSessionId] = useState<string \| null>(null);\n\n const sessionIdSetterRef = useRef(setSessionId);\n sessionIdSetterRef.current = setSessionId;\n\n if (transportRef.current !== options.transport) {\n chatRef.current?.stop();\n setSessionId(null);\n chatRef.current = new OctavusChat(options);\n transportRef.current = options.transport;\n }\n\n const chat = chatRef.current!;\n\n // Keep all mutable options (callbacks, tool handlers) fresh on every render.\n // This ensures handlers always reference the latest closures instead of going stale.\n chat.updateOptions({\n clientTools: options.clientTools,\n onError: options.onError,\n onFinish: options.onFinish,\n onStop: options.onStop,\n onResourceUpdate: options.onResourceUpdate,\n onStart: (id) => {\n sessionIdSetterRef.current(id);\n options.onStart?.(id);\n },\n requestUploadUrls: options.requestUploadUrls,\n uploadOptions: options.uploadOptions,\n });\n const transport = options.transport;\n\n const subscribe = useCallback((callback: () => void) => chat.subscribe(callback), [chat]);\n const getMessagesSnapshot = useCallback(() => chat.messages, [chat]);\n const getStatusSnapshot = useCallback(() => chat.status, [chat]);\n const getErrorSnapshot = useCallback(() => chat.error, [chat]);\n const getPendingClientToolsSnapshot = useCallback(() => chat.pendingClientTools, [chat]);\n const getCanRetrySnapshot = useCallback(() => chat.canRetry, [chat]);\n\n const messages = useSyncExternalStore(subscribe, getMessagesSnapshot, getMessagesSnapshot);\n const status = useSyncExternalStore(subscribe, getStatusSnapshot, getStatusSnapshot);\n const error = useSyncExternalStore(subscribe, getErrorSnapshot, getErrorSnapshot);\n const pendingClientTools = useSyncExternalStore(\n subscribe,\n getPendingClientToolsSnapshot,\n getPendingClientToolsSnapshot,\n );\n const canRetry = useSyncExternalStore(subscribe, getCanRetrySnapshot, getCanRetrySnapshot);\n\n const socketTransport = isSocketTransport(transport) ? transport : null;\n const [connectionState, setConnectionState] = useState<ConnectionState \| undefined>(\n socketTransport?.connectionState,\n );\n const [connectionError, setConnectionError] = useState<Error \| undefined>(undefined);\n\n useEffect(() => {\n if (!socketTransport) {\n setConnectionState(undefined);\n setConnectionError(undefined);\n return;\n }\n\n const unsubscribe = socketTransport.onConnectionStateChange((state, err) => {\n setConnectionState(state);\n setConnectionError(err);\n });\n\n return unsubscribe;\n }, [socketTransport]);\n\n const send = useCallback(\n (\n triggerName: string,\n input?: Record<string, unknown>,\n sendOptions?: { userMessage?: UserMessageInput },\n ) => chat.send(triggerName, input, sendOptions),\n [chat],\n );\n\n const stop = useCallback(() => chat.stop(), [chat]);\n const retry = useCallback(() => chat.retry(), [chat]);\n const observe = useCallback(() => chat.observe(), [chat]);\n const replaceMessages = useCallback((msgs: UIMessage[]) => chat.replaceMessages(msgs), [chat]);\n\n const uploadFiles = useCallback(\n (files: FileList \| File[], onProgress?: (fileIndex: number, progress: number) => void) =>\n chat.uploadFiles(files, onProgress),\n [chat],\n );\n\n // Stable references for connect/disconnect (socket transport only)\n const connect = useCallback(\n () => socketTransport?.connect() ?? Promise.resolve(),\n [socketTransport],\n );\n const disconnect = useCallback(() => socketTransport?.disconnect(), [socketTransport]);\n\n return {\n messages,\n status,\n error,\n sessionId,\n connectionState,\n connectionError,\n pendingClientTools,\n send,\n stop,\n retry,\n observe,\n replaceMessages,\n canRetry,\n connect: socketTransport ? connect : undefined,\n disconnect: socketTransport ? disconnect : undefined,\n uploadFiles,\n };\n}\n","'use client';\n\nimport { type RefObject, useRef, useCallback } from 'react';\n\nconst DEFAULT_THRESHOLD_PX = 80;\n\nexport interface UseAutoScrollOptions {\n /\n Provide your own ref if you need to share the scroll container\n * with other logic. When omitted, an internal ref is created.\n /\n scrollRef?: RefObject<HTMLDivElement \| null>;\n\n /\n Distance from the bottom (in pixels) within which auto-scroll\n * stays active. Defaults to 80.\n /\n threshold?: number;\n}\n\n/\n Smart auto-scroll for chat interfaces.\n \n Scrolls to bottom when new content arrives, but pauses if the user\n * has scrolled up to read earlier messages. Re-enables once the user\n * scrolls back near the bottom.\n \n @example\n * ```tsx\n * const { scrollRef, handleScroll, scrollOnUpdate, resetAutoScroll } = useAutoScroll();\n \n useEffect(() => {\n * const id = requestAnimationFrame(scrollOnUpdate);\n * return () => cancelAnimationFrame(id);\n * }, [messages, scrollOnUpdate]);\n \n <div ref={scrollRef} onScroll={handleScroll}>...</div>\n \n // On send: resetAutoScroll() to force-scroll on next update\n * ```\n /\nexport function useAutoScroll(options: UseAutoScrollOptions = {}) {\n const internalRef = useRef<HTMLDivElement>(null);\n const scrollRef = options.scrollRef ?? internalRef;\n const threshold = options.threshold ?? DEFAULT_THRESHOLD_PX;\n const shouldAutoScrollRef = useRef(true);\n // Swallows the async scroll event from a programmatic scrollTop write so it\n // can't falsely disable auto-scroll when content height grows between the\n // write and the event.\n const isProgrammaticScrollRef = useRef(false);\n\n const handleScroll = useCallback(() => {\n if (isProgrammaticScrollRef.current) {\n isProgrammaticScrollRef.current = false;\n return;\n }\n const el = scrollRef.current;\n if (!el) return;\n const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;\n shouldAutoScrollRef.current = distanceFromBottom <= threshold;\n }, [scrollRef, threshold]);\n\n const scrollOnUpdate = useCallback(() => {\n const el = scrollRef.current;\n if (!el) return;\n\n if (shouldAutoScrollRef.current) {\n // Only set the guard when the assignment actually moves scrollTop.\n // If we're already at the bottom, the browser fires no scroll event\n // and a stale `true` would swallow the next genuine user scroll.\n const previousScrollTop = el.scrollTop;\n el.scrollTop = el.scrollHeight;\n if (el.scrollTop !== previousScrollTop) {\n isProgrammaticScrollRef.current = true;\n }\n return;\n }\n\n const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;\n shouldAutoScrollRef.current = distanceFromBottom <= threshold;\n }, [scrollRef, threshold]);\n\n const resetAutoScroll = useCallback(() => {\n shouldAutoScrollRef.current = true;\n }, []);\n\n return { scrollRef, handleScroll, scrollOnUpdate, resetAutoScroll };\n}\n","export {\n useOctavusChat,\n type UseOctavusChatReturn,\n type OctavusChatOptions,\n type ChatStatus,\n type UserMessageInput,\n type ClientToolContext,\n type ClientToolHandler,\n type InteractiveTool,\n} from './hooks/use-octavus-chat';\n\nexport { useAutoScroll, type UseAutoScrollOptions } from './hooks/use-auto-scroll';\n\nexport type from '@octavus/client-sdk';\nexport {\n // Chat\n OctavusChat,\n // Files\n uploadFiles,\n // Stream\n parseSSEStream,\n // Transports\n createHttpTransport,\n createSocketTransport,\n isSocketTransport,\n createPollingTransport,\n // Error classes\n AppError,\n NotFoundError,\n ValidationError,\n ConflictError,\n ForbiddenError,\n OctavusError,\n // Error type guards\n isRateLimitError,\n isAuthenticationError,\n isProviderError,\n isToolError,\n isRetryableError,\n isValidationError,\n // Error event helpers\n createErrorEvent,\n errorToStreamEvent,\n createInternalErrorEvent,\n createApiErrorEvent,\n // Utilities\n generateId,\n isAbortError,\n // Thread helpers\n MAIN_THREAD,\n resolveThread,\n isMainThread,\n threadForPart,\n isOtherThread,\n // Type guards\n isFileReference,\n isFileReferenceArray,\n // Safe parse helpers\n safeParseStreamEvent,\n safeParseUIMessage,\n safeParseUIMessages,\n // Skills\n OCTAVUS_SKILL_TOOLS,\n isOctavusSkillTool,\n getSkillSlugFromToolCall,\n} from '@octavus/client-sdk';\n"],"mappings":"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","names":["uploadFiles","useRef","useCallback","OctavusChat","isSocketTransport"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@octavus/react",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "React bindings for Octavus agents",
   "license": "MIT",
   "author": "Octavus AI <dev@octavus.ai>",
@@ -47,7 +47,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@octavus/client-sdk": "^4.0.0"
+    "@octavus/client-sdk": "^4.2.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0"