@unityclaw/sdk 1.0.1 → 1.0.3

package/dist/index.js

@@ -1,6 +1,15 @@
+import {
+  CONFIG_DIR,
+  CONFIG_FILE,
+  DEFAULT_TASKS_DIR,
+  getConfigPath,
+  getConfigValue,
+  loadConfig,
+  saveConfig,
+  setConfigValue
+} from "./chunk-WG7OYNEX.js";
+
 // src/client.ts
-import path from "path";
-import os from "os";
 import axios2, { AxiosError } from "axios";
 
 // src/task-folder.ts
@@ -201,31 +210,31 @@ var ImageAPI = class {
    *   prompt: 'A beautiful sunset over mountains',
    *   size: { value: '2K', label: '2K' }
    * });
+   * console.log('Task folder:', result.taskFolder);
+   * console.log('Local path:', result.response.data?.[0]?.localPath);
    * ```
    */
   async gemini(params) {
-    const taskResult = await this.client.request("/api/gemini/image", {
+    return this.client.request("/api/gemini/image", {
       prompt: params.prompt,
       attachment: params.attachment,
       model: params.model,
       aspect_ratio: params.aspect_ratio,
       size: params.size
     });
-    return taskResult.response;
   }
   /**
    * Generate image using Gemini API v2
    * @see /api/gemini/image/v2
    */
   async geminiV2(params) {
-    const taskResult = await this.client.request("/api/gemini/image/v2", {
+    return this.client.request("/api/gemini/image/v2", {
       prompt: params.prompt,
       attachment: params.attachment,
       model: params.model,
       aspect_ratio: params.aspect_ratio,
       size: params.size
     });
-    return taskResult.response;
   }
   /**
    * Generate image using JiMeng (Doubao) API
@@ -237,10 +246,11 @@ var ImageAPI = class {
    *   prompt: '一只可爱的猫咪',
    *   size: { value: '1024x1024', label: '1:1' }
    * });
+   * console.log('Task folder:', result.taskFolder);
    * ```
    */
   async jimeng(params) {
-    const taskResult = await this.client.request("/api/jimeng/image", {
+    return this.client.request("/api/jimeng/image", {
       prompt: params.prompt,
       attachment: params.attachment,
       size: params.size,
@@ -249,14 +259,13 @@ var ImageAPI = class {
       image_count: params.image_count,
       model: params.model
     });
-    return taskResult.response;
   }
   /**
    * Generate image using JiMeng V3 API
    * @see /api/jimeng/image/v3
    */
   async jimengV3(params) {
-    const taskResult = await this.client.request("/api/jimeng/image/v3", {
+    return this.client.request("/api/jimeng/image/v3", {
       prompt: params.prompt,
       attachment: params.attachment,
       size: params.size,
@@ -265,18 +274,16 @@ var ImageAPI = class {
       image_count: params.image_count,
       model: params.model
     });
-    return taskResult.response;
   }
   /**
    * Compress image
    * @see /api/image/compress
    */
   async compress(params) {
-    const taskResult = await this.client.request("/api/image/compress", {
+    return this.client.request("/api/image/compress", {
       attachment: params.attachment,
       quality: params.quality
     });
-    return taskResult.response;
   }
 };
 
@@ -295,28 +302,27 @@ var VideoAPI = class {
    *   prompt: 'A cat playing piano',
    *   orientation: { value: 'landscape', label: 'Landscape' }
    * });
+   * console.log('Task folder:', result.taskFolder);
    * ```
    */
   async sora(params) {
-    const taskResult = await this.client.request("/api/sora/video", {
+    return this.client.request("/api/sora/video", {
       attachment: params.attachment,
       prompt: params.prompt,
       orientation: params.orientation
     });
-    return taskResult.response;
   }
   /**
    * Generate video using Sora Stable API
    * @see /api/sora/video/stable
    */
   async soraStable(params) {
-    const taskResult = await this.client.request("/api/sora/video/stable", {
+    return this.client.request("/api/sora/video/stable", {
       attachment: params.attachment,
       prompt: params.prompt,
       size: params.size,
       seconds: params.seconds
     });
-    return taskResult.response;
   }
   /**
    * Generate video using Veo API
@@ -332,7 +338,7 @@ var VideoAPI = class {
    * ```
    */
   async veo(params) {
-    const taskResult = await this.client.request("/api/veo/video", {
+    return this.client.request("/api/veo/video", {
       prompt: params.prompt,
       attachment: params.attachment,
       first_frame: params.first_frame,
@@ -341,7 +347,6 @@ var VideoAPI = class {
       resolution: params.resolution,
       duration: params.duration
     });
-    return taskResult.response;
   }
   /**
    * Generate video using Kling API
@@ -358,14 +363,13 @@ var VideoAPI = class {
    * ```
    */
   async kling(params) {
-    const taskResult = await this.client.request("/api/kling/video", {
+    return this.client.request("/api/kling/video", {
       attachment: params.attachment,
       prompt: params.prompt,
       aspect_ratio: params.aspect_ratio,
       duration: params.duration,
       model: params.model
     });
-    return taskResult.response;
   }
   /**
    * Generate video using JiMeng API
@@ -381,13 +385,12 @@ var VideoAPI = class {
    * ```
    */
   async jimeng(params) {
-    const taskResult = await this.client.request("/api/jimeng/video", {
+    return this.client.request("/api/jimeng/video", {
       action: params.action,
       attachment: params.attachment,
       prompt: params.prompt,
       aspect_ratio: params.aspect_ratio
     });
-    return taskResult.response;
   }
   /**
    * Generate video using Doubao API
@@ -403,7 +406,7 @@ var VideoAPI = class {
    * ```
    */
   async doubao(params) {
-    const taskResult = await this.client.request("/api/doubao/video", {
+    return this.client.request("/api/doubao/video", {
       action: params.action,
       attachment: params.attachment,
       prompt: params.prompt,
@@ -411,7 +414,6 @@ var VideoAPI = class {
       ratio: params.ratio,
       duration: params.duration
     });
-    return taskResult.response;
   }
   /**
    * Generate video using Wan API (Alibaba)
@@ -428,7 +430,7 @@ var VideoAPI = class {
    * ```
    */
   async wan(params) {
-    const taskResult = await this.client.request("/api/wan/video", {
+    return this.client.request("/api/wan/video", {
       attachment: params.attachment,
       prompt: params.prompt,
       size: params.size,
@@ -436,7 +438,6 @@ var VideoAPI = class {
       model: params.model,
       shot_type: params.shot_type
     });
-    return taskResult.response;
   }
   /**
    * Generate video using MiniMax API
@@ -452,14 +453,13 @@ var VideoAPI = class {
    * ```
    */
   async minimax(params) {
-    const taskResult = await this.client.request("/api/minimax/video", {
+    return this.client.request("/api/minimax/video", {
       attachment: params.attachment,
       prompt: params.prompt,
       size: params.size,
       duration: params.duration,
       model: params.model
     });
-    return taskResult.response;
   }
 };
 
@@ -479,119 +479,111 @@ var DocumentAPI = class {
    *   source_language: { value: 'en', label: 'English' },
    *   target_language: { value: 'zh', label: 'Chinese' }
    * });
+   * console.log('Task folder:', result.taskFolder);
    * ```
    */
   async translate(params) {
-    const taskResult = await this.client.request("/api/doc/translate", {
+    return this.client.request("/api/doc/translate", {
       attachment: params.attachment,
       source_language: params.source_language,
       target_language: params.target_language
     });
-    return taskResult.response;
   }
   /**
    * Convert image to Word document
    * @see /api/doc_convert/image2word
    */
   async image2Word(params) {
-    const taskResult = await this.client.request(
+    return this.client.request(
       "/api/doc_convert/image2word",
       {
         attachment: params.attachment
       }
     );
-    return taskResult.response;
   }
   /**
    * Convert image to PowerPoint
    * @see /api/doc_convert/image2ppt
    */
   async image2Ppt(params) {
-    const taskResult = await this.client.request(
+    return this.client.request(
       "/api/doc_convert/image2ppt",
       {
         attachment: params.attachment
       }
     );
-    return taskResult.response;
   }
   /**
    * Convert image to Excel
    * @see /api/doc_convert/image2excel
    */
   async image2Excel(params) {
-    const taskResult = await this.client.request(
+    return this.client.request(
       "/api/doc_convert/image2excel",
       {
         attachment: params.attachment
       }
     );
-    return taskResult.response;
   }
   /**
    * Convert image to PDF
    * @see /api/doc_convert/image2pdf
    */
   async image2Pdf(params) {
-    const taskResult = await this.client.request(
+    return this.client.request(
       "/api/doc_convert/image2pdf",
       {
         attachment: params.attachment
       }
     );
-    return taskResult.response;
   }
   /**
    * Convert PDF to Word document
    * @see /api/doc_convert/pdf2word
    */
   async pdf2Word(params) {
-    const taskResult = await this.client.request(
+    return this.client.request(
       "/api/doc_convert/pdf2word",
       {
         attachment: params.attachment
       }
     );
-    return taskResult.response;
   }
   /**
    * Convert PDF to PowerPoint
    * @see /api/doc_convert/pdf2ppt
    */
   async pdf2Ppt(params) {
-    const taskResult = await this.client.request(
+    return this.client.request(
       "/api/doc_convert/pdf2ppt",
       {
         attachment: params.attachment
       }
     );
-    return taskResult.response;
   }
   /**
    * Convert PDF to Excel
    * @see /api/doc_convert/pdf2excel
    */
   async pdf2Excel(params) {
-    const taskResult = await this.client.request(
+    return this.client.request(
       "/api/doc_convert/pdf2excel",
       {
         attachment: params.attachment
       }
     );
-    return taskResult.response;
   }
   /**
    * Convert PDF to image
    * @see /api/doc_convert/pdf2image
    */
   async pdf2Image(params) {
-    const taskResult = await this.client.request(
+    return this.client.request(
       "/api/doc_convert/pdf2image",
       {
         attachment: params.attachment
       }
     );
-    return taskResult.response;
   }
   /**
    * Generic document conversion
@@ -601,12 +593,11 @@ var DocumentAPI = class {
   async convert(params) {
     const isImage = params.input_format === "image" || !params.input_format;
     const endpoint = isImage ? "/api/doc_convert/image" : "/api/doc_convert/pdf";
-    const taskResult = await this.client.request(endpoint, {
+    return this.client.request(endpoint, {
       attachment: params.attachment,
       input_format: params.input_format,
       output_format: params.output_format
     });
-    return taskResult.response;
   }
 };
 
@@ -630,13 +621,15 @@ var MediaAPI = class {
    * const result = await client.media.analyze({
    *   url: [{ tmp_url: 'https://...', type: 'video/mp4', name: 'video.mp4' }]
    * });
+   *
+   * console.log('Task folder:', result.taskFolder);
+   * console.log('Summary:', result.response.data?.summary);
    * ```
    */
   async analyze(params) {
-    const taskResult = await this.client.request("/api/media_analysis", {
+    return this.client.request("/api/media_analysis", {
       url: params.url
     });
-    return taskResult.response;
   }
   /**
    * Analyze video file directly
@@ -651,7 +644,7 @@ var MediaAPI = class {
    * ```
    */
   async analyzeVideo(params) {
-    const taskResult = await this.client.request("/api/media_analysis", {
+    return this.client.request("/api/media_analysis", {
       url: [
         {
           tmp_url: params.file.tmp_url,
@@ -661,7 +654,6 @@ var MediaAPI = class {
         }
       ]
     });
-    return taskResult.response;
   }
   /**
    * Analyze social media video (TikTok, YouTube, etc.)
@@ -675,10 +667,9 @@ var MediaAPI = class {
    * ```
    */
   async analyzeSocialVideo(params) {
-    const taskResult = await this.client.request("/api/media_analysis", {
+    return this.client.request("/api/media_analysis", {
       url: [{ link: params.url, type: "url" }]
     });
-    return taskResult.response;
   }
 };
 
@@ -695,21 +686,16 @@ var UnityClawClient = class {
   document;
   media;
   constructor(config = {}) {
-    const apiKey = config.apiKey ?? process.env.UNITYCLAW_API_KEY ?? "";
-    const baseUrl = config.baseUrl ?? process.env.UNITYCLAW_BASE_URL ?? DEFAULT_BASE_URL;
+    const fileConfig = loadConfig();
+    const apiKey = config.apiKey ?? process.env.UNITYCLAW_API_KEY ?? fileConfig.apiKey ?? "";
+    const baseUrl = config.baseUrl ?? process.env.UNITYCLAW_BASE_URL ?? fileConfig.baseUrl ?? DEFAULT_BASE_URL;
     if (!apiKey) {
       throw new Error("API key is required. Set UNITYCLAW_API_KEY environment variable or pass apiKey in config.");
     }
     this.config = {
       apiKey,
       baseUrl,
-      taskDir: config.taskDir ?? (() => {
-        try {
-          return path.join(process.cwd(), "tasks");
-        } catch {
-          return path.join(os.homedir(), "tasks");
-        }
-      })(),
+      taskDir: config.taskDir ?? fileConfig.taskDir ?? DEFAULT_TASKS_DIR,
       timeout: config.timeout ?? DEFAULT_TIMEOUT,
       downloadAttachments: config.downloadAttachments ?? true,
       context: config.context ?? {}
@@ -886,10 +872,18 @@ var UnityClawClient = class {
   }
 };
 export {
+  CONFIG_DIR,
+  CONFIG_FILE,
+  DEFAULT_TASKS_DIR,
   DocumentAPI,
   ImageAPI,
   MediaAPI,
   TaskFolderManager,
   UnityClawClient,
-  VideoAPI
+  VideoAPI,
+  getConfigPath,
+  getConfigValue,
+  loadConfig,
+  saveConfig,
+  setConfigValue
 };

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@unityclaw/sdk",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Node.js SDK for UnityClaw API - AI-powered image/video generation, media analysis, and more",
   "type": "module",
+  "bin": {
+    "unityclaw-sdk": "./dist/cli.js"
+  },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,11 +18,12 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "src/cli.ts"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --watch",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },

package/src/cli.ts

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/**
+ * @unityclaw/sdk CLI
+ * Configuration management for UnityClaw SDK
+ */
+
+import {
+  loadConfig,
+  setConfigValue,
+  getConfigValue,
+  getConfigPath,
+} from './config.js';
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+function showHelp() {
+  console.log(`
+@unityclaw/sdk CLI - Configuration Management
+
+Usage:
+  unityclaw-sdk config                 Show current configuration
+  unityclaw-sdk config set <key> <value>  Set a configuration value
+  unityclaw-sdk config get <key>       Get a configuration value
+  unityclaw-sdk config list            List all configuration
+
+Configuration keys:
+  apiKey      API key for UnityClaw
+  baseUrl     Base URL for API (default: https://unityclaw.com)
+  taskDir     Directory for task folders (default: ~/.unityclaw/tasks)
+
+Examples:
+  unityclaw-sdk config set apiKey your-api-key
+  unityclaw-sdk config set baseUrl https://custom.example.com
+  unityclaw-sdk config get apiKey
+  unityclaw-sdk config list
+`);
+}
+
+if (!command || command === 'help' || command === '--help' || command === '-h') {
+  showHelp();
+  process.exit(0);
+}
+
+if (command === 'config') {
+  const action = args[1];
+  const key = args[2];
+  const value = args[3];
+
+  if (!action) {
+    // Show current config
+    const config = loadConfig();
+    console.log('\nCurrent configuration:\n');
+    console.log(`  Config file: ${getConfigPath()}\n`);
+    if (Object.keys(config).length === 0) {
+      console.log('  (empty - no configuration set)\n');
+    } else {
+      for (const [k, v] of Object.entries(config)) {
+        // Mask API key for security
+        const displayValue = k === 'apiKey' && v
+          ? `${String(v).slice(0, 8)}...${String(v).slice(-4)}`
+          : v;
+        console.log(`  ${k}: ${displayValue}`);
+      }
+      console.log();
+    }
+  } else if (action === 'set' && key && value) {
+    setConfigValue(key, value);
+    console.log(`✅ Config saved to ${getConfigPath()}`);
+  } else if (action === 'get' && key) {
+    const val = getConfigValue(key);
+    if (val) {
+      console.log(val);
+    } else {
+      console.log(`(not set)`);
+    }
+  } else if (action === 'list') {
+    const config = loadConfig();
+    console.log('\nConfiguration:\n');
+    for (const [k, v] of Object.entries(config)) {
+      const displayValue = k === 'apiKey' && v
+        ? `${String(v).slice(0, 8)}...${String(v).slice(-4)}`
+        : v;
+      console.log(`  ${k}: ${displayValue}`);
+    }
+    console.log();
+  } else {
+    console.error('Invalid usage. Run `unityclaw-sdk config --help` for help.');
+    process.exit(1);
+  }
+} else {
+  console.error(`Unknown command: ${command}`);
+  showHelp();
+  process.exit(1);
+}