@askexenow/exe-os 0.9.365 → 0.9.367

package/dist/chunk-PFR6EOUY.js

@@ -0,0 +1,356 @@
+import {
+  getAgentLivenessReport
+} from "./chunk-PHUHIVD5.js";
+import {
+  isValidSessionScope
+} from "./chunk-BTSWFMEH.js";
+import {
+  leaseExpiryIso,
+  leaseNowIso
+} from "./chunk-E23LNUWJ.js";
+import {
+  getClient
+} from "./chunk-HSBKV5LB.js";
+
+// src/lib/work-claims.ts
+var CLAIM_TTL_MINUTES = 90;
+var CLAIM_GRACE_MINUTES = 30;
+var MAX_CLAIM_AGE_HOURS = 24;
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+var SHORT_ID_RE = /^[0-9a-f]{8}$/;
+function normalizeWorkRef(raw) {
+  const v = raw.trim().toLowerCase();
+  if (UUID_RE.test(v)) return v.slice(0, 8);
+  if (SHORT_ID_RE.test(v)) return v;
+  return v.replace(/\s+/g, " ");
+}
+function normalizePathTarget(raw, repoRoot) {
+  let v = raw.trim().replace(/\\/g, "/");
+  if (repoRoot) {
+    const root = repoRoot.replace(/\\/g, "/").replace(/\/+$/, "");
+    if (v.startsWith(root + "/")) v = v.slice(root.length + 1);
+  }
+  v = v.replace(/^\.\//, "").replace(/^\/+/, (m) => repoRoot ? "" : m);
+  return v;
+}
+function normalizeTarget(target, opts = {}) {
+  if (target.kind === "path") {
+    const rel = normalizePathTarget(target.value, opts.repoRoot);
+    const project = (opts.project ?? "").trim();
+    const key = project ? `${project}/${rel}` : rel;
+    return { kind: "path", key, label: project ? `${project}/${rel}` : rel };
+  }
+  return { kind: "work_ref", key: normalizeWorkRef(target.value), label: target.value.trim() };
+}
+function extractWorkRefCandidates(text) {
+  if (!text) return [];
+  const out = /* @__PURE__ */ new Set();
+  for (const m of text.toLowerCase().matchAll(/\b[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}\b/g)) {
+    out.add(m[0].slice(0, 8));
+  }
+  for (const m of text.toLowerCase().matchAll(/\b[0-9a-f]{8}\b/g)) {
+    out.add(m[0]);
+  }
+  return [...out];
+}
+function rootScope(sessionName) {
+  const raw = (sessionName ?? "").trim();
+  if (!raw) return "";
+  const lastDash = raw.lastIndexOf("-");
+  return lastDash >= 0 ? raw.slice(lastDash + 1) : raw;
+}
+function liveSessionScopes() {
+  const live = /* @__PURE__ */ new Set();
+  try {
+    for (const r of getAgentLivenessReport()) {
+      if (r.status === "dead") continue;
+      const root = rootScope(r.sessionName);
+      if (root) live.add(root);
+    }
+  } catch {
+  }
+  return live;
+}
+var SELECT_COLS = "id, claim_group, target_kind, target_key, target_label, task_id, holder_session, holder_agent, note, claimed_at, lease_expires_at, updated_at";
+function toRow(r) {
+  return {
+    id: String(r.id),
+    claimGroup: String(r.claim_group),
+    targetKind: String(r.target_kind),
+    targetKey: String(r.target_key),
+    targetLabel: r.target_label == null ? String(r.target_key) : String(r.target_label),
+    taskId: r.task_id == null ? null : String(r.task_id),
+    holderSession: String(r.holder_session),
+    holderAgent: r.holder_agent == null ? null : String(r.holder_agent),
+    note: r.note == null ? null : String(r.note),
+    claimedAt: String(r.claimed_at),
+    leaseExpiresAt: String(r.lease_expires_at),
+    updatedAt: String(r.updated_at)
+  };
+}
+function isUniqueViolation(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return /UNIQUE constraint failed|SQLITE_CONSTRAINT_UNIQUE|duplicate key value/i.test(msg);
+}
+async function listClaims() {
+  const client = await getClient();
+  const res = await client.execute({
+    sql: `SELECT ${SELECT_COLS} FROM work_claims ORDER BY claimed_at DESC`,
+    args: []
+  });
+  return res.rows.map(toRow);
+}
+async function findConflicts(targets, holderSession) {
+  if (targets.length === 0) return [];
+  const client = await getClient();
+  const placeholders = targets.map(() => "(target_kind = ? AND target_key = ?)").join(" OR ");
+  const args = [];
+  for (const t of targets) args.push(t.kind, t.key);
+  const res = await client.execute({
+    sql: `SELECT ${SELECT_COLS} FROM work_claims WHERE (${placeholders})`,
+    args
+  });
+  const nowMs = Date.now();
+  const live = liveSessionScopes();
+  return res.rows.map(toRow).filter((r) => r.holderSession !== holderSession).filter((r) => {
+    const expiresMs = new Date(r.leaseExpiresAt).getTime();
+    if (Number.isNaN(expiresMs)) return true;
+    if (expiresMs >= nowMs) return true;
+    const ageMs = nowMs - new Date(r.claimedAt).getTime();
+    return live.has(r.holderSession) && ageMs < MAX_CLAIM_AGE_HOURS * 36e5;
+  });
+}
+async function findConflictsInText(text, holderSession) {
+  const candidates = extractWorkRefCandidates(text);
+  if (candidates.length === 0) return [];
+  return findConflicts(
+    candidates.map((c) => ({ kind: "work_ref", key: c, label: c })),
+    holderSession
+  );
+}
+async function acquireClaim(input) {
+  const holderSession = (input.holderSession ?? "").trim();
+  if (!isValidSessionScope(holderSession)) {
+    throw new Error(
+      `work-claims: refusing to claim for an invalid session scope "${holderSession}". A claim must name the owning coordinator session (e.g. exe2), not an agent or free text.`
+    );
+  }
+  if (input.force && !(input.reason ?? "").trim()) {
+    throw new Error(
+      "work-claims: force override requires a reason. Overriding another session's claim is a deliberate act and is recorded with who and why."
+    );
+  }
+  const targets = input.targets.map((t) => normalizeTarget(t, { repoRoot: input.repoRoot, project: input.project })).filter((t) => t.key.length > 0);
+  if (targets.length === 0) {
+    throw new Error("work-claims: no valid targets to claim.");
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const unique = targets.filter((t) => {
+    const k = `${t.kind}\0${t.key}`;
+    if (seen.has(k)) return false;
+    seen.add(k);
+    return true;
+  });
+  const client = await getClient();
+  const now = leaseNowIso();
+  const nowMs = Date.parse(now);
+  const expiry = leaseExpiryIso(now, input.ttlMinutes ?? CLAIM_TTL_MINUTES);
+  const graceExpiry = leaseExpiryIso(now, CLAIM_GRACE_MINUTES);
+  const minClaimedAt = new Date(nowMs - MAX_CLAIM_AGE_HOURS * 36e5).toISOString();
+  const live = [...liveSessionScopes()];
+  const stmts = [];
+  if (live.length > 0) {
+    stmts.push({
+      sql: `UPDATE work_claims SET lease_expires_at = ?, updated_at = ? WHERE lease_expires_at < ? AND claimed_at > ? AND holder_session IN (${live.map(() => "?").join(",")})`,
+      args: [graceExpiry, now, now, minClaimedAt, ...live]
+    });
+  }
+  stmts.push({
+    sql: `DELETE FROM work_claims WHERE lease_expires_at < ?`,
+    args: [now]
+  });
+  for (const t of unique) {
+    if (input.force) {
+      stmts.push({
+        sql: `DELETE FROM work_claims WHERE target_kind = ? AND target_key = ?`,
+        args: [t.kind, t.key]
+      });
+    } else {
+      stmts.push({
+        sql: `DELETE FROM work_claims WHERE target_kind = ? AND target_key = ? AND holder_session = ?`,
+        args: [t.kind, t.key, holderSession]
+      });
+    }
+  }
+  const claimGroup = crypto.randomUUID();
+  for (const t of unique) {
+    stmts.push({
+      sql: `INSERT INTO work_claims (id, claim_group, target_kind, target_key, target_label, task_id, holder_session, holder_agent, note, claimed_at, lease_expires_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      args: [
+        crypto.randomUUID(),
+        claimGroup,
+        t.kind,
+        t.key,
+        t.label,
+        input.taskId ?? null,
+        holderSession,
+        input.holderAgent ?? null,
+        input.note ?? null,
+        now,
+        expiry,
+        now
+      ]
+    });
+  }
+  let displaced = [];
+  if (input.force) {
+    try {
+      displaced = await findConflicts(unique, holderSession);
+    } catch {
+    }
+  }
+  try {
+    await client.batch(stmts, "write");
+  } catch (err) {
+    if (!isUniqueViolation(err)) throw err;
+    if (live.length > 0) {
+      try {
+        await client.execute({
+          sql: `UPDATE work_claims SET lease_expires_at = ?, updated_at = ? WHERE lease_expires_at < ? AND claimed_at > ? AND holder_session IN (${live.map(() => "?").join(",")})`,
+          args: [graceExpiry, now, now, minClaimedAt, ...live]
+        });
+      } catch {
+      }
+    }
+    let conflicts = [];
+    try {
+      conflicts = await findConflicts(unique, holderSession);
+    } catch {
+    }
+    return { ok: false, claimGroup: null, claimed: [], conflicts };
+  }
+  await recordClaimEvent(
+    input.force ? "claim.override" : "claim.acquired",
+    holderSession,
+    input.holderAgent ?? null,
+    {
+      claimGroup,
+      targets: unique.map((t) => `${t.kind}:${t.key}`),
+      note: input.note ?? null,
+      reason: input.reason ?? null,
+      displaced: displaced.map((d) => ({
+        target: `${d.targetKind}:${d.targetKey}`,
+        holderSession: d.holderSession,
+        holderAgent: d.holderAgent,
+        claimedAt: d.claimedAt
+      }))
+    },
+    input.force ? "warn" : "info"
+  );
+  return { ok: true, claimGroup, claimed: unique, conflicts: [] };
+}
+async function releaseClaim(input) {
+  const holderSession = (input.holderSession ?? "").trim();
+  if (input.force && !(input.reason ?? "").trim()) {
+    throw new Error("work-claims: force release requires a reason.");
+  }
+  const client = await getClient();
+  let released = 0;
+  if (!input.claimGroup && !input.taskId && (input.targets ?? []).length === 0) {
+    return { released: 0 };
+  }
+  if (input.claimGroup) {
+    const sql = input.force ? `DELETE FROM work_claims WHERE claim_group = ?` : `DELETE FROM work_claims WHERE claim_group = ? AND holder_session = ?`;
+    const args = input.force ? [input.claimGroup] : [input.claimGroup, holderSession];
+    const res = await client.execute({ sql, args });
+    released += Number(res.rowsAffected ?? 0);
+  }
+  if (input.taskId) {
+    const sql = input.force ? `DELETE FROM work_claims WHERE task_id = ?` : `DELETE FROM work_claims WHERE task_id = ? AND holder_session = ?`;
+    const args = input.force ? [input.taskId] : [input.taskId, holderSession];
+    const res = await client.execute({ sql, args });
+    released += Number(res.rowsAffected ?? 0);
+  }
+  for (const raw of input.targets ?? []) {
+    const t = normalizeTarget(raw, { repoRoot: input.repoRoot, project: input.project });
+    if (!t.key) continue;
+    const sql = input.force ? `DELETE FROM work_claims WHERE target_kind = ? AND target_key = ?` : `DELETE FROM work_claims WHERE target_kind = ? AND target_key = ? AND holder_session = ?`;
+    const args = input.force ? [t.kind, t.key] : [t.kind, t.key, holderSession];
+    const res = await client.execute({ sql, args });
+    released += Number(res.rowsAffected ?? 0);
+  }
+  if (released > 0) {
+    await recordClaimEvent(
+      input.force ? "claim.force_released" : "claim.released",
+      holderSession,
+      null,
+      {
+        claimGroup: input.claimGroup ?? null,
+        taskId: input.taskId ?? null,
+        released,
+        reason: input.reason ?? null
+      },
+      input.force ? "warn" : "info"
+    );
+  }
+  return { released };
+}
+async function heartbeatClaims(holderSession, ttlMinutes = CLAIM_TTL_MINUTES) {
+  const client = await getClient();
+  const now = leaseNowIso();
+  const res = await client.execute({
+    sql: `UPDATE work_claims SET lease_expires_at = ?, updated_at = ? WHERE holder_session = ?`,
+    args: [leaseExpiryIso(now, ttlMinutes), now, holderSession]
+  });
+  return { renewed: Number(res.rowsAffected ?? 0) };
+}
+async function recordClaimEvent(eventType, sessionScope, agentId, payload, severity) {
+  try {
+    const { recordOrchestrationEventBestEffort } = await import("./orchestration-events-HVG56HJ5.js");
+    recordOrchestrationEventBestEffort({
+      eventType,
+      source: "work-claims",
+      severity,
+      sessionScope: sessionScope || null,
+      agentId: agentId ?? void 0,
+      payload
+    });
+  } catch {
+  }
+}
+async function resolveHolderSession() {
+  let raw = "";
+  try {
+    const { getAgentContext } = await import("./agent-context-AZTTMUHP.js");
+    raw = getAgentContext()?.sessionHint ?? "";
+  } catch {
+  }
+  if (!raw) raw = process.env.EXE_SESSION_NAME || process.env.EXE_SESSION || "";
+  const root = rootScope(raw);
+  return isValidSessionScope(root) ? root : "";
+}
+function describeConflict(row, nowMs = Date.now()) {
+  const ageMin = Math.max(0, Math.round((nowMs - new Date(row.claimedAt).getTime()) / 6e4));
+  const who = row.holderAgent ? `${row.holderSession} (${row.holderAgent})` : row.holderSession;
+  const note = row.note ? ` \u2014 "${row.note}"` : "";
+  return `${row.targetKind}:${row.targetLabel} held by ${who}, ${ageMin}m ago${note}`;
+}
+
+export {
+  CLAIM_TTL_MINUTES,
+  CLAIM_GRACE_MINUTES,
+  MAX_CLAIM_AGE_HOURS,
+  normalizeWorkRef,
+  normalizePathTarget,
+  normalizeTarget,
+  extractWorkRefCandidates,
+  liveSessionScopes,
+  listClaims,
+  findConflicts,
+  findConflictsInText,
+  acquireClaim,
+  releaseClaim,
+  heartbeatClaims,
+  resolveHolderSession,
+  describeConflict
+};

package/dist/{agent-heartbeat-I5UPGXAU.js → chunk-PHUHIVD5.js}

@@ -1,5 +1,3 @@
-import "./chunk-MLKGABMK.js";
-
 // src/lib/agent-heartbeat.ts
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 import path from "path";
@@ -52,9 +50,10 @@ function getAgentLivenessReport() {
     };
   });
 }
+
 export {
-  classifyLiveness,
-  getAgentLivenessReport,
   loadHeartbeats,
-  recordHeartbeat
+  recordHeartbeat,
+  classifyLiveness,
+  getAgentLivenessReport
 };

package/dist/{chunk-45EQTS7B.js → chunk-PQ6NRLKL.js}

@@ -1,6 +1,6 @@
 import {
   listReminders
-} from "./chunk-RD4E5G3B.js";
+} from "./chunk-DTTISDTI.js";
 
 // src/mcp/tools/list-reminders.ts
 import { z } from "zod";

package/dist/{chunk-5CBGH6RA.js → chunk-PR3AHVFW.js}

@@ -4,10 +4,10 @@ import {
 import {
   reserveVersions,
   vectorToBlob
-} from "./chunk-4QKKLK3C.js";
+} from "./chunk-BQYQES2Z.js";
 import {
   getClient
-} from "./chunk-BRLS5OLZ.js";
+} from "./chunk-HSBKV5LB.js";
 
 // src/lib/documents.ts
 import crypto from "crypto";
@@ -270,7 +270,7 @@ async function ingestDocument(input) {
   await client.batch([documentStmt, ...chunkStmts], "write");
   const embedded = vectors.filter((v) => v !== null).length;
   const originalTexts = input.chunks.map((c) => c.text);
-  import("./doc-graph-extractor-P46R4QME.js").then(
+  import("./doc-graph-extractor-CAYUAM5A.js").then(
     ({ extractAndStoreDocumentGraph }) => extractAndStoreDocumentGraph(documentId, originalTexts)
   ).catch((err) => {
     process.stderr.write(