gambi 0.2.3

package/README.md

@@ -0,0 +1 @@
+# `gambi`

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "gambi",
+  "version": "0.2.3",
+  "description": "CLI for Gambi - Share local LLMs across your network",
+  "keywords": [
+    "llm",
+    "openresponses",
+    "open-responses",
+    "ollama",
+    "ai",
+    "cli",
+    "local-ai",
+    "local-llm",
+    "lm-studio"
+  ],
+  "author": "Arthur BM",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arthurbm/gambi.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/arthurbm/gambi",
+  "bugs": "https://github.com/arthurbm/gambi/issues",
+  "type": "module",
+  "bin": {
+    "gambi": "./src/cli.ts"
+  },
+  "exports": {
+    "./serve": "./src/commands/serve.ts",
+    "./create": "./src/commands/create.ts",
+    "./join": "./src/commands/join.ts",
+    "./list": "./src/commands/list.ts",
+    "./monitor": "./src/commands/monitor.ts"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "bun run src/cli.ts",
+    "build": "bun run build.ts",
+    "check-types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "@gambi/core": "workspace:*",
+    "clipanion": "^4.0.0-rc.4",
+    "nanoid": "^5.1.5"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env bun
+import { Builtins, Cli } from "./utils/option.ts";
+import { CreateCommand } from "./commands/create.ts";
+import { JoinCommand } from "./commands/join.ts";
+import { ListCommand } from "./commands/list.ts";
+import { MonitorCommand } from "./commands/monitor.ts";
+import { ServeCommand } from "./commands/serve.ts";
+
+const cli = new Cli({
+  binaryLabel: "gambi",
+  binaryName: "gambi",
+  binaryVersion: "0.0.1",
+});
+
+cli.register(ServeCommand);
+cli.register(CreateCommand);
+cli.register(JoinCommand);
+cli.register(ListCommand);
+cli.register(MonitorCommand);
+cli.register(Builtins.HelpCommand);
+cli.register(Builtins.VersionCommand);
+
+// TODO: Re-add TUI support as a separate optional package.
+// Previously, running `gambi` with no args launched the TUI,
+// but bundling OpenTUI + React inflated the binary from ~50MB to ~110MB.
+// See: https://github.com/arthurbm/gambi/issues — create issue for TUI separation
+const args = process.argv.slice(2);
+if (args.length === 0) {
+  cli.runExit(["--help"]);
+} else {
+  cli.runExit(args);
+}

package/src/commands/create.ts

@@ -0,0 +1,160 @@
+import { intro, outro, password as passwordPrompt, text } from "@clack/prompts";
+import { Command, Option } from "../utils/option.ts";
+import { handleCancel, isInteractive } from "../utils/prompt.ts";
+import {
+  hasRuntimeConfig,
+  loadRuntimeConfigFile,
+  promptRuntimeConfig,
+} from "../utils/runtime-config.ts";
+
+interface CreateRoomResponse {
+  room: {
+    id: string;
+    code: string;
+    name: string;
+    hostId: string;
+    createdAt: number;
+  };
+  hostId: string;
+}
+
+interface ErrorResponse {
+  error: string;
+}
+
+export class CreateCommand extends Command {
+  static override paths = [["create"]];
+
+  static override usage = Command.Usage({
+    description: "Create a new room on a hub",
+    examples: [
+      ["Create a room (interactive)", "gambi create"],
+      ["Create a room", "gambi create --name 'My Room'"],
+      [
+        "Create on custom hub",
+        "gambi create --name 'My Room' --hub http://192.168.1.10:3000",
+      ],
+      [
+        "Create a password-protected room",
+        "gambi create --name 'My Room' --password secret123",
+      ],
+    ],
+  });
+
+  name = Option.String("--name,-n", {
+    description: "Room name",
+    required: false,
+  });
+
+  password = Option.String("--password,-p", {
+    description: "Optional password to protect the room",
+    required: false,
+  });
+
+  configPath = Option.String("--config", {
+    description: "Path to a JSON file with room defaults",
+    required: false,
+  });
+
+  hub = Option.String("--hub,-H", "http://localhost:3000", {
+    description: "Hub URL",
+  });
+
+  async execute(): Promise<number> {
+    let name = this.name;
+    let password = this.password;
+    let defaults = this.configPath
+      ? await loadRuntimeConfigFile(this.configPath).catch((error) => {
+          this.context.stderr.write(`${error}\n`);
+          return null;
+        })
+      : {};
+
+    if (defaults === null) {
+      return 1;
+    }
+
+    if (!name && isInteractive()) {
+      intro("gambi create");
+
+      const nameResult = await text({
+        message: "Room name:",
+        validate: (v) => (v ? undefined : "Room name is required"),
+      });
+      handleCancel(nameResult);
+      name = nameResult as string;
+
+      if (password === undefined) {
+        const passwordResult = await passwordPrompt({
+          message: "Room password (leave empty for no password):",
+        });
+        handleCancel(passwordResult);
+        const pwd = passwordResult as string;
+        if (pwd) {
+          password = pwd;
+        }
+      }
+
+      try {
+        defaults = await promptRuntimeConfig("room", defaults);
+      } catch (error) {
+        this.context.stderr.write(`${error}\n`);
+        return 1;
+      }
+    } else if (!name) {
+      this.context.stderr.write(
+        "Error: --name is required (or run in a terminal for interactive mode)\n"
+      );
+      return 1;
+    }
+
+    try {
+      const body: {
+        defaults?: typeof defaults;
+        name: string;
+        password?: string;
+      } = { name };
+      if (password) {
+        body.password = password;
+      }
+      if (hasRuntimeConfig(defaults)) {
+        body.defaults = defaults;
+      }
+
+      const response = await fetch(`${this.hub}/rooms`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+      });
+
+      if (!response.ok) {
+        const data = (await response.json()) as ErrorResponse;
+        this.context.stderr.write(`Error: ${data.error}\n`);
+        return 1;
+      }
+
+      const data = (await response.json()) as CreateRoomResponse;
+
+      const successMsg = [
+        "Room created!",
+        `  Code: ${data.room.code}`,
+        `  ID: ${data.room.id}`,
+        ...(password ? ["  Protection: Password-protected"] : []),
+        "",
+        "Share the code with participants to join.",
+      ].join("\n");
+
+      if (isInteractive() && !this.name) {
+        outro(successMsg);
+      } else {
+        this.context.stdout.write(`${successMsg}\n`);
+      }
+
+      return 0;
+    } catch (err) {
+      this.context.stderr.write(`Failed to connect to hub at ${this.hub}\n`);
+      this.context.stderr.write(`${err}\n`);
+      return 1;
+    }
+  }
+}