@askexenow/exe-os 0.9.364 → 0.9.367

package/dist/bin/deferred-daemon-restart.js

@@ -1,163 +1,167 @@
 #!/usr/bin/env node
 import {
   computeMcpSurfaceHash
-} from "../chunk-DNRLIHUO.js";
+} from "../chunk-WYVBWDFY.js";
 import "../chunk-WCGNCH3Q.js";
-import "../chunk-3NETEIM6.js";
-import "../chunk-UIUO3N5Y.js";
-import "../chunk-U6E3CLKI.js";
-import "../chunk-RKUGAHPO.js";
-import "../chunk-V3K6FLAS.js";
+import "../chunk-PS4NA7PM.js";
+import "../chunk-XA4EU3CW.js";
+import "../chunk-SFKIZYKK.js";
+import "../chunk-6NJURKRG.js";
+import "../chunk-TZFOWWPM.js";
 import "../chunk-5H47VHB7.js";
 import "../chunk-557C2IGL.js";
 import "../chunk-GSJLB6JI.js";
-import "../chunk-P7JLMFKX.js";
-import "../chunk-J2W3XZHV.js";
-import "../chunk-AYMOVFBG.js";
+import "../chunk-PFR6EOUY.js";
+import "../chunk-52CFP2AV.js";
+import "../chunk-PR3AHVFW.js";
+import "../chunk-XM7HJ5SS.js";
 import "../chunk-CRCB5S7I.js";
-import "../chunk-RSDCOZVM.js";
-import "../chunk-G4XMAGTW.js";
-import "../chunk-JCVDT3DG.js";
-import "../chunk-6NGFGT23.js";
-import "../chunk-AIVK4A5Y.js";
-import "../chunk-VNVDUM5X.js";
-import "../chunk-HVMZBCP4.js";
-import "../chunk-E6ORBQHP.js";
-import "../chunk-M2IZ3TQT.js";
-import "../chunk-EUEESRS6.js";
-import "../chunk-5M6LXPR4.js";
-import "../chunk-OFQBR26Y.js";
+import "../chunk-CWBFOAGM.js";
+import "../chunk-AEVE654G.js";
+import "../chunk-ALKYXAMB.js";
+import "../chunk-DXCTHNEF.js";
+import "../chunk-XAMLDTRA.js";
+import "../chunk-DAXFAXLN.js";
+import "../chunk-6CAX7YH4.js";
+import "../chunk-AAMGHW5W.js";
+import "../chunk-PHUHIVD5.js";
+import "../chunk-MQ3N4KZY.js";
+import "../chunk-WCDIDSLR.js";
+import "../chunk-P5XTVIEC.js";
+import "../chunk-KOYGRP2L.js";
 import "../chunk-X2X3IGZU.js";
-import "../chunk-JN7IFPIQ.js";
-import "../chunk-TF5T2ASS.js";
-import "../chunk-TPXBX2LD.js";
-import "../chunk-OZIDGXKH.js";
-import "../chunk-G6EUAI67.js";
+import "../chunk-ZZXMB5F2.js";
+import "../chunk-Z5Z3MYUW.js";
+import "../chunk-O3F5P6Z5.js";
+import "../chunk-PVEM537A.js";
+import "../chunk-H37FSTF2.js";
 import "../chunk-A6PDF4BO.js";
-import "../chunk-XOFIXD5U.js";
-import "../chunk-DSQCXCPS.js";
+import "../chunk-PFOJX6CR.js";
+import "../chunk-JOKKIFRN.js";
 import "../chunk-MPVXHYD5.js";
 import "../chunk-4LWBC7CM.js";
 import "../chunk-5OPAUFLP.js";
-import "../chunk-VVXXMY6I.js";
-import "../chunk-5WADTD5Y.js";
-import "../chunk-PX2OHZKN.js";
-import "../chunk-JWLZQSHW.js";
-import "../chunk-XE23TMKN.js";
-import "../chunk-XI2BLVH6.js";
-import "../chunk-AU7AVWTM.js";
-import "../chunk-4DJCHH5R.js";
-import "../chunk-YNR3DSAF.js";
-import "../chunk-PGJG5TCQ.js";
-import "../chunk-MR56CIB5.js";
-import "../chunk-FLK5IS6R.js";
-import "../chunk-6G6JGJD3.js";
-import "../chunk-Y4JCCHHJ.js";
-import "../chunk-6LNT6NCB.js";
+import "../chunk-PQ6NRLKL.js";
+import "../chunk-URHJDUWO.js";
+import "../chunk-PWCZFIQH.js";
+import "../chunk-K2OFS57E.js";
+import "../chunk-7W5LCREK.js";
+import "../chunk-OPS7KUFV.js";
+import "../chunk-66BFQOWR.js";
+import "../chunk-FSIAGX55.js";
+import "../chunk-DTTISDTI.js";
+import "../chunk-YA4PM3MV.js";
+import "../chunk-XUGOVOID.js";
+import "../chunk-OADOH45L.js";
+import "../chunk-GUOMZ3JM.js";
+import "../chunk-NPND34FS.js";
+import "../chunk-LW5WRSDD.js";
 import "../chunk-3OEVDGIY.js";
-import "../chunk-QY6B23U2.js";
-import "../chunk-B5T43JSQ.js";
+import "../chunk-2IZH6W73.js";
+import "../chunk-4DJDC4Y2.js";
+import "../chunk-GTOMDMJL.js";
 import "../chunk-EXDW3E2R.js";
-import "../chunk-LYXICKAH.js";
-import "../chunk-HEFM2DBN.js";
-import "../chunk-L3TB7CC3.js";
+import "../chunk-SBJV2PCU.js";
+import "../chunk-KM6XSFHP.js";
+import "../chunk-ZNUJFX7L.js";
 import "../chunk-YQGMSXT5.js";
-import "../chunk-6TF4ZOXP.js";
+import "../chunk-P76VYS6V.js";
 import "../chunk-SSC7EKY2.js";
-import "../chunk-MM45YT2B.js";
+import "../chunk-E5HAY3DQ.js";
 import "../chunk-75H4R62K.js";
-import "../chunk-P5OPYQZE.js";
+import "../chunk-JJRZE2LD.js";
 import "../chunk-MMRUBN3I.js";
 import "../chunk-2XZ6X3PJ.js";
-import "../chunk-TCTED52S.js";
-import "../chunk-K2HYCBAG.js";
-import "../chunk-CAV64C4J.js";
-import "../chunk-ZACPAM2C.js";
-import "../chunk-W352QOGG.js";
-import "../chunk-7WVR5UQF.js";
+import "../chunk-V3ISR2QT.js";
+import "../chunk-5CH6XKVC.js";
+import "../chunk-HHGOCBVQ.js";
+import "../chunk-JZBZI36P.js";
+import "../chunk-BTMX2D4X.js";
 import "../chunk-NEHOQ3P2.js";
-import "../chunk-GSWAKK5Q.js";
-import "../chunk-VFYF7EMB.js";
-import "../chunk-JQTM2UFN.js";
-import "../chunk-X73CND7J.js";
+import "../chunk-62U63R3E.js";
+import "../chunk-CW2UCKHS.js";
+import "../chunk-VV5EZZNT.js";
+import "../chunk-JTB5V6BV.js";
 import "../chunk-NUTZJZKW.js";
 import "../chunk-X2Z5GT3V.js";
-import "../chunk-6BDSDDKT.js";
-import "../chunk-5G46JZTE.js";
-import "../chunk-UPCXDJ2S.js";
-import "../chunk-X24VCGZA.js";
-import "../chunk-Y2DUIE6X.js";
+import "../chunk-4WOOCTON.js";
+import "../chunk-WBKIU6UJ.js";
+import "../chunk-VMJ2UH4S.js";
+import "../chunk-CYNL3ZFD.js";
+import "../chunk-53LCVVX5.js";
 import "../chunk-GUMRIUI5.js";
 import "../chunk-Z6BZQHP5.js";
 import "../chunk-VGMACSEV.js";
-import "../chunk-IANRPLHA.js";
-import "../chunk-J7EXACGN.js";
+import "../chunk-RLDMUSRM.js";
+import "../chunk-YYA5LXCT.js";
 import "../chunk-L2VZBPJJ.js";
 import "../chunk-QGGH7LOU.js";
 import "../chunk-VHJVD3MZ.js";
 import "../chunk-TWMWHDOY.js";
 import "../chunk-EEZOBN6X.js";
-import "../chunk-ZT5PSVWW.js";
+import "../chunk-AE3PYLLS.js";
 import "../chunk-VMHZSZQJ.js";
-import "../chunk-UCSD67VW.js";
-import "../chunk-ESOETGYC.js";
+import "../chunk-BQYQES2Z.js";
+import "../chunk-JLYHJJHU.js";
 import "../chunk-CHCA3ZM2.js";
 import "../chunk-OTVEIJUQ.js";
-import "../chunk-QKOLA6FI.js";
-import "../chunk-ASBMFQAY.js";
-import "../chunk-6ML32VHG.js";
-import "../chunk-CLCNYC3F.js";
-import "../chunk-YWFFAM2S.js";
+import "../chunk-WM7Y5ZV2.js";
+import "../chunk-ZZ3JQM5I.js";
+import "../chunk-OISZ2I4X.js";
+import "../chunk-BTFDA3UJ.js";
+import "../chunk-JFOZHVNO.js";
 import "../chunk-B6TI3TZT.js";
-import "../chunk-74H5NWLY.js";
-import "../chunk-GETICKB4.js";
-import "../chunk-UXX2JSZO.js";
+import "../chunk-ALYI3P5D.js";
+import "../chunk-QWDZNQXA.js";
+import "../chunk-2ADYTOHQ.js";
 import "../chunk-5MOYSU5A.js";
 import "../chunk-4QCFFW2H.js";
 import "../chunk-76CJBM36.js";
-import "../chunk-ZVZEYHWY.js";
-import "../chunk-HJQILEBL.js";
-import "../chunk-U4KDN5B7.js";
-import "../chunk-2HRAVECR.js";
+import "../chunk-QX33D4CH.js";
+import "../chunk-BTSWFMEH.js";
+import "../chunk-6MCUXRIP.js";
+import "../chunk-7W6FDHHY.js";
+import "../chunk-IIVFXD6P.js";
 import "../chunk-WT4RI36X.js";
-import "../chunk-HJVXKDEK.js";
+import "../chunk-CX4MVEM3.js";
 import "../chunk-KI5PFRG6.js";
 import "../chunk-EIKATSE4.js";
 import "../chunk-E23LNUWJ.js";
 import "../chunk-QAEWWYHL.js";
-import "../chunk-ZSQNPN2W.js";
+import "../chunk-XKFMNAJ7.js";
 import "../chunk-GBNB4EWD.js";
 import "../chunk-UXLO7VHX.js";
 import "../chunk-DSOQUQTV.js";
-import "../chunk-4FNUBXYO.js";
+import "../chunk-UI3K73LD.js";
 import "../chunk-AJIXH5JF.js";
-import "../chunk-2ROXEOGE.js";
+import "../chunk-XTWHNLGD.js";
 import "../chunk-AM7S2TY6.js";
-import "../chunk-34XAUB2R.js";
+import "../chunk-N3JLNMPF.js";
 import "../chunk-CVYC6DUW.js";
-import "../chunk-ECVWCFY4.js";
-import "../chunk-Z75FBAP2.js";
-import "../chunk-OPU3NYOO.js";
+import "../chunk-ZVTKWWLV.js";
+import "../chunk-CDUB5Q6J.js";
 import {
   requestDeployRestart
-} from "../chunk-FXPWMPU2.js";
-import "../chunk-CE323JHD.js";
+} from "../chunk-BNHAZ65R.js";
+import "../chunk-RIECV7SR.js";
+import "../chunk-LNOS24GV.js";
 import {
   computeDaemonHeapCapMb
 } from "../chunk-NLEW62VC.js";
+import "../chunk-W2IRQJ6R.js";
 import "../chunk-HYZV25LY.js";
 import "../chunk-GJV3WDWM.js";
 import "../chunk-GL57PO3K.js";
-import "../chunk-IY7LTYEP.js";
+import "../chunk-YNPOELAN.js";
 import "../chunk-ML4S5SHZ.js";
 import "../chunk-MP2AFCGL.js";
-import "../chunk-KAF66DIP.js";
+import "../chunk-HSBKV5LB.js";
 import "../chunk-TKDITWDN.js";
 import "../chunk-BBMTVAE3.js";
 import "../chunk-5YEUPUV4.js";
-import "../chunk-AUIXAFYX.js";
+import "../chunk-Y7OK5PJE.js";
 import "../chunk-YYB5PMTK.js";
-import "../chunk-BRZR76TS.js";
+import "../chunk-NJFJWQNN.js";
 import "../chunk-V3W3SATA.js";
 import "../chunk-JY5GAZYC.js";
 import "../chunk-FXU7JOXK.js";
@@ -165,14 +169,15 @@ import "../chunk-SO7KTH3Q.js";
 import "../chunk-HPXFKUGU.js";
 import "../chunk-WNBZJSQT.js";
 import "../chunk-F55P3H4S.js";
-import "../chunk-J2OTTJWG.js";
+import "../chunk-TCTED52S.js";
+import "../chunk-F3PIHVVY.js";
 import "../chunk-A7XLR3K7.js";
-import "../chunk-6WBEFNO4.js";
+import "../chunk-65ZSFW3O.js";
 import "../chunk-QILQ5FCG.js";
 import "../chunk-ARX6TAGN.js";
 import {
   resolveDataDir
-} from "../chunk-EKOWJXHN.js";
+} from "../chunk-QMSEL5YS.js";
 import "../chunk-HSGBZSCA.js";
 import "../chunk-6Y4B3QF6.js";
 import "../chunk-JKKZGDLP.js";

package/dist/bin/exe-agent-config.js

@@ -6,24 +6,24 @@ import {
   getAgentRuntime,
   loadAgentConfig,
   setAgentRuntime
-} from "../chunk-2ROXEOGE.js";
+} from "../chunk-XTWHNLGD.js";
 import "../chunk-AM7S2TY6.js";
 import {
   loadEmployeesSync
-} from "../chunk-KAF66DIP.js";
+} from "../chunk-HSBKV5LB.js";
 import "../chunk-TKDITWDN.js";
 import "../chunk-BBMTVAE3.js";
 import "../chunk-5YEUPUV4.js";
-import "../chunk-AUIXAFYX.js";
+import "../chunk-Y7OK5PJE.js";
 import "../chunk-YYB5PMTK.js";
-import "../chunk-BRZR76TS.js";
+import "../chunk-NJFJWQNN.js";
 import "../chunk-V3W3SATA.js";
 import "../chunk-JY5GAZYC.js";
 import "../chunk-FXU7JOXK.js";
 import {
   DEFAULT_RUNTIME
 } from "../chunk-WNBZJSQT.js";
-import "../chunk-EKOWJXHN.js";
+import "../chunk-QMSEL5YS.js";
 import "../chunk-HSGBZSCA.js";
 import "../chunk-JKKZGDLP.js";
 import "../chunk-MLKGABMK.js";

package/dist/bin/exe-agent.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import {
+  FileEditTool
+} from "../chunk-R4WMF32C.js";
+import {
+  BashTool
+} from "../chunk-TQDARPML.js";
 import {
   FileReadTool
 } from "../chunk-TMEE7AT7.js";
@@ -11,21 +17,15 @@ import {
 import {
   FileWriteTool
 } from "../chunk-XEKO37NM.js";
-import {
-  FileEditTool
-} from "../chunk-R4WMF32C.js";
-import {
-  BashTool
-} from "../chunk-TQDARPML.js";
 import {
   createTerminalRenderer,
   renderAgentEvents
 } from "../chunk-YZFZDJWZ.js";
-import "../chunk-NGVOA6ZQ.js";
 import "../chunk-CMCYL2JC.js";
+import "../chunk-NGVOA6ZQ.js";
 import {
   agentLoop
-} from "../chunk-KSVLBATT.js";
+} from "../chunk-E5QQZDQN.js";
 import {
   ToolRegistry
 } from "../chunk-JRLNE3T2.js";
@@ -45,29 +45,206 @@ import {
 } from "../chunk-ECGTESAP.js";
 import {
   getSessionPrompt
-} from "../chunk-K2HYCBAG.js";
-import "../chunk-CAV64C4J.js";
-import "../chunk-ZACPAM2C.js";
-import "../chunk-KAF66DIP.js";
+} from "../chunk-V3ISR2QT.js";
+import "../chunk-5CH6XKVC.js";
+import "../chunk-HHGOCBVQ.js";
+import "../chunk-HSBKV5LB.js";
 import "../chunk-TKDITWDN.js";
 import "../chunk-BBMTVAE3.js";
 import "../chunk-5YEUPUV4.js";
-import "../chunk-AUIXAFYX.js";
+import "../chunk-Y7OK5PJE.js";
 import "../chunk-YYB5PMTK.js";
-import "../chunk-BRZR76TS.js";
+import "../chunk-NJFJWQNN.js";
 import "../chunk-V3W3SATA.js";
 import "../chunk-JY5GAZYC.js";
 import "../chunk-FXU7JOXK.js";
-import "../chunk-EKOWJXHN.js";
+import "../chunk-QMSEL5YS.js";
 import "../chunk-HSGBZSCA.js";
 import "../chunk-JKKZGDLP.js";
 import "../chunk-MLKGABMK.js";
 
 // src/bin/exe-agent.ts
 import { createInterface } from "readline";
-import { existsSync, readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { existsSync, readFileSync, realpathSync } from "fs";
 import path from "path";
 import os from "os";
+
+// src/runtime/tools/mcp.ts
+import { z } from "zod";
+import { spawn } from "child_process";
+var READ_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "ask_team_memory",
+  "recall_my_memory",
+  "list_tasks",
+  "get_session_context",
+  "get_memory_by_id",
+  "list_reminders"
+]);
+var McpToolWrapper = class {
+  name;
+  description;
+  inputSchema;
+  isReadOnly;
+  client;
+  constructor(name, description, jsonSchema, client) {
+    this.name = name;
+    this.description = description;
+    this.inputSchema = z.record(z.string(), z.unknown());
+    this.isReadOnly = READ_TOOL_NAMES.has(name);
+    this.client = client;
+    this._jsonSchema = jsonSchema;
+  }
+  async call(input, _context) {
+    try {
+      const result = await this.client.callTool(this.name, input);
+      return { content: typeof result === "string" ? result : JSON.stringify(result, null, 2) };
+    } catch (err) {
+      return {
+        content: `MCP tool error: ${err instanceof Error ? err.message : String(err)}`,
+        isError: true
+      };
+    }
+  }
+};
+var DEFAULT_MCP_REQUEST_TIMEOUT_MS = 15e3;
+var McpStdioClient = class {
+  constructor(command, args = [], options = {}) {
+    this.command = command;
+    this.args = args;
+    this.requestTimeoutMs = Math.max(1, options.requestTimeoutMs ?? DEFAULT_MCP_REQUEST_TIMEOUT_MS);
+  }
+  command;
+  args;
+  child = null;
+  requestId = 0;
+  pending = /* @__PURE__ */ new Map();
+  buffer = "";
+  MAX_BUFFER = 1e7;
+  // 10MB cap
+  requestTimeoutMs;
+  async connect() {
+    this.child = spawn(this.command, this.args, {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    this.child.stdout.on("data", (chunk) => {
+      this.buffer += chunk.toString("utf-8");
+      if (this.buffer.length > this.MAX_BUFFER) {
+        this.buffer = "";
+        return;
+      }
+      this.processBuffer();
+    });
+    this.child.on("error", (err) => {
+      this.rejectAllPending(err);
+    });
+    this.child.on("exit", (code, signal) => {
+      this.rejectAllPending(
+        new Error(`MCP server exited before responding (code=${code ?? "null"}, signal=${signal ?? "null"})`)
+      );
+    });
+    await this.request("initialize", {
+      protocolVersion: "2024-11-05",
+      capabilities: {},
+      clientInfo: { name: "exe-agent", version: "1.0.0" }
+    });
+    this.notify("notifications/initialized", {});
+  }
+  async listTools() {
+    const result = await this.request("tools/list", {});
+    return result.tools.map((t) => ({
+      name: t.name,
+      description: t.description ?? "",
+      inputSchema: t.inputSchema ?? {}
+    }));
+  }
+  async callTool(name, args) {
+    const result = await this.request("tools/call", {
+      name,
+      arguments: args
+    });
+    if (result.content && result.content.length > 0) {
+      return result.content.map((c) => c.text ?? "").join("\n");
+    }
+    return result;
+  }
+  async close() {
+    if (this.child) {
+      this.child.kill("SIGTERM");
+      this.child = null;
+    }
+    this.rejectAllPending(new Error("MCP client closed"));
+  }
+  request(method, params) {
+    return new Promise((resolve, reject) => {
+      if (!this.child?.stdin?.writable) {
+        reject(new Error("MCP client not connected"));
+        return;
+      }
+      const id = ++this.requestId;
+      const timer = setTimeout(() => {
+        this.pending.delete(id);
+        reject(new Error(`MCP request timed out after ${this.requestTimeoutMs}ms (${method})`));
+      }, this.requestTimeoutMs);
+      timer.unref?.();
+      this.pending.set(id, { resolve, reject, timer });
+      const msg = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+      this.child.stdin.write(msg + "\n", (err) => {
+        if (!err) return;
+        const pending = this.pending.get(id);
+        if (pending) {
+          clearTimeout(pending.timer);
+          this.pending.delete(id);
+        }
+        reject(err);
+      });
+    });
+  }
+  rejectAllPending(err) {
+    for (const [, p] of this.pending) {
+      clearTimeout(p.timer);
+      p.reject(err);
+    }
+    this.pending.clear();
+  }
+  notify(method, params) {
+    if (!this.child?.stdin?.writable) return;
+    const msg = JSON.stringify({ jsonrpc: "2.0", method, params });
+    this.child.stdin.write(msg + "\n");
+  }
+  processBuffer() {
+    const lines = this.buffer.split("\n");
+    this.buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      if (!line.trim()) continue;
+      try {
+        const msg = JSON.parse(line);
+        if (msg.id != null && this.pending.has(msg.id)) {
+          const p = this.pending.get(msg.id);
+          this.pending.delete(msg.id);
+          clearTimeout(p.timer);
+          if (msg.error) {
+            p.reject(new Error(msg.error.message));
+          } else {
+            p.resolve(msg.result);
+          }
+        }
+      } catch {
+      }
+    }
+  }
+};
+async function createMcpTools(serverCommand, serverArgs = []) {
+  const client = new McpStdioClient(serverCommand, serverArgs);
+  await client.connect();
+  const mcpTools = await client.listTools();
+  const tools = mcpTools.map(
+    (t) => new McpToolWrapper(t.name, t.description, t.inputSchema, client)
+  );
+  return { tools, client };
+}
+
+// src/bin/exe-agent.ts
 function parseArgs(argv) {
   const args = { employee: "" };
   for (let i = 2; i < argv.length; i++) {
@@ -131,6 +308,43 @@ function registerBuiltinTools(registry) {
   registry.register(GlobTool);
   registry.register(GrepTool);
 }
+function resolveMcpServerCommand(env = process.env, proxyPath = fileURLToPath(new URL("./exe-os-mcp-proxy.js", import.meta.url)), execPath = process.execPath) {
+  if (env.EXE_AGENT_MCP === "0" || env.EXE_AGENT_MCP === "false") return null;
+  const override = env.EXE_AGENT_MCP_COMMAND?.trim();
+  if (override) {
+    const parts = override.split(/\s+/).filter(Boolean);
+    return { command: parts[0], args: parts.slice(1) };
+  }
+  return { command: execPath, args: [proxyPath] };
+}
+async function registerMcpTools(registry, connect = createMcpTools, env = process.env) {
+  const server = resolveMcpServerCommand(env);
+  if (!server) {
+    console.error("[exe-agent] MCP disabled (EXE_AGENT_MCP=0) \u2014 builtin tools only.");
+    return null;
+  }
+  try {
+    const { tools, client } = await connect(server.command, server.args);
+    const builtins = new Set(registry.names());
+    let registered = 0;
+    for (const tool of tools) {
+      if (builtins.has(tool.name)) {
+        console.error(`[exe-agent] Skipping MCP tool "${tool.name}" \u2014 name collides with a builtin.`);
+        continue;
+      }
+      registry.register(tool);
+      registered++;
+    }
+    console.error(`[exe-agent] MCP connected \u2014 ${registered} tool(s) registered.`);
+    return client;
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    console.error(
+      `[exe-agent] MCP unavailable (${reason}) \u2014 continuing with builtin tools only. Memory, tasks and wiki will NOT be reachable this session.`
+    );
+    return null;
+  }
+}
 async function main() {
   const args = parseArgs(process.argv);
   if (!args.employee) {
@@ -146,10 +360,15 @@ async function main() {
   const model = args.model ?? provider.defaultModel ?? "claude-sonnet-4-20250514";
   const registry = new ToolRegistry();
   registerBuiltinTools(registry);
+  const mcpClient = await registerMcpTools(registry);
   const abortController = new AbortController();
   const shutdown = () => {
     process.stderr.write("\n[exe-agent] Shutting down...\n");
     abortController.abort();
+    try {
+      mcpClient?.close();
+    } catch {
+    }
   };
   process.on("SIGINT", shutdown);
   process.on("SIGTERM", shutdown);
@@ -188,11 +407,30 @@ async function main() {
     rl.prompt();
   });
   rl.on("close", () => {
+    try {
+      mcpClient?.close();
+    } catch {
+    }
     console.error("[exe-agent] Session ended.");
     process.exit(0);
   });
 }
-main().catch((err) => {
-  console.error(`[exe-agent] Fatal: ${err instanceof Error ? err.message : String(err)}`);
-  process.exit(1);
-});
+function isDirectRun(entry = process.argv[1], selfUrl = import.meta.url) {
+  if (!entry) return false;
+  try {
+    return realpathSync(entry) === realpathSync(fileURLToPath(selfUrl));
+  } catch {
+    return false;
+  }
+}
+if (isDirectRun()) {
+  main().catch((err) => {
+    console.error(`[exe-agent] Fatal: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  });
+}
+export {
+  isDirectRun,
+  registerMcpTools,
+  resolveMcpServerCommand
+};