@askexenow/exe-os 0.9.272 → 0.9.274

package/dist/chunk-CHBGCQXG.js

@@ -0,0 +1,333 @@
+import {
+  executeAction,
+  substituteTemplate
+} from "./chunk-ZFRG2MNB.js";
+
+// src/automation/workflow-engine.ts
+import { randomUUID } from "crypto";
+var _definitions = /* @__PURE__ */ new Map();
+var _instances = /* @__PURE__ */ new Map();
+function createWorkflowDefinition(input) {
+  const def = {
+    id: randomUUID().slice(0, 12),
+    ...input,
+    created_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  def.steps = def.steps.map((s, i) => ({ ...s, index: s.index || i + 1 }));
+  _definitions.set(def.id, def);
+  return def;
+}
+function getWorkflowDefinition(id) {
+  return _definitions.get(id);
+}
+function listWorkflowDefinitions() {
+  return [..._definitions.values()];
+}
+function buildTemplateContext(instance) {
+  const ctx = { ...instance.context };
+  const stepMap = {};
+  for (const sr of instance.step_results) {
+    stepMap[String(sr.step_index)] = {
+      status: sr.status,
+      result: sr.result,
+      error: sr.error
+    };
+  }
+  ctx.step = stepMap;
+  return ctx;
+}
+function resolveActionParams(action, context) {
+  const resolved = {};
+  for (const [key, val] of Object.entries(action.params)) {
+    resolved[key] = substituteTemplate(val, context);
+  }
+  return { ...action, params: resolved };
+}
+function startWorkflow(definitionId, context = {}) {
+  const def = _definitions.get(definitionId);
+  if (!def) throw new Error(`Workflow definition "${definitionId}" not found`);
+  const instance = {
+    id: randomUUID().slice(0, 12),
+    definition_id: definitionId,
+    status: "running",
+    current_step: 1,
+    step_results: [],
+    context,
+    created_at: (/* @__PURE__ */ new Date()).toISOString(),
+    updated_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  _instances.set(instance.id, instance);
+  return instance;
+}
+function getWorkflowInstance(id) {
+  return _instances.get(id);
+}
+function listWorkflowInstances(status) {
+  const all = [..._instances.values()];
+  return status ? all.filter((i) => i.status === status) : all;
+}
+async function advanceWorkflow(instanceId) {
+  const instance = _instances.get(instanceId);
+  if (!instance) throw new Error(`Workflow instance "${instanceId}" not found`);
+  if (instance.status !== "running") {
+    throw new Error(`Workflow "${instanceId}" is ${instance.status}, cannot advance`);
+  }
+  const def = _definitions.get(instance.definition_id);
+  if (!def) throw new Error(`Workflow definition "${instance.definition_id}" not found`);
+  const step = def.steps.find((s) => s.index === instance.current_step);
+  if (!step) {
+    instance.status = "completed";
+    instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+    return instance;
+  }
+  const templateCtx = buildTemplateContext(instance);
+  const stepResult = {
+    step_index: step.index,
+    status: "success",
+    started_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  switch (step.type) {
+    case "execute_action": {
+      const action = step.action ?? buildActionFromConnector(step);
+      if (!action) {
+        stepResult.status = "failed";
+        stepResult.error = "No action defined for execute_action step";
+        break;
+      }
+      const resolvedAction = resolveActionParams(action, templateCtx);
+      const result = await executeAction(resolvedAction, templateCtx);
+      stepResult.status = result.success ? "success" : "failed";
+      stepResult.result = result;
+      stepResult.error = result.error;
+      if (!result.success) {
+        instance.status = "failed";
+      }
+      break;
+    }
+    case "wait_for_approval": {
+      const { createTask } = await import("./lib/tasks.js");
+      const { getCoordinatorName } = await import("./lib/employees.js");
+      const message = step.approval_message ? substituteTemplate(step.approval_message, templateCtx) : `Workflow "${def.name}" step ${step.index} ("${step.name}") requires approval.`;
+      const task = await createTask({
+        title: `[Workflow Approval] ${def.name}: ${step.name}`,
+        assignedTo: getCoordinatorName(),
+        assignedBy: "workflow-engine",
+        projectName: "exe-os",
+        priority: "p1",
+        context: `${message}
+
+**Workflow:** ${def.name} (${instance.id})
+**Step:** ${step.index} \u2014 ${step.name}
+
+To approve: call approve_workflow_step with instance_id="${instance.id}"
+To reject: call approve_workflow_step with instance_id="${instance.id}" approved=false`,
+        baseDir: process.cwd()
+      });
+      instance.approval_task_id = task.id;
+      instance.status = "waiting_approval";
+      stepResult.status = "pending_approval";
+      break;
+    }
+    case "conditional": {
+      if (!step.condition) {
+        stepResult.status = "failed";
+        stepResult.error = "No condition defined for conditional step";
+        break;
+      }
+      const resolvedExpr = substituteTemplate(step.condition.expression, templateCtx);
+      const conditionMet = evaluateSimpleExpression(resolvedExpr);
+      stepResult.result = { expression: resolvedExpr, met: conditionMet };
+      if (conditionMet && step.condition.then_step) {
+        instance.current_step = step.condition.then_step;
+        stepResult.completed_at = (/* @__PURE__ */ new Date()).toISOString();
+        instance.step_results.push(stepResult);
+        instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+        return instance;
+      } else if (!conditionMet && step.condition.else_step) {
+        instance.current_step = step.condition.else_step;
+        stepResult.completed_at = (/* @__PURE__ */ new Date()).toISOString();
+        instance.step_results.push(stepResult);
+        instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+        return instance;
+      }
+      break;
+    }
+  }
+  stepResult.completed_at = (/* @__PURE__ */ new Date()).toISOString();
+  instance.step_results.push(stepResult);
+  if (instance.status === "running") {
+    const nextStep = def.steps.find((s) => s.index > step.index);
+    if (nextStep) {
+      instance.current_step = nextStep.index;
+    } else {
+      instance.status = "completed";
+    }
+  }
+  instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+  return instance;
+}
+async function runWorkflow(instanceId) {
+  let instance = _instances.get(instanceId);
+  if (!instance) throw new Error(`Workflow instance "${instanceId}" not found`);
+  while (instance.status === "running") {
+    instance = await advanceWorkflow(instanceId);
+  }
+  return instance;
+}
+async function approveWorkflowStep(instanceId, approved = true) {
+  const instance = _instances.get(instanceId);
+  if (!instance) throw new Error(`Workflow instance "${instanceId}" not found`);
+  if (instance.status !== "waiting_approval") {
+    throw new Error(`Workflow "${instanceId}" is not waiting for approval (status: ${instance.status})`);
+  }
+  const pendingResult = instance.step_results.find(
+    (sr) => sr.step_index === instance.current_step && sr.status === "pending_approval"
+  );
+  if (pendingResult) {
+    pendingResult.status = approved ? "approved" : "failed";
+    pendingResult.completed_at = (/* @__PURE__ */ new Date()).toISOString();
+    pendingResult.result = { approved };
+  }
+  if (!approved) {
+    instance.status = "cancelled";
+    instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+    return instance;
+  }
+  const def = _definitions.get(instance.definition_id);
+  if (!def) throw new Error(`Workflow definition "${instance.definition_id}" not found`);
+  const currentStep = def.steps.find((s) => s.index === instance.current_step);
+  const nextStep = currentStep ? def.steps.find((s) => s.index > currentStep.index) : void 0;
+  if (nextStep) {
+    instance.current_step = nextStep.index;
+    instance.status = "running";
+  } else {
+    instance.status = "completed";
+  }
+  instance.approval_task_id = void 0;
+  instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+  if (instance.status === "running") {
+    return runWorkflow(instanceId);
+  }
+  return instance;
+}
+function buildActionFromConnector(step) {
+  if (!step.connector || !step.operation) return null;
+  const params = {};
+  if (step.payload) {
+    for (const [k, v] of Object.entries(step.payload)) {
+      params[k] = String(v);
+    }
+  }
+  params._connector = step.connector;
+  params._operation = step.operation;
+  return {
+    type: "mcp_tool",
+    params
+  };
+}
+function evaluateSimpleExpression(expr) {
+  const operators = ["==", "!=", ">=", "<=", ">", "<"];
+  for (const op of operators) {
+    const idx = expr.indexOf(op);
+    if (idx === -1) continue;
+    const left = expr.slice(0, idx).trim();
+    const right = expr.slice(idx + op.length).trim();
+    switch (op) {
+      case "==":
+        return left === right;
+      case "!=":
+        return left !== right;
+      case ">":
+        return Number(left) > Number(right);
+      case "<":
+        return Number(left) < Number(right);
+      case ">=":
+        return Number(left) >= Number(right);
+      case "<=":
+        return Number(left) <= Number(right);
+    }
+  }
+  return expr.trim() !== "" && expr.trim() !== "false" && expr.trim() !== "0";
+}
+async function persistWorkflows() {
+  try {
+    const { getClient } = await import("./lib/database.js");
+    const client = getClient();
+    for (const def of _definitions.values()) {
+      await client.execute({
+        sql: `INSERT OR REPLACE INTO workflow_definitions (id, name, description, steps, trigger_event, created_at)
+              VALUES (?, ?, ?, ?, ?, ?)`,
+        args: [def.id, def.name, def.description ?? null, JSON.stringify(def.steps), def.trigger_event ?? null, def.created_at]
+      });
+    }
+    for (const inst of _instances.values()) {
+      await client.execute({
+        sql: `INSERT OR REPLACE INTO workflow_instances
+              (id, definition_id, status, current_step, step_results, context, approval_task_id, created_at, updated_at)
+              VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        args: [
+          inst.id,
+          inst.definition_id,
+          inst.status,
+          inst.current_step,
+          JSON.stringify(inst.step_results),
+          JSON.stringify(inst.context),
+          inst.approval_task_id ?? null,
+          inst.created_at,
+          inst.updated_at
+        ]
+      });
+    }
+  } catch (e) {
+    process.stderr.write(`[workflow-engine] persist failed: ${e instanceof Error ? e.message : String(e)}
+`);
+  }
+}
+async function loadWorkflows() {
+  try {
+    const { getClient } = await import("./lib/database.js");
+    const client = getClient();
+    const defs = await client.execute("SELECT * FROM workflow_definitions");
+    for (const row of defs.rows) {
+      const def = {
+        id: String(row.id),
+        name: String(row.name),
+        description: String(row.description),
+        steps: JSON.parse(String(row.steps)),
+        trigger_event: String(row.trigger_event),
+        created_at: String(row.created_at)
+      };
+      _definitions.set(def.id, def);
+    }
+    const insts = await client.execute("SELECT * FROM workflow_instances WHERE status NOT IN ('completed', 'cancelled')");
+    for (const row of insts.rows) {
+      const inst = {
+        id: String(row.id),
+        definition_id: String(row.definition_id),
+        status: String(row.status),
+        current_step: Number(row.current_step),
+        step_results: JSON.parse(String(row.step_results)),
+        context: JSON.parse(String(row.context)),
+        approval_task_id: row.approval_task_id ? String(row.approval_task_id) : void 0,
+        created_at: String(row.created_at),
+        updated_at: String(row.updated_at)
+      };
+      _instances.set(inst.id, inst);
+    }
+  } catch {
+  }
+}
+
+export {
+  createWorkflowDefinition,
+  getWorkflowDefinition,
+  listWorkflowDefinitions,
+  startWorkflow,
+  getWorkflowInstance,
+  listWorkflowInstances,
+  advanceWorkflow,
+  runWorkflow,
+  approveWorkflowStep,
+  persistWorkflows,
+  loadWorkflows
+};

package/dist/chunk-CHUOANKE.js

@@ -0,0 +1,346 @@
+import {
+  recordSessionKill
+} from "./chunk-SG2ANG5C.js";
+import {
+  sessionScopeFilter,
+  verifyPaneAtCapacity,
+  writeNotification
+} from "./chunk-5M5RYJ22.js";
+import {
+  listSessions
+} from "./chunk-OBUV3W7L.js";
+import {
+  getTransport
+} from "./chunk-MVW62NIZ.js";
+import {
+  recordOrchestrationEventBestEffort
+} from "./chunk-2NQQP3FF.js";
+import {
+  getClient,
+  isCoordinatorName
+} from "./chunk-CHBHR5W6.js";
+
+// src/lib/capacity-monitor.ts
+var CAPACITY_PATTERNS = [
+  /conversation is too long/i,
+  /maximum context length/i,
+  /context window.*(?:limit|exceed|full)/i,
+  /reached.*(?:token|context).*limit/i
+];
+var CONTENT_LINE_PREFIX = /^[\s>#\-*[]/;
+var CONTENT_LINE_MARKERS = [
+  "RESUME:",
+  "intercom",
+  "capacity-monitor",
+  "CAPACITY_PATTERNS",
+  "isAtCapacity",
+  "CONTENT_LINE_MARKERS",
+  "pollCapacityDead",
+  "confirmCapacityKill",
+  "session_kills",
+  "capacity-monitor.test"
+];
+var SOURCE_CODE_MARKERS = [
+  /["'`/].*(?:maximum context length|conversation is too long)/i,
+  /(?:maximum context length|conversation is too long).*["'`/]/i
+];
+var RELAUNCH_COOLDOWN_MS = 5 * 60 * 1e3;
+var _lastRelaunch = /* @__PURE__ */ new Map();
+var RESUME_TITLE_PREFIX = "RESUME:";
+var RESUME_TITLE_LIKE_PATTERN = `${RESUME_TITLE_PREFIX} % hit context capacity%`;
+var RESUME_ACTIVE_STATUSES = ["open", "in_progress"];
+function resumeTaskTitle(agentId) {
+  return `${RESUME_TITLE_PREFIX} ${agentId} hit context capacity \u2014 continue open tasks`;
+}
+function buildResumeContext(agentId, openTasks) {
+  const taskList = openTasks.map(
+    (r, i) => `${i + 1}. [${String(r.priority).toUpperCase()}] ${String(r.title)} (${String(r.task_file)})`
+  ).join("\n");
+  return [
+    "## Context",
+    "",
+    `${agentId} hit context capacity and was auto-relaunched by the capacity monitor.`,
+    "Call recall_my_memory first \u2014 search for 'CONTEXT CHECKPOINT'. Pick up where the previous session stopped.",
+    "",
+    `You have ${openTasks.length} open task(s). Work through them in priority order:`,
+    "",
+    taskList,
+    "",
+    "Read each task file and chain through them. Build and commit after each one."
+  ].join("\n");
+}
+var CONFIRMATION_WINDOW_MS = 3 * 60 * 1e3;
+var _pendingCapacityKill = /* @__PURE__ */ new Map();
+function filterPaneContent(paneOutput) {
+  return paneOutput.split("\n").filter((line) => {
+    if (CONTENT_LINE_PREFIX.test(line)) return false;
+    for (const marker of CONTENT_LINE_MARKERS) {
+      if (line.includes(marker)) return false;
+    }
+    for (const re of SOURCE_CODE_MARKERS) {
+      if (re.test(line)) return false;
+    }
+    return true;
+  }).join("\n");
+}
+var CC_CONTEXT_BAR_RE = /([\u2588\u2591\u2592\u2593]{10})\s+(\d+)%/;
+var CTX_FLOOR_PERCENT = 50;
+function extractContextPercent(paneOutput) {
+  const match = paneOutput.match(CC_CONTEXT_BAR_RE);
+  if (!match) return null;
+  const parsed = Number.parseInt(match[2], 10);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function isAtCapacity(paneOutput) {
+  const filtered = filterPaneContent(paneOutput);
+  return CAPACITY_PATTERNS.some((p) => p.test(filtered));
+}
+function confirmCapacityKill(agentId, now = Date.now()) {
+  const pendingSince = _pendingCapacityKill.get(agentId);
+  if (pendingSince === void 0) {
+    _pendingCapacityKill.set(agentId, now);
+    return false;
+  }
+  if (now - pendingSince > CONFIRMATION_WINDOW_MS) {
+    _pendingCapacityKill.set(agentId, now);
+    return false;
+  }
+  _pendingCapacityKill.delete(agentId);
+  return true;
+}
+function _resetPendingCapacityKills() {
+  _pendingCapacityKill.clear();
+}
+function _resetLastRelaunchCache() {
+  _lastRelaunch.clear();
+}
+async function lastResumeCreatedAtMs(agentId, sessionScope) {
+  const client = getClient();
+  const cmScope = sessionScopeFilter(sessionScope ?? null);
+  const result = await client.execute({
+    sql: `SELECT MAX(created_at) AS last_created_at
+          FROM tasks
+          WHERE assigned_to = ? AND title LIKE ?${cmScope.sql}`,
+    args: [agentId, `${RESUME_TITLE_PREFIX} %`, ...cmScope.args]
+  });
+  const raw = result.rows[0]?.last_created_at;
+  if (raw === null || raw === void 0) return null;
+  const parsed = Date.parse(String(raw));
+  return Number.isNaN(parsed) ? null : parsed;
+}
+async function isWithinRelaunchCooldown(agentId, now = Date.now(), sessionScope) {
+  const cacheKey = sessionScope ? `${agentId}::${sessionScope}` : agentId;
+  const cached = _lastRelaunch.get(cacheKey);
+  if (cached !== void 0) return now - cached < RELAUNCH_COOLDOWN_MS;
+  const persisted = await lastResumeCreatedAtMs(agentId, sessionScope);
+  if (persisted === null) return false;
+  if (now - persisted >= RELAUNCH_COOLDOWN_MS) return false;
+  _lastRelaunch.set(cacheKey, persisted);
+  return true;
+}
+async function createOrRefreshResumeTask(agentId, projectDir, openTasks, sessionScope) {
+  const client = getClient();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const context = buildResumeContext(agentId, openTasks);
+  const rdScope = sessionScopeFilter(sessionScope ?? null);
+  const existing = await client.execute({
+    sql: `SELECT id FROM tasks
+          WHERE assigned_to = ?
+            AND title LIKE ?
+            AND status IN (${RESUME_ACTIVE_STATUSES.map(() => "?").join(", ")})${rdScope.sql}
+          ORDER BY created_at DESC
+          LIMIT 1`,
+    args: [agentId, RESUME_TITLE_LIKE_PATTERN, ...RESUME_ACTIVE_STATUSES, ...rdScope.args]
+  });
+  if (existing.rows.length > 0) {
+    const taskId = String(existing.rows[0].id);
+    await client.execute({
+      sql: `UPDATE tasks SET context = ?, updated_at = ? WHERE id = ?`,
+      args: [context, now, taskId]
+    });
+    recordOrchestrationEventBestEffort({
+      eventType: "session.resumed",
+      source: "capacity-monitor.createOrRefreshResumeTask",
+      agentId,
+      taskId,
+      payload: { created: false, action: "refreshed" }
+    });
+    return { created: false, taskId };
+  }
+  const { createTask } = await import("./lib/tasks.js");
+  const task = await createTask({
+    title: resumeTaskTitle(agentId),
+    assignedTo: agentId,
+    assignedBy: "system",
+    projectName: projectDir.split("/").pop() ?? "unknown",
+    priority: "p0",
+    context,
+    baseDir: projectDir
+  });
+  recordOrchestrationEventBestEffort({
+    eventType: "session.resumed",
+    source: "capacity-monitor.createOrRefreshResumeTask",
+    agentId,
+    taskId: task.id,
+    payload: { created: true, action: "created", openTaskCount: openTasks.length }
+  });
+  return { created: true, taskId: task.id };
+}
+async function pollCapacityDead() {
+  const transport = getTransport();
+  const relaunched = [];
+  const registered = listSessions();
+  if (registered.length === 0) return [];
+  let liveSessions;
+  try {
+    liveSessions = transport.listSessions();
+  } catch {
+    return [];
+  }
+  for (const entry of registered) {
+    const { windowName, agentId, projectDir } = entry;
+    if (!liveSessions.includes(windowName)) continue;
+    const cmDashIdx = windowName.indexOf("-");
+    const cmDerivedScope = cmDashIdx >= 0 ? windowName.slice(cmDashIdx + 1) : null;
+    if (await isWithinRelaunchCooldown(agentId, Date.now(), cmDerivedScope)) continue;
+    let pane;
+    try {
+      pane = transport.capturePane(windowName, 15);
+    } catch {
+      continue;
+    }
+    if (!isAtCapacity(pane)) continue;
+    const ctxPct = extractContextPercent(pane);
+    if (ctxPct !== null && ctxPct < CTX_FLOOR_PERCENT) {
+      process.stderr.write(
+        `[capacity-monitor] ctx-floor: ${agentId} at ${ctxPct}% in ${windowName} \u2014 below ${CTX_FLOOR_PERCENT}%. Skipping capacity kill (likely self-referential content or false positive).
+`
+      );
+      continue;
+    }
+    if (!confirmCapacityKill(agentId)) {
+      process.stderr.write(
+        `[capacity-monitor] ${agentId} matched capacity pattern once in ${windowName}. Awaiting confirmation on next tick.
+`
+      );
+      continue;
+    }
+    const verify = await verifyPaneAtCapacity(windowName);
+    if (!verify.atCapacity) {
+      process.stderr.write(
+        `[capacity-monitor] verifyPaneAtCapacity rejected kill for ${agentId} in ${windowName} (reason: ${verify.reason}). Skipping.
+`
+      );
+      void recordSessionKill({
+        sessionName: windowName,
+        agentId,
+        reason: "capacity_false_positive_blocked"
+      });
+      continue;
+    }
+    process.stderr.write(
+      `[capacity-monitor] Detected ${agentId} at capacity in session ${windowName} (confirmed). Auto-relaunching.
+`
+    );
+    if (isCoordinatorName(agentId)) {
+      try {
+        const { loadConfigSync } = await import("./lib/config.js");
+        const cfg = loadConfigSync();
+        if (cfg.sessionLifecycle.autoRelaunchCoordinator !== false) {
+          const fs = await import("fs");
+          const path = await import("path");
+          const os = await import("os");
+          const markerDir = path.join(os.homedir(), ".exe-os", "session-cache");
+          fs.mkdirSync(markerDir, { recursive: true });
+          const markerPath = path.join(markerDir, `relaunch-${windowName}.json`);
+          fs.writeFileSync(markerPath, JSON.stringify({
+            reason: "context_full",
+            agentId,
+            projectDir,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          }));
+          process.stderr.write(
+            `[capacity-monitor] Coordinator relaunch marker written: ${markerPath}
+`
+          );
+        }
+        transport.kill(windowName);
+        void recordSessionKill({ sessionName: windowName, agentId, reason: "capacity" });
+        const coordCacheKey = cmDerivedScope ? `${agentId}::${cmDerivedScope}` : agentId;
+        _lastRelaunch.set(coordCacheKey, Date.now());
+        relaunched.push(agentId);
+      } catch (err) {
+        process.stderr.write(
+          `[capacity-monitor] Coordinator relaunch marker write failed: ${err instanceof Error ? err.message : String(err)}
+`
+        );
+      }
+      continue;
+    }
+    try {
+      transport.kill(windowName);
+      void recordSessionKill({
+        sessionName: windowName,
+        agentId,
+        reason: "capacity"
+      });
+      const client = getClient();
+      const dashIdx = windowName.indexOf("-");
+      const derivedScope = dashIdx >= 0 ? windowName.slice(dashIdx + 1) : null;
+      const rlScope = sessionScopeFilter(derivedScope);
+      const openTasks = await client.execute({
+        sql: `SELECT id, title, priority, task_file, status
+              FROM tasks
+              WHERE assigned_to = ? AND status IN ('open', 'in_progress')${rlScope.sql}
+              ORDER BY
+                CASE priority WHEN 'p0' THEN 0 WHEN 'p1' THEN 1 WHEN 'p2' THEN 2 ELSE 3 END,
+                created_at ASC
+              LIMIT 10`,
+        args: [agentId, ...rlScope.args]
+      });
+      if (openTasks.rows.length === 0) {
+        process.stderr.write(
+          `[capacity-monitor] ${agentId} has no open tasks \u2014 skipping relaunch.
+`
+        );
+        continue;
+      }
+      const { created } = await createOrRefreshResumeTask(
+        agentId,
+        projectDir,
+        openTasks.rows,
+        derivedScope
+      );
+      if (created) {
+        await writeNotification({
+          agentId: "system",
+          agentRole: "daemon",
+          event: "capacity_relaunch",
+          project: projectDir.split("/").pop() ?? "unknown",
+          summary: `${agentId} hit context capacity. Auto-relaunched with ${openTasks.rows.length} open task(s).`
+        });
+      }
+      const cacheKey = derivedScope ? `${agentId}::${derivedScope}` : agentId;
+      _lastRelaunch.set(cacheKey, Date.now());
+      if (created) relaunched.push(agentId);
+    } catch (err) {
+      process.stderr.write(
+        `[capacity-monitor] Failed to relaunch ${agentId}: ${err instanceof Error ? err.message : String(err)}
+`
+      );
+    }
+  }
+  return relaunched;
+}
+
+export {
+  CTX_FLOOR_PERCENT,
+  extractContextPercent,
+  isAtCapacity,
+  confirmCapacityKill,
+  _resetPendingCapacityKills,
+  _resetLastRelaunchCache,
+  isWithinRelaunchCooldown,
+  createOrRefreshResumeTask,
+  pollCapacityDead
+};