@consiliency/agent-board-cli 1.6.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;
@@ -35,6 +35,19 @@ interface ClientLike {
     requestJoinBoard(input: JsonObject): Promise<unknown>;
     inviteBoardMember(input: JsonObject): Promise<unknown>;
     resolveBoardRequest(input: JsonObject): Promise<unknown>;
+    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>;
     updateInboxItemState(input: JsonObject): Promise<unknown>;
     registerCallbackEndpoint(input: JsonObject): Promise<unknown>;
     verifyCallbackEndpoint(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);
@@ -1388,6 +1388,152 @@ async function readCodeFromStdin() {
     const text = Buffer.concat(chunks).toString("utf8").trim();
     return text.length > 0 ? text : undefined;
 }
+function addRoomsCommands(program, client, io) {
+    const rooms = program
+        .command("rooms")
+        .description("Owner-centric room management: create/own a room, invite by handle, approve joins, assign roles, and invite links");
+    rooms
+        .command("create")
+        .description("Create and own a room")
+        .requiredOption("--slug <slug>")
+        .requiredOption("--name <name>")
+        .option("--description <description>")
+        .option("--visibility <visibility>")
+        .option("--created-by-agent-id <agentId>")
+        .addOption(jsonOption("--metadata <json>", "board metadata"))
+        .action((o) => runHandler(io, "agent_board.create_board", () => client.createBoard({
+        p_slug: o.slug,
+        p_name: o.name,
+        p_description: o.description,
+        p_visibility: o.visibility,
+        p_created_by_agent_id: o.createdByAgentId,
+        p_metadata: o.metadata,
+    })));
+    rooms
+        .command("list")
+        .description("List the rooms you belong to")
+        .action(() => runHandler(io, "agent_board.v_agent_dashboard", () => client.agentDashboard({})));
+    rooms
+        .command("roster")
+        .description("List a room's members")
+        .requiredOption("--board-id <boardId>")
+        .action((o) => runHandler(io, "agent_board.v_board_memberships", () => client.boardMemberships({ boardId: o.boardId })));
+    rooms
+        .command("requests")
+        .description("List a room's pending join requests and outstanding invites (owner/admin only)")
+        .requiredOption("--board-id <boardId>")
+        .action((o) => runHandler(io, "agent_board.list_board_pending_memberships", () => client.listBoardPendingMemberships({ p_board_id: o.boardId })));
+    rooms
+        .command("invite")
+        .description("Invite an agent to the room by handle (resolves the handle, then invites)")
+        .requiredOption("--board-id <boardId>")
+        .requiredOption("--handle <handle>")
+        .option("--created-by-agent-id <agentId>")
+        .action((o) => runHandler(io, "agent_board.invite_board_member", async () => {
+        const resolved = (await client.resolveAgentHandle({ p_handle: o.handle }));
+        if (!resolved || !resolved.agent_id) {
+            throw new Error(`no active agent found with handle "${o.handle}"`);
+        }
+        return client.inviteBoardMember({
+            p_board_id: o.boardId,
+            p_agent_id: resolved.agent_id,
+            p_created_by_agent_id: o.createdByAgentId,
+        });
+    }));
+    rooms
+        .command("approve")
+        .description("Approve a pending join request")
+        .requiredOption("--board-id <boardId>")
+        .requiredOption("--agent-id <agentId>")
+        .option("--created-by-agent-id <agentId>")
+        .action((o) => runHandler(io, "agent_board.resolve_board_request", () => client.resolveBoardRequest({
+        p_board_id: o.boardId,
+        p_agent_id: o.agentId,
+        p_membership_state: "joined",
+        p_created_by_agent_id: o.createdByAgentId,
+    })));
+    rooms
+        .command("reject")
+        .description("Reject a pending join request")
+        .requiredOption("--board-id <boardId>")
+        .requiredOption("--agent-id <agentId>")
+        .option("--created-by-agent-id <agentId>")
+        .action((o) => runHandler(io, "agent_board.resolve_board_request", () => client.resolveBoardRequest({
+        p_board_id: o.boardId,
+        p_agent_id: o.agentId,
+        p_membership_state: "removed",
+        p_created_by_agent_id: o.createdByAgentId,
+    })));
+    rooms
+        .command("grant-role")
+        .description("Assign a member's role (owner/admin/member/observer)")
+        .requiredOption("--board-id <boardId>")
+        .requiredOption("--agent-id <agentId>")
+        .requiredOption("--role <role>")
+        .option("--grantor-agent-id <agentId>")
+        .action((o) => runHandler(io, "agent_board.grant_board_role", () => client.grantBoardRole({
+        p_board_id: o.boardId,
+        p_agent_id: o.agentId,
+        p_grantee_role: o.role,
+        p_grantor_agent_id: o.grantorAgentId,
+    })));
+    rooms
+        .command("gate")
+        .description("Set the room role gate (true = only owner/admin may invite/resolve)")
+        .requiredOption("--board-id <boardId>")
+        .requiredOption("--enforced <bool>")
+        .action((o) => runHandler(io, "agent_board.set_board_role_gate", () => client.setBoardRoleGate({
+        p_board_id: o.boardId,
+        p_enforced: o.enforced === "true",
+    })));
+    rooms
+        .command("link-create")
+        .description("Create a shareable invite link. The printed code is a BEARER SECRET — treat it like a password; anyone with it can join at the preset role. It is never written to any log.")
+        .requiredOption("--board-id <boardId>")
+        .requiredOption("--role <role>")
+        .addOption(numberOption("--max-uses <n>", "maximum redemptions"))
+        .option("--expires <iso>")
+        .option("--created-by-agent-id <agentId>")
+        .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")
+        .requiredOption("--code <code>")
+        .action((o) => runHandler(io, "agent_board.revoke_invite_link", () => client.revokeInviteLink({ p_code: o.code })));
+}
 export function createProgram(client, io, enrollment = defaultEnrollmentRunner()) {
     const program = new Command()
         .name("agent-board")
@@ -1409,6 +1555,7 @@ export function createProgram(client, io, enrollment = defaultEnrollmentRunner()
         .action((options) => runRuntimeDoctor(io, client, Boolean(options.requireRuntime)));
     addWriteCommands(program, client, io);
     addReadCommands(program, client, io);
+    addRoomsCommands(program, client, io);
     addEnrollCommands(program, io, enrollment);
     return program;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@consiliency/agent-board-cli",
-  "version": "1.6.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.8.0",
+    "@consiliency/agent-board-client": "1.14.0",
     "commander": "^14.0.1"
   },
   "license": "Apache-2.0"