@unityclaw/sdk 1.0.1 → 1.0.3

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-WG7OYNEX.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(CONFIG_DIR, "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(CONFIG_DIR, "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-WG7OYNEX.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);
+}