dsh-deja 0.22.2 → 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, 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) : "")));
     },
   })));
 
@@ -282,19 +288,20 @@ function autoDigest(ctx, board) {
     ctx.systemPrompt.context({
       name: "deja:project",
       order: 110,
+      interpolate: false,
       text: (assembly) => {
         const agent = assembly && assembly.agent;
         if (!agent) return "";
         const sid = sessionId(agent);
         if (sid && seen.has(sid)) return "";
         if (sid) seen.add(sid);
-        return askHook(
+        return inert(askHook(
           ["hook-context", "--plain"],
           ["hook-context"],
           JSON.stringify({ session_id: sid, cwd: sessionCwd(agent), source: "startup", deja_once: true }),
           sid,
           board,
-        );
+        ));
       },
     }),
   );
@@ -344,6 +351,7 @@ function autoRecall(ctx, board) {
     ctx.systemPrompt.context({
       name: "deja:recall",
       order: 120,
+      interpolate: false,
       text: (assembly) => {
         const agent = assembly && assembly.agent;
         if (!agent) return "";
@@ -360,13 +368,13 @@ function autoRecall(ctx, board) {
           asked = prompt;
           askedIn = cwd;
           askedBy = sid;
-          recalled = askHook(
+          recalled = inert(askHook(
             ["hook-prompt", "--plain"],
             ["hook-prompt"],
             JSON.stringify({ prompt, cwd, session_id: sid }),
             sid,
             board,
-          );
+          ));
         }
         // Silence is the common case: this speaks only when the history answers.
         return recalled;
@@ -505,20 +513,23 @@ function toolNotes(ctx) {
 // be answered with it now rather than twenty minutes from now.
 function sessionEnds(ctx) {
   if (typeof ctx.on !== "function") return;
-  const live = new Set();
+  // Each live session with the directory it opened in: the end refreshes that
+  // project's start digest, so the next session there sees this one.
+  const live = new Map();
   const end = (sid) => {
     if (!sid || !live.has(sid)) return;
+    const cwd = live.get(sid);
     live.delete(sid);
-    run(["hook-session-end"], JSON.stringify({ session_id: sid }));
+    run(["hook-session-end"], JSON.stringify({ session_id: sid, cwd }));
   };
   try {
     ctx.on("session/created", (session) => {
       const sid = bareSessionId(session && session.id);
-      if (sid) live.add(sid);
+      if (sid) live.set(sid, (session.header && session.header.cwd) || process.cwd());
     });
     ctx.on("session/disposed", (session) => end(bareSessionId(session && session.id)));
     process.on("exit", () => {
-      for (const sid of [...live]) end(sid);
+      for (const sid of [...live.keys()]) end(sid);
     });
   } catch {}
 }

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.
 //
@@ -62,6 +91,18 @@ export function exitStatus(text) {
   return { body: text, failed: false };
 }
 
+// inert keeps recalled text out of dsh's prompt templating. dsh reads every
+// {{name}} in a context as a prompt variable and throws on one it does not
+// know, which ends the turn before the model is called. Past sessions quote
+// templates, and that very error, so one recall carrying {{cwd}} broke every
+// turn after it (#5421). `interpolate: false` tells dsh 0.2.1-alpha.2 and later
+// to leave the text alone; older hosts ignore it, and a listener on
+// system-prompt/assemble may drop it, so the braces are split as well:
+// { {cwd} } still reads as braces and holds no {{ to resolve.
+export function inert(text) {
+  return String(text || "").replace(/\{(?=\{)/g, "{ ").replace(/\}(?=\})/g, "} ");
+}
+
 // contributions says what this package adds, given what `deja install` already
 // wrote into DSH_HOME and what the profile turned off. The rule is the same
 // everywhere: fill the gaps, never repeat the installer.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-deja",
-  "version": "0.22.2",
-  "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.22.2"
+    "@vshulcz/deja-vu": "^0.23.1"
   },
   "scripts": {
     "test": "node --test test/*.test.js"