opencode-supermemory 0.1.1 → 0.1.3

package/README.md

@@ -2,45 +2,123 @@
 
 OpenCode plugin for persistent memory using [Supermemory](https://supermemory.ai).
 
+Your agent remembers what you tell it - across sessions, across projects.
+
 ## Installation
 
+### For Humans
+
 ```bash
-npx opencode-supermemory setup
+bunx opencode-supermemory@latest install
+```
+
+Then get your API key from [console.supermemory.ai](https://console.supermemory.ai) and set it:
+
+```bash
+export SUPERMEMORY_API_KEY="sm_..."
+```
+
+**Or let your agent do it** - paste this into OpenCode:
+```
+Install opencode-supermemory by following https://raw.githubusercontent.com/supermemoryai/opencode-supermemory/main/README.md
 ```
 
-Interactive wizard that:
-1. Installs plugin globally
-2. Creates `/supermemory-init` command
-3. Adds plugin to OpenCode config
+### For LLM Agents
+
+<details>
+<summary>Instructions for LLM Agents (click to expand)</summary>
+
+If you're an LLM agent helping set up opencode-supermemory, follow these steps:
 
-Then set your API key:
+#### Step 1: Run the installer
 
 ```bash
-# Add to your shell profile (.zshrc, .bashrc, etc.)
-echo 'export SUPERMEMORY_API_KEY="your-api-key"' >> ~/.zshrc
-source ~/.zshrc
+bunx opencode-supermemory@latest install --no-tui
+```
+
+This will:
+- Register the plugin in `~/.config/opencode/opencode.jsonc`
+- Create the `/supermemory-init` command
+
+#### Step 2: Verify the config
 
-# Or set temporarily for current session
-export SUPERMEMORY_API_KEY="your-api-key"  # from console.supermemory.ai
+```bash
+cat ~/.config/opencode/opencode.jsonc
+```
+
+Should contain:
+```json
+{
+  "plugin": ["opencode-supermemory"]
+}
 ```
 
-Make sure `~/.config/opencode/opencode.json` contains the plugin:
+If not, add it manually:
 
+**JSONC:**
+```jsonc
+{
+  "plugin": [
+    "opencode-supermemory"
+    // ... other plugins
+  ]
+}
+```
+
+**JSON:**
 ```json
 {
   "plugin": ["opencode-supermemory"]
 }
 ```
 
+#### Step 3: Configure API key
+
+Ask the user to get their API key from [console.supermemory.ai](https://console.supermemory.ai).
+
+Then set it via environment variable:
+
+```bash
+export SUPERMEMORY_API_KEY="sm_..."
+```
+
+Or create `~/.config/opencode/supermemory.jsonc`:
+
+```jsonc
+{
+  "apiKey": "sm_..."
+}
+```
+
+#### Step 4: Verify setup
+
+Tell the user to restart OpenCode and run:
+
+```bash
+opencode -c
+```
+
+They should see `supermemory` in the tools list. If not, check:
+1. Is `SUPERMEMORY_API_KEY` set?
+2. Is the plugin in `opencode.jsonc`?
+3. Check logs: `tail ~/.opencode-supermemory.log`
+
+#### Step 5: Initialize codebase memory (optional)
+
+Run `/supermemory-init` to have the agent explore and memorize the codebase.
+
+</details>
+
 ## Features
 
 ### Context Injection
 
-On first message, injects:
+On first message, the agent receives (invisible to user):
 - User profile (cross-project preferences)
 - Project memories (all project knowledge)
 - Relevant user memories (semantic search)
 
+Example of what the agent sees:
 ```
 [SUPERMEMORY]
 
@@ -56,6 +134,8 @@ Relevant Memories:
 - [82%] Build fails if .env.local missing
 ```
 
+The agent uses this context automatically - no manual prompting needed.
+
 ### Keyword Detection
 
 Say "remember", "save this", "don't forget" etc. and the agent auto-saves to memory.
@@ -134,17 +214,12 @@ Create `~/.config/opencode/supermemory.jsonc`:
   "injectProfile": true,
   
   // Prefix for container tags
-  "containerTagPrefix": "opencode",
-  
-  // LLM filter prompt for memory relevance
-  "filterPrompt": "You are a stateful coding agent. Remember all the information, including but not limited to user's coding preferences, tech stack, behaviours, workflows, and any other relevant details."
+  "containerTagPrefix": "opencode"
 }
 ```
 
 All fields optional. Env var `SUPERMEMORY_API_KEY` takes precedence over config file.
 
-API timeout: 30s
-
 ## Usage with Oh My OpenCode
 
 If you're using [Oh My OpenCode](https://github.com/code-yeongyu/oh-my-opencode), disable its built-in auto-compact hook to let supermemory handle context compaction:
@@ -157,14 +232,6 @@ Add to `~/.config/opencode/oh-my-opencode.json`:
 }
 ```
 
-This ensures supermemory's preemptive compaction (which preserves memories across sessions) works correctly instead of oh-my-opencode's default compaction.
-
-## Hooks
-
-Registered in `package.json`:
-- `chat.message` - Context injection on first message, keyword detection
-- `event` - Compaction monitoring and summary capture
-
 ## Development
 
 ```bash

package/dist/cli.js

@@ -1,22 +1,4 @@
 #!/usr/bin/env node
-import { createRequire } from "node:module";
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/cli.ts
 import { mkdirSync, writeFileSync, readFileSync, existsSync } from "node:fs";
@@ -25,6 +7,7 @@ import { homedir } from "node:os";
 import * as readline from "node:readline";
 var OPENCODE_CONFIG_DIR = join(homedir(), ".config", "opencode");
 var OPENCODE_COMMAND_DIR = join(OPENCODE_CONFIG_DIR, "command");
+var OH_MY_OPENCODE_CONFIG = join(OPENCODE_CONFIG_DIR, "oh-my-opencode.json");
 var PLUGIN_NAME = "opencode-supermemory@latest";
 var SUPERMEMORY_INIT_COMMAND = `---
 description: Initialize Supermemory with comprehensive codebase knowledge
@@ -190,42 +173,10 @@ async function confirm(rl, question) {
     });
   });
 }
-async function installPlugin() {
-  const { execSync } = await import("node:child_process");
-  let pm = "npm";
-  try {
-    execSync("bun --version", { stdio: "ignore" });
-    pm = "bun";
-  } catch {
-    try {
-      execSync("pnpm --version", { stdio: "ignore" });
-      pm = "pnpm";
-    } catch {}
-  }
-  console.log(`Installing ${PLUGIN_NAME} with ${pm}...`);
-  try {
-    execSync(`${pm} install -g ${PLUGIN_NAME}`, { stdio: "inherit" });
-    return true;
-  } catch {
-    console.error("Failed to install plugin globally.");
-    return false;
-  }
-}
-function createCommand() {
-  mkdirSync(OPENCODE_COMMAND_DIR, { recursive: true });
-  const commandPath = join(OPENCODE_COMMAND_DIR, "supermemory-init.md");
-  if (existsSync(commandPath)) {
-    console.log(`Command already exists at ${commandPath}`);
-    return true;
-  }
-  writeFileSync(commandPath, SUPERMEMORY_INIT_COMMAND);
-  console.log(`Created /supermemory-init command`);
-  return true;
-}
 function findOpencodeConfig() {
   const candidates = [
-    join(OPENCODE_CONFIG_DIR, "config.jsonc"),
-    join(OPENCODE_CONFIG_DIR, "config.json")
+    join(OPENCODE_CONFIG_DIR, "opencode.jsonc"),
+    join(OPENCODE_CONFIG_DIR, "opencode.json")
   ];
   for (const path of candidates) {
     if (existsSync(path)) {
@@ -238,7 +189,7 @@ function addPluginToConfig(configPath) {
   try {
     const content = readFileSync(configPath, "utf-8");
     if (content.includes("opencode-supermemory")) {
-      console.log("Plugin already in config");
+      console.log("✓ Plugin already registered in config");
       return true;
     }
     const jsonContent = content.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
@@ -246,7 +197,7 @@ function addPluginToConfig(configPath) {
     try {
       config = JSON.parse(jsonContent);
     } catch {
-      console.error("Failed to parse config file");
+      console.error("✗ Failed to parse config file");
       return false;
     }
     const plugins = config.plugin || [];
@@ -274,91 +225,193 @@ function addPluginToConfig(configPath) {
     } else {
       writeFileSync(configPath, JSON.stringify(config, null, 2));
     }
-    console.log(`Added ${PLUGIN_NAME} to ${configPath}`);
+    console.log(`✓ Added plugin to ${configPath}`);
     return true;
   } catch (err) {
-    console.error("Failed to update config:", err);
+    console.error("✗ Failed to update config:", err);
     return false;
   }
 }
 function createNewConfig() {
-  const configPath = join(OPENCODE_CONFIG_DIR, "config.jsonc");
+  const configPath = join(OPENCODE_CONFIG_DIR, "opencode.jsonc");
   mkdirSync(OPENCODE_CONFIG_DIR, { recursive: true });
-  const config = {
-    plugin: [PLUGIN_NAME]
-  };
-  writeFileSync(configPath, JSON.stringify(config, null, 2));
-  console.log(`Created ${configPath} with plugin registered`);
+  const config = `{
+  "plugin": ["${PLUGIN_NAME}"]
+}
+`;
+  writeFileSync(configPath, config);
+  console.log(`✓ Created ${configPath}`);
   return true;
 }
-async function setup() {
-  const rl = createReadline();
-  console.log(`
-opencode-supermemory setup
-`);
-  const shouldInstall = await confirm(rl, "Install opencode-supermemory globally?");
-  if (!shouldInstall) {
-    console.log("Aborted.");
-    rl.close();
-    process.exit(0);
+function createCommand() {
+  mkdirSync(OPENCODE_COMMAND_DIR, { recursive: true });
+  const commandPath = join(OPENCODE_COMMAND_DIR, "supermemory-init.md");
+  writeFileSync(commandPath, SUPERMEMORY_INIT_COMMAND);
+  console.log(`✓ Created /supermemory-init command`);
+  return true;
+}
+function isOhMyOpencodeInstalled() {
+  const configPath = findOpencodeConfig();
+  if (!configPath)
+    return false;
+  try {
+    const content = readFileSync(configPath, "utf-8");
+    return content.includes("oh-my-opencode");
+  } catch {
+    return false;
   }
-  const installed = await installPlugin();
-  if (!installed) {
-    console.log("Aborted.");
-    rl.close();
-    process.exit(1);
+}
+function isAutoCompactAlreadyDisabled() {
+  if (!existsSync(OH_MY_OPENCODE_CONFIG))
+    return false;
+  try {
+    const content = readFileSync(OH_MY_OPENCODE_CONFIG, "utf-8");
+    const config = JSON.parse(content);
+    const disabledHooks = config.disabled_hooks;
+    return disabledHooks?.includes("anthropic-auto-compact") ?? false;
+  } catch {
+    return false;
   }
-  const shouldCreateCommand = await confirm(rl, "Add /supermemory-init command?");
-  if (!shouldCreateCommand) {
-    console.log("Aborted.");
-    rl.close();
-    process.exit(0);
+}
+function disableAutoCompactHook() {
+  try {
+    let config = {};
+    if (existsSync(OH_MY_OPENCODE_CONFIG)) {
+      const content = readFileSync(OH_MY_OPENCODE_CONFIG, "utf-8");
+      config = JSON.parse(content);
+    }
+    const disabledHooks = config.disabled_hooks || [];
+    if (!disabledHooks.includes("anthropic-auto-compact")) {
+      disabledHooks.push("anthropic-auto-compact");
+    }
+    config.disabled_hooks = disabledHooks;
+    writeFileSync(OH_MY_OPENCODE_CONFIG, JSON.stringify(config, null, 2));
+    console.log(`✓ Disabled anthropic-auto-compact hook in oh-my-opencode.json`);
+    return true;
+  } catch (err) {
+    console.error("✗ Failed to update oh-my-opencode.json:", err);
+    return false;
   }
-  createCommand();
+}
+async function install(options) {
+  console.log(`
+\uD83E\uDDE0 opencode-supermemory installer
+`);
+  const rl = options.tui ? createReadline() : null;
+  console.log("Step 1: Register plugin in OpenCode config");
   const configPath = findOpencodeConfig();
   if (configPath) {
-    const shouldModifyConfig = await confirm(rl, `Add plugin to ${configPath}?`);
-    if (!shouldModifyConfig) {
-      console.log("Aborted.");
-      rl.close();
-      process.exit(0);
+    if (options.tui) {
+      const shouldModify = await confirm(rl, `Add plugin to ${configPath}?`);
+      if (!shouldModify) {
+        console.log("Skipped.");
+      } else {
+        addPluginToConfig(configPath);
+      }
+    } else {
+      addPluginToConfig(configPath);
     }
-    addPluginToConfig(configPath);
   } else {
-    const shouldCreateConfig = await confirm(rl, "No OpenCode config found. Create one?");
-    if (!shouldCreateConfig) {
-      console.log("Aborted.");
-      rl.close();
-      process.exit(0);
+    if (options.tui) {
+      const shouldCreate = await confirm(rl, "No OpenCode config found. Create one?");
+      if (!shouldCreate) {
+        console.log("Skipped.");
+      } else {
+        createNewConfig();
+      }
+    } else {
+      createNewConfig();
     }
-    createNewConfig();
   }
   console.log(`
-Setup complete!`);
-  console.log("Set SUPERMEMORY_API_KEY and restart OpenCode.");
-  rl.close();
+Step 2: Create /supermemory-init command`);
+  if (options.tui) {
+    const shouldCreate = await confirm(rl, "Add /supermemory-init command?");
+    if (!shouldCreate) {
+      console.log("Skipped.");
+    } else {
+      createCommand();
+    }
+  } else {
+    createCommand();
+  }
+  if (isOhMyOpencodeInstalled()) {
+    console.log(`
+Step 3: Configure Oh My OpenCode`);
+    console.log("Detected Oh My OpenCode plugin.");
+    console.log("Supermemory handles context compaction, so the built-in auto-compact hook should be disabled.");
+    if (isAutoCompactAlreadyDisabled()) {
+      console.log("✓ anthropic-auto-compact hook already disabled");
+    } else {
+      if (options.tui) {
+        const shouldDisable = await confirm(rl, "Disable anthropic-auto-compact hook to let Supermemory handle context?");
+        if (!shouldDisable) {
+          console.log("Skipped.");
+        } else {
+          disableAutoCompactHook();
+        }
+      } else if (options.disableAutoCompact) {
+        disableAutoCompactHook();
+      } else {
+        console.log("Skipped. Use --disable-auto-compact to disable the hook in non-interactive mode.");
+      }
+    }
+  }
+  console.log(`
+` + "─".repeat(50));
+  console.log(`
+\uD83D\uDD11 Final step: Set your API key
+`);
+  console.log("Get your API key from: https://console.supermemory.ai");
+  console.log(`
+Then add to your shell profile:
+`);
+  console.log('  export SUPERMEMORY_API_KEY="sm_..."');
+  console.log(`
+Or create ~/.config/opencode/supermemory.jsonc:
+`);
+  console.log('  { "apiKey": "sm_..." }');
+  console.log(`
+` + "─".repeat(50));
+  console.log(`
+✓ Setup complete! Restart OpenCode to activate.
+`);
+  if (rl)
+    rl.close();
+  return 0;
 }
 function printHelp() {
   console.log(`
-opencode-supermemory CLI
+opencode-supermemory - Persistent memory for OpenCode agents
 
 Commands:
-  setup    Interactive setup wizard
+  install                    Install and configure the plugin
+    --no-tui                 Run in non-interactive mode (for LLM agents)
+    --disable-auto-compact   Disable Oh My OpenCode's auto-compact hook (use with --no-tui)
 
 Examples:
-  npx opencode-supermemory setup
-  bunx opencode-supermemory setup
+  bunx opencode-supermemory@latest install
+  bunx opencode-supermemory@latest install --no-tui
+  bunx opencode-supermemory@latest install --no-tui --disable-auto-compact
 `);
 }
 var args = process.argv.slice(2);
-if (args.length === 0 || args[0] === "help" || args[0] === "--help") {
+if (args.length === 0 || args[0] === "help" || args[0] === "--help" || args[0] === "-h") {
   printHelp();
   process.exit(0);
 }
-if (args[0] === "setup") {
-  setup();
+if (args[0] === "install") {
+  const noTui = args.includes("--no-tui");
+  const disableAutoCompact = args.includes("--disable-auto-compact");
+  install({ tui: !noTui, disableAutoCompact }).then((code) => process.exit(code));
+} else if (args[0] === "setup") {
+  console.log(`Note: 'setup' is deprecated. Use 'install' instead.
+`);
+  const noTui = args.includes("--no-tui");
+  const disableAutoCompact = args.includes("--disable-auto-compact");
+  install({ tui: !noTui, disableAutoCompact }).then((code) => process.exit(code));
 } else {
-  console.error(`Unknown command: ${args.join(" ")}`);
+  console.error(`Unknown command: ${args[0]}`);
   printHelp();
   process.exit(1);
 }

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;AAuC/D,eAAO,MAAM,iBAAiB,EAAE,MA6Y/B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AAuC/D,eAAO,MAAM,iBAAiB,EAAE,MAwa/B,CAAC"}

package/dist/index.js

@@ -13698,11 +13698,11 @@ class SupermemoryClient {
         searchMode: "hybrid"
       }), TIMEOUT_MS);
       log("searchMemories: success", { count: result.results?.length || 0 });
-      return result;
+      return { success: true, ...result };
     } catch (error45) {
-      log("searchMemories: error", { error: String(error45) });
-      console.error("Supermemory: search failed", error45);
-      return { results: [], total: 0, timing: 0 };
+      const errorMessage = error45 instanceof Error ? error45.message : String(error45);
+      log("searchMemories: error", { error: errorMessage });
+      return { success: false, error: errorMessage, results: [], total: 0, timing: 0 };
     }
   }
   async getProfile(containerTag, query) {
@@ -13713,34 +13713,39 @@ class SupermemoryClient {
         q: query
       }), TIMEOUT_MS);
       log("getProfile: success", { hasProfile: !!result?.profile });
-      return result;
+      return { success: true, ...result };
     } catch (error45) {
-      log("getProfile: error", { error: String(error45) });
-      console.error("Supermemory: profile fetch failed", error45);
-      return null;
+      const errorMessage = error45 instanceof Error ? error45.message : String(error45);
+      log("getProfile: error", { error: errorMessage });
+      return { success: false, error: errorMessage, profile: null };
     }
   }
   async addMemory(content, containerTag, metadata) {
+    log("addMemory: start", { containerTag, contentLength: content.length });
     try {
-      return await withTimeout(this.getClient().memories.add({
+      const result = await withTimeout(this.getClient().memories.add({
         content,
         containerTag,
         metadata
       }), TIMEOUT_MS);
+      log("addMemory: success", { id: result.id });
+      return { success: true, ...result };
     } catch (error45) {
-      console.error("Supermemory: add memory failed", error45);
-      return null;
+      const errorMessage = error45 instanceof Error ? error45.message : String(error45);
+      log("addMemory: error", { error: errorMessage });
+      return { success: false, error: errorMessage };
     }
   }
-  async forgetMemory(containerTag, memoryId) {
+  async deleteMemory(memoryId) {
+    log("deleteMemory: start", { memoryId });
     try {
-      return await withTimeout(this.getClient().memories.forget({
-        containerTag,
-        id: memoryId
-      }), TIMEOUT_MS);
+      await withTimeout(this.getClient().memories.delete(memoryId), TIMEOUT_MS);
+      log("deleteMemory: success", { memoryId });
+      return { success: true };
     } catch (error45) {
-      console.error("Supermemory: forget memory failed", error45);
-      return null;
+      const errorMessage = error45 instanceof Error ? error45.message : String(error45);
+      log("deleteMemory: error", { memoryId, error: errorMessage });
+      return { success: false, error: errorMessage };
     }
   }
   async listMemories(containerTag, limit = 20) {
@@ -13753,11 +13758,11 @@ class SupermemoryClient {
         sort: "createdAt"
       }), TIMEOUT_MS);
       log("listMemories: success", { count: result.memories?.length || 0 });
-      return result;
+      return { success: true, ...result };
     } catch (error45) {
-      log("listMemories: error", { error: String(error45) });
-      console.error("Supermemory: list memories failed", error45);
-      return { memories: [], pagination: { currentPage: 1, totalItems: 0, totalPages: 0 } };
+      const errorMessage = error45 instanceof Error ? error45.message : String(error45);
+      log("listMemories: error", { error: errorMessage });
+      return { success: false, error: errorMessage, memories: [], pagination: { currentPage: 1, totalItems: 0, totalPages: 0 } };
     }
   }
   async ingestConversation(conversationId, messages, containerTags, metadata) {
@@ -13779,15 +13784,15 @@ class SupermemoryClient {
       if (!response.ok) {
         const errorText = await response.text();
         log("ingestConversation: error response", { status: response.status, error: errorText });
-        return null;
+        return { success: false, error: `HTTP ${response.status}: ${errorText}` };
       }
       const result = await response.json();
       log("ingestConversation: success", { conversationId, status: result.status });
-      return result;
+      return { success: true, ...result };
     } catch (error45) {
-      log("ingestConversation: error", { error: String(error45) });
-      console.error("Supermemory: ingest conversation failed", error45);
-      return null;
+      const errorMessage = error45 instanceof Error ? error45.message : String(error45);
+      log("ingestConversation: error", { error: errorMessage });
+      return { success: false, error: errorMessage };
     }
   }
 }
@@ -14077,8 +14082,10 @@ function createCompactionHook(ctx, tags, options) {
     try {
       const result = await supermemoryClient.addMemory(`[Session Summary]
 ${summaryContent}`, tags.project, { type: "conversation" });
-      if (result) {
+      if (result.success) {
         log("[compaction] summary saved as memory", { sessionID, memoryId: result.id });
+      } else {
+        log("[compaction] failed to save summary", { error: result.error });
       }
     } catch (err) {
       log("[compaction] failed to save summary", { error: String(err) });
@@ -14331,20 +14338,23 @@ var SupermemoryPlugin = async (ctx) => {
         const isFirstMessage = !injectedSessions.has(input.sessionID);
         if (isFirstMessage) {
           injectedSessions.add(input.sessionID);
-          const [profile, userMemories, projectMemoriesList] = await Promise.all([
+          const [profileResult, userMemoriesResult, projectMemoriesListResult] = await Promise.all([
             supermemoryClient.getProfile(tags.user, userMessage),
             supermemoryClient.searchMemories(userMessage, tags.user),
             supermemoryClient.listMemories(tags.project, CONFIG.maxProjectMemories)
           ]);
+          const profile = profileResult.success ? profileResult : null;
+          const userMemories = userMemoriesResult.success ? userMemoriesResult : { results: [] };
+          const projectMemoriesList = projectMemoriesListResult.success ? projectMemoriesListResult : { memories: [] };
           const projectMemories = {
-            results: (projectMemoriesList?.memories || []).map((m) => ({
+            results: (projectMemoriesList.memories || []).map((m) => ({
               id: m.id,
               memory: m.summary,
               similarity: 1,
               title: m.title,
               metadata: m.metadata
             })),
-            total: projectMemoriesList?.memories?.length || 0,
+            total: projectMemoriesList.memories?.length || 0,
             timing: 0
           };
           const memoryContext = formatContextForPrompt(profile, userMemories, projectMemories);
@@ -14460,10 +14470,10 @@ var SupermemoryPlugin = async (ctx) => {
                 const scope = args.scope || "project";
                 const containerTag = scope === "user" ? tags.user : tags.project;
                 const result = await supermemoryClient.addMemory(sanitizedContent, containerTag, { type: args.type });
-                if (!result) {
+                if (!result.success) {
                   return JSON.stringify({
                     success: false,
-                    error: "Failed to add memory"
+                    error: result.error || "Failed to add memory"
                   });
                 }
                 return JSON.stringify({
@@ -14483,23 +14493,41 @@ var SupermemoryPlugin = async (ctx) => {
                 }
                 const scope = args.scope;
                 if (scope === "user") {
-                  const results = await supermemoryClient.searchMemories(args.query, tags.user);
-                  return formatSearchResults(args.query, scope, results, args.limit);
+                  const result = await supermemoryClient.searchMemories(args.query, tags.user);
+                  if (!result.success) {
+                    return JSON.stringify({
+                      success: false,
+                      error: result.error || "Failed to search memories"
+                    });
+                  }
+                  return formatSearchResults(args.query, scope, result, args.limit);
                 }
                 if (scope === "project") {
-                  const results = await supermemoryClient.searchMemories(args.query, tags.project);
-                  return formatSearchResults(args.query, scope, results, args.limit);
+                  const result = await supermemoryClient.searchMemories(args.query, tags.project);
+                  if (!result.success) {
+                    return JSON.stringify({
+                      success: false,
+                      error: result.error || "Failed to search memories"
+                    });
+                  }
+                  return formatSearchResults(args.query, scope, result, args.limit);
                 }
-                const [userResults, projectResults] = await Promise.all([
+                const [userResult, projectResult] = await Promise.all([
                   supermemoryClient.searchMemories(args.query, tags.user),
                   supermemoryClient.searchMemories(args.query, tags.project)
                 ]);
+                if (!userResult.success || !projectResult.success) {
+                  return JSON.stringify({
+                    success: false,
+                    error: userResult.error || projectResult.error || "Failed to search memories"
+                  });
+                }
                 const combined = [
-                  ...(userResults.results || []).map((r) => ({
+                  ...(userResult.results || []).map((r) => ({
                     ...r,
                     scope: "user"
                   })),
-                  ...(projectResults.results || []).map((r) => ({
+                  ...(projectResult.results || []).map((r) => ({
                     ...r,
                     scope: "project"
                   }))
@@ -14517,18 +14545,18 @@ var SupermemoryPlugin = async (ctx) => {
                 });
               }
               case "profile": {
-                const profile = await supermemoryClient.getProfile(tags.user, args.query);
-                if (!profile) {
+                const result = await supermemoryClient.getProfile(tags.user, args.query);
+                if (!result.success) {
                   return JSON.stringify({
                     success: false,
-                    error: "Failed to fetch profile"
+                    error: result.error || "Failed to fetch profile"
                   });
                 }
                 return JSON.stringify({
                   success: true,
                   profile: {
-                    static: profile.profile?.static || [],
-                    dynamic: profile.profile?.dynamic || []
+                    static: result.profile?.static || [],
+                    dynamic: result.profile?.dynamic || []
                   }
                 });
               }
@@ -14537,6 +14565,12 @@ var SupermemoryPlugin = async (ctx) => {
                 const limit = args.limit || 20;
                 const containerTag = scope === "user" ? tags.user : tags.project;
                 const result = await supermemoryClient.listMemories(containerTag, limit);
+                if (!result.success) {
+                  return JSON.stringify({
+                    success: false,
+                    error: result.error || "Failed to list memories"
+                  });
+                }
                 const memories = result.memories || [];
                 return JSON.stringify({
                   success: true,
@@ -14558,12 +14592,11 @@ var SupermemoryPlugin = async (ctx) => {
                   });
                 }
                 const scope = args.scope || "project";
-                const containerTag = scope === "user" ? tags.user : tags.project;
-                const result = await supermemoryClient.forgetMemory(containerTag, args.memoryId);
-                if (!result) {
+                const result = await supermemoryClient.deleteMemory(args.memoryId);
+                if (!result.success) {
                   return JSON.stringify({
                     success: false,
-                    error: "Failed to forget memory"
+                    error: result.error || "Failed to delete memory"
                   });
                 }
                 return JSON.stringify({

package/dist/services/client.d.ts

@@ -1,18 +1,76 @@
 import Supermemory from "supermemory";
-import type { MemoryType, ConversationMessage, ConversationIngestResponse } from "../types/index.js";
+import type { MemoryType, ConversationMessage } from "../types/index.js";
 export declare class SupermemoryClient {
     private client;
     private getClient;
-    searchMemories(query: string, containerTag: string): Promise<Supermemory.Search.SearchMemoriesResponse>;
-    getProfile(containerTag: string, query?: string): Promise<Supermemory.ProfileResponse | null>;
+    searchMemories(query: string, containerTag: string): Promise<{
+        results: Array<Supermemory.Search.SearchMemoriesResponse.Result>;
+        timing: number;
+        total: number;
+        success: true;
+        error?: undefined;
+    } | {
+        success: false;
+        error: string;
+        results: never[];
+        total: number;
+        timing: number;
+    }>;
+    getProfile(containerTag: string, query?: string): Promise<{
+        profile: Supermemory.ProfileResponse.Profile;
+        searchResults?: Supermemory.ProfileResponse.SearchResults;
+        success: true;
+        error?: undefined;
+    } | {
+        success: false;
+        error: string;
+        profile: null;
+    }>;
     addMemory(content: string, containerTag: string, metadata?: {
         type?: MemoryType;
         tool?: string;
         [key: string]: unknown;
-    }): Promise<Supermemory.Memories.MemoryAddResponse | null>;
-    forgetMemory(containerTag: string, memoryId?: string): Promise<Supermemory.Memories.MemoryForgetResponse | null>;
-    listMemories(containerTag: string, limit?: number): Promise<Supermemory.Memories.MemoryListResponse>;
-    ingestConversation(conversationId: string, messages: ConversationMessage[], containerTags: string[], metadata?: Record<string, string | number | boolean>): Promise<ConversationIngestResponse | null>;
+    }): Promise<{
+        id: string;
+        status: string;
+        success: true;
+        error?: undefined;
+    } | {
+        success: false;
+        error: string;
+    }>;
+    deleteMemory(memoryId: string): Promise<{
+        success: boolean;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+    }>;
+    listMemories(containerTag: string, limit?: number): Promise<{
+        memories: Array<Supermemory.Memories.MemoryListResponse.Memory>;
+        pagination: Supermemory.Memories.MemoryListResponse.Pagination;
+        success: true;
+        error?: undefined;
+    } | {
+        success: false;
+        error: string;
+        memories: never[];
+        pagination: {
+            currentPage: number;
+            totalItems: number;
+            totalPages: number;
+        };
+    }>;
+    ingestConversation(conversationId: string, messages: ConversationMessage[], containerTags: string[], metadata?: Record<string, string | number | boolean>): Promise<{
+        success: false;
+        error: string;
+    } | {
+        id: string;
+        conversationId: string;
+        status: string;
+        success: true;
+        error?: undefined;
+    }>;
 }
 export declare const supermemoryClient: SupermemoryClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/services/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/services/client.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,aAAa,CAAC;AAGtC,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAe3B,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA4B;IAE1C,OAAO,CAAC,SAAS;IAcX,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAsBlD,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAmB/C,SAAS,CACb,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE;IAiBnE,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAepD,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,SAAK;IAqB7C,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACnD,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;CAmC9C;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/services/client.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,aAAa,CAAC;AAGtC,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EAEpB,MAAM,mBAAmB,CAAC;AAe3B,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA4B;IAE1C,OAAO,CAAC,SAAS;IAcX,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;;;;;;;;;;;;;IAsBlD,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;;;;;;;;;;IAmB/C,SAAS,CACb,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE;;;;;;;;;IAqBnE,YAAY,CAAC,QAAQ,EAAE,MAAM;;;;;;;IAgB7B,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,SAAK;;;;;;;;;;;;;;;IAqB7C,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;;;;;;;;;;CAoCvD;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/services/compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/services/compaction.ts"],"names":[],"mappings":"AAsBA,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAeD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC7E;AAuLD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,OAAO,EAAE;YACP,SAAS,EAAE,CAAC,MAAM,EAAE;gBAAE,IAAI,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAAC,IAAI,EAAE;oBAAE,UAAU,EAAE,MAAM,CAAC;oBAAC,OAAO,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAAC,KAAK,EAAE;oBAAE,SAAS,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/I,QAAQ,EAAE,CAAC,MAAM,EAAE;gBAAE,IAAI,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAAC,KAAK,EAAE;oBAAE,SAAS,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC;gBAAE,IAAI,CAAC,EAAE,KAAK,CAAC;oBAAE,IAAI,EAAE,WAAW,CAAA;iBAAE,CAAC,CAAA;aAAE,CAAC,CAAC;YAC/H,WAAW,EAAE,CAAC,MAAM,EAAE;gBAAE,IAAI,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAAC,IAAI,EAAE;oBAAE,KAAK,CAAC,EAAE,MAAM,CAAC;oBAAC,KAAK,EAAE,KAAK,CAAC;wBAAE,IAAI,EAAE,MAAM,CAAC;wBAAC,IAAI,EAAE,MAAM,CAAA;qBAAE,CAAC,CAAA;iBAAE,CAAC;gBAAC,KAAK,EAAE;oBAAE,SAAS,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAC3K,CAAC;QACF,GAAG,EAAE;YACH,SAAS,EAAE,CAAC,MAAM,EAAE;gBAAE,IAAI,EAAE;oBAAE,KAAK,EAAE,MAAM,CAAC;oBAAC,OAAO,EAAE,MAAM,CAAC;oBAAC,OAAO,EAAE,MAAM,CAAC;oBAAC,QAAQ,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAC1H,CAAC;KACH,CAAC;CACH;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACvC,OAAO,CAAC,EAAE,iBAAiB;qBAuNF;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE;EAgE3E"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/services/compaction.ts"],"names":[],"mappings":"AAsBA,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAeD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC7E;AAuLD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,OAAO,EAAE;YACP,SAAS,EAAE,CAAC,MAAM,EAAE;gBAAE,IAAI,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAAC,IAAI,EAAE;oBAAE,UAAU,EAAE,MAAM,CAAC;oBAAC,OAAO,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAAC,KAAK,EAAE;oBAAE,SAAS,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/I,QAAQ,EAAE,CAAC,MAAM,EAAE;gBAAE,IAAI,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAAC,KAAK,EAAE;oBAAE,SAAS,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC;gBAAE,IAAI,CAAC,EAAE,KAAK,CAAC;oBAAE,IAAI,EAAE,WAAW,CAAA;iBAAE,CAAC,CAAA;aAAE,CAAC,CAAC;YAC/H,WAAW,EAAE,CAAC,MAAM,EAAE;gBAAE,IAAI,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAAC,IAAI,EAAE;oBAAE,KAAK,CAAC,EAAE,MAAM,CAAC;oBAAC,KAAK,EAAE,KAAK,CAAC;wBAAE,IAAI,EAAE,MAAM,CAAC;wBAAC,IAAI,EAAE,MAAM,CAAA;qBAAE,CAAC,CAAA;iBAAE,CAAC;gBAAC,KAAK,EAAE;oBAAE,SAAS,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAC3K,CAAC;QACF,GAAG,EAAE;YACH,SAAS,EAAE,CAAC,MAAM,EAAE;gBAAE,IAAI,EAAE;oBAAE,KAAK,EAAE,MAAM,CAAC;oBAAC,OAAO,EAAE,MAAM,CAAC;oBAAC,OAAO,EAAE,MAAM,CAAC;oBAAC,QAAQ,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAC1H,CAAC;KACH,CAAC;CACH;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACvC,OAAO,CAAC,EAAE,iBAAiB;qBAyNF;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE;EAgE3E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-supermemory",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "OpenCode plugin that gives coding agents persistent memory using Supermemory",
   "type": "module",
   "main": "dist/index.js",