dsh-deja 0.23.0 → 0.23.1

package/README.md

@@ -8,7 +8,7 @@ DeepSeek Harness can already search its own sessions — that is what the built-
 `session-query` subsystem does. This plugin answers the other question: what you
 did in the *other* agents on this machine.
 
-deja indexes the session files that forty-one other coding agents — Claude Code,
+deja indexes the session files that forty-two other coding agents — Claude Code,
 Codex, Cursor, opencode, Antigravity, Grok Build, Kimi, Cline and Zed among
 them — already write to disk. Nothing has to have been recorded ahead of time: the history is already
 there, including the months before deja was installed. If you moved to dsh last

package/docs/zh.md

@@ -6,7 +6,7 @@
 
 DeepSeek Harness 自带的 `session-query` 已经可以检索它自己的会话。这个插件回答的是另一个问题：你在这台机器上**其他**智能体里做过什么。
 
-deja 索引 Claude Code、Codex、Cursor、opencode、Antigravity、Grok Build、Kimi、Cline、Zed 等其他四十一个智能体本来就写在磁盘上的会话文件。不需要提前录制：历史已经在那里，包括安装 deja 之前的那些月份。如果你上周才转到 dsh，上周之前做过的事仍然可以在 dsh 里查到。
+deja 索引 Claude Code、Codex、Cursor、opencode、Antigravity、Grok Build、Kimi、Cline、Zed 等其他四十二个智能体本来就写在磁盘上的会话文件。不需要提前录制：历史已经在那里，包括安装 deja 之前的那些月份。如果你上周才转到 dsh，上周之前做过的事仍然可以在 dsh 里查到。
 
 ## 安装
 

package/index.js

@@ -2,7 +2,7 @@
 //
 // dsh answers questions about its own sessions through the built-in
 // session-query subsystem. This plugin answers the other question: what you did
-// in Claude Code, Codex, Cursor, opencode and thirty-eight more agents, on this
+// in Claude Code, Codex, Cursor, opencode and thirty-nine more agents, on this
 // machine, before dsh existed. The index is deja's; this file is the seam.
 
 import { createRequire } from "node:module";
@@ -12,7 +12,7 @@ import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-import { argv, contributions, exitStatus, guarded, inert, newestEvents, noteBoard, resultText, splitHookReply } from "./lib.js";
+import { argv, contributions, recallArgv, recallSilence, exitStatus, guarded, inert, newestEvents, noteBoard, resultText, splitHookReply } from "./lib.js";
 
 const require = createRequire(import.meta.url);
 
@@ -60,9 +60,10 @@ const DEJA = resolveDeja();
 
 // run returns stdout, or "" when deja is missing or says nothing. Memory is
 // optional everywhere: a throw here would end the turn.
-function run(args, input) {
+function run(args, input, cwd) {
   try {
     return execFileSync(DEJA, args, {
+      cwd,
       encoding: "utf8",
       timeout: 20000,
       maxBuffer: 8 * 1024 * 1024,
@@ -95,8 +96,8 @@ function tools(ctx) {
   if (!defineTool) return;
 
   // Every tool here answers with the text deja printed, so one output
-  // declaration serves them all. Printed with --framed: search, ctx, blame,
-  // fix and how write for a person, and without the frame a tag planted in a
+  // declaration serves them all. Printed with --framed: ctx, blame, fix and
+  // how write for a person (recall frames its own page), and without the frame a tag planted in a
   // transcript reached the model as though deja had closed its own block. The schema is plain JSON Schema — a
   // schemastery instance is rejected as "schema must be a value schema object",
   // because the host validates that this is an ordinary JSON record.
@@ -119,14 +120,19 @@ function tools(ctx) {
         type: "number",
         description: "How many sessions to return. Default 5.",
       },
+      offset: {
+        type: "number",
+        description: "Sessions to skip, from the offset the previous page named. Default 0.",
+      },
     },
     output: TEXT_OUTPUT,
-    execute(args) {
-      // deja itself caps the window; asking for a hundred sessions would
-      // spend the model's context on a tail nobody reads.
-      const asked = Number.isFinite(args.limit) ? Math.trunc(args.limit) : 5;
-      const limit = String(Math.min(20, Math.max(1, asked)));
-      return Promise.resolve(answer(run(["--framed", ...argv("search", ["--json", "--limit", limit], args.query)])));
+    execute(args, exec) {
+      // The page the MCP recall tool serves, framed and budgeted by deja. It
+      // puts the project of its working directory first, so it runs in the
+      // calling session's workspace rather than wherever dsh was launched.
+      const call = recallArgv(args);
+      const out = run(call, undefined, sessionCwd(exec && exec.agent));
+      return Promise.resolve(answer(out || (INSTALLED ? recallSilence(call) : "")));
     },
   })));
 

package/lib.js

@@ -21,6 +21,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 = Math.min(20, Math.max(1, 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.";
+}
+
 // guarded runs one registration, and swallows the host's refusal of a name it
 // already holds.
 //

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-deja",
-  "version": "0.23.0",
-  "description": "deja-vu memory for DeepSeek Harness: the session history of forty-one other coding agents, searchable and recalled before each step — a local index, no LLM.",
+  "version": "0.23.1",
+  "description": "deja-vu memory for DeepSeek Harness: the session history of forty-two other coding agents, searchable and recalled before each step — a local index, no LLM.",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -68,7 +68,7 @@
     }
   },
   "dependencies": {
-    "@vshulcz/deja-vu": "^0.23.0"
+    "@vshulcz/deja-vu": "^0.23.1"
   },
   "scripts": {
     "test": "node --test test/*.test.js"