@agentmeshhq/agent 0.4.2 → 0.4.3

package/dist/cli/whoami.js

@@ -1,5 +1,6 @@
 import pc from "picocolors";
 import { loadConfig, loadState } from "../config/loader.js";
+import { fetchOnboard } from "../core/registry.js";
 import { getRunnerDisplayName } from "../core/runner.js";
 import { getTokenExpiry } from "../utils/jwt.js";
 export async function whoami(agentName) {
@@ -11,21 +12,18 @@ export async function whoami(agentName) {
     const state = loadState();
     // If no agent name provided, check environment or show all
     if (!agentName) {
-        // Check if running as an agent (env vars set)
         const envAgentId = process.env.AGENTMESH_AGENT_ID;
         const envToken = process.env.AGENT_TOKEN;
         if (envAgentId && envToken) {
-            // We're running inside an agent session
+            // We're running inside an agent session — show canonical context
             const expiry = getTokenExpiry(envToken);
             const expiryStr = formatExpiry(expiry);
-            // Try to find agent in state for runtime info
             const agentState = state.agents.find((a) => a.agentId === envAgentId);
             console.log(pc.bold("Current Agent"));
             console.log(`  ID:        ${pc.cyan(envAgentId)}`);
             console.log(`  Workspace: ${pc.dim(config.workspace)}`);
             console.log(`  Token:     ${expiryStr}`);
             console.log(`  Hub:       ${pc.dim(config.hubUrl)}`);
-            // Show runtime model info if available
             if (agentState?.runtimeModel) {
                 const runnerName = agentState.runnerType
                     ? getRunnerDisplayName(agentState.runnerType)
@@ -33,6 +31,8 @@ export async function whoami(agentName) {
                 console.log(`  Model:     ${pc.cyan(agentState.runtimeModel)}`);
                 console.log(`  Runner:    ${pc.dim(runnerName)}`);
             }
+            // Extended canonical context from HQ
+            await printCanonicalContext(config.hubUrl, envToken, "  ");
             return;
         }
         // Show all registered agents
@@ -78,7 +78,6 @@ export async function whoami(agentName) {
     console.log(`  Session:   ${pc.dim(agent.tmuxSession || "none")}`);
     console.log(`  Started:   ${pc.dim(agent.startedAt || "unknown")}`);
     console.log(`  Hub:       ${pc.dim(config.hubUrl)}`);
-    // Show runtime model info
     if (agent.runtimeModel) {
         const runnerName = agent.runnerType
             ? getRunnerDisplayName(agent.runnerType)
@@ -86,6 +85,111 @@ export async function whoami(agentName) {
         console.log(`  Model:     ${pc.cyan(agent.runtimeModel)}`);
         console.log(`  Runner:    ${pc.dim(runnerName)}`);
     }
+    // Extended canonical context from HQ when token is available
+    if (agent.token) {
+        await printCanonicalContext(config.hubUrl, agent.token, "  ");
+    }
+}
+/**
+ * Fetch and print canonical workspace/team/role context from the HQ onboard API.
+ * Prints nothing on error so it degrades gracefully.
+ */
+async function printCanonicalContext(hubUrl, token, indent) {
+    try {
+        const onboard = await fetchOnboard(hubUrl, token);
+        if (!onboard)
+            return;
+        const { assignment, project, team } = onboard;
+        if (assignment) {
+            console.log(`${indent}Role:      ${pc.dim(assignment.role)}`);
+        }
+        if (project) {
+            console.log(`${indent}Project:   ${pc.dim(`${project.name} (${project.code})`)}`);
+        }
+        if (team && team.length > 0) {
+            const teammates = team
+                .filter((t) => t.status === "online" || t.status === "idle")
+                .map((t) => t.display_name)
+                .slice(0, 5);
+            if (teammates.length > 0) {
+                console.log(`${indent}Team:      ${pc.dim(teammates.join(", "))}`);
+            }
+        }
+    }
+    catch {
+        // Silently ignore — canonical context is best-effort
+    }
+}
+/**
+ * Resolve the canonical Product Owner agent ID for the current team/workspace.
+ * Usage: agentmesh po resolve
+ *        agentmesh whoami --po
+ */
+export async function resolvePO(agentName) {
+    const config = loadConfig();
+    if (!config) {
+        console.log(pc.red("No config found. Run 'agentmesh init' first."));
+        process.exit(1);
+    }
+    // Resolve token
+    let token;
+    const envToken = process.env.AGENT_TOKEN;
+    if (envToken && !agentName) {
+        token = envToken;
+    }
+    else {
+        const state = loadState();
+        const agent = agentName ? state.agents.find((a) => a.name === agentName) : state.agents[0];
+        if (!agent) {
+            console.log(pc.red("No agent found."));
+            process.exit(1);
+        }
+        token = agent.token;
+    }
+    if (!token) {
+        console.log(pc.red("No token available. Run 'agentmesh token refresh' first."));
+        process.exit(1);
+    }
+    try {
+        const onboard = await fetchOnboard(config.hubUrl, token);
+        if (!onboard) {
+            console.log(pc.red("Could not fetch workspace context from HQ."));
+            process.exit(1);
+        }
+        // Find PO in team (role === "po" or display_name contains "po")
+        const po = onboard.team.find((t) => t.role?.toLowerCase() === "po" ||
+            t.role?.toLowerCase() === "product-owner" ||
+            t.display_name?.toLowerCase().includes("forge-po") ||
+            t.display_name?.toLowerCase().includes("product owner"));
+        if (po) {
+            console.log(pc.bold("Product Owner"));
+            console.log(`  ID:      ${pc.cyan(po.agent_id)}`);
+            console.log(`  Name:    ${pc.dim(po.display_name)}`);
+            console.log(`  Status:  ${formatOnlineStatus(po.status)}`);
+        }
+        else {
+            // Fallback: print all team members so caller can identify PO
+            console.log(pc.yellow("No explicit PO role found. Team members:"));
+            for (const member of onboard.team) {
+                console.log(`  ${pc.cyan(member.agent_id)} — ${member.display_name} (${member.role})`);
+            }
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.log(pc.red(`Failed to resolve PO: ${err.message}`));
+        process.exit(1);
+    }
+}
+function formatOnlineStatus(status) {
+    switch (status) {
+        case "online":
+            return pc.green("online");
+        case "idle":
+            return pc.yellow("idle");
+        default:
+            return pc.dim(status);
+    }
 }
 function formatExpiry(expiry) {
     if (!expiry) {

package/dist/cli/whoami.js.map

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

package/dist/core/cleanup/eligibility.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Cleanup Eligibility — GH-421
+ *
+ * Determines which agents are eligible for filesystem cleanup.
+ *
+ * Rules:
+ *   - Agent status must be "evicted"
+ *   - Agent must have been evicted for at least `retentionMs` (default 2 hours)
+ *   - Active/online/stale agents are always skipped
+ *   - Agents with no lastHeartbeatAt are skipped (unknown state)
+ */
+export declare const DEFAULT_RETENTION_MS: number;
+export interface AgentRecord {
+    agentId: string;
+    /** Display name — used to locate ~/.agentmesh/opencode-data/<name> */
+    displayName: string;
+    status: string;
+    /** ISO timestamp of last heartbeat (used to infer eviction age) */
+    lastHeartbeatAt: string | null;
+    workspaceId: string;
+}
+export interface EligibilityResult {
+    eligible: boolean;
+    reason: string;
+    evictedAgeMs?: number;
+}
+/**
+ * Check whether a single agent is eligible for cleanup.
+ *
+ * @param agent       - Agent record from Hub API
+ * @param retentionMs - Minimum eviction age before cleanup (default 2h)
+ * @param now         - Override for current time (testing)
+ */
+export declare function checkEligibility(agent: AgentRecord, retentionMs?: number, now?: Date): EligibilityResult;
+/**
+ * Filter a list of agents to those eligible for cleanup.
+ */
+export declare function filterEligible(agents: AgentRecord[], retentionMs?: number, now?: Date): Array<{
+    agent: AgentRecord;
+    eligibility: EligibilityResult;
+}>;

package/dist/core/cleanup/eligibility.js

@@ -0,0 +1,64 @@
+/**
+ * Cleanup Eligibility — GH-421
+ *
+ * Determines which agents are eligible for filesystem cleanup.
+ *
+ * Rules:
+ *   - Agent status must be "evicted"
+ *   - Agent must have been evicted for at least `retentionMs` (default 2 hours)
+ *   - Active/online/stale agents are always skipped
+ *   - Agents with no lastHeartbeatAt are skipped (unknown state)
+ */
+export const DEFAULT_RETENTION_MS = 2 * 60 * 60 * 1000; // 2 hours
+/** Statuses that indicate the agent is safe to clean up */
+const EVICTED_STATUS = "evicted";
+/** Statuses that MUST never be cleaned */
+const SAFE_STATUSES = new Set(["online", "idle", "active", "stale"]);
+/**
+ * Check whether a single agent is eligible for cleanup.
+ *
+ * @param agent       - Agent record from Hub API
+ * @param retentionMs - Minimum eviction age before cleanup (default 2h)
+ * @param now         - Override for current time (testing)
+ */
+export function checkEligibility(agent, retentionMs = DEFAULT_RETENTION_MS, now = new Date()) {
+    // Safety guard: never touch running agents
+    if (SAFE_STATUSES.has(agent.status)) {
+        return { eligible: false, reason: `status=${agent.status} (safe — skipped)` };
+    }
+    // Must be explicitly evicted
+    if (agent.status !== EVICTED_STATUS) {
+        return { eligible: false, reason: `status=${agent.status} (not evicted)` };
+    }
+    // Need a heartbeat timestamp to measure eviction age
+    if (!agent.lastHeartbeatAt) {
+        return { eligible: false, reason: "no lastHeartbeatAt — unknown eviction time" };
+    }
+    const lastSeen = new Date(agent.lastHeartbeatAt);
+    if (Number.isNaN(lastSeen.getTime())) {
+        return { eligible: false, reason: `invalid lastHeartbeatAt: ${agent.lastHeartbeatAt}` };
+    }
+    const evictedAgeMs = now.getTime() - lastSeen.getTime();
+    if (evictedAgeMs < retentionMs) {
+        const remainingMin = Math.ceil((retentionMs - evictedAgeMs) / 60_000);
+        return {
+            eligible: false,
+            reason: `evicted only ${Math.floor(evictedAgeMs / 60_000)}m ago (need ${Math.floor(retentionMs / 60_000)}m) — ${remainingMin}m remaining`,
+            evictedAgeMs,
+        };
+    }
+    return {
+        eligible: true,
+        reason: `evicted for ${Math.floor(evictedAgeMs / 60_000)}m (threshold ${Math.floor(retentionMs / 60_000)}m)`,
+        evictedAgeMs,
+    };
+}
+/**
+ * Filter a list of agents to those eligible for cleanup.
+ */
+export function filterEligible(agents, retentionMs = DEFAULT_RETENTION_MS, now = new Date()) {
+    return agents
+        .map((agent) => ({ agent, eligibility: checkEligibility(agent, retentionMs, now) }))
+        .filter(({ eligibility }) => eligibility.eligible);
+}
+//# sourceMappingURL=eligibility.js.map

package/dist/core/cleanup/eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.js","sourceRoot":"","sources":["../../../src/core/cleanup/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,UAAU;AAElE,2DAA2D;AAC3D,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC,0CAA0C;AAC1C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAkBrE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAkB,EAClB,WAAW,GAAG,oBAAoB,EAClC,GAAG,GAAG,IAAI,IAAI,EAAE;IAEhB,2CAA2C;IAC3C,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,KAAK,CAAC,MAAM,mBAAmB,EAAE,CAAC;IAChF,CAAC;IAED,6BAA6B;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QACpC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,KAAK,CAAC,MAAM,gBAAgB,EAAE,CAAC;IAC7E,CAAC;IAED,qDAAqD;IACrD,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,4CAA4C,EAAE,CAAC;IACnF,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC;IAC1F,CAAC;IAED,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IAExD,IAAI,YAAY,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,CAAC;QACtE,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,gBAAgB,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,QAAQ,YAAY,aAAa;YACzI,YAAY;SACb,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,eAAe,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,gBAAgB,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI;QAC5G,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAqB,EACrB,WAAW,GAAG,oBAAoB,EAClC,GAAG,GAAG,IAAI,IAAI,EAAE;IAEhB,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SACnF,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AACvD,CAAC"}

package/dist/core/cleanup/scheduler.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Cleanup Scheduler — GH-421
+ *
+ * Periodic job that:
+ *   1. Fetches all agents in the workspace from the Hub API
+ *   2. Filters to eviction-eligible agents (status=evicted, age>=2h)
+ *   3. Runs cleanupAgents() for each eligible agent
+ *
+ * Designed to run as a setInterval loop inside the agent daemon,
+ * configurable via env vars:
+ *   AGENTMESH_CLEANUP_INTERVAL_MS  (default 10 minutes)
+ *   AGENTMESH_CLEANUP_RETENTION_MS (default 2 hours)
+ *   AGENTMESH_CLEANUP_DRY_RUN      (default false)
+ */
+export interface CleanupSchedulerConfig {
+    /** Hub base URL, e.g. https://agentmeshhq.dev */
+    hubUrl: string;
+    /** Bearer token for Hub API calls */
+    token: string;
+    /** Workspace ID to query */
+    workspace: string;
+    /** How often to run (ms). Default: 10 min */
+    intervalMs?: number;
+    /** Minimum eviction age before cleanup (ms). Default: 2h */
+    retentionMs?: number;
+    /** Dry-run mode: log but don't delete. Default: false */
+    dryRun?: boolean;
+    /** Max log lines to archive per agent. Default: 200 */
+    archiveLogLines?: number;
+    /** Override home dir (testing) */
+    homeDir?: string;
+}
+export interface SchedulerRunResult {
+    checkedAt: string;
+    totalAgents: number;
+    eligibleCount: number;
+    processed: number;
+    succeeded: number;
+    failed: number;
+    errors: string[];
+}
+/**
+ * Execute one cleanup cycle: fetch agents → filter eligible → clean.
+ */
+export declare function runCleanupCycle(config: CleanupSchedulerConfig): Promise<SchedulerRunResult>;
+/**
+ * Start the cleanup scheduler as a recurring setInterval.
+ * Returns a stop function (clears the interval).
+ */
+export declare function startCleanupScheduler(config: CleanupSchedulerConfig): () => void;

package/dist/core/cleanup/scheduler.js

@@ -0,0 +1,120 @@
+/**
+ * Cleanup Scheduler — GH-421
+ *
+ * Periodic job that:
+ *   1. Fetches all agents in the workspace from the Hub API
+ *   2. Filters to eviction-eligible agents (status=evicted, age>=2h)
+ *   3. Runs cleanupAgents() for each eligible agent
+ *
+ * Designed to run as a setInterval loop inside the agent daemon,
+ * configurable via env vars:
+ *   AGENTMESH_CLEANUP_INTERVAL_MS  (default 10 minutes)
+ *   AGENTMESH_CLEANUP_RETENTION_MS (default 2 hours)
+ *   AGENTMESH_CLEANUP_DRY_RUN      (default false)
+ */
+import { DEFAULT_RETENTION_MS, filterEligible } from "./eligibility.js";
+import { cleanupAgents } from "./worker.js";
+const DEFAULT_INTERVAL_MS = 10 * 60 * 1000; // 10 minutes
+// ─── Hub API fetch ─────────────────────────────────────────────────────────────
+async function fetchWorkspaceAgents(hubUrl, workspace, token) {
+    const resp = await fetch(`${hubUrl}/api/v1/workspaces/${workspace}/agents`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!resp.ok) {
+        throw new Error(`Failed to fetch agents: ${resp.status} ${resp.statusText}`);
+    }
+    const data = (await resp.json());
+    const rows = data.agents ?? data.data ?? [];
+    return rows.map((r) => ({
+        agentId: r.agent_id,
+        displayName: r.display_name,
+        status: r.status,
+        lastHeartbeatAt: r.last_heartbeat_at,
+        workspaceId: r.workspace_id,
+    }));
+}
+/**
+ * Execute one cleanup cycle: fetch agents → filter eligible → clean.
+ */
+export async function runCleanupCycle(config) {
+    const retentionMs = config.retentionMs ?? DEFAULT_RETENTION_MS;
+    const dryRun = config.dryRun ?? false;
+    const opts = {
+        dryRun,
+        archiveLogLines: config.archiveLogLines ?? 200,
+        homeDir: config.homeDir,
+    };
+    const checkedAt = new Date().toISOString();
+    const errors = [];
+    let allAgents = [];
+    try {
+        allAgents = await fetchWorkspaceAgents(config.hubUrl, config.workspace, config.token);
+    }
+    catch (err) {
+        const msg = `[cleanup] Failed to fetch agents: ${err instanceof Error ? err.message : String(err)}`;
+        console.error(msg);
+        return {
+            checkedAt,
+            totalAgents: 0,
+            eligibleCount: 0,
+            processed: 0,
+            succeeded: 0,
+            failed: 0,
+            errors: [msg],
+        };
+    }
+    const eligible = filterEligible(allAgents, retentionMs);
+    if (eligible.length === 0) {
+        return {
+            checkedAt,
+            totalAgents: allAgents.length,
+            eligibleCount: 0,
+            processed: 0,
+            succeeded: 0,
+            failed: 0,
+            errors: [],
+        };
+    }
+    console.log(`[cleanup] ${eligible.length} agent(s) eligible for cleanup (${dryRun ? "DRY-RUN" : "LIVE"})`);
+    const batch = await cleanupAgents(eligible.map(({ agent }) => agent), opts);
+    for (const r of batch.results) {
+        if (!r.success && r.error) {
+            errors.push(`${r.agentName}: ${r.error}`);
+        }
+    }
+    if (batch.succeeded > 0 || batch.failed > 0) {
+        console.log(`[cleanup] done — succeeded=${batch.succeeded} failed=${batch.failed}`, errors.length ? errors : "");
+    }
+    return {
+        checkedAt,
+        totalAgents: allAgents.length,
+        eligibleCount: eligible.length,
+        processed: batch.processed,
+        succeeded: batch.succeeded,
+        failed: batch.failed,
+        errors,
+    };
+}
+// ─── scheduler ────────────────────────────────────────────────────────────────
+/**
+ * Start the cleanup scheduler as a recurring setInterval.
+ * Returns a stop function (clears the interval).
+ */
+export function startCleanupScheduler(config) {
+    const intervalMs = config.intervalMs ?? DEFAULT_INTERVAL_MS;
+    const run = async () => {
+        try {
+            await runCleanupCycle(config);
+        }
+        catch (err) {
+            console.error("[cleanup] Unhandled error in cleanup cycle:", err);
+        }
+    };
+    const id = setInterval(run, intervalMs);
+    console.log(`[cleanup] Scheduler started — interval=${intervalMs}ms retention=${config.retentionMs ?? DEFAULT_RETENTION_MS}ms dryRun=${config.dryRun ?? false}`);
+    return () => {
+        clearInterval(id);
+        console.log("[cleanup] Scheduler stopped");
+    };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/core/cleanup/scheduler.js.map

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

package/dist/core/cleanup/worker.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Cleanup Worker — GH-421
+ *
+ * Executes filesystem cleanup for eviction-eligible agents:
+ *   1. Stop any residual tmux session for the agent
+ *   2. Optionally archive diagnostics (last N log lines)
+ *   3. Remove ~/.agentmesh/opencode-data/<agentName>
+ *   4. Remove ~/.agentmesh/agents/<agentName>.waiting signal file if present
+ *   5. Emit a structured audit event for every action
+ *
+ * Safety guarantees:
+ *   - Dry-run mode: logs actions without touching filesystem
+ *   - Idempotent: re-running on an already-cleaned agent is a no-op
+ *   - Never removes paths outside ~/.agentmesh/opencode-data/
+ *   - Never removes the base ~/.agentmesh/ directory
+ */
+import type { AgentRecord } from "./eligibility.js";
+export interface CleanupOptions {
+    /** When true, log actions but make no filesystem changes (default false) */
+    dryRun?: boolean;
+    /** Max lines to archive from the most recent log file (default 200, 0 = skip) */
+    archiveLogLines?: number;
+    /** Override home directory for testing */
+    homeDir?: string;
+}
+export type CleanupActionType = "session_killed" | "session_not_found" | "logs_archived" | "dir_removed" | "dir_not_found" | "waiting_file_removed" | "skipped_dry_run" | "error";
+export interface CleanupAction {
+    type: CleanupActionType;
+    agentId: string;
+    agentName: string;
+    path?: string;
+    detail?: string;
+    timestamp: string;
+    dryRun: boolean;
+}
+export interface CleanupResult {
+    agentId: string;
+    agentName: string;
+    success: boolean;
+    actions: CleanupAction[];
+    error?: string;
+}
+/**
+ * Clean up the filesystem artifacts for a single eviction-eligible agent.
+ *
+ * Steps (all logged as CleanupAction entries):
+ *  1. Kill residual tmux session (if present)
+ *  2. Archive last N log lines to ~/.agentmesh/logs/cleanup-<agent>-<ts>.txt
+ *  3. Remove ~/.agentmesh/opencode-data/<agentName>/ recursively
+ *  4. Remove ~/.agentmesh/agents/<agentName>.waiting (if exists)
+ */
+export declare function cleanupAgent(agent: AgentRecord, opts?: CleanupOptions): Promise<CleanupResult>;
+export interface BatchCleanupResult {
+    processed: number;
+    succeeded: number;
+    failed: number;
+    results: CleanupResult[];
+}
+/**
+ * Run cleanup for multiple eligible agents.
+ * Failures on one agent never abort the others.
+ */
+export declare function cleanupAgents(agents: AgentRecord[], opts?: CleanupOptions): Promise<BatchCleanupResult>;