@whiteroom-ai/cli 1.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+import { WhiteRoomClient, WhiteRoomError } from "@whiteroom-ai/sdk";
+const USAGE = `whiteroom — CLI for WhiteRoom agent governance
+
+Usage:
+  whiteroom health
+  whiteroom register <agent_id> [--fleet <id>] [--role <role>]
+  whiteroom pair <agent_a> <agent_b> [--fleet <id>]
+  whiteroom auto-pair [--fleet <id>]
+  whiteroom start <agent_id> [--fleet <id>]
+  whiteroom task <agent_id> <task_name> [--minutes <n>] [--tokens <n>] [--fleet <id>]
+  whiteroom check <agent_id> [--fleet <id>]
+  whiteroom handover <from_agent> <to_agent> [--fleet <id>]
+  whiteroom alarm <agent_id> [--fleet <id>]
+  whiteroom report [--fleet <id>]
+  whiteroom fleets
+  whiteroom login <fleet_token>
+
+Options:
+  --url <base_url>   Server URL (default: WHITEROOM_URL or http://localhost:3000)
+  --key <api_key>    API key (default: WHITEROOM_API_KEY)
+`;
+function parseArgs(argv) {
+    const args = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i].startsWith("--") && i + 1 < argv.length) {
+            flags[argv[i].slice(2)] = argv[++i];
+        }
+        else {
+            args.push(argv[i]);
+        }
+    }
+    return { args, flags };
+}
+async function main() {
+    const { args, flags } = parseArgs(process.argv.slice(2));
+    const command = args[0];
+    if (!command || command === "help" || command === "--help") {
+        console.log(USAGE);
+        process.exit(0);
+    }
+    const client = new WhiteRoomClient({
+        baseUrl: flags.url ?? process.env.WHITEROOM_URL ?? "http://localhost:3000",
+        apiKey: flags.key ?? process.env.WHITEROOM_API_KEY,
+    });
+    try {
+        switch (command) {
+            case "health":
+                print(await client.health());
+                break;
+            case "register":
+                requireArg(args[1], "agent_id");
+                print(await client.registerAgent(args[1], { fleetId: flags.fleet, role: flags.role }));
+                break;
+            case "pair":
+                requireArg(args[1], "agent_a");
+                requireArg(args[2], "agent_b");
+                print(await client.pairAgents(args[1], args[2], flags.fleet));
+                break;
+            case "auto-pair":
+                print(await client.autoPair(flags.fleet));
+                break;
+            case "start":
+                requireArg(args[1], "agent_id");
+                print(await client.startWatch(args[1], flags.fleet));
+                break;
+            case "task":
+                requireArg(args[1], "agent_id");
+                requireArg(args[2], "task_name");
+                print(await client.completeTask(args[1], args[2], {
+                    fleetId: flags.fleet,
+                    minutesSpent: flags.minutes ? Number(flags.minutes) : undefined,
+                    tokensUsed: flags.tokens ? Number(flags.tokens) : undefined,
+                }));
+                break;
+            case "check":
+                requireArg(args[1], "agent_id");
+                print(await client.checkWatch(args[1], flags.fleet));
+                break;
+            case "handover":
+                requireArg(args[1], "from_agent");
+                requireArg(args[2], "to_agent");
+                print(await client.initiateHandover(args[1], args[2], { fleetId: flags.fleet }));
+                break;
+            case "alarm":
+                requireArg(args[1], "agent_id");
+                print(await client.fireAlarm(args[1], flags.fleet));
+                break;
+            case "report":
+                print(await client.fleetReport(flags.fleet));
+                break;
+            case "fleets":
+                print(await client.listFleets());
+                break;
+            case "login":
+                requireArg(args[1], "fleet_token");
+                print(await client.tokenLogin(args[1]));
+                break;
+            default:
+                console.error(`Unknown command: ${command}\n`);
+                console.log(USAGE);
+                process.exit(1);
+        }
+    }
+    catch (e) {
+        if (e instanceof WhiteRoomError) {
+            console.error(`Error ${e.status}: ${e.message}`);
+            process.exit(1);
+        }
+        throw e;
+    }
+}
+function requireArg(value, name) {
+    if (!value) {
+        console.error(`Missing required argument: <${name}>`);
+        process.exit(1);
+    }
+}
+function print(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;CAmBb,CAAC;AAEF,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,uBAAuB;QAC1E,MAAM,EAAE,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;KACnD,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,QAAQ;gBACX,KAAK,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7B,MAAM;YAER,KAAK,UAAU;gBACb,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;gBAChC,KAAK,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACvF,MAAM;YAER,KAAK,MAAM;gBACT,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;gBAC/B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;gBAC/B,KAAK,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC9D,MAAM;YAER,KAAK,WAAW;gBACd,KAAK,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC1C,MAAM;YAER,KAAK,OAAO;gBACV,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;gBAChC,KAAK,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;gBACrD,MAAM;YAER,KAAK,MAAM;gBACT,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;gBAChC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;gBACjC,KAAK,CACH,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE;oBAC1C,OAAO,EAAE,KAAK,CAAC,KAAK;oBACpB,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;oBAC/D,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;iBAC5D,CAAC,CACH,CAAC;gBACF,MAAM;YAER,KAAK,OAAO;gBACV,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;gBAChC,KAAK,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;gBACrD,MAAM;YAER,KAAK,UAAU;gBACb,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;gBAClC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;gBAChC,KAAK,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACjF,MAAM;YAER,KAAK,OAAO;gBACV,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;gBAChC,KAAK,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpD,MAAM;YAER,KAAK,QAAQ;gBACX,KAAK,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7C,MAAM;YAER,KAAK,QAAQ;gBACX,KAAK,CAAC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;gBACjC,MAAM;YAER,KAAK,OAAO;gBACV,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;gBACnC,KAAK,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxC,MAAM;YAER;gBACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;gBAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,cAAc,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,SAAU,CAAoB,CAAC,MAAM,KAAM,CAAoB,CAAC,OAAO,EAAE,CAAC,CAAC;YACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAyB,EAAE,IAAY;IACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,IAAa;IAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,IAAI,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@whiteroom-ai/cli",
+  "version": "1.1.0",
+  "description": "CLI for WhiteRoom — manage AI agent fleets from the terminal",
+  "type": "module",
+  "bin": {
+    "whiteroom": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsx src/index.ts"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@whiteroom-ai/sdk": "^1.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "tsx": "^4.19.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+import { WhiteRoomClient, WhiteRoomError } from "@whiteroom-ai/sdk";
+
+const USAGE = `whiteroom — CLI for WhiteRoom agent governance
+
+Usage:
+  whiteroom health
+  whiteroom register <agent_id> [--fleet <id>] [--role <role>]
+  whiteroom pair <agent_a> <agent_b> [--fleet <id>]
+  whiteroom auto-pair [--fleet <id>]
+  whiteroom start <agent_id> [--fleet <id>]
+  whiteroom task <agent_id> <task_name> [--minutes <n>] [--tokens <n>] [--fleet <id>]
+  whiteroom check <agent_id> [--fleet <id>]
+  whiteroom handover <from_agent> <to_agent> [--fleet <id>]
+  whiteroom alarm <agent_id> [--fleet <id>]
+  whiteroom report [--fleet <id>]
+  whiteroom fleets
+  whiteroom login <fleet_token>
+
+Options:
+  --url <base_url>   Server URL (default: WHITEROOM_URL or http://localhost:3000)
+  --key <api_key>    API key (default: WHITEROOM_API_KEY)
+`;
+
+function parseArgs(argv: string[]) {
+  const args: string[] = [];
+  const flags: Record<string, string> = {};
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i].startsWith("--") && i + 1 < argv.length) {
+      flags[argv[i].slice(2)] = argv[++i];
+    } else {
+      args.push(argv[i]);
+    }
+  }
+  return { args, flags };
+}
+
+async function main() {
+  const { args, flags } = parseArgs(process.argv.slice(2));
+  const command = args[0];
+
+  if (!command || command === "help" || command === "--help") {
+    console.log(USAGE);
+    process.exit(0);
+  }
+
+  const client = new WhiteRoomClient({
+    baseUrl: flags.url ?? process.env.WHITEROOM_URL ?? "http://localhost:3000",
+    apiKey: flags.key ?? process.env.WHITEROOM_API_KEY,
+  });
+
+  try {
+    switch (command) {
+      case "health":
+        print(await client.health());
+        break;
+
+      case "register":
+        requireArg(args[1], "agent_id");
+        print(await client.registerAgent(args[1], { fleetId: flags.fleet, role: flags.role }));
+        break;
+
+      case "pair":
+        requireArg(args[1], "agent_a");
+        requireArg(args[2], "agent_b");
+        print(await client.pairAgents(args[1], args[2], flags.fleet));
+        break;
+
+      case "auto-pair":
+        print(await client.autoPair(flags.fleet));
+        break;
+
+      case "start":
+        requireArg(args[1], "agent_id");
+        print(await client.startWatch(args[1], flags.fleet));
+        break;
+
+      case "task":
+        requireArg(args[1], "agent_id");
+        requireArg(args[2], "task_name");
+        print(
+          await client.completeTask(args[1], args[2], {
+            fleetId: flags.fleet,
+            minutesSpent: flags.minutes ? Number(flags.minutes) : undefined,
+            tokensUsed: flags.tokens ? Number(flags.tokens) : undefined,
+          })
+        );
+        break;
+
+      case "check":
+        requireArg(args[1], "agent_id");
+        print(await client.checkWatch(args[1], flags.fleet));
+        break;
+
+      case "handover":
+        requireArg(args[1], "from_agent");
+        requireArg(args[2], "to_agent");
+        print(await client.initiateHandover(args[1], args[2], { fleetId: flags.fleet }));
+        break;
+
+      case "alarm":
+        requireArg(args[1], "agent_id");
+        print(await client.fireAlarm(args[1], flags.fleet));
+        break;
+
+      case "report":
+        print(await client.fleetReport(flags.fleet));
+        break;
+
+      case "fleets":
+        print(await client.listFleets());
+        break;
+
+      case "login":
+        requireArg(args[1], "fleet_token");
+        print(await client.tokenLogin(args[1]));
+        break;
+
+      default:
+        console.error(`Unknown command: ${command}\n`);
+        console.log(USAGE);
+        process.exit(1);
+    }
+  } catch (e) {
+    if (e instanceof WhiteRoomError) {
+      console.error(`Error ${(e as WhiteRoomError).status}: ${(e as WhiteRoomError).message}`);
+      process.exit(1);
+    }
+    throw e;
+  }
+}
+
+function requireArg(value: string | undefined, name: string): asserts value is string {
+  if (!value) {
+    console.error(`Missing required argument: <${name}>`);
+    process.exit(1);
+  }
+}
+
+function print(data: unknown) {
+  console.log(JSON.stringify(data, null, 2));
+}
+
+main();

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}