shmem-opencode 0.1.0

package/index.ts

@@ -0,0 +1,76 @@
+/**
+ * shmem-opencode — memory hooks for OpenCode.
+ *
+ * This plugin shells out to `shmem hook user-message` and `shmem hook response`
+ * after each user prompt and assistant response. The hook commands read a
+ * JSON blob from stdin with the shape:
+ *
+ *   user-message: { "prompt": "<text>", "cwd": "<absolute path>" }
+ *   response:     { "last_assistant_message": "<text>", "cwd": "<absolute path>" }
+ *
+ * The MCP server (`shmem-mcp`) is the primary capture path for OpenCode and
+ * is configured via `shmem init --for opencode`. These hooks provide a
+ * secondary capture path that works independently of MCP.
+ *
+ * TODO: Verify the exact import path for @opencode-ai/sdk once the plugin
+ * API stabilises. The `define` export and event names below are based on
+ * the OpenCode plugin RFC / v0.1 spec — adjust if the upstream API changes.
+ */
+
+// TODO: replace with the correct package name once confirmed stable.
+// Candidate: "@opencode-ai/sdk" or "@opencode-ai/plugin"
+import { define } from "@opencode-ai/sdk"
+import { execFileSync } from "child_process"
+
+// Pipe content into a shmem hook subcommand. Fire-and-forget: errors are
+// swallowed so a shmem outage never blocks the agent.
+function shmemHook(subcommand: string, payload: Record<string, string>): void {
+  try {
+    execFileSync("shmem", ["hook", subcommand], {
+      input: JSON.stringify(payload),
+      timeout: 10_000,
+      stdio: ["pipe", "ignore", "ignore"],
+    })
+  } catch {
+    // Swallow — hook failures must not surface to the user.
+  }
+}
+
+export default define({
+  id: "shmem",
+
+  // TODO: Verify the correct setup function signature for OpenCode's plugin API.
+  // The ctx object shape below is speculative; consult @opencode-ai/sdk types.
+  setup: async (ctx: {
+    // TODO: replace with the actual OpenCode SDK context type.
+    // Expected surface area based on OpenCode plugin RFC:
+    //   ctx.session.cwd      — absolute path of the session working directory
+    //   ctx.on(event, fn)    — subscribe to lifecycle events
+    on: (
+      event: string,
+      handler: (data: Record<string, unknown>) => void | Promise<void>
+    ) => void
+    session?: { cwd?: string }
+  }) => {
+    const cwd = ctx.session?.cwd ?? ""
+
+    // TODO: Verify the exact event names. OpenCode's plugin RFC uses:
+    //   "message:user"      — fired when the user submits a prompt
+    //   "message:assistant" — fired when the assistant response completes
+    // Adjust to the actual event names once confirmed.
+    ctx.on("message:user", (data) => {
+      const prompt = typeof data["content"] === "string" ? data["content"] : ""
+      if (prompt.length >= 10) {
+        shmemHook("user-message", { prompt, cwd })
+      }
+    })
+
+    ctx.on("message:assistant", (data) => {
+      const message =
+        typeof data["content"] === "string" ? data["content"] : ""
+      if (message.length >= 20) {
+        shmemHook("response", { last_assistant_message: message, cwd })
+      }
+    })
+  },
+})

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "shmem-opencode",
+  "version": "0.1.0",
+  "description": "shmem memory hooks for OpenCode",
+  "main": "index.ts",
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@opencode-ai/sdk": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "keywords": ["shmem", "opencode", "memory", "ai"],
+  "license": "MIT"
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["index.ts"]
+}