@agentmeshhq/agent 0.4.6 → 0.4.11

package/dist/core/auth-sync.js

@@ -0,0 +1,263 @@
+/**
+ * OpenCode auth sync — symlink-first strategy.
+ *
+ * Canonical source: ~/.local/share/opencode/auth.json
+ * Per-agent target:  ~/.agentmesh/opencode-data/<agent>/opencode/auth.json
+ *
+ * Strategy (in order):
+ *   1. If target is already a correct symlink → no-op.
+ *   2. If target is a regular file (stale copy) → backup + replace with symlink.
+ *   3. If target does not exist → create symlink.
+ *   4. If canonical does not exist → no-op (agent must auth manually).
+ *
+ * On any symlink creation failure (e.g. cross-device) → fall back to copy.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const CANONICAL_AUTH_PATH = path.join(os.homedir(), ".local", "share", "opencode", "auth.json");
+/**
+ * Returns the per-agent auth.json path for the given agent name.
+ * Pass `homeDir` to override os.homedir() — useful for testing.
+ */
+export function agentAuthPath(agentName, homeDir = os.homedir()) {
+    return path.join(homeDir, ".agentmesh", "opencode-data", agentName, "opencode", "auth.json");
+}
+/**
+ * Ensures the per-agent auth.json is a symlink to the canonical source.
+ * Safe to call at every agent startup — idempotent.
+ *
+ * @param agentName   - Agent identifier (used to compute per-agent path)
+ * @param canonicalPath - Override canonical auth path (default: ~/.local/share/opencode/auth.json)
+ * @param homeDir       - Override home directory base (default: os.homedir()); useful for tests
+ */
+export function ensureAuthLink(agentName, canonicalPath = CANONICAL_AUTH_PATH, homeDir = os.homedir()) {
+    const targetPath = agentAuthPath(agentName, homeDir);
+    const targetDir = path.dirname(targetPath);
+    // Canonical source must exist; nothing to link if not.
+    if (!fs.existsSync(canonicalPath)) {
+        return {
+            action: "no-op",
+            message: `Canonical auth not found at ${canonicalPath} — skipping link`,
+            ok: false,
+        };
+    }
+    // Ensure parent directory
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    // Check existing target
+    let existingLstat = null;
+    try {
+        existingLstat = fs.lstatSync(targetPath);
+    }
+    catch {
+        // Does not exist — will create
+    }
+    if (existingLstat) {
+        if (existingLstat.isSymbolicLink()) {
+            // Verify it points to the correct canonical path
+            const currentTarget = fs.readlinkSync(targetPath);
+            if (currentTarget === canonicalPath) {
+                return {
+                    action: "symlink-ok",
+                    message: `Auth symlink already correct for ${agentName}`,
+                    ok: true,
+                };
+            }
+            // Points somewhere else — re-link
+            fs.unlinkSync(targetPath);
+        }
+        else if (existingLstat.isFile()) {
+            // Regular file (stale copy) — back it up then replace
+            const backupPath = `${targetPath}.bak.${Date.now()}`;
+            fs.renameSync(targetPath, backupPath);
+        }
+        else {
+            // Unknown (directory, etc.) — remove
+            fs.rmSync(targetPath, { recursive: true, force: true });
+        }
+    }
+    // Create symlink (prefer) or copy (fallback)
+    try {
+        fs.symlinkSync(canonicalPath, targetPath);
+        fs.chmodSync(targetPath, 0o600);
+        return {
+            action: existingLstat?.isFile() ? "symlink-replaced-file" : "symlink-created",
+            message: `Auth symlink created for ${agentName} → ${canonicalPath}`,
+            ok: true,
+        };
+    }
+    catch (symlinkErr) {
+        // Cross-device or permission issue — fall back to copy
+        try {
+            fs.copyFileSync(canonicalPath, targetPath);
+            fs.chmodSync(targetPath, 0o600);
+            return {
+                action: "copy-fallback",
+                message: `Auth copied (symlink failed) for ${agentName}: ${symlinkErr.message}`,
+                ok: true,
+            };
+        }
+        catch (copyErr) {
+            return {
+                action: "no-op",
+                message: `Auth sync failed for ${agentName}: ${copyErr.message}`,
+                ok: false,
+            };
+        }
+    }
+}
+/**
+ * Returns diagnostic status for a single agent's auth link.
+ *
+ * @param agentName     - Agent identifier
+ * @param canonicalPath - Override canonical auth path (default: ~/.local/share/opencode/auth.json)
+ * @param homeDir       - Override home directory base (default: os.homedir()); useful for tests
+ */
+export function getAuthLinkStatus(agentName, canonicalPath = CANONICAL_AUTH_PATH, homeDir = os.homedir()) {
+    const authPath = agentAuthPath(agentName, homeDir);
+    const canonicalExists = fs.existsSync(canonicalPath);
+    let exists = false;
+    let isSymlink = false;
+    let pointsToCanonical = false;
+    let symlinkTarget;
+    let mtime;
+    try {
+        const lstat = fs.lstatSync(authPath);
+        exists = true;
+        isSymlink = lstat.isSymbolicLink();
+        mtime = lstat.mtime;
+        if (isSymlink) {
+            symlinkTarget = fs.readlinkSync(authPath);
+            pointsToCanonical = symlinkTarget === canonicalPath;
+        }
+    }
+    catch {
+        // Not found
+    }
+    return {
+        agentName,
+        authPath,
+        exists,
+        isSymlink,
+        pointsToCanonical,
+        canonicalExists,
+        symlinkTarget,
+        mtime,
+    };
+}
+/**
+ * Returns the list of agent names that have opencode-data directories.
+ *
+ * @param homeDir - Override home directory base (default: os.homedir()); useful for tests
+ */
+export function listManagedAgents(homeDir = os.homedir()) {
+    const dataRoot = path.join(homeDir, ".agentmesh", "opencode-data");
+    if (!fs.existsSync(dataRoot))
+        return [];
+    return fs.readdirSync(dataRoot).filter((name) => {
+        try {
+            return fs.statSync(path.join(dataRoot, name)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/**
+ * Repairs ALL managed agents' auth links.
+ * Returns per-agent results.
+ *
+ * @param canonicalPath - Override canonical auth path (default: ~/.local/share/opencode/auth.json)
+ * @param homeDir       - Override home directory base (default: os.homedir()); useful for tests
+ */
+export function repairAllAuthLinks(canonicalPath = CANONICAL_AUTH_PATH, homeDir = os.homedir()) {
+    const agents = listManagedAgents(homeDir);
+    return agents.map((agentName) => ensureAuthLink(agentName, canonicalPath, homeDir));
+}
+/**
+ * Startup preflight: verify auth is in good shape, auto-repair if not.
+ *
+ * Does NOT make a live provider API call (that would slow down every startup).
+ * It validates:
+ *   1. Canonical auth file exists and is readable
+ *   2. Per-agent auth link is correct (symlink → canonical or readable copy)
+ *   3. Auth JSON has at least one provider entry
+ *
+ * If link is bad → auto-repair via ensureAuthLink.
+ *
+ * @param agentName     - Agent identifier
+ * @param canonicalPath - Override canonical auth path (default: ~/.local/share/opencode/auth.json)
+ * @param homeDir       - Override home directory base (default: os.homedir()); useful for tests
+ */
+export function preflightAuth(agentName, canonicalPath = CANONICAL_AUTH_PATH, homeDir = os.homedir()) {
+    // 1. Canonical auth file check
+    const canonicalOk = (() => {
+        try {
+            return fs.existsSync(canonicalPath) && fs.statSync(canonicalPath).isFile();
+        }
+        catch {
+            return false;
+        }
+    })();
+    if (!canonicalOk) {
+        return {
+            passed: false,
+            linkOk: false,
+            canonicalOk: false,
+            contentOk: false,
+            message: `Canonical auth not found at ${canonicalPath}. Run 'opencode auth login' to authenticate.`,
+        };
+    }
+    // 2. Per-agent link check + auto-repair if needed
+    const status = getAuthLinkStatus(agentName, canonicalPath, homeDir);
+    let linkOk = status.exists && (status.isSymlink ? status.pointsToCanonical : true);
+    let repairResult;
+    if (!linkOk) {
+        repairResult = ensureAuthLink(agentName, canonicalPath, homeDir);
+        linkOk = repairResult.ok;
+    }
+    if (!linkOk) {
+        return {
+            passed: false,
+            linkOk: false,
+            canonicalOk,
+            contentOk: false,
+            repairResult,
+            message: `Auth link repair failed for ${agentName}: ${repairResult?.message ?? "unknown error"}`,
+        };
+    }
+    // 3. Content validity check (parse canonical; must have at least one provider key)
+    const contentOk = (() => {
+        try {
+            const raw = fs.readFileSync(canonicalPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            return Object.keys(parsed).length > 0;
+        }
+        catch {
+            return false;
+        }
+    })();
+    if (!contentOk) {
+        return {
+            passed: false,
+            linkOk,
+            canonicalOk,
+            contentOk: false,
+            repairResult,
+            message: `Auth file at ${canonicalPath} is empty or malformed. Run 'opencode auth login' to re-authenticate.`,
+        };
+    }
+    return {
+        passed: true,
+        linkOk,
+        canonicalOk,
+        contentOk,
+        repairResult,
+        message: repairResult
+            ? `Auth preflight passed (repair applied: ${repairResult.action})`
+            : "Auth preflight passed",
+    };
+}
+//# sourceMappingURL=auth-sync.js.map

package/dist/core/auth-sync.js.map

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

package/dist/core/daemon/context-template.js

@@ -101,6 +101,71 @@ export function generateClaudeMd(onboard, options) {
         lines.push(onboard.project.instructions);
         lines.push("");
     }
+    // ── CLI Reference ────────────────────────────────────────────────
+    lines.push("## AgentMesh CLI");
+    lines.push("");
+    lines.push("Your primary tool. Use `agentmesh --help` for the full command list.");
+    lines.push("");
+    lines.push("| Command | What it does |");
+    lines.push("|---------|-------------|");
+    lines.push("| `agentmesh whoami` | Your identity and registration status |");
+    lines.push("| `agentmesh status` | Hub connectivity and agent health |");
+    lines.push("| `agentmesh inbox` | Show pending handoffs |");
+    lines.push("| `agentmesh handoff accept/complete/reject <id>` | Manage handoff lifecycle |");
+    lines.push("| `agentmesh claims create/list/release` | File-path coordination locks |");
+    lines.push("| `agentmesh token` | Show, refresh, or inspect your JWT token |");
+    lines.push("| `agentmesh logs <name>` | View agent session logs |");
+    lines.push("| `agentmesh attach <name>` | Attach to agent's tmux session |");
+    lines.push("| `agentmesh restart <name>` | Restart agent (preserves ID and model) |");
+    lines.push("| `agentmesh nudge <name> <msg>` | Send a message to a running agent |");
+    lines.push("| `agentmesh ready` | Show available unassigned work |");
+    lines.push("");
+    // ── Daemon ────────────────────────────────────────────────────────
+    lines.push("## How the daemon works");
+    lines.push("");
+    lines.push("When you run `agentmesh start`, the daemon:");
+    lines.push("1. Registers with the hub (or re-attaches if already registered)");
+    lines.push("2. Rewrites this CLAUDE.md with your identity, team, and token");
+    lines.push("3. Opens a tmux session running opencode");
+    lines.push("4. Sends a heartbeat to the hub every 8 seconds to stay `online`");
+    lines.push("5. Listens for incoming handoffs over WebSocket");
+    lines.push("6. In `--worker` mode: auto-accepts handoffs and manages the work cycle");
+    lines.push("");
+    lines.push("**Heartbeat thresholds:** idle >10s · stale >45s · evicted >120s · deleted >12h");
+    lines.push("If deleted, re-register before sending handoffs (see Token section above).");
+    lines.push("");
+    // ── Skills Reference ──────────────────────────────────────────────
+    lines.push("## Available Skills");
+    lines.push("");
+    lines.push("Load these when you need them — not loaded automatically:");
+    lines.push("");
+    lines.push("| Skill | When to load |");
+    lines.push("|-------|-------------|");
+    lines.push("| `agentmesh-testing` | Before running any tests |");
+    lines.push("| `agentmesh-pr-merge` | Before merging a PR |");
+    lines.push("| `agentmesh-git-workflow` | For branching strategy and session completion |");
+    lines.push("| `agentmesh-migrations` | Before touching database schema |");
+    lines.push("| `agentmesh-deploy` | Before deploying to any environment |");
+    lines.push("| `agentmesh-docker` | For Docker build patterns |");
+    lines.push("| `agentmesh-agent-ops` | For agent registration and handoffs |");
+    lines.push("| `agentmesh-local-dev` | For local development environment setup |");
+    lines.push("| `agentmesh-concierge` | For Concierge container management |");
+    lines.push("| `vault-secrets` | For accessing secrets from Vault |");
+    lines.push("");
+    // ── Key Docs ──────────────────────────────────────────────────────
+    lines.push("## Key docs");
+    lines.push("");
+    lines.push("| Doc | What it covers |");
+    lines.push("|-----|---------------|");
+    lines.push("| `docs/TESTING.md` | Full test guide — all levels, ports, diagnosis |");
+    lines.push("| `docs/INFRASTRUCTURE.md` | All environments, server access, DBs, Valkey, registry, deploy pipeline |");
+    lines.push("| `docs/AGENT_TOKENS.md` | Token lifecycle in full detail |");
+    lines.push("| `docs/LOCAL_DEVELOPMENT.md` | Local dev environment setup |");
+    lines.push("| `docs/ENVIRONMENTS.md` | dev / staging / prod definitions |");
+    lines.push("| `docs/CI-CD-PIPELINE.md` | CI/CD architecture |");
+    lines.push("| `docs/TMUX_MESSAGE_DELIVERY.md` | Required tmux message delivery protocol |");
+    lines.push("| `AGENT_API_GUIDE.md` | Full Hub API reference |");
+    lines.push("");
     // ── Footer ────────────────────────────────────────────────────────
     lines.push("---");
     lines.push(`*Generated at ${new Date().toISOString()} by AgentMesh*`);

package/dist/core/daemon/context-template.js.map

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

package/dist/core/daemon/done-state-guard.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Done-State Guard — Epic #497: Restart Continuity
+ *
+ * Determines whether a restarting agent should resume its prior work or come up idle.
+ *
+ * ## Rules (from epic acceptance criteria)
+ * - If prior work is DONE → restart must remain `idle-awaiting-assignment`
+ * - Resume is only allowed when a task is `in_progress` with a valid active claim
+ *
+ * ## Definition of "done" (any true):
+ * 1. Agent has no active claims owned by it
+ * 2. The relevant handoff(s) are completed / rejected / superseded
+ * 3. The last inbox is empty after filtering out completed items
+ *
+ * ## Emitted lifecycle events (structured log):
+ *   `[RESTART] state=resumed  reason=<reason>`
+ *   `[RESTART] state=idle     reason=<reason>`
+ *   `[RESTART] state=blocked  reason=<reason>`
+ */
+import type { ClaimRecord, HandoffRecord, InboxItem } from "../registry.js";
+export type RestartState = "resumed" | "idle" | "blocked";
+export interface RestartDecision {
+    state: RestartState;
+    reason: string;
+}
+export interface DoneStateInput {
+    /** All active claims owned by THIS agent (pre-filtered by agent_id & status=active) */
+    activeClaims: ClaimRecord[];
+    /** All inbox items currently pending for this agent */
+    inboxItems: InboxItem[];
+    /** Recently completed / rejected handoffs that were owned by this agent */
+    completedHandoffs: HandoffRecord[];
+    /** Whether automation is currently paused */
+    automationPaused?: boolean;
+}
+/**
+ * Evaluates whether a restarting agent should resume or stay idle.
+ *
+ * This is a pure function — no side-effects, fully testable.
+ *
+ * @param input - Snapshot of claims, inbox and recent handoff history at restart time
+ * @returns A RestartDecision with state and human-readable reason
+ */
+export declare function evaluateRestartState(input: DoneStateInput): RestartDecision;
+/**
+ * Returns true when the prior work cycle is definitively done.
+ * Convenience wrapper around evaluateRestartState.
+ */
+export declare function isPriorWorkDone(input: DoneStateInput): boolean;
+/**
+ * Formats a structured log line for the restart lifecycle event.
+ * Pattern: `[RESTART] state=<state> reason=<reason>`
+ */
+export declare function formatRestartLifecycleLog(decision: RestartDecision): string;
+/**
+ * Filters a list of claims to only those actively owned by the given agent.
+ */
+export declare function filterActiveClaimsForAgent(claims: ClaimRecord[], agentId: string): ClaimRecord[];
+/**
+ * Filters handoffs to those that are definitively done (completed or rejected)
+ * and were sent TO this agent (i.e. work that belonged to this agent).
+ */
+export declare function filterCompletedHandoffsForAgent(handoffs: HandoffRecord[], agentId: string): HandoffRecord[];

package/dist/core/daemon/done-state-guard.js

@@ -0,0 +1,102 @@
+/**
+ * Done-State Guard — Epic #497: Restart Continuity
+ *
+ * Determines whether a restarting agent should resume its prior work or come up idle.
+ *
+ * ## Rules (from epic acceptance criteria)
+ * - If prior work is DONE → restart must remain `idle-awaiting-assignment`
+ * - Resume is only allowed when a task is `in_progress` with a valid active claim
+ *
+ * ## Definition of "done" (any true):
+ * 1. Agent has no active claims owned by it
+ * 2. The relevant handoff(s) are completed / rejected / superseded
+ * 3. The last inbox is empty after filtering out completed items
+ *
+ * ## Emitted lifecycle events (structured log):
+ *   `[RESTART] state=resumed  reason=<reason>`
+ *   `[RESTART] state=idle     reason=<reason>`
+ *   `[RESTART] state=blocked  reason=<reason>`
+ */
+// ---------------------------------------------------------------------------
+// Core guard
+// ---------------------------------------------------------------------------
+/**
+ * Evaluates whether a restarting agent should resume or stay idle.
+ *
+ * This is a pure function — no side-effects, fully testable.
+ *
+ * @param input - Snapshot of claims, inbox and recent handoff history at restart time
+ * @returns A RestartDecision with state and human-readable reason
+ */
+export function evaluateRestartState(input) {
+    const { activeClaims, inboxItems, completedHandoffs, automationPaused } = input;
+    // --- BLOCKED: automation is paused ---
+    if (automationPaused) {
+        return {
+            state: "blocked",
+            reason: "automation is paused; waiting for operator to resume",
+        };
+    }
+    // --- IDLE: no active claims → nothing in-flight to resume ---
+    if (activeClaims.length === 0) {
+        // Extra check: if there are ONLY completed/rejected handoffs (no pending inbox),
+        // this confirms the previous cycle is done.
+        const hasPendingWork = inboxItems.some((item) => item.status === "pending");
+        if (!hasPendingWork) {
+            if (completedHandoffs.length > 0) {
+                return {
+                    state: "idle",
+                    reason: `prior cycle is done (${completedHandoffs.length} completed handoff(s), no active claims, no pending inbox)`,
+                };
+            }
+            return {
+                state: "idle",
+                reason: "no active claims and no pending work; awaiting new assignment",
+            };
+        }
+        // There are pending inbox items but no claims — treat as idle (agent will
+        // auto-accept them fresh on startup rather than resuming stale state).
+        return {
+            state: "idle",
+            reason: "pending inbox items present but no active claim; will accept fresh on startup",
+        };
+    }
+    // --- RESUMED: active claims exist → prior work is still in-flight ---
+    const claimSummary = activeClaims.map((c) => c.scope).join(", ");
+    return {
+        state: "resumed",
+        reason: `active claim(s) found: ${claimSummary}`,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns true when the prior work cycle is definitively done.
+ * Convenience wrapper around evaluateRestartState.
+ */
+export function isPriorWorkDone(input) {
+    const decision = evaluateRestartState(input);
+    return decision.state === "idle";
+}
+/**
+ * Formats a structured log line for the restart lifecycle event.
+ * Pattern: `[RESTART] state=<state> reason=<reason>`
+ */
+export function formatRestartLifecycleLog(decision) {
+    return `[RESTART] state=${decision.state} reason=${decision.reason}`;
+}
+/**
+ * Filters a list of claims to only those actively owned by the given agent.
+ */
+export function filterActiveClaimsForAgent(claims, agentId) {
+    return claims.filter((claim) => claim.status === "active" && claim.agent_id === agentId);
+}
+/**
+ * Filters handoffs to those that are definitively done (completed or rejected)
+ * and were sent TO this agent (i.e. work that belonged to this agent).
+ */
+export function filterCompletedHandoffsForAgent(handoffs, agentId) {
+    return handoffs.filter((h) => h.to_agent_id === agentId && (h.status === "completed" || h.status === "rejected"));
+}
+//# sourceMappingURL=done-state-guard.js.map

package/dist/core/daemon/done-state-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"done-state-guard.js","sourceRoot":"","sources":["../../../src/core/daemon/done-state-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA0BH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAEhF,wCAAwC;IACxC,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,sDAAsD;SAC/D,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,iFAAiF;QACjF,4CAA4C;QAC5C,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAE5E,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO;oBACL,KAAK,EAAE,MAAM;oBACb,MAAM,EAAE,wBAAwB,iBAAiB,CAAC,MAAM,4DAA4D;iBACrH,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,+DAA+D;aACxE,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,uEAAuE;QACvE,OAAO;YACL,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,+EAA+E;SACxF,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,0BAA0B,YAAY,EAAE;KACjD,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAyB;IACjE,OAAO,mBAAmB,QAAQ,CAAC,KAAK,WAAW,QAAQ,CAAC,MAAM,EAAE,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAqB,EAAE,OAAe;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAAyB,EACzB,OAAe;IAEf,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAC1F,CAAC;AACJ,CAAC"}

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

@@ -6,6 +6,7 @@ export interface StartTmuxSessionInput {
     workdir?: string;
     runnerEnv: SessionEnv;
     shouldRestoreContext: boolean;
+    autonomous?: boolean;
 }
 export interface StartTmuxSessionResult {
     preStartSessionId?: string | null;

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

@@ -18,7 +18,7 @@ export function startTmuxRuntimeSession(input) {
         }
         const preStartSessionId = snapshotSessionId(input.agentName);
         console.log(`Creating tmux session: ${sessionName}`);
-        const created = createSession(input.agentName, input.command, input.workdir, input.runnerEnv, savedSessionId);
+        const created = createSession(input.agentName, input.command, input.workdir, input.runnerEnv, savedSessionId, input.autonomous);
         if (!created) {
             throw new Error("Failed to create tmux session");
         }

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

@@ -1 +1 @@
-{"version":3,"file":"tmux-session.js","sourceRoot":"","sources":["../../../src/core/daemon/tmux-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,aAAa,EACb,cAAc,EAEd,aAAa,EACb,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAgBpB;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA4B;IAClE,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,cAAkC,CAAC;QAEvC,IAAI,KAAK,CAAC,oBAAoB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChD,cAAc,GAAG,YAAY,EAAE,MAAM,EAAE,iBAAuC,CAAC;YAC/E,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,8CAA8C,cAAc,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE7D,OAAO,CAAC,GAAG,CAAC,0BAA0B,WAAW,EAAE,CAAC,CAAC;QAErD,MAAM,OAAO,GAAG,aAAa,CAC3B,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,SAAS,EACf,cAAc,CACf,CAAC;QAEF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,OAAO;YACL,iBAAiB;YACjB,wBAAwB,EAAE,cAAc;SACzC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qCAAqC,WAAW,EAAE,CAAC,CAAC;IAChE,wBAAwB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3D,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"tmux-session.js","sourceRoot":"","sources":["../../../src/core/daemon/tmux-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,aAAa,EACb,cAAc,EAEd,aAAa,EACb,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAiBpB;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA4B;IAClE,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,cAAkC,CAAC;QAEvC,IAAI,KAAK,CAAC,oBAAoB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChD,cAAc,GAAG,YAAY,EAAE,MAAM,EAAE,iBAAuC,CAAC;YAC/E,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,8CAA8C,cAAc,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE7D,OAAO,CAAC,GAAG,CAAC,0BAA0B,WAAW,EAAE,CAAC,CAAC;QAErD,MAAM,OAAO,GAAG,aAAa,CAC3B,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,SAAS,EACf,cAAc,EACd,KAAK,CAAC,UAAU,CACjB,CAAC;QAEF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,OAAO;YACL,iBAAiB;YACjB,wBAAwB,EAAE,cAAc;SACzC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qCAAqC,WAAW,EAAE,CAAC,CAAC;IAChE,wBAAwB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3D,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/core/daemon.d.ts

@@ -28,6 +28,10 @@ export interface DaemonOptions {
     role?: string;
     /** Auto-accept pending handoffs in worker mode (default: enabled for --worker) */
     autoAcceptHandoffs?: boolean;
+    /** Run agent in fully autonomous mode — injects runtime-specific non-interactive flags */
+    autonomous?: boolean;
+    /** Team ID to register this worker agent with (required for --worker) */
+    teamId?: string;
 }
 export declare class AgentDaemon {
     private agentName;
@@ -55,18 +59,21 @@ export declare class AgentDaemon {
     private projectCode;
     private projectRole;
     private autoAcceptHandoffs;
+    private autonomous;
     private healthCheckInterval;
     private stopCleanupScheduler;
+    private authHealthWatcher;
     private _preStartSessionId;
     private _attemptedResumeSessionId;
     private stuckSince;
-    private nudgeSentAt;
     private lastPendingHandoffAlertAt;
     private remoteAutomationPaused;
     private lastAutonomyPolicyFetchAt;
+    private teamId;
     private pendingClaimCreations;
     private sessionRecoveryAttempts;
     private lastSessionRecoveryAt;
+    private initialInboxCheckComplete;
     constructor(options: DaemonOptions);
     start(): Promise<void>;
     /**
@@ -76,6 +83,7 @@ export declare class AgentDaemon {
     private autoAcceptPendingHandoffs;
     private autoAcceptHandoffFromEvent;
     private isAutomationPaused;
+    private sweepInboxOnWebSocketConnect;
     private refreshRemoteAutonomyPolicy;
     private acceptHandoffWithRetry;
     private checkPendingHandoffSla;
@@ -118,6 +126,15 @@ export declare class AgentDaemon {
      * Resolves workdir from --project flag: looks up project by code, clones repo, self-assigns.
      */
     private resolveProjectWorkdir;
+    /**
+     * Evaluates whether this restart should resume in-flight work or come up idle.
+     *
+     * Pulls claims, inbox, and recent handoff history from HQ, then delegates to
+     * the pure `evaluateRestartState` function for the actual decision.
+     *
+     * Failures are non-fatal — defaults to `idle` so we fail safe.
+     */
+    private evaluateDoneStateGuard;
     /**
      * Fetches assignments from HQ and validates workdir setup
      * Uses project.workdir from HQ as source of truth, falls back to helpful instructions