@askexenow/exe-os 0.9.296 → 0.9.298

package/dist/chunk-2DQIQXHX.js

@@ -0,0 +1,204 @@
+import {
+  getClient
+} from "./chunk-I3IW6AAX.js";
+
+// src/lib/pipeline-router.ts
+import crypto from "crypto";
+async function sinkConversationStore(msg, agentResponse, agentName) {
+  try {
+    const client = getClient();
+    const id = crypto.randomUUID();
+    const mediaJson = msg.media ? JSON.stringify(msg.media) : null;
+    await client.execute({
+      sql: `INSERT INTO conversations
+            (id, platform, external_id, sender_id, sender_name, sender_phone, sender_email,
+             recipient_id, channel_id, thread_id, reply_to_id,
+             content_text, content_media, agent_response, agent_name,
+             timestamp, ingested_at)
+            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      args: [
+        id,
+        msg.platform,
+        msg.messageId,
+        msg.senderId,
+        msg.senderName ?? null,
+        msg.senderPhone ?? null,
+        msg.senderEmail ?? null,
+        msg.accountId ?? null,
+        msg.channelId,
+        msg.threadId ?? `${msg.platform}:${msg.channelId}`,
+        msg.replyTo?.messageId ?? null,
+        msg.text ?? null,
+        mediaJson,
+        agentResponse ?? null,
+        agentName ?? null,
+        msg.timestamp,
+        (/* @__PURE__ */ new Date()).toISOString()
+      ]
+    });
+    return true;
+  } catch (err) {
+    process.stderr.write(
+      `[pipeline] conversation-store error: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    return false;
+  }
+}
+async function sinkMemory(msg, agentResponse, agentName) {
+  try {
+    const { embed } = await import("./lib/embedder.js");
+    const { writeMemory, flushBatch } = await import("./lib/store.js");
+    const direction = agentResponse ? "conversation" : "inbound";
+    const rawText = [
+      `[${msg.platform}] ${direction} from ${msg.senderName ?? msg.senderId}`,
+      msg.text ? `Message: ${msg.text}` : null,
+      agentResponse ? `Agent (${agentName ?? "unknown"}): ${agentResponse}` : null
+    ].filter(Boolean).join("\n");
+    const vector = await embed(rawText);
+    await writeMemory({
+      id: crypto.randomUUID(),
+      agent_id: agentName ?? "gateway",
+      agent_role: "gateway",
+      session_id: `gateway-${msg.platform}`,
+      timestamp: msg.timestamp,
+      tool_name: `gateway-${msg.platform}`,
+      project_name: "exe-os",
+      has_error: false,
+      raw_text: rawText,
+      vector,
+      importance: 4,
+      confidence: 0.8
+    });
+    await flushBatch();
+    return true;
+  } catch (err) {
+    process.stderr.write(
+      `[pipeline] memory-sink error: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    return false;
+  }
+}
+async function sinkCRM(msg, agentResponse, agentName) {
+  try {
+    const { isCRMBridgeEnabled, pushConversationToCRM, pushInboundMessageToCRM } = await import("./crm-bridge-BVTB6LZK.js");
+    if (!isCRMBridgeEnabled()) return false;
+    if (agentResponse) {
+      await pushConversationToCRM({
+        platform: msg.platform,
+        senderId: msg.senderId,
+        senderName: msg.senderName,
+        messageText: msg.text,
+        agentResponse,
+        agentName: agentName ?? "unknown",
+        timestamp: msg.timestamp,
+        accountId: msg.accountId
+      });
+    } else {
+      await pushInboundMessageToCRM({
+        platform: msg.platform,
+        senderId: msg.senderId,
+        senderName: msg.senderName,
+        messageText: msg.text,
+        timestamp: msg.timestamp,
+        accountId: msg.accountId
+      });
+    }
+    return true;
+  } catch (err) {
+    process.stderr.write(
+      `[pipeline] crm-sink error: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    return false;
+  }
+}
+async function sinkWiki(msg, agentResponse) {
+  try {
+    const { createWikiClient } = await import("./wiki-client-Q4O6EMTP.js");
+    const client = await createWikiClient();
+    if (!client) return false;
+    const content = msg.text ?? "";
+    if (content.length < 50) return false;
+    const { chatInWorkspace } = await import("./wiki-client-Q4O6EMTP.js");
+    const ingestText = [
+      `[${msg.platform}] Message from ${msg.senderName ?? msg.senderId} (${msg.timestamp}):`,
+      content,
+      agentResponse ? `
+Agent response: ${agentResponse}` : ""
+    ].join("\n");
+    await chatInWorkspace(client, "conversations", ingestText, "chat");
+    return true;
+  } catch (err) {
+    process.stderr.write(
+      `[pipeline] wiki-sink error: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    return false;
+  }
+}
+async function sinkEntityExtraction(msg, agentResponse, agentName) {
+  try {
+    const { extractFromConversation } = await import("./conversation-entity-extractor-6PJUN5DP.js");
+    const { storeExtraction } = await import("./graph-rag-ZCJ4X7YL.js");
+    if ((msg.text?.length ?? 0) < 20) return false;
+    if (msg.isHistorical) return false;
+    const extraction = await extractFromConversation(msg, agentResponse, agentName);
+    if (extraction.entities.length === 0) return false;
+    const client = getClient();
+    const memoryId = `conv:${msg.messageId}`;
+    await storeExtraction(client, extraction, memoryId, msg.timestamp);
+    import("./conversation-wiki-populator-PDL2SUZJ.js").then(
+      ({ populateWikiFromExtraction }) => populateWikiFromExtraction(extraction, msg, agentResponse, agentName)
+    ).catch((err) => {
+      process.stderr.write(
+        `[pipeline] wiki-population error: ${err instanceof Error ? err.message : String(err)}
+`
+      );
+    });
+    return true;
+  } catch (err) {
+    process.stderr.write(
+      `[pipeline] entity-extraction-sink error: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    return false;
+  }
+}
+async function ingest(msg, agentResponse, agentName) {
+  const errors = [];
+  const [conversationStored, memorySunk, crmSunk, wikiSunk, entityExtracted] = await Promise.all([
+    sinkConversationStore(msg, agentResponse, agentName).catch((e) => {
+      errors.push(`conversation: ${e}`);
+      return false;
+    }),
+    sinkMemory(msg, agentResponse, agentName).catch((e) => {
+      errors.push(`memory: ${e}`);
+      return false;
+    }),
+    sinkCRM(msg, agentResponse, agentName).catch((e) => {
+      errors.push(`crm: ${e}`);
+      return false;
+    }),
+    sinkWiki(msg, agentResponse).catch((e) => {
+      errors.push(`wiki: ${e}`);
+      return false;
+    }),
+    sinkEntityExtraction(msg, agentResponse, agentName).catch((e) => {
+      errors.push(`entity-extraction: ${e}`);
+      return false;
+    })
+  ]);
+  if (errors.length > 0) {
+    process.stderr.write(
+      `[pipeline] ${errors.length} sink error(s): ${errors.join("; ")}
+`
+    );
+  }
+  return { conversationStored, memorySunk, crmSunk, wikiSunk, entityExtracted, errors };
+}
+
+export {
+  ingest
+};

package/dist/chunk-2DWYR2LJ.js

@@ -0,0 +1,395 @@
+import {
+  EXE_AI_DIR
+} from "./chunk-R36FAN53.js";
+
+// src/lib/db-backup.ts
+import { existsSync, readdirSync, unlinkSync, statSync, statfsSync } from "fs";
+import { copyFile, mkdir, unlink, rename } from "fs/promises";
+import path from "path";
+var BACKUP_DIR = path.join(EXE_AI_DIR, "backups");
+var DEFAULT_KEEP_DAYS = 3;
+var DB_NAMES = ["memories.db", "exe-mem.db", "exe-os.db", "exe.db"];
+var REASON_COUNT_CAP = {
+  // Bug 727b7b1e: a daemon OOM crash loop made a ~1.5GB pre-restart backup on
+  // EVERY restart. 22 crashes = 11GB of pre-restart snapshots with no rotation.
+  // Keep only the 2 newest — enough to recover, small enough not to fill disk.
+  "pre-restart": 2,
+  "pre-consolidation": 5,
+  "pre-fix": 5,
+  "pre-restore": 5,
+  // Bug 91b1b167: daily snapshots are full uncompressed SQLCipher copies
+  // (~2-3GB apiece on large enterprise DBs). Time-based rotation alone left
+  // 19GB accumulating when mtimes drifted / the disk guard tripped. A hard
+  // count cap is a belt-and-braces safety net on top of day-based rotation.
+  "daily": 3
+};
+var MIN_FREE_BYTES = 5 * 1024 * 1024 * 1024;
+var STALE_TMP_MAX_AGE_MS = 60 * 60 * 1e3;
+function findActiveDb() {
+  for (const name of DB_NAMES) {
+    const p = path.join(EXE_AI_DIR, name);
+    if (existsSync(p)) return p;
+  }
+  return null;
+}
+async function createBackup(reason = "manual") {
+  return createBackupAsync(reason);
+}
+async function createBackupAsync(reason = "manual", opts = {}) {
+  const dbPath = findActiveDb();
+  if (!dbPath) return null;
+  await mkdir(BACKUP_DIR, { recursive: true });
+  try {
+    let dbSize = 0;
+    try {
+      dbSize = statSync(dbPath).size;
+    } catch {
+    }
+    const freeBytes = getFreeBytes(BACKUP_DIR);
+    if (!hasEnoughDiskSpace(freeBytes, dbSize)) {
+      process.stderr.write(
+        `[db-backup] DISK GUARD: skipping "${reason}" backup \u2014 ${Math.round(freeBytes / 1024 / 1024)}MB free, need >${Math.round(Math.max(MIN_FREE_BYTES, dbSize * 2) / 1024 / 1024)}MB. Disk is nearly full; refusing to make it worse.
+`
+      );
+      return null;
+    }
+  } catch {
+  }
+  const dbName = path.basename(dbPath, ".db");
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+  const backupName = `${dbName}-${reason}-${timestamp}.db`;
+  const backupPath = path.join(BACKUP_DIR, backupName);
+  const tmpBackupPath = `${backupPath}.tmp`;
+  const checkpointMode = opts.checkpointMode ?? "TRUNCATE";
+  try {
+    const { getClient } = await import("./lib/database.js");
+    const client = getClient();
+    await client.execute(`PRAGMA wal_checkpoint(${checkpointMode})`);
+  } catch {
+    try {
+      const { execFile: execFileCb } = await import("child_process");
+      const { promisify } = await import("util");
+      const execFileAsync = promisify(execFileCb);
+      await execFileAsync("sqlite3", [dbPath, `PRAGMA wal_checkpoint(${checkpointMode});`], { timeout: 3e4 });
+    } catch {
+      process.stderr.write(`[db-backup] WAL checkpoint skipped \u2014 proceeding with copy (backup may include stale WAL)
+`);
+    }
+  }
+  try {
+    await unlink(tmpBackupPath);
+  } catch {
+  }
+  await copyFile(dbPath, tmpBackupPath);
+  await rename(tmpBackupPath, backupPath);
+  try {
+    const { getClient } = await import("./lib/database.js");
+    const client = getClient();
+    const chk = await client.execute("PRAGMA quick_check;");
+    const result = String(chk.rows[0]?.quick_check ?? chk.rows[0]?.[0] ?? "").trim();
+    if (result && result !== "ok") {
+      process.stderr.write(`[db-backup] WARNING: backup source failed quick_check (${reason}): ${result}
+`);
+      try {
+        await unlink(backupPath);
+      } catch {
+      }
+      return null;
+    }
+  } catch {
+    process.stderr.write(`[db-backup] Backup validation skipped (encrypted DB or CLI context) \u2014 proceeding with checkpoint-consistent copy.
+`);
+  }
+  const walPath = dbPath + "-wal";
+  if (existsSync(walPath)) {
+    try {
+      await copyFile(walPath, backupPath + "-wal.tmp");
+      await rename(backupPath + "-wal.tmp", backupPath + "-wal");
+    } catch {
+    }
+  }
+  const shmPath = dbPath + "-shm";
+  if (existsSync(shmPath)) {
+    try {
+      await copyFile(shmPath, backupPath + "-shm.tmp");
+      await rename(backupPath + "-shm.tmp", backupPath + "-shm");
+    } catch {
+    }
+  }
+  return backupPath;
+}
+function rotateBackups(keepDays = DEFAULT_KEEP_DAYS) {
+  if (!existsSync(BACKUP_DIR)) return 0;
+  const cutoff = Date.now() - keepDays * 24 * 60 * 60 * 1e3;
+  let deleted = 0;
+  try {
+    const files = readdirSync(BACKUP_DIR);
+    for (const file of files) {
+      if (file.endsWith(".tmp")) continue;
+      if (!file.endsWith(".db") && !file.endsWith(".db-wal") && !file.endsWith(".db-shm")) continue;
+      const filePath = path.join(BACKUP_DIR, file);
+      try {
+        const stat = statSync(filePath);
+        if (stat.mtimeMs < cutoff) {
+          unlinkSync(filePath);
+          deleted++;
+        }
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return deleted;
+}
+function selectBackupsToDelete(backups, keep) {
+  if (keep < 0) keep = 0;
+  const sorted = [...backups].sort((a, b) => b.mtimeMs - a.mtimeMs);
+  return sorted.slice(keep).map((b) => b.path);
+}
+function selectStaleTmpFiles(tmpFiles, cutoffMs) {
+  return tmpFiles.filter((f) => f.mtimeMs < cutoffMs).map((f) => f.path);
+}
+function cleanupStaleTmp(maxAgeMs = STALE_TMP_MAX_AGE_MS) {
+  if (!existsSync(BACKUP_DIR)) return 0;
+  const cutoffMs = Date.now() - maxAgeMs;
+  let deleted = 0;
+  try {
+    const candidates = [];
+    for (const file of readdirSync(BACKUP_DIR)) {
+      if (!file.endsWith(".tmp")) continue;
+      const filePath = path.join(BACKUP_DIR, file);
+      try {
+        candidates.push({ path: filePath, mtimeMs: statSync(filePath).mtimeMs });
+      } catch {
+      }
+    }
+    for (const target of selectStaleTmpFiles(candidates, cutoffMs)) {
+      try {
+        unlinkSync(target);
+        deleted++;
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return deleted;
+}
+function hasEnoughDiskSpace(freeBytes, backupSizeBytes, minFreeBytes = MIN_FREE_BYTES) {
+  const required = Math.max(minFreeBytes, backupSizeBytes * 2);
+  return freeBytes >= required;
+}
+function getFreeBytes(dir) {
+  try {
+    const s = statfsSync(dir);
+    return s.bavail * s.bsize;
+  } catch {
+    return Number.POSITIVE_INFINITY;
+  }
+}
+async function quickCheckBackupSource(source) {
+  try {
+    const { execFile: execFileCb } = await import("child_process");
+    const { promisify } = await import("util");
+    const execFileAsync = promisify(execFileCb);
+    const { stdout } = await execFileAsync("sqlite3", [source, "PRAGMA quick_check;"], { timeout: 3e4 });
+    const result = String(stdout ?? "").trim();
+    if (result !== "ok") {
+      throw new Error(result || "quick_check returned no result");
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (/file is not a database|not an error/i.test(msg)) {
+      process.stderr.write(`[db-backup] Backup source quick_check unavailable for encrypted backup (${path.basename(source)}); proceeding with atomic restore.
+`);
+      return;
+    }
+    throw new Error(`Backup source failed quick_check: ${msg}`);
+  }
+}
+function rotateBackupsByReason(reason, keep) {
+  if (!existsSync(BACKUP_DIR)) return 0;
+  let deleted = 0;
+  try {
+    const files = readdirSync(BACKUP_DIR);
+    const matches = [];
+    for (const file of files) {
+      if (file.endsWith(".tmp")) continue;
+      if (!file.endsWith(".db")) continue;
+      if (!file.includes(`-${reason}-`)) continue;
+      const filePath = path.join(BACKUP_DIR, file);
+      try {
+        matches.push({ path: filePath, mtimeMs: statSync(filePath).mtimeMs });
+      } catch {
+      }
+    }
+    for (const target of selectBackupsToDelete(matches, keep)) {
+      for (const p of [target, target + "-wal", target + "-shm"]) {
+        try {
+          if (existsSync(p)) {
+            unlinkSync(p);
+            if (p === target) deleted++;
+          }
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return deleted;
+}
+function enforceRetention(reason, keepDays = DEFAULT_KEEP_DAYS) {
+  let deleted = rotateBackups(keepDays);
+  const cap = REASON_COUNT_CAP[reason];
+  if (typeof cap === "number") {
+    deleted += rotateBackupsByReason(reason, cap);
+  }
+  deleted += cleanupStaleTmp();
+  return deleted;
+}
+var QUARANTINE_KEEP = 2;
+function pruneCorruptQuarantine(keep = QUARANTINE_KEEP) {
+  if (!existsSync(EXE_AI_DIR)) return 0;
+  let deleted = 0;
+  try {
+    const matches = [];
+    for (const file of readdirSync(EXE_AI_DIR)) {
+      if (!/\.corrupt-\d+$/.test(file)) continue;
+      const filePath = path.join(EXE_AI_DIR, file);
+      try {
+        matches.push({ path: filePath, mtimeMs: statSync(filePath).mtimeMs });
+      } catch {
+      }
+    }
+    for (const target of selectBackupsToDelete(matches, keep)) {
+      for (const p of [target, target + "-wal", target + "-shm"]) {
+        try {
+          if (existsSync(p)) {
+            unlinkSync(p);
+            if (p === target) deleted++;
+          }
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return deleted;
+}
+function cleanupCrashDebris() {
+  let deleted = 0;
+  deleted += rotateBackupsByReason("pre-restart", REASON_COUNT_CAP["pre-restart"] ?? 2);
+  deleted += cleanupStaleTmp();
+  deleted += pruneCorruptQuarantine();
+  return deleted;
+}
+function listBackups() {
+  if (!existsSync(BACKUP_DIR)) return [];
+  try {
+    const files = readdirSync(BACKUP_DIR).filter((f) => f.endsWith(".db") && !f.endsWith(".tmp") && !f.endsWith("-wal") && !f.endsWith("-shm"));
+    return files.map((name) => {
+      const p = path.join(BACKUP_DIR, name);
+      const stat = statSync(p);
+      return { path: p, name, size: stat.size, date: stat.mtime };
+    }).sort((a, b) => b.date.getTime() - a.date.getTime());
+  } catch {
+    return [];
+  }
+}
+function hasBackupToday(reason) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const backups = listBackups();
+  return backups.some((b) => b.name.includes(reason) && b.name.includes(today.replace(/-/g, "-")));
+}
+function hasRecentBackup(reason, withinMs) {
+  try {
+    if (!existsSync(BACKUP_DIR)) return false;
+    const now = Date.now();
+    for (const file of readdirSync(BACKUP_DIR)) {
+      if (file.endsWith(".tmp")) continue;
+      if (!file.endsWith(".db")) continue;
+      if (!file.includes(`-${reason}-`)) continue;
+      try {
+        if (now - statSync(path.join(BACKUP_DIR, file)).mtimeMs <= withinMs) return true;
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return false;
+}
+function getLatestBackup() {
+  const backups = listBackups();
+  return backups.length > 0 ? backups[0].path : null;
+}
+async function restoreBackup(backupPath) {
+  const dbPath = findActiveDb();
+  if (!dbPath) {
+    const target = path.join(EXE_AI_DIR, DB_NAMES[0]);
+    const source2 = backupPath ?? getLatestBackup();
+    if (!source2 || !existsSync(source2)) return null;
+    await copyFile(source2, target);
+    return { restored: path.basename(source2), preRestoreBackup: null };
+  }
+  const source = backupPath ?? getLatestBackup();
+  if (!source || !existsSync(source)) return null;
+  if (path.resolve(source) === path.resolve(dbPath)) return null;
+  await quickCheckBackupSource(source);
+  const preRestoreBackup = await createBackup("pre-restore");
+  const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const tmpDb = `${dbPath}.restore-${stamp}.tmp`;
+  const oldDb = `${dbPath}.pre-restore-active-${stamp}`;
+  await copyFile(source, tmpDb);
+  const walPath = source + "-wal";
+  const shmPath = source + "-shm";
+  const tmpWal = `${tmpDb}-wal`;
+  const tmpShm = `${tmpDb}-shm`;
+  if (existsSync(walPath)) {
+    try {
+      await copyFile(walPath, tmpWal);
+    } catch {
+    }
+  }
+  if (existsSync(shmPath)) {
+    try {
+      await copyFile(shmPath, tmpShm);
+    } catch {
+    }
+  }
+  try {
+    unlinkSync(dbPath + "-wal");
+  } catch {
+  }
+  try {
+    unlinkSync(dbPath + "-shm");
+  } catch {
+  }
+  await rename(dbPath, oldDb);
+  await rename(tmpDb, dbPath);
+  if (existsSync(tmpWal)) await rename(tmpWal, dbPath + "-wal");
+  if (existsSync(tmpShm)) await rename(tmpShm, dbPath + "-shm");
+  return { restored: path.basename(source), preRestoreBackup };
+}
+function getBackupDir() {
+  return BACKUP_DIR;
+}
+
+export {
+  findActiveDb,
+  createBackup,
+  createBackupAsync,
+  rotateBackups,
+  selectBackupsToDelete,
+  selectStaleTmpFiles,
+  cleanupStaleTmp,
+  hasEnoughDiskSpace,
+  rotateBackupsByReason,
+  enforceRetention,
+  pruneCorruptQuarantine,
+  cleanupCrashDebris,
+  listBackups,
+  hasBackupToday,
+  hasRecentBackup,
+  getLatestBackup,
+  restoreBackup,
+  getBackupDir
+};

package/dist/chunk-2MSLUPJA.js

@@ -0,0 +1,70 @@
+import {
+  loadEmployees
+} from "./chunk-I3IW6AAX.js";
+
+// src/lib/agent-symlinks.ts
+import os from "os";
+import path from "path";
+import {
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readlinkSync,
+  symlinkSync
+} from "fs";
+function claudeAgentsDir(homeDir) {
+  return path.join(homeDir, ".claude", "agents");
+}
+function identitySourcePath(homeDir, agentId) {
+  return path.join(homeDir, ".exe-os", "identity", `${agentId}.md`);
+}
+function claudeAgentLinkPath(homeDir, agentId) {
+  return path.join(claudeAgentsDir(homeDir), `${agentId}.md`);
+}
+function ensureAgentSymlink(agentId, homeDir = os.homedir()) {
+  const target = identitySourcePath(homeDir, agentId);
+  const link = claudeAgentLinkPath(homeDir, agentId);
+  mkdirSync(claudeAgentsDir(homeDir), { recursive: true });
+  if (existsSync(link)) {
+    let stat;
+    try {
+      stat = lstatSync(link);
+    } catch {
+      return { agentId, action: "conflict", target, link, conflict: "stat_failed" };
+    }
+    if (!stat.isSymbolicLink()) {
+      return { agentId, action: "conflict", target, link, conflict: "regular_file" };
+    }
+    let currentTarget;
+    try {
+      currentTarget = readlinkSync(link);
+    } catch {
+      return { agentId, action: "conflict", target, link, conflict: "readlink_failed" };
+    }
+    if (currentTarget === target) {
+      return { agentId, action: "already_correct", target, link };
+    }
+    return { agentId, action: "conflict", target, link, conflict: `points_to:${currentTarget}` };
+  }
+  try {
+    symlinkSync(target, link);
+  } catch (err) {
+    return {
+      agentId,
+      action: "conflict",
+      target,
+      link,
+      conflict: err instanceof Error ? err.message : String(err)
+    };
+  }
+  return { agentId, action: "created", target, link };
+}
+async function ensureAllAgentSymlinks(homeDir = os.homedir()) {
+  const employees = await loadEmployees();
+  return employees.map((emp) => ensureAgentSymlink(emp.name, homeDir));
+}
+
+export {
+  ensureAgentSymlink,
+  ensureAllAgentSymlinks
+};