botworker 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BotWorker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# BotWorker CLI
+
+שוחח עם הבוטים שלך מ-[BotWorker](https://botworker.dev) ישירות מהטרמינל.
+
+## התקנה
+
+```bash
+npm install -g botworker
+```
+
+או הרצה חד-פעמית ללא התקנה:
+
+```bash
+npx botworker chat "שלום"
+```
+
+## התחברות
+
+ההתחברות מתבצעת עם שם + אימייל **@gmail.com**. נשלח קוד בן 6 תווים לאימייל:
+
+```bash
+botworker config --name "ישראל ישראלי"
+botworker config --email you@gmail.com   # שולח קוד 6 תווים לאימייל
+botworker login                          # הזן את הקוד מהמייל
+```
+
+לחלופין, התחברות ידנית עם API key מהדשבורד:
+
+```bash
+botworker config --api-key bw_live_xxxxxxxx
+```
+
+## שימוש
+
+```bash
+botworker bots                 # רשימת הבוטים שלך
+botworker use <BOT_ID>         # בחירת הבוט הפעיל
+botworker chat "מה השעות שלכם?" # שליחת הודעה אחת
+botworker                      # מצב שיחה אינטראקטיבי
+botworker whoami              # פרטי החשבון
+botworker logout             # ניתוק
+```
+
+## חיוב (Pay Per Use)
+
+כל בקשה צורכת קרדיטים מהמכסה של הבוט. כשנגמרים הקרדיטים תוחזר שגיאה `402` —
+ניתן להגדיל את המכסה ברכישת חבילת קרדיטים בדשבורד.
+
+## משתני סביבה
+
+- `BOTWORKER_API_BASE` — לשינוי כתובת ה-API (ברירת מחדל: שרת BotWorker).
+
+## הגדרות
+
+ההגדרות נשמרות מקומית ב-`~/.botworker/config.json` (הרשאות `600`).
+
+## רישיון
+
+MIT

package/bin/botworker.mjs

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+/**
+ * BotWorker CLI
+ * --------------
+ * Talk to your BotWorker bots from the terminal.
+ *
+ * Quick start:
+ *   npm install -g botworker
+ *   botworker config --name "Your Name"
+ *   botworker config --email you@gmail.com   # sends a 6-char code to your gmail
+ *   botworker login                          # paste the code from the email
+ *   botworker bots                           # list your bots
+ *   botworker use <BOT_ID>                   # pick the active bot
+ *   botworker chat "שלום, מה אתה יודע לעשות?"
+ *   botworker                                # interactive chat
+ */
+import readline from "node:readline";
+import { loadConfig, saveConfig, clearConfig, CONFIG_FILE } from "../lib/config.js";
+import { requestCode, verifyCode, listBots, chat } from "../lib/api.js";
+
+const GMAIL_RE = /@gmail\.com$/i;
+
+function ask(prompt, { hidden = false } = {}) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  if (hidden) {
+    const onData = (char) => {
+      const s = String(char);
+      if (s === "\n" || s === "\r" || s === "\u0004") process.stdout.write("\n");
+      else process.stdout.write("\u001b[2K\u001b[200D" + prompt + "*".repeat(rl.line.length));
+    };
+    process.stdin.on("data", onData);
+    return new Promise((res) =>
+      rl.question(prompt, (a) => {
+        process.stdin.removeListener("data", onData);
+        rl.close();
+        res(a);
+      }),
+    );
+  }
+  return new Promise((res) => rl.question(prompt, (a) => { rl.close(); res(a); }));
+}
+
+function parseFlags(args) {
+  const out = {};
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a.startsWith("--")) {
+      const key = a.slice(2);
+      const val = args[i + 1] && !args[i + 1].startsWith("--") ? args[++i] : true;
+      out[key] = val;
+    }
+  }
+  return out;
+}
+
+function requireAuth(cfg) {
+  if (!cfg.token) {
+    console.error("❌ אינך מחובר. הרץ: botworker config --email you@gmail.com ואז botworker login");
+    process.exit(1);
+  }
+}
+
+async function cmdConfig(cfg, rest) {
+  const flags = parseFlags(rest);
+  if (flags.name) cfg.name = String(flags.name);
+  if (flags["api-key"]) {
+    cfg.token = String(flags["api-key"]);
+    saveConfig(cfg);
+    console.log("✅ API key נשמר.");
+    return;
+  }
+  if (flags.email) {
+    const email = String(flags.email);
+    if (!GMAIL_RE.test(email)) {
+      console.error("❌ האימייל חייב להיות כתובת @gmail.com");
+      process.exit(1);
+    }
+    cfg.email = email;
+    saveConfig(cfg);
+    console.log(`📧 שולח קוד בן 6 תווים אל ${email} ...`);
+    const { ok, data } = await requestCode(cfg.name, email);
+    if (!ok) {
+      console.error("❌", (data && data.error) || "שליחת הקוד נכשלה");
+      process.exit(1);
+    }
+    console.log("✅ הקוד נשלח. הרץ עכשיו: botworker login");
+    return;
+  }
+  saveConfig(cfg);
+  console.log("✅ ההגדרות נשמרו ב-", CONFIG_FILE);
+  console.log({ name: cfg.name, email: cfg.email, botId: cfg.botId, connected: !!cfg.token });
+}
+
+async function cmdLogin(cfg) {
+  if (!cfg.email) {
+    console.error("❌ הגדר קודם אימייל: botworker config --email you@gmail.com");
+    process.exit(1);
+  }
+  const code = (await ask("🔑 הזן את הקוד בן 6 התווים מהמייל: ")).trim();
+  if (code.length !== 6) {
+    console.error("❌ הקוד חייב להיות בן 6 תווים.");
+    process.exit(1);
+  }
+  const { ok, data } = await verifyCode(cfg.email, code);
+  if (!ok || !data.token) {
+    console.error("❌", (data && data.error) || "אימות נכשל");
+    process.exit(1);
+  }
+  cfg.token = data.token;
+  saveConfig(cfg);
+  console.log("✅ התחברת בהצלחה! הרץ: botworker bots");
+}
+
+async function cmdBots(cfg) {
+  requireAuth(cfg);
+  const { ok, data } = await listBots(cfg.token);
+  if (!ok) {
+    console.error("❌", (data && data.error) || "טעינת הבוטים נכשלה");
+    process.exit(1);
+  }
+  const bots = data.bots || [];
+  if (!bots.length) {
+    console.log("אין לך בוטים זמינים עדיין.");
+    return;
+  }
+  console.log("\nהבוטים שלך:");
+  for (const b of bots) {
+    const active = b.id === cfg.botId ? " ←  פעיל" : "";
+    console.log(`  • ${b.name}  (${b.id})${active}`);
+  }
+  console.log("\nבחר בוט עם: botworker use <BOT_ID>\n");
+}
+
+function cmdUse(cfg, rest) {
+  const botId = (rest[0] || "").trim();
+  if (!botId) {
+    console.error('שימוש: botworker use <BOT_ID>');
+    process.exit(1);
+  }
+  cfg.botId = botId;
+  saveConfig(cfg);
+  console.log("✅ הבוט הפעיל הוא כעת:", botId);
+}
+
+async function send(cfg, message, history) {
+  requireAuth(cfg);
+  if (!cfg.botId) {
+    console.error("❌ לא נבחר בוט. הרץ: botworker bots ואז botworker use <BOT_ID>");
+    process.exit(1);
+  }
+  const { ok, status, data } = await chat(cfg.token, cfg.botId, message, history);
+  if (status === 402) {
+    console.error("⚠️  נגמרו הקרדיטים (Pay Per Use). קנה חבילת קרדיטים בדשבורד כדי להמשיך.");
+    process.exit(2);
+  }
+  if (status === 401) {
+    console.error("❌ פג תוקף ההתחברות. הרץ שוב: botworker login");
+    process.exit(1);
+  }
+  if (!ok || data.success === false) {
+    console.error("❌", (data && (data.error?.message || data.error)) || `HTTP ${status}`);
+    process.exit(1);
+  }
+  return String(data.reply || "");
+}
+
+async function cmdChat(cfg, rest) {
+  const message = rest.join(" ").trim();
+  if (!message) {
+    console.error('שימוש: botworker chat "ההודעה שלך"');
+    process.exit(1);
+  }
+  const reply = await send(cfg, message, []);
+  console.log("\n🤖 " + reply + "\n");
+}
+
+async function cmdInteractive(cfg) {
+  console.log("BotWorker CLI — מצב שיחה. הקלד 'exit' ליציאה.\n");
+  const history = [];
+  // eslint-disable-next-line no-constant-condition
+  while (true) {
+    const message = (await ask("👤 ")).trim();
+    if (!message || message === "exit" || message === "quit") break;
+    const reply = await send(cfg, message, history);
+    console.log("🤖 " + reply + "\n");
+    history.push({ role: "user", content: message });
+    history.push({ role: "assistant", content: reply });
+  }
+}
+
+function cmdHelp() {
+  console.log(`BotWorker CLI
+
+שימוש:
+  botworker config --name "Your Name"
+  botworker config --email you@gmail.com     שולח קוד בן 6 תווים לאימייל
+  botworker login                            הזנת הקוד וקבלת גישה
+  botworker config --api-key bw_live_xxx     התחברות ידנית עם API key
+  botworker bots                             רשימת הבוטים שלך
+  botworker use <BOT_ID>                     בחירת הבוט הפעיל
+  botworker chat "ההודעה שלך"                 שליחת הודעה אחת
+  botworker                                  מצב שיחה אינטראקטיבי
+  botworker whoami                           הצגת פרטי החשבון
+  botworker logout                           ניתוק ומחיקת ההגדרות
+`);
+}
+
+async function main() {
+  const [cmd, ...rest] = process.argv.slice(2);
+  const cfg = loadConfig();
+
+  switch (cmd) {
+    case "config":
+      return cmdConfig(cfg, rest);
+    case "login":
+      return cmdLogin(cfg);
+    case "bots":
+      return cmdBots(cfg);
+    case "use":
+      return cmdUse(cfg, rest);
+    case "chat":
+      return cmdChat(cfg, rest);
+    case "whoami":
+      console.log({ name: cfg.name, email: cfg.email, botId: cfg.botId, connected: !!cfg.token });
+      return;
+    case "logout":
+      clearConfig();
+      console.log("✅ התנתקת. ההגדרות נמחקו.");
+      return;
+    case "help":
+    case "--help":
+    case "-h":
+      return cmdHelp();
+    case undefined:
+      return cmdInteractive(cfg);
+    default:
+      console.error(`פקודה לא מוכרת: ${cmd}\n`);
+      return cmdHelp();
+  }
+}
+
+main().catch((e) => {
+  console.error("שגיאה:", e.message);
+  process.exit(1);
+});

package/lib/api.js

@@ -0,0 +1,46 @@
+const BASE =
+  process.env.BOTWORKER_API_BASE ||
+  "https://gvmrylxlzktfsuzznmbc.supabase.co/functions/v1";
+
+export const ENDPOINTS = {
+  authRequest: `${BASE}/cli-auth-request`,
+  authVerify: `${BASE}/cli-auth-verify`,
+  chat: `${BASE}/custom-bot-chat`,
+  bots: `${BASE}/cli-list-bots`,
+};
+
+async function call(url, body, token) {
+  const headers = { "Content-Type": "application/json" };
+  if (token) headers.Authorization = `Bearer ${token}`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(body || {}),
+  });
+  const data = await res.json().catch(() => ({}));
+  return { status: res.status, ok: res.ok, data };
+}
+
+/** Step 1: send a 6-character code to the user's gmail. */
+export function requestCode(name, email) {
+  return call(ENDPOINTS.authRequest, { name, email });
+}
+
+/** Step 2: verify the code and receive a CLI token. */
+export function verifyCode(email, code) {
+  return call(ENDPOINTS.authVerify, { email, code });
+}
+
+/** List the bots the authenticated user owns or rents. */
+export function listBots(token) {
+  return call(ENDPOINTS.bots, {}, token);
+}
+
+/** Send a chat message to a bot. */
+export function chat(token, botId, message, history) {
+  return call(
+    ENDPOINTS.chat,
+    { bot_id: botId, message, history: (history || []).slice(-8) },
+    token,
+  );
+}

package/lib/config.js

@@ -0,0 +1,32 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+export const CONFIG_DIR = path.join(os.homedir(), ".botworker");
+export const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+
+export function loadConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+export function saveConfig(cfg) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2));
+  try {
+    fs.chmodSync(CONFIG_FILE, 0o600);
+  } catch {
+    /* windows */
+  }
+}
+
+export function clearConfig() {
+  try {
+    fs.unlinkSync(CONFIG_FILE);
+  } catch {
+    /* noop */
+  }
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "botworker",
+  "version": "1.0.0",
+  "description": "BotWorker CLI — chat with your BotWorker bots straight from the terminal.",
+  "type": "module",
+  "bin": {
+    "botworker": "bin/botworker.mjs",
+    "BotWorker": "bin/botworker.mjs"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "botworker",
+    "cli",
+    "chatbot",
+    "ai",
+    "bot"
+  ],
+  "homepage": "https://botworker.dev",
+  "license": "MIT",
+  "scripts": {
+    "start": "node bin/botworker.mjs"
+  }
+}