@easybits.cloud/cli 0.11.0 → 0.12.0

package/README.md

@@ -119,6 +119,8 @@ easybits docs --open   # open the docs in your browser
 pass its name instead of the id (`easybits sb exec scratch -- ls`, `easybits domains ls shop`).
 The match is exact and case-insensitive; if two share the name the CLI exits 2 and lists the ids.
 
+Shell completion: `source <(easybits completion zsh)` (or `bash`, `fish`).
+
 Help and messages follow your locale (`LANG=es_*` → Spanish) or `--lang es|en`.
 
 Every command has help with examples: `easybits <command> <subcommand> --help`
@@ -161,6 +163,11 @@ Host *.ghosty
 
 Full reference: https://www.easybits.cloud/docs#cli · https://www.easybits.cloud/en/docs/cli.md
 
+## Changes in 0.12.0
+
+- `easybits completion zsh|bash|fish`: TAB completes commands, subcommands, flags and the names of
+  your agents, sandboxes and databases (cached 5 min in `~/.cache/easybits/`).
+
 ## Changes in 0.11.0
 
 - **Spanish or English, following your locale** (`LANG=es_*` → Spanish; otherwise English), or

package/dist/index.js

@@ -2957,6 +2957,130 @@ var agents = {
   }
 };
 
+// src/commands/completion.ts
+import { mkdirSync as mkdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync6 } from "fs";
+import { homedir as homedir4 } from "os";
+import { dirname as dirname3, join as join6 } from "path";
+var GLOBAL_FLAGS = ["--json", "--token", "--lang", "--help", "--version"];
+var AGENT_FLAGS = /* @__PURE__ */ new Set(["--agent", "--like"]);
+var findSub = (c, name) => Object.entries(c.subs ?? {}).find(([n, l]) => n === name || l.aliases?.includes(name));
+function completionFor(words, current2, commands) {
+  const names = commands.filter((c) => !c.name.startsWith("__")).map((c) => c.name);
+  const prev = words[words.length - 1];
+  if (prev && AGENT_FLAGS.has(prev)) return { kind: "names", ref: "agent" };
+  if (!words.length) return { kind: "words", words: [...names, "help"] };
+  const find = (n2) => commands.find((c) => c.name === n2 || c.aliases?.includes(n2));
+  const cmd = find(words[0]);
+  if (words[0] === "help") return { kind: "words", words: words.length === 1 ? names : Object.keys(find(words[1])?.subs ?? {}) };
+  if (!cmd) return { kind: "words", words: [] };
+  const sub = cmd.subs && words[1] ? findSub(cmd, words[1]) : void 0;
+  const leaf = sub?.[1] ?? cmd.leaf;
+  if (current2.startsWith("-")) {
+    const own = Object.keys(leaf?.options ?? {}).map((n2) => `--${n2}`);
+    return { kind: "words", words: [...own, ...GLOBAL_FLAGS] };
+  }
+  if (cmd.subs && !sub) return { kind: "words", words: words.length === 1 ? Object.keys(cmd.subs) : [] };
+  if (cmd.name === "completion") return { kind: "words", words: words.length === 1 ? ["zsh", "bash", "fish"] : [] };
+  const opts = leaf?.options ?? {};
+  let n = 0;
+  for (let i = sub ? 2 : 1; i < words.length; i++) {
+    const w = words[i];
+    if (w.startsWith("--")) {
+      const o = opts[w.slice(2)];
+      if ((o?.type === "string" || w === "--token" || w === "--lang") && !w.includes("=")) i++;
+      continue;
+    }
+    if (w.startsWith("-") && w !== "-") continue;
+    n++;
+  }
+  const spec = REF_ARGS[sub ? `${cmd.name} ${sub[0]}` : cmd.name];
+  if (spec && spec.index === n) return { kind: "names", ref: spec.kind };
+  return { kind: "words", words: [] };
+}
+var cacheFile = () => join6(process.env.XDG_CACHE_HOME || join6(homedir4(), ".cache"), "easybits", "complete.json");
+async function namesOf(ctx, kind) {
+  let cache2 = {};
+  try {
+    cache2 = JSON.parse(readFileSync10(cacheFile(), "utf8"));
+    const c = cache2[kind];
+    if (c && Date.now() - c.at < 5 * 6e4) return c.names;
+  } catch {
+  }
+  const names = [...new Set((await listRefs(ctx, kind)).map((x) => x.name).filter((x) => !!x))];
+  try {
+    mkdirSync5(dirname3(cacheFile()), { recursive: true });
+    writeFileSync6(cacheFile(), JSON.stringify({ ...cache2, [kind]: { at: Date.now(), names } }));
+  } catch {
+  }
+  return names;
+}
+async function completeCmd(args, commands) {
+  const rest = args[0] === "--" ? args.slice(1) : args;
+  const current2 = rest.length ? rest[rest.length - 1] : "";
+  const words = rest.slice(0, -1);
+  let out = [];
+  try {
+    const want = completionFor(words, current2, commands);
+    const ctx = { json: true, args: [], opts: {} };
+    out = want.kind === "words" ? want.words : await namesOf(ctx, want.ref);
+  } catch {
+    out = [];
+  }
+  const cur = current2.toLowerCase();
+  process.stdout.write(out.filter((w) => w.toLowerCase().startsWith(cur)).join("\n") + "\n");
+}
+function completionScript(shell) {
+  if (shell === "bash") {
+    return `# easybits \u2014 bash completion: eval "$(easybits completion bash)" en ~/.bashrc
+_easybits() {
+  # Las palabras ANTES de cambiar IFS: el bash 3.2 de macOS junta \${arr[@]:1:n} con un IFS propio.
+  local words=("\${COMP_WORDS[@]:1:COMP_CWORD-1}") cur="\${COMP_WORDS[COMP_CWORD]}"
+  local IFS=$'\\n'
+  COMPREPLY=( $(easybits __complete -- "\${words[@]}" "$cur" 2>/dev/null) )
+}
+complete -o default -F _easybits easybits
+`;
+  }
+  if (shell === "zsh") {
+    return `#compdef easybits
+# easybits \u2014 zsh completion: source <(easybits completion zsh) en ~/.zshrc (despu\xE9s de compinit)
+_easybits() {
+  local -a opts
+  opts=("\${(@f)$(easybits __complete -- "\${(@)words[2,CURRENT-1]}" "\${words[CURRENT]}" 2>/dev/null)}")
+  compadd -a opts
+}
+compdef _easybits easybits
+`;
+  }
+  if (shell === "fish") {
+    return `# easybits \u2014 fish completion: easybits completion fish > ~/.config/fish/completions/easybits.fish
+complete -c easybits -f -a "(easybits __complete -- (commandline -opc)[2..-1] (commandline -ct) 2>/dev/null)"
+`;
+  }
+  return null;
+}
+var completion = {
+  name: "completion",
+  group: "Help",
+  summary: "Shell completion script (zsh, bash, fish)",
+  synopsis: "completion <shell>",
+  leaf: {
+    summary: "Print the completion script for your shell: commands, flags and your agents, sandboxes and databases",
+    usage: "easybits completion <zsh|bash|fish>",
+    examples: [
+      "source <(easybits completion zsh)                  # add to ~/.zshrc, after compinit",
+      'eval "$(easybits completion bash)"                 # add to ~/.bashrc',
+      "easybits completion fish > ~/.config/fish/completions/easybits.fish"
+    ],
+    async run(ctx) {
+      const shell = need(ctx, 0, "zsh|bash|fish", this.usage);
+      const script = completionScript(shell);
+      if (!script) throw usageError(t(`Unknown shell "${shell}".`, `Shell desconocido "${shell}".`), this.usage);
+      process.stdout.write(script);
+    }
+  }
+};
+
 // src/commands/docs.ts
 import { spawn as spawn2 } from "child_process";
 import { resolveBaseUrl as resolveBaseUrl5 } from "@easybits.cloud/sdk";
@@ -3005,15 +3129,15 @@ var docs = {
 
 // src/commands/doctor.ts
 import { existsSync as existsSync10, statSync as statSync5 } from "fs";
-import { homedir as homedir5 } from "os";
-import { join as join7 } from "path";
+import { homedir as homedir6 } from "os";
+import { join as join8 } from "path";
 import { resolveBaseUrl as resolveBaseUrl6 } from "@easybits.cloud/sdk";
 
 // src/update.ts
-import { mkdirSync as mkdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync6 } from "fs";
-import { homedir as homedir4 } from "os";
-import { dirname as dirname3, join as join6 } from "path";
-var FILE = join6(process.env.XDG_CONFIG_HOME || join6(homedir4(), ".config"), "easybits", "update.json");
+import { mkdirSync as mkdirSync6, readFileSync as readFileSync11, writeFileSync as writeFileSync7 } from "fs";
+import { homedir as homedir5 } from "os";
+import { dirname as dirname4, join as join7 } from "path";
+var FILE = join7(process.env.XDG_CONFIG_HOME || join7(homedir5(), ".config"), "easybits", "update.json");
 var DAY = 24 * 60 * 60 * 1e3;
 var UPGRADE = "npm i -g @easybits.cloud/cli@latest";
 function newer(a, b) {
@@ -3025,7 +3149,7 @@ function newer(a, b) {
 var updateCheckDisabled = () => Boolean(process.env.EASYBITS_NO_UPDATE_CHECK || process.env.CI);
 function readCache() {
   try {
-    return JSON.parse(readFileSync10(FILE, "utf8"));
+    return JSON.parse(readFileSync11(FILE, "utf8"));
   } catch {
     return {};
   }
@@ -3035,8 +3159,8 @@ async function fetchLatest(timeoutMs = 1500) {
     const r = await fetch("https://registry.npmjs.org/@easybits.cloud/cli/latest", { signal: AbortSignal.timeout(timeoutMs) });
     const latest = (await r.json()).version;
     if (!latest) return null;
-    mkdirSync5(dirname3(FILE), { recursive: true });
-    writeFileSync6(FILE, JSON.stringify({ latest, checkedAt: Date.now() }));
+    mkdirSync6(dirname4(FILE), { recursive: true });
+    writeFileSync7(FILE, JSON.stringify({ latest, checkedAt: Date.now() }));
     return latest;
   } catch {
     return null;
@@ -3060,7 +3184,7 @@ async function updateNotice(current2) {
 }
 
 // src/commands/doctor.ts
-var VERSION = true ? "0.11.0" : "dev";
+var VERSION = true ? "0.12.0" : "dev";
 var doctor2 = {
   name: "doctor",
   group: "Account",
@@ -3103,7 +3227,7 @@ var doctor2 = {
           checks.push({ check: "credential-env", ok: true, detail: t("EASYBITS_API_KEY wins over the saved login in ~/.easybitsrc", "EASYBITS_API_KEY le gana a la sesi\xF3n guardada en ~/.easybitsrc") });
         }
       }
-      const rcPath = join7(homedir5(), ".easybitsrc");
+      const rcPath = join8(homedir6(), ".easybitsrc");
       if (existsSync10(rcPath)) {
         const mode = statSync5(rcPath).mode & 511;
         const ok2 = (mode & 63) === 0;
@@ -3142,7 +3266,8 @@ var COMMANDS = [
   mcp,
   sshKey,
   sshProxy,
-  docs
+  docs,
+  completion
 ];
 function findCommand(name) {
   return COMMANDS.find((c) => c.name === name || c.aliases?.includes(name));
@@ -3337,7 +3462,11 @@ var HELP_ES = {
   "Help": "Ayuda",
   "Print the docs URL, or a docs section as markdown": "Imprime la URL de los docs, o una secci\xF3n de los docs en markdown",
   "English docs": "Docs en ingl\xE9s",
-  "Open the docs in your browser": "Abre los docs en tu navegador"
+  "Open the docs in your browser": "Abre los docs en tu navegador",
+  "Shell completion script (zsh, bash, fish)": "Script de autocompletado para tu shell (zsh, bash, fish)",
+  "Print the completion script for your shell: commands, flags and your agents, sandboxes and databases": "Imprime el script de autocompletado de tu shell: comandos, flags y tus agentes, sandboxes y bases",
+  "add to ~/.zshrc, after compinit": "agr\xE9galo a ~/.zshrc, despu\xE9s de compinit",
+  "add to ~/.bashrc": "agr\xE9galo a ~/.bashrc"
 };
 
 // src/help.ts
@@ -3528,7 +3657,7 @@ function normalizeArgs(input) {
 }
 
 // src/index.ts
-var VERSION2 = true ? "0.11.0" : "dev";
+var VERSION2 = true ? "0.12.0" : "dev";
 var GLOBAL_OPTIONS = {
   json: { type: "boolean" },
   token: { type: "string" },
@@ -3572,7 +3701,7 @@ function parse(argv2, skip, leaf) {
     throw usageError(e.message.split("\n")[0].split(". To specify")[0].replace(/\.?$/, "."), leaf?.usage);
   }
 }
-function findSub(cmd, name) {
+function findSub2(cmd, name) {
   return Object.entries(cmd.subs ?? {}).find(([n, l]) => n === name || l.aliases?.includes(name));
 }
 function unknownCommand(name) {
@@ -3586,7 +3715,7 @@ ${t("Run", "Corre")}: easybits --help`;
 function unknownSub(cmd, name) {
   const e = usageError(t(`Unknown subcommand "${cmd.name} ${name}".`, `Subcomando desconocido "${cmd.name} ${name}".`), `easybits ${cmd.name} <${Object.keys(cmd.subs ?? {}).join("|")}>`);
   const names = Object.entries(cmd.subs ?? {}).flatMap(([n, l]) => [n, ...l.aliases ?? []]);
-  const hint = didYouMean(name, names, `easybits ${cmd.name} `, (n) => findSub(cmd, n)?.[0] ?? n);
+  const hint = didYouMean(name, names, `easybits ${cmd.name} `, (n) => findSub2(cmd, n)?.[0] ?? n);
   if (hint) e.hint = `${localHint(hint)}
 ${e.hint}`;
   return e;
@@ -3600,6 +3729,7 @@ function aliasNote([en, es]) {
 }
 var localHint = (hint) => hint.replace("Did you mean this?", t("Did you mean this?", "\xBFQuisiste decir esto?"));
 async function main(input) {
+  if (input[0] === "__complete") return completeCmd(input.slice(1), COMMANDS);
   const { argv: argv2, notes } = normalizeArgs(input);
   if (!wantsJson(argv2)) notes.forEach(aliasNote);
   const pos = positionalIndexes(argv2);
@@ -3609,7 +3739,7 @@ async function main(input) {
     const topic = topicName ? findCommand(topicName) : void 0;
     if (topicName && !topic) throw unknownCommand(topicName);
     const subName = topic?.subs && pos[2] != null ? argv2[pos[2]] : void 0;
-    const sub = topic && subName ? findSub(topic, subName) : void 0;
+    const sub = topic && subName ? findSub2(topic, subName) : void 0;
     if (topic && subName && !sub) throw unknownSub(topic, subName);
     const { values: values2 } = parse(argv2, pos.slice(0, sub ? 3 : 2), void 0);
     if (values2.version) {
@@ -3635,7 +3765,7 @@ async function main(input) {
   const skip = [pos[0]];
   if (cmd.subs) {
     const subName = pos[1] != null ? argv2[pos[1]] : void 0;
-    const entry = subName ? findSub(cmd, subName) : void 0;
+    const entry = subName ? findSub2(cmd, subName) : void 0;
     if (entry) {
       leaf = entry[1];
       subKey = entry[0];
@@ -3682,7 +3812,7 @@ async function main(input) {
 }
 var argv = process.argv.slice(2);
 setLang(detectLang(langFlag(argv)));
-var notice = process.stderr.isTTY && !wantsJson(argv) && !argv.includes("doctor") ? updateNotice(VERSION2) : null;
+var notice = process.stderr.isTTY && !wantsJson(argv) && !argv.includes("doctor") && argv[0] !== "__complete" ? updateNotice(VERSION2) : null;
 main(argv).catch((err) => {
   const e = toCliError(err);
   const latest = e.code === "usage" ? cachedNewer(VERSION2) : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easybits.cloud/cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Official CLI for EasyBits, the cloud for AI agents — sandboxes, hosting, domains, databases, agents and files from your terminal",
   "type": "module",
   "bin": {