@protoboxai/cli 1.0.0

package/dist/utils/config-store.js

@@ -0,0 +1,209 @@
+import Conf from "conf";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync, mkdirSync } from "node:fs";
+const DEFAULT_CONFIG = {
+  baseUrl: "https://platform.protobox.ai",
+  defaultFormat: "table"
+};
+function getConfigDir() {
+  return join(homedir(), ".protobox");
+}
+function ensureConfigDir() {
+  const configDir = getConfigDir();
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true });
+  }
+}
+class ConfigStore {
+  store;
+  constructor() {
+    ensureConfigDir();
+    this.store = new Conf({
+      projectName: "protobox",
+      cwd: getConfigDir(),
+      configName: "config",
+      defaults: DEFAULT_CONFIG,
+      schema: {
+        apiKey: { type: "string" },
+        jwtToken: { type: "string" },
+        refreshToken: { type: "string" },
+        baseUrl: { type: "string", default: DEFAULT_CONFIG.baseUrl },
+        server: { type: "string" },
+        deployment: { type: "string" },
+        apiPrefix: { type: "string" },
+        workspaceId: { type: "string" },
+        appUrl: { type: "string" },
+        defaultFormat: {
+          type: "string",
+          enum: ["table", "json"],
+          default: "table"
+        }
+      }
+    });
+  }
+  /**
+   * Get a configuration value
+   * Supports dot notation for nested values
+   */
+  get(key) {
+    return this.store.get(key);
+  }
+  /**
+   * Set a configuration value
+   */
+  set(key, value) {
+    this.store.set(key, value);
+  }
+  /**
+   * Delete a configuration value
+   */
+  delete(key) {
+    this.store.delete(key);
+  }
+  /**
+   * Get all configuration values
+   */
+  getAll() {
+    return this.store.store;
+  }
+  /**
+   * Check if a key exists in the configuration
+   */
+  has(key) {
+    return this.store.has(key);
+  }
+  /**
+   * Clear all configuration
+   */
+  clear() {
+    this.store.clear();
+  }
+  /**
+   * Get the path to the config file
+   */
+  getPath() {
+    return this.store.path;
+  }
+  /**
+   * Get API key with environment variable fallback
+   * Priority: CHANL_API_KEY env var > config file
+   */
+  getApiKey() {
+    return process.env["PROTOBOX_API_KEY"] || process.env["CHANL_API_KEY"] || this.get("apiKey");
+  }
+  /**
+   * Get JWT token from config
+   */
+  getJwtToken() {
+    return this.get("jwtToken");
+  }
+  /**
+   * Get refresh token from config
+   */
+  getRefreshToken() {
+    return this.get("refreshToken");
+  }
+  /**
+   * Get base URL with environment variable fallback
+   * Priority: CHANL_BASE_URL env var > config file > default
+   */
+  getBaseUrl() {
+    return process.env["PROTOBOX_BASE_URL"] || process.env["CHANL_BASE_URL"] || this.get("server") || this.get("baseUrl");
+  }
+  getDeployment() {
+    const d = process.env["CHANL_DEPLOYMENT"] || this.get("deployment");
+    if (d === "local" || d === "cloud") return d;
+    const base = this.getBaseUrl();
+    if (base.includes("localhost:18005") || base.includes("127.0.0.1:18005")) {
+      return "local";
+    }
+    return void 0;
+  }
+  getApiPrefix() {
+    const fromEnv = process.env["CHANL_API_PREFIX"];
+    if (fromEnv !== void 0) return fromEnv;
+    return this.get("apiPrefix");
+  }
+  /**
+   * Get the app URL for browser-based flows (e.g., CLI auth)
+   * Priority: CHANL_APP_URL env var > config file > derived from baseUrl
+   */
+  getAppUrl() {
+    if (process.env["PROTOBOX_APP_URL"]) return process.env["PROTOBOX_APP_URL"];
+    if (process.env["CHANL_APP_URL"]) return process.env["CHANL_APP_URL"];
+    const stored = this.get("appUrl");
+    if (stored) return stored;
+    const baseUrl = this.getBaseUrl();
+    if (baseUrl.includes("localhost")) return "http://localhost:3014";
+    return "https://app.protobox.ai";
+  }
+  /**
+   * Get workspace ID with environment variable fallback
+   * Priority: CHANL_WORKSPACE_ID env var > config file
+   */
+  getWorkspaceId() {
+    return process.env["PROTOBOX_WORKSPACE_ID"] || process.env["CHANL_WORKSPACE_ID"] || this.get("workspaceId");
+  }
+  /**
+   * Check if user is authenticated (has API key or JWT token)
+   */
+  isAuthenticated() {
+    return !!(this.getApiKey() || this.getJwtToken());
+  }
+  /**
+   * Get the auth method in use
+   */
+  getAuthMethod() {
+    if (this.getApiKey()) return "api-key";
+    if (this.getJwtToken()) return "jwt";
+    return null;
+  }
+  /**
+   * Set API key in config
+   */
+  setApiKey(apiKey) {
+    this.set("apiKey", apiKey);
+  }
+  /**
+   * Set JWT tokens in config (from browser login)
+   */
+  setJwtAuth(jwtToken, refreshToken) {
+    this.set("jwtToken", jwtToken);
+    this.set("refreshToken", refreshToken);
+    this.delete("apiKey");
+  }
+  /**
+   * Remove all auth credentials from config (logout)
+   */
+  clearAuth() {
+    this.delete("apiKey");
+    this.delete("jwtToken");
+    this.delete("refreshToken");
+  }
+  /**
+   * Remove API key from config (logout)
+   */
+  removeApiKey() {
+    this.delete("apiKey");
+  }
+  /**
+   * Set workspace ID in config
+   */
+  setWorkspaceId(workspaceId) {
+    this.set("workspaceId", workspaceId);
+  }
+  /**
+   * Set base URL in config
+   */
+  setBaseUrl(baseUrl) {
+    this.set("baseUrl", baseUrl);
+  }
+}
+const configStore = new ConfigStore();
+export {
+  ConfigStore,
+  configStore,
+  getConfigDir
+};
+//# sourceMappingURL=config-store.js.map

package/dist/utils/output.js

@@ -0,0 +1,221 @@
+import chalk from "chalk";
+let globalOptions = {};
+function setOutputOptions(options) {
+  globalOptions = { ...globalOptions, ...options };
+}
+function getOutputOptions() {
+  return globalOptions;
+}
+function isJsonOutput() {
+  return globalOptions.json === true;
+}
+function printJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+function printSuccess(message) {
+  if (isJsonOutput()) return;
+  console.log(chalk.green("\u2713"), message);
+}
+function printError(message, details) {
+  if (isJsonOutput()) {
+    printJson({ error: message, details });
+    return;
+  }
+  console.error(chalk.red("\u2717"), chalk.red("Error:"), message);
+  if (details) {
+    console.error("  ", chalk.dim(details));
+  }
+}
+function printWarning(message) {
+  if (isJsonOutput()) return;
+  console.log(chalk.yellow("!"), chalk.yellow("Warning:"), message);
+}
+function printInfo(message) {
+  if (isJsonOutput()) return;
+  console.log(chalk.blue("\u2139"), message);
+}
+function printLabel(label, value) {
+  if (isJsonOutput()) return;
+  console.log(chalk.dim(label + ":"), value);
+}
+function printHeader(title) {
+  if (isJsonOutput()) return;
+  console.log();
+  console.log(chalk.bold(title));
+  console.log(chalk.dim("\u2500".repeat(title.length)));
+}
+function printBlank() {
+  if (isJsonOutput()) return;
+  console.log();
+}
+function printTable(columns, rows) {
+  if (isJsonOutput()) {
+    printJson(rows);
+    return;
+  }
+  if (rows.length === 0) {
+    console.log(chalk.dim("No data to display"));
+    return;
+  }
+  const widths = columns.map((col) => {
+    const headerWidth = col.header.length;
+    const maxDataWidth = rows.reduce((max, row) => {
+      const value = col.format ? col.format(row[col.key]) : String(row[col.key] ?? "");
+      return Math.max(max, value.length);
+    }, 0);
+    return col.width ?? Math.max(headerWidth, maxDataWidth);
+  });
+  const headerLine = columns.map((col, i) => padString(col.header, widths[i] ?? 0, col.align)).join("  ");
+  console.log(chalk.bold(headerLine));
+  console.log(
+    chalk.dim(
+      widths.map((w) => "\u2500".repeat(w)).join("\u2500\u2500")
+    )
+  );
+  for (const row of rows) {
+    const rowLine = columns.map((col, i) => {
+      const value = col.format ? col.format(row[col.key]) : String(row[col.key] ?? "");
+      return padString(value, widths[i] ?? 0, col.align);
+    }).join("  ");
+    console.log(rowLine);
+  }
+}
+function padString(str, width, align = "left") {
+  const strLen = stripAnsi(str).length;
+  const padding = Math.max(0, width - strLen);
+  switch (align) {
+    case "right":
+      return " ".repeat(padding) + str;
+    case "center":
+      const leftPad = Math.floor(padding / 2);
+      const rightPad = padding - leftPad;
+      return " ".repeat(leftPad) + str + " ".repeat(rightPad);
+    default:
+      return str + " ".repeat(padding);
+  }
+}
+function stripAnsi(str) {
+  return str.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "");
+}
+function formatBoolean(value) {
+  return value ? chalk.green("\u2713") : chalk.dim("\u2717");
+}
+function formatRelativeDate(dateStr) {
+  if (!dateStr) return chalk.dim("Never");
+  const date = typeof dateStr === "string" ? new Date(dateStr) : dateStr;
+  const now = /* @__PURE__ */ new Date();
+  const diffMs = now.getTime() - date.getTime();
+  const diffSecs = Math.floor(diffMs / 1e3);
+  const diffMins = Math.floor(diffSecs / 60);
+  const diffHours = Math.floor(diffMins / 60);
+  const diffDays = Math.floor(diffHours / 24);
+  if (diffSecs < 60) return "Just now";
+  if (diffMins < 60) return `${diffMins} minute${diffMins > 1 ? "s" : ""} ago`;
+  if (diffHours < 24) return `${diffHours} hour${diffHours > 1 ? "s" : ""} ago`;
+  if (diffDays < 7) return `${diffDays} day${diffDays > 1 ? "s" : ""} ago`;
+  return date.toLocaleDateString();
+}
+function truncate(str, maxLength) {
+  if (str.length <= maxLength) return str;
+  return str.slice(0, maxLength - 1) + "\u2026";
+}
+function maskString(str, showFirst = 4, showLast = 4) {
+  if (str.length <= showFirst + showLast) {
+    return "*".repeat(str.length);
+  }
+  const first = str.slice(0, showFirst);
+  const last = str.slice(-showLast);
+  const masked = "*".repeat(Math.min(8, str.length - showFirst - showLast));
+  return `${first}${masked}${last}`;
+}
+function formatDuration(ms) {
+  if (ms === void 0) return chalk.dim("\u2014");
+  if (ms < 1e3) return `${ms}ms`;
+  if (ms < 6e4) return `${(ms / 1e3).toFixed(1)}s`;
+  return `${(ms / 6e4).toFixed(1)}m`;
+}
+function formatStatus(status) {
+  const statusColors = {
+    success: chalk.green,
+    completed: chalk.green,
+    active: chalk.green,
+    enabled: chalk.green,
+    failed: chalk.red,
+    error: chalk.red,
+    disabled: chalk.red,
+    pending: chalk.yellow,
+    running: chalk.blue,
+    in_progress: chalk.blue
+  };
+  const colorFn = statusColors[status.toLowerCase()] ?? chalk.white;
+  return colorFn(status);
+}
+function formatDate(dateStr) {
+  if (!dateStr) return chalk.dim("\u2014");
+  const date = typeof dateStr === "string" ? new Date(dateStr) : dateStr;
+  return date.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+function printSimpleTable(headers, rows) {
+  if (isJsonOutput()) {
+    const data = rows.map((row) => {
+      const obj = {};
+      headers.forEach((h, i) => {
+        obj[h] = row[i] ?? "";
+      });
+      return obj;
+    });
+    printJson(data);
+    return;
+  }
+  if (rows.length === 0) {
+    console.log(chalk.dim("No data to display"));
+    return;
+  }
+  const widths = headers.map((header, i) => {
+    const maxDataWidth = rows.reduce((max, row) => {
+      const value = stripAnsi(row[i] ?? "");
+      return Math.max(max, value.length);
+    }, 0);
+    return Math.max(header.length, maxDataWidth);
+  });
+  const headerLine = headers.map((h, i) => padString(h, widths[i] ?? 0)).join("  ");
+  console.log(chalk.bold(headerLine));
+  console.log(
+    chalk.dim(
+      widths.map((w) => "\u2500".repeat(w)).join("\u2500\u2500")
+    )
+  );
+  for (const row of rows) {
+    const rowLine = row.map((cell, i) => padString(cell, widths[i] ?? 0)).join("  ");
+    console.log(rowLine);
+  }
+}
+export {
+  formatBoolean,
+  formatDate,
+  formatDuration,
+  formatRelativeDate,
+  formatStatus,
+  getOutputOptions,
+  isJsonOutput,
+  maskString,
+  printBlank,
+  printError,
+  printHeader,
+  printInfo,
+  printJson,
+  printLabel,
+  printSimpleTable,
+  printSuccess,
+  printTable,
+  printWarning,
+  setOutputOptions,
+  truncate
+};
+//# sourceMappingURL=output.js.map

package/dist/utils/sdk-factory.js

@@ -0,0 +1,46 @@
+import { ChanlSDK } from "@protoboxai/sdk";
+import { configStore } from "./config-store.js";
+import { printError } from "./output.js";
+function createSdk() {
+  const apiKey = configStore.getApiKey();
+  const jwtToken = configStore.getJwtToken();
+  const baseUrl = configStore.getBaseUrl();
+  if (!apiKey && !jwtToken) {
+    printError("Not authenticated", "Run 'chanl login' to authenticate");
+    process.exitCode = 1;
+    return null;
+  }
+  const deployment = configStore.getDeployment();
+  const apiPrefix = configStore.getApiPrefix();
+  if (apiKey) {
+    if (apiKey.startsWith("eyJ")) {
+      return new ChanlSDK({
+        jwtToken: apiKey,
+        baseUrl,
+        deployment,
+        apiPrefix
+      });
+    }
+    return new ChanlSDK({ apiKey, baseUrl, deployment, apiPrefix });
+  }
+  return new ChanlSDK({
+    jwtToken,
+    baseUrl,
+    deployment,
+    apiPrefix
+  });
+}
+function getWorkspaceId() {
+  const workspaceId = configStore.getWorkspaceId();
+  if (!workspaceId) {
+    printError("No workspace selected", "Run 'chanl config set workspaceId <id>' to select a workspace");
+    process.exitCode = 1;
+    return null;
+  }
+  return workspaceId;
+}
+export {
+  createSdk,
+  getWorkspaceId
+};
+//# sourceMappingURL=sdk-factory.js.map

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@protoboxai/cli",
+  "version": "1.0.0",
+  "description": "Command-line interface for Protobox — MCP, tools, knowledge, agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "protobox": "./bin/protobox.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "protobox",
+    "cli",
+    "mcp",
+    "ai-agents",
+    "api",
+    "command-line"
+  ],
+  "author": "Protobox",
+  "license": "MIT",
+  "dependencies": {
+    "@protoboxai/sdk": "workspace:*",
+    "@inquirer/prompts": "^7.10.1",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "conf": "^13.0.1",
+    "inquirer": "^12.2.0",
+    "open": "^11.0.0",
+    "ora": "^8.1.1"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^22.10.2",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}