arisa 5.1.24 → 5.1.49

package/src/core/tools/tool-registry.js

@@ -16,17 +16,53 @@ function toolEnv() {
   return { ...process.env, ARISA_PACKAGE_DIR: arisaPackageDir, ARISA_IPC_SOCKET: arisaIpcSocketFile };
 }
 
-function runProcess(command, args, options = {}) {
-  return new Promise((resolve) => {
-    const child = spawn(command, args, { ...options, stdio: ["ignore", "pipe", "pipe"] });
-    let stdout = "";
-    let stderr = "";
-    child.stdout.on("data", (d) => { stdout += d.toString(); });
-    child.stderr.on("data", (d) => { stderr += d.toString(); });
-    child.on("close", (code) => resolve({ code, stdout, stderr }));
+const defaultToolHelpTimeoutMs = 10_000;
+const defaultToolRunTimeoutMs = 30 * 60_000;
+const defaultToolKillGraceMs = 2_000;
+
+function positiveDuration(value, fallback) {
+  return Number.isFinite(value) && value > 0 ? value : fallback;
+}
+
+function waitForToolProcess(child, { timeoutMs, killGraceMs, label }) {
+  return new Promise((resolve, reject) => {
+    let timedOut = false;
+    let forceTimer = null;
+    const timeout = setTimeout(() => {
+      timedOut = true;
+      child.kill("SIGTERM");
+      forceTimer = setTimeout(() => child.kill("SIGKILL"), killGraceMs);
+    }, timeoutMs);
+
+    const finish = (callback, value) => {
+      clearTimeout(timeout);
+      clearTimeout(forceTimer);
+      callback(value);
+    };
+
+    child.once("error", (error) => finish(reject, error));
+    child.once("close", (code) => {
+      if (!timedOut) {
+        finish(resolve, code);
+        return;
+      }
+      const error = new Error(`${label} timed out after ${timeoutMs}ms`);
+      error.code = "TOOL_PROCESS_TIMEOUT";
+      finish(reject, error);
+    });
   });
 }
 
+async function runProcess(command, args, { timeoutMs, killGraceMs, label, ...options } = {}) {
+  const child = spawn(command, args, { ...options, stdio: ["ignore", "pipe", "pipe"] });
+  let stdout = "";
+  let stderr = "";
+  child.stdout.on("data", (d) => { stdout += d.toString(); });
+  child.stderr.on("data", (d) => { stderr += d.toString(); });
+  const code = await waitForToolProcess(child, { timeoutMs, killGraceMs, label });
+  return { code, stdout, stderr };
+}
+
 function requirementNames(requirements) {
   if (Array.isArray(requirements)) {
     return requirements.map((item) => typeof item === "string" ? item : item?.name).filter(Boolean);
@@ -121,7 +157,7 @@ export function createToolOutputParser(name, { onEvent, maxFrameBytes = 1_048_57
   };
 }
 
-async function runToolProcess(command, args, { onEvent, maxFrameBytes, ...options } = {}) {
+async function runToolProcess(command, args, { onEvent, maxFrameBytes, timeoutMs, killGraceMs, label, ...options } = {}) {
   const child = spawn(command, args, { ...options, stdio: ["ignore", "pipe", "pipe"] });
   const parser = createToolOutputParser(path.basename(args[0] || command), { onEvent, maxFrameBytes });
   const stderrChunks = [];
@@ -139,13 +175,15 @@ async function runToolProcess(command, args, { onEvent, maxFrameBytes, ...option
     }
     return Buffer.concat(stderrChunks).toString("utf8");
   })();
-  const exitPromise = new Promise((resolve, reject) => {
-    child.once("error", reject);
-    child.once("close", resolve);
-  });
   child.stdout.resume();
   child.stderr.resume();
-  const code = await exitPromise;
+  let code;
+  try {
+    code = await waitForToolProcess(child, { timeoutMs, killGraceMs, label });
+  } catch (error) {
+    await Promise.allSettled([stdoutTask, stderrTask]);
+    throw error;
+  }
   const [parsed, stderr] = await Promise.all([stdoutTask, stderrTask]);
   return { code, parsed, stderr };
 }
@@ -228,17 +266,26 @@ async function readOfficialToolNames() {
 }
 
 export class ToolRegistry {
-  constructor({ logger, usageStore = new ToolUsageStore(), resolveOfficialToolNames = readOfficialToolNames } = {}) {
+  constructor({
+    logger,
+    usageStore = new ToolUsageStore(),
+    resolveOfficialToolNames = readOfficialToolNames,
+    helpTimeoutMs = defaultToolHelpTimeoutMs,
+    runTimeoutMs = defaultToolRunTimeoutMs,
+    killGraceMs = defaultToolKillGraceMs
+  } = {}) {
     this.logger = logger;
+    this.helpTimeoutMs = positiveDuration(helpTimeoutMs, defaultToolHelpTimeoutMs);
+    this.runTimeoutMs = positiveDuration(runTimeoutMs, defaultToolRunTimeoutMs);
+    this.killGraceMs = positiveDuration(killGraceMs, defaultToolKillGraceMs);
     this.tools = new Map();
     this.skillRegistry = new SkillRegistry();
     this.usageStore = usageStore;
     this.resolveOfficialToolNames = resolveOfficialToolNames;
   }
 
-  async load() {
-    this.tools.clear();
-
+  async buildSnapshot() {
+    const snapshot = new Map();
     let entries = [];
     try {
       entries = await readdir(userToolsRoot, { withFileTypes: true });
@@ -253,12 +300,12 @@ export class ToolRegistry {
       const configPath = path.join(toolDir, "config.js");
       try {
         const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
-        if (this.tools.has(manifest.name)) continue;
+        if (snapshot.has(manifest.name)) continue;
         const configSource = await readFile(configPath, "utf8");
         const defaults = parseConfigModule(configSource);
         const config = await loadToolConfig(manifest.name, defaults);
         const skillHints = this.skillRegistry.normalizeHints(manifest);
-        this.tools.set(manifest.name, {
+        snapshot.set(manifest.name, {
           ...manifest,
           toolDependencies: normalizeToolDependencies(manifest.toolDependencies),
           category: normalizeCategory(manifest.category),
@@ -275,8 +322,13 @@ export class ToolRegistry {
         // ignore invalid tool dirs in v1
       }
     }
+    return snapshot;
+  }
 
-    this.logger?.log("tools", `loaded ${this.tools.size} tool(s)`);
+  async load() {
+    const snapshot = await this.buildSnapshot();
+    this.tools = snapshot;
+    this.logger?.log("tools", `loaded ${snapshot.size} tool(s)`);
   }
 
   list() {
@@ -333,7 +385,13 @@ export class ToolRegistry {
   async help(name) {
     const tool = this.get(name);
     if (!tool) throw new Error(`Tool not found: ${name}`);
-    const result = await runProcess("node", [tool.entry, "--help"], { cwd: tool.dir, env: toolEnv() });
+    const result = await runProcess("node", [tool.entry, "--help"], {
+      cwd: tool.dir,
+      env: toolEnv(),
+      timeoutMs: this.helpTimeoutMs,
+      killGraceMs: this.killGraceMs,
+      label: `Tool help for ${name}`
+    });
     const help = result.stdout || result.stderr;
     const skills = await this.resolveSkills(name);
     const sections = [
@@ -443,7 +501,10 @@ export class ToolRegistry {
           cwd: tool.dir,
           env: toolEnv(),
           onEvent,
-          maxFrameBytes: daemonConfigDefaults.ipcFrameBytes
+          maxFrameBytes: daemonConfigDefaults.ipcFrameBytes,
+          timeoutMs: this.runTimeoutMs,
+          killGraceMs: this.killGraceMs,
+          label: `Tool run for ${name}`
         });
         if (processResult.stderr.trim()) {
           this.logger?.log("tools", `${name} stderr: ${processResult.stderr.trim()}`);
@@ -460,6 +521,18 @@ export class ToolRegistry {
       }
       return normalized;
     } catch (error) {
+      if (error?.code === "TOOL_PROCESS_TIMEOUT") {
+        return normalizeToolResult(name, {
+          ok: false,
+          status: "outcome_uncertain",
+          error: error.message,
+          resolution: {
+            type: "status_check_required",
+            retry: false,
+            message: "The tool process was terminated after timing out. Check external state before retrying."
+          }
+        });
+      }
       return normalizeToolResult(name, {
         ok: false,
         error: error?.message || `Invalid tool response for ${name}`

package/src/official-tools.lock.json

@@ -1,8 +1,100 @@
 {
   "version": 1,
   "repository": "https://github.com/clasen/Arisa.git",
-  "commit": "eff37798c546e33cc4386c878ee01baa5dbd701c",
+  "commit": "aaec12e4f63f4959462b26380e7d4c1a60562586",
   "tools": {
+    "browser-session-bridge": {
+      "version": "0.1.0",
+      "files": {
+        "bridge-server.js": "87f5a392bc99fd97899836c0731b4694402b04d5dfbe88e66bb4f496bfef351d",
+        "chrome-web-store.js": "a6bd9553f1490d5ccda3fe3044c30ee6fe243f422e69a5000bc844884e6d1e95",
+        "config.js": "45c8e9e9a159b9125d6ea3458c616926c2ba2b5327fdfd750aa05316d3ce5af8",
+        "extension/icons/icon-128.png": "a55af49bb570bd5471fc0a2e15a6bcaf3f76a2c5e7439f16bb1829682b343380",
+        "extension/icons/icon-16.png": "a4aedb49e2227222a68dc56455812a9e17938fd197b1f30268f02d6c9f7bf95e",
+        "extension/icons/icon-32.png": "2dfc9e6e7ec6b4e9feb9c1326d65116cda8e53306c65c84074c818c9e7f6a2a2",
+        "extension/icons/icon-48.png": "2f316f1f2fbc72227e7e1f14cf1ff1553a12fc9aab139799f1ee2970c0303deb",
+        "extension/manifest.json": "3e19d7b1c2a9521745b585fbbb3a6f4639d3056703fdbca17e8cd6dd80fc4c91",
+        "extension/popup.css": "138811e3e96e9c7741f064f8cf017be75973cd0942efa9668e96a584b7b52c1c",
+        "extension/popup.html": "9d7798efd04c57c534840a7966dd3818f9264022c52390f0fd1d462236a01d60",
+        "extension/popup.js": "60ea83f17e5d87f072d27c6540b903361f70e03925c3727983cca6beba9696d3",
+        "index.js": "4c92afffaec61910e3522f483535c760e8c660604158a23628d2807daa024934",
+        "package-lock.json": "e1081b8b48c2eaaeca73c63e64902519b33e8822ce351a45afe8509224776c12",
+        "package.json": "b54fad02442d9d09fb42d6c1fa01bb2e441e946babdf73dbc7e5767002a07b28",
+        "README.md": "fc2848472b48627838b757bf1a7be9564f31e483e8b673bd4ae95a11016f3309",
+        "session-browser.js": "d5544db5c6712327e76b8436cfabe02e34d8e043ff2d251c2c5ff3f00f1a9dd7",
+        "session-store.js": "56b33e1a342ba148cb4443e03435e5c728db60903ecd0ae87c05fbff3ca881ab",
+        "test/device-enrollment.test.js": "3dd36d37044eaf1043bd8b2e9f10ead9dc87479152a07237ab87d50146782f4c",
+        "test/session-refresh.test.js": "8f5facb81444f0d09928d48f22e82112d47bde21927afcd7fd830ce6832b9f79",
+        "tool.manifest.json": "40326de8bc08f2fd51ce51d4a20637b9af37de588d6cb97d27bc0b0d16304095",
+        "web-store/listing.md": "914e7c38bc67e19f3afbea86288c0cbc49afcb8941f4734fd3f786c5533861e7",
+        "web-store/privacy-policy.md": "c96e84f1a112e5949a3e7bd952fcf5ec794eaa5c4bee14a1dbe0c8e0f5888fb7"
+      }
+    },
+    "campaign-draft-runner": {
+      "version": "0.3.3",
+      "toolDependencies": {
+        "pr-campaign": "^0.1.0",
+        "gmail-workspace": "^0.1.0"
+      },
+      "files": {
+        "README.md": "fb73d47f6825a1c9b419f6667a319c2cbd959dc7b56c488321db72a6e2210a41",
+        "config.js": "23b95ad1851e498310eb400b1d53c648c280ddcc73cf91f6fa0ae5dc470ae6d2",
+        "index.js": "28d58096adb76e00d74b23ef10816199a5af57e13866ed6ab829da2535d73890",
+        "operation-timeout.js": "9b1ced30ec9ed710bb9118b91f6f3feded5111a08e1e21abf163e4cfb91d7ad2",
+        "package.json": "a25b7ed1dd2c30cd68c3c10feb8ee1752cac8cd55cd4344690ffad649e231ec1",
+        "product-facts.js": "69339e20e7b70a6b9833878d72b10b70ea4ede4aa448097975d0961b6aaced59",
+        "search-quality.js": "ab5412d45d5144e976cccef52992e634c11aca0e21b73fd53f9dc2d489c56dd7",
+        "source-exhaustion.js": "407f940f5205eb01715a797672d0dad8bd0b0b897024b5fcb87052a062ecd054",
+        "telemetry.js": "bab44341ae2176c8a29eed19b89db4e7e251c9938af163ecd85293917d94bfb5",
+        "test/selection-policy.test.js": "27dacdc6ac3b1c570229ef624267c5bf7e4b9606dbb71214c2a451a30ac3762b",
+        "test/telemetry.test.js": "e297727e382163f18ab0ec4a21f55bf7e47790939510b615fd8e38c4dfc1998f",
+        "tool.manifest.json": "1eacb9ccdf0b37bba9745ba20ce3462548bac28c7abb15214e5502e7e53d3e0d"
+      }
+    },
+    "creator-scout": {
+      "version": "1.0.1",
+      "files": {
+        "README.md": "4f50850317c0875ad7ddea767c7dda112669112bec107a98e67a31a42787b82c",
+        "config.js": "bab728665650b986c0eaef8e1be1c259ec42b1f83df4217c9780f5468d3c7666",
+        "index.js": "d1266d622b6abaf77ce1fe93823d4f2faedb8a5991371997c364082a198dc728",
+        "package-lock.json": "ed479120b59c2d9b083991dea60eb7750ba36bc7b2c7defb01cfb598889b8d90",
+        "package.json": "ad463eeddea6a958ef291d58f216c0b42c5ff3b398b62ed9512b857ea5e4b672",
+        "reference-match.js": "762d822ad31f89c06cb5a40f84ba3f864436db486375ed30e48bde94de282c7c",
+        "test/reference-match.test.js": "701ce83396126b1e42bd3a54e331ff011a1fc27646a0f3aa99ce1c3e576aff6d",
+        "tool.manifest.json": "0617b0488035fd7f8a83a8e5a698558b3d0e956e7ea1e043e2e80bb224d4974f"
+      }
+    },
+    "gmail-workspace": {
+      "version": "0.1.1",
+      "files": {
+        "config.js": "6ad295ec4cedbc936835d8f86c7528e0939ef09d5792c003308d2ee85dc5eea4",
+        "index.js": "c4b1c27a3c5d2309501b695058da73f6287e2a6239f6e2384c05daae8ee25d43",
+        "package.json": "ba87edd5a148da9e99af6b3ab71a0024b86e1a469d56f548c7eeb253bb431f5d",
+        "secretary-state.js": "afc27732670420bccf1ce56ce715676dd2266de9f2d36a92015a93842755094a",
+        "test/secretary-state.test.mjs": "3aea05524a4ad5ebcb79c6aa1db94fcd009ac8ae69414c8f950b32a32af94370",
+        "tool.manifest.json": "2860c5684b9b9532ab4675f5cc5b96238320209086b132a5eda74ba99b6c294a"
+      }
+    },
+    "magnific-mcp": {
+      "version": "0.1.1",
+      "toolDependencies": {
+        "mcp-client": "^0.1.0"
+      },
+      "files": {
+        "README.md": "519b68d10c80112f475ab173394e937b0fc5930758415c1fc65ea2f5536b6371",
+        "config.js": "98a629781a1b2541806050952aa78a1e6e1b1671a6f1df7ba36c70dd116936a7",
+        "delivery-claims.js": "52f05a5bd1ece1ab21f7d9a49f362f9c55f101ef5723efd642dbecf0236921cd",
+        "generation-watch-close.js": "0dd780280eef870d2f11cb1800e6e9de19e5ead7b9d02b9983852cc8ddbdc79b",
+        "generation-watch-plan.js": "eb60660341f254adc224181ca19dbbb969ef1d676aeaab60b71a8567f52648fe",
+        "index.js": "0dcbd84ad03ab59919df57081d34a45c3a8d59b3c37ac31249409210ae7107e6",
+        "magnific-api.js": "39fa9a122577029111965c3e8487565c88ce46b61dec5ca685acf1c76cd3b636",
+        "network.js": "b45e43b49eea98ca7d80921ebfa6daf8b0a85d2079d4653f9eda682bc82101ae",
+        "package.json": "9c44eb43a3555cf79bd327318f9a30d3060f22dd2fd534923e303cca1eed7de9",
+        "state-store.js": "c3ee744509f7a6be251cd895406bd1c70827f53cbdc1ac9d1c2a6e48479bfe1e",
+        "test/magnific-mcp.test.js": "7a61dd19a2f6f9f48213cabf0de6e87e0b6fb73a94f0ea9dbfe9c8568c2cc32d",
+        "tool.manifest.json": "ff886d95250d279eff097430e6f89405a2bdd488d5f0949277cbc3f57f918950"
+      }
+    },
     "master-slave": {
       "files": {
         "README.md": "84d2841d8df31c07065d4fee6e434dc43cad241f3abf63e95efafad51ed69fcb",
@@ -53,38 +145,19 @@
         "tool.manifest.json": "5659c398922c914c5bf893404519a30071ee685ab49f34a650ecafd585b4d6ec"
       }
     },
-    "magnific-mcp": {
-      "version": "0.1.0",
-      "toolDependencies": {
-        "mcp-client": "^0.1.0"
-      },
-      "files": {
-        "README.md": "00342fc9ae98f38716aeb332941524336c0e9ee4a5020104e52e7ed7b61882f9",
-        "config.js": "98a629781a1b2541806050952aa78a1e6e1b1671a6f1df7ba36c70dd116936a7",
-        "delivery-claims.js": "52f05a5bd1ece1ab21f7d9a49f362f9c55f101ef5723efd642dbecf0236921cd",
-        "generation-watch-plan.js": "eb60660341f254adc224181ca19dbbb969ef1d676aeaab60b71a8567f52648fe",
-        "index.js": "da7d35f2685fa0d5e716073f20725d7a5a4a0c477a1982b106a314662641b989",
-        "magnific-api.js": "39fa9a122577029111965c3e8487565c88ce46b61dec5ca685acf1c76cd3b636",
-        "network.js": "b45e43b49eea98ca7d80921ebfa6daf8b0a85d2079d4653f9eda682bc82101ae",
-        "package.json": "10ded9e89c13b500208717610984fd837e67e82ac3b31b21fe0058bd53c22a96",
-        "state-store.js": "c3ee744509f7a6be251cd895406bd1c70827f53cbdc1ac9d1c2a6e48479bfe1e",
-        "test/magnific-mcp.test.js": "c6345e70a7834a22df49abaf648c781f4da2e4d0790cbc13035c8af433c814c5",
-        "tool.manifest.json": "bbb24f54814c67f1ca1e119e6767e59d48f8e0cbc7f92444cf8e22fcc2fe06ed"
-      }
-    },
-    "campaign-draft-runner": {
-      "version": "0.1.0",
+    "official-tool-sync": {
+      "version": "1.0.0",
       "toolDependencies": {
-        "pr-campaign": "^0.1.0",
-        "gmail-workspace": "^0.1.0"
+        "trash": "^1.0.0"
       },
       "files": {
-        "README.md": "4e97db605c55c31c5fdb3ad83973f7733cef7a689b71b6d014fe07df631a4f99",
-        "config.js": "3c0c252baa7170e0bf0a9d1a7ecdb4febcf19f7baf0fcd320c0b852008f41b63",
-        "index.js": "0fd4574c70e7d008714f17eb54ccc34bc703a1fee7ab7eae768d79f86d2e747c",
-        "package.json": "a25b7ed1dd2c30cd68c3c10feb8ee1752cac8cd55cd4344690ffad649e231ec1",
-        "test/selection-policy.test.js": "b1bc804ba2be210230e78d7e4cfa5469e07e75c6ee944f58d77e6d00e88561cd",
-        "tool.manifest.json": "2609869985fd78000c999a9ae03f4b251c0aa945d19eed97e630f70da97c72ce"
+        ".gitignore": "4d56952b0fb13bf8f9b6c13a6d4c34a075bac3af447636a1df4335d7576e2f97",
+        "config.js": "744c445b1d2ff65b77f38a5473c24e50a32f4288c4a08c25a874a478086c08c8",
+        "index.js": "fdd4167c63cd33c8e7640cb7ce09fd618dbd416030aa920407392e4591543e94",
+        "package.json": "4447cb5d4e0a04526604dfb9820c44af88349c27e208f27baa148686846559da",
+        "sync-lib.js": "c9f2cd7e19370088ab5fd10f6b2ada52c07d2e405674a356d0989f9a0f4984f6",
+        "sync-lib.test.js": "c97cf850d9f42f6b121a458863b048bdcaa6d7d0475642f20742c5862ebf7cc4",
+        "tool.manifest.json": "8e0f94ad786bdaf9edb1a65cd03438e26c1e9927e8db9a5a39e349e7ef3c6cd3"
       }
     },
     "pr-campaign": {
@@ -99,15 +172,44 @@
         "tool.manifest.json": "9c68d89276996039b055c43b4b4f82499ea684edbb36d9bfedcc909a3a23a80f"
       }
     },
-    "gmail-workspace": {
+    "process-retrospective": {
+      "version": "1.1.0",
+      "files": {
+        "README.md": "798c5c34893dccabe2101be91581b1845359fb57744efcc56a2b5beb83712c15",
+        "config.js": "30703e809f0a2c4b85ffb1e1f9cd7ee599224e9bc62c3bc19e71e271cbc72b5d",
+        "index.js": "9bd1ae078293211387ee3035b4c4dc7cc5852d08503cd55cf5fb3187cf1ace34",
+        "package.json": "491b490a8c7f5db0fef1202f5d3059f1cc2dd75a84c6668f9fd2f5c81c1a4240",
+        "reflection-plan.js": "6c7e088385d39d2e3ba4f74c2d6dd94194e6a506f4ac263e552d34d9c2335488",
+        "state-store.js": "6d0d39bff7e5e16558123c088eb8946bf3758596ae974598936b94424618c7cf",
+        "test/reflection-plan.test.js": "d7c5953b5c5ba6fed4c403d64affce3f2b70b7975c1f28edcd1b902651fbe727",
+        "tool.manifest.json": "33440c26660f74dc381c4b4cc5f8487f4764693a352d37ae7ae2ef67e669754f"
+      }
+    },
+    "telemetry-ledger": {
       "version": "0.1.0",
       "files": {
-        "config.js": "6ad295ec4cedbc936835d8f86c7528e0939ef09d5792c003308d2ee85dc5eea4",
-        "index.js": "495b5cec129a71638ab9b2682cf575eb8659e9a100b2e70deb0c523e60b69886",
-        "package.json": "1e88d42180a8dacd08c7ad1aa84d783991f901bb3bca7f0dddc4efd919470bdc",
-        "secretary-state.js": "0c4ef04db0d990a92b4b49ef62135baea76b7e4d5c232dfbf2087c61d1ce1948",
-        "test/secretary-state.test.mjs": "d8e866400853b39dc26e4b4ec09880c3cb1dd0b0091b2d25097388adf38559e7",
-        "tool.manifest.json": "93583b8c3a5f417435e3b3e88b129d2c610f2f168788e510f4cb2c03d4aef3a4"
+        "README.md": "4cf1b8c7addaa0f6a2d802a7ae261293822c2662efac9c10afa844f9fbcf4e1d",
+        "analysis.js": "c0effbff3af519b018e59c0460d2c277b4f7e1422ca2680de217bcb5e8a13136",
+        "config.js": "ddc8543cde5aeda634b8df60628d0024bb03e65b8710cf4878b4c6a7d953a641",
+        "index.js": "7df14d142a70b725b32ee40741ce1007fd96a080f96a9b2e3e34d917d88621b5",
+        "package.json": "e662652038c1c5a6a2a4502b308ae89e1acbd3cb6d3fc494512a730ebe9ccb8a",
+        "stats.js": "fc41b065d1f280dc278c53dc4c4baaa385a5bf25416c3e4ff8a153ea624967fb",
+        "storage.js": "099187e270ccc2bd6d7300b78a2ee31a837f98694a23a3b40b20a646cdb1db1e",
+        "test/telemetry.test.js": "312eef22ad960b19a6fe777aecd520952ae20ed03168edbbef8a0f747bee01c0",
+        "tool.manifest.json": "e4b321a56db9030e5b39b764547769c76bcf282ed019ebba0323bf16a73dbe05",
+        "validation.js": "1a50c75a5ca1bb7249bb8bfc3f2927b31ff4accd0efb56a48c36df5adae78f61"
+      }
+    },
+    "trash": {
+      "version": "1.0.0",
+      "files": {
+        ".gitignore": "4d56952b0fb13bf8f9b6c13a6d4c34a075bac3af447636a1df4335d7576e2f97",
+        "config.js": "ad76578e9dcc05c2e45854de9fa2cd41285fd8dcdb9a7d9ee2056e0f8b2d68d6",
+        "index.js": "d562d2466bddc93dd9a3bc5455962a3457c50368ee5dde0607cae3ff5a88578a",
+        "package.json": "18ec594d43b6595c587b16125b9ce0c9426fdf00a28d7e342834e31e360575f8",
+        "tool.manifest.json": "4f236d274c891b55e4445d459cff6a3337a5d13adc5e8aca7fb965ff6aba4e4d",
+        "trash-store.js": "1318e0f9539292684c0c2ec2f1b7189f066fdba42f78e07821b067792f40e8c9",
+        "trash-store.test.js": "5647edba4ab5e5492764ccf8ba3e674e42b63942623d779b0bf69465c5adb53f"
       }
     },
     "x-campaign-runner": {
@@ -126,66 +228,16 @@
     },
     "x-dm": {
       "version": "0.2.0",
+      "toolDependencies": {
+        "browser-session-bridge": "^0.1.0"
+      },
       "files": {
-        "README.md": "f02835c10d822ce906df121441761de8c6d61c3a4aac3f9aa9a6d9211b73a6ea",
         "config.js": "69a2dcccd10aa2f1ddcc24d52f4ce8fe4a6f5f5a85be64abbdf9dc9e19de0cd4",
-        "index.js": "cf4f92e94b9f21f6fcfed7d8d2926105a11b4ad621e2121c762d9c1e67a91456",
+        "index.js": "83e3eb7fbeea8a5183303e0e56b1d6854ca7ccb800e4cd2ad689a5f13637380f",
         "package.json": "3a76a921b1e78e91b1d2a5ae1926b298dfd6b4ee3f716d5382159b474ee400f4",
+        "README.md": "503b0ed25ef9a8df3079523ea653178e6e029854b4d199cb8d20be82cc837f9e",
         "test/x-dm.test.mjs": "06352996e14777358eb62ad5e5d757b0dab5c0696927ed54ff40a5b7cdefcfd0",
-        "tool.manifest.json": "f3b2e613562e4dd0f88d196c4e3caf525a425483133a54351300ce284a5836a9"
-      }
-    },
-    "official-tool-sync": {
-      "version": "1.0.0",
-      "toolDependencies": {
-        "trash": "^1.0.0"
-      },
-      "files": {
-        ".gitignore": "4d56952b0fb13bf8f9b6c13a6d4c34a075bac3af447636a1df4335d7576e2f97",
-        "config.js": "744c445b1d2ff65b77f38a5473c24e50a32f4288c4a08c25a874a478086c08c8",
-        "index.js": "fdd4167c63cd33c8e7640cb7ce09fd618dbd416030aa920407392e4591543e94",
-        "package.json": "4447cb5d4e0a04526604dfb9820c44af88349c27e208f27baa148686846559da",
-        "sync-lib.js": "c9f2cd7e19370088ab5fd10f6b2ada52c07d2e405674a356d0989f9a0f4984f6",
-        "sync-lib.test.js": "c97cf850d9f42f6b121a458863b048bdcaa6d7d0475642f20742c5862ebf7cc4",
-        "tool.manifest.json": "8e0f94ad786bdaf9edb1a65cd03438e26c1e9927e8db9a5a39e349e7ef3c6cd3"
-      }
-    },
-    "trash": {
-      "version": "1.0.0",
-      "files": {
-        ".gitignore": "4d56952b0fb13bf8f9b6c13a6d4c34a075bac3af447636a1df4335d7576e2f97",
-        "config.js": "ad76578e9dcc05c2e45854de9fa2cd41285fd8dcdb9a7d9ee2056e0f8b2d68d6",
-        "index.js": "d562d2466bddc93dd9a3bc5455962a3457c50368ee5dde0607cae3ff5a88578a",
-        "package.json": "18ec594d43b6595c587b16125b9ce0c9426fdf00a28d7e342834e31e360575f8",
-        "tool.manifest.json": "4f236d274c891b55e4445d459cff6a3337a5d13adc5e8aca7fb965ff6aba4e4d",
-        "trash-store.js": "1318e0f9539292684c0c2ec2f1b7189f066fdba42f78e07821b067792f40e8c9",
-        "trash-store.test.js": "5647edba4ab5e5492764ccf8ba3e674e42b63942623d779b0bf69465c5adb53f"
-      }
-    },
-    "process-retrospective": {
-      "version": "1.0.0",
-      "files": {
-        "README.md": "7fa901adf532dbd1bb337a8019b0bd73978eef3b1ded51ffb24a3279d107056d",
-        "config.js": "30703e809f0a2c4b85ffb1e1f9cd7ee599224e9bc62c3bc19e71e271cbc72b5d",
-        "index.js": "9bd1ae078293211387ee3035b4c4dc7cc5852d08503cd55cf5fb3187cf1ace34",
-        "package.json": "e3978089354004e495b7c7f4b4edd9c0984b34f68229d0dfdafbb2e606d48c8d",
-        "reflection-plan.js": "ae78b47f5108993395fe9a6f1ff2eea0663a07ae1100780f9a63107fd6402314",
-        "state-store.js": "6d0d39bff7e5e16558123c088eb8946bf3758596ae974598936b94424618c7cf",
-        "test/reflection-plan.test.js": "d4e960948fc76aaed03651652a592ee4b3109abbb91693d415945cbb79642237",
-        "tool.manifest.json": "4304208986be075c95c6d71aa97d301fd266af18fef1b6ddac4cf004e38427e7"
-      }
-    },
-    "creator-scout": {
-      "version": "1.0.1",
-      "files": {
-        "README.md": "4f50850317c0875ad7ddea767c7dda112669112bec107a98e67a31a42787b82c",
-        "config.js": "bab728665650b986c0eaef8e1be1c259ec42b1f83df4217c9780f5468d3c7666",
-        "index.js": "d1266d622b6abaf77ce1fe93823d4f2faedb8a5991371997c364082a198dc728",
-        "package-lock.json": "ed479120b59c2d9b083991dea60eb7750ba36bc7b2c7defb01cfb598889b8d90",
-        "package.json": "ad463eeddea6a958ef291d58f216c0b42c5ff3b398b62ed9512b857ea5e4b672",
-        "reference-match.js": "762d822ad31f89c06cb5a40f84ba3f864436db486375ed30e48bde94de282c7c",
-        "test/reference-match.test.js": "701ce83396126b1e42bd3a54e331ff011a1fc27646a0f3aa99ce1c3e576aff6d",
-        "tool.manifest.json": "0617b0488035fd7f8a83a8e5a698558b3d0e956e7ea1e043e2e80bb224d4974f"
+        "tool.manifest.json": "177e0abac770f89a0f06aa445363393fa38e7f05ad7cd773ea907fa56faed505"
       }
     }
   }

package/src/runtime/doctor.js

@@ -193,7 +193,6 @@ export async function inspectSystemResources({ diskPath = arisaHomeDir } = {}) {
 
 function assertDoctorPolicy(policy) {
   const positiveValues = [
-    "contextInspectionTimeoutMs",
     "contextWarningPercent",
     "contextCriticalPercent",
     "contextInefficientMinTokens",
@@ -318,9 +317,7 @@ export async function runDoctor({
   inspectToolDependencies = null
 }) {
   assertDoctorPolicy(doctorPolicy);
-  const runtime = await agentManager.getRuntimeDiagnostic({
-    contextInspectionTimeoutMs: doctorPolicy.contextInspectionTimeoutMs
-  });
+  const runtime = await agentManager.getRuntimeDiagnostic();
   const report = {
     runtime,
     contexts: runtime.contexts.map((context) => evaluateContext(context, doctorPolicy)),

package/src/runtime/headless-tool-executor.js

@@ -1,5 +1,4 @@
-import path from "node:path";
-import { unlink } from "node:fs/promises";
+import { materializeToolOutput } from "../core/tools/tool-output-materializer.js";
 
 export function createHeadlessToolExecutor({ artifactStore, taskStore, toolRegistry } = {}) {
   if (!artifactStore || !taskStore || !toolRegistry) {
@@ -10,36 +9,7 @@ export function createHeadlessToolExecutor({ artifactStore, taskStore, toolRegis
     async runTool({ name, request, chatId }) {
       await toolRegistry.load();
       const result = await toolRegistry.run({ name, request, chatId });
-      const chatArtifacts = artifactStore.forChat(chatId);
-
-      if (result.output?.text) {
-        const artifact = await chatArtifacts.createText({
-          text: result.output.text,
-          source: { type: "tool", toolName: name },
-          metadata: { tool: name }
-        });
-        result.output.artifactId = artifact.id;
-      }
-      if (result.output?.filePath) {
-        const generated = await chatArtifacts.createFromFile({
-          originalPath: result.output.filePath,
-          fileName: result.output.fileName || path.basename(result.output.filePath),
-          kind: result.output.kind || "file",
-          mimeType: result.output.mimeType || "application/octet-stream",
-          source: { type: "tool", toolName: name },
-          metadata: { tool: name, delivery: result.output.delivery }
-        });
-        result.output.artifactId = generated.id;
-        await unlink(result.output.filePath).catch(() => {});
-      }
-      if (result.asyncTask || result.asyncTasks?.length) {
-        result.asyncTasks = await taskStore.addMany(result.asyncTasks || [result.asyncTask], {
-          payload: { chatId },
-          source: { type: "tool", toolName: name, chatId }
-        });
-        delete result.asyncTask;
-      }
-      return result;
+      return materializeToolOutput({ result, name, chatId, artifactStore, taskStore });
     }
   };
 }

package/src/runtime/paths.js

@@ -13,6 +13,8 @@ export const configFile = path.join(stateDir, "config.json");
 export const piAuthFile = path.join(stateDir, "pi-auth.json");
 export const servicePidFile = path.join(stateDir, "arisa.pid");
 export const serviceLogFile = path.join(stateDir, "arisa.log");
+export const restartReceiptFile = path.join(stateDir, "restart-receipt.json");
+export const sessionStartOperationalNotesFile = path.join(stateDir, "session-start-operational-notes.json");
 export function createIpcSocketPath({ homeDir = arisaHomeDir, platform = process.platform } = {}) {
   if (platform === "win32") {
     const suffix = crypto.createHash("sha256").update(homeDir).digest("hex").slice(0, 16);
@@ -47,7 +49,11 @@ export function getChatArtifactsIndexFile(chatId) {
   return path.join(getChatDir(chatId), "state", "artifacts.json");
 }
 
-export function getChatConversationHistoryFile(chatId) {
+export function getChatSessionSeedFile(chatId) {
+  return path.join(getChatDir(chatId), "state", "session-seed.jsonl");
+}
+
+export function getChatLegacyConversationHistoryFile(chatId) {
   return path.join(getChatDir(chatId), "state", "conversation.jsonl");
 }
 

package/src/runtime/restart-receipt.js

@@ -0,0 +1,90 @@
+import crypto from "node:crypto";
+import { execFile } from "node:child_process";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+import { arisaPackageDir, restartReceiptFile } from "./paths.js";
+
+const execFileAsync = promisify(execFile);
+
+function normalizeDestination({ transportChatId, threadId = null }) {
+  const chatId = Number(transportChatId);
+  if (!Number.isSafeInteger(chatId)) throw new Error("Restart receipt requires a valid Telegram chat id");
+  const topic = threadId == null ? null : Number(threadId);
+  if (topic != null && (!Number.isSafeInteger(topic) || topic <= 0)) {
+    throw new Error("Restart receipt requires a valid Telegram topic id");
+  }
+  return { transportChatId: chatId, threadId: topic };
+}
+
+async function runtimeIdentity() {
+  const packageJson = JSON.parse(await readFile(path.join(arisaPackageDir, "package.json"), "utf8"));
+  let commit = null;
+  try {
+    const result = await execFileAsync("git", ["rev-parse", "--short=12", "HEAD"], { cwd: arisaPackageDir });
+    commit = String(result.stdout || "").trim() || null;
+  } catch {}
+  return { version: String(packageJson.version || "unknown"), commit };
+}
+
+export async function prepareRestartReceipt(destination, { reason = "requested restart" } = {}, {
+  receiptFile = restartReceiptFile,
+  getIdentity = runtimeIdentity
+} = {}) {
+  const target = normalizeDestination(destination);
+  const identity = await getIdentity();
+  const receipt = {
+    id: crypto.randomUUID(),
+    ...target,
+    reason: String(reason || "requested restart").slice(0, 500),
+    expectedVersion: identity.version,
+    expectedCommit: identity.commit,
+    requestedAt: new Date().toISOString()
+  };
+  await mkdir(path.dirname(receiptFile), { recursive: true, mode: 0o700 });
+  const temporaryFile = `${receiptFile}.${process.pid}.tmp`;
+  await writeFile(temporaryFile, `${JSON.stringify(receipt, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+  await rename(temporaryFile, receiptFile);
+  return receipt;
+}
+
+export async function cancelRestartReceipt(receiptId, { receiptFile = restartReceiptFile } = {}) {
+  try {
+    const receipt = JSON.parse(await readFile(receiptFile, "utf8"));
+    if (receipt.id !== receiptId) return false;
+    await rm(receiptFile, { force: true });
+    return true;
+  } catch (error) {
+    if (error?.code === "ENOENT") return false;
+    throw error;
+  }
+}
+
+export async function deliverRestartReceipt(sendMessage, {
+  receiptFile = restartReceiptFile,
+  getIdentity = runtimeIdentity
+} = {}) {
+  let receipt;
+  try {
+    receipt = JSON.parse(await readFile(receiptFile, "utf8"));
+  } catch (error) {
+    if (error?.code === "ENOENT") return null;
+    throw error;
+  }
+
+  const actual = await getIdentity();
+  const versionMatches = receipt.expectedVersion === actual.version;
+  const commitMatches = !receipt.expectedCommit || receipt.expectedCommit === actual.commit;
+  const genericReasons = new Set(["requested restart", "Agent-requested restart", "Telegram restart", "Telegram /restart", "Telegram update restart"]);
+  const resultSummary = String(receipt.reason || "").trim();
+  const lines = [
+    versionMatches && commitMatches ? "Restart completed." : "Restart completed with an unexpected runtime identity.",
+    resultSummary && !genericReasons.has(resultSummary) ? resultSummary : null,
+    `Arisa ${actual.version} is running${actual.commit ? ` at commit ${actual.commit}` : ""}.`,
+    versionMatches && commitMatches ? null : `Expected: ${receipt.expectedVersion}${receipt.expectedCommit ? ` at ${receipt.expectedCommit}` : ""}.`
+  ].filter(Boolean);
+  const options = receipt.threadId ? { message_thread_id: receipt.threadId } : {};
+  await sendMessage(receipt.transportChatId, lines.join("\n"), options);
+  await rm(receiptFile, { force: true });
+  return { receipt, actual, verified: versionMatches && commitMatches };
+}