@mathew-cf/opencode-memory 0.3.1 → 1.0.0

package/dist/index.js

@@ -1,4 +1,3 @@
-import { createRequire } from "node:module";
 var __defProp = Object.defineProperty;
 var __returnValue = (v) => v;
 function __exportSetter(name, newValue) {
@@ -13,12 +12,14 @@ var __export = (target, all) => {
       set: __exportSetter.bind(all, name)
     });
 };
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/index.ts
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
+// src/config.ts
+import { posix as posix2 } from "node:path";
+
 // src/constants.ts
 var CATEGORIES = [
   "preferences",
@@ -46,31 +47,66 @@ var STOP_WORDS = new Set([
 ]);
 
 // src/lib/paths.ts
+import { posix, win32 } from "node:path";
 function resolveHome(env = process.env) {
   const raw = env.HOME || env.USERPROFILE;
   if (!raw) {
     throw new Error("Cannot resolve home directory: neither HOME nor USERPROFILE is set. " + "On Windows, add `if (-not $env:HOME) { $env:HOME = $env:USERPROFILE }` to your PowerShell profile.");
   }
-  return normPath(raw);
+  return normalizeDirPath(raw);
 }
 function normPath(p) {
-  return p.replace(/\\/g, "/");
+  return posix.normalize(p.replaceAll(win32.sep, posix.sep));
+}
+function normalizeDirPath(p) {
+  return posix.join(normPath(p), ".");
+}
+function expandHomePath(p, env = process.env) {
+  const normalized = normPath(p);
+  if (normalized === "~")
+    return resolveHome(env);
+  if (normalized.startsWith(`~${posix.sep}`)) {
+    return posix.join(resolveHome(env), normalized.slice(2));
+  }
+  return normalized;
 }
 function resolveMemoryDir(env = process.env) {
-  if (env.MEMORY_DIR && env.MEMORY_DIR.length > 0)
-    return normPath(env.MEMORY_DIR);
-  return `${resolveHome(env)}/${DEFAULT_MEMORY_SUBDIR}`;
+  if (env.OPENCODE_MEMORY_DIR && env.OPENCODE_MEMORY_DIR.length > 0) {
+    return normalizeDirPath(expandHomePath(env.OPENCODE_MEMORY_DIR, env));
+  }
+  return posix.join(resolveHome(env), DEFAULT_MEMORY_SUBDIR);
+}
+function formatMemoryDirForDisplay(memoryDir, env = process.env) {
+  const normalized = normalizeDirPath(memoryDir);
+  try {
+    const home = resolveHome(env);
+    const relativeToHome = posix.relative(home, normalized);
+    if (relativeToHome === "")
+      return "~";
+    if (relativeToHome && !relativeToHome.startsWith("..") && !posix.isAbsolute(relativeToHome)) {
+      return posix.join("~", relativeToHome);
+    }
+  } catch {}
+  return normalized;
+}
+function formatMemoryPathForDisplay(memoryDir, relPath, env = process.env) {
+  const root = formatMemoryDirForDisplay(memoryDir, env);
+  if (!relPath)
+    return root;
+  return posix.join(root, normPath(relPath));
 }
 function ragIndexDir(memoryDir) {
-  return `${memoryDir}/${RAG_INDEX_SUBDIR}`;
+  return posix.join(memoryDir, RAG_INDEX_SUBDIR);
 }
 
 // src/config.ts
-var MEMORY_PROMPT_APPENDIX = `## Memory & Sessions
+function buildMemoryPromptAppendix(memoryDir = `~/${DEFAULT_MEMORY_SUBDIR}`) {
+  const memoryRoot = formatMemoryDirForDisplay(memoryDir);
+  return `## Memory & Sessions
 
 1. **Before work:** call \`memory_search\` and \`session_search\` with your topic. Read results — don't just glance at summaries.
 2. **When something is unfamiliar mid-task** (tool, API, pattern, build system): search both \`memory_search\` and \`session_search\` BEFORE attempting. Use previous sessions to inform your approach — don't try first, search first.
-3. **When you discover something reusable:** write to ~/opencode-memory/{category}/{filename}.md and \`memory_save\` immediately. Never defer, never ask.
+3. **When you discover something reusable:** write to ${memoryRoot}/{category}/{filename}.md and \`memory_save\` immediately. Never defer, never ask.
 
 If you can't write to memory, end your response with:
 ## Discoveries worth saving
@@ -87,13 +123,9 @@ End with: a clear conclusion (recommendation, diagnosis, or finding), your confi
 ## Source age
 
 Flag anything > 1 year old as potentially stale.`;
-var TARGET_AGENTS = [
-  "general",
-  "explore",
-  "research",
-  "review",
-  "investigator"
-];
+}
+var MEMORY_PROMPT_APPENDIX = buildMemoryPromptAppendix();
+var TARGET_AGENTS = ["general", "explore", "research", "review", "investigator"];
 var EXPLORE_PERMISSIONS = {
   memory_search: "allow",
   memory_list: "allow",
@@ -110,7 +142,8 @@ function applyConfig(config, options) {
       config.skills.paths.push(options.skillsDir);
     }
   }
-  const memoryGlob = `${options.memoryDir ?? resolveMemoryDir()}/**`;
+  const memoryDir = normalizeDirPath(options.memoryDir ?? resolveMemoryDir());
+  const memoryGlob = posix2.join(memoryDir, "**");
   config.permission = config.permission || {};
   if (typeof config.permission.edit !== "string") {
     const edit = config.permission.edit = config.permission.edit || {};
@@ -125,9 +158,9 @@ function applyConfig(config, options) {
     }
   }
   config.agent = config.agent || {};
+  const prefix = buildMemoryPromptAppendix(memoryDir);
   for (const name of TARGET_AGENTS) {
     const existing = config.agent[name] || {};
-    const prefix = MEMORY_PROMPT_APPENDIX;
     if (!existing.prompt) {
       existing.prompt = prefix;
     } else if (!existing.prompt.includes("memory_search")) {
@@ -136,7 +169,10 @@ function applyConfig(config, options) {
 ${existing.prompt}`;
     }
     if (name === "explore") {
-      existing.permission = { ...EXPLORE_PERMISSIONS, ...existing.permission || {} };
+      existing.permission = {
+        ...EXPLORE_PERMISSIONS,
+        ...existing.permission || {}
+      };
     } else {
       existing.permission = existing.permission || {};
       const p = existing.permission;
@@ -167,6 +203,13 @@ function matchesToolName(toolName, candidates) {
   const lower = toolName.toLowerCase();
   return candidates.some((c) => lower === c || lower.endsWith(`_${c}`) || lower.endsWith(`.${c}`));
 }
+function configuredMemoryDirLabel(memoryDir) {
+  try {
+    return formatMemoryDirForDisplay(memoryDir ?? resolveMemoryDir());
+  } catch {
+    return "the configured memory directory";
+  }
+}
 function afterToolUpdate(state, input) {
   state.toolCalls++;
   if (matchesToolName(input.tool, ["memory_search"]))
@@ -188,7 +231,8 @@ function afterToolUpdate(state, input) {
   }
   if (matchesToolName(input.tool, ["task"]) && !state.discoveryNudged && typeof input.output === "string" && input.output.includes("Discoveries worth saving")) {
     state.discoveryNudged = true;
-    return `<system-reminder>` + `The subagent reported "Discoveries worth saving" above. ` + `Per protocol, you MUST save these to ~/opencode-memory/ now — ` + `don't defer to session end. Write the file, then call memory_save.` + `</system-reminder>`;
+    const memoryRoot = configuredMemoryDirLabel(input.memoryDir);
+    return `<system-reminder>` + `The subagent reported "Discoveries worth saving" above. ` + `Per protocol, you MUST save these to ${memoryRoot} now — ` + `don't defer to session end. Write the file, then call memory_save.` + `</system-reminder>`;
   }
   return null;
 }
@@ -253,12 +297,16 @@ __export(exports_memory, {
   runList: () => runList,
   runAccess: () => runAccess,
   parseRagHits: () => parseRagHits,
+  memorySearchDescription: () => memorySearchDescription,
+  memorySaveDescription: () => memorySaveDescription,
+  memoryListDescription: () => memoryListDescription,
+  memoryAccessPathDescription: () => memoryAccessPathDescription,
   list: () => list,
   buildRgArgs: () => buildRgArgs,
   access: () => access
 });
 
-// node_modules/zod/v4/classic/external.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/classic/external.js
 var exports_external = {};
 __export(exports_external, {
   xid: () => xid2,
@@ -488,7 +536,7 @@ __export(exports_external, {
   $brand: () => $brand
 });
 
-// node_modules/zod/v4/core/index.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/index.js
 var exports_core2 = {};
 __export(exports_core2, {
   version: () => version,
@@ -752,7 +800,7 @@ __export(exports_core2, {
   $ZodAny: () => $ZodAny
 });
 
-// node_modules/zod/v4/core/core.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/core.js
 var NEVER = Object.freeze({
   status: "aborted"
 });
@@ -819,7 +867,7 @@ function config(newConfig) {
     Object.assign(globalConfig, newConfig);
   return globalConfig;
 }
-// node_modules/zod/v4/core/util.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/util.js
 var exports_util = {};
 __export(exports_util, {
   unwrapMessage: () => unwrapMessage,
@@ -1448,7 +1496,7 @@ class Class {
   constructor(..._args) {}
 }
 
-// node_modules/zod/v4/core/errors.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/errors.js
 var initializer = (inst, def) => {
   inst.name = "$ZodError";
   Object.defineProperty(inst, "_zod", {
@@ -1591,7 +1639,7 @@ function prettifyError(error) {
 `);
 }
 
-// node_modules/zod/v4/core/parse.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/parse.js
 var _parse = (_Err) => (schema, value, _ctx, _params) => {
   const ctx = _ctx ? Object.assign(_ctx, { async: false }) : { async: false };
   const result = schema._zod.run({ value, issues: [] }, ctx);
@@ -1678,7 +1726,7 @@ var _safeDecodeAsync = (_Err) => async (schema, value, _ctx) => {
   return _safeParseAsync(_Err)(schema, value, _ctx);
 };
 var safeDecodeAsync = /* @__PURE__ */ _safeDecodeAsync($ZodRealError);
-// node_modules/zod/v4/core/regexes.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/regexes.js
 var exports_regexes = {};
 __export(exports_regexes, {
   xid: () => xid,
@@ -1830,7 +1878,7 @@ var sha512_hex = /^[0-9a-fA-F]{128}$/;
 var sha512_base64 = /* @__PURE__ */ fixedBase64(86, "==");
 var sha512_base64url = /* @__PURE__ */ fixedBase64url(86);
 
-// node_modules/zod/v4/core/checks.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/checks.js
 var $ZodCheck = /* @__PURE__ */ $constructor("$ZodCheck", (inst, def) => {
   var _a;
   inst._zod ?? (inst._zod = {});
@@ -2371,7 +2419,7 @@ var $ZodCheckOverwrite = /* @__PURE__ */ $constructor("$ZodCheckOverwrite", (ins
   };
 });
 
-// node_modules/zod/v4/core/doc.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/doc.js
 class Doc {
   constructor(args = []) {
     this.content = [];
@@ -2409,14 +2457,14 @@ class Doc {
   }
 }
 
-// node_modules/zod/v4/core/versions.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/versions.js
 var version = {
   major: 4,
   minor: 1,
   patch: 8
 };
 
-// node_modules/zod/v4/core/schemas.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/schemas.js
 var $ZodType = /* @__PURE__ */ $constructor("$ZodType", (inst, def) => {
   var _a;
   inst ?? (inst = {});
@@ -4239,7 +4287,7 @@ function handleRefineResult(result, payload, input, inst) {
     payload.issues.push(issue(_iss));
   }
 }
-// node_modules/zod/v4/locales/index.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/index.js
 var exports_locales = {};
 __export(exports_locales, {
   zhTW: () => zh_TW_default,
@@ -4290,7 +4338,7 @@ __export(exports_locales, {
   ar: () => ar_default
 });
 
-// node_modules/zod/v4/locales/ar.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ar.js
 var error = () => {
   const Sizable = {
     string: { unit: "حرف", verb: "أن يحوي" },
@@ -4406,7 +4454,7 @@ function ar_default() {
     localeError: error()
   };
 }
-// node_modules/zod/v4/locales/az.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/az.js
 var error2 = () => {
   const Sizable = {
     string: { unit: "simvol", verb: "olmalıdır" },
@@ -4521,7 +4569,7 @@ function az_default() {
     localeError: error2()
   };
 }
-// node_modules/zod/v4/locales/be.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/be.js
 function getBelarusianPlural(count, one, few, many) {
   const absCount = Math.abs(count);
   const lastDigit = absCount % 10;
@@ -4685,7 +4733,7 @@ function be_default() {
     localeError: error3()
   };
 }
-// node_modules/zod/v4/locales/ca.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ca.js
 var error4 = () => {
   const Sizable = {
     string: { unit: "caràcters", verb: "contenir" },
@@ -4802,7 +4850,7 @@ function ca_default() {
     localeError: error4()
   };
 }
-// node_modules/zod/v4/locales/cs.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/cs.js
 var error5 = () => {
   const Sizable = {
     string: { unit: "znaků", verb: "mít" },
@@ -4937,7 +4985,7 @@ function cs_default() {
     localeError: error5()
   };
 }
-// node_modules/zod/v4/locales/da.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/da.js
 var error6 = () => {
   const Sizable = {
     string: { unit: "tegn", verb: "havde" },
@@ -5068,7 +5116,7 @@ function da_default() {
     localeError: error6()
   };
 }
-// node_modules/zod/v4/locales/de.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/de.js
 var error7 = () => {
   const Sizable = {
     string: { unit: "Zeichen", verb: "zu haben" },
@@ -5184,7 +5232,7 @@ function de_default() {
     localeError: error7()
   };
 }
-// node_modules/zod/v4/locales/en.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/en.js
 var parsedType = (data) => {
   const t = typeof data;
   switch (t) {
@@ -5301,7 +5349,7 @@ function en_default() {
     localeError: error8()
   };
 }
-// node_modules/zod/v4/locales/eo.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/eo.js
 var parsedType2 = (data) => {
   const t = typeof data;
   switch (t) {
@@ -5417,7 +5465,7 @@ function eo_default() {
     localeError: error9()
   };
 }
-// node_modules/zod/v4/locales/es.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/es.js
 var error10 = () => {
   const Sizable = {
     string: { unit: "caracteres", verb: "tener" },
@@ -5565,7 +5613,7 @@ function es_default() {
     localeError: error10()
   };
 }
-// node_modules/zod/v4/locales/fa.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/fa.js
 var error11 = () => {
   const Sizable = {
     string: { unit: "کاراکتر", verb: "داشته باشد" },
@@ -5687,7 +5735,7 @@ function fa_default() {
     localeError: error11()
   };
 }
-// node_modules/zod/v4/locales/fi.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/fi.js
 var error12 = () => {
   const Sizable = {
     string: { unit: "merkkiä", subject: "merkkijonon" },
@@ -5809,7 +5857,7 @@ function fi_default() {
     localeError: error12()
   };
 }
-// node_modules/zod/v4/locales/fr.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/fr.js
 var error13 = () => {
   const Sizable = {
     string: { unit: "caractères", verb: "avoir" },
@@ -5925,7 +5973,7 @@ function fr_default() {
     localeError: error13()
   };
 }
-// node_modules/zod/v4/locales/fr-CA.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/fr-CA.js
 var error14 = () => {
   const Sizable = {
     string: { unit: "caractères", verb: "avoir" },
@@ -6042,7 +6090,7 @@ function fr_CA_default() {
     localeError: error14()
   };
 }
-// node_modules/zod/v4/locales/he.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/he.js
 var error15 = () => {
   const Sizable = {
     string: { unit: "אותיות", verb: "לכלול" },
@@ -6158,7 +6206,7 @@ function he_default() {
     localeError: error15()
   };
 }
-// node_modules/zod/v4/locales/hu.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/hu.js
 var error16 = () => {
   const Sizable = {
     string: { unit: "karakter", verb: "legyen" },
@@ -6274,7 +6322,7 @@ function hu_default() {
     localeError: error16()
   };
 }
-// node_modules/zod/v4/locales/id.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/id.js
 var error17 = () => {
   const Sizable = {
     string: { unit: "karakter", verb: "memiliki" },
@@ -6390,7 +6438,7 @@ function id_default() {
     localeError: error17()
   };
 }
-// node_modules/zod/v4/locales/is.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/is.js
 var parsedType3 = (data) => {
   const t = typeof data;
   switch (t) {
@@ -6507,7 +6555,7 @@ function is_default() {
     localeError: error18()
   };
 }
-// node_modules/zod/v4/locales/it.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/it.js
 var error19 = () => {
   const Sizable = {
     string: { unit: "caratteri", verb: "avere" },
@@ -6623,7 +6671,7 @@ function it_default() {
     localeError: error19()
   };
 }
-// node_modules/zod/v4/locales/ja.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ja.js
 var error20 = () => {
   const Sizable = {
     string: { unit: "文字", verb: "である" },
@@ -6738,7 +6786,7 @@ function ja_default() {
     localeError: error20()
   };
 }
-// node_modules/zod/v4/locales/ka.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ka.js
 var parsedType4 = (data) => {
   const t = typeof data;
   switch (t) {
@@ -6863,7 +6911,7 @@ function ka_default() {
     localeError: error21()
   };
 }
-// node_modules/zod/v4/locales/km.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/km.js
 var error22 = () => {
   const Sizable = {
     string: { unit: "តួអក្សរ", verb: "គួរមាន" },
@@ -6981,11 +7029,11 @@ function km_default() {
   };
 }
 
-// node_modules/zod/v4/locales/kh.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/kh.js
 function kh_default() {
   return km_default();
 }
-// node_modules/zod/v4/locales/ko.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ko.js
 var error23 = () => {
   const Sizable = {
     string: { unit: "문자", verb: "to have" },
@@ -7106,7 +7154,7 @@ function ko_default() {
     localeError: error23()
   };
 }
-// node_modules/zod/v4/locales/lt.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/lt.js
 var parsedType5 = (data) => {
   const t = typeof data;
   return parsedTypeFromType(t, data);
@@ -7335,7 +7383,7 @@ function lt_default() {
     localeError: error24()
   };
 }
-// node_modules/zod/v4/locales/mk.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/mk.js
 var error25 = () => {
   const Sizable = {
     string: { unit: "знаци", verb: "да имаат" },
@@ -7452,7 +7500,7 @@ function mk_default() {
     localeError: error25()
   };
 }
-// node_modules/zod/v4/locales/ms.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ms.js
 var error26 = () => {
   const Sizable = {
     string: { unit: "aksara", verb: "mempunyai" },
@@ -7568,7 +7616,7 @@ function ms_default() {
     localeError: error26()
   };
 }
-// node_modules/zod/v4/locales/nl.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/nl.js
 var error27 = () => {
   const Sizable = {
     string: { unit: "tekens" },
@@ -7685,7 +7733,7 @@ function nl_default() {
     localeError: error27()
   };
 }
-// node_modules/zod/v4/locales/no.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/no.js
 var error28 = () => {
   const Sizable = {
     string: { unit: "tegn", verb: "å ha" },
@@ -7801,7 +7849,7 @@ function no_default() {
     localeError: error28()
   };
 }
-// node_modules/zod/v4/locales/ota.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ota.js
 var error29 = () => {
   const Sizable = {
     string: { unit: "harf", verb: "olmalıdır" },
@@ -7917,7 +7965,7 @@ function ota_default() {
     localeError: error29()
   };
 }
-// node_modules/zod/v4/locales/ps.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ps.js
 var error30 = () => {
   const Sizable = {
     string: { unit: "توکي", verb: "ولري" },
@@ -8039,7 +8087,7 @@ function ps_default() {
     localeError: error30()
   };
 }
-// node_modules/zod/v4/locales/pl.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/pl.js
 var error31 = () => {
   const Sizable = {
     string: { unit: "znaków", verb: "mieć" },
@@ -8156,7 +8204,7 @@ function pl_default() {
     localeError: error31()
   };
 }
-// node_modules/zod/v4/locales/pt.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/pt.js
 var error32 = () => {
   const Sizable = {
     string: { unit: "caracteres", verb: "ter" },
@@ -8272,7 +8320,7 @@ function pt_default() {
     localeError: error32()
   };
 }
-// node_modules/zod/v4/locales/ru.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ru.js
 function getRussianPlural(count, one, few, many) {
   const absCount = Math.abs(count);
   const lastDigit = absCount % 10;
@@ -8436,7 +8484,7 @@ function ru_default() {
     localeError: error33()
   };
 }
-// node_modules/zod/v4/locales/sl.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/sl.js
 var error34 = () => {
   const Sizable = {
     string: { unit: "znakov", verb: "imeti" },
@@ -8553,7 +8601,7 @@ function sl_default() {
     localeError: error34()
   };
 }
-// node_modules/zod/v4/locales/sv.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/sv.js
 var error35 = () => {
   const Sizable = {
     string: { unit: "tecken", verb: "att ha" },
@@ -8671,7 +8719,7 @@ function sv_default() {
     localeError: error35()
   };
 }
-// node_modules/zod/v4/locales/ta.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ta.js
 var error36 = () => {
   const Sizable = {
     string: { unit: "எழுத்துக்கள்", verb: "கொண்டிருக்க வேண்டும்" },
@@ -8788,7 +8836,7 @@ function ta_default() {
     localeError: error36()
   };
 }
-// node_modules/zod/v4/locales/th.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/th.js
 var error37 = () => {
   const Sizable = {
     string: { unit: "ตัวอักษร", verb: "ควรมี" },
@@ -8905,7 +8953,7 @@ function th_default() {
     localeError: error37()
   };
 }
-// node_modules/zod/v4/locales/tr.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/tr.js
 var parsedType6 = (data) => {
   const t = typeof data;
   switch (t) {
@@ -9020,7 +9068,7 @@ function tr_default() {
     localeError: error38()
   };
 }
-// node_modules/zod/v4/locales/uk.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/uk.js
 var error39 = () => {
   const Sizable = {
     string: { unit: "символів", verb: "матиме" },
@@ -9137,11 +9185,11 @@ function uk_default() {
   };
 }
 
-// node_modules/zod/v4/locales/ua.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ua.js
 function ua_default() {
   return uk_default();
 }
-// node_modules/zod/v4/locales/ur.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/ur.js
 var error40 = () => {
   const Sizable = {
     string: { unit: "حروف", verb: "ہونا" },
@@ -9258,7 +9306,7 @@ function ur_default() {
     localeError: error40()
   };
 }
-// node_modules/zod/v4/locales/vi.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/vi.js
 var error41 = () => {
   const Sizable = {
     string: { unit: "ký tự", verb: "có" },
@@ -9374,7 +9422,7 @@ function vi_default() {
     localeError: error41()
   };
 }
-// node_modules/zod/v4/locales/zh-CN.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/zh-CN.js
 var error42 = () => {
   const Sizable = {
     string: { unit: "字符", verb: "包含" },
@@ -9490,7 +9538,7 @@ function zh_CN_default() {
     localeError: error42()
   };
 }
-// node_modules/zod/v4/locales/zh-TW.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/zh-TW.js
 var error43 = () => {
   const Sizable = {
     string: { unit: "字元", verb: "擁有" },
@@ -9607,7 +9655,7 @@ function zh_TW_default() {
     localeError: error43()
   };
 }
-// node_modules/zod/v4/locales/yo.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/locales/yo.js
 var error44 = () => {
   const Sizable = {
     string: { unit: "àmi", verb: "ní" },
@@ -9722,7 +9770,7 @@ function yo_default() {
     localeError: error44()
   };
 }
-// node_modules/zod/v4/core/registries.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/registries.js
 var $output = Symbol("ZodOutput");
 var $input = Symbol("ZodInput");
 
@@ -9773,7 +9821,7 @@ function registry() {
   return new $ZodRegistry;
 }
 var globalRegistry = /* @__PURE__ */ registry();
-// node_modules/zod/v4/core/api.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/api.js
 function _string(Class2, params) {
   return new Class2({
     type: "string",
@@ -10651,7 +10699,7 @@ function _stringFormat(Class2, format, fnOrRegex, _params = {}) {
   const inst = new Class2(def);
   return inst;
 }
-// node_modules/zod/v4/core/to-json-schema.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/to-json-schema.js
 class JSONSchemaGenerator {
   constructor(params) {
     this.counter = 0;
@@ -10989,7 +11037,7 @@ class JSONSchemaGenerator {
               if (val === undefined) {
                 if (this.unrepresentable === "throw") {
                   throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-                } else {}
+                }
               } else if (typeof val === "bigint") {
                 if (this.unrepresentable === "throw") {
                   throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -11455,9 +11503,9 @@ function isTransforming(_schema, _ctx) {
   }
   throw new Error(`Unknown schema type: ${def.type}`);
 }
-// node_modules/zod/v4/core/json-schema.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/core/json-schema.js
 var exports_json_schema = {};
-// node_modules/zod/v4/classic/iso.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/classic/iso.js
 var exports_iso = {};
 __export(exports_iso, {
   time: () => time2,
@@ -11498,7 +11546,7 @@ function duration2(params) {
   return _isoDuration(ZodISODuration, params);
 }
 
-// node_modules/zod/v4/classic/errors.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/classic/errors.js
 var initializer2 = (inst, issues) => {
   $ZodError.init(inst, issues);
   inst.name = "ZodError";
@@ -11533,7 +11581,7 @@ var ZodRealError = $constructor("ZodError", initializer2, {
   Parent: Error
 });
 
-// node_modules/zod/v4/classic/parse.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/classic/parse.js
 var parse3 = /* @__PURE__ */ _parse(ZodRealError);
 var parseAsync2 = /* @__PURE__ */ _parseAsync(ZodRealError);
 var safeParse2 = /* @__PURE__ */ _safeParse(ZodRealError);
@@ -11547,7 +11595,7 @@ var safeDecode2 = /* @__PURE__ */ _safeDecode(ZodRealError);
 var safeEncodeAsync2 = /* @__PURE__ */ _safeEncodeAsync(ZodRealError);
 var safeDecodeAsync2 = /* @__PURE__ */ _safeDecodeAsync(ZodRealError);
 
-// node_modules/zod/v4/classic/schemas.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/classic/schemas.js
 var ZodType = /* @__PURE__ */ $constructor("ZodType", (inst, def) => {
   $ZodType.init(inst, def);
   inst.def = def;
@@ -12522,7 +12570,7 @@ function json(params) {
 function preprocess(fn, schema) {
   return pipe(transform(fn), schema);
 }
-// node_modules/zod/v4/classic/compat.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/classic/compat.js
 var ZodIssueCode = {
   invalid_type: "invalid_type",
   too_big: "too_big",
@@ -12546,7 +12594,7 @@ function getErrorMap() {
 }
 var ZodFirstPartyTypeKind;
 (function(ZodFirstPartyTypeKind2) {})(ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {}));
-// node_modules/zod/v4/classic/coerce.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/classic/coerce.js
 var exports_coerce = {};
 __export(exports_coerce, {
   string: () => string3,
@@ -12571,13 +12619,16 @@ function date4(params) {
   return _coercedDate(ZodDate, params);
 }
 
-// node_modules/zod/v4/classic/external.js
+// node_modules/@opencode-ai/plugin/node_modules/zod/v4/classic/external.js
 config(en_default());
 // node_modules/@opencode-ai/plugin/dist/tool.js
 function tool(input) {
   return input;
 }
 tool.schema = exports_external;
+// src/tools/memory.ts
+import { posix as posix3 } from "node:path";
+
 // src/lib/frontmatter.ts
 var FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
 function parseFrontmatter(content) {
@@ -12642,8 +12693,8 @@ function todayISO() {
 }
 
 // src/lib/rag.ts
-import { createRequire as createRequire2 } from "node:module";
-var require2 = createRequire2(import.meta.url);
+import { createRequire } from "node:module";
+var require2 = createRequire(import.meta.url);
 function resolveRagBinary() {
   try {
     return require2.resolve("@mathew-cf/rag-cli/bin/rag.js");
@@ -12706,8 +12757,8 @@ async function downloadModel() {
 }
 
 // src/lib/ripgrep.ts
-import { createRequire as createRequire3 } from "node:module";
-var require3 = createRequire3(import.meta.url);
+import { createRequire as createRequire2 } from "node:module";
+var require3 = createRequire2(import.meta.url);
 function resolveRgBinary() {
   try {
     const mod = require3("@vscode/ripgrep");
@@ -12797,17 +12848,7 @@ function scoreCandidate(input) {
 
 // src/tools/memory.ts
 function buildRgArgs(terms) {
-  const args = [
-    "-il",
-    "--glob",
-    "*.md",
-    "--glob",
-    "!.git",
-    "--glob",
-    "!.rag",
-    "--glob",
-    "!**/INDEX.md"
-  ];
+  const args = ["-il", "--glob", "*.md", "--glob", "!.git", "--glob", "!.rag", "--glob", "!**/INDEX.md"];
   for (const term of terms) {
     args.push("-e", term);
   }
@@ -12826,10 +12867,26 @@ function parseRagHits(ragText) {
   }
 }
 function toRelPath(memoryDir, absPath) {
-  return normPath(absPath).replace(`${memoryDir}/`, "");
+  return posix3.relative(memoryDir, normPath(absPath));
 }
-var search = tool({
-  description: "Search memories in ~/opencode-memory/ using both keyword (rg) and semantic (rag) search. " + "Results are summaries only (path, tags, importance, short context). " + `Use the Read tool on ~/opencode-memory/{path} to get the full content.
+function configuredMemoryDirLabel2(memoryDir) {
+  try {
+    return formatMemoryDirForDisplay(memoryDir ?? resolveMemoryDir());
+  } catch {
+    return "the configured memory directory";
+  }
+}
+function configuredMemoryPathLabel(relPath, memoryDir) {
+  try {
+    return formatMemoryPathForDisplay(memoryDir ?? resolveMemoryDir(), relPath);
+  } catch {
+    return `the configured memory directory/${relPath}`;
+  }
+}
+function memorySearchDescription(memoryDir) {
+  const memoryRoot = configuredMemoryDirLabel2(memoryDir);
+  const memoryPath = configuredMemoryPathLabel("{path}", memoryDir);
+  return `Search memories in ${memoryRoot} using both keyword (rg) and semantic (rag) search. ` + "Results are summaries only (path, tags, importance, short context). " + `Use the Read tool on ${memoryPath} to get the full content.
 
 ` + "Multi-term queries match files containing ANY search term (OR logic); files matching more terms rank higher. " + `For example, 'errors retries' finds files mentioning 'errors' OR 'retries', with files containing both ranked first.
 
@@ -12842,9 +12899,53 @@ var search = tool({
 ` + `- Before writing new memory — check if a file already exists to update instead of duplicate
 
 ` + `FOLLOW-UP SEARCHES (do when results seem incomplete):
-` + `- Results include Related: files — use the Read tool on ~/opencode-memory/{path} for connected knowledge
+` + `- Results include Related: files — use the Read tool on ${memoryPath} for connected knowledge
 ` + `- If few/no results, try broader terms or search without the category filter
-` + "- Check the 'Related files' section at the bottom of results for cross-references worth exploring",
+` + "- Check the 'Related files' section at the bottom of results for cross-references worth exploring";
+}
+function memoryListDescription(memoryDir) {
+  const memoryRoot = configuredMemoryDirLabel2(memoryDir);
+  return `Browse memories in ${memoryRoot}. Without a category, lists all categories with file counts. ` + "With a category, lists files in that category with their summaries.";
+}
+function memoryAccessPathDescription(memoryDir) {
+  const memoryRoot = configuredMemoryDirLabel2(memoryDir);
+  return `Relative path within ${memoryRoot} (e.g. 'technical/build-tooling.md')`;
+}
+function memorySaveDescription(memoryDir) {
+  const memoryPath = configuredMemoryPathLabel("{category}/{filename}.md", memoryDir);
+  return "Commit and re-index all pending memory changes. " + `Call AFTER using Write/Edit tools on ${memoryPath}. ` + `Handles: git add -A, commit (message derived from changed files), RAG re-indexing.
+
+` + `WHEN TO SAVE (always save when you discover something reusable):
+` + `- Learned a non-obvious API pattern, tool quirk, or workaround
+` + `- Discovered repo structure, conventions, or gotchas that future sessions would benefit from
+` + `- Found external tool usage patterns that weren't documented
+` + `- Resolved a tricky debugging problem with a non-obvious root cause
+` + `- Learned team/ownership/contact information not easily found elsewhere
+` + `DO NOT save: one-off answers, things in public docs, or context only relevant to the current task
+
+` + `WORKFLOW:
+` + `1. memory_search first — check if a file already exists to update
+` + `2. Write/Edit files at ${memoryPath}
+` + `3. Call this tool to sync all changes
+
+` + `REPO NOTES: for repository-related memory, use the path structure
+` + "`repos/{host}/{org}/{repo}.md` — e.g. `repos/github.com/user/project.md`.\n" + `This makes it easy to find later by repo URL fragments.
+
+` + `CATEGORIES: preferences, repos, technical, people, workflows, snippets, notes
+
+` + `FRONTMATTER FORMAT (include at top of file):
+` + `---
+` + `title: Human-readable title
+` + `tags: [tag1, tag2]
+` + `summary: One-line summary
+` + `created: YYYY-MM-DD
+` + `updated: YYYY-MM-DD
+` + `importance: high | medium | low
+` + `related: [category/file.md]
+` + "---";
+}
+var search = tool({
+  description: memorySearchDescription(),
   args: {
     query: tool.schema.string().describe("Search terms or natural language query"),
     category: tool.schema.string().optional().describe("Filter to a specific category: preferences, repos, technical, people, workflows, snippets, notes")
@@ -12857,7 +12958,7 @@ async function runSearch(input) {
   const { query, category } = input;
   const memoryDir = resolveMemoryDir();
   const indexDir = ragIndexDir(memoryDir);
-  const searchDir = category ? `${memoryDir}/${category}` : memoryDir;
+  const searchDir = category ? posix3.join(memoryDir, category) : memoryDir;
   const terms = parseSearchTerms(query);
   const rgTerms = terms.length > 0 ? terms : [query];
   const hasRag = ragAvailable();
@@ -12915,7 +13016,7 @@ async function runSearch(input) {
     }
   }
   if (resultMap.size === 0) {
-    const scanDir = category ? `${memoryDir}/${category}` : memoryDir;
+    const scanDir = category ? posix3.join(memoryDir, category) : memoryDir;
     const suggestions = [];
     try {
       const fnGlob = new Bun.Glob("**/*.md");
@@ -12932,7 +13033,7 @@ async function runSearch(input) {
       return `No content matches for: "${query}"
 
 ` + `Files with matching names:
-${suggestions.slice(0, 5).map((s) => `  - ~/opencode-memory/${s}`).join(`
+${suggestions.slice(0, 5).map((s) => `  - ${formatMemoryPathForDisplay(memoryDir, s)}`).join(`
 `)}
 
 ` + `Use the Read tool to check these.`;
@@ -12942,7 +13043,7 @@ ${suggestions.slice(0, 5).map((s) => `  - ~/opencode-memory/${s}`).join(`
   const results = [];
   for (const [path, info] of resultMap) {
     try {
-      const content = await Bun.file(`${memoryDir}/${path}`).text();
+      const content = await Bun.file(posix3.join(memoryDir, path)).text();
       const { meta } = parseFrontmatter(content);
       const termMatches = terms.length > 0 ? countTermMatches(content, terms) : info.rgMatch ? 1 : 0;
       const score = scoreCandidate({
@@ -13003,7 +13104,7 @@ ${suggestions.slice(0, 5).map((s) => `  - ~/opencode-memory/${s}`).join(`
     lines.push("");
   }
   if (topResults.length > 0) {
-    lines.push(`_Read the top result: \`~/opencode-memory/${topResults[0].path}\`_`);
+    lines.push(`_Read the top result: \`${formatMemoryPathForDisplay(memoryDir, topResults[0].path)}\`_`);
     lines.push("");
   }
   const shownPaths = new Set(topResults.slice(0, 7).map((r) => r.path));
@@ -13018,13 +13119,13 @@ ${suggestions.slice(0, 5).map((s) => `  - ~/opencode-memory/${s}`).join(`
   const verified = [];
   for (const rel of relatedSuggestions) {
     try {
-      if (await Bun.file(`${memoryDir}/${rel}`).exists())
+      if (await Bun.file(posix3.join(memoryDir, rel)).exists())
         verified.push(rel);
     } catch {}
   }
   if (verified.length > 0) {
     lines.push("---");
-    lines.push("**Related files** (not in results — use the Read tool on ~/opencode-memory/{path}):");
+    lines.push(`**Related files** (not in results — use the Read tool on ${formatMemoryPathForDisplay(memoryDir, "{path}")}):`);
     for (const rel of verified) {
       lines.push(`  - ${rel}`);
     }
@@ -13034,7 +13135,7 @@ ${suggestions.slice(0, 5).map((s) => `  - ~/opencode-memory/${s}`).join(`
 `);
 }
 var list = tool({
-  description: "Browse memories in ~/opencode-memory/. Without a category, lists all categories with file counts. " + "With a category, lists files in that category with their summaries.",
+  description: memoryListDescription(),
   args: {
     category: tool.schema.string().optional().describe("Category to list: preferences, repos, technical, people, workflows, snippets, notes")
   },
@@ -13053,7 +13154,7 @@ async function runList(input) {
       let count = 0;
       try {
         for await (const _ of glob2.scan({
-          cwd: `${memoryDir}/${cat}`,
+          cwd: posix3.join(memoryDir, cat),
           dot: false
         })) {
           count++;
@@ -13064,13 +13165,13 @@ async function runList(input) {
     return lines2.join(`
 `);
   }
-  const catDir = `${memoryDir}/${category}`;
+  const catDir = posix3.join(memoryDir, category);
   const glob = new Bun.Glob("**/*.md");
   const files = [];
   try {
     for await (const f of glob.scan({ cwd: catDir, dot: false })) {
       try {
-        const content = await Bun.file(`${catDir}/${f}`).text();
+        const content = await Bun.file(posix3.join(catDir, f)).text();
         const { meta } = parseFrontmatter(content);
         files.push({
           path: `${category}/${f}`,
@@ -13103,7 +13204,7 @@ var access = tool({
 
 ` + "This helps the memory system track which memories are actively useful vs. stale.",
   args: {
-    path: tool.schema.string().describe("Relative path within ~/opencode-memory/ (e.g. 'technical/build-tooling.md')")
+    path: tool.schema.string().describe(memoryAccessPathDescription())
   },
   async execute({ path }) {
     return runAccess({ path });
@@ -13112,7 +13213,7 @@ var access = tool({
 async function runAccess(input) {
   const memoryDir = resolveMemoryDir();
   const { path } = input;
-  const filePath = `${memoryDir}/${path}`;
+  const filePath = posix3.join(memoryDir, path);
   try {
     const content = await Bun.file(filePath).text();
     const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
@@ -13132,36 +13233,7 @@ ${body}`);
   }
 }
 var save = tool({
-  description: "Commit and re-index all pending memory changes. " + "Call AFTER using Write/Edit tools on ~/opencode-memory/{category}/{filename}.md. " + `Handles: git add -A, commit (message derived from changed files), RAG re-indexing.
-
-` + `WHEN TO SAVE (always save when you discover something reusable):
-` + `- Learned a non-obvious API pattern, tool quirk, or workaround
-` + `- Discovered repo structure, conventions, or gotchas that future sessions would benefit from
-` + `- Found external tool usage patterns that weren't documented
-` + `- Resolved a tricky debugging problem with a non-obvious root cause
-` + `- Learned team/ownership/contact information not easily found elsewhere
-` + `DO NOT save: one-off answers, things in public docs, or context only relevant to the current task
-
-` + `WORKFLOW:
-` + `1. memory_search first — check if a file already exists to update
-` + `2. Write/Edit files at ~/opencode-memory/{category}/{filename}.md
-` + `3. Call this tool to sync all changes
-
-` + `REPO NOTES: for repository-related memory, use the path structure
-` + "`repos/{host}/{org}/{repo}.md` — e.g. `repos/github.com/user/project.md`.\n" + `This makes it easy to find later by repo URL fragments.
-
-` + `CATEGORIES: preferences, repos, technical, people, workflows, snippets, notes
-
-` + `FRONTMATTER FORMAT (include at top of file):
-` + `---
-` + `title: Human-readable title
-` + `tags: [tag1, tag2]
-` + `summary: One-line summary
-` + `created: YYYY-MM-DD
-` + `updated: YYYY-MM-DD
-` + `importance: high | medium | low
-` + `related: [category/file.md]
-` + "---",
+  description: memorySaveDescription(),
   args: {},
   async execute() {
     return runSave();