chatroom-cli 1.0.72 → 1.0.74

package/dist/index.js

@@ -10568,6 +10568,115 @@ var init_update = __esm(() => {
   execAsync = promisify(exec);
   log = console.log.bind(console);
 });
+
+// src/commands/register-agent.ts
+var exports_register_agent = {};
+__export(exports_register_agent, {
+  registerAgent: () => registerAgent
+});
+async function registerAgent(chatroomId, options) {
+  const client2 = await getConvexClient();
+  const { role, type } = options;
+  const sessionId = getSessionId();
+  if (!sessionId) {
+    const otherUrls = getOtherSessionUrls();
+    const currentUrl = getConvexUrl();
+    console.error(`❌ Not authenticated for: ${currentUrl}`);
+    if (otherUrls.length > 0) {
+      console.error(`
+\uD83D\uDCA1 You have sessions for other environments:`);
+      for (const url of otherUrls) {
+        console.error(`   • ${url}`);
+      }
+      console.error(`
+   To use a different environment, set CHATROOM_CONVEX_URL:`);
+      console.error(`   CHATROOM_CONVEX_URL=${otherUrls[0]} chatroom register-agent ...`);
+      console.error(`
+   Or to authenticate for the current environment:`);
+    }
+    console.error(`   chatroom auth login`);
+    process.exit(1);
+  }
+  if (!chatroomId || typeof chatroomId !== "string" || chatroomId.length < 20 || chatroomId.length > 40) {
+    console.error(`❌ Invalid chatroom ID format: ID must be 20-40 characters (got ${chatroomId?.length || 0})`);
+    process.exit(1);
+  }
+  if (!/^[a-zA-Z0-9_]+$/.test(chatroomId)) {
+    console.error(`❌ Invalid chatroom ID format: ID must contain only alphanumeric characters and underscores`);
+    process.exit(1);
+  }
+  const chatroom = await client2.query(api.chatrooms.get, {
+    sessionId,
+    chatroomId
+  });
+  if (!chatroom) {
+    console.error(`❌ Chatroom ${chatroomId} not found or access denied`);
+    process.exit(1);
+  }
+  if (type === "remote") {
+    try {
+      const machineInfo = ensureMachineRegistered();
+      let availableModels = [];
+      try {
+        const registry = getDriverRegistry();
+        for (const driver of registry.all()) {
+          if (driver.capabilities.dynamicModelDiscovery) {
+            const models = await driver.listModels();
+            availableModels = availableModels.concat(models);
+          }
+        }
+      } catch {}
+      await client2.mutation(api.machines.register, {
+        sessionId,
+        machineId: machineInfo.machineId,
+        hostname: machineInfo.hostname,
+        os: machineInfo.os,
+        availableHarnesses: machineInfo.availableHarnesses,
+        harnessVersions: machineInfo.harnessVersions,
+        availableModels
+      });
+      const agentHarness = machineInfo.availableHarnesses.length > 0 ? machineInfo.availableHarnesses[0] : undefined;
+      await client2.mutation(api.machines.saveTeamAgentConfig, {
+        sessionId,
+        chatroomId,
+        role,
+        type: "remote",
+        machineId: machineInfo.machineId,
+        agentHarness,
+        workingDir: process.cwd()
+      });
+      console.log(`✅ Registered as remote agent for role "${role}"`);
+      console.log(`   Machine: ${machineInfo.hostname} (${machineInfo.machineId})`);
+      console.log(`   Working directory: ${process.cwd()}`);
+      if (agentHarness) {
+        console.log(`   Agent harness: ${agentHarness}`);
+      }
+    } catch (error) {
+      console.error(`❌ Registration failed: ${error.message}`);
+      process.exit(1);
+    }
+  } else {
+    try {
+      await client2.mutation(api.machines.saveTeamAgentConfig, {
+        sessionId,
+        chatroomId,
+        role,
+        type: "custom"
+      });
+      console.log(`✅ Registered as custom agent for role "${role}"`);
+    } catch (error) {
+      console.error(`❌ Registration failed: ${error.message}`);
+      process.exit(1);
+    }
+  }
+}
+var init_register_agent = __esm(() => {
+  init_api3();
+  init_agent_drivers();
+  init_storage();
+  init_client2();
+  init_machine();
+});
 // ../../services/backend/prompts/base/cli/task-started/command.ts
 function taskStartedCommand(params) {
   const prefix = params.cliEnvPrefix || "";
@@ -10598,7 +10707,6 @@ var init_new_feature = () => {};
 var init_classification = __esm(() => {
   init_new_feature();
 });
-
 // ../../services/backend/prompts/base/cli/task-started/main-prompt.ts
 var init_main_prompt = () => {};
 
@@ -10684,15 +10792,15 @@ var init_utils = __esm(() => {
   init_env();
 });
 
-// ../../services/backend/prompts/base/cli/init/context-gaining.ts
-var init_context_gaining = __esm(() => {
+// ../../services/backend/prompts/base/shared/getting-started-content.ts
+var init_getting_started_content = __esm(() => {
   init_utils();
 });
 
 // ../../services/backend/prompts/base/cli/index.ts
 var init_cli = __esm(() => {
   init_task_started();
-  init_context_gaining();
+  init_getting_started_content();
 });
 
 // ../../services/backend/prompts/base/cli/wait-for-task/command.ts
@@ -11007,12 +11115,35 @@ Classification types: question, new_feature, follow_up`);
 <!-- CONTEXT: Available Actions & Role Instructions`);
     console.log(taskDeliveryPrompt.humanReadable);
     console.log(`-->`);
+    const currentContext = taskDeliveryPrompt.json?.contextWindow?.currentContext;
     const originMessage = taskDeliveryPrompt.json?.contextWindow?.originMessage;
     console.log(`
 ${"=".repeat(60)}`);
     console.log(`\uD83D\uDCCD PINNED - Work on this immediately`);
     console.log(`${"=".repeat(60)}`);
-    if (originMessage && originMessage.senderRole.toLowerCase() === "user") {
+    if (currentContext) {
+      console.log(`
+## Context`);
+      console.log(`<context>`);
+      console.log(currentContext.content);
+      const messagesSinceContext = currentContext.messagesSinceContext ?? 0;
+      const elapsedHours = currentContext.elapsedHours ?? 0;
+      if (messagesSinceContext >= 10) {
+        console.log(`
+⚠️  WARNING: ${messagesSinceContext} messages since this context was set.`);
+        console.log(`   Consider updating the context with a summary of recent developments.`);
+        console.log(`   Create a new context with:`);
+        console.log(`   ${cliEnvPrefix}chatroom context new --chatroom-id=${chatroomId} --role=${role} --content="<summary>"`);
+      }
+      if (elapsedHours >= 24) {
+        const ageDays = Math.floor(elapsedHours / 24);
+        console.log(`
+⚠️  WARNING: This context is ${ageDays} day(s) old.`);
+        console.log(`   Consider creating a new context with updated summary.`);
+        console.log(`   ${cliEnvPrefix}chatroom context new --chatroom-id=${chatroomId} --role=${role} --content="<summary>"`);
+      }
+      console.log(`</context>`);
+    } else if (originMessage && originMessage.senderRole.toLowerCase() === "user") {
       console.log(`
 ## User Message`);
       console.log(`<user-message>`);
@@ -11030,7 +11161,8 @@ ATTACHED BACKLOG (${originMessage.attachedTasks.length})`);
         console.log(`
 ⚠️  WARNING: ${followUpCount} follow-up messages since this pinned message.`);
         console.log(`   The user may have moved on to a different topic.`);
-        console.log(`   Consider asking if this context is still relevant.`);
+        console.log(`   Consider creating a context with:`);
+        console.log(`   ${cliEnvPrefix}chatroom context new --chatroom-id=${chatroomId} --role=${role} --content="<summary>"`);
       }
       if (originCreatedAt) {
         const ageMs = Date.now() - originCreatedAt;
@@ -11039,7 +11171,8 @@ ATTACHED BACKLOG (${originMessage.attachedTasks.length})`);
           const ageDays = Math.floor(ageHours / 24);
           console.log(`
 ⚠️  WARNING: This pinned message is ${ageDays} day(s) old.`);
-          console.log(`   The context may be outdated.`);
+          console.log(`   Consider creating a context with:`);
+          console.log(`   ${cliEnvPrefix}chatroom context new --chatroom-id=${chatroomId} --role=${role} --content="<summary>"`);
         }
       }
       console.log(`</user-message>`);
@@ -12366,7 +12499,10 @@ var init_messages = __esm(() => {
 // src/commands/context.ts
 var exports_context = {};
 __export(exports_context, {
-  readContext: () => readContext
+  readContext: () => readContext,
+  newContext: () => newContext,
+  listContexts: () => listContexts,
+  inspectContext: () => inspectContext
 });
 async function readContext(chatroomId, options) {
   const client2 = await getConvexClient();
@@ -12462,6 +12598,136 @@ async function readContext(chatroomId, options) {
     process.exit(1);
   }
 }
+async function newContext(chatroomId, options) {
+  const client2 = await getConvexClient();
+  const sessionId = getSessionId();
+  if (!sessionId) {
+    console.error(`❌ Not authenticated. Please run: chatroom auth login`);
+    process.exit(1);
+  }
+  if (!chatroomId || typeof chatroomId !== "string" || chatroomId.length < 20 || chatroomId.length > 40) {
+    console.error(`❌ Invalid chatroom ID format: ID must be 20-40 characters (got ${chatroomId?.length || 0})`);
+    process.exit(1);
+  }
+  if (!options.content || options.content.trim().length === 0) {
+    console.error(`❌ Context content cannot be empty`);
+    process.exit(1);
+  }
+  try {
+    const contextId = await client2.mutation(api.contexts.createContext, {
+      sessionId,
+      chatroomId,
+      content: options.content,
+      role: options.role
+    });
+    console.log(`✅ Context created successfully`);
+    console.log(`   Context ID: ${contextId}`);
+    console.log(`   Created by: ${options.role}`);
+    console.log(`
+\uD83D\uDCCC This context is now pinned for all agents in this chatroom.`);
+  } catch (err) {
+    console.error(`❌ Failed to create context: ${err.message}`);
+    process.exit(1);
+  }
+}
+async function listContexts(chatroomId, options) {
+  const client2 = await getConvexClient();
+  const sessionId = getSessionId();
+  if (!sessionId) {
+    console.error(`❌ Not authenticated. Please run: chatroom auth login`);
+    process.exit(1);
+  }
+  if (!chatroomId || typeof chatroomId !== "string" || chatroomId.length < 20 || chatroomId.length > 40) {
+    console.error(`❌ Invalid chatroom ID format: ID must be 20-40 characters (got ${chatroomId?.length || 0})`);
+    process.exit(1);
+  }
+  try {
+    const contexts = await client2.query(api.contexts.listContexts, {
+      sessionId,
+      chatroomId,
+      limit: options.limit ?? 10
+    });
+    if (contexts.length === 0) {
+      console.log(`
+\uD83D\uDCED No contexts found for this chatroom`);
+      console.log(`
+\uD83D\uDCA1 Create a context with:`);
+      console.log(`   chatroom context new --chatroom-id=${chatroomId} --role=${options.role} --content="Your context summary"`);
+      return;
+    }
+    console.log(`
+\uD83D\uDCDA CONTEXTS (${contexts.length} found)`);
+    console.log("═".repeat(60));
+    for (const context of contexts) {
+      const timestamp = new Date(context.createdAt).toLocaleString();
+      console.log(`
+\uD83D\uDD39 Context ID: ${context._id}`);
+      console.log(`   Created by: ${context.createdBy}`);
+      console.log(`   Created at: ${timestamp}`);
+      if (context.messageCountAtCreation !== undefined) {
+        console.log(`   Messages at creation: ${context.messageCountAtCreation}`);
+      }
+      console.log(`   Content:`);
+      const truncatedContent = context.content.length > 200 ? context.content.slice(0, 200) + "..." : context.content;
+      console.log(truncatedContent.split(`
+`).map((l) => `      ${l}`).join(`
+`));
+    }
+    console.log(`
+` + "═".repeat(60));
+  } catch (err) {
+    console.error(`❌ Failed to list contexts: ${err.message}`);
+    process.exit(1);
+  }
+}
+async function inspectContext(chatroomId, options) {
+  const client2 = await getConvexClient();
+  const sessionId = getSessionId();
+  if (!sessionId) {
+    console.error(`❌ Not authenticated. Please run: chatroom auth login`);
+    process.exit(1);
+  }
+  try {
+    const context = await client2.query(api.contexts.getContext, {
+      sessionId,
+      contextId: options.contextId
+    });
+    console.log(`
+\uD83D\uDCCB CONTEXT DETAILS`);
+    console.log("═".repeat(60));
+    console.log(`
+\uD83D\uDD39 Context ID: ${context._id}`);
+    console.log(`   Created by: ${context.createdBy}`);
+    console.log(`   Created at: ${new Date(context.createdAt).toLocaleString()}`);
+    console.log(`
+\uD83D\uDCCA Staleness:`);
+    console.log(`   Messages since context: ${context.messagesSinceContext}`);
+    console.log(`   Time elapsed: ${context.elapsedHours.toFixed(1)} hours`);
+    if (context.messagesSinceContext >= 10) {
+      console.log(`
+⚠️  Many messages since this context was created.`);
+      console.log(`   Consider creating a new context with an updated summary.`);
+    }
+    if (context.elapsedHours >= 24) {
+      console.log(`
+⚠️  This context is over 24 hours old.`);
+      console.log(`   Consider creating a new context with an updated summary.`);
+    }
+    console.log(`
+\uD83D\uDCDD Content:`);
+    console.log("─".repeat(60));
+    console.log(context.content);
+    console.log("─".repeat(60));
+    console.log(`
+\uD83D\uDCA1 To create a new context:`);
+    console.log(`   chatroom context new --chatroom-id=${chatroomId} --role=${options.role} --content="Your updated summary"`);
+    console.log(`
+` + "═".repeat(60));
+  } catch (err) {
+    console.error(`❌ Failed to inspect context: ${err.message}`);
+    process.exit(1);
+  }
+}
 var init_context = __esm(() => {
   init_api3();
   init_storage();
@@ -13302,7 +13568,23 @@ Listening for commands...`);
   }, async (result) => {
     if (!result.commands || result.commands.length === 0)
       return;
-    const parsed = result.commands.map(parseMachineCommand).filter((c) => c !== null);
+    const parsed = [];
+    for (const raw of result.commands) {
+      const command = parseMachineCommand(raw);
+      if (command !== null) {
+        parsed.push(command);
+      } else {
+        try {
+          await ctx.client.mutation(api.machines.ackCommand, {
+            sessionId: ctx.sessionId,
+            commandId: raw._id,
+            status: "failed",
+            result: `Invalid command: type="${raw.type}" missing required payload fields`
+          });
+          console.warn(`[${formatTimestamp()}] ⚠️  Acked invalid command ${raw._id} (type=${raw.type}) as failed`);
+        } catch {}
+      }
+    }
     enqueueCommands(parsed);
     await drainQueue();
   });
@@ -13835,6 +14117,18 @@ program2.command("update").description("Update the CLI to the latest version").a
   const { update: update2 } = await Promise.resolve().then(() => (init_update(), exports_update));
   await update2();
 });
+program2.command("register-agent").description("Register agent type for a chatroom role").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Role to register as (e.g., builder, reviewer)").requiredOption("--type <type>", "Agent type: remote or custom").action(async (options) => {
+  await maybeRequireAuth();
+  if (options.type !== "remote" && options.type !== "custom") {
+    console.error(`❌ Invalid agent type: "${options.type}". Must be "remote" or "custom".`);
+    process.exit(1);
+  }
+  const { registerAgent: registerAgent2 } = await Promise.resolve().then(() => (init_register_agent(), exports_register_agent));
+  await registerAgent2(options.chatroomId, {
+    role: options.role,
+    type: options.type
+  });
+});
 program2.command("wait-for-task").description("Join a chatroom and wait for tasks").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Role to join as (e.g., builder, reviewer)").option("--timeout <ms>", "Optional timeout in milliseconds (deprecated, use --duration)").option("--duration <duration>", 'How long to wait (e.g., "1m", "5m", "30s")').action(async (options) => {
   await maybeRequireAuth();
   const { waitForTask: waitForTask2, parseDuration: parseDuration2 } = await Promise.resolve().then(() => (init_wait_for_task(), exports_wait_for_task));
@@ -14057,12 +14351,45 @@ messagesCommand.command("list").description("List messages by sender role or sin
     });
   }
 });
-var contextCommand = program2.command("context").description("Get chatroom context and state");
+var contextCommand = program2.command("context").description("Manage chatroom context and state (explicit context management)");
 contextCommand.command("read").description("Read context for your role (conversation history, tasks, status)").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").action(async (options) => {
   await maybeRequireAuth();
   const { readContext: readContext2 } = await Promise.resolve().then(() => (init_context(), exports_context));
   await readContext2(options.chatroomId, options);
 });
+contextCommand.command("new").description("Create a new context and pin it for all agents").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role (creator of the context)").option("--content <content>", "Context summary/description (alternative: provide via stdin/heredoc)").action(async (options) => {
+  await maybeRequireAuth();
+  let content;
+  if (options.content && options.content.trim().length > 0) {
+    content = options.content.trim();
+  } else {
+    const stdinContent = await readStdin();
+    if (!stdinContent.trim()) {
+      console.error("❌ Context content cannot be empty.");
+      console.error('   Provide content via --content="..." or stdin (heredoc):');
+      console.error("   chatroom context new --chatroom-id=<id> --role=<role> << 'EOF'");
+      console.error("   Your context summary here");
+      console.error("   EOF");
+      process.exit(1);
+    }
+    content = stdinContent.trim();
+  }
+  const { newContext: newContext2 } = await Promise.resolve().then(() => (init_context(), exports_context));
+  await newContext2(options.chatroomId, { ...options, content });
+});
+contextCommand.command("list").description("List recent contexts for a chatroom").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").option("--limit <n>", "Maximum number of contexts to show (default: 10)").action(async (options) => {
+  await maybeRequireAuth();
+  const { listContexts: listContexts2 } = await Promise.resolve().then(() => (init_context(), exports_context));
+  await listContexts2(options.chatroomId, {
+    role: options.role,
+    limit: options.limit ? parseInt(options.limit, 10) : 10
+  });
+});
+contextCommand.command("inspect").description("View a specific context with staleness information").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--context-id <contextId>", "Context ID to inspect").action(async (options) => {
+  await maybeRequireAuth();
+  const { inspectContext: inspectContext2 } = await Promise.resolve().then(() => (init_context(), exports_context));
+  await inspectContext2(options.chatroomId, options);
+});
 var guidelinesCommand = program2.command("guidelines").description("View review guidelines by type");
 guidelinesCommand.command("view").description("View guidelines for a specific review type").requiredOption("--type <type>", "Guideline type (coding|security|design|performance|all)").action(async (options) => {
   await maybeRequireAuth();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatroom-cli",
-  "version": "1.0.72",
+  "version": "1.0.74",
   "description": "CLI for multi-agent chatroom collaboration",
   "type": "module",
   "bin": {