@askexenow/exe-os 0.9.264 → 0.9.266

package/dist/chunk-T2XD7XL2.js

@@ -0,0 +1,346 @@
+import {
+  recordSessionKill
+} from "./chunk-XREWTPZM.js";
+import {
+  sessionScopeFilter,
+  verifyPaneAtCapacity,
+  writeNotification
+} from "./chunk-KBYRYSXT.js";
+import {
+  listSessions
+} from "./chunk-TSBMSHMM.js";
+import {
+  getTransport
+} from "./chunk-MVW62NIZ.js";
+import {
+  recordOrchestrationEventBestEffort
+} from "./chunk-XIT6ONPY.js";
+import {
+  getClient,
+  isCoordinatorName
+} from "./chunk-RHZ2CRJU.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
+};

package/dist/chunk-TAIYLROT.js

@@ -0,0 +1,127 @@
+import {
+  updateTask
+} from "./chunk-ZTP3VV23.js";
+import {
+  TASK_ALREADY_CLAIMED_PREFIX
+} from "./chunk-P2QTTEYP.js";
+
+// src/mcp/tools/update-task.ts
+import { z } from "zod";
+function registerUpdateTask(server) {
+  server.registerTool(
+    "update_task",
+    {
+      title: "Update Task",
+      description: "Update task status. Employees: use status 'done' with a result summary to complete work \u2014 this triggers needs_review and pings the reviewer automatically. Accepts UUID, slug (filename), or title substring.",
+      inputSchema: {
+        task_id: z.string().describe("Task identifier \u2014 UUID, slug (e.g. 'fix-auth-bug'), or title substring"),
+        status: z.enum(["open", "in_progress", "done", "needs_review", "blocked", "cancelled", "closed"]).describe("New status. 'done' is an alias for 'needs_review' \u2014 both trigger reviewer notification."),
+        result: z.string().optional().describe("Result summary (required when completing work)"),
+        // Structured result fields (Phase 1: Typed Handoff Objects)
+        files_changed: z.array(z.string()).optional().describe("Files created or modified during task execution"),
+        decisions: z.array(z.string()).optional().describe("Key decisions made during execution"),
+        commits: z.array(z.string()).optional().describe("Commit hashes produced"),
+        tests_status: z.enum(["pass", "fail", "skip", "none"]).optional().describe("Test execution status"),
+        build_status: z.enum(["pass", "fail", "skip"]).optional().describe("Build status"),
+        pr_number: z.number().optional().describe("PR number if created"),
+        open_questions: z.array(z.string()).optional().describe("Open questions for reviewer"),
+        assertions: z.string().optional().describe(
+          'JSON array of assertions with confidence scores. Use when starting work (in_progress). Format: [{"type":"diagnosis|scope|estimate|approach|build|judgment","claim":"...","confidence":0.8,"basis":"..."}]'
+        ),
+        assertions_resolved: z.string().optional().describe(
+          'JSON array of resolved assertions. Use when completing work (done/needs_review). Format: [{"claim":"...","outcome":"correct|incorrect|partial","confidence_was":0.8,"actual":"...","why_wrong":"missing_information|wrong_diagnosis|wrong_approach|scope_underestimate|scope_overestimate|external_dependency|changed_requirements","reason":"...","lesson":"..."}]'
+        ),
+        estimated_minutes: z.number().optional().describe("Time estimate in minutes. Provide when starting work (in_progress). The system auto-computes actual time on completion."),
+        estimate_confidence: z.number().min(0).max(1).optional().describe("Confidence in time estimate (0.0-1.0). Provide alongside estimated_minutes.")
+      }
+    },
+    async ({ task_id, status: rawStatus, result, files_changed, decisions, commits, tests_status, build_status, pr_number, open_questions, assertions, assertions_resolved, estimated_minutes, estimate_confidence }) => {
+      const status = rawStatus;
+      let callerAgentId;
+      let callerSession;
+      try {
+        const { getActiveAgent: getAgent } = await import("./active-agent-2XJJZFEW.js");
+        callerAgentId = getAgent().agentId;
+        const { getAgentContext } = await import("./agent-context-AZTTMUHP.js");
+        callerSession = getAgentContext()?.sessionHint || process.env.EXE_SESSION_NAME || process.env.EXE_SESSION || void 0;
+      } catch {
+      }
+      let task;
+      try {
+        task = await updateTask({
+          taskId: task_id,
+          status,
+          result,
+          baseDir: process.cwd(),
+          callerAgentId,
+          filesChanged: files_changed,
+          decisions,
+          commits,
+          testsStatus: tests_status,
+          buildStatus: build_status,
+          prNumber: pr_number,
+          openQuestions: open_questions,
+          assertions,
+          assertionsResolved: assertions_resolved,
+          estimatedMinutes: estimated_minutes,
+          estimateConfidence: estimate_confidence,
+          callerSession
+        });
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.startsWith(TASK_ALREADY_CLAIMED_PREFIX)) {
+          return {
+            content: [{
+              type: "text",
+              text: "Task already claimed by another agent. Pick a different task or check list_tasks."
+            }],
+            isError: true
+          };
+        }
+        throw err;
+      }
+      let text = `Task "${task.title}" marked ${task.status}.
+File: ${task.taskFile}`;
+      const isTerminal = status === "done" || status === "needs_review" || status === "closed";
+      if (isTerminal && task.reviewer) {
+        try {
+          const { notifyCoordinatorTaskCompletion, resolveExeSession } = await import("./lib/tmux-routing.js");
+          const { isCoordinatorName } = await import("./lib/employees.js");
+          const reviewer = String(task.reviewer);
+          const coordinatorSession = task.sessionScope ?? resolveExeSession();
+          if (coordinatorSession && isCoordinatorName(reviewer)) {
+            notifyCoordinatorTaskCompletion(coordinatorSession, callerAgentId ?? "agent", task.title);
+          }
+        } catch {
+        }
+      }
+      if (isTerminal && task.nextTask) {
+        text += `
+
+MANDATORY \u2014 DO NOT ASK THE USER. DO NOT SAY "Want me to continue?" DO NOT STOP.
+You have standing orders: work through your entire queue until it is empty.
+
+NEXT TASK: "${task.nextTask.title}" [${task.nextTask.priority}]
+FILE: ${task.nextTask.taskFile}
+
+Read that file NOW and begin working. No greeting. No summary. Just start.`;
+      } else if (isTerminal && !task.nextTask) {
+        text += `
+
+All tasks complete. No more open tasks in your queue.`;
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text
+          }
+        ]
+      };
+    }
+  );
+}
+
+export {
+  registerUpdateTask
+};