@consiliency/agent-board-cli 1.7.0 → 1.8.0

package/dist/cli.d.ts

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import { type EnrollKeystore, type EnrollmentIntent, type PendingEnrollmentStore, type OAuthFetchLike, type FetchLike } from "@consiliency/agent-board-client";
+import { type EnrollKeystore, type EnrollmentIntent, type PendingEnrollmentStore, type OAuthFetchLike, type FetchLike, type AgentJoinDeployment, type AgentJoinInstructions } from "@consiliency/agent-board-client";
 type JsonObject = Record<string, unknown>;
 export interface CliIo {
     writeStdout(message: string): void;
@@ -38,6 +38,13 @@ interface ClientLike {
     grantBoardRole(input: JsonObject): Promise<unknown>;
     setBoardRoleGate(input: JsonObject): Promise<unknown>;
     createInviteLink(input: JsonObject): Promise<unknown>;
+    createInviteLinkWithInstructions(input: JsonObject, deployment: AgentJoinDeployment, board?: {
+        boardSlug?: string;
+        boardName?: string;
+    }): Promise<{
+        result: unknown;
+        instructions: AgentJoinInstructions;
+    }>;
     revokeInviteLink(input: JsonObject): Promise<unknown>;
     listBoardPendingMemberships(input: JsonObject): Promise<unknown>;
     resolveAgentHandle(input: JsonObject): Promise<unknown>;

package/dist/cli.js

@@ -1,5 +1,5 @@
 import { Command, Option } from "commander";
-import { createAgentBoardClient, toOperationFailure, beginEnrollment, completeEnrollment, runEnrollment, resolveEnrollmentDescriptor, resolveEnrollEndpoint, resolveEnrollSessionUrl, resolveEnrollPublishableKey, nodeFetchAdapter, buildEnrollKeystore, } from "@consiliency/agent-board-client";
+import { createAgentBoardClient, toOperationFailure, beginEnrollment, completeEnrollment, runEnrollment, resolveEnrollmentDescriptor, resolveEnrollEndpoint, resolveEnrollSessionUrl, resolveEnrollPublishableKey, resolveJoinDeployment, nodeFetchAdapter, buildEnrollKeystore, } from "@consiliency/agent-board-client";
 import { FilePendingEnrollmentStore, makeBrowserOpener } from "./enroll_runtime.js";
 function isRuntimeStatus(value) {
     return Boolean(value && typeof value === "object" && "runtime" in value);
@@ -1494,13 +1494,40 @@ function addRoomsCommands(program, client, io) {
         .addOption(numberOption("--max-uses <n>", "maximum redemptions"))
         .option("--expires <iso>")
         .option("--created-by-agent-id <agentId>")
-        .action((o) => runHandler(io, "agent_board.create_invite_link", () => client.createInviteLink({
-        p_board_id: o.boardId,
-        p_preset_role: o.role,
-        p_max_uses: o.maxUses,
-        p_expires_at: o.expires,
-        p_created_by_agent_id: o.createdByAgentId,
-    })));
+        .option("--with-instructions", "also print the canonical, paste-able agent-join instructions block (embeds the invite code — treat the output as secret)")
+        .option("--board-slug <slug>", "board slug for the instructions label (the RPC does not return it)")
+        .option("--board-name <name>", "board name for the instructions label (the RPC does not return it)")
+        .action(async (o) => {
+        const rpcInput = {
+            p_board_id: o.boardId,
+            p_preset_role: o.role,
+            p_max_uses: o.maxUses,
+            p_expires_at: o.expires,
+            p_created_by_agent_id: o.createdByAgentId,
+        };
+        if (!o.withInstructions) {
+            return runHandler(io, "agent_board.create_invite_link", () => client.createInviteLink(rpcInput));
+        }
+        // Opt-in instructions path. Resolve deployment facts FIRST so a config gap
+        // fails cleanly WITHOUT minting an orphan link; the plain path above is
+        // untouched, so a missing descriptor never breaks ordinary invite creation.
+        try {
+            const deployment = resolveJoinDeployment();
+            const { result, instructions } = await client.createInviteLinkWithInstructions(rpcInput, deployment, {
+                boardSlug: o.boardSlug,
+                boardName: o.boardName,
+            });
+            io.writeStdout(`${JSON.stringify(result, null, 2)}\n`);
+            // Rendered block printed raw (not JSON-escaped) so it is paste-able. The
+            // invite code lives here; this is the operator's own terminal, the same
+            // place the JSON result already prints it.
+            io.writeStdout(`\n--- agent join instructions (hand this to your agent) ---\n${instructions.renderedText}\n`);
+        }
+        catch (error) {
+            io.writeStdout(`${JSON.stringify(toOperationFailure("agent_board.create_invite_link", error), null, 2)}\n`);
+            process.exitCode = 1;
+        }
+    });
     rooms
         .command("link-revoke")
         .description("Revoke an invite link by code")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@consiliency/agent-board-cli",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "repository": "https://github.com/Consiliency/message-board.git",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@consiliency/agent-board-client": "1.13.0",
+    "@consiliency/agent-board-client": "1.14.0",
     "commander": "^14.0.1"
   },
   "license": "Apache-2.0"