@unityclaw/sdk 1.0.2 → 1.0.4

package/README.md

@@ -0,0 +1,173 @@
+# @unityclaw/sdk
+
+Node.js SDK for UnityClaw API - AI-powered image/video generation, media analysis, and more.
+
+## Installation
+
+```bash
+npm install @unityclaw/sdk
+```
+
+## Quick Start
+
+```typescript
+import { UnityClawClient } from '@unityclaw/sdk';
+
+// Reads UNITYCLAW_API_KEY from environment variable
+const client = new UnityClawClient();
+
+// Or with explicit config
+const client = new UnityClawClient({
+  apiKey: 'your-api-key',
+  baseUrl: 'https://unityclaw.com',
+  taskDir: './tasks'
+});
+
+// Generate image
+const imageResult = await client.image.gemini({
+  prompt: 'A beautiful sunset over mountains'
+});
+
+// Generate video
+const videoResult = await client.video.sora({
+  prompt: 'A cat playing piano',
+  orientation: { value: 'landscape', label: 'Landscape' }
+});
+
+// Translate document
+const docResult = await client.document.translate({
+  attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }],
+  source_language: { value: 'en', label: 'English' },
+  target_language: { value: 'zh', label: 'Chinese' }
+});
+
+// Analyze media
+const mediaResult = await client.media.analyze({
+  url: [{ link: 'https://youtube.com/watch?v=...' }]
+});
+```
+
+## Configuration
+
+### Environment Variables
+
+- `UNITYCLAW_API_KEY` - Your UnityClaw API key
+- `UNITYCLAW_BASE_URL` - API base URL (optional, defaults to https://unityclaw.com)
+
+### CLI Configuration
+
+Use the CLI to persist configuration:
+
+```bash
+# Install globally
+npm install -g @unityclaw/sdk
+
+# Set API key (stored in ~/.unityclaw/config.json)
+unityclaw-sdk config set apiKey your-api-key
+
+# Set custom base URL
+unityclaw-sdk config set baseUrl https://custom.example.com
+
+# View current configuration
+unityclaw-sdk config
+
+# Get a specific value
+unityclaw-sdk config get apiKey
+```
+
+### Configuration Priority
+
+1. Constructor parameters (highest priority)
+2. Environment variables
+3. Config file (~/.unityclaw/config.json)
+4. Default values (lowest priority)
+
+## Task Folders
+
+Each SDK execution creates a task folder with:
+
+- `logs/request.json` - Request details
+- `logs/response.json` - API response
+- `logs/execution.log` - Execution log
+- `attachments/` - Downloaded attachments (to avoid link expiration)
+
+### Default Task Directory
+
+Tasks are stored in `~/.unityclaw/tasks/` by default. You can override this:
+
+```typescript
+const client = new UnityClawClient({
+  taskDir: '/path/to/custom/tasks'
+});
+```
+
+## API Reference
+
+### Image Generation
+
+```typescript
+// Gemini
+await client.image.gemini({
+  prompt: 'A sunset over mountains',
+  aspect_ratio: '16:9'
+});
+
+// JiMeng (Doubao)
+await client.image.jimeng({
+  prompt: 'A futuristic city',
+  model: 'v6.0'
+});
+```
+
+### Video Generation
+
+```typescript
+// Sora
+await client.video.sora({
+  prompt: 'A cat playing piano',
+  orientation: 'landscape'
+});
+
+// Veo
+await client.video.veo({
+  prompt: 'Ocean waves at sunset'
+});
+
+// Kling
+await client.video.kling({
+  prompt: 'A dancing robot',
+  version: 'v1.5'
+});
+```
+
+### Document Processing
+
+```typescript
+// Translate document
+await client.document.translate({
+  attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }],
+  source_language: { value: 'en', label: 'English' },
+  target_language: { value: 'zh', label: 'Chinese' }
+});
+
+// Convert document
+await client.document.convert({
+  attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }],
+  target_format: { value: 'word', label: 'Word' }
+});
+```
+
+### Media Analysis
+
+```typescript
+const result = await client.media.analyze({
+  url: [{ link: 'https://youtube.com/watch?v=...' }]
+});
+
+console.log(result.data.summary);
+console.log(result.data.subtitle);
+```
+
+## License
+
+MIT

package/dist/chunk-SZITFMFH.js

@@ -0,0 +1,71 @@
+// src/config.ts
+import path from "path";
+import os from "os";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+var CONFIG_DIR = path.join(os.homedir(), ".unityclaw");
+var CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+var DEFAULT_TASKS_DIR = path.join(os.homedir(), "Documents", "tasks");
+function getConfigPath() {
+  return CONFIG_FILE;
+}
+function loadConfig() {
+  try {
+    if (existsSync(CONFIG_FILE)) {
+      const content = readFileSync(CONFIG_FILE, "utf-8");
+      return JSON.parse(content);
+    }
+  } catch {
+  }
+  return {};
+}
+function saveConfig(config) {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+}
+function setConfigValue(key, value) {
+  const config = loadConfig();
+  const keyMap = {
+    "apiKey": "apiKey",
+    "api_key": "apiKey",
+    "key": "apiKey",
+    "baseUrl": "baseUrl",
+    "base_url": "baseUrl",
+    "url": "baseUrl",
+    "taskDir": "taskDir",
+    "task_dir": "taskDir",
+    "tasks": "taskDir"
+  };
+  const configKey = keyMap[key] || key;
+  config[configKey] = value;
+  saveConfig(config);
+}
+function getConfigValue(key) {
+  const config = loadConfig();
+  const keyMap = {
+    "apiKey": "apiKey",
+    "api_key": "apiKey",
+    "key": "apiKey",
+    "baseUrl": "baseUrl",
+    "base_url": "baseUrl",
+    "url": "baseUrl",
+    "taskDir": "taskDir",
+    "task_dir": "taskDir",
+    "tasks": "taskDir"
+  };
+  const configKey = keyMap[key] || key;
+  const value = config[configKey];
+  return value ? String(value) : void 0;
+}
+
+export {
+  CONFIG_DIR,
+  CONFIG_FILE,
+  DEFAULT_TASKS_DIR,
+  getConfigPath,
+  loadConfig,
+  saveConfig,
+  setConfigValue,
+  getConfigValue
+};

package/dist/cli.cjs

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/config.ts
+var import_path = __toESM(require("path"), 1);
+var import_os = __toESM(require("os"), 1);
+var import_fs = require("fs");
+var CONFIG_DIR = import_path.default.join(import_os.default.homedir(), ".unityclaw");
+var CONFIG_FILE = import_path.default.join(CONFIG_DIR, "config.json");
+var DEFAULT_TASKS_DIR = import_path.default.join(import_os.default.homedir(), "Documents", "tasks");
+function getConfigPath() {
+  return CONFIG_FILE;
+}
+function loadConfig() {
+  try {
+    if ((0, import_fs.existsSync)(CONFIG_FILE)) {
+      const content = (0, import_fs.readFileSync)(CONFIG_FILE, "utf-8");
+      return JSON.parse(content);
+    }
+  } catch {
+  }
+  return {};
+}
+function saveConfig(config) {
+  if (!(0, import_fs.existsSync)(CONFIG_DIR)) {
+    (0, import_fs.mkdirSync)(CONFIG_DIR, { recursive: true });
+  }
+  (0, import_fs.writeFileSync)(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+}
+function setConfigValue(key, value) {
+  const config = loadConfig();
+  const keyMap = {
+    "apiKey": "apiKey",
+    "api_key": "apiKey",
+    "key": "apiKey",
+    "baseUrl": "baseUrl",
+    "base_url": "baseUrl",
+    "url": "baseUrl",
+    "taskDir": "taskDir",
+    "task_dir": "taskDir",
+    "tasks": "taskDir"
+  };
+  const configKey = keyMap[key] || key;
+  config[configKey] = value;
+  saveConfig(config);
+}
+function getConfigValue(key) {
+  const config = loadConfig();
+  const keyMap = {
+    "apiKey": "apiKey",
+    "api_key": "apiKey",
+    "key": "apiKey",
+    "baseUrl": "baseUrl",
+    "base_url": "baseUrl",
+    "url": "baseUrl",
+    "taskDir": "taskDir",
+    "task_dir": "taskDir",
+    "tasks": "taskDir"
+  };
+  const configKey = keyMap[key] || key;
+  const value = config[configKey];
+  return value ? String(value) : void 0;
+}
+
+// src/cli.ts
+var args = process.argv.slice(2);
+var 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) {
+    const config = loadConfig();
+    console.log("\nCurrent configuration:\n");
+    console.log(`  Config file: ${getConfigPath()}
+`);
+    if (Object.keys(config).length === 0) {
+      console.log("  (empty - no configuration set)\n");
+    } else {
+      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 if (action === "set" && key && value) {
+    setConfigValue(key, value);
+    console.log(`\u2705 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);
+}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import {
+  getConfigPath,
+  getConfigValue,
+  loadConfig,
+  setConfigValue
+} from "./chunk-SZITFMFH.js";
+
+// src/cli.ts
+var args = process.argv.slice(2);
+var 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) {
+    const config = loadConfig();
+    console.log("\nCurrent configuration:\n");
+    console.log(`  Config file: ${getConfigPath()}
+`);
+    if (Object.keys(config).length === 0) {
+      console.log("  (empty - no configuration set)\n");
+    } else {
+      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 if (action === "set" && key && value) {
+    setConfigValue(key, value);
+    console.log(`\u2705 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);
+}

package/dist/index.cjs

@@ -30,18 +30,24 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CONFIG_DIR: () => CONFIG_DIR,
+  CONFIG_FILE: () => CONFIG_FILE,
+  DEFAULT_TASKS_DIR: () => DEFAULT_TASKS_DIR,
   DocumentAPI: () => DocumentAPI,
   ImageAPI: () => ImageAPI,
   MediaAPI: () => MediaAPI,
   TaskFolderManager: () => TaskFolderManager,
   UnityClawClient: () => UnityClawClient,
-  VideoAPI: () => VideoAPI
+  VideoAPI: () => VideoAPI,
+  getConfigPath: () => getConfigPath,
+  getConfigValue: () => getConfigValue,
+  loadConfig: () => loadConfig,
+  saveConfig: () => saveConfig,
+  setConfigValue: () => setConfigValue
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
-var import_path2 = __toESM(require("path"), 1);
-var import_os = __toESM(require("os"), 1);
 var import_axios2 = __toESM(require("axios"), 1);
 
 // src/task-folder.ts
@@ -227,6 +233,67 @@ var TaskFolderManager = class {
   }
 };
 
+// src/config.ts
+var import_path2 = __toESM(require("path"), 1);
+var import_os = __toESM(require("os"), 1);
+var import_fs2 = require("fs");
+var CONFIG_DIR = import_path2.default.join(import_os.default.homedir(), ".unityclaw");
+var CONFIG_FILE = import_path2.default.join(CONFIG_DIR, "config.json");
+var DEFAULT_TASKS_DIR = import_path2.default.join(import_os.default.homedir(), "Documents", "tasks");
+function getConfigPath() {
+  return CONFIG_FILE;
+}
+function loadConfig() {
+  try {
+    if ((0, import_fs2.existsSync)(CONFIG_FILE)) {
+      const content = (0, import_fs2.readFileSync)(CONFIG_FILE, "utf-8");
+      return JSON.parse(content);
+    }
+  } catch {
+  }
+  return {};
+}
+function saveConfig(config) {
+  if (!(0, import_fs2.existsSync)(CONFIG_DIR)) {
+    (0, import_fs2.mkdirSync)(CONFIG_DIR, { recursive: true });
+  }
+  (0, import_fs2.writeFileSync)(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+}
+function setConfigValue(key, value) {
+  const config = loadConfig();
+  const keyMap = {
+    "apiKey": "apiKey",
+    "api_key": "apiKey",
+    "key": "apiKey",
+    "baseUrl": "baseUrl",
+    "base_url": "baseUrl",
+    "url": "baseUrl",
+    "taskDir": "taskDir",
+    "task_dir": "taskDir",
+    "tasks": "taskDir"
+  };
+  const configKey = keyMap[key] || key;
+  config[configKey] = value;
+  saveConfig(config);
+}
+function getConfigValue(key) {
+  const config = loadConfig();
+  const keyMap = {
+    "apiKey": "apiKey",
+    "api_key": "apiKey",
+    "key": "apiKey",
+    "baseUrl": "baseUrl",
+    "base_url": "baseUrl",
+    "url": "baseUrl",
+    "taskDir": "taskDir",
+    "task_dir": "taskDir",
+    "tasks": "taskDir"
+  };
+  const configKey = keyMap[key] || key;
+  const value = config[configKey];
+  return value ? String(value) : void 0;
+}
+
 // src/apis/image.ts
 var ImageAPI = class {
   constructor(client) {
@@ -708,6 +775,16 @@ var MediaAPI = class {
 // src/client.ts
 var DEFAULT_BASE_URL = "https://unityclaw.com";
 var DEFAULT_TIMEOUT = 3e5;
+var OLD_DOMAINS = ["fieldshortcut.cn", "fieldshortcut.com"];
+var NEW_DOMAIN = "unityclaw.com";
+function replaceOldDomains(text) {
+  if (!text || typeof text !== "string") return text;
+  let result = text;
+  for (const oldDomain of OLD_DOMAINS) {
+    result = result.replace(new RegExp(oldDomain.replace(/\./g, "\\."), "g"), NEW_DOMAIN);
+  }
+  return result;
+}
 var UnityClawClient = class {
   config;
   httpClient;
@@ -718,21 +795,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 import_path2.default.join(process.cwd(), "tasks");
-        } catch {
-          return import_path2.default.join(import_os.default.homedir(), "tasks");
-        }
-      })(),
+      taskDir: config.taskDir ?? fileConfig.taskDir ?? DEFAULT_TASKS_DIR,
       timeout: config.timeout ?? DEFAULT_TIMEOUT,
       downloadAttachments: config.downloadAttachments ?? true,
       context: config.context ?? {}
@@ -819,6 +891,9 @@ var UnityClawClient = class {
       await this.taskFolderManager.writeRequest(taskCtx, endpoint, params, context);
       await this.taskFolderManager.log(taskCtx, "info", "Request prepared", { endpoint, params });
       const response = await this.httpClient.post(endpoint, requestBody);
+      if (response.data.msg) {
+        response.data.msg = replaceOldDomains(response.data.msg);
+      }
       await this.taskFolderManager.writeResponse(taskCtx, response.data);
       await this.taskFolderManager.log(taskCtx, "info", "Response received", {
         code: response.data.code,
@@ -846,7 +921,8 @@ var UnityClawClient = class {
         response.data.code === 0
       );
     } catch (error) {
-      const errorMessage = error instanceof import_axios2.AxiosError ? error.response?.data?.msg || error.message : error instanceof Error ? error.message : String(error);
+      const rawErrorMessage = error instanceof import_axios2.AxiosError ? error.response?.data?.msg || error.message : error instanceof Error ? error.message : String(error);
+      const errorMessage = replaceOldDomains(rawErrorMessage);
       await this.taskFolderManager.log(taskCtx, "error", `Request failed: ${errorMessage}`, {
         error: error instanceof import_axios2.AxiosError ? { status: error.response?.status, data: error.response?.data } : error
       });
@@ -910,10 +986,18 @@ var UnityClawClient = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CONFIG_DIR,
+  CONFIG_FILE,
+  DEFAULT_TASKS_DIR,
   DocumentAPI,
   ImageAPI,
   MediaAPI,
   TaskFolderManager,
   UnityClawClient,
-  VideoAPI
+  VideoAPI,
+  getConfigPath,
+  getConfigValue,
+  loadConfig,
+  saveConfig,
+  setConfigValue
 });

package/dist/index.d.cts

@@ -804,4 +804,31 @@ declare class UnityClawClient {
     analyzeMedia(params: MediaAnalysisParams): Promise<TaskResult<APIResponse<MediaAnalysisResult>>>;
 }
 
-export { type APIResponse, type AttachmentFieldItem, type AttachmentResult, type BitableContext, type Context, type DeepPartial, type DocConvertParams, type DocTranslateParams, DocumentAPI, type DoubaoVideoParams, type GeminiImageParams, ImageAPI, type ImageGenParams, type JiMengImageParams, type JiMengVideoParams, type KlingVideoParams, type LabelFieldItem, type LabelValue, MediaAPI, type MediaAnalysisParams, type MediaAnalysisResult, type MiniMaxVideoParams, type OpenClawShortcutParams, type SDKContext, type SoraVideoParams, type TaskFolderContext, TaskFolderManager, type TaskFolderOptions, type TaskLog, type TaskResult, type TextFieldItem, type TextInput, UnityClawClient, type UnityClawClientConfig, type UrlFieldItem, type VeoVideoParams, VideoAPI, type WanVideoParams };
+/**
+ * UnityClaw SDK Config Management
+ * Shared configuration for SDK and CLI tools
+ */
+/** Config directory */
+declare const CONFIG_DIR: string;
+/** Config file path */
+declare const CONFIG_FILE: string;
+/** Default tasks directory - in Documents so users can easily find results */
+declare const DEFAULT_TASKS_DIR: string;
+/** UnityClaw configuration */
+interface UnityClawConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    taskDir?: string;
+}
+/** Get config file path */
+declare function getConfigPath(): string;
+/** Load config from ~/.unityclaw/config.json */
+declare function loadConfig(): UnityClawConfig;
+/** Save config to file */
+declare function saveConfig(config: UnityClawConfig): void;
+/** Set a config value */
+declare function setConfigValue(key: string, value: string): void;
+/** Get a config value */
+declare function getConfigValue(key: string): string | undefined;
+
+export { type APIResponse, type AttachmentFieldItem, type AttachmentResult, type BitableContext, CONFIG_DIR, CONFIG_FILE, type Context, DEFAULT_TASKS_DIR, type DeepPartial, type DocConvertParams, type DocTranslateParams, DocumentAPI, type DoubaoVideoParams, type GeminiImageParams, ImageAPI, type ImageGenParams, type JiMengImageParams, type JiMengVideoParams, type KlingVideoParams, type LabelFieldItem, type LabelValue, MediaAPI, type MediaAnalysisParams, type MediaAnalysisResult, type MiniMaxVideoParams, type OpenClawShortcutParams, type SDKContext, type SoraVideoParams, type TaskFolderContext, TaskFolderManager, type TaskFolderOptions, type TaskLog, type TaskResult, type TextFieldItem, type TextInput, UnityClawClient, type UnityClawClientConfig, type UnityClawConfig, type UrlFieldItem, type VeoVideoParams, VideoAPI, type WanVideoParams, getConfigPath, getConfigValue, loadConfig, saveConfig, setConfigValue };

package/dist/index.d.ts

@@ -804,4 +804,31 @@ declare class UnityClawClient {
     analyzeMedia(params: MediaAnalysisParams): Promise<TaskResult<APIResponse<MediaAnalysisResult>>>;
 }
 
-export { type APIResponse, type AttachmentFieldItem, type AttachmentResult, type BitableContext, type Context, type DeepPartial, type DocConvertParams, type DocTranslateParams, DocumentAPI, type DoubaoVideoParams, type GeminiImageParams, ImageAPI, type ImageGenParams, type JiMengImageParams, type JiMengVideoParams, type KlingVideoParams, type LabelFieldItem, type LabelValue, MediaAPI, type MediaAnalysisParams, type MediaAnalysisResult, type MiniMaxVideoParams, type OpenClawShortcutParams, type SDKContext, type SoraVideoParams, type TaskFolderContext, TaskFolderManager, type TaskFolderOptions, type TaskLog, type TaskResult, type TextFieldItem, type TextInput, UnityClawClient, type UnityClawClientConfig, type UrlFieldItem, type VeoVideoParams, VideoAPI, type WanVideoParams };
+/**
+ * UnityClaw SDK Config Management
+ * Shared configuration for SDK and CLI tools
+ */
+/** Config directory */
+declare const CONFIG_DIR: string;
+/** Config file path */
+declare const CONFIG_FILE: string;
+/** Default tasks directory - in Documents so users can easily find results */
+declare const DEFAULT_TASKS_DIR: string;
+/** UnityClaw configuration */
+interface UnityClawConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    taskDir?: string;
+}
+/** Get config file path */
+declare function getConfigPath(): string;
+/** Load config from ~/.unityclaw/config.json */
+declare function loadConfig(): UnityClawConfig;
+/** Save config to file */
+declare function saveConfig(config: UnityClawConfig): void;
+/** Set a config value */
+declare function setConfigValue(key: string, value: string): void;
+/** Get a config value */
+declare function getConfigValue(key: string): string | undefined;
+
+export { type APIResponse, type AttachmentFieldItem, type AttachmentResult, type BitableContext, CONFIG_DIR, CONFIG_FILE, type Context, DEFAULT_TASKS_DIR, type DeepPartial, type DocConvertParams, type DocTranslateParams, DocumentAPI, type DoubaoVideoParams, type GeminiImageParams, ImageAPI, type ImageGenParams, type JiMengImageParams, type JiMengVideoParams, type KlingVideoParams, type LabelFieldItem, type LabelValue, MediaAPI, type MediaAnalysisParams, type MediaAnalysisResult, type MiniMaxVideoParams, type OpenClawShortcutParams, type SDKContext, type SoraVideoParams, type TaskFolderContext, TaskFolderManager, type TaskFolderOptions, type TaskLog, type TaskResult, type TextFieldItem, type TextInput, UnityClawClient, type UnityClawClientConfig, type UnityClawConfig, type UrlFieldItem, type VeoVideoParams, VideoAPI, type WanVideoParams, getConfigPath, getConfigValue, loadConfig, saveConfig, setConfigValue };

package/dist/index.js

@@ -1,6 +1,15 @@
+import {
+  CONFIG_DIR,
+  CONFIG_FILE,
+  DEFAULT_TASKS_DIR,
+  getConfigPath,
+  getConfigValue,
+  loadConfig,
+  saveConfig,
+  setConfigValue
+} from "./chunk-SZITFMFH.js";
+
 // src/client.ts
-import path from "path";
-import os from "os";
 import axios2, { AxiosError } from "axios";
 
 // src/task-folder.ts
@@ -667,6 +676,16 @@ var MediaAPI = class {
 // src/client.ts
 var DEFAULT_BASE_URL = "https://unityclaw.com";
 var DEFAULT_TIMEOUT = 3e5;
+var OLD_DOMAINS = ["fieldshortcut.cn", "fieldshortcut.com"];
+var NEW_DOMAIN = "unityclaw.com";
+function replaceOldDomains(text) {
+  if (!text || typeof text !== "string") return text;
+  let result = text;
+  for (const oldDomain of OLD_DOMAINS) {
+    result = result.replace(new RegExp(oldDomain.replace(/\./g, "\\."), "g"), NEW_DOMAIN);
+  }
+  return result;
+}
 var UnityClawClient = class {
   config;
   httpClient;
@@ -677,21 +696,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 ?? {}
@@ -778,6 +792,9 @@ var UnityClawClient = class {
       await this.taskFolderManager.writeRequest(taskCtx, endpoint, params, context);
       await this.taskFolderManager.log(taskCtx, "info", "Request prepared", { endpoint, params });
       const response = await this.httpClient.post(endpoint, requestBody);
+      if (response.data.msg) {
+        response.data.msg = replaceOldDomains(response.data.msg);
+      }
       await this.taskFolderManager.writeResponse(taskCtx, response.data);
       await this.taskFolderManager.log(taskCtx, "info", "Response received", {
         code: response.data.code,
@@ -805,7 +822,8 @@ var UnityClawClient = class {
         response.data.code === 0
       );
     } catch (error) {
-      const errorMessage = error instanceof AxiosError ? error.response?.data?.msg || error.message : error instanceof Error ? error.message : String(error);
+      const rawErrorMessage = error instanceof AxiosError ? error.response?.data?.msg || error.message : error instanceof Error ? error.message : String(error);
+      const errorMessage = replaceOldDomains(rawErrorMessage);
       await this.taskFolderManager.log(taskCtx, "error", `Request failed: ${errorMessage}`, {
         error: error instanceof AxiosError ? { status: error.response?.status, data: error.response?.data } : error
       });
@@ -868,10 +886,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.2",
+  "version": "1.0.4",
   "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);
+}