@octavus/client-sdk 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { StreamEvent, UIMessage } from '@octavus/core';
+import { StreamEvent, FileReference, UIMessage } from '@octavus/core';
 export * from '@octavus/core';
-export { isOtherThread } from '@octavus/core';
+export { isFileReference, isFileReferenceArray, isOtherThread } from '@octavus/core';
 
 /**
  * Transport interface for delivering events from server to client.
@@ -113,14 +113,99 @@ interface SocketTransport extends Transport {
  */
 declare function isSocketTransport(transport: Transport): transport is SocketTransport;
 
+/**
+ * Response from the upload URLs endpoint
+ */
+interface UploadUrlsResponse {
+    files: {
+        id: string;
+        uploadUrl: string;
+        downloadUrl: string;
+    }[];
+}
+/**
+ * Options for uploading files
+ */
+interface UploadFilesOptions {
+    /**
+     * Function to request upload URLs from the platform.
+     * Consumer apps must implement this to authenticate with the platform.
+     *
+     * @param files - Array of file metadata to request URLs for
+     * @returns Response with presigned upload and download URLs
+     *
+     * @example
+     * ```typescript
+     * requestUploadUrls: async (files) => {
+     *   const response = await fetch('/api/upload-urls', {
+     *     method: 'POST',
+     *     headers: { 'Content-Type': 'application/json' },
+     *     body: JSON.stringify({ sessionId, files }),
+     *   });
+     *   return response.json();
+     * }
+     * ```
+     */
+    requestUploadUrls: (files: {
+        filename: string;
+        mediaType: string;
+        size: number;
+    }[]) => Promise<UploadUrlsResponse>;
+    /**
+     * Callback for upload progress (0-100 per file).
+     * Called multiple times during upload with real-time progress.
+     *
+     * @param fileIndex - Index of the file being uploaded
+     * @param progress - Progress percentage (0-100)
+     */
+    onProgress?: (fileIndex: number, progress: number) => void;
+}
+/**
+ * Upload files to the Octavus platform.
+ *
+ * This function:
+ * 1. Requests presigned upload URLs from the platform
+ * 2. Uploads each file directly to S3 with progress tracking
+ * 3. Returns file references that can be used in trigger input
+ *
+ * @param files - Files to upload (from file input or drag/drop)
+ * @param options - Upload configuration
+ * @returns Array of file references with download URLs
+ *
+ * @example
+ * ```typescript
+ * const fileRefs = await uploadFiles(fileInputRef.current.files, {
+ *   requestUploadUrls: async (files) => {
+ *     const response = await fetch('/api/upload-urls', {
+ *       method: 'POST',
+ *       headers: { 'Content-Type': 'application/json' },
+ *       body: JSON.stringify({ sessionId, files }),
+ *     });
+ *     return response.json();
+ *   },
+ *   onProgress: (fileIndex, progress) => {
+ *     console.log(`File ${fileIndex}: ${progress}%`);
+ *   },
+ * });
+ * ```
+ */
+declare function uploadFiles(files: FileList | File[], options: UploadFilesOptions): Promise<FileReference[]>;
+
 type ChatStatus = 'idle' | 'streaming' | 'error';
 /**
  * Input for creating a user message.
- * Currently supports text content. Will be extended to support attachments, images, etc.
+ * Supports text content and file attachments.
  */
 interface UserMessageInput {
     /** Text content of the message */
-    content: string;
+    content?: string;
+    /**
+     * File attachments (shorthand). Can be:
+     * - FileList: From file input element (will be uploaded via uploadFiles)
+     * - File[]: Array of File objects (will be uploaded via uploadFiles)
+     * - FileReference[]: Already uploaded files (used directly)
+     */
+    files?: FileList | File[] | FileReference[];
 }
 interface OctavusChatOptions {
     /**
@@ -128,6 +213,23 @@ interface OctavusChatOptions {
      * Use `createHttpTransport` for HTTP/SSE or `createSocketTransport` for WebSocket/SockJS.
      */
     transport: Transport;
+    /**
+     * Function to request upload URLs from the platform.
+     * Required if you want to use file uploads with FileList/File[].
+     *
+     * @example
+     * ```typescript
+     * requestUploadUrls: async (files) => {
+     *   const response = await fetch('/api/upload-urls', {
+     *     method: 'POST',
+     *     headers: { 'Content-Type': 'application/json' },
+     *     body: JSON.stringify({ sessionId, files }),
+     *   });
+     *   return response.json();
+     * }
+     * ```
+     */
+    requestUploadUrls?: UploadFilesOptions['requestUploadUrls'];
     /** Initial messages (for session refresh) */
     initialMessages?: UIMessage[];
     /** Callback when an error occurs */
@@ -199,10 +301,44 @@ declare class OctavusChat {
      * @param triggerName - The trigger name defined in the agent's protocol.yaml
      * @param input - Input parameters for the trigger (variable substitutions)
      * @param options.userMessage - If provided, adds a user message to the chat before triggering
+     *
+     * @example Send a text message
+     * ```typescript
+     * await chat.send('user-message',
+     *   { USER_MESSAGE: message },
+     *   { userMessage: { content: message } }
+     * );
+     * ```
+     *
+     * @example Send a message with file attachments
+     * ```typescript
+     * await chat.send('user-message',
+     *   { USER_MESSAGE: message, FILES: fileRefs },
+     *   { userMessage: { content: message, files: fileRefs } }
+     * );
+     * ```
      */
     send(triggerName: string, input?: Record<string, unknown>, sendOptions?: {
         userMessage?: UserMessageInput;
     }): Promise<void>;
+    /**
+     * Upload files directly without sending a message.
+     * Useful for showing upload progress before sending.
+     *
+     * @param files - Files to upload
+     * @param onProgress - Optional progress callback
+     * @returns Array of file references
+     *
+     * @example
+     * ```typescript
+     * const fileRefs = await chat.uploadFiles(fileInput.files, (i, progress) => {
+     *   console.log(`File ${i}: ${progress}%`);
+     * });
+     * // Later...
+     * await chat.send('user-message', { FILES: fileRefs }, { userMessage: { files: fileRefs } });
+     * ```
+     */
+    uploadFiles(files: FileList | File[], onProgress?: (fileIndex: number, progress: number) => void): Promise<FileReference[]>;
     /** Stop the current streaming and finalize any partial message */
     stop(): void;
     private handleStreamEvent;
@@ -364,4 +500,4 @@ interface SocketTransportOptions {
  */
 declare function createSocketTransport(options: SocketTransportOptions): SocketTransport;
 
-export { type ChatStatus, type ConnectionState, type ConnectionStateListener, type HttpTransportOptions, OctavusChat, type OctavusChatOptions, type SocketLike, type SocketTransport, type SocketTransportOptions, type Transport, type UserMessageInput, createHttpTransport, createSocketTransport, isSocketTransport, parseSSEStream };
+export { type ChatStatus, type ConnectionState, type ConnectionStateListener, type HttpTransportOptions, OctavusChat, type OctavusChatOptions, type SocketLike, type SocketTransport, type SocketTransportOptions, type Transport, type UploadFilesOptions, type UploadUrlsResponse, type UserMessageInput, createHttpTransport, createSocketTransport, isSocketTransport, parseSSEStream, uploadFiles };

package/dist/index.js

@@ -1,14 +1,91 @@
 // src/chat.ts
 import {
   generateId,
-  threadForPart
+  threadForPart,
+  isFileReferenceArray
 } from "@octavus/core";
+
+// src/files.ts
+function uploadFileWithProgress(url, file, onProgress) {
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.upload.addEventListener("progress", (event) => {
+      if (event.lengthComputable) {
+        const progress = Math.round(event.loaded / event.total * 100);
+        onProgress?.(progress);
+      }
+    });
+    xhr.addEventListener("load", () => {
+      if (xhr.status >= 200 && xhr.status < 300) {
+        resolve();
+      } else {
+        reject(new Error(`Upload failed with status ${xhr.status}`));
+      }
+    });
+    xhr.addEventListener("error", () => {
+      reject(new Error("Upload failed: network error"));
+    });
+    xhr.addEventListener("abort", () => {
+      reject(new Error("Upload aborted"));
+    });
+    xhr.open("PUT", url);
+    xhr.setRequestHeader("Content-Type", file.type || "application/octet-stream");
+    xhr.send(file);
+  });
+}
+async function uploadFiles(files, options) {
+  const fileArray = Array.from(files);
+  if (fileArray.length === 0) {
+    return [];
+  }
+  const { files: uploadInfos } = await options.requestUploadUrls(
+    fileArray.map((f) => ({
+      filename: f.name,
+      mediaType: f.type || "application/octet-stream",
+      size: f.size
+    }))
+  );
+  const references = [];
+  for (let i = 0; i < fileArray.length; i++) {
+    const file = fileArray[i];
+    const uploadInfo = uploadInfos[i];
+    await uploadFileWithProgress(uploadInfo.uploadUrl, file, (progress) => {
+      options.onProgress?.(i, progress);
+    });
+    references.push({
+      id: uploadInfo.id,
+      mediaType: file.type || "application/octet-stream",
+      url: uploadInfo.downloadUrl,
+      filename: file.name,
+      size: file.size
+    });
+  }
+  return references;
+}
+
+// src/chat.ts
 var OPERATION_BLOCK_TYPES = /* @__PURE__ */ new Set(["set-resource", "serialize-thread", "generate-image"]);
-function createUserMessage(input) {
+function createUserMessage(input, files) {
+  const parts = [];
+  if (files && files.length > 0) {
+    for (const file of files) {
+      parts.push({
+        type: "file",
+        id: file.id,
+        mediaType: file.mediaType,
+        url: file.url,
+        filename: file.filename,
+        size: file.size
+      });
+    }
+  }
+  if (input.content) {
+    parts.push({ type: "text", text: input.content, status: "done" });
+  }
   return {
     id: generateId(),
     role: "user",
-    parts: [{ type: "text", text: input.content, status: "done" }],
+    parts,
     status: "done",
     createdAt: /* @__PURE__ */ new Date()
   };
@@ -149,18 +226,60 @@ var OctavusChat = class {
    * @param triggerName - The trigger name defined in the agent's protocol.yaml
    * @param input - Input parameters for the trigger (variable substitutions)
    * @param options.userMessage - If provided, adds a user message to the chat before triggering
+   *
+   * @example Send a text message
+   * ```typescript
+   * await chat.send('user-message',
+   *   { USER_MESSAGE: message },
+   *   { userMessage: { content: message } }
+   * );
+   * ```
+   *
+   * @example Send a message with file attachments
+   * ```typescript
+   * await chat.send('user-message',
+   *   { USER_MESSAGE: message, FILES: fileRefs },
+   *   { userMessage: { content: message, files: fileRefs } }
+   * );
+   * ```
    */
   async send(triggerName, input, sendOptions) {
     this.transport.stop();
+    let fileRefs;
+    if (sendOptions?.userMessage?.files) {
+      const files = sendOptions.userMessage.files;
+      if (isFileReferenceArray(files)) {
+        fileRefs = files;
+      } else if (this.options.requestUploadUrls) {
+        fileRefs = await uploadFiles(files, {
+          requestUploadUrls: this.options.requestUploadUrls
+        });
+      } else {
+        throw new Error(
+          "File upload requires requestUploadUrls option. Either provide FileReference[] or configure requestUploadUrls."
+        );
+      }
+    }
+    let processedInput = input;
+    if (input?.FILES !== void 0 && !isFileReferenceArray(input.FILES)) {
+      if (this.options.requestUploadUrls) {
+        const inputFiles = input.FILES;
+        const uploadedRefs = fileRefs ?? await uploadFiles(inputFiles, {
+          requestUploadUrls: this.options.requestUploadUrls
+        });
+        processedInput = { ...input, FILES: uploadedRefs };
+        fileRefs = fileRefs ?? uploadedRefs;
+      }
+    }
     if (sendOptions?.userMessage !== void 0) {
-      const userMsg = createUserMessage(sendOptions.userMessage);
+      const userMsg = createUserMessage(sendOptions.userMessage, fileRefs);
       this.setMessages([...this._messages, userMsg]);
     }
     this.setStatus("streaming");
     this.setError(null);
     this.streamingState = createEmptyStreamingState();
     try {
-      for await (const event of this.transport.trigger(triggerName, input)) {
+      for await (const event of this.transport.trigger(triggerName, processedInput)) {
         if (this.streamingState === null) break;
         this.handleStreamEvent(event, this.streamingState);
       }
@@ -172,6 +291,32 @@ var OctavusChat = class {
       this.options.onError?.(errorObj);
     }
   }
+  /**
+   * Upload files directly without sending a message.
+   * Useful for showing upload progress before sending.
+   *
+   * @param files - Files to upload
+   * @param onProgress - Optional progress callback
+   * @returns Array of file references
+   *
+   * @example
+   * ```typescript
+   * const fileRefs = await chat.uploadFiles(fileInput.files, (i, progress) => {
+   *   console.log(`File ${i}: ${progress}%`);
+   * });
+   * // Later...
+   * await chat.send('user-message', { FILES: fileRefs }, { userMessage: { files: fileRefs } });
+   * ```
+   */
+  async uploadFiles(files, onProgress) {
+    if (!this.options.requestUploadUrls) {
+      throw new Error("File upload requires requestUploadUrls option");
+    }
+    return await uploadFiles(files, {
+      requestUploadUrls: this.options.requestUploadUrls,
+      onProgress
+    });
+  }
   /** Stop the current streaming and finalize any partial message */
   stop() {
     this.transport.stop();
@@ -559,7 +704,7 @@ async function* parseSSEStream(response) {
 }
 
 // src/index.ts
-import { isOtherThread } from "@octavus/core";
+import { isOtherThread, isFileReference, isFileReferenceArray as isFileReferenceArray2 } from "@octavus/core";
 
 // src/transports/types.ts
 function isSocketTransport(transport) {
@@ -748,8 +893,11 @@ export {
   OctavusChat,
   createHttpTransport,
   createSocketTransport,
+  isFileReference,
+  isFileReferenceArray2 as isFileReferenceArray,
   isOtherThread,
   isSocketTransport,
-  parseSSEStream
+  parseSSEStream,
+  uploadFiles
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/chat.ts","../src/stream/reader.ts","../src/index.ts","../src/transports/types.ts","../src/transports/http.ts","../src/transports/socket.ts"],"sourcesContent":["import {\n  generateId,\n  threadForPart,\n  type UIMessage,\n  type UIMessagePart,\n  type UITextPart,\n  type UIReasoningPart,\n  type UIToolCallPart,\n  type UIOperationPart,\n  type UISourcePart,\n  type UIFilePart,\n  type UIObjectPart,\n  type DisplayMode,\n  type StreamEvent,\n} from '@octavus/core';\nimport type { Transport } from './transports/types';\n\n/** Block types that are internal operations (not LLM-driven) */\nconst OPERATION_BLOCK_TYPES = new Set(['set-resource', 'serialize-thread', 'generate-image']);\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport type ChatStatus = 'idle' | 'streaming' | 'error';\n\n/**\n * Input for creating a user message.\n * Currently supports text content. Will be extended to support attachments, images, etc.\n */\nexport interface UserMessageInput {\n  /** Text content of the message */\n  content: string;\n}\n\nexport interface OctavusChatOptions {\n  /**\n   * Transport for streaming events.\n   * Use `createHttpTransport` for HTTP/SSE or `createSocketTransport` for WebSocket/SockJS.\n   */\n  transport: Transport;\n\n  /** Initial messages (for session refresh) */\n  initialMessages?: UIMessage[];\n  /** Callback when an error occurs */\n  onError?: (error: Error) => void;\n  /** Callback when streaming finishes */\n  onFinish?: () => void;\n  /** Callback when a resource is updated */\n  onResourceUpdate?: (name: string, value: unknown) => void;\n}\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\ninterface BlockState {\n  blockId: string;\n  blockName: string;\n  blockType: string;\n  display: DisplayMode;\n  description?: string;\n  outputToChat: boolean;\n  thread?: string;\n  reasoning: string;\n  text: string;\n  toolCalls: Map<string, UIToolCallPart>;\n}\n\ninterface StreamingState {\n  messageId: string;\n  parts: UIMessagePart[];\n  activeBlock: BlockState | null;\n  blocks: Map<string, BlockState>;\n  currentTextPartIndex: number | null;\n  currentReasoningPartIndex: number | null;\n  currentObjectPartIndex: number | null;\n  accumulatedJson: string;\n}\n\ntype Listener = () => void;\n\n// =============================================================================\n// Helpers\n// =============================================================================\n\nfunction createUserMessage(input: UserMessageInput): UIMessage {\n  return {\n    id: generateId(),\n    role: 'user',\n    parts: [{ type: 'text', text: input.content, status: 'done' }],\n    status: 'done',\n    createdAt: new Date(),\n  };\n}\n\n/**\n * Parse partial JSON by fixing incomplete structures (unclosed strings, brackets, braces).\n */\nfunction parsePartialJson(jsonText: string): unknown {\n  if (!jsonText.trim()) {\n    return undefined;\n  }\n\n  try {\n    return JSON.parse(jsonText) as unknown;\n  } catch {\n    // Continue to fix incomplete JSON\n  }\n\n  let fixed = jsonText;\n\n  // Count unclosed brackets/braces while tracking string boundaries\n  let openBraces = 0;\n  let openBrackets = 0;\n  let inString = false;\n  let escaped = false;\n\n  for (const char of fixed) {\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n\n    if (char === '\\\\') {\n      escaped = true;\n      continue;\n    }\n\n    if (char === '\"') {\n      inString = !inString;\n      continue;\n    }\n\n    if (!inString) {\n      if (char === '{') openBraces += 1;\n      else if (char === '}') openBraces -= 1;\n      else if (char === '[') openBrackets += 1;\n      else if (char === ']') openBrackets -= 1;\n    }\n  }\n\n  // Close unclosed structures\n  if (inString) {\n    fixed += '\"';\n  }\n  while (openBrackets > 0) {\n    fixed += ']';\n    openBrackets -= 1;\n  }\n  while (openBraces > 0) {\n    fixed += '}';\n    openBraces -= 1;\n  }\n\n  try {\n    return JSON.parse(fixed) as unknown;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction createEmptyStreamingState(): StreamingState {\n  return {\n    messageId: generateId(),\n    parts: [],\n    activeBlock: null,\n    blocks: new Map(),\n    currentTextPartIndex: null,\n    currentReasoningPartIndex: null,\n    currentObjectPartIndex: null,\n    accumulatedJson: '',\n  };\n}\n\nfunction buildMessageFromState(state: StreamingState, status: 'streaming' | 'done'): UIMessage {\n  return {\n    id: state.messageId,\n    role: 'assistant',\n    parts: [...state.parts],\n    status,\n    createdAt: new Date(),\n  };\n}\n\n// =============================================================================\n// OctavusChat Class\n// =============================================================================\n\n/**\n * Framework-agnostic chat client for Octavus agents.\n * Manages chat state and streaming, allowing reactive frameworks to subscribe to updates.\n *\n * @example HTTP transport (Next.js, etc.)\n * ```typescript\n * import { OctavusChat, createHttpTransport } from '@octavus/client-sdk';\n *\n * const chat = new OctavusChat({\n *   transport: createHttpTransport({\n *     triggerRequest: (triggerName, input) =>\n *       fetch('/api/trigger', {\n *         method: 'POST',\n *         body: JSON.stringify({ sessionId, triggerName, input }),\n *       }),\n *   }),\n * });\n * ```\n *\n * @example Socket transport (WebSocket, SockJS, Meteor)\n * ```typescript\n * import { OctavusChat, createSocketTransport } from '@octavus/client-sdk';\n *\n * const chat = new OctavusChat({\n *   transport: createSocketTransport({\n *     connect: () => new Promise((resolve, reject) => {\n *       const ws = new WebSocket(`wss://api.octavus.ai/stream?sessionId=${sessionId}`);\n *       ws.onopen = () => resolve(ws);\n *       ws.onerror = () => reject(new Error('Connection failed'));\n *     }),\n *   }),\n * });\n * ```\n */\nexport class OctavusChat {\n  // Private state\n  private _messages: UIMessage[];\n  private _status: ChatStatus = 'idle';\n  private _error: Error | null = null;\n  private options: OctavusChatOptions;\n  private transport: Transport;\n  private streamingState: StreamingState | null = null;\n\n  // Listener sets for reactive frameworks\n  private listeners = new Set<Listener>();\n\n  constructor(options: OctavusChatOptions) {\n    this.options = options;\n    this._messages = options.initialMessages ?? [];\n    this.transport = options.transport;\n  }\n\n  // =========================================================================\n  // Public Getters\n  // =========================================================================\n\n  get messages(): UIMessage[] {\n    return this._messages;\n  }\n\n  get status(): ChatStatus {\n    return this._status;\n  }\n\n  get error(): Error | null {\n    return this._error;\n  }\n\n  // =========================================================================\n  // Subscription Methods (for reactive frameworks)\n  // =========================================================================\n\n  /**\n   * Subscribe to state changes. The callback is called whenever messages, status, or error changes.\n   * @returns Unsubscribe function\n   */\n  subscribe(listener: Listener): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private notifyListeners(): void {\n    this.listeners.forEach((l) => l());\n  }\n\n  // =========================================================================\n  // Private Setters (notify listeners)\n  // =========================================================================\n\n  private setMessages(messages: UIMessage[]): void {\n    this._messages = messages;\n    this.notifyListeners();\n  }\n\n  private setStatus(status: ChatStatus): void {\n    this._status = status;\n    this.notifyListeners();\n  }\n\n  private setError(error: Error | null): void {\n    this._error = error;\n    this.notifyListeners();\n  }\n\n  // =========================================================================\n  // Public Methods\n  // =========================================================================\n\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  async send(\n    triggerName: string,\n    input?: Record<string, unknown>,\n    sendOptions?: { userMessage?: UserMessageInput },\n  ): Promise<void> {\n    this.transport.stop();\n\n    if (sendOptions?.userMessage !== undefined) {\n      const userMsg = createUserMessage(sendOptions.userMessage);\n      this.setMessages([...this._messages, userMsg]);\n    }\n\n    this.setStatus('streaming');\n    this.setError(null);\n    this.streamingState = createEmptyStreamingState();\n\n    try {\n      for await (const event of this.transport.trigger(triggerName, input)) {\n        if (this.streamingState === null) break;\n\n        this.handleStreamEvent(event, this.streamingState);\n      }\n    } catch (err) {\n      const errorObj = err instanceof Error ? err : new Error('Unknown error');\n      this.setError(errorObj);\n      this.setStatus('error');\n      this.streamingState = null;\n      this.options.onError?.(errorObj);\n    }\n  }\n\n  /** Stop the current streaming and finalize any partial message */\n  stop(): void {\n    this.transport.stop();\n\n    const state = this.streamingState;\n    if (state && state.parts.length > 0) {\n      const finalMessage = buildMessageFromState(state, 'done');\n      const messages = [...this._messages];\n      const lastMsg = messages[messages.length - 1];\n      if (lastMsg && lastMsg.id === state.messageId) {\n        messages[messages.length - 1] = finalMessage;\n      } else {\n        messages.push(finalMessage);\n      }\n      this.setMessages(messages);\n    }\n\n    this.streamingState = null;\n    this.setStatus('idle');\n  }\n\n  // =========================================================================\n  // Private Helpers\n  // =========================================================================\n\n  private handleStreamEvent(event: StreamEvent, state: StreamingState): void {\n    switch (event.type) {\n      case 'start':\n        break;\n\n      case 'block-start': {\n        const block: BlockState = {\n          blockId: event.blockId,\n          blockName: event.blockName,\n          blockType: event.blockType,\n          display: event.display,\n          description: event.description,\n          outputToChat: event.outputToChat ?? true,\n          thread: event.thread,\n          reasoning: '',\n          text: '',\n          toolCalls: new Map(),\n        };\n        state.blocks.set(event.blockId, block);\n        state.activeBlock = block;\n\n        const isOperation = OPERATION_BLOCK_TYPES.has(event.blockType);\n        const isHidden = event.display === 'hidden';\n        if (isOperation && !isHidden) {\n          const thread = event.thread;\n          const operationPart: UIOperationPart = {\n            type: 'operation',\n            operationId: event.blockId,\n            name: event.description ?? event.blockName,\n            operationType: event.blockType,\n            status: 'running',\n            thread: threadForPart(thread),\n          };\n          state.parts.push(operationPart);\n        }\n\n        state.currentTextPartIndex = null;\n        state.currentReasoningPartIndex = null;\n\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'block-end': {\n        const operationPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'operation' && p.operationId === event.blockId,\n        );\n        if (operationPartIndex >= 0) {\n          const part = state.parts[operationPartIndex] as UIOperationPart;\n          state.parts[operationPartIndex] = { ...part, status: 'done' };\n        }\n\n        if (state.activeBlock?.blockId === event.blockId) {\n          state.activeBlock = null;\n        }\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'reasoning-start': {\n        const reasoningPart: UIReasoningPart = {\n          type: 'reasoning',\n          text: '',\n          status: 'streaming',\n          thread: threadForPart(state.activeBlock?.thread),\n        };\n        state.parts.push(reasoningPart);\n        state.currentReasoningPartIndex = state.parts.length - 1;\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'reasoning-delta': {\n        if (state.currentReasoningPartIndex !== null) {\n          const part = state.parts[state.currentReasoningPartIndex] as UIReasoningPart;\n          part.text += event.delta;\n          state.parts[state.currentReasoningPartIndex] = { ...part };\n        }\n\n        if (state.activeBlock) {\n          state.activeBlock.reasoning += event.delta;\n        }\n\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'reasoning-end': {\n        if (state.currentReasoningPartIndex !== null) {\n          const part = state.parts[state.currentReasoningPartIndex] as UIReasoningPart;\n          part.status = 'done';\n          state.parts[state.currentReasoningPartIndex] = { ...part };\n          state.currentReasoningPartIndex = null;\n        }\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'text-start': {\n        const thread = threadForPart(state.activeBlock?.thread);\n        const shouldAddPart = state.activeBlock?.outputToChat !== false || thread !== undefined;\n\n        if (shouldAddPart) {\n          // Structured output mode: accumulate JSON and parse progressively\n          if (event.responseType) {\n            const objectPart: UIObjectPart = {\n              type: 'object',\n              id: event.id,\n              typeName: event.responseType,\n              partial: undefined,\n              object: undefined,\n              status: 'streaming',\n              thread,\n            };\n            state.parts.push(objectPart);\n            state.currentObjectPartIndex = state.parts.length - 1;\n            state.accumulatedJson = '';\n            state.currentTextPartIndex = null;\n          } else {\n            const textPart: UITextPart = {\n              type: 'text',\n              text: '',\n              status: 'streaming',\n              thread,\n            };\n            state.parts.push(textPart);\n            state.currentTextPartIndex = state.parts.length - 1;\n            state.currentObjectPartIndex = null;\n          }\n        }\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'text-delta': {\n        if (state.currentObjectPartIndex !== null) {\n          state.accumulatedJson += event.delta;\n          const part = state.parts[state.currentObjectPartIndex] as UIObjectPart;\n          const parsed = parsePartialJson(state.accumulatedJson);\n          if (parsed !== undefined) {\n            part.partial = parsed;\n            state.parts[state.currentObjectPartIndex] = { ...part };\n          }\n        } else if (state.currentTextPartIndex !== null) {\n          const part = state.parts[state.currentTextPartIndex] as UITextPart;\n          part.text += event.delta;\n          state.parts[state.currentTextPartIndex] = { ...part };\n        }\n\n        if (state.activeBlock) {\n          state.activeBlock.text += event.delta;\n        }\n\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'text-end': {\n        if (state.currentObjectPartIndex !== null) {\n          const part = state.parts[state.currentObjectPartIndex] as UIObjectPart;\n          try {\n            const finalObject = JSON.parse(state.accumulatedJson) as unknown;\n            part.object = finalObject;\n            part.partial = finalObject;\n            part.status = 'done';\n          } catch {\n            // Keep partial data but mark as error\n            part.status = 'error';\n            part.error = 'Failed to parse response as JSON';\n          }\n          state.parts[state.currentObjectPartIndex] = { ...part };\n          state.currentObjectPartIndex = null;\n          state.accumulatedJson = '';\n        } else if (state.currentTextPartIndex !== null) {\n          const part = state.parts[state.currentTextPartIndex] as UITextPart;\n          part.status = 'done';\n          state.parts[state.currentTextPartIndex] = { ...part };\n          state.currentTextPartIndex = null;\n        }\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'tool-input-start': {\n        const toolPart: UIToolCallPart = {\n          type: 'tool-call',\n          toolCallId: event.toolCallId,\n          toolName: event.toolName,\n          displayName: event.title,\n          args: {},\n          status: 'pending',\n          thread: threadForPart(state.activeBlock?.thread),\n        };\n        state.parts.push(toolPart);\n\n        if (state.activeBlock) {\n          state.activeBlock.toolCalls.set(event.toolCallId, toolPart);\n        }\n\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'tool-input-delta': {\n        const toolPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'tool-call' && p.toolCallId === event.toolCallId,\n        );\n        if (toolPartIndex >= 0) {\n          try {\n            const part = state.parts[toolPartIndex] as UIToolCallPart;\n            part.args = JSON.parse(event.inputTextDelta) as Record<string, unknown>;\n            state.parts[toolPartIndex] = { ...part };\n            this.updateStreamingMessage();\n          } catch {\n            // Partial JSON, ignore\n          }\n        }\n        break;\n      }\n\n      case 'tool-input-end':\n        // Input streaming ended, wait for tool-input-available\n        break;\n\n      case 'tool-input-available': {\n        const toolPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'tool-call' && p.toolCallId === event.toolCallId,\n        );\n        if (toolPartIndex >= 0) {\n          const part = state.parts[toolPartIndex] as UIToolCallPart;\n          part.args = event.input as Record<string, unknown>;\n          part.status = 'running';\n          state.parts[toolPartIndex] = { ...part };\n          this.updateStreamingMessage();\n        }\n        break;\n      }\n\n      case 'tool-output-available': {\n        const toolPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'tool-call' && p.toolCallId === event.toolCallId,\n        );\n        if (toolPartIndex >= 0) {\n          const part = state.parts[toolPartIndex] as UIToolCallPart;\n          part.result = event.output;\n          part.status = 'done';\n          state.parts[toolPartIndex] = { ...part };\n          this.updateStreamingMessage();\n        }\n        break;\n      }\n\n      case 'tool-output-error': {\n        const toolPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'tool-call' && p.toolCallId === event.toolCallId,\n        );\n        if (toolPartIndex >= 0) {\n          const part = state.parts[toolPartIndex] as UIToolCallPart;\n          part.error = event.errorText;\n          part.status = 'error';\n          state.parts[toolPartIndex] = { ...part };\n          this.updateStreamingMessage();\n        }\n        break;\n      }\n\n      case 'source': {\n        // Add source (URL or document) as a part - aligned with Vercel AI SDK\n        const thread = threadForPart(state.activeBlock?.thread);\n\n        let sourcePart: UISourcePart;\n        if (event.sourceType === 'url') {\n          sourcePart = {\n            type: 'source',\n            sourceType: 'url',\n            id: event.id,\n            url: event.url,\n            title: event.title,\n            thread,\n          };\n        } else {\n          sourcePart = {\n            type: 'source',\n            sourceType: 'document',\n            id: event.id,\n            mediaType: event.mediaType,\n            title: event.title,\n            filename: event.filename,\n            thread,\n          };\n        }\n\n        state.parts.push(sourcePart);\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'file-available': {\n        // Add generated file as a part (aligned with Vercel AI SDK FilePart)\n        const filePart: UIFilePart = {\n          type: 'file',\n          id: event.id,\n          mediaType: event.mediaType,\n          url: event.url,\n          filename: event.filename,\n          size: event.size,\n          toolCallId: event.toolCallId,\n          thread: threadForPart(state.activeBlock?.thread),\n        };\n        state.parts.push(filePart);\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'resource-update':\n        this.options.onResourceUpdate?.(event.name, event.value);\n        break;\n\n      case 'finish': {\n        const finalMessage = buildMessageFromState(state, 'done');\n\n        finalMessage.parts = finalMessage.parts.map((part) => {\n          if (part.type === 'text' || part.type === 'reasoning') {\n            return { ...part, status: 'done' as const };\n          }\n          if (part.type === 'object' && part.status === 'streaming') {\n            return { ...part, status: 'done' as const };\n          }\n          return part;\n        });\n\n        if (finalMessage.parts.length > 0) {\n          const messages = [...this._messages];\n          const lastMsg = messages[messages.length - 1];\n          if (lastMsg && lastMsg.id === state.messageId) {\n            messages[messages.length - 1] = finalMessage;\n          } else {\n            messages.push(finalMessage);\n          }\n          this.setMessages(messages);\n        }\n\n        this.setStatus('idle');\n        this.streamingState = null;\n        this.options.onFinish?.();\n        break;\n      }\n\n      case 'error':\n        throw new Error(event.errorText);\n\n      case 'tool-request':\n        // Handled by server-sdk, not relevant for UI\n        break;\n    }\n  }\n\n  private updateStreamingMessage(): void {\n    const state = this.streamingState;\n    if (!state) return;\n\n    const msg = buildMessageFromState(state, 'streaming');\n    const messages = [...this._messages];\n\n    const lastMsg = messages[messages.length - 1];\n    if (lastMsg && lastMsg.id === state.messageId) {\n      messages[messages.length - 1] = msg;\n    } else {\n      messages.push(msg);\n    }\n\n    this.setMessages(messages);\n  }\n}\n","import { safeParseStreamEvent, type StreamEvent } from '@octavus/core';\n\n/**\n * Parse SSE stream events\n */\nexport async function* parseSSEStream(\n  response: Response,\n): AsyncGenerator<StreamEvent, void, unknown> {\n  const reader = response.body?.getReader();\n  if (!reader) {\n    throw new Error('Response body is not readable');\n  }\n\n  const decoder = new TextDecoder();\n  let buffer = '';\n\n  try {\n    let reading = true;\n    while (reading) {\n      const { done, value } = await reader.read();\n\n      if (done) {\n        reading = false;\n        continue;\n      }\n\n      buffer += decoder.decode(value, { stream: true });\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() ?? '';\n\n      for (const line of lines) {\n        if (line.startsWith('data: ') && line !== 'data: [DONE]') {\n          try {\n            const parsed = safeParseStreamEvent(JSON.parse(line.slice(6)));\n            if (parsed.success) {\n              yield parsed.data;\n            }\n            // Skip malformed events silently\n          } catch {\n            // Skip malformed JSON - no logging in production\n          }\n        }\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n","export {\n  OctavusChat,\n  type OctavusChatOptions,\n  type ChatStatus,\n  type UserMessageInput,\n} from './chat';\n\nexport { parseSSEStream } from './stream/reader';\n\nexport { isOtherThread } from '@octavus/core';\n\n// Transport exports\nexport {\n  createHttpTransport,\n  createSocketTransport,\n  isSocketTransport,\n  type Transport,\n  type SocketTransport,\n  type ConnectionState,\n  type ConnectionStateListener,\n  type HttpTransportOptions,\n  type SocketLike,\n  type SocketTransportOptions,\n} from './transports';\n\n// Re-export all types from core so consumers don't need to install @octavus/core separately\nexport type * from '@octavus/core';\n","import type { StreamEvent } from '@octavus/core';\n\n// =============================================================================\n// Base Transport Interface\n// =============================================================================\n\n/**\n * Transport interface for delivering events from server to client.\n *\n * Abstracts the connection mechanism (HTTP/SSE or WebSocket) behind a unified\n * async iterator interface. Use `createHttpTransport` or `createSocketTransport`\n * to create an implementation.\n */\nexport interface Transport {\n  /**\n   * Trigger the agent and stream events.\n   * @param triggerName - The trigger name defined in the agent's protocol\n   * @param input - Input parameters for variable substitution\n   */\n  trigger(triggerName: string, input?: Record<string, unknown>): AsyncIterable<StreamEvent>;\n\n  /** Stop the current stream. Safe to call when no stream is active. */\n  stop(): void;\n}\n\n// =============================================================================\n// Socket Transport (extends Transport with connection management)\n// =============================================================================\n\n/**\n * Connection states for socket transport.\n *\n * - `disconnected`: Not connected (initial state or after disconnect)\n * - `connecting`: Connection attempt in progress\n * - `connected`: Successfully connected and ready\n * - `error`: Connection failed (check error in listener callback)\n */\nexport type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'error';\n\n/**\n * Callback for connection state changes.\n */\nexport type ConnectionStateListener = (state: ConnectionState, error?: Error) => void;\n\n/**\n * Socket transport with connection management capabilities.\n *\n * Extends the base Transport interface with methods for managing persistent\n * WebSocket/SockJS connections. Use this when you need:\n * - Eager connection (connect before first message)\n * - Connection status UI indicators\n * - Manual connection lifecycle control\n *\n * Created via `createSocketTransport()`.\n */\nexport interface SocketTransport extends Transport {\n  /**\n   * Current connection state.\n   *\n   * - `disconnected`: Not connected (initial state)\n   * - `connecting`: Connection in progress\n   * - `connected`: Ready to send/receive\n   * - `error`: Connection failed\n   */\n  readonly connectionState: ConnectionState;\n\n  /**\n   * Subscribe to connection state changes.\n   *\n   * The listener is called immediately with the current state, then again\n   * whenever the state changes.\n   *\n   * @param listener - Callback invoked on state changes\n   * @returns Unsubscribe function\n   *\n   * @example\n   * ```typescript\n   * const unsubscribe = transport.onConnectionStateChange((state, error) => {\n   *   setConnectionState(state);\n   *   if (error) setConnectionError(error);\n   * });\n   * ```\n   */\n  onConnectionStateChange(listener: ConnectionStateListener): () => void;\n\n  /**\n   * Eagerly establish the connection.\n   *\n   * By default, socket transport connects lazily on first `trigger()`. Call\n   * this method to establish the connection early (e.g., on component mount):\n   * - Faster first message response\n   * - Show accurate connection status in UI\n   * - Handle connection errors before user interaction\n   *\n   * Safe to call multiple times - resolves immediately if already connected.\n   *\n   * @example\n   * ```tsx\n   * useEffect(() => {\n   *   transport.connect()\n   *     .then(() => console.log('Connected'))\n   *     .catch((err) => console.error('Failed:', err));\n   *\n   *   return () => transport.disconnect();\n   * }, [transport]);\n   * ```\n   */\n  connect(): Promise<void>;\n\n  /**\n   * Close the connection and clean up resources.\n   *\n   * The transport will reconnect automatically on next `trigger()` call.\n   */\n  disconnect(): void;\n}\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Check if a transport is a SocketTransport with connection management.\n *\n * @example\n * ```typescript\n * if (isSocketTransport(transport)) {\n *   transport.connect(); // TypeScript knows this is available\n * }\n * ```\n */\nexport function isSocketTransport(transport: Transport): transport is SocketTransport {\n  return (\n    'connect' in transport &&\n    'disconnect' in transport &&\n    'connectionState' in transport &&\n    'onConnectionStateChange' in transport\n  );\n}\n","import { parseSSEStream } from '@/stream/reader';\nimport type { Transport } from './types';\n\n/**\n * Options for creating an HTTP transport.\n */\nexport interface HttpTransportOptions {\n  /**\n   * Function to make the trigger request.\n   * Called each time `send()` is invoked on the chat.\n   *\n   * @param triggerName - The trigger name (e.g., 'user-message')\n   * @param input - Input parameters for the trigger\n   * @returns Response with SSE stream body\n   */\n  triggerRequest: (triggerName: string, input?: Record<string, unknown>) => Promise<Response>;\n}\n\n/**\n * Create an HTTP transport using native fetch() and SSE parsing.\n * This is the default transport for Next.js and other HTTP-based applications.\n *\n * @example\n * ```typescript\n * const transport = createHttpTransport({\n *   triggerRequest: (triggerName, input) =>\n *     fetch('/api/octavus', {\n *       method: 'POST',\n *       headers: { 'Content-Type': 'application/json' },\n *       body: JSON.stringify({ sessionId, triggerName, input }),\n *     }),\n * });\n * ```\n */\nexport function createHttpTransport(options: HttpTransportOptions): Transport {\n  let abortController: AbortController | null = null;\n\n  return {\n    async *trigger(triggerName, input) {\n      abortController = new AbortController();\n\n      const response = await options.triggerRequest(triggerName, input);\n\n      if (!response.ok) {\n        const errorText = await response.text().catch(() => `Request failed: ${response.status}`);\n        throw new Error(errorText);\n      }\n\n      if (!response.body) {\n        throw new Error('Response body is empty');\n      }\n\n      for await (const event of parseSSEStream(response)) {\n        if (abortController.signal.aborted) {\n          break;\n        }\n        yield event;\n      }\n    },\n\n    stop() {\n      abortController?.abort();\n      abortController = null;\n    },\n  };\n}\n","import { safeParseStreamEvent, type StreamEvent } from '@octavus/core';\nimport type { SocketTransport, ConnectionState, ConnectionStateListener } from './types';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Socket interface compatible with both WebSocket and SockJS.\n *\n * Uses MessageEvent for the message handler, which both WebSocket and SockJS support.\n * The `| undefined` union accommodates SockJS's optional property typing.\n */\nexport interface SocketLike {\n  send(data: string): void;\n  close(): void;\n  readyState: number;\n  onmessage: ((event: MessageEvent) => void) | null | undefined;\n  onclose: ((event: CloseEvent) => void) | null | undefined;\n}\n\n/** WebSocket readyState constants */\nconst SOCKET_OPEN = 1;\n\n// =============================================================================\n// Transport Options\n// =============================================================================\n\n/**\n * Options for creating a socket transport.\n */\nexport interface SocketTransportOptions {\n  /**\n   * Function to create and connect the socket.\n   * Works directly with WebSocket and SockJS - no wrappers needed.\n   *\n   * @example Native WebSocket\n   * ```typescript\n   * connect: () => new Promise((resolve, reject) => {\n   *   const ws = new WebSocket('wss://api.example.com/stream?sessionId=xxx');\n   *   ws.onopen = () => resolve(ws);\n   *   ws.onerror = () => reject(new Error('Connection failed'));\n   * })\n   * ```\n   *\n   * @example SockJS\n   * ```typescript\n   * connect: () => new Promise((resolve, reject) => {\n   *   const sock = new SockJS('/chat-service');\n   *   sock.onopen = () => resolve(sock);\n   *   sock.onerror = () => reject(new Error('Connection failed'));\n   * })\n   * ```\n   */\n  connect: () => Promise<SocketLike>;\n\n  /**\n   * Called for every message received (parsed as JSON).\n   * Use this to handle custom (non-Octavus) events.\n   * Octavus StreamEvents are handled automatically by the transport.\n   *\n   * @example\n   * ```typescript\n   * onMessage: (data) => {\n   *   const msg = data as { type: string };\n   *   if (msg.type === 'typing-indicator') {\n   *     setIsTyping(true);\n   *   }\n   *   if (msg.type === 'presence-update') {\n   *     updatePresence(msg.users);\n   *   }\n   * }\n   * ```\n   */\n  onMessage?: (data: unknown) => void;\n\n  /**\n   * Called when the socket connection closes.\n   * Use this for cleanup or reconnection logic.\n   */\n  onClose?: () => void;\n}\n\n/**\n * Create a socket transport that works with any WebSocket-like connection.\n * Supports native WebSocket, SockJS, or any compatible socket implementation.\n *\n * The server should send StreamEvent format (same as SSE) over the socket.\n * Unknown events are safely ignored using Zod validation.\n *\n * ## Connection Lifecycle\n *\n * By default, the socket connects **lazily** on the first `send()` call.\n * Use `connect()` to establish the connection eagerly (e.g., on component mount):\n *\n * ```typescript\n * // Eager connection for UI status indicators\n * useEffect(() => {\n *   transport.connect()\n *     .then(() => console.log('Connected'))\n *     .catch((err) => console.error('Failed:', err));\n *\n *   return () => transport.disconnect();\n * }, [transport]);\n * ```\n *\n * @example Basic usage with WebSocket\n * ```typescript\n * const transport = createSocketTransport({\n *   connect: () => new Promise((resolve, reject) => {\n *     const ws = new WebSocket(`wss://api.octavus.ai/stream?sessionId=${sessionId}`);\n *     ws.onopen = () => resolve(ws);\n *     ws.onerror = () => reject(new Error('Connection failed'));\n *   }),\n * });\n * ```\n *\n * @example With SockJS and connection state\n * ```typescript\n * const transport = createSocketTransport({\n *   connect: () => new Promise((resolve, reject) => {\n *     const sock = new SockJS('/octavus-stream');\n *     sock.onopen = () => resolve(sock);\n *     sock.onerror = () => reject(new Error('Connection failed'));\n *   }),\n * });\n *\n * // Subscribe to connection state changes\n * transport.onConnectionStateChange((state, error) => {\n *   setConnectionState(state);\n *   if (error) setConnectionError(error);\n * });\n * ```\n */\nexport function createSocketTransport(options: SocketTransportOptions): SocketTransport {\n  let socket: SocketLike | null = null;\n  let eventQueue: StreamEvent[] = [];\n  let eventResolver: ((event: StreamEvent | null) => void) | null = null;\n  let isStreaming = false;\n\n  let connectionState: ConnectionState = 'disconnected';\n  let connectionError: Error | undefined;\n  let connectionPromise: Promise<void> | null = null;\n  const connectionListeners = new Set<ConnectionStateListener>();\n\n  function setConnectionState(state: ConnectionState, error?: Error) {\n    connectionState = state;\n    connectionError = error;\n    connectionListeners.forEach((listener) => listener(state, error));\n  }\n\n  function enqueueEvent(event: StreamEvent) {\n    if (eventResolver) {\n      eventResolver(event);\n      eventResolver = null;\n    } else {\n      eventQueue.push(event);\n    }\n  }\n\n  function nextEvent(): Promise<StreamEvent | null> {\n    if (eventQueue.length > 0) {\n      return Promise.resolve(eventQueue.shift()!);\n    }\n    if (!isStreaming) {\n      return Promise.resolve(null);\n    }\n    return new Promise((resolve) => {\n      eventResolver = resolve;\n    });\n  }\n\n  function setupSocketHandlers(sock: SocketLike): void {\n    sock.onmessage = (e: MessageEvent) => {\n      try {\n        const data: unknown = typeof e.data === 'string' ? JSON.parse(e.data) : e.data;\n\n        options.onMessage?.(data);\n\n        const result = safeParseStreamEvent(data);\n        if (result.success) {\n          const event = result.data;\n          enqueueEvent(event);\n\n          if (event.type === 'finish' || event.type === 'error') {\n            isStreaming = false;\n          }\n        }\n      } catch {\n        // Malformed JSON, skip\n      }\n    };\n\n    sock.onclose = () => {\n      socket = null;\n      connectionPromise = null;\n      setConnectionState('disconnected');\n      options.onClose?.();\n\n      isStreaming = false;\n      if (eventResolver) {\n        eventResolver(null);\n        eventResolver = null;\n      }\n    };\n  }\n\n  async function ensureConnected(): Promise<void> {\n    // Already connected\n    if (socket?.readyState === SOCKET_OPEN) {\n      return;\n    }\n\n    // Connection in progress - wait for it\n    if (connectionPromise) {\n      await connectionPromise;\n      return;\n    }\n\n    // Start new connection\n    setConnectionState('connecting');\n\n    connectionPromise = (async () => {\n      try {\n        const sock = await options.connect();\n        socket = sock;\n        setupSocketHandlers(sock);\n        setConnectionState('connected');\n      } catch (err) {\n        socket = null;\n        connectionPromise = null;\n        const error = err instanceof Error ? err : new Error('Connection failed');\n        setConnectionState('error', error);\n        throw error;\n      }\n    })();\n\n    await connectionPromise;\n  }\n\n  return {\n    // =========================================================================\n    // Connection Management\n    // =========================================================================\n\n    get connectionState(): ConnectionState {\n      return connectionState;\n    },\n\n    onConnectionStateChange(listener: ConnectionStateListener): () => void {\n      connectionListeners.add(listener);\n      // Immediately notify with current state\n      listener(connectionState, connectionError);\n      return () => connectionListeners.delete(listener);\n    },\n\n    async connect(): Promise<void> {\n      await ensureConnected();\n    },\n\n    disconnect(): void {\n      if (socket) {\n        socket.close();\n        socket = null;\n      }\n      connectionPromise = null;\n      isStreaming = false;\n      if (eventResolver) {\n        eventResolver(null);\n        eventResolver = null;\n      }\n      setConnectionState('disconnected');\n    },\n\n    // =========================================================================\n    // Streaming\n    // =========================================================================\n\n    async *trigger(triggerName, input) {\n      await ensureConnected();\n\n      eventQueue = [];\n      isStreaming = true;\n\n      socket!.send(\n        JSON.stringify({\n          type: 'trigger',\n          triggerName,\n          input,\n        }),\n      );\n\n      while (true) {\n        const event = await nextEvent();\n        if (event === null) break;\n        yield event;\n        if (event.type === 'finish' || event.type === 'error') break;\n      }\n    },\n\n    stop() {\n      if (socket?.readyState === SOCKET_OPEN) {\n        socket.send(JSON.stringify({ type: 'stop' }));\n      }\n      isStreaming = false;\n      if (eventResolver) {\n        eventResolver(null);\n        eventResolver = null;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["safeParseStreamEvent"]}
+{"version":3,"sources":["../src/chat.ts","../src/files.ts","../src/stream/reader.ts","../src/index.ts","../src/transports/types.ts","../src/transports/http.ts","../src/transports/socket.ts"],"sourcesContent":["import {\n  generateId,\n  threadForPart,\n  isFileReferenceArray,\n  type UIMessage,\n  type UIMessagePart,\n  type UITextPart,\n  type UIReasoningPart,\n  type UIToolCallPart,\n  type UIOperationPart,\n  type UISourcePart,\n  type UIFilePart,\n  type UIObjectPart,\n  type DisplayMode,\n  type StreamEvent,\n  type FileReference,\n} from '@octavus/core';\nimport type { Transport } from './transports/types';\nimport { uploadFiles, type UploadFilesOptions } from './files';\n\n/** Block types that are internal operations (not LLM-driven) */\nconst OPERATION_BLOCK_TYPES = new Set(['set-resource', 'serialize-thread', 'generate-image']);\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport type ChatStatus = 'idle' | 'streaming' | 'error';\n\n/**\n * Input for creating a user message.\n * Supports text content and file attachments.\n */\nexport interface UserMessageInput {\n  /** Text content of the message */\n  content?: string;\n  /**\n   * File attachments (shorthand). Can be:\n   * - FileList: From file input element (will be uploaded via uploadFiles)\n   * - File[]: Array of File objects (will be uploaded via uploadFiles)\n   * - FileReference[]: Already uploaded files (used directly)\n   */\n  files?: FileList | File[] | FileReference[];\n}\n\nexport interface OctavusChatOptions {\n  /**\n   * Transport for streaming events.\n   * Use `createHttpTransport` for HTTP/SSE or `createSocketTransport` for WebSocket/SockJS.\n   */\n  transport: Transport;\n\n  /**\n   * Function to request upload URLs from the platform.\n   * Required if you want to use file uploads with FileList/File[].\n   *\n   * @example\n   * ```typescript\n   * requestUploadUrls: async (files) => {\n   *   const response = await fetch('/api/upload-urls', {\n   *     method: 'POST',\n   *     headers: { 'Content-Type': 'application/json' },\n   *     body: JSON.stringify({ sessionId, files }),\n   *   });\n   *   return response.json();\n   * }\n   * ```\n   */\n  requestUploadUrls?: UploadFilesOptions['requestUploadUrls'];\n\n  /** Initial messages (for session refresh) */\n  initialMessages?: UIMessage[];\n  /** Callback when an error occurs */\n  onError?: (error: Error) => void;\n  /** Callback when streaming finishes */\n  onFinish?: () => void;\n  /** Callback when a resource is updated */\n  onResourceUpdate?: (name: string, value: unknown) => void;\n}\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\ninterface BlockState {\n  blockId: string;\n  blockName: string;\n  blockType: string;\n  display: DisplayMode;\n  description?: string;\n  outputToChat: boolean;\n  thread?: string;\n  reasoning: string;\n  text: string;\n  toolCalls: Map<string, UIToolCallPart>;\n}\n\ninterface StreamingState {\n  messageId: string;\n  parts: UIMessagePart[];\n  activeBlock: BlockState | null;\n  blocks: Map<string, BlockState>;\n  currentTextPartIndex: number | null;\n  currentReasoningPartIndex: number | null;\n  currentObjectPartIndex: number | null;\n  accumulatedJson: string;\n}\n\ntype Listener = () => void;\n\n// =============================================================================\n// Helpers\n// =============================================================================\n\n/**\n * Create a user message from input with optional file attachments.\n * Files are added first (for vision models), then text content.\n */\nfunction createUserMessage(input: UserMessageInput, files?: FileReference[]): UIMessage {\n  const parts: UIMessagePart[] = [];\n\n  // Add file parts first (vision models expect images before text)\n  if (files && files.length > 0) {\n    for (const file of files) {\n      parts.push({\n        type: 'file',\n        id: file.id,\n        mediaType: file.mediaType,\n        url: file.url,\n        filename: file.filename,\n        size: file.size,\n      });\n    }\n  }\n\n  // Add text part after files\n  if (input.content) {\n    parts.push({ type: 'text', text: input.content, status: 'done' });\n  }\n\n  return {\n    id: generateId(),\n    role: 'user',\n    parts,\n    status: 'done',\n    createdAt: new Date(),\n  };\n}\n\n/**\n * Parse partial JSON by fixing incomplete structures (unclosed strings, brackets, braces).\n */\nfunction parsePartialJson(jsonText: string): unknown {\n  if (!jsonText.trim()) {\n    return undefined;\n  }\n\n  try {\n    return JSON.parse(jsonText) as unknown;\n  } catch {\n    // Continue to fix incomplete JSON\n  }\n\n  let fixed = jsonText;\n\n  // Count unclosed brackets/braces while tracking string boundaries\n  let openBraces = 0;\n  let openBrackets = 0;\n  let inString = false;\n  let escaped = false;\n\n  for (const char of fixed) {\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n\n    if (char === '\\\\') {\n      escaped = true;\n      continue;\n    }\n\n    if (char === '\"') {\n      inString = !inString;\n      continue;\n    }\n\n    if (!inString) {\n      if (char === '{') openBraces += 1;\n      else if (char === '}') openBraces -= 1;\n      else if (char === '[') openBrackets += 1;\n      else if (char === ']') openBrackets -= 1;\n    }\n  }\n\n  // Close unclosed structures\n  if (inString) {\n    fixed += '\"';\n  }\n  while (openBrackets > 0) {\n    fixed += ']';\n    openBrackets -= 1;\n  }\n  while (openBraces > 0) {\n    fixed += '}';\n    openBraces -= 1;\n  }\n\n  try {\n    return JSON.parse(fixed) as unknown;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction createEmptyStreamingState(): StreamingState {\n  return {\n    messageId: generateId(),\n    parts: [],\n    activeBlock: null,\n    blocks: new Map(),\n    currentTextPartIndex: null,\n    currentReasoningPartIndex: null,\n    currentObjectPartIndex: null,\n    accumulatedJson: '',\n  };\n}\n\nfunction buildMessageFromState(state: StreamingState, status: 'streaming' | 'done'): UIMessage {\n  return {\n    id: state.messageId,\n    role: 'assistant',\n    parts: [...state.parts],\n    status,\n    createdAt: new Date(),\n  };\n}\n\n// =============================================================================\n// OctavusChat Class\n// =============================================================================\n\n/**\n * Framework-agnostic chat client for Octavus agents.\n * Manages chat state and streaming, allowing reactive frameworks to subscribe to updates.\n *\n * @example HTTP transport (Next.js, etc.)\n * ```typescript\n * import { OctavusChat, createHttpTransport } from '@octavus/client-sdk';\n *\n * const chat = new OctavusChat({\n *   transport: createHttpTransport({\n *     triggerRequest: (triggerName, input) =>\n *       fetch('/api/trigger', {\n *         method: 'POST',\n *         body: JSON.stringify({ sessionId, triggerName, input }),\n *       }),\n *   }),\n * });\n * ```\n *\n * @example Socket transport (WebSocket, SockJS, Meteor)\n * ```typescript\n * import { OctavusChat, createSocketTransport } from '@octavus/client-sdk';\n *\n * const chat = new OctavusChat({\n *   transport: createSocketTransport({\n *     connect: () => new Promise((resolve, reject) => {\n *       const ws = new WebSocket(`wss://api.octavus.ai/stream?sessionId=${sessionId}`);\n *       ws.onopen = () => resolve(ws);\n *       ws.onerror = () => reject(new Error('Connection failed'));\n *     }),\n *   }),\n * });\n * ```\n */\nexport class OctavusChat {\n  // Private state\n  private _messages: UIMessage[];\n  private _status: ChatStatus = 'idle';\n  private _error: Error | null = null;\n  private options: OctavusChatOptions;\n  private transport: Transport;\n  private streamingState: StreamingState | null = null;\n\n  // Listener sets for reactive frameworks\n  private listeners = new Set<Listener>();\n\n  constructor(options: OctavusChatOptions) {\n    this.options = options;\n    this._messages = options.initialMessages ?? [];\n    this.transport = options.transport;\n  }\n\n  // =========================================================================\n  // Public Getters\n  // =========================================================================\n\n  get messages(): UIMessage[] {\n    return this._messages;\n  }\n\n  get status(): ChatStatus {\n    return this._status;\n  }\n\n  get error(): Error | null {\n    return this._error;\n  }\n\n  // =========================================================================\n  // Subscription Methods (for reactive frameworks)\n  // =========================================================================\n\n  /**\n   * Subscribe to state changes. The callback is called whenever messages, status, or error changes.\n   * @returns Unsubscribe function\n   */\n  subscribe(listener: Listener): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private notifyListeners(): void {\n    this.listeners.forEach((l) => l());\n  }\n\n  // =========================================================================\n  // Private Setters (notify listeners)\n  // =========================================================================\n\n  private setMessages(messages: UIMessage[]): void {\n    this._messages = messages;\n    this.notifyListeners();\n  }\n\n  private setStatus(status: ChatStatus): void {\n    this._status = status;\n    this.notifyListeners();\n  }\n\n  private setError(error: Error | null): void {\n    this._error = error;\n    this.notifyListeners();\n  }\n\n  // =========================================================================\n  // Public Methods\n  // =========================================================================\n\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   * @example Send a text message\n   * ```typescript\n   * await chat.send('user-message',\n   *   { USER_MESSAGE: message },\n   *   { userMessage: { content: message } }\n   * );\n   * ```\n   *\n   * @example Send a message with file attachments\n   * ```typescript\n   * await chat.send('user-message',\n   *   { USER_MESSAGE: message, FILES: fileRefs },\n   *   { userMessage: { content: message, files: fileRefs } }\n   * );\n   * ```\n   */\n  async send(\n    triggerName: string,\n    input?: Record<string, unknown>,\n    sendOptions?: { userMessage?: UserMessageInput },\n  ): Promise<void> {\n    this.transport.stop();\n\n    let fileRefs: FileReference[] | undefined;\n    if (sendOptions?.userMessage?.files) {\n      const files = sendOptions.userMessage.files;\n      if (isFileReferenceArray(files)) {\n        fileRefs = files;\n      } else if (this.options.requestUploadUrls) {\n        fileRefs = await uploadFiles(files, {\n          requestUploadUrls: this.options.requestUploadUrls,\n        });\n      } else {\n        throw new Error(\n          'File upload requires requestUploadUrls option. Either provide FileReference[] or configure requestUploadUrls.',\n        );\n      }\n    }\n\n    // Auto-upload FILES in trigger input if needed\n    let processedInput = input;\n    if (input?.FILES !== undefined && !isFileReferenceArray(input.FILES)) {\n      if (this.options.requestUploadUrls) {\n        const inputFiles = input.FILES as FileList | File[];\n        const uploadedRefs =\n          fileRefs ??\n          (await uploadFiles(inputFiles, {\n            requestUploadUrls: this.options.requestUploadUrls,\n          }));\n        processedInput = { ...input, FILES: uploadedRefs };\n        fileRefs = fileRefs ?? uploadedRefs;\n      }\n    }\n\n    // Optimistic UI: add user message before server responds\n    if (sendOptions?.userMessage !== undefined) {\n      const userMsg = createUserMessage(sendOptions.userMessage, fileRefs);\n      this.setMessages([...this._messages, userMsg]);\n    }\n\n    this.setStatus('streaming');\n    this.setError(null);\n    this.streamingState = createEmptyStreamingState();\n\n    try {\n      for await (const event of this.transport.trigger(triggerName, processedInput)) {\n        if (this.streamingState === null) break;\n\n        this.handleStreamEvent(event, this.streamingState);\n      }\n    } catch (err) {\n      const errorObj = err instanceof Error ? err : new Error('Unknown error');\n      this.setError(errorObj);\n      this.setStatus('error');\n      this.streamingState = null;\n      this.options.onError?.(errorObj);\n    }\n  }\n\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 chat.uploadFiles(fileInput.files, (i, progress) => {\n   *   console.log(`File ${i}: ${progress}%`);\n   * });\n   * // Later...\n   * await chat.send('user-message', { FILES: fileRefs }, { userMessage: { files: fileRefs } });\n   * ```\n   */\n  async uploadFiles(\n    files: FileList | File[],\n    onProgress?: (fileIndex: number, progress: number) => void,\n  ): Promise<FileReference[]> {\n    if (!this.options.requestUploadUrls) {\n      throw new Error('File upload requires requestUploadUrls option');\n    }\n    return await uploadFiles(files, {\n      requestUploadUrls: this.options.requestUploadUrls,\n      onProgress,\n    });\n  }\n\n  /** Stop the current streaming and finalize any partial message */\n  stop(): void {\n    this.transport.stop();\n\n    const state = this.streamingState;\n    if (state && state.parts.length > 0) {\n      const finalMessage = buildMessageFromState(state, 'done');\n      const messages = [...this._messages];\n      const lastMsg = messages[messages.length - 1];\n      if (lastMsg && lastMsg.id === state.messageId) {\n        messages[messages.length - 1] = finalMessage;\n      } else {\n        messages.push(finalMessage);\n      }\n      this.setMessages(messages);\n    }\n\n    this.streamingState = null;\n    this.setStatus('idle');\n  }\n\n  // =========================================================================\n  // Private Helpers\n  // =========================================================================\n\n  private handleStreamEvent(event: StreamEvent, state: StreamingState): void {\n    switch (event.type) {\n      case 'start':\n        break;\n\n      case 'block-start': {\n        const block: BlockState = {\n          blockId: event.blockId,\n          blockName: event.blockName,\n          blockType: event.blockType,\n          display: event.display,\n          description: event.description,\n          outputToChat: event.outputToChat ?? true,\n          thread: event.thread,\n          reasoning: '',\n          text: '',\n          toolCalls: new Map(),\n        };\n        state.blocks.set(event.blockId, block);\n        state.activeBlock = block;\n\n        const isOperation = OPERATION_BLOCK_TYPES.has(event.blockType);\n        const isHidden = event.display === 'hidden';\n        if (isOperation && !isHidden) {\n          const thread = event.thread;\n          const operationPart: UIOperationPart = {\n            type: 'operation',\n            operationId: event.blockId,\n            name: event.description ?? event.blockName,\n            operationType: event.blockType,\n            status: 'running',\n            thread: threadForPart(thread),\n          };\n          state.parts.push(operationPart);\n        }\n\n        state.currentTextPartIndex = null;\n        state.currentReasoningPartIndex = null;\n\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'block-end': {\n        const operationPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'operation' && p.operationId === event.blockId,\n        );\n        if (operationPartIndex >= 0) {\n          const part = state.parts[operationPartIndex] as UIOperationPart;\n          state.parts[operationPartIndex] = { ...part, status: 'done' };\n        }\n\n        if (state.activeBlock?.blockId === event.blockId) {\n          state.activeBlock = null;\n        }\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'reasoning-start': {\n        const reasoningPart: UIReasoningPart = {\n          type: 'reasoning',\n          text: '',\n          status: 'streaming',\n          thread: threadForPart(state.activeBlock?.thread),\n        };\n        state.parts.push(reasoningPart);\n        state.currentReasoningPartIndex = state.parts.length - 1;\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'reasoning-delta': {\n        if (state.currentReasoningPartIndex !== null) {\n          const part = state.parts[state.currentReasoningPartIndex] as UIReasoningPart;\n          part.text += event.delta;\n          state.parts[state.currentReasoningPartIndex] = { ...part };\n        }\n\n        if (state.activeBlock) {\n          state.activeBlock.reasoning += event.delta;\n        }\n\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'reasoning-end': {\n        if (state.currentReasoningPartIndex !== null) {\n          const part = state.parts[state.currentReasoningPartIndex] as UIReasoningPart;\n          part.status = 'done';\n          state.parts[state.currentReasoningPartIndex] = { ...part };\n          state.currentReasoningPartIndex = null;\n        }\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'text-start': {\n        const thread = threadForPart(state.activeBlock?.thread);\n        const shouldAddPart = state.activeBlock?.outputToChat !== false || thread !== undefined;\n\n        if (shouldAddPart) {\n          // Structured output mode: accumulate JSON and parse progressively\n          if (event.responseType) {\n            const objectPart: UIObjectPart = {\n              type: 'object',\n              id: event.id,\n              typeName: event.responseType,\n              partial: undefined,\n              object: undefined,\n              status: 'streaming',\n              thread,\n            };\n            state.parts.push(objectPart);\n            state.currentObjectPartIndex = state.parts.length - 1;\n            state.accumulatedJson = '';\n            state.currentTextPartIndex = null;\n          } else {\n            const textPart: UITextPart = {\n              type: 'text',\n              text: '',\n              status: 'streaming',\n              thread,\n            };\n            state.parts.push(textPart);\n            state.currentTextPartIndex = state.parts.length - 1;\n            state.currentObjectPartIndex = null;\n          }\n        }\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'text-delta': {\n        if (state.currentObjectPartIndex !== null) {\n          state.accumulatedJson += event.delta;\n          const part = state.parts[state.currentObjectPartIndex] as UIObjectPart;\n          const parsed = parsePartialJson(state.accumulatedJson);\n          if (parsed !== undefined) {\n            part.partial = parsed;\n            state.parts[state.currentObjectPartIndex] = { ...part };\n          }\n        } else if (state.currentTextPartIndex !== null) {\n          const part = state.parts[state.currentTextPartIndex] as UITextPart;\n          part.text += event.delta;\n          state.parts[state.currentTextPartIndex] = { ...part };\n        }\n\n        if (state.activeBlock) {\n          state.activeBlock.text += event.delta;\n        }\n\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'text-end': {\n        if (state.currentObjectPartIndex !== null) {\n          const part = state.parts[state.currentObjectPartIndex] as UIObjectPart;\n          try {\n            const finalObject = JSON.parse(state.accumulatedJson) as unknown;\n            part.object = finalObject;\n            part.partial = finalObject;\n            part.status = 'done';\n          } catch {\n            // Keep partial data but mark as error\n            part.status = 'error';\n            part.error = 'Failed to parse response as JSON';\n          }\n          state.parts[state.currentObjectPartIndex] = { ...part };\n          state.currentObjectPartIndex = null;\n          state.accumulatedJson = '';\n        } else if (state.currentTextPartIndex !== null) {\n          const part = state.parts[state.currentTextPartIndex] as UITextPart;\n          part.status = 'done';\n          state.parts[state.currentTextPartIndex] = { ...part };\n          state.currentTextPartIndex = null;\n        }\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'tool-input-start': {\n        const toolPart: UIToolCallPart = {\n          type: 'tool-call',\n          toolCallId: event.toolCallId,\n          toolName: event.toolName,\n          displayName: event.title,\n          args: {},\n          status: 'pending',\n          thread: threadForPart(state.activeBlock?.thread),\n        };\n        state.parts.push(toolPart);\n\n        if (state.activeBlock) {\n          state.activeBlock.toolCalls.set(event.toolCallId, toolPart);\n        }\n\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'tool-input-delta': {\n        const toolPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'tool-call' && p.toolCallId === event.toolCallId,\n        );\n        if (toolPartIndex >= 0) {\n          try {\n            const part = state.parts[toolPartIndex] as UIToolCallPart;\n            part.args = JSON.parse(event.inputTextDelta) as Record<string, unknown>;\n            state.parts[toolPartIndex] = { ...part };\n            this.updateStreamingMessage();\n          } catch {\n            // Partial JSON, ignore\n          }\n        }\n        break;\n      }\n\n      case 'tool-input-end':\n        // Input streaming ended, wait for tool-input-available\n        break;\n\n      case 'tool-input-available': {\n        const toolPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'tool-call' && p.toolCallId === event.toolCallId,\n        );\n        if (toolPartIndex >= 0) {\n          const part = state.parts[toolPartIndex] as UIToolCallPart;\n          part.args = event.input as Record<string, unknown>;\n          part.status = 'running';\n          state.parts[toolPartIndex] = { ...part };\n          this.updateStreamingMessage();\n        }\n        break;\n      }\n\n      case 'tool-output-available': {\n        const toolPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'tool-call' && p.toolCallId === event.toolCallId,\n        );\n        if (toolPartIndex >= 0) {\n          const part = state.parts[toolPartIndex] as UIToolCallPart;\n          part.result = event.output;\n          part.status = 'done';\n          state.parts[toolPartIndex] = { ...part };\n          this.updateStreamingMessage();\n        }\n        break;\n      }\n\n      case 'tool-output-error': {\n        const toolPartIndex = state.parts.findIndex(\n          (p: UIMessagePart) => p.type === 'tool-call' && p.toolCallId === event.toolCallId,\n        );\n        if (toolPartIndex >= 0) {\n          const part = state.parts[toolPartIndex] as UIToolCallPart;\n          part.error = event.errorText;\n          part.status = 'error';\n          state.parts[toolPartIndex] = { ...part };\n          this.updateStreamingMessage();\n        }\n        break;\n      }\n\n      case 'source': {\n        // Add source (URL or document) as a part - aligned with Vercel AI SDK\n        const thread = threadForPart(state.activeBlock?.thread);\n\n        let sourcePart: UISourcePart;\n        if (event.sourceType === 'url') {\n          sourcePart = {\n            type: 'source',\n            sourceType: 'url',\n            id: event.id,\n            url: event.url,\n            title: event.title,\n            thread,\n          };\n        } else {\n          sourcePart = {\n            type: 'source',\n            sourceType: 'document',\n            id: event.id,\n            mediaType: event.mediaType,\n            title: event.title,\n            filename: event.filename,\n            thread,\n          };\n        }\n\n        state.parts.push(sourcePart);\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'file-available': {\n        // Add generated file as a part (aligned with Vercel AI SDK FilePart)\n        const filePart: UIFilePart = {\n          type: 'file',\n          id: event.id,\n          mediaType: event.mediaType,\n          url: event.url,\n          filename: event.filename,\n          size: event.size,\n          toolCallId: event.toolCallId,\n          thread: threadForPart(state.activeBlock?.thread),\n        };\n        state.parts.push(filePart);\n        this.updateStreamingMessage();\n        break;\n      }\n\n      case 'resource-update':\n        this.options.onResourceUpdate?.(event.name, event.value);\n        break;\n\n      case 'finish': {\n        const finalMessage = buildMessageFromState(state, 'done');\n\n        finalMessage.parts = finalMessage.parts.map((part) => {\n          if (part.type === 'text' || part.type === 'reasoning') {\n            return { ...part, status: 'done' as const };\n          }\n          if (part.type === 'object' && part.status === 'streaming') {\n            return { ...part, status: 'done' as const };\n          }\n          return part;\n        });\n\n        if (finalMessage.parts.length > 0) {\n          const messages = [...this._messages];\n          const lastMsg = messages[messages.length - 1];\n          if (lastMsg && lastMsg.id === state.messageId) {\n            messages[messages.length - 1] = finalMessage;\n          } else {\n            messages.push(finalMessage);\n          }\n          this.setMessages(messages);\n        }\n\n        this.setStatus('idle');\n        this.streamingState = null;\n        this.options.onFinish?.();\n        break;\n      }\n\n      case 'error':\n        throw new Error(event.errorText);\n\n      case 'tool-request':\n        // Handled by server-sdk, not relevant for UI\n        break;\n    }\n  }\n\n  private updateStreamingMessage(): void {\n    const state = this.streamingState;\n    if (!state) return;\n\n    const msg = buildMessageFromState(state, 'streaming');\n    const messages = [...this._messages];\n\n    const lastMsg = messages[messages.length - 1];\n    if (lastMsg && lastMsg.id === state.messageId) {\n      messages[messages.length - 1] = msg;\n    } else {\n      messages.push(msg);\n    }\n\n    this.setMessages(messages);\n  }\n}\n","import type { FileReference } from '@octavus/core';\n\n/**\n * Response from the upload URLs endpoint\n */\nexport interface UploadUrlsResponse {\n  files: {\n    id: string;\n    uploadUrl: string;\n    downloadUrl: string;\n  }[];\n}\n\n/**\n * Options for uploading files\n */\nexport interface UploadFilesOptions {\n  /**\n   * Function to request upload URLs from the platform.\n   * Consumer apps must implement this to authenticate with the platform.\n   *\n   * @param files - Array of file metadata to request URLs for\n   * @returns Response with presigned upload and download URLs\n   *\n   * @example\n   * ```typescript\n   * requestUploadUrls: async (files) => {\n   *   const response = await fetch('/api/upload-urls', {\n   *     method: 'POST',\n   *     headers: { 'Content-Type': 'application/json' },\n   *     body: JSON.stringify({ sessionId, files }),\n   *   });\n   *   return response.json();\n   * }\n   * ```\n   */\n  requestUploadUrls: (\n    files: { filename: string; mediaType: string; size: number }[],\n  ) => Promise<UploadUrlsResponse>;\n\n  /**\n   * Callback for upload progress (0-100 per file).\n   * Called multiple times during upload with real-time progress.\n   *\n   * @param fileIndex - Index of the file being uploaded\n   * @param progress - Progress percentage (0-100)\n   */\n  onProgress?: (fileIndex: number, progress: number) => void;\n}\n\n/**\n * Upload a single file to S3 with progress tracking.\n * Uses XMLHttpRequest for upload progress events (fetch doesn't support this).\n */\nfunction uploadFileWithProgress(\n  url: string,\n  file: File,\n  onProgress?: (progress: number) => void,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const xhr = new XMLHttpRequest();\n\n    xhr.upload.addEventListener('progress', (event) => {\n      if (event.lengthComputable) {\n        const progress = Math.round((event.loaded / event.total) * 100);\n        onProgress?.(progress);\n      }\n    });\n\n    xhr.addEventListener('load', () => {\n      if (xhr.status >= 200 && xhr.status < 300) {\n        resolve();\n      } else {\n        reject(new Error(`Upload failed with status ${xhr.status}`));\n      }\n    });\n\n    xhr.addEventListener('error', () => {\n      reject(new Error('Upload failed: network error'));\n    });\n\n    xhr.addEventListener('abort', () => {\n      reject(new Error('Upload aborted'));\n    });\n\n    xhr.open('PUT', url);\n    xhr.setRequestHeader('Content-Type', file.type || 'application/octet-stream');\n    xhr.send(file);\n  });\n}\n\n/**\n * Upload files to the Octavus platform.\n *\n * This function:\n * 1. Requests presigned upload URLs from the platform\n * 2. Uploads each file directly to S3 with progress tracking\n * 3. Returns file references that can be used in trigger input\n *\n * @param files - Files to upload (from file input or drag/drop)\n * @param options - Upload configuration\n * @returns Array of file references with download URLs\n *\n * @example\n * ```typescript\n * const fileRefs = await uploadFiles(fileInputRef.current.files, {\n *   requestUploadUrls: async (files) => {\n *     const response = await fetch('/api/upload-urls', {\n *       method: 'POST',\n *       headers: { 'Content-Type': 'application/json' },\n *       body: JSON.stringify({ sessionId, files }),\n *     });\n *     return response.json();\n *   },\n *   onProgress: (fileIndex, progress) => {\n *     console.log(`File ${fileIndex}: ${progress}%`);\n *   },\n * });\n * ```\n */\nexport async function uploadFiles(\n  files: FileList | File[],\n  options: UploadFilesOptions,\n): Promise<FileReference[]> {\n  const fileArray = Array.from(files);\n\n  if (fileArray.length === 0) {\n    return [];\n  }\n\n  const { files: uploadInfos } = await options.requestUploadUrls(\n    fileArray.map((f) => ({\n      filename: f.name,\n      mediaType: f.type || 'application/octet-stream',\n      size: f.size,\n    })),\n  );\n\n  const references: FileReference[] = [];\n\n  for (let i = 0; i < fileArray.length; i++) {\n    const file = fileArray[i]!;\n    const uploadInfo = uploadInfos[i]!;\n\n    await uploadFileWithProgress(uploadInfo.uploadUrl, file, (progress) => {\n      options.onProgress?.(i, progress);\n    });\n\n    references.push({\n      id: uploadInfo.id,\n      mediaType: file.type || 'application/octet-stream',\n      url: uploadInfo.downloadUrl,\n      filename: file.name,\n      size: file.size,\n    });\n  }\n\n  return references;\n}\n","import { safeParseStreamEvent, type StreamEvent } from '@octavus/core';\n\n/**\n * Parse SSE stream events\n */\nexport async function* parseSSEStream(\n  response: Response,\n): AsyncGenerator<StreamEvent, void, unknown> {\n  const reader = response.body?.getReader();\n  if (!reader) {\n    throw new Error('Response body is not readable');\n  }\n\n  const decoder = new TextDecoder();\n  let buffer = '';\n\n  try {\n    let reading = true;\n    while (reading) {\n      const { done, value } = await reader.read();\n\n      if (done) {\n        reading = false;\n        continue;\n      }\n\n      buffer += decoder.decode(value, { stream: true });\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() ?? '';\n\n      for (const line of lines) {\n        if (line.startsWith('data: ') && line !== 'data: [DONE]') {\n          try {\n            const parsed = safeParseStreamEvent(JSON.parse(line.slice(6)));\n            if (parsed.success) {\n              yield parsed.data;\n            }\n            // Skip malformed events silently\n          } catch {\n            // Skip malformed JSON - no logging in production\n          }\n        }\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n","export {\n  OctavusChat,\n  type OctavusChatOptions,\n  type ChatStatus,\n  type UserMessageInput,\n} from './chat';\n\nexport { uploadFiles, type UploadFilesOptions, type UploadUrlsResponse } from './files';\n\nexport { parseSSEStream } from './stream/reader';\n\n// Re-export utility functions from core\nexport { isOtherThread, isFileReference, isFileReferenceArray } from '@octavus/core';\n\n// Transport exports\nexport {\n  createHttpTransport,\n  createSocketTransport,\n  isSocketTransport,\n  type Transport,\n  type SocketTransport,\n  type ConnectionState,\n  type ConnectionStateListener,\n  type HttpTransportOptions,\n  type SocketLike,\n  type SocketTransportOptions,\n} from './transports';\n\n// Re-export all types from core so consumers don't need to install @octavus/core separately\nexport type * from '@octavus/core';\n","import type { StreamEvent } from '@octavus/core';\n\n// =============================================================================\n// Base Transport Interface\n// =============================================================================\n\n/**\n * Transport interface for delivering events from server to client.\n *\n * Abstracts the connection mechanism (HTTP/SSE or WebSocket) behind a unified\n * async iterator interface. Use `createHttpTransport` or `createSocketTransport`\n * to create an implementation.\n */\nexport interface Transport {\n  /**\n   * Trigger the agent and stream events.\n   * @param triggerName - The trigger name defined in the agent's protocol\n   * @param input - Input parameters for variable substitution\n   */\n  trigger(triggerName: string, input?: Record<string, unknown>): AsyncIterable<StreamEvent>;\n\n  /** Stop the current stream. Safe to call when no stream is active. */\n  stop(): void;\n}\n\n// =============================================================================\n// Socket Transport (extends Transport with connection management)\n// =============================================================================\n\n/**\n * Connection states for socket transport.\n *\n * - `disconnected`: Not connected (initial state or after disconnect)\n * - `connecting`: Connection attempt in progress\n * - `connected`: Successfully connected and ready\n * - `error`: Connection failed (check error in listener callback)\n */\nexport type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'error';\n\n/**\n * Callback for connection state changes.\n */\nexport type ConnectionStateListener = (state: ConnectionState, error?: Error) => void;\n\n/**\n * Socket transport with connection management capabilities.\n *\n * Extends the base Transport interface with methods for managing persistent\n * WebSocket/SockJS connections. Use this when you need:\n * - Eager connection (connect before first message)\n * - Connection status UI indicators\n * - Manual connection lifecycle control\n *\n * Created via `createSocketTransport()`.\n */\nexport interface SocketTransport extends Transport {\n  /**\n   * Current connection state.\n   *\n   * - `disconnected`: Not connected (initial state)\n   * - `connecting`: Connection in progress\n   * - `connected`: Ready to send/receive\n   * - `error`: Connection failed\n   */\n  readonly connectionState: ConnectionState;\n\n  /**\n   * Subscribe to connection state changes.\n   *\n   * The listener is called immediately with the current state, then again\n   * whenever the state changes.\n   *\n   * @param listener - Callback invoked on state changes\n   * @returns Unsubscribe function\n   *\n   * @example\n   * ```typescript\n   * const unsubscribe = transport.onConnectionStateChange((state, error) => {\n   *   setConnectionState(state);\n   *   if (error) setConnectionError(error);\n   * });\n   * ```\n   */\n  onConnectionStateChange(listener: ConnectionStateListener): () => void;\n\n  /**\n   * Eagerly establish the connection.\n   *\n   * By default, socket transport connects lazily on first `trigger()`. Call\n   * this method to establish the connection early (e.g., on component mount):\n   * - Faster first message response\n   * - Show accurate connection status in UI\n   * - Handle connection errors before user interaction\n   *\n   * Safe to call multiple times - resolves immediately if already connected.\n   *\n   * @example\n   * ```tsx\n   * useEffect(() => {\n   *   transport.connect()\n   *     .then(() => console.log('Connected'))\n   *     .catch((err) => console.error('Failed:', err));\n   *\n   *   return () => transport.disconnect();\n   * }, [transport]);\n   * ```\n   */\n  connect(): Promise<void>;\n\n  /**\n   * Close the connection and clean up resources.\n   *\n   * The transport will reconnect automatically on next `trigger()` call.\n   */\n  disconnect(): void;\n}\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Check if a transport is a SocketTransport with connection management.\n *\n * @example\n * ```typescript\n * if (isSocketTransport(transport)) {\n *   transport.connect(); // TypeScript knows this is available\n * }\n * ```\n */\nexport function isSocketTransport(transport: Transport): transport is SocketTransport {\n  return (\n    'connect' in transport &&\n    'disconnect' in transport &&\n    'connectionState' in transport &&\n    'onConnectionStateChange' in transport\n  );\n}\n","import { parseSSEStream } from '@/stream/reader';\nimport type { Transport } from './types';\n\n/**\n * Options for creating an HTTP transport.\n */\nexport interface HttpTransportOptions {\n  /**\n   * Function to make the trigger request.\n   * Called each time `send()` is invoked on the chat.\n   *\n   * @param triggerName - The trigger name (e.g., 'user-message')\n   * @param input - Input parameters for the trigger\n   * @returns Response with SSE stream body\n   */\n  triggerRequest: (triggerName: string, input?: Record<string, unknown>) => Promise<Response>;\n}\n\n/**\n * Create an HTTP transport using native fetch() and SSE parsing.\n * This is the default transport for Next.js and other HTTP-based applications.\n *\n * @example\n * ```typescript\n * const transport = createHttpTransport({\n *   triggerRequest: (triggerName, input) =>\n *     fetch('/api/octavus', {\n *       method: 'POST',\n *       headers: { 'Content-Type': 'application/json' },\n *       body: JSON.stringify({ sessionId, triggerName, input }),\n *     }),\n * });\n * ```\n */\nexport function createHttpTransport(options: HttpTransportOptions): Transport {\n  let abortController: AbortController | null = null;\n\n  return {\n    async *trigger(triggerName, input) {\n      abortController = new AbortController();\n\n      const response = await options.triggerRequest(triggerName, input);\n\n      if (!response.ok) {\n        const errorText = await response.text().catch(() => `Request failed: ${response.status}`);\n        throw new Error(errorText);\n      }\n\n      if (!response.body) {\n        throw new Error('Response body is empty');\n      }\n\n      for await (const event of parseSSEStream(response)) {\n        if (abortController.signal.aborted) {\n          break;\n        }\n        yield event;\n      }\n    },\n\n    stop() {\n      abortController?.abort();\n      abortController = null;\n    },\n  };\n}\n","import { safeParseStreamEvent, type StreamEvent } from '@octavus/core';\nimport type { SocketTransport, ConnectionState, ConnectionStateListener } from './types';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Socket interface compatible with both WebSocket and SockJS.\n *\n * Uses MessageEvent for the message handler, which both WebSocket and SockJS support.\n * The `| undefined` union accommodates SockJS's optional property typing.\n */\nexport interface SocketLike {\n  send(data: string): void;\n  close(): void;\n  readyState: number;\n  onmessage: ((event: MessageEvent) => void) | null | undefined;\n  onclose: ((event: CloseEvent) => void) | null | undefined;\n}\n\n/** WebSocket readyState constants */\nconst SOCKET_OPEN = 1;\n\n// =============================================================================\n// Transport Options\n// =============================================================================\n\n/**\n * Options for creating a socket transport.\n */\nexport interface SocketTransportOptions {\n  /**\n   * Function to create and connect the socket.\n   * Works directly with WebSocket and SockJS - no wrappers needed.\n   *\n   * @example Native WebSocket\n   * ```typescript\n   * connect: () => new Promise((resolve, reject) => {\n   *   const ws = new WebSocket('wss://api.example.com/stream?sessionId=xxx');\n   *   ws.onopen = () => resolve(ws);\n   *   ws.onerror = () => reject(new Error('Connection failed'));\n   * })\n   * ```\n   *\n   * @example SockJS\n   * ```typescript\n   * connect: () => new Promise((resolve, reject) => {\n   *   const sock = new SockJS('/chat-service');\n   *   sock.onopen = () => resolve(sock);\n   *   sock.onerror = () => reject(new Error('Connection failed'));\n   * })\n   * ```\n   */\n  connect: () => Promise<SocketLike>;\n\n  /**\n   * Called for every message received (parsed as JSON).\n   * Use this to handle custom (non-Octavus) events.\n   * Octavus StreamEvents are handled automatically by the transport.\n   *\n   * @example\n   * ```typescript\n   * onMessage: (data) => {\n   *   const msg = data as { type: string };\n   *   if (msg.type === 'typing-indicator') {\n   *     setIsTyping(true);\n   *   }\n   *   if (msg.type === 'presence-update') {\n   *     updatePresence(msg.users);\n   *   }\n   * }\n   * ```\n   */\n  onMessage?: (data: unknown) => void;\n\n  /**\n   * Called when the socket connection closes.\n   * Use this for cleanup or reconnection logic.\n   */\n  onClose?: () => void;\n}\n\n/**\n * Create a socket transport that works with any WebSocket-like connection.\n * Supports native WebSocket, SockJS, or any compatible socket implementation.\n *\n * The server should send StreamEvent format (same as SSE) over the socket.\n * Unknown events are safely ignored using Zod validation.\n *\n * ## Connection Lifecycle\n *\n * By default, the socket connects **lazily** on the first `send()` call.\n * Use `connect()` to establish the connection eagerly (e.g., on component mount):\n *\n * ```typescript\n * // Eager connection for UI status indicators\n * useEffect(() => {\n *   transport.connect()\n *     .then(() => console.log('Connected'))\n *     .catch((err) => console.error('Failed:', err));\n *\n *   return () => transport.disconnect();\n * }, [transport]);\n * ```\n *\n * @example Basic usage with WebSocket\n * ```typescript\n * const transport = createSocketTransport({\n *   connect: () => new Promise((resolve, reject) => {\n *     const ws = new WebSocket(`wss://api.octavus.ai/stream?sessionId=${sessionId}`);\n *     ws.onopen = () => resolve(ws);\n *     ws.onerror = () => reject(new Error('Connection failed'));\n *   }),\n * });\n * ```\n *\n * @example With SockJS and connection state\n * ```typescript\n * const transport = createSocketTransport({\n *   connect: () => new Promise((resolve, reject) => {\n *     const sock = new SockJS('/octavus-stream');\n *     sock.onopen = () => resolve(sock);\n *     sock.onerror = () => reject(new Error('Connection failed'));\n *   }),\n * });\n *\n * // Subscribe to connection state changes\n * transport.onConnectionStateChange((state, error) => {\n *   setConnectionState(state);\n *   if (error) setConnectionError(error);\n * });\n * ```\n */\nexport function createSocketTransport(options: SocketTransportOptions): SocketTransport {\n  let socket: SocketLike | null = null;\n  let eventQueue: StreamEvent[] = [];\n  let eventResolver: ((event: StreamEvent | null) => void) | null = null;\n  let isStreaming = false;\n\n  let connectionState: ConnectionState = 'disconnected';\n  let connectionError: Error | undefined;\n  let connectionPromise: Promise<void> | null = null;\n  const connectionListeners = new Set<ConnectionStateListener>();\n\n  function setConnectionState(state: ConnectionState, error?: Error) {\n    connectionState = state;\n    connectionError = error;\n    connectionListeners.forEach((listener) => listener(state, error));\n  }\n\n  function enqueueEvent(event: StreamEvent) {\n    if (eventResolver) {\n      eventResolver(event);\n      eventResolver = null;\n    } else {\n      eventQueue.push(event);\n    }\n  }\n\n  function nextEvent(): Promise<StreamEvent | null> {\n    if (eventQueue.length > 0) {\n      return Promise.resolve(eventQueue.shift()!);\n    }\n    if (!isStreaming) {\n      return Promise.resolve(null);\n    }\n    return new Promise((resolve) => {\n      eventResolver = resolve;\n    });\n  }\n\n  function setupSocketHandlers(sock: SocketLike): void {\n    sock.onmessage = (e: MessageEvent) => {\n      try {\n        const data: unknown = typeof e.data === 'string' ? JSON.parse(e.data) : e.data;\n\n        options.onMessage?.(data);\n\n        const result = safeParseStreamEvent(data);\n        if (result.success) {\n          const event = result.data;\n          enqueueEvent(event);\n\n          if (event.type === 'finish' || event.type === 'error') {\n            isStreaming = false;\n          }\n        }\n      } catch {\n        // Malformed JSON, skip\n      }\n    };\n\n    sock.onclose = () => {\n      socket = null;\n      connectionPromise = null;\n      setConnectionState('disconnected');\n      options.onClose?.();\n\n      isStreaming = false;\n      if (eventResolver) {\n        eventResolver(null);\n        eventResolver = null;\n      }\n    };\n  }\n\n  async function ensureConnected(): Promise<void> {\n    // Already connected\n    if (socket?.readyState === SOCKET_OPEN) {\n      return;\n    }\n\n    // Connection in progress - wait for it\n    if (connectionPromise) {\n      await connectionPromise;\n      return;\n    }\n\n    // Start new connection\n    setConnectionState('connecting');\n\n    connectionPromise = (async () => {\n      try {\n        const sock = await options.connect();\n        socket = sock;\n        setupSocketHandlers(sock);\n        setConnectionState('connected');\n      } catch (err) {\n        socket = null;\n        connectionPromise = null;\n        const error = err instanceof Error ? err : new Error('Connection failed');\n        setConnectionState('error', error);\n        throw error;\n      }\n    })();\n\n    await connectionPromise;\n  }\n\n  return {\n    // =========================================================================\n    // Connection Management\n    // =========================================================================\n\n    get connectionState(): ConnectionState {\n      return connectionState;\n    },\n\n    onConnectionStateChange(listener: ConnectionStateListener): () => void {\n      connectionListeners.add(listener);\n      // Immediately notify with current state\n      listener(connectionState, connectionError);\n      return () => connectionListeners.delete(listener);\n    },\n\n    async connect(): Promise<void> {\n      await ensureConnected();\n    },\n\n    disconnect(): void {\n      if (socket) {\n        socket.close();\n        socket = null;\n      }\n      connectionPromise = null;\n      isStreaming = false;\n      if (eventResolver) {\n        eventResolver(null);\n        eventResolver = null;\n      }\n      setConnectionState('disconnected');\n    },\n\n    // =========================================================================\n    // Streaming\n    // =========================================================================\n\n    async *trigger(triggerName, input) {\n      await ensureConnected();\n\n      eventQueue = [];\n      isStreaming = true;\n\n      socket!.send(\n        JSON.stringify({\n          type: 'trigger',\n          triggerName,\n          input,\n        }),\n      );\n\n      while (true) {\n        const event = await nextEvent();\n        if (event === null) break;\n        yield event;\n        if (event.type === 'finish' || event.type === 'error') break;\n      }\n    },\n\n    stop() {\n      if (socket?.readyState === SOCKET_OPEN) {\n        socket.send(JSON.stringify({ type: 'stop' }));\n      }\n      isStreaming = false;\n      if (eventResolver) {\n        eventResolver(null);\n        eventResolver = null;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["isFileReferenceArray","safeParseStreamEvent"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octavus/client-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Framework-agnostic client SDK for Octavus agents",
   "license": "MIT",
   "author": "Octavus AI <dev@octavus.ai>",
@@ -28,7 +28,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@octavus/core": "^0.1.0"
+    "@octavus/core": "^0.1.1"
   },
   "devDependencies": {
     "tsup": "^8.3.5",