@agentmeshhq/agent 0.4.15 → 0.4.18

package/dist/core/daemon/lead-loop.js

@@ -0,0 +1,155 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+function ciGreen(pr) {
+    const checks = pr.statusCheckRollup;
+    if (!checks || checks.length === 0)
+        return true; // no checks = assume green
+    return checks.every((c) => {
+        if (c.conclusion)
+            return c.conclusion === "SUCCESS";
+        if (c.state)
+            return c.state === "SUCCESS";
+        return false;
+    });
+}
+/** Fetch the reviewer agent ID from the hub at tick time. */
+async function resolveReviewerAgentId(hubUrl, workspace, token) {
+    try {
+        const res = await fetch(`${hubUrl}/api/v1/workspaces/${workspace}/agents`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        const agents = body.data ?? [];
+        // Find agent with role "reviewer" or display_name containing "reviewer"
+        const reviewer = agents.find((a) => a.metadata?.role === "reviewer" || a.display_name?.toLowerCase().includes("reviewer"));
+        return reviewer?.agent_id ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check whether an active (non-completed, non-rejected) handoff already exists
+ * for this PR number sent from this agent.
+ */
+async function handoffExistsForPr(hubUrl, workspace, token, prNumber) {
+    try {
+        const res = await fetch(`${hubUrl}/api/v1/workspaces/${workspace}/handoffs?limit=50`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok)
+            return false;
+        const body = (await res.json());
+        const handoffs = body.data ?? [];
+        return handoffs.some((h) => h.scope?.includes(`#${prNumber}`) && h.status !== "completed" && h.status !== "rejected");
+    }
+    catch {
+        return false;
+    }
+}
+/** Create a handoff to the reviewer agent for this PR. */
+async function createReviewHandoff(hubUrl, workspace, token, reviewerAgentId, pr) {
+    try {
+        const res = await fetch(`${hubUrl}/api/v1/workspaces/${workspace}/handoffs`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                to_agent_id: reviewerAgentId,
+                scope: `Review PR #${pr.number}: ${pr.title}`,
+                reason: `PR #${pr.number} (${pr.headRefName}) is open and needs review before merge.`,
+                metadata: { pr_number: pr.number, watcher_generated: true },
+            }),
+        });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        return body.handoff_id ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * One coordination tick for a lead agent:
+ *  1. Poll open PRs via `gh pr list`
+ *  2. Update BEHIND branches via `gh pr update-branch`
+ *  3. Route unreviewed PRs to the reviewer via hub handoffs
+ *  4. Merge APPROVED + CI-green + MERGEABLE PRs
+ */
+export async function runLeadTick(ctx) {
+    const run = ctx.exec ?? execAsync;
+    let prs;
+    try {
+        const { stdout } = await run("gh pr list --state open --json number,title,headRefName,mergeable,reviewDecision,statusCheckRollup");
+        prs = JSON.parse(stdout.trim());
+    }
+    catch (err) {
+        ctx.log(`[lead-tick] Failed to list PRs: ${err.message}`);
+        return;
+    }
+    if (prs.length === 0) {
+        ctx.log("[lead-tick] No open PRs.");
+        return;
+    }
+    // Resolve reviewer once per tick
+    const reviewerAgentId = ctx.reviewerAgentId ?? (await resolveReviewerAgentId(ctx.hubUrl, ctx.workspace, ctx.token));
+    let updated = 0;
+    let routed = 0;
+    let merged = 0;
+    let skipped = 0;
+    for (const pr of prs) {
+        try {
+            // 1. Update BEHIND branches
+            if (pr.mergeable === "BEHIND") {
+                try {
+                    await run(`gh pr update-branch ${pr.number}`);
+                    ctx.log(`[lead-tick] PR #${pr.number}: updated BEHIND branch`);
+                    updated++;
+                }
+                catch (err) {
+                    ctx.log(`[lead-tick] PR #${pr.number}: update-branch failed: ${err.message}`);
+                }
+            }
+            // 2. Route unreviewed PRs to reviewer
+            if ((!pr.reviewDecision || pr.reviewDecision === "REVIEW_REQUIRED") && reviewerAgentId) {
+                const alreadySent = await handoffExistsForPr(ctx.hubUrl, ctx.workspace, ctx.token, pr.number);
+                if (!alreadySent) {
+                    const handoffId = await createReviewHandoff(ctx.hubUrl, ctx.workspace, ctx.token, reviewerAgentId, pr);
+                    if (handoffId) {
+                        ctx.log(`[lead-tick] PR #${pr.number}: review handoff created → ${handoffId}`);
+                        routed++;
+                    }
+                    else {
+                        ctx.log(`[lead-tick] PR #${pr.number}: failed to create review handoff`);
+                    }
+                }
+            }
+            // 3. Merge APPROVED + CI-green + MERGEABLE PRs
+            if (pr.reviewDecision === "APPROVED" && pr.mergeable === "MERGEABLE" && ciGreen(pr)) {
+                try {
+                    await run(`gh pr merge ${pr.number} --squash --delete-branch`);
+                    ctx.log(`[lead-tick] PR #${pr.number}: merged`);
+                    merged++;
+                }
+                catch (err) {
+                    ctx.log(`[lead-tick] PR #${pr.number}: merge failed: ${err.message}`);
+                }
+            }
+            else if (pr.reviewDecision === "APPROVED") {
+                skipped++;
+                ctx.log(`[lead-tick] PR #${pr.number}: approved but not mergeable (mergeable=${pr.mergeable}, ci=${ciGreen(pr)})`);
+            }
+        }
+        catch (err) {
+            ctx.log(`[lead-tick] PR #${pr.number}: unexpected error: ${err.message}`);
+        }
+    }
+    ctx.log(`[lead-tick] done — prs=${prs.length} updated=${updated} routed=${routed} merged=${merged} skipped=${skipped}`);
+}
+//# sourceMappingURL=lead-loop.js.map

package/dist/core/daemon/lead-loop.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Predefined agent roles — each role activates specific daemon behaviour and
+ * injects a role-scoped system prompt into the agent's CLAUDE.md context.
+ *
+ * Adding a new role requires updating all three exports below.
+ */
+/** 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" | "watcher";
+export declare const VALID_ROLES: readonly AgentRole[];
+export declare function isKnownRole(role: string): role is AgentRole;
+/**
+ * System prompt injected into CLAUDE.md for each predefined role.
+ * Injected at session start — works for all runners (opencode, claude, codex, custom).
+ */
+export declare const ROLE_SYSTEM_PROMPTS: Record<AgentRole, string>;
+/**
+ * Maps each predefined role to a daemon behaviour mode:
+ *  - "lead-loop"  → starts runLeadTick every 2 minutes
+ *  - "worker"     → standard inbox poll + auto-accept handoffs
+ *  - "observer"   → heartbeat only; no auto-accept, no lead loop
+ *
+ * Replaces inferAttendedFromRole() in bootstrap.ts for known roles.
+ */
+export declare const ROLE_DAEMON_BEHAVIOUR: Record<AgentRole, "lead-loop" | "worker" | "observer" | "watcher-loop">;

package/dist/core/daemon/roles.js

@@ -0,0 +1,46 @@
+/**
+ * Predefined agent roles — each role activates specific daemon behaviour and
+ * injects a role-scoped system prompt into the agent's CLAUDE.md context.
+ *
+ * Adding a new role requires updating all three exports below.
+ */
+export const VALID_ROLES = [
+    "coordinator",
+    "developer",
+    "reviewer",
+    "lead",
+    "observer",
+    "watcher",
+];
+export function isKnownRole(role) {
+    return VALID_ROLES.includes(role);
+}
+/**
+ * System prompt injected into CLAUDE.md for each predefined role.
+ * Injected at session start — works for all runners (opencode, claude, codex, custom).
+ */
+export const ROLE_SYSTEM_PROMPTS = {
+    coordinator: "You are a coordinator agent. Your job is to route work, manage PR reviews via handoffs, and merge approved pull requests. Do not implement features yourself — delegate to developer agents.",
+    developer: "You are a developer agent. Your job is to implement features and bug fixes assigned via handoffs, write tests, and open pull requests for review.",
+    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:
+ *  - "lead-loop"  → starts runLeadTick every 2 minutes
+ *  - "worker"     → standard inbox poll + auto-accept handoffs
+ *  - "observer"   → heartbeat only; no auto-accept, no lead loop
+ *
+ * Replaces inferAttendedFromRole() in bootstrap.ts for known roles.
+ */
+export const ROLE_DAEMON_BEHAVIOUR = {
+    coordinator: "lead-loop",
+    developer: "worker",
+    reviewer: "worker",
+    lead: "lead-loop",
+    observer: "observer",
+    watcher: "watcher-loop",
+};
+//# sourceMappingURL=roles.js.map

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

@@ -0,0 +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;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;

package/dist/core/daemon/session-recovery.js

@@ -1,7 +1,91 @@
-export function isRecoverableSessionFailure(reason) {
-    return (reason === "session_not_found" ||
-        reason === "pane_dead" ||
-        reason === "no_pid" ||
-        reason.startsWith("check_failed"));
+import { readStartupDiagnostics } from "./startup-diagnostics.js";
+/**
+ * Extended reasons that can indicate a recoverable session failure
+ */
+const RECOVERABLE_REASONS = [
+    "session_not_found",
+    "pane_dead",
+    "no_pid",
+    "pane_died",
+    "process_replaced",
+    "session_terminated",
+];
+/**
+ * Maximum age of an exit event to consider it relevant (60 seconds)
+ * Exit events older than this are considered stale and unrelated to current failures
+ */
+const MAX_EXIT_EVENT_AGE_MS = 60000;
+/**
+ * Startup window - if process exits within this time of startup, it's recoverable
+ */
+const STARTUP_WINDOW_MS = 15000;
+/**
+ * Check if a reason string matches recoverable patterns
+ */
+function matchesRecoverablePattern(reason) {
+    return (RECOVERABLE_REASONS.includes(reason) ||
+        reason.startsWith("check_failed") ||
+        reason.startsWith("session_creation_failed") ||
+        reason.startsWith("pane_dead"));
+}
+/**
+ * Gets the most recent process exit event from diagnostics
+ */
+export function getLastProcessExit(agentName) {
+    const entries = readStartupDiagnostics(agentName);
+    // Find the most recent exit entry
+    for (let i = entries.length - 1; i >= 0; i--) {
+        if (entries[i].type === "exit") {
+            return entries[i].data;
+        }
+    }
+    return 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 function isRecoverableSessionFailure(reason, agentName) {
+    // First check pattern match
+    if (matchesRecoverablePattern(reason)) {
+        return true;
+    }
+    // If we have agent name, check startup diagnostics
+    if (agentName) {
+        const entries = readStartupDiagnostics(agentName);
+        let lastExit = null;
+        for (let i = entries.length - 1; i >= 0; i--) {
+            if (entries[i].type === "exit") {
+                lastExit = {
+                    exit: entries[i].data,
+                    timestamp: entries[i].timestamp,
+                };
+                break;
+            }
+        }
+        if (lastExit) {
+            // Check freshness: exit event must be recent enough to be relevant
+            const exitTimestamp = new Date(lastExit.timestamp).getTime();
+            const now = Date.now();
+            const exitAgeMs = now - exitTimestamp;
+            // Only consider fresh exit events (within last 60 seconds)
+            if (exitAgeMs <= MAX_EXIT_EVENT_AGE_MS) {
+                // If process exited within 15 seconds of startup, consider it recoverable
+                // This catches cases where the runner crashed immediately
+                if (lastExit.exit.elapsedMs < STARTUP_WINDOW_MS) {
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
 }
 //# sourceMappingURL=session-recovery.js.map

package/dist/core/daemon/session-recovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-recovery.js","sourceRoot":"","sources":["../../../src/core/daemon/session-recovery.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,2BAA2B,CAAC,MAAc;IACxD,OAAO,CACL,MAAM,KAAK,mBAAmB;QAC9B,MAAM,KAAK,WAAW;QACtB,MAAM,KAAK,QAAQ;QACnB,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAClC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"session-recovery.js","sourceRoot":"","sources":["../../../src/core/daemon/session-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEzF;;GAEG;AACH,MAAM,mBAAmB,GAAG;IAC1B,mBAAmB;IACnB,WAAW;IACX,QAAQ;IACR,WAAW;IACX,kBAAkB;IAClB,oBAAoB;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC;;GAEG;AACH,SAAS,yBAAyB,CAAC,MAAc;IAC/C,OAAO,CACL,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpC,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC;QACjC,MAAM,CAAC,UAAU,CAAC,yBAAyB,CAAC;QAC5C,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,OAAO,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAClD,kCAAkC;IAClC,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,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,IAAwB,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAc,EAAE,SAAkB;IAC5E,4BAA4B;IAC5B,IAAI,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mDAAmD;IACnD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAOlD,IAAI,QAAQ,GAAqB,IAAI,CAAC;QAEtC,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC/B,QAAQ,GAAG;oBACT,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAwB;oBACzC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;iBAChC,CAAC;gBACF,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,mEAAmE;YACnE,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,GAAG,GAAG,aAAa,CAAC;YAEtC,2DAA2D;YAC3D,IAAI,SAAS,IAAI,qBAAqB,EAAE,CAAC;gBACvC,0EAA0E;gBAC1E,0DAA0D;gBAC1D,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,iBAAiB,EAAE,CAAC;oBAChD,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/daemon/startup-diagnostics.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Startup Diagnostics for Agent Tmux Sessions
+ *
+ * Provides structured logging for runner startup to diagnose
+ * session creation failures and early exits.
+ */
+export interface StartupDiagnostics {
+    /** The final resolved command (with args) that was executed */
+    resolvedCommand: string;
+    /** Environment variables set (keys only, values redacted) */
+    envKeys: string[];
+    /** Session name used for tmux */
+    sessionName: string;
+    /** Working directory for the session */
+    workdir?: string;
+    /** Timestamp when session creation started */
+    startTime: string;
+    /** Runner type detected */
+    runnerKind: "opencode" | "claude" | "codex" | "other";
+    /** Whether autonomous mode was enabled */
+    autonomous?: boolean;
+}
+export interface ProcessExitEvent {
+    /** Exit code (null if killed by signal) */
+    code: number | null;
+    /** Signal that killed the process (null if exited normally) */
+    signal: string | null;
+    /** Time elapsed since session creation (ms) */
+    elapsedMs: number;
+    /** Reason classification */
+    reason: string;
+}
+interface DiagnosticsEntry {
+    type: "startup" | "exit";
+    timestamp: string;
+    agentName: string;
+    data: StartupDiagnostics | ProcessExitEvent;
+}
+/**
+ * Redacts sensitive environment variable values, keeping only keys
+ */
+export declare function redactEnvKeys(env: Record<string, string | undefined>): string[];
+/**
+ * Detects the runner type from the command
+ */
+export declare function detectRunnerKind(command: string): "opencode" | "claude" | "codex" | "other";
+/**
+ * Logs startup diagnostics for a new tmux session
+ */
+export declare function logSessionStartup(agentName: string, diagnostics: StartupDiagnostics): void;
+/**
+ * Logs a process exit event
+ */
+export declare function logProcessExit(agentName: string, exitEvent: ProcessExitEvent): void;
+/**
+ * Reads the recent diagnostics for an agent
+ */
+export declare function readStartupDiagnostics(agentName: string): DiagnosticsEntry[];
+/**
+ * Clears old diagnostics for an agent (keeps last 100 entries)
+ */
+export declare function cleanupOldDiagnostics(agentName: string): void;
+/**
+ * Captures the current pane PID for an agent's session
+ */
+export declare function capturePanePid(sessionName: string): number | null;
+/**
+ * Monitors a tmux session for early process exit
+ * Returns a cleanup function to stop monitoring
+ */
+export declare function monitorSessionExit(agentName: string, sessionName: string, startTime: Date, onEarlyExit?: (event: ProcessExitEvent) => void): () => void;
+/**
+ * Formats a diagnostic summary for display
+ */
+export declare function formatDiagnosticSummary(agentName: string): string;
+export {};