npm - @octavus/react - Versions diffs - 2.2.0 → 2.4.0 - Mend

@octavus/react 2.2.0 → 2.4.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 (4) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -13,6 +13,14 @@ interface UseOctavusChatReturn {
      * Use type guards like `isRateLimitError()` or `isProviderError()` to check specific error types.
      */
     error: OctavusError | null;
+    /**
+     * The current session/execution ID from the most recent `send()` call.
+     * Updated when the server responds with a `start` event containing an execution ID.
+     * Useful for tracking activity logs or debugging.
+     *
+     * For workers, this is the execution ID. For interactive sessions, this is the session ID.
+     */
+    sessionId: string | null;
     /**
      * Socket connection state (socket transport only).
      * For HTTP transport, this is always `undefined`.

package/dist/index.js CHANGED Viewed

@@ -7,9 +7,21 @@ import {
 function useOctavusChat(options) {
   const chatRef = useRef(null);
   const transportRef = useRef(null);
+  const [sessionId, setSessionId] = useState(null);
+  const sessionIdSetterRef = useRef(setSessionId);
+  sessionIdSetterRef.current = setSessionId;
+  const userOnStartRef = useRef(options.onStart);
+  userOnStartRef.current = options.onStart;
   if (transportRef.current !== options.transport) {
     chatRef.current?.stop();
-    chatRef.current = new OctavusChat(options);
+    setSessionId(null);
+    chatRef.current = new OctavusChat({
+      ...options,
+      onStart: (id) => {
+        sessionIdSetterRef.current(id);
+        userOnStartRef.current?.(id);
+      }
+    });
     transportRef.current = options.transport;
   }
   const chat = chatRef.current;
@@ -62,6 +74,7 @@ function useOctavusChat(options) {
     messages,
     status,
     error,
+    sessionId,
     connectionState,
     connectionError,
     pendingClientTools,

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/hooks/use-octavus-chat.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 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 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\n if (transportRef.current !== options.transport) {\n chatRef.current?.stop();\n chatRef.current = new OctavusChat(options);\n transportRef.current = options.transport;\n }\n\n const chat = chatRef.current!;\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\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\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\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 connectionState,\n connectionError,\n pendingClientTools,\n send,\n stop,\n connect: socketTransport ? connect : undefined,\n disconnect: socketTransport ? disconnect : undefined,\n uploadFiles,\n };\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 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 // 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","OctavusChat","isSocketTransport"]}
1	+ {"version":3,"sources":["../src/hooks/use-octavus-chat.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 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 // Store the session ID setter in a ref so we can use it in a stable callback\n const sessionIdSetterRef = useRef(setSessionId);\n sessionIdSetterRef.current = setSessionId;\n\n // Store user's onStart callback in a ref\n const userOnStartRef = useRef(options.onStart);\n userOnStartRef.current = options.onStart;\n\n if (transportRef.current !== options.transport) {\n chatRef.current?.stop();\n // Reset session ID when transport changes\n setSessionId(null);\n // Create chat with wrapped onStart callback\n chatRef.current = new OctavusChat({\n ...options,\n onStart: (id) => {\n sessionIdSetterRef.current(id);\n userOnStartRef.current?.(id);\n },\n });\n transportRef.current = options.transport;\n }\n\n const chat = chatRef.current!;\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\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\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\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 connect: socketTransport ? connect : undefined,\n disconnect: socketTransport ? disconnect : undefined,\n uploadFiles,\n };\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 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 // 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":";AAEA,SAAS,QAAQ,aAAa,sBAAsB,UAAU,iBAAiB;AAC/E;AAAA,EACE;AAAA,EAEA;AAAA,OAaK;AAiMA,SAAS,eAAe,SAAmD;AAChF,QAAM,UAAU,OAA2B,IAAI;AAC/C,QAAM,eAAe,OAAyB,IAAI;AAClD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAwB,IAAI;AAG9D,QAAM,qBAAqB,OAAO,YAAY;AAC9C,qBAAmB,UAAU;AAG7B,QAAM,iBAAiB,OAAO,QAAQ,OAAO;AAC7C,iBAAe,UAAU,QAAQ;AAEjC,MAAI,aAAa,YAAY,QAAQ,WAAW;AAC9C,YAAQ,SAAS,KAAK;AAEtB,iBAAa,IAAI;AAEjB,YAAQ,UAAU,IAAI,YAAY;AAAA,MAChC,GAAG;AAAA,MACH,SAAS,CAAC,OAAO;AACf,2BAAmB,QAAQ,EAAE;AAC7B,uBAAe,UAAU,EAAE;AAAA,MAC7B;AAAA,IACF,CAAC;AACD,iBAAa,UAAU,QAAQ;AAAA,EACjC;AAEA,QAAM,OAAO,QAAQ;AACrB,QAAM,YAAY,QAAQ;AAE1B,QAAM,YAAY,YAAY,CAAC,aAAyB,KAAK,UAAU,QAAQ,GAAG,CAAC,IAAI,CAAC;AACxF,QAAM,sBAAsB,YAAY,MAAM,KAAK,UAAU,CAAC,IAAI,CAAC;AACnE,QAAM,oBAAoB,YAAY,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC;AAC/D,QAAM,mBAAmB,YAAY,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;AAC7D,QAAM,gCAAgC,YAAY,MAAM,KAAK,oBAAoB,CAAC,IAAI,CAAC;AAEvF,QAAM,WAAW,qBAAqB,WAAW,qBAAqB,mBAAmB;AACzF,QAAM,SAAS,qBAAqB,WAAW,mBAAmB,iBAAiB;AACnF,QAAM,QAAQ,qBAAqB,WAAW,kBAAkB,gBAAgB;AAChF,QAAM,qBAAqB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,kBAAkB,kBAAkB,SAAS,IAAI,YAAY;AACnE,QAAM,CAAC,iBAAiB,kBAAkB,IAAI;AAAA,IAC5C,iBAAiB;AAAA,EACnB;AACA,QAAM,CAAC,iBAAiB,kBAAkB,IAAI,SAA4B,MAAS;AAEnF,YAAU,MAAM;AACd,QAAI,CAAC,iBAAiB;AACpB,yBAAmB,MAAS;AAC5B,yBAAmB,MAAS;AAC5B;AAAA,IACF;AAEA,UAAM,cAAc,gBAAgB,wBAAwB,CAAC,OAAO,QAAQ;AAC1E,yBAAmB,KAAK;AACxB,yBAAmB,GAAG;AAAA,IACxB,CAAC;AAED,WAAO;AAAA,EACT,GAAG,CAAC,eAAe,CAAC;AAEpB,QAAM,OAAO;AAAA,IACX,CACE,aACA,OACA,gBACG,KAAK,KAAK,aAAa,OAAO,WAAW;AAAA,IAC9C,CAAC,IAAI;AAAA,EACP;AAEA,QAAM,OAAO,YAAY,MAAM,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC;AAElD,QAAMA,eAAc;AAAA,IAClB,CAAC,OAA0B,eACzB,KAAK,YAAY,OAAO,UAAU;AAAA,IACpC,CAAC,IAAI;AAAA,EACP;AAGA,QAAM,UAAU;AAAA,IACd,MAAM,iBAAiB,QAAQ,KAAK,QAAQ,QAAQ;AAAA,IACpD,CAAC,eAAe;AAAA,EAClB;AACA,QAAM,aAAa,YAAY,MAAM,iBAAiB,WAAW,GAAG,CAAC,eAAe,CAAC;AAErF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,kBAAkB,UAAU;AAAA,IACrC,YAAY,kBAAkB,aAAa;AAAA,IAC3C,aAAAA;AAAA,EACF;AACF;;;ACjTA;AAAA,EAEE,eAAAC;AAAA,EAEA;AAAA,EAEA;AAAA,EAEA;AAAA,EACA;AAAA,EACA,qBAAAC;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":["uploadFiles","OctavusChat","isSocketTransport"]}

package/package.json CHANGED Viewed

@@ -1,17 +1,17 @@
 {
   "name": "@octavus/react",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "React bindings for Octavus agents",
   "license": "MIT",
   "author": "Octavus AI <dev@octavus.ai>",
   "repository": {
     "type": "git",
-    "url": "https://github.com/octavus-ai/js-sdk.git",
+    "url": "https://github.com/octavus-ai/agent-sdk.git",
     "directory": "packages/react"
   },
   "homepage": "https://octavus.ai",
   "bugs": {
-    "url": "https://github.com/octavus-ai/js-sdk/issues"
+    "url": "https://github.com/octavus-ai/agent-sdk/issues"
   },
   "keywords": [
     "octavus",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@octavus/client-sdk": "^2.2.0"
+    "@octavus/client-sdk": "^2.4.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0"