fastclaw-cli 0.1.0

package/dist/sdk.js

@@ -0,0 +1,409 @@
+// src/constants.ts
+var DEFAULT_URL = "https://claw.yesy.dev";
+var API_BASE = "/bot/api/v1";
+var MODEL_PRESETS = {
+  google: {
+    name: "google",
+    baseUrl: "https://generativelanguage.googleapis.com/v1beta",
+    models: [
+      {
+        id: "gemini-2.5-flash",
+        name: "Gemini 2.5 Flash",
+        reasoning: true,
+        input: ["text", "image"],
+        context_window: 1048576,
+        max_tokens: 65536
+      },
+      {
+        id: "gemini-2.5-pro",
+        name: "Gemini 2.5 Pro",
+        reasoning: true,
+        input: ["text", "image"],
+        context_window: 1048576,
+        max_tokens: 65536
+      }
+    ]
+  },
+  anthropic: {
+    name: "anthropic",
+    baseUrl: "https://api.anthropic.com",
+    auth: "api-key",
+    api: "anthropic-messages",
+    models: [
+      {
+        id: "claude-sonnet-4-20250514",
+        name: "Claude Sonnet 4",
+        reasoning: false,
+        input: ["text", "image"],
+        context_window: 2e5,
+        max_tokens: 8192
+      }
+    ]
+  },
+  openai: {
+    name: "openai",
+    baseUrl: "https://api.openai.com/v1",
+    auth: "api-key",
+    api: "openai-completions",
+    models: [
+      {
+        id: "gpt-5.1",
+        name: "GPT-5.1",
+        reasoning: false,
+        input: ["text", "image"],
+        context_window: 1048576,
+        max_tokens: 32768
+      }
+    ]
+  },
+  minimax: {
+    name: "minimax",
+    baseUrl: "https://api.minimax.chat/v1",
+    auth: "api-key",
+    api: "openai-completions",
+    models: [
+      {
+        id: "MiniMax-Text-01",
+        name: "MiniMax Text 01",
+        reasoning: false,
+        input: ["text"],
+        context_window: 1e6,
+        max_tokens: 65536
+      }
+    ]
+  }
+};
+var PROVIDER_DEFAULTS = {
+  google: "google/gemini-2.5-flash",
+  anthropic: "anthropic/claude-sonnet-4-20250514",
+  openai: "openai/gpt-5.1",
+  minimax: "minimax/MiniMax-Text-01"
+};
+var CHANNEL_FIELDS = {
+  feishu: {
+    required: ["appId", "appSecret"],
+    optional: ["account", "dmPolicy", "groupPolicy"]
+  },
+  telegram: {
+    required: ["botToken"],
+    optional: ["account", "dmPolicy", "groupPolicy"]
+  },
+  slack: {
+    required: ["botToken", "appToken"],
+    optional: ["account", "dmPolicy", "groupPolicy"]
+  },
+  discord: {
+    required: ["botToken"],
+    optional: ["account", "dmPolicy", "groupPolicy"]
+  },
+  whatsapp: {
+    required: ["botToken"],
+    optional: ["account", "dmPolicy", "groupPolicy"]
+  },
+  line: {
+    required: ["botToken", "channelSecret"],
+    optional: ["account", "dmPolicy", "groupPolicy"]
+  },
+  teams: {
+    required: ["appId", "appPassword"],
+    optional: ["account", "dmPolicy", "groupPolicy"]
+  }
+};
+var DM_POLICIES = ["open", "pairing", "allowlist", "disabled"];
+var GROUP_POLICIES = ["open", "allowlist", "disabled"];
+
+// src/utils/error.ts
+import chalk from "chalk";
+var ApiError = class extends Error {
+  constructor(statusCode, apiCode, message) {
+    super(message);
+    this.statusCode = statusCode;
+    this.apiCode = apiCode;
+    this.name = "ApiError";
+  }
+};
+
+// src/client.ts
+var FastClawClient = class {
+  baseUrl;
+  adminToken;
+  appToken;
+  constructor(opts) {
+    this.baseUrl = opts.url.replace(/\/+$/, "") + API_BASE;
+    this.adminToken = opts.adminToken;
+    this.appToken = opts.appToken;
+  }
+  // ── Helpers ──
+  async request(method, path, opts) {
+    const authType = opts?.auth ?? "app";
+    const token = authType === "admin" ? this.adminToken : this.appToken;
+    if (!token) {
+      throw new Error(`No ${authType} token configured. Set via --${authType}-token, env, or 'fastclaw config set'.`);
+    }
+    let url = this.baseUrl + path;
+    if (opts?.query) {
+      const params = new URLSearchParams();
+      for (const [k, v] of Object.entries(opts.query)) {
+        if (v !== void 0 && v !== "") params.set(k, v);
+      }
+      const qs = params.toString();
+      if (qs) url += "?" + qs;
+    }
+    const headers = {
+      Authorization: `Bearer ${token}`
+    };
+    let bodyStr;
+    if (opts?.body !== void 0) {
+      headers["Content-Type"] = "application/json";
+      bodyStr = JSON.stringify(opts.body);
+    }
+    const res = await fetch(url, { method, headers, body: bodyStr });
+    if (!res.ok) {
+      let msg = res.statusText;
+      try {
+        const j = await res.json();
+        if (j.message) msg = j.message;
+      } catch {
+      }
+      throw new ApiError(res.status, res.status, msg);
+    }
+    const text = await res.text();
+    if (!text) return void 0;
+    const json = JSON.parse(text);
+    if (json && typeof json === "object" && "code" in json && json.code === 0 && "data" in json) {
+      return json.data;
+    }
+    return json;
+  }
+  // ── Admin: Apps ──
+  async createApp(req) {
+    return this.request("POST", "/admin/apps", { body: req, auth: "admin" });
+  }
+  async listApps() {
+    return this.request("GET", "/admin/apps", { auth: "admin" });
+  }
+  async getApp(id) {
+    return this.request("GET", `/admin/apps/${id}`, { auth: "admin" });
+  }
+  async updateApp(id, req) {
+    return this.request("PUT", `/admin/apps/${id}`, { body: req, auth: "admin" });
+  }
+  async deleteApp(id) {
+    return this.request("DELETE", `/admin/apps/${id}`, { auth: "admin" });
+  }
+  async rotateAppToken(id) {
+    return this.request("POST", `/admin/apps/${id}/reset-token`, { auth: "admin" });
+  }
+  // ── Admin: Bot Upgrade ──
+  async upgradeBot(id, req) {
+    return this.request("POST", `/admin/bots/${id}/upgrade`, { body: req ?? {}, auth: "admin" });
+  }
+  async upgradeAllBots(req) {
+    return this.request("POST", "/admin/bots/upgrade", { body: req ?? {}, auth: "admin" });
+  }
+  // ── Bots ──
+  async createBot(req) {
+    return this.request("POST", "/bots", { body: req });
+  }
+  async listBots(userId) {
+    return this.request("GET", "/bots", { query: { user_id: userId } });
+  }
+  async getBot(id) {
+    return this.request("GET", `/bots/${id}`);
+  }
+  async updateBot(id, req) {
+    return this.request("PUT", `/bots/${id}`, { body: req });
+  }
+  async deleteBot(id) {
+    return this.request("DELETE", `/bots/${id}`);
+  }
+  // ── Bot Lifecycle ──
+  async startBot(id) {
+    return this.request("POST", `/bots/${id}/start`);
+  }
+  async stopBot(id) {
+    return this.request("POST", `/bots/${id}/stop`);
+  }
+  async restartBot(id) {
+    return this.request("POST", `/bots/${id}/restart`);
+  }
+  async getBotStatus(id) {
+    return this.request("GET", `/bots/${id}/status`);
+  }
+  async getBotConnect(id) {
+    return this.request("GET", `/bots/${id}/connect`);
+  }
+  async resetBotToken(id) {
+    return this.request("POST", `/bots/${id}/reset-token`);
+  }
+  // ── Model Providers ──
+  async listProviders(botId) {
+    return this.request("GET", `/bots/${botId}/config/models`);
+  }
+  async addProvider(botId, provider) {
+    return this.request("POST", `/bots/${botId}/config/models`, { body: provider });
+  }
+  async getProvider(botId, name) {
+    return this.request("GET", `/bots/${botId}/config/models/${name}`);
+  }
+  async updateProvider(botId, name, provider) {
+    return this.request("PUT", `/bots/${botId}/config/models/${name}`, { body: provider });
+  }
+  async deleteProvider(botId, name) {
+    return this.request("DELETE", `/bots/${botId}/config/models/${name}`);
+  }
+  // ── Model Defaults ──
+  async getDefaults(botId) {
+    return this.request("GET", `/bots/${botId}/config/defaults`);
+  }
+  async setDefaults(botId, defaults) {
+    return this.request("PUT", `/bots/${botId}/config/defaults`, { body: defaults });
+  }
+  // ── Channels ──
+  async addChannel(botId, req) {
+    return this.request("POST", `/bots/${botId}/channels`, { body: req });
+  }
+  async listChannels(botId) {
+    return this.request("GET", `/bots/${botId}/channels`);
+  }
+  async removeChannel(botId, channel, account) {
+    const query = {};
+    if (account) query.account = account;
+    return this.request("DELETE", `/bots/${botId}/channels/${channel}`, { query });
+  }
+  // ── Channel Pairing ──
+  async listPairing(botId, channel) {
+    return this.request("GET", `/bots/${botId}/channels/${channel}/pairing`);
+  }
+  async approvePairing(botId, channel, req) {
+    return this.request("POST", `/bots/${botId}/channels/${channel}/pairing/approve`, { body: req });
+  }
+  async revokePairing(botId, channel, req) {
+    return this.request("POST", `/bots/${botId}/channels/${channel}/pairing/revoke`, { body: req });
+  }
+  async listPairedUsers(botId, channel) {
+    return this.request("GET", `/bots/${botId}/channels/${channel}/pairing/users`);
+  }
+  // ── Devices ──
+  async listDevices(botId, opts) {
+    const query = {};
+    if (opts?.status) query.status = opts.status;
+    if (opts?.client_mode) query.client_mode = opts.client_mode;
+    return this.request("GET", `/bots/${botId}/devices`, { query });
+  }
+  async approveDevice(botId, requestId) {
+    return this.request("POST", `/bots/${botId}/devices/${requestId}/approve`);
+  }
+  async revokeDevice(botId, deviceId, role) {
+    const query = {};
+    if (role) query.role = role;
+    return this.request("DELETE", `/bots/${botId}/devices/${deviceId}`, { query });
+  }
+  // ── Skills ──
+  async listSkills(botId) {
+    return this.request("GET", `/bots/${botId}/skills`);
+  }
+  async setSkill(botId, name, req) {
+    return this.request("PUT", `/bots/${botId}/skills/${name}`, { body: req });
+  }
+  async deleteSkill(botId, name) {
+    return this.request("DELETE", `/bots/${botId}/skills/${name}`);
+  }
+  // ── Utility: wait for bot ready ──
+  async waitForReady(botId, timeoutMs = 12e4, intervalMs = 3e3) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+      const status = await this.getBotStatus(botId);
+      if (status.ready) return status;
+      if (status.status === "error") throw new Error("Bot entered error state");
+      await new Promise((r) => setTimeout(r, intervalMs));
+    }
+    throw new Error(`Bot not ready after ${timeoutMs / 1e3}s`);
+  }
+  // ── Health check ──
+  async health() {
+    try {
+      const url = this.baseUrl.replace(API_BASE, "") + "/health";
+      const res = await fetch(url);
+      return res.ok;
+    } catch {
+      return false;
+    }
+  }
+};
+
+// src/config.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var CONFIG_DIR = join(homedir(), ".fastclaw");
+var CONFIG_FILE = join(CONFIG_DIR, "config.json");
+function loadConfig() {
+  try {
+    if (!existsSync(CONFIG_FILE)) return {};
+    const raw = readFileSync(CONFIG_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function saveConfig(config) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n");
+}
+function updateConfig(updates) {
+  const config = loadConfig();
+  Object.assign(config, updates);
+  saveConfig(config);
+  return config;
+}
+function resolveConfig(opts) {
+  const file = loadConfig();
+  return {
+    url: opts.url || process.env.FASTCLAW_URL || file.url || DEFAULT_URL,
+    adminToken: opts.adminToken || process.env.FASTCLAW_ADMIN_TOKEN || file.admin_token,
+    appToken: opts.appToken || process.env.FASTCLAW_APP_TOKEN || file.app_token,
+    userId: opts.userId || process.env.FASTCLAW_USER_ID || file.default_user_id || "default",
+    botId: opts.botId || process.env.FASTCLAW_BOT_ID || file.default_bot_id,
+    json: opts.json ?? false
+  };
+}
+function getConfigPath() {
+  return CONFIG_FILE;
+}
+
+// src/utils/validators.ts
+var SLUG_REGEX = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+function isValidSlug(slug) {
+  return slug.length >= 1 && slug.length <= 50 && SLUG_REGEX.test(slug);
+}
+function isValidUrl(url) {
+  try {
+    new URL(url);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function slugify(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 50);
+}
+export {
+  API_BASE,
+  ApiError,
+  CHANNEL_FIELDS,
+  DEFAULT_URL,
+  DM_POLICIES,
+  FastClawClient,
+  GROUP_POLICIES,
+  MODEL_PRESETS,
+  PROVIDER_DEFAULTS,
+  getConfigPath,
+  isValidSlug,
+  isValidUrl,
+  loadConfig,
+  resolveConfig,
+  saveConfig,
+  slugify,
+  updateConfig
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "fastclaw-cli",
+  "version": "0.1.0",
+  "description": "CLI and SDK for managing FastClaw bots",
+  "type": "module",
+  "main": "dist/sdk.js",
+  "types": "dist/sdk.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/sdk.js",
+      "types": "./dist/sdk.d.ts"
+    }
+  },
+  "bin": {
+    "fastclaw": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "fastclaw",
+    "bot",
+    "cli",
+    "sdk",
+    "openclaw"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.0.0",
+    "ora": "^8.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  }
+}