seacloud-sdk 0.11.10 → 0.12.1

package/dist/index.d.ts

@@ -12167,6 +12167,13 @@ interface LlmChatCompletionsParams {
      * A unique identifier representing your end-user
      */
     user?: string;
+    /**
+     * Request timeout in milliseconds
+     * Overrides the global timeout set in initSeacloud()
+     * @default 30000 (from global config)
+     * @example 60000 for 60 seconds timeout
+     */
+    timeout?: number;
 }
 /**
  * Usage statistics for the completion
@@ -12331,6 +12338,18 @@ interface ChatCompletionChunk {
  * console.log(response.choices[0].message.content);
  * ```
  *
+ * @example With custom timeout
+ * ```typescript
+ * // Set 60 seconds timeout for this specific call
+ * const response = await llmChatCompletions({
+ *   model: 'deepseek-v3.1',
+ *   messages: [
+ *     { role: 'user', content: 'Write a long article' }
+ *   ],
+ *   timeout: 60000  // 60 seconds
+ * });
+ * ```
+ *
  * @param params Request parameters
  * @returns Chat completion response
  */
@@ -12401,7 +12420,7 @@ declare function llmChatCompletions(params: LlmChatCompletionsParams & {
  *    - For tool calls (image/video generation), streaming is RECOMMENDED
  *
  * 4. AUTHENTICATION:
- *    - Requires 'X-Project' header (configured via initSeacloud({ xProject: 'SeaArt' }))
+ *    - Requires 'X-Project' header (configured via initSeacloud({ xProject: 'SeaVerse' }))
  *    - Uses Bearer token authentication
  *
  * 5. SESSION MANAGEMENT:
@@ -12650,6 +12669,14 @@ interface AgentChatCompletionsParams {
      * Top-p nucleus sampling (0-1)
      */
     top_p?: number;
+    /**
+     * Request timeout in milliseconds
+     * Overrides the global timeout set in initSeacloud()
+     * @default 30000 (from global config)
+     * @recommended 120000 or more for agent operations with tool calls
+     * @example 120000 for 120 seconds timeout
+     */
+    timeout?: number;
 }
 /**
  * Artifact (generated file)

package/dist/index.js

@@ -1598,10 +1598,17 @@ async function googleGeminiImage(params) {
     pollingOptions
   );
   const resources = [];
+  let firstTextResource = null;
   if (result.output) {
     for (const item of result.output) {
       if (item.content) {
         for (const resource of item.content) {
+          if (resource.type === "text") {
+            if (!firstTextResource) {
+              firstTextResource = resource;
+            }
+            continue;
+          }
           validateResourceUrl(resource, "image");
           resources.push({
             type: resource.type || "unknown",
@@ -1614,6 +1621,10 @@ async function googleGeminiImage(params) {
       }
     }
   }
+  if (resources.length === 0) {
+    const errorResource = firstTextResource || { type: "text", url: "" };
+    validateResourceUrl(errorResource, "image");
+  }
   return resources;
 }
 
@@ -5335,8 +5346,9 @@ async function llmChatCompletions(params) {
   const config = client.getConfig();
   const url = `${config.baseUrl}/llm/chat/completions`;
   const token = await getApiToken(config.apiKey);
+  const timeoutMs = params.timeout ?? config.timeout;
   const controller = new AbortController();
-  const timeoutId = setTimeout(() => controller.abort(), config.timeout);
+  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
   try {
     const response = await config.fetch(url, {
       method: "POST",
@@ -5367,7 +5379,7 @@ async function llmChatCompletions(params) {
       throw error;
     }
     if (error.name === "AbortError") {
-      throw new SeacloudError(`Request timeout after ${config.timeout}ms`);
+      throw new SeacloudError(`Request timeout after ${timeoutMs}ms`);
     }
     throw new SeacloudError(
       `Request failed: ${error.message}`,
@@ -5425,8 +5437,9 @@ async function agentChatCompletions(params) {
     stream: true
     // Always request SSE from API
   };
+  const timeoutMs = params.timeout ?? config.timeout;
   const controller = new AbortController();
-  const timeoutId = setTimeout(() => controller.abort(), config.timeout);
+  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
   try {
     const headers = {
       "Content-Type": "application/json",
@@ -5460,7 +5473,7 @@ async function agentChatCompletions(params) {
       throw error;
     }
     if (error.name === "AbortError") {
-      throw new SeacloudError(`Request timeout after ${config.timeout}ms`);
+      throw new SeacloudError(`Request timeout after ${timeoutMs}ms`);
     }
     throw new SeacloudError(
       `Request failed: ${error.message}`,