@agentmeshhq/agent 0.4.16 → 0.4.20

package/dist/core/chat-output-parser.js

@@ -0,0 +1,150 @@
+/**
+ * Extracts clean LLM reply from raw tmux capture.
+ *
+ * Raw tmux output includes:
+ * - Welcome screen with logo
+ * - Prompt characters (❯ for input, ⏺ for output)
+ * - ANSI escape codes for colors/formatting
+ * - Box-drawing characters
+ *
+ * This parser identifies the LLM's response block and strips all chrome.
+ */
+/**
+ * Remove ANSI escape codes (colors, formatting, etc.)
+ */
+function stripAnsiCodes(text) {
+    // Match ESC[ ... (letter|number) patterns
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ESC is needed for ANSI parsing
+    return text.replace(/\u001b\[[0-9;]*[a-zA-Z]/g, "");
+}
+/**
+ * Check if a line is tmux chrome (logo, box-drawing, etc.)
+ */
+function isTmuxChrome(line) {
+    const trimmed = line.trim();
+    // Empty lines are not chrome
+    if (trimmed.length === 0)
+        return false;
+    // Claude Code logo lines (▐▛███▜▌, ▝▜█████▛▘, etc.)
+    if (/^[▐▛███▜▌▝█]*\s*Claude Code/.test(trimmed))
+        return true;
+    if (/^[▛███▜▌▝█]*\s*Haiku|Sonnet|Opus|Claude/.test(trimmed))
+        return true;
+    if (/^[▘▝]*\s*$/.test(trimmed))
+        return true;
+    // Pure box drawing / special characters
+    if (/^[╔╗╚╝═║├┤┬┴┼▐▛███▜▌▝█\s]*$/.test(trimmed))
+        return true;
+    return false;
+}
+/**
+ * Check if a line starts with a prompt character.
+ * Input prompts:
+ * - ❯ (Claude)
+ * - › (Codex/OpenCode)
+ * Output prompts:
+ * - ⏺ (Claude)
+ * - • (Codex/OpenCode)
+ */
+function getPromptType(line) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("❯") || trimmed.startsWith("›"))
+        return "input";
+    if (trimmed.startsWith("⏺") || trimmed.startsWith("•"))
+        return "output";
+    return null;
+}
+/**
+ * Extract the message content after a prompt character.
+ * Removes the prompt character and leading/trailing whitespace.
+ */
+function extractMessageAfterPrompt(line) {
+    const trimmed = line.trim();
+    // Remove ❯/›/⏺/• and following space(s)
+    return trimmed.replace(/^[❯›⏺•]\s+/, "").trim();
+}
+/**
+ * Main parser: extract clean LLM reply from raw tmux capture.
+ *
+ * Strategy:
+ * 1. Split into lines
+ * 2. Remove ANSI codes
+ * 3. Find the last input prompt (most recent user turn)
+ * 4. Extract all output lines after that input prompt
+ * 5. Stop at the next input prompt (if any)
+ *
+ * Returns the clean reply text, or empty string if no reply found.
+ */
+export function extractLLMReply(rawOutput) {
+    if (!rawOutput || rawOutput.trim().length === 0) {
+        return "";
+    }
+    const lines = rawOutput.split("\n");
+    // Step 1: Remove ANSI codes and filter out tmux chrome
+    const cleaned = [];
+    for (const line of lines) {
+        const noAnsi = stripAnsiCodes(line);
+        if (isTmuxChrome(noAnsi)) {
+            // Skip pure chrome lines, but keep track of them in the array
+            continue;
+        }
+        const promptType = getPromptType(noAnsi);
+        cleaned.push({
+            original: line,
+            text: noAnsi,
+            promptType,
+        });
+    }
+    // Step 2: Anchor extraction after the most recent input prompt.
+    // This preserves multi-line Codex/OpenCode replies where each line starts with "•".
+    let startSearchIdx = 0;
+    for (let i = cleaned.length - 1; i >= 0; i--) {
+        if (cleaned[i].promptType === "input") {
+            startSearchIdx = i + 1;
+            break;
+        }
+    }
+    // Step 3: Find the first output prompt after the latest input turn.
+    let firstOutputIdx = -1;
+    for (let i = startSearchIdx; i < cleaned.length; i++) {
+        if (cleaned[i].promptType === "output") {
+            firstOutputIdx = i;
+            break;
+        }
+    }
+    if (firstOutputIdx === -1) {
+        // No output prompt found — maybe the response hasn't started yet
+        return "";
+    }
+    // Step 4: Extract content starting from the first output prompt.
+    const replyLines = [];
+    // Add the message from the output prompt line
+    const firstMsg = extractMessageAfterPrompt(cleaned[firstOutputIdx].text);
+    if (firstMsg) {
+        replyLines.push(firstMsg);
+    }
+    // Step 5: Continue collecting lines until the next input prompt or end of buffer.
+    for (let i = firstOutputIdx + 1; i < cleaned.length; i++) {
+        if (cleaned[i].promptType === "input") {
+            // Stop at the next input prompt
+            break;
+        }
+        // If this line has a prompt marker but it's not an input, skip the marker
+        if (cleaned[i].promptType === "output") {
+            const msg = extractMessageAfterPrompt(cleaned[i].text);
+            if (msg) {
+                replyLines.push(msg);
+            }
+        }
+        else {
+            // Regular continuation line
+            const continuation = cleaned[i].text.trim();
+            if (continuation.length > 0) {
+                replyLines.push(continuation);
+            }
+        }
+    }
+    // Step 6: Join and return
+    return replyLines.join("\n").trim();
+}
+//# sourceMappingURL=chat-output-parser.js.map

package/dist/core/chat-output-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-output-parser.js","sourceRoot":"","sources":["../../src/core/chat-output-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,0CAA0C;IAC1C,0FAA0F;IAC1F,OAAO,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,6BAA6B;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEvC,oDAAoD;IACpD,IAAI,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,yCAAyC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,wCAAwC;IACxC,IAAI,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACvE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB,CAAC,IAAY;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,wCAAwC;IACxC,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEpC,uDAAuD;IACvD,MAAM,OAAO,GACX,EAAE,CAAC;IAEL,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAEpC,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,8DAA8D;YAC9D,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC;YACX,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,MAAM;YACZ,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IAChE,oFAAoF;IACpF,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;YACtC,cAAc,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,MAAM;QACR,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,IAAI,cAAc,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,cAAc,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACvC,cAAc,GAAG,CAAC,CAAC;YACnB,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,iEAAiE;QACjE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,iEAAiE;IACjE,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,yBAAyB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC;IACzE,IAAI,QAAQ,EAAE,CAAC;QACb,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,kFAAkF;IAClF,KAAK,IAAI,CAAC,GAAG,cAAc,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzD,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;YACtC,gCAAgC;YAChC,MAAM;QACR,CAAC;QAED,0EAA0E;QAC1E,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvD,IAAI,GAAG,EAAE,CAAC;gBACR,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,4BAA4B;YAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACtC,CAAC"}

package/dist/core/chat-output-parser.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for chat-output-parser (GH-891 Phase 1)
+ *
+ * Tests extraction of clean LLM replies from raw tmux capture,
+ * including removal of ANSI codes, prompt characters, and tmux chrome.
+ */
+export {};

package/dist/core/chat-output-parser.test.js

@@ -0,0 +1,151 @@
+/**
+ * Unit tests for chat-output-parser (GH-891 Phase 1)
+ *
+ * Tests extraction of clean LLM replies from raw tmux capture,
+ * including removal of ANSI codes, prompt characters, and tmux chrome.
+ */
+import assert from "node:assert/strict";
+import test from "node:test";
+import { extractLLMReply } from "./chat-output-parser.js";
+test("extractLLMReply - basic reply extraction", () => {
+    const raw = `▐▛███▜▌   Claude Code v2.1.88
+▝▜█████▛▘  Haiku 4.5 with high effort · Claude Max
+  ▘▘ ▝▝    ~/Dev/agentmesh-mesh-dev-2
+
+❯ [AgentMesh] Connected and ready...
+⏺ Ready and connected. I understand the system...
+❯ ping - test chat
+⏺ Pong. Chat is live and connected. Ready to assist.
+❯ `;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Pong. Chat is live and connected. Ready to assist.");
+});
+test("extractLLMReply - multi-line response", () => {
+    const raw = `❯ tell me a story
+⏺ Once upon a time,
+there was a kingdom.
+❯ `;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Once upon a time,\nthere was a kingdom.");
+});
+test("extractLLMReply - strips ANSI codes", () => {
+    const raw = `❯ hello
+⏺ \x1b[32mGreen\x1b[0m text
+❯ `;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Green text");
+});
+test("extractLLMReply - handles empty input", () => {
+    const result = extractLLMReply("");
+    assert.strictEqual(result, "");
+});
+test("extractLLMReply - handles whitespace-only input", () => {
+    const result = extractLLMReply("   \n  \n  ");
+    assert.strictEqual(result, "");
+});
+test("extractLLMReply - no output prompt found", () => {
+    const raw = `❯ hello
+some random text`;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "");
+});
+test("extractLLMReply - strips logo and chrome", () => {
+    const raw = `▐▛███▜▌   Claude Code v2.1.88
+▝▜█████▛▘  Sonnet 4.6 · High Effort
+  ▘▘ ▝▝    ~/project
+
+❯ test
+⏺ Clean output
+❯ `;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Clean output");
+});
+test("extractLLMReply - response with blank lines", () => {
+    const raw = `❯ query
+⏺ First paragraph.
+
+Second paragraph.
+❯ `;
+    const result = extractLLMReply(raw);
+    // Empty lines between paragraphs should be preserved
+    assert.strictEqual(result, "First paragraph.\n\nSecond paragraph.");
+});
+test("extractLLMReply - last output prompt wins", () => {
+    const raw = `❯ first
+⏺ First reply
+❯ second
+⏺ Second reply
+❯ `;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Second reply");
+});
+test("extractLLMReply - handles trailing empty lines", () => {
+    const raw = `❯ hello
+⏺ Response
+
+
+❯ `;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Response");
+});
+test("extractLLMReply - only extracts until next input prompt", () => {
+    const raw = `❯ first query
+⏺ Response to first
+More response content
+❯ second query`;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Response to first\nMore response content");
+});
+test("extractLLMReply - complex real-world example", () => {
+    const raw = `▐▛███▜▌   Claude Code v2.1.88
+▝▜█████▛▘  Haiku 4.5 · High Effort
+  ▘▘ ▝▝    ~/Dev/project
+
+❯ [Handoff] Task: implement feature X
+⏺ I understand. Let me start by reading the requirements.
+❯ [User] What's your plan?
+⏺ Here's my plan:
+
+1. Read the specification
+2. Create tests
+3. Implement the feature
+
+I'll start now.
+❯ `;
+    const result = extractLLMReply(raw);
+    const expected = "Here's my plan:\n\n1. Read the specification\n2. Create tests\n3. Implement the feature\n\nI'll start now.";
+    assert.strictEqual(result, expected);
+});
+test("extractLLMReply - handles colored box-drawing characters", () => {
+    const raw = `╔════════════════════════════╗
+║     Claude Code v2        ║
+╚════════════════════════════╝
+
+❯ command
+⏺ Result
+❯ `;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Result");
+});
+test("extractLLMReply - codex prompt markers (›/•)", () => {
+    const raw = `› Hello!
+• Hi. What do you want to work on in this repo?
+› Summarize recent commits
+• Sure — here's a quick summary:
+• - Added runtime chat ACK wiring
+• - Fixed local workspace routing
+› `;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Sure — here's a quick summary:\n- Added runtime chat ACK wiring\n- Fixed local workspace routing");
+});
+test("extractLLMReply - codex multiline output continuation", () => {
+    const raw = `› Plan this work
+• Here's a concrete plan:
+1. Reproduce the issue.
+2. Patch parser.
+3. Validate E2E.
+› `;
+    const result = extractLLMReply(raw);
+    assert.strictEqual(result, "Here's a concrete plan:\n1. Reproduce the issue.\n2. Patch parser.\n3. Validate E2E.");
+});
+//# sourceMappingURL=chat-output-parser.test.js.map

package/dist/core/chat-output-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-output-parser.test.js","sourceRoot":"","sources":["../../src/core/chat-output-parser.test.ts"],"names":[],"mappings":"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"}

package/dist/core/daemon/bootstrap.d.ts

@@ -10,6 +10,10 @@ export interface BootstrapOptions {
     autoSetup?: boolean;
     serve?: boolean;
     servePort?: number;
+    serveHostname?: string;
+    servePublicUrl?: string;
+    serveUsername?: string;
+    servePasswordEnv?: string;
     sandbox?: boolean;
     sandboxImage?: string;
     sandboxCpu?: string;
@@ -27,6 +31,10 @@ export interface DaemonBootstrap {
     autoSetup: boolean;
     serveMode: boolean;
     servePort: number;
+    serveHostname: string;
+    servePublicUrl?: string;
+    serveUsername?: string;
+    servePasswordEnv?: string;
     sandboxMode: boolean;
     sandboxImage: string;
     sandboxCpu: string;

package/dist/core/daemon/bootstrap.js

@@ -1,4 +1,5 @@
 import { loadConfig } from "../../config/loader.js";
+import { DEFAULT_OPENCODE_SERVE_HOSTNAME, DEFAULT_OPENCODE_SERVE_PORT } from "../opencode-serve.js";
 import { buildRunnerConfig } from "../runner.js";
 import { isKnownRole, ROLE_DAEMON_BEHAVIOUR } from "./roles.js";
 /**
@@ -60,7 +61,11 @@ export function bootstrapDaemon(options) {
         isWorkerAgent: workerMode,
         autoSetup: options.autoSetup === true,
         serveMode: options.serve === true,
-        servePort: options.servePort || 3001,
+        servePort: options.servePort || DEFAULT_OPENCODE_SERVE_PORT,
+        serveHostname: options.serveHostname || DEFAULT_OPENCODE_SERVE_HOSTNAME,
+        servePublicUrl: options.servePublicUrl?.trim() || undefined,
+        serveUsername: options.serveUsername?.trim() || undefined,
+        servePasswordEnv: options.servePasswordEnv?.trim() || undefined,
         sandboxMode: options.sandbox === true,
         sandboxImage: options.sandboxImage || "agentmesh/agent-sandbox:latest",
         sandboxCpu: options.sandboxCpu || "1",

package/dist/core/daemon/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/core/daemon/bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/core/daemon/bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/core/daemon/crash-log.js

@@ -1,7 +1,10 @@
+import { formatDiagnosticSummary } from "./startup-diagnostics.js";
 /**
  * Formats a structured crash entry for on-disk diagnostics.
  */
 export function formatCrashLog(input) {
+    // Include startup diagnostics if available
+    const startupDiagnostics = formatDiagnosticSummary(input.agentName);
     return `
 ================================================================================
 AGENT CRASH DETECTED
@@ -14,6 +17,8 @@ Sandbox: ${input.sandboxLabel}
 Workdir: ${input.workdir}
 Model: ${input.model}
 
+${startupDiagnostics}
+
 --- Last Session Output ---
 ${input.lastOutput}
 ================================================================================

package/dist/core/daemon/crash-log.js.map

@@ -1 +1 @@
-{"version":3,"file":"crash-log.js","sourceRoot":"","sources":["../../../src/core/daemon/crash-log.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,OAAO;;;;aAII,KAAK,CAAC,SAAS;SACnB,KAAK,CAAC,SAAS;YACZ,KAAK,CAAC,OAAO;UACf,KAAK,CAAC,MAAM;WACX,KAAK,CAAC,YAAY;WAClB,KAAK,CAAC,OAAO;SACf,KAAK,CAAC,KAAK;;;EAGlB,KAAK,CAAC,UAAU;;;CAGjB,CAAC;AACF,CAAC"}
+{"version":3,"file":"crash-log.js","sourceRoot":"","sources":["../../../src/core/daemon/crash-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAanE;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,2CAA2C;IAC3C,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEpE,OAAO;;;;aAII,KAAK,CAAC,SAAS;SACnB,KAAK,CAAC,SAAS;YACZ,KAAK,CAAC,OAAO;UACf,KAAK,CAAC,MAAM;WACX,KAAK,CAAC,YAAY;WAClB,KAAK,CAAC,OAAO;SACf,KAAK,CAAC,KAAK;;EAElB,kBAAkB;;;EAGlB,KAAK,CAAC,UAAU;;;CAGjB,CAAC;AACF,CAAC"}

package/dist/core/daemon/injection-verify.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Handoff injection verification — confirms the LLM actually started
+ * processing an injected handoff by monitoring tmux output changes.
+ *
+ * Also detects rate-limit patterns to pause auto-acceptance.
+ *
+ * Epic #887
+ */
+export interface InjectionResult {
+    verified: boolean;
+    rateLimited: boolean;
+    attempts: number;
+}
+/**
+ * After injecting a handoff into tmux, poll output to verify the LLM
+ * acknowledged it. Re-injects up to maxRetries times if no activity.
+ *
+ * Returns whether the injection was verified, and whether a rate limit
+ * was detected.
+ */
+export declare function verifyInjection(agentName: string, handoffId: string, handoffScope: string, maxRetries?: number): Promise<InjectionResult>;
+/**
+ * Scan tmux output for rate-limit indicators.
+ */
+export declare function isRateLimited(output: string): boolean;

package/dist/core/daemon/injection-verify.js

@@ -0,0 +1,94 @@
+/**
+ * Handoff injection verification — confirms the LLM actually started
+ * processing an injected handoff by monitoring tmux output changes.
+ *
+ * Also detects rate-limit patterns to pause auto-acceptance.
+ *
+ * Epic #887
+ */
+import { captureSessionOutput, sendKeys } from "../tmux.js";
+const RATE_LIMIT_PATTERNS = [
+    "hit your limit",
+    "rate limit",
+    "resets ",
+    "usage limit",
+    "too many requests",
+    "quota exceeded",
+];
+/**
+ * After injecting a handoff into tmux, poll output to verify the LLM
+ * acknowledged it. Re-injects up to maxRetries times if no activity.
+ *
+ * Returns whether the injection was verified, and whether a rate limit
+ * was detected.
+ */
+export async function verifyInjection(agentName, handoffId, handoffScope, maxRetries = 2) {
+    const result = { verified: false, rateLimited: false, attempts: 1 };
+    // Capture baseline output before checking
+    const baseline = captureSessionOutput(agentName, 30) || "";
+    // Check for rate limit in current output
+    if (isRateLimited(baseline)) {
+        console.log(`[INJECT-VERIFY] Rate limit detected for ${agentName}`);
+        result.rateLimited = true;
+        return result;
+    }
+    // Wait and check if output changed (LLM is processing)
+    const verified = await pollForActivity(agentName, baseline, 30_000);
+    if (verified) {
+        result.verified = true;
+        return result;
+    }
+    // No activity — retry injection
+    for (let retry = 0; retry < maxRetries; retry++) {
+        result.attempts += 1;
+        console.log(`[INJECT-VERIFY] Re-injecting handoff ${handoffId} (attempt ${result.attempts})`);
+        const reminderMsg = `[AgentMesh] Reminder: You accepted handoff ${handoffId}. Scope: ${handoffScope}. Please start working on it.`;
+        const sent = sendKeys(agentName, reminderMsg);
+        if (!sent) {
+            console.warn(`[INJECT-VERIFY] Failed to re-inject into ${agentName}`);
+            continue;
+        }
+        // Wait a bit then check output
+        await sleep(5000);
+        const current = captureSessionOutput(agentName, 30) || "";
+        // Check rate limit after re-injection
+        if (isRateLimited(current)) {
+            console.log(`[INJECT-VERIFY] Rate limit detected after retry for ${agentName}`);
+            result.rateLimited = true;
+            return result;
+        }
+        const retryVerified = await pollForActivity(agentName, current, 20_000);
+        if (retryVerified) {
+            result.verified = true;
+            return result;
+        }
+    }
+    console.warn(`[INJECT-VERIFY] Handoff ${handoffId} not verified after ${result.attempts} attempts`);
+    return result;
+}
+/**
+ * Scan tmux output for rate-limit indicators.
+ */
+export function isRateLimited(output) {
+    const lower = output.toLowerCase();
+    return RATE_LIMIT_PATTERNS.some((pattern) => lower.includes(pattern));
+}
+/**
+ * Poll tmux output for changes over a duration. Returns true if output changes.
+ */
+async function pollForActivity(agentName, baseline, durationMs) {
+    const pollInterval = 5000;
+    const polls = Math.ceil(durationMs / pollInterval);
+    for (let i = 0; i < polls; i++) {
+        await sleep(pollInterval);
+        const current = captureSessionOutput(agentName, 30) || "";
+        if (current !== baseline) {
+            return true;
+        }
+    }
+    return false;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=injection-verify.js.map

package/dist/core/daemon/injection-verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-verify.js","sourceRoot":"","sources":["../../../src/core/daemon/injection-verify.ts"],"names":[],"mappings":"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"}

package/dist/core/daemon/roles.d.ts

@@ -6,7 +6,7 @@
  */
 /** Canonical set of predefined roles. Free-form strings are still accepted for
  *  hub auto-assignment but will not activate role-specific daemon behaviour. */
-export type AgentRole = "coordinator" | "developer" | "reviewer" | "lead" | "observer";
+export type AgentRole = "coordinator" | "developer" | "reviewer" | "lead" | "observer" | "watcher";
 export declare const VALID_ROLES: readonly AgentRole[];
 export declare function isKnownRole(role: string): role is AgentRole;
 /**
@@ -22,4 +22,4 @@ export declare const ROLE_SYSTEM_PROMPTS: Record<AgentRole, string>;
  *
  * Replaces inferAttendedFromRole() in bootstrap.ts for known roles.
  */
-export declare const ROLE_DAEMON_BEHAVIOUR: Record<AgentRole, "lead-loop" | "worker" | "observer">;
+export declare const ROLE_DAEMON_BEHAVIOUR: Record<AgentRole, "lead-loop" | "worker" | "observer" | "watcher-loop">;

package/dist/core/daemon/roles.js

@@ -10,6 +10,7 @@ export const VALID_ROLES = [
     "reviewer",
     "lead",
     "observer",
+    "watcher",
 ];
 export function isKnownRole(role) {
     return VALID_ROLES.includes(role);
@@ -24,6 +25,7 @@ export const ROLE_SYSTEM_PROMPTS = {
     reviewer: "You are a reviewer agent. Your job is to review pull requests and handoff proposals for correctness, quality, and consistency. Approve, request changes, or reject with clear reasoning.",
     lead: "You are a lead agent. You coordinate the team, route work to the right agents, monitor SLAs, and escalate blockers. You also review high-level architecture decisions.",
     observer: "You are an observer agent. You monitor team activity and provide strategic input when asked. You do not accept handoffs automatically and do not modify code directly.",
+    watcher: "You are a watcher agent. Every ~2 minutes you receive a project state snapshot showing handoffs, agent health, blockers, and claims. Analyze the state and take corrective actions using agentmesh CLI commands: nudge stuck agents, escalate breached SLAs, reassign stalled handoffs, create blockers, release stale claims. Process one tick at a time — after analysis and action, wait for the next tick. Do not take actions unprompted between ticks.",
 };
 /**
  * Maps each predefined role to a daemon behaviour mode:
@@ -39,5 +41,6 @@ export const ROLE_DAEMON_BEHAVIOUR = {
     reviewer: "worker",
     lead: "lead-loop",
     observer: "observer",
+    watcher: "watcher-loop",
 };
 //# sourceMappingURL=roles.js.map

package/dist/core/daemon/roles.js.map

@@ -1 +1 @@
-{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../../src/core/daemon/roles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,aAAa;IACb,WAAW;IACX,UAAU;IACV,MAAM;IACN,UAAU;CACX,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAQ,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B;IAC5D,WAAW,EACT,8LAA8L;IAChM,SAAS,EACP,mJAAmJ;IACrJ,QAAQ,EACN,0LAA0L;IAC5L,IAAI,EAAE,wKAAwK;IAC9K,QAAQ,EACN,wKAAwK;CAC3K,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2D;IAC3F,WAAW,EAAE,WAAW;IACxB,SAAS,EAAE,QAAQ;IACnB,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,UAAU;CACrB,CAAC"}
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../../src/core/daemon/roles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,aAAa;IACb,WAAW;IACX,UAAU;IACV,MAAM;IACN,UAAU;IACV,SAAS;CACV,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAQ,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B;IAC5D,WAAW,EACT,8LAA8L;IAChM,SAAS,EACP,mJAAmJ;IACrJ,QAAQ,EACN,0LAA0L;IAC5L,IAAI,EAAE,wKAAwK;IAC9K,QAAQ,EACN,wKAAwK;IAC1K,OAAO,EACL,8bAA8b;CACjc,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAG9B;IACF,WAAW,EAAE,WAAW;IACxB,SAAS,EAAE,QAAQ;IACnB,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,cAAc;CACxB,CAAC"}

package/dist/core/daemon/session-recovery.d.ts

@@ -1 +1,18 @@
-export declare function isRecoverableSessionFailure(reason: string): boolean;
+import { type ProcessExitEvent } from "./startup-diagnostics.js";
+/**
+ * Gets the most recent process exit event from diagnostics
+ */
+export declare function getLastProcessExit(agentName: string): ProcessExitEvent | null;
+/**
+ * Determines if a session failure is recoverable based on the reason
+ * and startup diagnostics.
+ *
+ * A failure is considered recoverable if:
+ * 1. The reason matches known recoverable patterns
+ * 2. The process exited during startup (within 15s) AND the exit event is fresh
+ *    (within 60s) - this suggests a transient issue that may resolve on retry
+ *
+ * The freshness guard prevents old exit events from misclassifying unrelated
+ * future failures as recoverable.
+ */
+export declare function isRecoverableSessionFailure(reason: string, agentName?: string): boolean;