@momomemory/opencode-momo 0.1.2 → 0.1.5

package/README.md

@@ -115,6 +115,14 @@ The `momo` tool supports 6 operational modes:
 - **list**: List recent memories for a given scope.
 - **forget**: Remove a specific memory by its ID.
 
+### Ingestion Tools (RAG Pipeline)
+For richer ingestion than plain `read`, the plugin also exposes dedicated tools that route through Momo's document pipeline:
+- **momo_ingest**: Ingest text, URLs, or local files into documents + retrieval index, with optional memory extraction.
+- **momo_ocr**: Ingest image files, run OCR, and optionally extract memories from recognized text.
+- **momo_transcribe**: Ingest audio/video files, run transcription, and optionally extract memories.
+
+These tools are especially useful with non-vision models: image/audio content is converted into searchable text in Momo.
+
 ### Codebase Indexing
 The `/momo-init` command provides a structured workflow for agents to explore a new codebase and store its architecture, conventions, and key facts into project memory.
 
@@ -138,6 +146,14 @@ Momo supports the `<private>` tag. Any content wrapped in `<private>` tags is au
 **Scopes**: `user` (cross-project), `project` (current project, default)  
 **Memory Types**: `fact`, `preference`, `episode`
 
+### Ingestion Tool Arguments (high-level)
+
+| Tool | Required Args | Optional Args |
+|------|--------------|---------------|
+| `momo_ingest` | `input` | `inputType`, `scope`, `extractMemories`, `metadataJson`, `contentType`, `wait`, `timeoutMs`, `pollIntervalMs` |
+| `momo_ocr` | `filePath` | `scope`, `extractMemories`, `contentType`, `wait`, `timeoutMs`, `pollIntervalMs` |
+| `momo_transcribe` | `filePath` | `scope`, `extractMemories`, `contentType`, `wait`, `timeoutMs`, `pollIntervalMs` |
+
 ## Memory Scoping
 
 Memories are isolated using container tags derived from your environment:
@@ -156,10 +172,27 @@ Configuration is stored in `~/.config/opencode/momo.jsonc`:
   // Momo server URL
   "baseUrl": "http://localhost:3000",
   // API key for authentication
-  "apiKey": "your-key-here"
+  "apiKey": "your-key-here",
+  // Optional override for user memory container tag
+  "containerTagUser": "",
+  // Optional override for project memory container tag
+  "containerTagProject": ""
 }
 ```
 
+### Project-local config (optional)
+
+You can also place config in your project root as `.momo.jsonc` (preferred) or `momo.jsonc`.
+This is useful when you want a stable `containerTagProject` for a specific repo.
+
+### Config precedence
+
+Highest to lowest precedence:
+1. Environment variables (`MOMO_*`)
+2. Project-local config (`.momo.jsonc` / `momo.jsonc`)
+3. Global config (`~/.config/opencode/momo.jsonc`)
+4. Built-in defaults
+
 ### Environment Variables
 
 The following variables can be used to override configuration:

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAyIA;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA8CjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAWA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,IAAI,CA2CN"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA2IA;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA+CjE;AA0ID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAWA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,IAAI,CAwDN"}

package/dist/cli.js

@@ -11,89 +11,107 @@ import {
 } from "node:fs";
 import { join as join2 } from "node:path";
 import { createInterface } from "node:readline";
-
-// src/config.ts
+// node_modules/@momomemory/sdk/dist/plugin-config.js
+import { homedir, hostname } from "node:os";
 import { join } from "node:path";
-import { homedir } from "node:os";
+var OPENCLAW_DEFAULTS = {
+  baseUrl: "http://localhost:3000",
+  containerTag: `oclw_${hostname()}`,
+  perAgentMemory: false,
+  autoRecall: true,
+  autoCapture: true,
+  maxRecallResults: 10,
+  profileFrequency: 50,
+  captureMode: "all",
+  debug: false
+};
+var OPENCODE_CONFIG_DIR = join(homedir(), ".config", "opencode");
+var PI_DEFAULTS = {
+  baseUrl: "http://localhost:3000",
+  containerTag: `pi_${hostname()}`,
+  autoRecall: true,
+  autoCapture: true,
+  maxRecallResults: 10,
+  profileFrequency: 50,
+  debug: false
+};
+// src/config.ts
+function getConfigDir() {
+  const xdg = process.env.XDG_CONFIG_HOME;
+  if (xdg) {
+    return `${xdg}/opencode`;
+  }
+  return `${process.env.HOME}/.config/opencode`;
+}
 
 // src/services/jsonc.ts
-function stripJsoncComments(content) {
-  let result = "";
-  let i = 0;
-  let inString = false;
-  let inSingleLineComment = false;
-  let inMultiLineComment = false;
-  while (i < content.length) {
-    const char = content[i];
-    const nextChar = content[i + 1];
-    if (!inSingleLineComment && !inMultiLineComment) {
-      if (char === '"') {
-        let backslashCount = 0;
-        let j = i - 1;
-        while (j >= 0 && content[j] === "\\") {
-          backslashCount++;
-          j--;
-        }
-        if (backslashCount % 2 === 0) {
-          inString = !inString;
+function stripJsoncComments(input) {
+  var Mode;
+  ((Mode2) => {
+    Mode2[Mode2["Code"] = 0] = "Code";
+    Mode2[Mode2["String"] = 1] = "String";
+    Mode2[Mode2["LineComment"] = 2] = "LineComment";
+    Mode2[Mode2["BlockComment"] = 3] = "BlockComment";
+  })(Mode ||= {});
+  const out = [];
+  let mode = 0 /* Code */;
+  for (let i = 0;i < input.length; i++) {
+    const ch = input[i];
+    const next = input[i + 1];
+    if (mode === 1 /* String */) {
+      out.push(ch);
+      if (ch === "\\") {
+        if (next !== undefined) {
+          out.push(next);
+          i++;
         }
-        result += char;
-        i++;
-        continue;
-      }
-    }
-    if (inString) {
-      result += char;
-      i++;
-      continue;
-    }
-    if (!inSingleLineComment && !inMultiLineComment) {
-      if (char === "/" && nextChar === "/") {
-        inSingleLineComment = true;
-        i += 2;
         continue;
       }
-      if (char === "/" && nextChar === "*") {
-        inMultiLineComment = true;
-        i += 2;
-        continue;
+      if (ch === '"') {
+        mode = 0 /* Code */;
       }
+      continue;
     }
-    if (inSingleLineComment) {
-      if (char === `
+    if (mode === 2 /* LineComment */) {
+      if (ch === `
 `) {
-        inSingleLineComment = false;
-        result += char;
+        mode = 0 /* Code */;
+        out.push(`
+`);
       }
-      i++;
       continue;
     }
-    if (inMultiLineComment) {
-      if (char === "*" && nextChar === "/") {
-        inMultiLineComment = false;
-        i += 2;
+    if (mode === 3 /* BlockComment */) {
+      if (ch === "*" && next === "/") {
+        mode = 0 /* Code */;
+        i++;
         continue;
       }
-      if (char === `
+      if (ch === `
 `) {
-        result += char;
+        out.push(`
+`);
       }
+      continue;
+    }
+    if (ch === '"') {
+      mode = 1 /* String */;
+      out.push(ch);
+      continue;
+    }
+    if (ch === "/" && next === "/") {
+      mode = 2 /* LineComment */;
       i++;
       continue;
     }
-    result += char;
-    i++;
-  }
-  return result.replace(/,\s*([}\]])/g, "$1");
-}
-
-// src/config.ts
-function getConfigDir() {
-  const xdg = process.env.XDG_CONFIG_HOME;
-  if (xdg) {
-    return join(xdg, "opencode");
+    if (ch === "/" && next === "*") {
+      mode = 3 /* BlockComment */;
+      i++;
+      continue;
+    }
+    out.push(ch);
   }
-  return join(homedir(), ".config", "opencode");
+  return out.join("").replace(/,\s*([}\]])/g, "$1");
 }
 
 // src/cli.ts
@@ -157,8 +175,10 @@ bunx @momomemory/opencode-momo configure
 \`\`\`
 
 Or set environment variables:
-- \`MOMO_BASE_URL\` - Momo server URL (default: http://localhost:3000)
-- \`MOMO_API_KEY\` - API key for authentication
+- \`MOMO_OPENCODE_BASE_URL\` - Momo server URL (default: http://localhost:3000)
+- \`MOMO_OPENCODE_API_KEY\` - API key for authentication
+- \`MOMO_OPENCODE_CONTAINER_TAG_USER\` - Optional user container tag override
+- \`MOMO_OPENCODE_CONTAINER_TAG_PROJECT\` - Optional project container tag override
 
 After configuration, restart OpenCode to activate.
 `;
@@ -206,53 +226,186 @@ async function promptInput(question, defaultValue) {
 }
 function registerPluginInConfig(configDir) {
   const configPath = join2(configDir, "opencode.jsonc");
-  if (existsSync(configPath)) {
-    const content = readFileSync(configPath, "utf-8");
-    if (content.includes(PLUGIN_NAME)) {
-      return false;
-    }
-    if (content.includes('"plugin"')) {
-      const newContent = content.replace(/("plugin"\s*:\s*\[)([^\]]*?)(\])/, (_match, start, middle, end) => {
-        const trimmed = middle.trim();
-        if (trimmed === "") {
-          return `${start}
+  if (!existsSync(configPath)) {
+    mkdirSync(configDir, { recursive: true });
+    const newConfig = `{
+  "plugin": [
     "${PLUGIN_NAME}"
-  ${end}`;
-        }
-        return `${start}${middle.trimEnd()},
+  ]
+}
+`;
+    writeFileSync(configPath, newConfig, "utf-8");
+    return true;
+  }
+  const content = readFileSync(configPath, "utf-8");
+  if (content.includes(PLUGIN_NAME)) {
+    return false;
+  }
+  const pluginArrayStart = findPluginArrayStart(content);
+  if (pluginArrayStart !== -1) {
+    const pluginArrayEnd = findMatchingBracket(content, pluginArrayStart);
+    if (pluginArrayEnd !== -1) {
+      const before = content.slice(0, pluginArrayStart + 1);
+      const middle = content.slice(pluginArrayStart + 1, pluginArrayEnd);
+      const after = content.slice(pluginArrayEnd);
+      const middleTrimmed = middle.trim();
+      const appended = middleTrimmed.length === 0 ? `
+    "${PLUGIN_NAME}"
+  ` : `${middle.replace(/\s*$/, "")},
     "${PLUGIN_NAME}"
-  ${end}`;
-      });
-      writeFileSync(configPath, newContent, "utf-8");
+  `;
+      writeFileSync(configPath, `${before}${appended}${after}`, "utf-8");
       return true;
     }
-    const beforeBrace = content.trimEnd().slice(0, -1).trimEnd();
-    if (beforeBrace.endsWith(",") || beforeBrace.endsWith("{")) {
-      const insertContent = content.replace(/\}\s*$/, `  "plugin": [
-    "${PLUGIN_NAME}"
-  ]
-}`);
-      writeFileSync(configPath, insertContent, "utf-8");
-    } else {
-      const withComma = content.replace(/(\S)\s*\}\s*$/, `$1,
+  }
+  const rootClose = findRootObjectClose(content);
+  if (rootClose === -1) {
+    const rebuilt = `{
   "plugin": [
     "${PLUGIN_NAME}"
   ]
-}`);
-      writeFileSync(configPath, withComma, "utf-8");
-    }
+}
+`;
+    writeFileSync(configPath, rebuilt, "utf-8");
     return true;
   }
-  mkdirSync(configDir, { recursive: true });
-  const newConfig = `{
+  const head = content.slice(0, rootClose).replace(/\s*$/, "");
+  const needsComma = !head.endsWith("{") && !head.endsWith(",");
+  const insertion = `${needsComma ? "," : ""}
   "plugin": [
     "${PLUGIN_NAME}"
   ]
-}
 `;
-  writeFileSync(configPath, newConfig, "utf-8");
+  const tail = content.slice(rootClose);
+  writeFileSync(configPath, `${head}${insertion}${tail}`, "utf-8");
   return true;
 }
+function findPluginArrayStart(content) {
+  const keyMatch = /"plugin"\s*:/.exec(content);
+  if (!keyMatch)
+    return -1;
+  const start = keyMatch.index + keyMatch[0].length;
+  for (let i = start;i < content.length; i++) {
+    const ch = content[i];
+    if (!ch || /\s/.test(ch))
+      continue;
+    return ch === "[" ? i : -1;
+  }
+  return -1;
+}
+function findMatchingBracket(content, openIndex) {
+  let depth = 0;
+  let inString = false;
+  let inLineComment = false;
+  let inBlockComment = false;
+  for (let i = openIndex;i < content.length; i++) {
+    const ch = content[i];
+    const next = content[i + 1];
+    if (inLineComment) {
+      if (ch === `
+`)
+        inLineComment = false;
+      continue;
+    }
+    if (inBlockComment) {
+      if (ch === "*" && next === "/") {
+        inBlockComment = false;
+        i++;
+      }
+      continue;
+    }
+    if (inString) {
+      if (ch === "\\") {
+        i++;
+        continue;
+      }
+      if (ch === '"')
+        inString = false;
+      continue;
+    }
+    if (ch === '"') {
+      inString = true;
+      continue;
+    }
+    if (ch === "/" && next === "/") {
+      inLineComment = true;
+      i++;
+      continue;
+    }
+    if (ch === "/" && next === "*") {
+      inBlockComment = true;
+      i++;
+      continue;
+    }
+    if (ch === "[") {
+      depth++;
+      continue;
+    }
+    if (ch === "]") {
+      depth--;
+      if (depth === 0)
+        return i;
+    }
+  }
+  return -1;
+}
+function findRootObjectClose(content) {
+  let depth = 0;
+  let inString = false;
+  let inLineComment = false;
+  let inBlockComment = false;
+  let rootClose = -1;
+  for (let i = 0;i < content.length; i++) {
+    const ch = content[i];
+    const next = content[i + 1];
+    if (inLineComment) {
+      if (ch === `
+`)
+        inLineComment = false;
+      continue;
+    }
+    if (inBlockComment) {
+      if (ch === "*" && next === "/") {
+        inBlockComment = false;
+        i++;
+      }
+      continue;
+    }
+    if (inString) {
+      if (ch === "\\") {
+        i++;
+        continue;
+      }
+      if (ch === '"')
+        inString = false;
+      continue;
+    }
+    if (ch === '"') {
+      inString = true;
+      continue;
+    }
+    if (ch === "/" && next === "/") {
+      inLineComment = true;
+      i++;
+      continue;
+    }
+    if (ch === "/" && next === "*") {
+      inBlockComment = true;
+      i++;
+      continue;
+    }
+    if (ch === "{") {
+      depth++;
+      continue;
+    }
+    if (ch === "}") {
+      depth--;
+      if (depth === 0)
+        rootClose = i;
+    }
+  }
+  return rootClose;
+}
 function writeCommandFiles(configDir) {
   const commandDir = join2(configDir, "command");
   mkdirSync(commandDir, { recursive: true });
@@ -275,10 +428,11 @@ function writeMomoConfig(configDir, options) {
       existing = {};
     }
   }
-  const priorBaseUrl = typeof existing.baseUrl === "string" ? existing.baseUrl : undefined;
-  const priorApiKey = typeof existing.apiKey === "string" ? existing.apiKey : undefined;
-  const priorContainerTagUser = typeof existing.containerTagUser === "string" ? existing.containerTagUser : undefined;
-  const priorContainerTagProject = typeof existing.containerTagProject === "string" ? existing.containerTagProject : undefined;
+  const existingOpenCode = existing.opencode && typeof existing.opencode === "object" && !Array.isArray(existing.opencode) ? existing.opencode : {};
+  const priorBaseUrl = typeof existingOpenCode.baseUrl === "string" ? existingOpenCode.baseUrl : undefined;
+  const priorApiKey = typeof existingOpenCode.apiKey === "string" ? existingOpenCode.apiKey : undefined;
+  const priorContainerTagUser = typeof existingOpenCode.containerTagUser === "string" ? existingOpenCode.containerTagUser : undefined;
+  const priorContainerTagProject = typeof existingOpenCode.containerTagProject === "string" ? existingOpenCode.containerTagProject : undefined;
   const config = {
     baseUrl: options.baseUrl ?? priorBaseUrl ?? "http://localhost:3000",
     apiKey: options.apiKey ?? priorApiKey ?? "",
@@ -286,14 +440,19 @@ function writeMomoConfig(configDir, options) {
     containerTagProject: priorContainerTagProject ?? ""
   };
   const lines = ["{"];
-  lines.push("  // Momo server URL");
-  lines.push(`  "baseUrl": ${JSON.stringify(config.baseUrl)},`);
-  lines.push("  // API key for authentication (leave empty if your server has auth disabled)");
-  lines.push(`  "apiKey": ${JSON.stringify(config.apiKey)},`);
-  lines.push("  // Optional override for user memory container tag (default: auto-derived from username)");
-  lines.push(`  "containerTagUser": ${JSON.stringify(config.containerTagUser)},`);
-  lines.push("  // Optional override for project memory container tag (default: auto-derived from project directory)");
-  lines.push(`  "containerTagProject": ${JSON.stringify(config.containerTagProject)}`);
+  lines.push("  // OpenCode plugin config for Momo");
+  lines.push('  "opencode": {');
+  lines.push("    // Momo server URL (default: http://localhost:3000)");
+  lines.push(`    "baseUrl": ${JSON.stringify(config.baseUrl)},`);
+  lines.push("    // API key for authentication (leave empty if your server has auth disabled)");
+  lines.push(`    "apiKey": ${JSON.stringify(config.apiKey)},`);
+  lines.push("    // Optional override for user memory container tag (default: auto-derived from username)");
+  lines.push(`    "containerTagUser": ${JSON.stringify(config.containerTagUser)},`);
+  lines.push("    // Optional override for project memory container tag (default: auto-derived from project directory)");
+  lines.push(`    "containerTagProject": ${JSON.stringify(config.containerTagProject)}`);
+  lines.push("  }");
+  lines.push("  // Note: project-local config file (.momo.jsonc) overrides this global file,");
+  lines.push("  // and MOMO_OPENCODE_* environment variables override both.");
   lines.push("}");
   lines.push("");
   writeFileSync(configPath, lines.join(`
@@ -331,6 +490,14 @@ async function runInstall(flags) {
   writeCommandFiles(configDir);
   console.log(`  ✓ Created ${join2(configDir, "command", "momo-init.md")}`);
   console.log(`  ✓ Created ${join2(configDir, "command", "momo-configure.md")}`);
+  const momoConfigPath = join2(configDir, "momo.jsonc");
+  const hadMomoConfig = existsSync(momoConfigPath);
+  writeMomoConfig(configDir, {});
+  if (hadMomoConfig) {
+    console.log(`  ✓ Updated ${momoConfigPath}`);
+  } else {
+    console.log(`  ✓ Created ${momoConfigPath}`);
+  }
   console.log(`
 ✅ Installation complete!
 
@@ -339,8 +506,8 @@ Next steps:
      $ opencode-momo configure --base-url http://localhost:3000 --api-key YOUR_KEY
 
      Or set environment variables:
-     $ export MOMO_API_KEY=your-key
-     $ export MOMO_BASE_URL=http://localhost:3000
+     $ export MOMO_OPENCODE_API_KEY=your-key
+     $ export MOMO_OPENCODE_BASE_URL=http://localhost:3000
 
   2. Restart OpenCode to activate the plugin.
 
@@ -375,7 +542,7 @@ async function runConfigure(flags) {
 Restart OpenCode to apply changes.`);
 }
 function printHelp() {
-  console.log(`opencode-momo v0.1.2
+  console.log(`opencode-momo v0.1.3
 
 OpenCode plugin that gives coding agents persistent memory using Momo.
 

package/dist/config.d.ts

@@ -1,10 +1,9 @@
-export interface MomoConfig {
-    apiKey?: string;
+import { type ResolvedOpenCodePluginConfig } from "@momomemory/sdk";
+export type { ResolvedOpenCodePluginConfig };
+export type MomoConfig = ResolvedOpenCodePluginConfig & {
     baseUrl: string;
-    containerTagUser?: string;
-    containerTagProject?: string;
-}
+};
 export declare function getConfigDir(): string;
-export declare function loadConfig(): MomoConfig;
-export declare function isConfigured(): boolean;
+export declare function loadConfig(directory?: string): MomoConfig;
+export declare function isConfigured(directory?: string): boolean;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAWD,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAaD,wBAAgB,UAAU,IAAI,UAAU,CAYvC;AAED,wBAAgB,YAAY,IAAI,OAAO,CAGtC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE9F,YAAY,EAAE,4BAA4B,EAAE,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG,4BAA4B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAMzD;AAED,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAGxD"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AAoC/D,eAAO,MAAM,UAAU,EAAE,MAmSxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AAuG/D,eAAO,MAAM,UAAU,EAAE,MAqpBxB,CAAC"}