chatroom-cli 1.0.74 → 1.0.75

package/dist/index.js

@@ -10717,9 +10717,6 @@ var init_task_started = __esm(() => {
 });
 
 // ../../services/backend/prompts/base/cli/wait-for-task/reminder.ts
-function getWaitForTaskReminder() {
-  return "Message availability is critical: Use `wait-for-task` in the foreground to stay connected, otherwise your team cannot reach you";
-}
 function getWaitForTaskGuidance() {
   return `\uD83D\uDD17 STAYING CONNECTED TO YOUR TEAM
 
@@ -10735,11 +10732,11 @@ Two requirements:
 
 2. **Blocking execution** - Wait for command completion
    • Do not respond to user or perform other work while running
-   • Only proceed after the command exits (timeout or task received)
+   • Only proceed after the command exits (signal or task received)
 
-⏱️  UNDERSTANDING TIMEOUTS
-• Timeouts are normal and expected - they keep agents responsive
-• When the command terminates:
+⚠️  WHEN THE PROCESS IS TERMINATED OR TIMED OUT
+• Your harness may kill long-running commands after a set duration
+• When the command terminates unexpectedly:
   1. Do you have urgent pending work?
   2. Without wait-for-task, your team cannot reach you
   3. If no urgent work, reconnect immediately
@@ -10812,9 +10809,8 @@ function waitForTaskCommand(params) {
 }
 
 // src/config.ts
-var DEFAULT_WAIT_TIMEOUT_MS, DEFAULT_ACTIVE_TIMEOUT_MS, WEB_SERVER_PORT;
+var DEFAULT_ACTIVE_TIMEOUT_MS, WEB_SERVER_PORT;
 var init_config2 = __esm(() => {
-  DEFAULT_WAIT_TIMEOUT_MS = 10 * 60 * 1000;
   DEFAULT_ACTIVE_TIMEOUT_MS = 60 * 60 * 1000;
   WEB_SERVER_PORT = parseInt(process.env.WEB_PORT || "3456", 10);
 });
@@ -10822,38 +10818,11 @@ var init_config2 = __esm(() => {
 // src/commands/wait-for-task.ts
 var exports_wait_for_task = {};
 __export(exports_wait_for_task, {
-  waitForTask: () => waitForTask,
-  parseDuration: () => parseDuration
+  waitForTask: () => waitForTask
 });
-function parseDuration(duration) {
-  const match = duration.trim().match(/^(\d+(?:\.\d+)?)\s*(s|sec|second|seconds|m|min|minute|minutes|h|hr|hour|hours)?$/i);
-  if (!match)
-    return null;
-  const value = parseFloat(match[1]);
-  const unit = (match[2] || "s").toLowerCase();
-  switch (unit) {
-    case "s":
-    case "sec":
-    case "second":
-    case "seconds":
-      return value * 1000;
-    case "m":
-    case "min":
-    case "minute":
-    case "minutes":
-      return value * 60 * 1000;
-    case "h":
-    case "hr":
-    case "hour":
-    case "hours":
-      return value * 60 * 60 * 1000;
-    default:
-      return null;
-  }
-}
 async function waitForTask(chatroomId, options) {
   const client2 = await getConvexClient();
-  const { role, timeout, silent } = options;
+  const { role, silent } = options;
   const convexUrl = getConvexUrl();
   const cliEnvPrefix = getCliEnvPrefix(convexUrl);
   const sessionId = getSessionId();
@@ -10930,14 +10899,11 @@ async function waitForTask(chatroomId, options) {
       console.warn(`⚠️  Machine registration failed: ${machineError.message}`);
     }
   }
-  const effectiveTimeout = timeout || DEFAULT_WAIT_TIMEOUT_MS;
-  const readyUntil = Date.now() + effectiveTimeout;
   const connectionId = `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
   await client2.mutation(api.participants.join, {
     sessionId,
     chatroomId,
     role,
-    readyUntil,
     connectionId
   });
   const connectionTime = new Date().toISOString().replace("T", " ").substring(0, 19);
@@ -10975,22 +10941,6 @@ async function waitForTask(chatroomId, options) {
   } catch {}
   let taskProcessed = false;
   let unsubscribe = null;
-  const timeoutHandle = setTimeout(() => {
-    if (unsubscribe)
-      unsubscribe();
-    const timeoutTime = new Date().toISOString().replace("T", " ").substring(0, 19);
-    console.log(`
-${"─".repeat(50)}`);
-    console.log(`⚠️  RECONNECTION REQUIRED
-`);
-    console.log(`[${timeoutTime}] Why: Session timeout reached (normal and expected behavior)`);
-    console.log(`Impact: You are no longer listening for tasks`);
-    console.log(`Action: Run this command immediately to resume availability
-`);
-    console.log(waitForTaskCommand({ chatroomId, role, cliEnvPrefix }));
-    console.log(`${"─".repeat(50)}`);
-    process.exit(0);
-  }, effectiveTimeout);
   const handlePendingTasks = async (pendingTasks) => {
     if (taskProcessed)
       return;
@@ -11002,7 +10952,6 @@ ${"─".repeat(50)}`);
     if (currentConnectionId && currentConnectionId !== connectionId) {
       if (unsubscribe)
         unsubscribe();
-      clearTimeout(timeoutHandle);
       const takeoverTime = new Date().toISOString().replace("T", " ").substring(0, 19);
       console.log(`
 ${"─".repeat(50)}`);
@@ -11022,15 +10971,26 @@ ${"─".repeat(50)}`);
       return;
     }
     const { task, message } = taskWithMessage;
-    try {
-      await client2.mutation(api.tasks.claimTask, {
-        sessionId,
-        chatroomId,
-        role
-      });
-    } catch (_claimError) {
-      console.log(`\uD83D\uDD04 Task already claimed by another agent, continuing to wait...`);
-      return;
+    if (task.status === "acknowledged") {
+      const acknowledgedAt = task.acknowledgedAt || task.updatedAt;
+      const elapsedMs = Date.now() - acknowledgedAt;
+      const RECOVERY_GRACE_PERIOD_MS = 60 * 1000;
+      if (elapsedMs < RECOVERY_GRACE_PERIOD_MS) {
+        const remainingSec = Math.ceil((RECOVERY_GRACE_PERIOD_MS - elapsedMs) / 1000);
+        console.log(`\uD83D\uDD04 Task was recently acknowledged (${remainingSec}s remaining). ` + `Re-run wait-for-task in 1 minute to recover it if the other agent is unresponsive.`);
+        return;
+      }
+    } else {
+      try {
+        await client2.mutation(api.tasks.claimTask, {
+          sessionId,
+          chatroomId,
+          role
+        });
+      } catch (_claimError) {
+        console.log(`\uD83D\uDD04 Task already claimed by another agent, continuing to wait...`);
+        return;
+      }
     }
     taskProcessed = true;
     if (message) {
@@ -11042,7 +11002,6 @@ ${"─".repeat(50)}`);
     }
     if (unsubscribe)
       unsubscribe();
-    clearTimeout(timeoutHandle);
     const activeUntil = Date.now() + DEFAULT_ACTIVE_TIMEOUT_MS;
     await client2.mutation(api.participants.updateStatus, {
       sessionId,
@@ -11063,151 +11022,7 @@ ${"─".repeat(50)}`);
     console.log(`
 [${taskReceivedTime}] \uD83D\uDCE8 Task received!
 `);
-    console.log(`${"=".repeat(60)}`);
-    console.log(`\uD83C\uDD94 TASK INFORMATION`);
-    console.log(`${"=".repeat(60)}`);
-    console.log(`Task ID: ${task._id}`);
-    if (message) {
-      console.log(`Message ID: ${message._id}`);
-    }
-    console.log(`
-\uD83D\uDCCB NEXT STEPS`);
-    console.log(`${"=".repeat(60)}`);
-    const isUserMessage = message && message.senderRole.toLowerCase() === "user";
-    if (isUserMessage) {
-      console.log(`To acknowledge and classify this message, run:
-`);
-      const baseCmd = taskStartedCommand({
-        chatroomId,
-        role,
-        taskId: task._id,
-        classification: "question",
-        cliEnvPrefix
-      }).replace("--origin-message-classification=question", "--origin-message-classification=<type>");
-      console.log(baseCmd);
-      console.log(`
-\uD83D\uDCDD Classification Requirements:`);
-      console.log(`   • question: No additional fields required`);
-      console.log(`   • follow_up: No additional fields required`);
-      console.log(`   • new_feature: REQUIRES --title, --description, --tech-specs`);
-      console.log(`
-\uD83D\uDCA1 Example for new_feature:`);
-      console.log(taskStartedCommand({
-        chatroomId,
-        role,
-        taskId: task._id,
-        classification: "new_feature",
-        title: "<title>",
-        description: "<description>",
-        techSpecs: "<tech-specs>",
-        cliEnvPrefix
-      }));
-      console.log(`
-Classification types: question, new_feature, follow_up`);
-    } else if (message) {
-      console.log(`Task handed off from ${message.senderRole}.`);
-      console.log(`The original user message was already classified - you can start work immediately.`);
-    } else {
-      console.log(`No message found. Task ID: ${task._id}`);
-    }
-    console.log(`${"=".repeat(60)}`);
-    console.log(`
-<!-- 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 (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>`);
-      console.log(originMessage.content);
-      if (originMessage.attachedTasks && originMessage.attachedTasks.length > 0) {
-        console.log(`
-ATTACHED BACKLOG (${originMessage.attachedTasks.length})`);
-        for (const attachedTask of originMessage.attachedTasks) {
-          console.log(`${attachedTask.content}`);
-        }
-      }
-      const followUpCount = taskDeliveryPrompt.json?.contextWindow?.followUpCountSinceOrigin ?? 0;
-      const originCreatedAt = taskDeliveryPrompt.json?.contextWindow?.originMessageCreatedAt;
-      if (followUpCount >= 5) {
-        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 creating a context with:`);
-        console.log(`   ${cliEnvPrefix}chatroom context new --chatroom-id=${chatroomId} --role=${role} --content="<summary>"`);
-      }
-      if (originCreatedAt) {
-        const ageMs = Date.now() - originCreatedAt;
-        const ageHours = ageMs / (1000 * 60 * 60);
-        if (ageHours >= 24) {
-          const ageDays = Math.floor(ageHours / 24);
-          console.log(`
-⚠️  WARNING: This pinned message is ${ageDays} day(s) old.`);
-          console.log(`   Consider creating a context with:`);
-          console.log(`   ${cliEnvPrefix}chatroom context new --chatroom-id=${chatroomId} --role=${role} --content="<summary>"`);
-        }
-      }
-      console.log(`</user-message>`);
-    }
-    console.log(`
-## Task`);
-    console.log(task.content);
-    const existingClassification = originMessage?.classification;
-    if (existingClassification) {
-      console.log(`
-Classification: ${existingClassification.toUpperCase()}`);
-    }
-    console.log(`
-${"=".repeat(60)}`);
-    console.log(`\uD83D\uDCCB PROCESS`);
-    console.log(`${"=".repeat(60)}`);
-    console.log(`
-1. Mark task as started:`);
-    if (isUserMessage) {
-      console.log(`   ${taskStartedCommand({ chatroomId, role, taskId: task._id, classification: "follow_up", cliEnvPrefix })}`);
-    } else {
-      console.log(`   ${cliEnvPrefix}chatroom task-started --chatroom-id=${chatroomId} --role=${role} --task-id=${task._id} --no-classify`);
-    }
-    console.log(`
-2. Do the work`);
-    console.log(`
-3. Hand off when complete:`);
-    console.log(`   ${cliEnvPrefix}chatroom handoff --chatroom-id=${chatroomId} --role=${role} --next-role=<target>`);
-    console.log(`
-4. Resume listening:`);
-    console.log(`   ${waitForTaskCommand({ chatroomId, role, cliEnvPrefix })}`);
-    console.log(`
-${"=".repeat(60)}`);
-    console.log(getWaitForTaskReminder());
-    console.log(`${"=".repeat(60)}`);
+    console.log(taskDeliveryPrompt.fullCliOutput);
     process.exit(0);
   };
   const wsClient2 = await getConvexWsClient();
@@ -11223,7 +11038,6 @@ ${"=".repeat(60)}`);
   const handleSignal = (_signal) => {
     if (unsubscribe)
       unsubscribe();
-    clearTimeout(timeoutHandle);
     const signalTime = new Date().toISOString().replace("T", " ").substring(0, 19);
     console.log(`
 ${"─".repeat(50)}`);
@@ -14129,24 +13943,11 @@ program2.command("register-agent").description("Register agent type for a chatro
     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) => {
+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)").action(async (options) => {
   await maybeRequireAuth();
-  const { waitForTask: waitForTask2, parseDuration: parseDuration2 } = await Promise.resolve().then(() => (init_wait_for_task(), exports_wait_for_task));
-  let timeoutMs;
-  if (options.duration) {
-    const parsed = parseDuration2(options.duration);
-    if (parsed === null) {
-      console.error(`❌ Invalid duration format: "${options.duration}". Use formats like "1m", "5m", "30s".`);
-      process.exit(1);
-    }
-    timeoutMs = parsed;
-  } else if (options.timeout) {
-    timeoutMs = parseInt(options.timeout, 10);
-  }
+  const { waitForTask: waitForTask2 } = await Promise.resolve().then(() => (init_wait_for_task(), exports_wait_for_task));
   await waitForTask2(options.chatroomId, {
-    role: options.role,
-    timeout: timeoutMs,
-    duration: options.duration
+    role: options.role
   });
 });
 program2.command("task-started").description("Acknowledge a task and optionally classify the user message").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").option("--origin-message-classification <type>", "Original message classification: question, new_feature, or follow_up (for entry point roles)").option("--no-classify", "Skip classification (for handoff recipients - classification already done by entry point)").requiredOption("--task-id <taskId>", "Task ID to acknowledge").action(async (options) => {

package/package.json

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