@zilliz/memsearch-opencode 0.2.1 → 0.3.1

package/README.md

@@ -62,6 +62,7 @@ OpenCode Session
     ├── chat.message hook ──→ Detect turn completion
     │                              │
     │                              ├── Extract last turn from SQLite
+    │                              ├── Persist turn metadata to .memsearch/opencode-turns.db
     │                              ├── Summarize via LLM (third-person notes)
     │                              └── Append to .memsearch/memory/YYYY-MM-DD.md
     │                                     │
@@ -106,7 +107,11 @@ We discussed the authentication flow before, what was the approach?
 |------|-------------|
 | `memory_search` | Semantic search over past memories. Returns ranked chunks. |
 | `memory_get` | Expand a chunk hash to see the full markdown section. |
-| `memory_transcript` | Read original conversation from OpenCode SQLite DB. |
+| `memory_transcript` | Read original conversation from OpenCode SQLite DB, optionally centered on a turn cursor. |
+
+`<project>/.memsearch/opencode-turns.db` stores derived capture checkpoints and
+turn ordering only. It is rebuildable state, not the source of truth for
+transcript recall.
 
 ## Memory Files
 
@@ -127,7 +132,7 @@ Each file contains timestamped entries with bullet-point summaries:
 ## Session 14:30
 
 ### 14:30
-<!-- session:ses_abc123 db:~/.local/share/opencode/opencode.db -->
+<!-- session:ses_abc123 turn:msg_123abc db:~/.local/share/opencode/opencode.db -->
 - User asked about the authentication flow.
 - Assistant explained the OAuth2 implementation in auth.ts.
 - Assistant modified the token refresh logic in refresh.ts.
@@ -143,13 +148,22 @@ memsearch config set embedding.provider openai
 export OPENAI_API_KEY=sk-...
 ```
 
-To override only the OpenCode capture summarization model:
+To override only the OpenCode native capture summarization model:
 
 ```bash
 memsearch config set plugins.opencode.summarize.model anthropic/claude-haiku
 ```
 
-Leave it empty or unset to keep the current `small_model` / plugin default behavior. This setting does not fall back to `llm.model`.
+To use a memsearch-managed API provider instead:
+
+```bash
+memsearch config set llm.providers.openai.type openai
+memsearch config set llm.providers.openai.model gpt-4o-mini
+memsearch config set llm.providers.openai.api_key env:OPENAI_API_KEY
+memsearch config set plugins.opencode.summarize.provider openai
+```
+
+Leave `plugins.opencode.summarize.provider` empty or set it to `native` to keep the current `small_model` / plugin default behavior. This setting does not fall back to `llm.model`.
 
 ## How It Works
 
@@ -157,7 +171,7 @@ Leave it empty or unset to keep the current `small_model` / plugin default behav
 
 2. **Index**: The markdown files are indexed by memsearch into a Milvus collection (Milvus Lite by default, runs in-process).
 
-3. **Recall**: When the assistant needs historical context, it calls `memory_search` to find relevant chunks. Results can be expanded with `memory_get` or drilled into with `memory_transcript`.
+3. **Recall**: When the assistant needs historical context, it calls `memory_search` to find relevant chunks. Results can be expanded with `memory_get` or drilled into with `memory_transcript`, which reads the original transcript from OpenCode SQLite.
 
 4. **Cold-start**: At session start, recent memory bullets are injected into the system prompt so the assistant has immediate context.
 

package/index.ts

@@ -285,11 +285,14 @@ const MemsearchPlugin: Plugin = async ({ project, directory, worktree }) => {
         description:
           "Retrieve the original conversation from a past OpenCode session. " +
           "Use after memory_get when the expanded result contains a session anchor " +
-          "(<!-- session:ID db:PATH -->). Returns the formatted " +
-          "dialogue with [Human] and [Assistant] labels.",
+          "(<!-- session:ID turn:ID db:PATH -->). Returns the formatted " +
+          "dialogue with [Human] and [Assistant] labels. When turn_id is present, " +
+          "the tool returns the target turn plus surrounding context.",
         args: {
           session_id: tool.schema.string().describe("The session ID from the anchor comment"),
-          limit: tool.schema.number().optional().describe("Max number of messages to return (default: 20)"),
+          turn_id: tool.schema.string().optional().describe("Optional turn ID from the anchor comment"),
+          context: tool.schema.number().optional().describe("Turns before/after the target turn (default: 3)"),
+          limit: tool.schema.number().optional().describe("Max number of turns to return when no turn_id is provided (default: 20)"),
         },
         async execute(args, context) {
           const dir = context?.directory || projectDir;
@@ -297,11 +300,25 @@ const MemsearchPlugin: Plugin = async ({ project, directory, worktree }) => {
           if (autoCapture) startCaptureDaemon(dir, col, memsearchCmd);
           try {
             const scriptPath = join(PLUGIN_DIR, "scripts", "parse-transcript.py");
-            const result = spawnSync(
-              "python3",
-              [scriptPath, args.session_id, ...(args.limit ? ["--limit", String(args.limit)] : [])],
-              { encoding: "utf-8", timeout: 15000 }
-            );
+            const scriptArgs = [
+              scriptPath,
+              args.session_id,
+              "--project-dir",
+              dir,
+            ];
+            if (args.turn_id) {
+              scriptArgs.push("--turn", args.turn_id);
+            }
+            if (typeof args.context === "number") {
+              scriptArgs.push("--context", String(args.context));
+            }
+            if (typeof args.limit === "number") {
+              scriptArgs.push("--limit", String(args.limit));
+            }
+            const result = spawnSync("python3", scriptArgs, {
+              encoding: "utf-8",
+              timeout: 15000,
+            });
             return result.stdout?.trim() || result.stderr || "No transcript content found.";
           } catch (e: any) {
             return `Transcript parse failed: ${e.message}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zilliz/memsearch-opencode",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "memsearch plugin for OpenCode — semantic memory search across sessions",
   "type": "module",
   "main": "index.ts",