opencode-deja 0.23.0 → 0.23.1

package/README.md

@@ -3,7 +3,7 @@
 English | [中文](https://github.com/vshulcz/deja-vu/blob/main/extensions/opencode/docs/zh.md)
 
 opencode remembers its own sessions. This plugin answers the other question:
-what you did in the forty-one other coding agents on this machine — Claude Code,
+what you did in the forty-two other coding agents on this machine — Claude Code,
 Codex, Cursor, Gemini and Zed among them — including the months before you
 installed anything.
 

package/index.js

@@ -1,7 +1,7 @@
 // opencode-deja — the sessions you already have, inside opencode.
 //
 // opencode remembers its own sessions. This plugin answers the other question:
-// what you did in Claude Code, Codex, Cursor, Gemini and thirty-eight more agents on
+// what you did in Claude Code, Codex, Cursor, Gemini and thirty-nine more agents on
 // this machine, including months before deja existed. The index is deja's; this
 // file is the seam: six tools the model can call, plus recall that arrives
 // without being asked for.
@@ -18,12 +18,13 @@ import { accessSync, constants, existsSync, readFileSync } from "node:fs"
 
 import {
   argv,
-  clampLimit,
   cliPluginPath,
   configPaths,
   contextText,
   contributions,
   mcpWired,
+  recallArgv,
+  recallSilence,
   TOOL_SPECS,
   userTurns,
   zodTools,
@@ -218,10 +219,17 @@ export const DejaPlugin = async ({ client, directory }, options = {}) => {
       args: {
         query: { type: "string", description: "Specific tokens to match. Several words are ANDed." },
         limit: { type: "number", optional: true, description: "How many sessions to return. Default 5." },
+        offset: {
+          type: "number",
+          optional: true,
+          description: "Sessions to skip, from the offset the previous page named. Default 0.",
+        },
       },
       async execute(args) {
-        const limit = String(clampLimit(args.limit))
-        return answer(await ask(["--framed", ...argv("search", ["--json", "--limit", limit], args.query)]))
+        // The page the MCP recall tool serves, framed and budgeted by deja.
+        const call = recallArgv(args)
+        const out = await ask(call)
+        return answer(out || (installed ? recallSilence(call) : ""))
       },
     },
     deja_session: {

package/lib.js

@@ -143,6 +143,35 @@ export function argv(cmd, flags, text) {
   return arg.startsWith("-") ? [cmd, ...flags, "--", arg] : [cmd, ...flags, arg]
 }
 
+// recallArgv is the call behind the deja_recall tool: `deja recall`, the page
+// the MCP recall tool serves, framed and held to its 4 KB budget by deja
+// itself. The tool used to run `search --json`, which carries every hit's
+// matched messages whole and handed a model 661,528 characters for five hits
+// (#5568). The page ends with "call recall again with offset=N"; offset is
+// how the tool asks for that, and it is sent only past the first page, so a
+// deja too old to know --offset still answers the first one.
+export function recallArgv(args) {
+  const count = (v, fallback) => {
+    const n = Math.trunc(Number(v))
+    return v == null || v === "" || !Number.isFinite(n) ? fallback : n
+  }
+  const limit = clampLimit(count(args && args.limit, 5))
+  const offset = Math.min(1e9, Math.max(0, count(args && args.offset, 0)))
+  const flags = ["--limit", String(limit)]
+  if (offset > 0) flags.push("--offset", String(offset))
+  return argv("recall", flags, args && args.query)
+}
+
+// recallSilence is the answer when `deja recall` printed nothing. Past the
+// first page that is a deja older than --offset refusing the flag, not an
+// empty history: recall always prints a line, "No more matches" included.
+export function recallSilence(call) {
+  if (call.includes("--offset")) {
+    return "This deja cannot page recall. Run deja update, then ask again with the same offset."
+  }
+  return "Nothing in this machine's history matches that."
+}
+
 // clampLimit keeps a model that asks for a hundred sessions from spending the
 // window on a tail nobody reads.
 export function clampLimit(value, fallback = 5) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-deja",
-  "version": "0.23.0",
-  "description": "deja-vu memory for opencode: the session history of forty-one other coding agents, searchable and recalled on every request — a local index, no LLM.",
+  "version": "0.23.1",
+  "description": "deja-vu memory for opencode: the session history of forty-two other coding agents, searchable and recalled on every request — a local index, no LLM.",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -52,7 +52,7 @@
   },
   "dependencies": {
     "@opencode-ai/plugin": ">=1.0.0",
-    "@vshulcz/deja-vu": "^0.23.0"
+    "@vshulcz/deja-vu": "^0.23.1"
   },
   "scripts": {
     "test": "node --test test/*.test.js"