@2kw/ai 6.3.0-dev.2 → 6.3.0-dev.3

package/dist/commands/relays.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeRelaysCommand(): Command;
+//# sourceMappingURL=relays.d.ts.map

package/dist/commands/relays.js

@@ -0,0 +1,135 @@
+import { Command } from "commander";
+import { getClient, runAction } from "../lib/client.js";
+import { isJsonOutput } from "../lib/config.js";
+import { formatDetail, formatPage, formatSuccess } from "../lib/output.js";
+import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+/**
+ * Prints an enrolment response in text mode. The relay record comes first when the response
+ * carries one: `create` is the only place the new relay's id is ever shown, and every other
+ * subcommand takes that id as its argument.
+ */
+function printEnrolment(data, command) {
+    if (isJsonOutput(command)) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    if (data.relay) {
+        formatDetail(data.relay, command);
+        console.log("");
+    }
+    console.log(data.enrolmentExpiresAt
+        ? `Enrolment token (shown once, valid until ${data.enrolmentExpiresAt}):`
+        : "Enrolment token (shown once):");
+    console.log(`  ${data.enrolmentToken ?? ""}`);
+    console.log("");
+    console.log("Run the relay inside your network:");
+    console.log(data.dockerRun ?? "");
+}
+export function makeRelaysCommand() {
+    const cmd = new Command("relays").description("Manage MCP relays that reach MCP servers on private networks");
+    const list = new Command("list").description("List MCP relays");
+    addPaginationOptions(list);
+    list.action(async (opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/mcp-relays", {
+                params: { query: { ...paginationParams(opts) } },
+            });
+            formatPage(data, command, [
+                "id",
+                "name",
+                "status",
+                "online",
+                "relayVersion",
+                "inventoryReportedAt",
+            ]);
+        });
+    });
+    cmd.addCommand(list);
+    cmd
+        .command("get")
+        .description("Show a relay with its inventory")
+        .argument("<id>", "Relay ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/mcp-relays/{id}", {
+                params: { path: { id } },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("create")
+        .description("Create a relay; prints a single-use enrolment token and a docker run snippet")
+        .requiredOption("--name <name>", 'Display name, e.g. "Office Berlin"')
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/mcp-relays", {
+                body: { name: opts.name },
+            });
+            printEnrolment(data ?? {}, command);
+        });
+    });
+    cmd
+        .command("rename")
+        .description("Rename a relay")
+        .argument("<id>", "Relay ID")
+        .requiredOption("--name <name>", "New name")
+        .action(async (id, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.PATCH("/v1/mcp-relays/{id}", {
+                params: { path: { id } },
+                body: { name: opts.name },
+            });
+            formatDetail(data, command);
+        });
+    });
+    for (const [name, disabled, description] of [
+        ["disable", true, "Disable a relay: it gets no new work and its enrolment token is voided"],
+        ["enable", false, "Enable a disabled relay"],
+    ]) {
+        cmd
+            .command(name)
+            .description(description)
+            .argument("<id>", "Relay ID")
+            .action(async (id, _opts, command) => {
+            await runAction(command, async () => {
+                const client = getClient(command);
+                const { data } = await client.PATCH("/v1/mcp-relays/{id}", {
+                    params: { path: { id } },
+                    body: { disabled },
+                });
+                formatDetail(data, command);
+            });
+        });
+    }
+    cmd
+        .command("re-enrol")
+        .description("Issue a new enrolment token; redeeming it replaces the relay's key")
+        .argument("<id>", "Relay ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/mcp-relays/{id}/enrolment-token", {
+                params: { path: { id } },
+            });
+            printEnrolment(data ?? {}, command);
+        });
+    });
+    cmd
+        .command("delete")
+        .description("Revoke a relay for good")
+        .argument("<id>", "Relay ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            await client.DELETE("/v1/mcp-relays/{id}", { params: { path: { id } } });
+            formatSuccess(`Relay ${id} revoked.`, command);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=relays.js.map

package/dist/index.js

@@ -29,6 +29,7 @@ import { makeConversationsCommand } from "./commands/conversations.js";
 import { makeKnowledgeCommand } from "./commands/knowledge.js";
 import { makeFilesCommand } from "./commands/files.js";
 import { makeInstallationsCommand } from "./commands/installations.js";
+import { makeRelaysCommand } from "./commands/relays.js";
 import { checkForUpdates } from "./lib/update-notifier.js";
 const updater = checkForUpdates(pkg.version);
 const program = new Command();
@@ -65,6 +66,7 @@ program.addCommand(makeConversationsCommand());
 program.addCommand(makeKnowledgeCommand());
 program.addCommand(makeFilesCommand());
 program.addCommand(makeInstallationsCommand());
+program.addCommand(makeRelaysCommand());
 program.addCommand(makeDocsCommand());
 program.parseAsync().then(() => updater.notify());
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai",
-  "version": "6.3.0-dev.2",
+  "version": "6.3.0-dev.3",
   "description": "CLI for 2kw.ai — schema-driven document extraction, an OpenAI-compatible EU LLM gateway, transcription, prompts, datasets, and experiments from your terminal or agentic workflows. Ships as 2kw, backbone, and bb.",
   "keywords": [
     "cli",