@rupayan10/aios-cli 0.1.3 → 0.1.5

package/dist/cli.js

@@ -3518,7 +3518,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@rupayan10/aios-cli",
-      version: "0.1.3",
+      version: "0.1.5",
       description: "FlowScale AIOS command-line interface",
       license: "AGPL-3.0-only",
       bin: {
@@ -5541,6 +5541,10 @@ var init_render = __esm({
 // src/commands/gpu.ts
 function registerGpu(program2) {
   const gpu = program2.command("gpu").description("GPU management");
+  gpu.addHelpText("after", `
+Examples:
+  $ aios gpu list
+  $ aios gpu detect --json       force re-detection (clears the cache)`);
   function printGpus(gpus, json) {
     if (json) {
       process.stdout.write(renderJson(gpus) + "\n");
@@ -8896,8 +8900,8 @@ var require_adm_zip = __commonJS({
         return null;
       }
       function fixPath(zipPath) {
-        const { join: join4, normalize: normalize2, sep } = pth.posix;
-        return join4(pth.isAbsolute(zipPath) ? "/" : ".", normalize2(sep + zipPath.split("\\").join(sep) + sep));
+        const { join: join5, normalize: normalize2, sep } = pth.posix;
+        return join5(pth.isAbsolute(zipPath) ? "/" : ".", normalize2(sep + zipPath.split("\\").join(sep) + sep));
       }
       function filenameFilter(filterfn) {
         if (filterfn instanceof RegExp) {
@@ -10123,6 +10127,16 @@ function collectInput(val, acc) {
 }
 function registerTools(program2) {
   const tools = program2.command("tools").description("Tool management");
+  tools.addHelpText("after", `
+Examples:
+  $ aios tools build flux.json --name "Flux Dev" --instance auto
+  $ aios tools build wf.json --inputs 6__text --outputs 9__images    keep only a subset
+  $ aios tools list --json
+  $ aios tools run <id> --input 6__text="a cat" --input 4__image=@cat.png --instance auto
+  $ aios tools show <executionId>
+
+ComfyUI inputs are keyed <nodeId>__<paramName> (e.g. 6__text); plugin inputs use api__<paramName>.
+Prefix a value with @ to upload a local file (e.g. --input 4__image=@photo.png).`);
   const build = tools.command("build").description("Create a tool from a ComfyUI workflow JSON file").argument("<workflow.json>", "path to a ComfyUI workflow JSON file").option("--name <name>", "tool name (defaults to the filename)").option("--instance <id>", "a running instance to resolve widget names via /object_info").option("--inputs <keys>", "comma-separated nodeId__param input keys to keep (default: all)").option("--outputs <keys>", "comma-separated output keys to keep (default: all)").option("--json", "machine-readable JSON output");
   build.action(async (file) => {
     const o2 = build.opts();
@@ -10669,6 +10683,13 @@ var init_comfy_logs = __esm({
 // src/commands/comfy.ts
 function registerComfy(program2) {
   const comfy = program2.command("comfy").description("ComfyUI instance management");
+  comfy.addHelpText("after", `
+Examples:
+  $ aios comfy detect            generate instance configs from detected GPUs
+  $ aios comfy status            which instances are alive
+  $ aios comfy start gpu-0       start one instance (omit id to start all)
+  $ aios comfy logs gpu-0 -n 100
+  $ aios comfy stop gpu-0`);
   const status = comfy.command("status").description("Show ComfyUI instance status").option("--json", "machine-readable JSON output");
   status.action(() => {
     const json = Boolean(status.opts().json);
@@ -10803,6 +10824,10 @@ var init_model_scanner = __esm({
 // src/commands/models.ts
 function registerModels(program2) {
   const models = program2.command("models").description("Local model management");
+  models.addHelpText("after", `
+Examples:
+  $ aios models scan --instance auto             HTTP-scan a running instance
+  $ aios models list --type checkpoint --json`);
   const scan = models.command("scan").description("Scan a running ComfyUI instance for models").requiredOption("--instance <id>", 'instance id or "auto"').option("--json", "machine-readable JSON output");
   scan.action(async () => {
     const o2 = scan.opts();
@@ -10851,6 +10876,12 @@ var init_models = __esm({
 // src/commands/plugins.ts
 function registerPlugins(program2) {
   const plugins = program2.command("plugins").description("API-engine tool plugin management");
+  plugins.addHelpText("after", `
+Examples:
+  $ aios plugins install flux1-lora-trainer       from the FlowScale registry
+  $ aios plugins import ./my-plugin               local dir or a GitHub URL
+  $ aios plugins start flux1-lora-trainer
+  $ aios tools run flux1-lora-trainer-builtin --input api__prompt="a cat" --start`);
   const list = plugins.command("list").description("List locally installed tool plugins").option("--json", "machine-readable JSON output");
   list.action(() => {
     const o2 = list.opts();
@@ -11033,6 +11064,11 @@ var init_open_file = __esm({
 // src/commands/assets.ts
 function registerAssets(program2) {
   const assets = program2.command("assets").description("Saved execution outputs (assets)");
+  assets.addHelpText("after", `
+Examples:
+  $ aios assets list --tool <id> --json
+  $ aios assets show <executionId>
+  $ aios assets open <executionId>               open the first output in your viewer`);
   const list = assets.command("list").description("List completed execution outputs resolved to disk").option("--tool <id>", "filter by tool id").option("--json", "machine-readable JSON output");
   list.action(() => {
     const o2 = list.opts();
@@ -11102,6 +11138,113 @@ var init_assets2 = __esm({
   }
 });
 
+// src/core-ext/config.ts
+function getConfigSummary() {
+  return {
+    comfyui: {
+      path: getComfyManagedPath() ?? null,
+      installType: getComfyInstallType() ?? null,
+      managedPort: getComfyManagedPort()
+    },
+    providers: listProviders().map((p) => ({ name: p.name, configured: p.configured, docsUrl: p.docsUrl }))
+  };
+}
+function isProviderName(name) {
+  return ALL_PROVIDER_NAMES.includes(name);
+}
+var init_config = __esm({
+  "src/core-ext/config.ts"() {
+    "use strict";
+    init_provider_settings();
+  }
+});
+
+// src/commands/config.ts
+function registerConfig(program2) {
+  const config = program2.command("config").description("View and set CLI configuration (~/.flowscale/aios)");
+  config.addHelpText("after", `
+Examples:
+  $ aios config show
+  $ aios config show --json
+  $ aios config comfyui-path ~/ComfyUI                 point the CLI at a ComfyUI install
+  $ aios config provider-key fal sk-...                set a cloud provider key
+  $ aios config provider-key replicate --unset         remove a key
+
+Providers: ${ALL_PROVIDER_NAMES.join(", ")}. Keys are stored in ~/.flowscale/aios/provider-keys.json and never printed.`);
+  const show = config.command("show").description("Show current config (provider keys are masked)").option("--json", "machine-readable JSON output");
+  show.action(() => {
+    const o2 = show.opts();
+    const summary = getConfigSummary();
+    if (o2.json) {
+      process.stdout.write(renderJson(summary) + "\n");
+      return;
+    }
+    process.stdout.write(`ComfyUI path:  ${summary.comfyui.path ?? "(unset)"}
+`);
+    process.stdout.write(`Install type:  ${summary.comfyui.installType ?? "(unset)"}
+`);
+    process.stdout.write(`Managed port:  ${summary.comfyui.managedPort}
+
+`);
+    process.stdout.write("Provider keys:\n");
+    for (const p of summary.providers) {
+      process.stdout.write(`  ${p.name.padEnd(12)} ${p.configured ? "set" : "\u2014"}
+`);
+    }
+  });
+  const comfyPath = config.command("comfyui-path").description("Set the ComfyUI installation path the CLI manages").argument("<path>", "path to a ComfyUI install (the dir containing main.py)");
+  comfyPath.action((p) => {
+    if (!(0, import_node_fs6.existsSync)(p)) {
+      process.stderr.write(`Path does not exist: ${p}
+`);
+      process.exitCode = 1;
+      return;
+    }
+    if (!(0, import_node_fs6.existsSync)((0, import_node_path3.join)(p, "main.py"))) {
+      process.stderr.write(`Warning: no main.py in ${p} \u2014 is this a ComfyUI install?
+`);
+    }
+    setComfyManagedPath(p);
+    process.stdout.write(`ComfyUI path set to ${p}
+`);
+  });
+  const providerKey = config.command("provider-key").description("Set or unset a cloud provider API key").argument("<provider>", `one of: ${ALL_PROVIDER_NAMES.join(", ")}`).argument("[key]", "the API key (omit when using --unset)").option("--unset", "remove the key instead of setting it");
+  providerKey.action((provider, key) => {
+    const o2 = providerKey.opts();
+    if (!isProviderName(provider)) {
+      process.stderr.write(`Unknown provider: ${provider}. Valid: ${ALL_PROVIDER_NAMES.join(", ")}
+`);
+      process.exitCode = 1;
+      return;
+    }
+    if (o2.unset) {
+      deleteProviderKey(provider);
+      process.stdout.write(`Removed ${provider} key
+`);
+      return;
+    }
+    if (!key) {
+      process.stderr.write("Provide a key, or use --unset to remove it\n");
+      process.exitCode = 1;
+      return;
+    }
+    setProviderKey(provider, key);
+    process.stdout.write(`Set ${provider} key
+`);
+  });
+}
+var import_node_fs6, import_node_path3;
+var init_config2 = __esm({
+  "src/commands/config.ts"() {
+    "use strict";
+    import_node_fs6 = require("node:fs");
+    import_node_path3 = require("node:path");
+    init_provider_settings();
+    init_config();
+    init_render();
+  }
+});
+
 // node_modules/fast-string-truncated-width/dist/utils.js
 var getCodePointsLength, isFullWidth, isWideNotCJKTNotEmoji;
 var init_utils = __esm({
@@ -12254,6 +12397,17 @@ function buildProgram() {
   registerModels(program2);
   registerPlugins(program2);
   registerAssets(program2);
+  registerConfig(program2);
+  program2.addHelpText("after", `
+Examples:
+  $ aios                                              interactive menu (in a TTY)
+  $ aios gpu list                                     show detected GPUs
+  $ aios comfy detect && aios comfy start gpu-0       configure + launch an instance
+  $ aios tools build workflow.json --instance auto    build a tool from a workflow
+  $ aios tools run <toolId> --input 6__text="a cat" --instance auto
+  $ aios assets open <executionId>                    open the rendered output
+
+Add --json to most commands for scripting. Run \`aios help <command>\` for per-command examples.`);
   return program2;
 }
 async function main(argv) {
@@ -12282,6 +12436,7 @@ var init_cli = __esm({
     init_models();
     init_plugins();
     init_assets2();
+    init_config2();
     process.removeAllListeners("warning");
     process.on("warning", (w) => {
       if (w.name === "ExperimentalWarning" && /sqlite/i.test(w.message)) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rupayan10/aios-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "FlowScale AIOS command-line interface",
   "license": "AGPL-3.0-only",
   "bin": {