seacloud-sdk 0.5.0 → 0.5.1

package/dist/index.d.ts

@@ -11882,27 +11882,96 @@ declare function llmChatCompletions(params: LlmChatCompletionsParams & {
     stream: true;
 }): Promise<AsyncIterable<ChatCompletionChunk>>;
 
+/**
+ * ============================================================================
+ * SeaCloud Fast Agent Chat Completions API
+ * ============================================================================
+ *
+ * This module provides a comprehensive API for interacting with SeaCloud's
+ * Fast Agent system, which supports:
+ *
+ * - Multi-turn conversations with session management
+ * - Tool calling for artifact generation (images, videos, music, etc.)
+ * - Streaming and non-streaming response modes
+ * - Multiple content types (text, image, video, audio, file)
+ * - Flexible model selection (Claude, GPT, Gemini, etc.)
+ *
+ * IMPORTANT NOTES:
+ * ================
+ *
+ * 1. REQUIRED PARAMETERS:
+ *    - agent_id: Caller-provided agent identifier
+ *    - messages: Array of conversation messages
+ *
+ * 2. TIMEOUT CONFIGURATION:
+ *    - Default timeout: 30 seconds (may be too short for tool calls)
+ *    - Recommended for agent operations: 120 seconds or more
+ *    - Set via initSeacloud({ timeout: 120000 })
+ *
+ * 3. STREAMING MODE:
+ *    - API always returns Server-Sent Events (SSE) format
+ *    - params.stream controls how SDK consumes the response
+ *    - For tool calls (image/video generation), streaming is RECOMMENDED
+ *
+ * 4. AUTHENTICATION:
+ *    - Requires 'X-Project: SeaArt' header (automatically added)
+ *    - Uses Bearer token authentication
+ *
+ * 5. SESSION MANAGEMENT:
+ *    - Use session_id to maintain multi-turn conversations
+ *    - Increment seq for each message in the session
+ *
+ * @see AGENT_API.md for detailed documentation and examples
+ */
 /**
  * Message content type
  */
 type AgentMessageContentType = 'text' | 'image' | 'video' | 'audio' | 'file';
 /**
- * Message content item
+ * Base message content
  */
-interface AgentMessageContent {
-    /**
-     * Content type
-     */
+interface BaseMessageContent {
     type: AgentMessageContentType;
-    /**
-     * Text content (for type: 'text')
-     */
-    text?: string;
-    /**
-     * URL (for type: 'image' | 'video' | 'audio' | 'file')
-     */
-    url?: string;
 }
+/**
+ * Text message content
+ */
+interface TextMessageContent extends BaseMessageContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * Image message content
+ */
+interface ImageMessageContent extends BaseMessageContent {
+    type: 'image';
+    image_url: string;
+}
+/**
+ * Video message content
+ */
+interface VideoMessageContent extends BaseMessageContent {
+    type: 'video';
+    video_url: string;
+}
+/**
+ * Audio message content
+ */
+interface AudioMessageContent extends BaseMessageContent {
+    type: 'audio';
+    audio_url: string;
+}
+/**
+ * File message content
+ */
+interface FileMessageContent extends BaseMessageContent {
+    type: 'file';
+    file_url: string;
+}
+/**
+ * Message content item (union type for type safety)
+ */
+type AgentMessageContent = TextMessageContent | ImageMessageContent | VideoMessageContent | AudioMessageContent | FileMessageContent;
 /**
  * Message role type
  */
@@ -12025,14 +12094,26 @@ interface AgentChatCompletionsParams {
      */
     user_id?: string;
     /**
-     * Message ID for SSE reconnection
-     * Used when connection drops during streaming
-     * Allows resuming from where the connection was lost
+     * Message ID for SSE reconnection (ADVANCED USE)
+     * Only use this when resuming an interrupted streaming response
+     * Server returns msg_id in response; use it to resume from disconnect point
+     *
+     * WARNING: Do NOT use for multi-turn conversations
+     * For multi-turn, just include full message history + session_id
+     *
+     * @example
+     * // DON'T do this for multi-turn:
+     * // { msg_id: previousResponse.msg_id, seq: 1 }
+     *
+     * // DO this instead:
+     * // { session_id: previousResponse.session_id, messages: [...allMessages] }
      */
     msg_id?: string;
     /**
-     * Sequence number for message resumption
-     * Used with msg_id for resuming interrupted streams
+     * Sequence number for message resumption (ADVANCED USE)
+     * Only used with msg_id for resuming interrupted streams
+     * For regular multi-turn conversations, omit this parameter
+     *
      * @default 0
      */
     seq?: number;
@@ -12579,15 +12660,52 @@ declare function agentChatCompletions(params: AgentChatCompletionsParams & {
 }): Promise<AsyncIterable<AgentChatCompletionChunk>>;
 /**
  * Helper function to create a text message
+ *
+ * @param role - Message role ('user' | 'assistant' | 'developer' | 'tool')
+ * @param text - Text content
+ * @returns Agent message with text content
+ *
+ * @example
+ * ```typescript
+ * const message = createTextMessage('user', 'Hello!');
+ * ```
  */
 declare function createTextMessage(role: AgentMessageRole, text: string): AgentMessage;
 /**
  * Helper function to create a message with image
+ *
+ * @param role - Message role ('user' | 'assistant' | 'developer' | 'tool')
+ * @param text - Text content
+ * @param imageUrl - Image URL
+ * @returns Agent message with text and image content
+ *
+ * @example
+ * ```typescript
+ * const message = createImageMessage('user', 'What is this?', 'https://example.com/image.jpg');
+ * ```
  */
 declare function createImageMessage(role: AgentMessageRole, text: string, imageUrl: string): AgentMessage;
+/**
+ * Helper function to create a message with video
+ *
+ * @param role - Message role
+ * @param text - Text content
+ * @param videoUrl - Video URL
+ * @returns Agent message with text and video content
+ */
+declare function createVideoMessage(role: AgentMessageRole, text: string, videoUrl: string): AgentMessage;
+/**
+ * Helper function to create a message with audio
+ *
+ * @param role - Message role
+ * @param text - Text content
+ * @param audioUrl - Audio URL
+ * @returns Agent message with text and audio content
+ */
+declare function createAudioMessage(role: AgentMessageRole, text: string, audioUrl: string): AgentMessage;
 /**
  * Helper function to create a tool
  */
 declare function createTool(toolName: string): AgentTool;
 
-export { type AgentArtifact, type AgentChatCompletionChoice, type AgentChatCompletionChunk, type AgentChatCompletionChunkChoice, type AgentChatCompletionDelta, type AgentChatCompletionResponse, type AgentChatCompletionsParams, type AgentContentFilterResult, type AgentMessage, type AgentMessageContent, type AgentMessageContentType, type AgentMessageRole, type AgentResponseMessage, type AgentTool, type AgentToolCall, type AgentToolFunction, type AgentUsage, type AlibabaAnimateAnyoneDetectParams, type AlibabaAnimateAnyoneDetectResource, type AlibabaAnimateAnyoneTemplateParams, type AlibabaAnimateAnyoneTemplateResource, type AlibabaAnimateAnyoneVideoParams, type AlibabaAnimateAnyoneVideoResource, type AlibabaQianwenImageParams, type AlibabaQianwenImageResource, type AlibabaWan22T2iFlashParams, type AlibabaWan22T2iFlashResource, type AlibabaWan22T2iPlusParams, type AlibabaWan22T2iPlusResource, type AlibabaWan25I2iPreviewParams, type AlibabaWan25I2iPreviewResource, type AlibabaWan25T2iPreviewParams, type AlibabaWan25T2iPreviewResource, type AlibabaWanx20T2iTurboParams, type AlibabaWanx20T2iTurboResource, type AlibabaWanx21I2vPlusParams, type AlibabaWanx21I2vPlusResource, type AlibabaWanx21I2vTurboParams, type AlibabaWanx21I2vTurboResource, type AlibabaWanx21T2iPlusParams, type AlibabaWanx21T2iPlusResource, type AlibabaWanx21T2iTurboParams, type AlibabaWanx21T2iTurboResource, type AlibabaWanx21T2vPlusParams, type AlibabaWanx21T2vPlusResource, type AlibabaWanx21T2vTurboParams, type AlibabaWanx21T2vTurboResource, type AlibabaWanx22I2vFlashParams, type AlibabaWanx22I2vFlashResource, type AlibabaWanx22I2vPlusParams, type AlibabaWanx22I2vPlusResource, type AlibabaWanx22T2vPlusParams, type AlibabaWanx22T2vPlusResource, type AlibabaWanx25I2vPreviewParams, type AlibabaWanx25I2vPreviewResource, type AlibabaWanx25T2vPreviewParams, type AlibabaWanx25T2vPreviewResource, type AlibabaWanx26I2vParams, type AlibabaWanx26I2vResource, type AlibabaWanx26ReferenceParams, type AlibabaWanx26ReferenceResource, type AlibabaWanx26T2vParams, type AlibabaWanx26T2vResource, type BlackforestlabsFlux11ProParams, type BlackforestlabsFlux11ProResource, type BlackforestlabsFlux1ProParams, type BlackforestlabsFlux1ProResource, type BlackforestlabsFlux2FlexEditParams, type BlackforestlabsFlux2FlexEditResource, type BlackforestlabsFlux2FlexParams, type BlackforestlabsFlux2FlexResource, type BlackforestlabsFlux2ProEditParams, type BlackforestlabsFlux2ProEditResource, type BlackforestlabsFlux2ProParams, type BlackforestlabsFlux2ProResource, type BlackforestlabsFluxKontextMaxParams, type BlackforestlabsFluxKontextMaxResource, type BlackforestlabsFluxKontextProParams, type BlackforestlabsFluxKontextProResource, type ChatCompletionChoice, type ChatCompletionChunk, type ChatCompletionChunkChoice, type ChatCompletionChunkDelta, type ChatCompletionResponse, type ChatCompletionUsage, type ChatMessage, type ChatMessageRole, type ElevenlabsTtsGeneratorParams, type ElevenlabsTtsGeneratorResource, type GoogleGemini3ProImageParams, type GoogleGemini3ProImageResource, type GoogleGeminiImageParams, type GoogleGeminiImageResource, type GoogleImagen4FastGenerateParams, type GoogleImagen4FastGenerateResource, type GoogleImagen4GenerateParams, type GoogleImagen4GenerateResource, type GoogleImagen4UltraGenerateParams, type GoogleImagen4UltraGenerateResource, type GoogleVeo20Generate001Params, type GoogleVeo20Generate001Resource, type GoogleVeo20GenerateExpParams, type GoogleVeo20GenerateExpResource, type GoogleVeo20GeneratePreviewParams, type GoogleVeo20GeneratePreviewResource, type GoogleVeo30FastGenerate001Params, type GoogleVeo30FastGenerate001Resource, type GoogleVeo30Generate001Params, type GoogleVeo30Generate001Resource, type GoogleVeo31Params, type GoogleVeo31Resource, type KlingAvatarParams, type KlingAvatarResource, type KlingDurationExtensionParams, type KlingDurationExtensionResource, type KlingEffectsMultiV15Params, type KlingEffectsMultiV15Resource, type KlingEffectsMultiV16Params, type KlingEffectsMultiV16Resource, type KlingEffectsMultiV1Params, type KlingEffectsMultiV1Resource, type KlingEffectsSingleParams, type KlingEffectsSingleResource, type KlingLipsyncParams, type KlingLipsyncResource, type KlingOmniImageParams, type KlingOmniImageResource, type KlingOmniVideoParams, type KlingOmniVideoResource, type KlingV15I2vParams, type KlingV15I2vResource, type KlingV15Params, type KlingV15Resource, type KlingV16I2vParams, type KlingV16I2vResource, type KlingV16Params, type KlingV16Resource, type KlingV1I2vParams, type KlingV1I2vResource, type KlingV1Params, type KlingV1Resource, type KlingV21I2vParams, type KlingV21I2vResource, type KlingV21MasterI2vParams, type KlingV21MasterI2vResource, type KlingV21MasterParams, type KlingV21MasterResource, type KlingV25TurboI2vParams, type KlingV25TurboI2vResource, type KlingV25TurboParams, type KlingV25TurboResource, type KlingV26I2vParams, type KlingV26I2vResource, type KlingV26Params, type KlingV26Resource, type KlingV2MasterI2vParams, type KlingV2MasterI2vResource, type KlingV2MasterParams, type KlingV2MasterResource, type LlmChatCompletionsParams, type MicrosoftGptImage15Params, type MicrosoftGptImage15Resource, type MicrosoftGptImage1Params, type MicrosoftGptImage1Resource, type MicrosoftSora2Params, type MicrosoftSora2Resource, type MinimaxHailuo02I2vParams, type MinimaxHailuo02I2vResource, type MinimaxHailuo02Params, type MinimaxHailuo02Resource, type MinimaxHailuo23FastI2vParams, type MinimaxHailuo23FastI2vResource, type MinimaxHailuo23I2vParams, type MinimaxHailuo23I2vResource, type MinimaxI2v01DirectorParams, type MinimaxI2v01DirectorResource, type MinimaxI2v01LiveParams, type MinimaxI2v01LiveResource, type MinimaxI2v01Params, type MinimaxI2v01Resource, type MinimaxT2aParams, type MinimaxT2aResource, type MinimaxT2v01DirectorParams, type MinimaxT2v01DirectorResource, type MinimaxT2v01Params, type MinimaxT2v01Resource, type PixverseV35I2vParams, type PixverseV35I2vResource, type PixverseV35T2vParams, type PixverseV35T2vResource, type PixverseV35TransitionParams, type PixverseV35TransitionResource, type PixverseV45I2vParams, type PixverseV45I2vResource, type PixverseV45T2vParams, type PixverseV45T2vResource, type PixverseV45TransitionParams, type PixverseV45TransitionResource, type PixverseV4I2vParams, type PixverseV4I2vResource, type PixverseV4T2vParams, type PixverseV4T2vResource, type PixverseV4TransitionParams, type PixverseV4TransitionResource, type PixverseV55I2vParams, type PixverseV55I2vResource, type PixverseV55T2vParams, type PixverseV55T2vResource, type PixverseV55TransitionParams, type PixverseV55TransitionResource, type PixverseV5I2vParams, type PixverseV5I2vResource, type PixverseV5T2vParams, type PixverseV5T2vResource, type PixverseV5TransitionParams, type PixverseV5TransitionResource, type PollingOptions, type RunwayGen3aTurboI2vParams, type RunwayGen3aTurboI2vResource, SeacloudClient, type SeacloudConfig, SeacloudError, type TaskError, type TaskResult, type TaskStatus, type TencentHunyuan3dParams, type TencentHunyuan3dProParams, type TencentHunyuan3dProResource, type TencentHunyuan3dRapidParams, type TencentHunyuan3dRapidResource, type TencentHunyuan3dResource, type TencentImageCreation3Params, type TencentImageCreation3Resource, type TencentMpsSuperResolutionParams, type TencentMpsSuperResolutionResource, type Vidu15I2vParams, type Vidu15I2vResource, type Vidu15Params, type Vidu15Resource, type Vidu20I2vParams, type Vidu20I2vResource, type ViduQ1I2vParams, type ViduQ1I2vResource, type ViduQ1Params, type ViduQ1Resource, type ViduQ2Params, type ViduQ2Resource, type ViduTemplateParams, type ViduTemplateResource, type ViduTemplateV2Params, type ViduTemplateV2Resource, type VolcesJimeng30Params, type VolcesJimeng30Resource, type VolcesJimeng31Params, type VolcesJimeng31Resource, type VolcesJimengDreamActorM1Params, type VolcesJimengDreamActorM1Resource, type VolcesJimengI2i30Params, type VolcesJimengI2i30Resource, type VolcesRealmanAvatarImitatorV2vParams, type VolcesRealmanAvatarImitatorV2vResource, type VolcesRealmanAvatarPictureOmniV15Params, type VolcesRealmanAvatarPictureOmniV15Resource, type VolcesRealmanAvatarPictureOmniV2Params, type VolcesRealmanAvatarPictureOmniV2Resource, type VolcesSeed3dParams, type VolcesSeed3dResource, type VolcesSeedance30I2vParams, type VolcesSeedance30I2vResource, type VolcesSeedance30Params, type VolcesSeedance30ProParams, type VolcesSeedance30ProResource, type VolcesSeedance30Resource, type VolcesSeedanceProFastParams, type VolcesSeedanceProFastResource, type VolcesSeededit20Params, type VolcesSeededit20Resource, type VolcesSeededit30I2iParams, type VolcesSeededit30I2iResource, type VolcesSeededit30Params, type VolcesSeededit30Resource, type VolcesSeededit3dStyleParams, type VolcesSeededit3dStyleResource, type VolcesSeededitMultiIpParams, type VolcesSeededitMultiIpResource, type VolcesSeededitMultiStyleParams, type VolcesSeededitMultiStyleResource, type VolcesSeededitPortraitParams, type VolcesSeededitPortraitResource, type VolcesSeededitSingleIpParams, type VolcesSeededitSingleIpResource, type VolcesSeedream30Params, type VolcesSeedream30Resource, type VolcesSeedream40Params, type VolcesSeedream40Resource, type VolcesSeedream45I2iParams, type VolcesSeedream45I2iResource, type VolcesSeedream45MultiBlendParams, type VolcesSeedream45MultiBlendResource, type VolcesSeedream45Params, type VolcesSeedream45Resource, type VolcesSubjectDetectionParams, type VolcesSubjectDetectionResource, type VolcesSubjectRecognitionParams, type VolcesSubjectRecognitionResource, agentChatCompletions, alibabaAnimateAnyoneDetect, alibabaAnimateAnyoneTemplate, alibabaAnimateAnyoneVideo, alibabaQianwenImage, alibabaWan22T2iFlash, alibabaWan22T2iPlus, alibabaWan25I2iPreview, alibabaWan25T2iPreview, alibabaWanx20T2iTurbo, alibabaWanx21I2vPlus, alibabaWanx21I2vTurbo, alibabaWanx21T2iPlus, alibabaWanx21T2iTurbo, alibabaWanx21T2vPlus, alibabaWanx21T2vTurbo, alibabaWanx22I2vFlash, alibabaWanx22I2vPlus, alibabaWanx22T2vPlus, alibabaWanx25I2vPreview, alibabaWanx25T2vPreview, alibabaWanx26I2v, alibabaWanx26Reference, alibabaWanx26T2v, blackforestlabsFlux11Pro, blackforestlabsFlux1Pro, blackforestlabsFlux2Flex, blackforestlabsFlux2FlexEdit, blackforestlabsFlux2Pro, blackforestlabsFlux2ProEdit, blackforestlabsFluxKontextMax, blackforestlabsFluxKontextPro, createAndWaitTask, createConfig, createImageMessage, createTextMessage, createTool, elevenlabsTtsGenerator, getClient, getDefaultPollingOptions, googleGemini3ProImage, googleGeminiImage, googleImagen4FastGenerate, googleImagen4Generate, googleImagen4UltraGenerate, googleVeo20Generate001, googleVeo20GenerateExp, googleVeo20GeneratePreview, googleVeo30FastGenerate001, googleVeo30Generate001, googleVeo31, initSeacloud, klingAvatar, klingDurationExtension, klingEffectsMultiV1, klingEffectsMultiV15, klingEffectsMultiV16, klingEffectsSingle, klingLipsync, klingOmniImage, klingOmniVideo, klingV1, klingV15, klingV15I2v, klingV16, klingV16I2v, klingV1I2v, klingV21I2v, klingV21Master, klingV21MasterI2v, klingV25Turbo, klingV25TurboI2v, klingV26, klingV26I2v, klingV2Master, klingV2MasterI2v, llmChatCompletions, microsoftGptImage1, microsoftGptImage15, microsoftSora2, minimaxHailuo02, minimaxHailuo02I2v, minimaxHailuo23FastI2v, minimaxHailuo23I2v, minimaxI2v01, minimaxI2v01Director, minimaxI2v01Live, minimaxT2a, minimaxT2v01, minimaxT2v01Director, pixverseV35I2v, pixverseV35T2v, pixverseV35Transition, pixverseV45I2v, pixverseV45T2v, pixverseV45Transition, pixverseV4I2v, pixverseV4T2v, pixverseV4Transition, pixverseV55I2v, pixverseV55T2v, pixverseV55Transition, pixverseV5I2v, pixverseV5T2v, pixverseV5Transition, pollTaskUntilComplete, resetConfig, runwayGen3aTurboI2v, setDefaultPollingOptions, tencentHunyuan3d, tencentHunyuan3dPro, tencentHunyuan3dRapid, tencentImageCreation3, tencentMpsSuperResolution, validateConfig, vidu15, vidu15I2v, vidu20I2v, viduQ1, viduQ1I2v, viduQ2, viduTemplate, viduTemplateV2, volcesJimeng30, volcesJimeng31, volcesJimengDreamActorM1, volcesJimengI2i30, volcesRealmanAvatarImitatorV2v, volcesRealmanAvatarPictureOmniV15, volcesRealmanAvatarPictureOmniV2, volcesSeed3d, volcesSeedance30, volcesSeedance30I2v, volcesSeedance30Pro, volcesSeedanceProFast, volcesSeededit20, volcesSeededit30, volcesSeededit30I2i, volcesSeededit3dStyle, volcesSeededitMultiIp, volcesSeededitMultiStyle, volcesSeededitPortrait, volcesSeededitSingleIp, volcesSeedream30, volcesSeedream40, volcesSeedream45, volcesSeedream45I2i, volcesSeedream45MultiBlend, volcesSubjectDetection, volcesSubjectRecognition };
+export { type AgentArtifact, type AgentChatCompletionChoice, type AgentChatCompletionChunk, type AgentChatCompletionChunkChoice, type AgentChatCompletionDelta, type AgentChatCompletionResponse, type AgentChatCompletionsParams, type AgentContentFilterResult, type AgentMessage, type AgentMessageContent, type AgentMessageContentType, type AgentMessageRole, type AgentResponseMessage, type AgentTool, type AgentToolCall, type AgentToolFunction, type AgentUsage, type AlibabaAnimateAnyoneDetectParams, type AlibabaAnimateAnyoneDetectResource, type AlibabaAnimateAnyoneTemplateParams, type AlibabaAnimateAnyoneTemplateResource, type AlibabaAnimateAnyoneVideoParams, type AlibabaAnimateAnyoneVideoResource, type AlibabaQianwenImageParams, type AlibabaQianwenImageResource, type AlibabaWan22T2iFlashParams, type AlibabaWan22T2iFlashResource, type AlibabaWan22T2iPlusParams, type AlibabaWan22T2iPlusResource, type AlibabaWan25I2iPreviewParams, type AlibabaWan25I2iPreviewResource, type AlibabaWan25T2iPreviewParams, type AlibabaWan25T2iPreviewResource, type AlibabaWanx20T2iTurboParams, type AlibabaWanx20T2iTurboResource, type AlibabaWanx21I2vPlusParams, type AlibabaWanx21I2vPlusResource, type AlibabaWanx21I2vTurboParams, type AlibabaWanx21I2vTurboResource, type AlibabaWanx21T2iPlusParams, type AlibabaWanx21T2iPlusResource, type AlibabaWanx21T2iTurboParams, type AlibabaWanx21T2iTurboResource, type AlibabaWanx21T2vPlusParams, type AlibabaWanx21T2vPlusResource, type AlibabaWanx21T2vTurboParams, type AlibabaWanx21T2vTurboResource, type AlibabaWanx22I2vFlashParams, type AlibabaWanx22I2vFlashResource, type AlibabaWanx22I2vPlusParams, type AlibabaWanx22I2vPlusResource, type AlibabaWanx22T2vPlusParams, type AlibabaWanx22T2vPlusResource, type AlibabaWanx25I2vPreviewParams, type AlibabaWanx25I2vPreviewResource, type AlibabaWanx25T2vPreviewParams, type AlibabaWanx25T2vPreviewResource, type AlibabaWanx26I2vParams, type AlibabaWanx26I2vResource, type AlibabaWanx26ReferenceParams, type AlibabaWanx26ReferenceResource, type AlibabaWanx26T2vParams, type AlibabaWanx26T2vResource, type BlackforestlabsFlux11ProParams, type BlackforestlabsFlux11ProResource, type BlackforestlabsFlux1ProParams, type BlackforestlabsFlux1ProResource, type BlackforestlabsFlux2FlexEditParams, type BlackforestlabsFlux2FlexEditResource, type BlackforestlabsFlux2FlexParams, type BlackforestlabsFlux2FlexResource, type BlackforestlabsFlux2ProEditParams, type BlackforestlabsFlux2ProEditResource, type BlackforestlabsFlux2ProParams, type BlackforestlabsFlux2ProResource, type BlackforestlabsFluxKontextMaxParams, type BlackforestlabsFluxKontextMaxResource, type BlackforestlabsFluxKontextProParams, type BlackforestlabsFluxKontextProResource, type ChatCompletionChoice, type ChatCompletionChunk, type ChatCompletionChunkChoice, type ChatCompletionChunkDelta, type ChatCompletionResponse, type ChatCompletionUsage, type ChatMessage, type ChatMessageRole, type ElevenlabsTtsGeneratorParams, type ElevenlabsTtsGeneratorResource, type GoogleGemini3ProImageParams, type GoogleGemini3ProImageResource, type GoogleGeminiImageParams, type GoogleGeminiImageResource, type GoogleImagen4FastGenerateParams, type GoogleImagen4FastGenerateResource, type GoogleImagen4GenerateParams, type GoogleImagen4GenerateResource, type GoogleImagen4UltraGenerateParams, type GoogleImagen4UltraGenerateResource, type GoogleVeo20Generate001Params, type GoogleVeo20Generate001Resource, type GoogleVeo20GenerateExpParams, type GoogleVeo20GenerateExpResource, type GoogleVeo20GeneratePreviewParams, type GoogleVeo20GeneratePreviewResource, type GoogleVeo30FastGenerate001Params, type GoogleVeo30FastGenerate001Resource, type GoogleVeo30Generate001Params, type GoogleVeo30Generate001Resource, type GoogleVeo31Params, type GoogleVeo31Resource, type KlingAvatarParams, type KlingAvatarResource, type KlingDurationExtensionParams, type KlingDurationExtensionResource, type KlingEffectsMultiV15Params, type KlingEffectsMultiV15Resource, type KlingEffectsMultiV16Params, type KlingEffectsMultiV16Resource, type KlingEffectsMultiV1Params, type KlingEffectsMultiV1Resource, type KlingEffectsSingleParams, type KlingEffectsSingleResource, type KlingLipsyncParams, type KlingLipsyncResource, type KlingOmniImageParams, type KlingOmniImageResource, type KlingOmniVideoParams, type KlingOmniVideoResource, type KlingV15I2vParams, type KlingV15I2vResource, type KlingV15Params, type KlingV15Resource, type KlingV16I2vParams, type KlingV16I2vResource, type KlingV16Params, type KlingV16Resource, type KlingV1I2vParams, type KlingV1I2vResource, type KlingV1Params, type KlingV1Resource, type KlingV21I2vParams, type KlingV21I2vResource, type KlingV21MasterI2vParams, type KlingV21MasterI2vResource, type KlingV21MasterParams, type KlingV21MasterResource, type KlingV25TurboI2vParams, type KlingV25TurboI2vResource, type KlingV25TurboParams, type KlingV25TurboResource, type KlingV26I2vParams, type KlingV26I2vResource, type KlingV26Params, type KlingV26Resource, type KlingV2MasterI2vParams, type KlingV2MasterI2vResource, type KlingV2MasterParams, type KlingV2MasterResource, type LlmChatCompletionsParams, type MicrosoftGptImage15Params, type MicrosoftGptImage15Resource, type MicrosoftGptImage1Params, type MicrosoftGptImage1Resource, type MicrosoftSora2Params, type MicrosoftSora2Resource, type MinimaxHailuo02I2vParams, type MinimaxHailuo02I2vResource, type MinimaxHailuo02Params, type MinimaxHailuo02Resource, type MinimaxHailuo23FastI2vParams, type MinimaxHailuo23FastI2vResource, type MinimaxHailuo23I2vParams, type MinimaxHailuo23I2vResource, type MinimaxI2v01DirectorParams, type MinimaxI2v01DirectorResource, type MinimaxI2v01LiveParams, type MinimaxI2v01LiveResource, type MinimaxI2v01Params, type MinimaxI2v01Resource, type MinimaxT2aParams, type MinimaxT2aResource, type MinimaxT2v01DirectorParams, type MinimaxT2v01DirectorResource, type MinimaxT2v01Params, type MinimaxT2v01Resource, type PixverseV35I2vParams, type PixverseV35I2vResource, type PixverseV35T2vParams, type PixverseV35T2vResource, type PixverseV35TransitionParams, type PixverseV35TransitionResource, type PixverseV45I2vParams, type PixverseV45I2vResource, type PixverseV45T2vParams, type PixverseV45T2vResource, type PixverseV45TransitionParams, type PixverseV45TransitionResource, type PixverseV4I2vParams, type PixverseV4I2vResource, type PixverseV4T2vParams, type PixverseV4T2vResource, type PixverseV4TransitionParams, type PixverseV4TransitionResource, type PixverseV55I2vParams, type PixverseV55I2vResource, type PixverseV55T2vParams, type PixverseV55T2vResource, type PixverseV55TransitionParams, type PixverseV55TransitionResource, type PixverseV5I2vParams, type PixverseV5I2vResource, type PixverseV5T2vParams, type PixverseV5T2vResource, type PixverseV5TransitionParams, type PixverseV5TransitionResource, type PollingOptions, type RunwayGen3aTurboI2vParams, type RunwayGen3aTurboI2vResource, SeacloudClient, type SeacloudConfig, SeacloudError, type TaskError, type TaskResult, type TaskStatus, type TencentHunyuan3dParams, type TencentHunyuan3dProParams, type TencentHunyuan3dProResource, type TencentHunyuan3dRapidParams, type TencentHunyuan3dRapidResource, type TencentHunyuan3dResource, type TencentImageCreation3Params, type TencentImageCreation3Resource, type TencentMpsSuperResolutionParams, type TencentMpsSuperResolutionResource, type Vidu15I2vParams, type Vidu15I2vResource, type Vidu15Params, type Vidu15Resource, type Vidu20I2vParams, type Vidu20I2vResource, type ViduQ1I2vParams, type ViduQ1I2vResource, type ViduQ1Params, type ViduQ1Resource, type ViduQ2Params, type ViduQ2Resource, type ViduTemplateParams, type ViduTemplateResource, type ViduTemplateV2Params, type ViduTemplateV2Resource, type VolcesJimeng30Params, type VolcesJimeng30Resource, type VolcesJimeng31Params, type VolcesJimeng31Resource, type VolcesJimengDreamActorM1Params, type VolcesJimengDreamActorM1Resource, type VolcesJimengI2i30Params, type VolcesJimengI2i30Resource, type VolcesRealmanAvatarImitatorV2vParams, type VolcesRealmanAvatarImitatorV2vResource, type VolcesRealmanAvatarPictureOmniV15Params, type VolcesRealmanAvatarPictureOmniV15Resource, type VolcesRealmanAvatarPictureOmniV2Params, type VolcesRealmanAvatarPictureOmniV2Resource, type VolcesSeed3dParams, type VolcesSeed3dResource, type VolcesSeedance30I2vParams, type VolcesSeedance30I2vResource, type VolcesSeedance30Params, type VolcesSeedance30ProParams, type VolcesSeedance30ProResource, type VolcesSeedance30Resource, type VolcesSeedanceProFastParams, type VolcesSeedanceProFastResource, type VolcesSeededit20Params, type VolcesSeededit20Resource, type VolcesSeededit30I2iParams, type VolcesSeededit30I2iResource, type VolcesSeededit30Params, type VolcesSeededit30Resource, type VolcesSeededit3dStyleParams, type VolcesSeededit3dStyleResource, type VolcesSeededitMultiIpParams, type VolcesSeededitMultiIpResource, type VolcesSeededitMultiStyleParams, type VolcesSeededitMultiStyleResource, type VolcesSeededitPortraitParams, type VolcesSeededitPortraitResource, type VolcesSeededitSingleIpParams, type VolcesSeededitSingleIpResource, type VolcesSeedream30Params, type VolcesSeedream30Resource, type VolcesSeedream40Params, type VolcesSeedream40Resource, type VolcesSeedream45I2iParams, type VolcesSeedream45I2iResource, type VolcesSeedream45MultiBlendParams, type VolcesSeedream45MultiBlendResource, type VolcesSeedream45Params, type VolcesSeedream45Resource, type VolcesSubjectDetectionParams, type VolcesSubjectDetectionResource, type VolcesSubjectRecognitionParams, type VolcesSubjectRecognitionResource, agentChatCompletions, alibabaAnimateAnyoneDetect, alibabaAnimateAnyoneTemplate, alibabaAnimateAnyoneVideo, alibabaQianwenImage, alibabaWan22T2iFlash, alibabaWan22T2iPlus, alibabaWan25I2iPreview, alibabaWan25T2iPreview, alibabaWanx20T2iTurbo, alibabaWanx21I2vPlus, alibabaWanx21I2vTurbo, alibabaWanx21T2iPlus, alibabaWanx21T2iTurbo, alibabaWanx21T2vPlus, alibabaWanx21T2vTurbo, alibabaWanx22I2vFlash, alibabaWanx22I2vPlus, alibabaWanx22T2vPlus, alibabaWanx25I2vPreview, alibabaWanx25T2vPreview, alibabaWanx26I2v, alibabaWanx26Reference, alibabaWanx26T2v, blackforestlabsFlux11Pro, blackforestlabsFlux1Pro, blackforestlabsFlux2Flex, blackforestlabsFlux2FlexEdit, blackforestlabsFlux2Pro, blackforestlabsFlux2ProEdit, blackforestlabsFluxKontextMax, blackforestlabsFluxKontextPro, createAndWaitTask, createAudioMessage, createConfig, createImageMessage, createTextMessage, createTool, createVideoMessage, elevenlabsTtsGenerator, getClient, getDefaultPollingOptions, googleGemini3ProImage, googleGeminiImage, googleImagen4FastGenerate, googleImagen4Generate, googleImagen4UltraGenerate, googleVeo20Generate001, googleVeo20GenerateExp, googleVeo20GeneratePreview, googleVeo30FastGenerate001, googleVeo30Generate001, googleVeo31, initSeacloud, klingAvatar, klingDurationExtension, klingEffectsMultiV1, klingEffectsMultiV15, klingEffectsMultiV16, klingEffectsSingle, klingLipsync, klingOmniImage, klingOmniVideo, klingV1, klingV15, klingV15I2v, klingV16, klingV16I2v, klingV1I2v, klingV21I2v, klingV21Master, klingV21MasterI2v, klingV25Turbo, klingV25TurboI2v, klingV26, klingV26I2v, klingV2Master, klingV2MasterI2v, llmChatCompletions, microsoftGptImage1, microsoftGptImage15, microsoftSora2, minimaxHailuo02, minimaxHailuo02I2v, minimaxHailuo23FastI2v, minimaxHailuo23I2v, minimaxI2v01, minimaxI2v01Director, minimaxI2v01Live, minimaxT2a, minimaxT2v01, minimaxT2v01Director, pixverseV35I2v, pixverseV35T2v, pixverseV35Transition, pixverseV45I2v, pixverseV45T2v, pixverseV45Transition, pixverseV4I2v, pixverseV4T2v, pixverseV4Transition, pixverseV55I2v, pixverseV55T2v, pixverseV55Transition, pixverseV5I2v, pixverseV5T2v, pixverseV5Transition, pollTaskUntilComplete, resetConfig, runwayGen3aTurboI2v, setDefaultPollingOptions, tencentHunyuan3d, tencentHunyuan3dPro, tencentHunyuan3dRapid, tencentImageCreation3, tencentMpsSuperResolution, validateConfig, vidu15, vidu15I2v, vidu20I2v, viduQ1, viduQ1I2v, viduQ2, viduTemplate, viduTemplateV2, volcesJimeng30, volcesJimeng31, volcesJimengDreamActorM1, volcesJimengI2i30, volcesRealmanAvatarImitatorV2v, volcesRealmanAvatarPictureOmniV15, volcesRealmanAvatarPictureOmniV2, volcesSeed3d, volcesSeedance30, volcesSeedance30I2v, volcesSeedance30Pro, volcesSeedanceProFast, volcesSeededit20, volcesSeededit30, volcesSeededit30I2i, volcesSeededit3dStyle, volcesSeededitMultiIp, volcesSeededitMultiStyle, volcesSeededitPortrait, volcesSeededitSingleIp, volcesSeedream30, volcesSeedream40, volcesSeedream45, volcesSeedream45I2i, volcesSeedream45MultiBlend, volcesSubjectDetection, volcesSubjectRecognition };

package/dist/index.js

@@ -5085,9 +5085,13 @@ async function agentChatCompletions(params) {
   const client = getClient();
   const config = client.getConfig();
   const url = `${config.baseUrl}/agent/api/v1/chat/completions`;
+  const model = params.model || "custom_openai/vertex-ai-claude-sonnet-4.5";
+  const userWantsStreaming = params.stream !== false;
   const requestBody = {
     ...params,
-    model: params.model || "custom_openai/vertex-ai-claude-sonnet-4.5"
+    model,
+    stream: true
+    // Always request SSE from API
   };
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), config.timeout);
@@ -5098,6 +5102,7 @@ async function agentChatCompletions(params) {
         "Content-Type": "application/json",
         "Authorization": `Bearer ${config.apiKey}`,
         "X-Project": "SeaArt"
+        // Required header for agent API
       },
       body: JSON.stringify(requestBody),
       signal: controller.signal
@@ -5111,7 +5116,7 @@ async function agentChatCompletions(params) {
         errorBody
       );
     }
-    if (params.stream) {
+    if (userWantsStreaming) {
       return parseAgentStreamingResponse(response);
     }
     return await parseAgentNonStreamingResponse(response);
@@ -5278,7 +5283,25 @@ function createImageMessage(role, text, imageUrl) {
     role,
     content: [
       { type: "text", text },
-      { type: "image", url: imageUrl }
+      { type: "image", image_url: imageUrl }
+    ]
+  };
+}
+function createVideoMessage(role, text, videoUrl) {
+  return {
+    role,
+    content: [
+      { type: "text", text },
+      { type: "video", video_url: videoUrl }
+    ]
+  };
+}
+function createAudioMessage(role, text, audioUrl) {
+  return {
+    role,
+    content: [
+      { type: "text", text },
+      { type: "audio", audio_url: audioUrl }
     ]
   };
 }
@@ -5291,6 +5314,6 @@ function createTool(toolName) {
   };
 }
 
-export { SeacloudClient, SeacloudError, agentChatCompletions, alibabaAnimateAnyoneDetect, alibabaAnimateAnyoneTemplate, alibabaAnimateAnyoneVideo, alibabaQianwenImage, alibabaWan22T2iFlash, alibabaWan22T2iPlus, alibabaWan25I2iPreview, alibabaWan25T2iPreview, alibabaWanx20T2iTurbo, alibabaWanx21I2vPlus, alibabaWanx21I2vTurbo, alibabaWanx21T2iPlus, alibabaWanx21T2iTurbo, alibabaWanx21T2vPlus, alibabaWanx21T2vTurbo, alibabaWanx22I2vFlash, alibabaWanx22I2vPlus, alibabaWanx22T2vPlus, alibabaWanx25I2vPreview, alibabaWanx25T2vPreview, alibabaWanx26I2v, alibabaWanx26Reference, alibabaWanx26T2v, blackforestlabsFlux11Pro, blackforestlabsFlux1Pro, blackforestlabsFlux2Flex, blackforestlabsFlux2FlexEdit, blackforestlabsFlux2Pro, blackforestlabsFlux2ProEdit, blackforestlabsFluxKontextMax, blackforestlabsFluxKontextPro, createAndWaitTask, createConfig, createImageMessage, createTextMessage, createTool, elevenlabsTtsGenerator, getClient, getDefaultPollingOptions, googleGemini3ProImage, googleGeminiImage, googleImagen4FastGenerate, googleImagen4Generate, googleImagen4UltraGenerate, googleVeo20Generate001, googleVeo20GenerateExp, googleVeo20GeneratePreview, googleVeo30FastGenerate001, googleVeo30Generate001, googleVeo31, initSeacloud, klingAvatar, klingDurationExtension, klingEffectsMultiV1, klingEffectsMultiV15, klingEffectsMultiV16, klingEffectsSingle, klingLipsync, klingOmniImage, klingOmniVideo, klingV1, klingV15, klingV15I2v, klingV16, klingV16I2v, klingV1I2v, klingV21I2v, klingV21Master, klingV21MasterI2v, klingV25Turbo, klingV25TurboI2v, klingV26, klingV26I2v, klingV2Master, klingV2MasterI2v, llmChatCompletions, microsoftGptImage1, microsoftGptImage15, microsoftSora2, minimaxHailuo02, minimaxHailuo02I2v, minimaxHailuo23FastI2v, minimaxHailuo23I2v, minimaxI2v01, minimaxI2v01Director, minimaxI2v01Live, minimaxT2a, minimaxT2v01, minimaxT2v01Director, pixverseV35I2v, pixverseV35T2v, pixverseV35Transition, pixverseV45I2v, pixverseV45T2v, pixverseV45Transition, pixverseV4I2v, pixverseV4T2v, pixverseV4Transition, pixverseV55I2v, pixverseV55T2v, pixverseV55Transition, pixverseV5I2v, pixverseV5T2v, pixverseV5Transition, pollTaskUntilComplete, resetConfig, runwayGen3aTurboI2v, setDefaultPollingOptions, tencentHunyuan3d, tencentHunyuan3dPro, tencentHunyuan3dRapid, tencentImageCreation3, tencentMpsSuperResolution, validateConfig, vidu15, vidu15I2v, vidu20I2v, viduQ1, viduQ1I2v, viduQ2, viduTemplate, viduTemplateV2, volcesJimeng30, volcesJimeng31, volcesJimengDreamActorM1, volcesJimengI2i30, volcesRealmanAvatarImitatorV2v, volcesRealmanAvatarPictureOmniV15, volcesRealmanAvatarPictureOmniV2, volcesSeed3d, volcesSeedance30, volcesSeedance30I2v, volcesSeedance30Pro, volcesSeedanceProFast, volcesSeededit20, volcesSeededit30, volcesSeededit30I2i, volcesSeededit3dStyle, volcesSeededitMultiIp, volcesSeededitMultiStyle, volcesSeededitPortrait, volcesSeededitSingleIp, volcesSeedream30, volcesSeedream40, volcesSeedream45, volcesSeedream45I2i, volcesSeedream45MultiBlend, volcesSubjectDetection, volcesSubjectRecognition };
+export { SeacloudClient, SeacloudError, agentChatCompletions, alibabaAnimateAnyoneDetect, alibabaAnimateAnyoneTemplate, alibabaAnimateAnyoneVideo, alibabaQianwenImage, alibabaWan22T2iFlash, alibabaWan22T2iPlus, alibabaWan25I2iPreview, alibabaWan25T2iPreview, alibabaWanx20T2iTurbo, alibabaWanx21I2vPlus, alibabaWanx21I2vTurbo, alibabaWanx21T2iPlus, alibabaWanx21T2iTurbo, alibabaWanx21T2vPlus, alibabaWanx21T2vTurbo, alibabaWanx22I2vFlash, alibabaWanx22I2vPlus, alibabaWanx22T2vPlus, alibabaWanx25I2vPreview, alibabaWanx25T2vPreview, alibabaWanx26I2v, alibabaWanx26Reference, alibabaWanx26T2v, blackforestlabsFlux11Pro, blackforestlabsFlux1Pro, blackforestlabsFlux2Flex, blackforestlabsFlux2FlexEdit, blackforestlabsFlux2Pro, blackforestlabsFlux2ProEdit, blackforestlabsFluxKontextMax, blackforestlabsFluxKontextPro, createAndWaitTask, createAudioMessage, createConfig, createImageMessage, createTextMessage, createTool, createVideoMessage, elevenlabsTtsGenerator, getClient, getDefaultPollingOptions, googleGemini3ProImage, googleGeminiImage, googleImagen4FastGenerate, googleImagen4Generate, googleImagen4UltraGenerate, googleVeo20Generate001, googleVeo20GenerateExp, googleVeo20GeneratePreview, googleVeo30FastGenerate001, googleVeo30Generate001, googleVeo31, initSeacloud, klingAvatar, klingDurationExtension, klingEffectsMultiV1, klingEffectsMultiV15, klingEffectsMultiV16, klingEffectsSingle, klingLipsync, klingOmniImage, klingOmniVideo, klingV1, klingV15, klingV15I2v, klingV16, klingV16I2v, klingV1I2v, klingV21I2v, klingV21Master, klingV21MasterI2v, klingV25Turbo, klingV25TurboI2v, klingV26, klingV26I2v, klingV2Master, klingV2MasterI2v, llmChatCompletions, microsoftGptImage1, microsoftGptImage15, microsoftSora2, minimaxHailuo02, minimaxHailuo02I2v, minimaxHailuo23FastI2v, minimaxHailuo23I2v, minimaxI2v01, minimaxI2v01Director, minimaxI2v01Live, minimaxT2a, minimaxT2v01, minimaxT2v01Director, pixverseV35I2v, pixverseV35T2v, pixverseV35Transition, pixverseV45I2v, pixverseV45T2v, pixverseV45Transition, pixverseV4I2v, pixverseV4T2v, pixverseV4Transition, pixverseV55I2v, pixverseV55T2v, pixverseV55Transition, pixverseV5I2v, pixverseV5T2v, pixverseV5Transition, pollTaskUntilComplete, resetConfig, runwayGen3aTurboI2v, setDefaultPollingOptions, tencentHunyuan3d, tencentHunyuan3dPro, tencentHunyuan3dRapid, tencentImageCreation3, tencentMpsSuperResolution, validateConfig, vidu15, vidu15I2v, vidu20I2v, viduQ1, viduQ1I2v, viduQ2, viduTemplate, viduTemplateV2, volcesJimeng30, volcesJimeng31, volcesJimengDreamActorM1, volcesJimengI2i30, volcesRealmanAvatarImitatorV2v, volcesRealmanAvatarPictureOmniV15, volcesRealmanAvatarPictureOmniV2, volcesSeed3d, volcesSeedance30, volcesSeedance30I2v, volcesSeedance30Pro, volcesSeedanceProFast, volcesSeededit20, volcesSeededit30, volcesSeededit30I2i, volcesSeededit3dStyle, volcesSeededitMultiIp, volcesSeededitMultiStyle, volcesSeededitPortrait, volcesSeededitSingleIp, volcesSeedream30, volcesSeedream40, volcesSeedream45, volcesSeedream45I2i, volcesSeedream45MultiBlend, volcesSubjectDetection, volcesSubjectRecognition };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map