dsh-session-recall 0.6.0 → 0.7.1

package/README.md

@@ -2,7 +2,7 @@
 
 English | [中文](https://github.com/kittimzhe/dsh-session-recall/blob/main/README.zh.md)
 
-[![npm version](https://img.shields.io/npm/v/dsh-session-recall)](https://www.npmjs.com/package/dsh-session-recall) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/kittimzhe/dsh-session-recall/blob/main/LICENSE)
+[![CI](https://github.com/kittimzhe/dsh-session-recall/actions/workflows/test.yml/badge.svg)](https://github.com/kittimzhe/dsh-session-recall/actions/workflows/test.yml) [![npm version](https://img.shields.io/npm/v/dsh-session-recall)](https://www.npmjs.com/package/dsh-session-recall) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/kittimzhe/dsh-session-recall/blob/main/LICENSE)
 
 Deterministic cross-session full-text retrieval for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): the model-facing `recall` tool lets the agent **search its own past session transcripts** — "that bug we fixed last week", "the font we chose for my resume" — through the trusted `ctx.sessionQuery` seam.
 
@@ -21,10 +21,16 @@ If you need agent memory orchestration, use a memory framework; if you need boun
 | Capability focus | Memory frameworks | Generic transcript search | `dsh-session-recall` |
 |---|---|---|---|
 | Retrieval target | Derived memory objects | Varies by implementation | **Original session transcript events** |
-| Scope control | Framework-specific | Often coarse | **cwd-scoped default + explicit `all_projects` gate** |
+| Scope control | Framework-specific | Often coarse | **cwd-scoped default + explicit `all_projects`, `since_days`, `tools`, `errors_only` gate** |
 | CJK behavior | Framework-specific | Often tokenizer-limited | **FTS + CJK zero-hit substring fallback** |
 | Output contract | Usually framework-native | Varies | **Typed `recall` result with stable fields/hints** |
 
+Name & scope notes (2026-09):
+
+- This plugin is **unrelated to `dsh-recall-plugin`** — that plugin is message undo/rewind (restoring workspace and conversation to before a message was sent).
+- It **succeeds `dsh-recall`** — an earlier transcript-search plugin (last release 2026-08-21) with a similar goal; this plugin continues the line with persistent FTS5 indexing, CJK fallback, approval gates, and lineage-scoped authorization.
+- It **complements memory frameworks** such as `dsh-mnemon` (write-side memory orchestration): this plugin stays a read-only retrieval layer over original session logs and makes no writes to any memory store.
+
 ## Roadmap
 
 - **P2: evidence handoff** — one-click bridge to session export for matched sessions.

package/README.zh.md

@@ -2,7 +2,7 @@
 
 [English](https://github.com/kittimzhe/dsh-session-recall/blob/main/README.md) | 中文
 
-[![npm version](https://img.shields.io/npm/v/dsh-session-recall)](https://www.npmjs.com/package/dsh-session-recall) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/kittimzhe/dsh-session-recall/blob/main/LICENSE)
+[![CI](https://github.com/kittimzhe/dsh-session-recall/actions/workflows/test.yml/badge.svg)](https://github.com/kittimzhe/dsh-session-recall/actions/workflows/test.yml) [![npm version](https://img.shields.io/npm/v/dsh-session-recall)](https://www.npmjs.com/package/dsh-session-recall) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/kittimzhe/dsh-session-recall/blob/main/LICENSE)
 
 DeepSeek Harness 的**确定性跨会话全文检索**插件：注册模型可调用的 `recall` 工具，让 agent 能**检索自己过往的会话原文**——"上周修的那个 bug"、"简历选的什么字体"——全部通过可信的 `ctx.sessionQuery` 缝完成。
 
@@ -25,6 +25,11 @@ DeepSeek Harness 的**确定性跨会话全文检索**插件：注册模型可
 | CJK 体验 | 视实现而定 | 常受分词限制 | **FTS + CJK 零命中子串回退** |
 | 输出契约 | 框架内部格式 | 不统一 | **类型化 `recall` 结果 + 稳定 hint** |
 
+命名与边界说明（2026-09）：
+
+- 本插件与 **`dsh-recall-plugin` 无关**——那是"撤回消息"插件（把工作区与对话回退到某条消息发出之前）。
+- 本插件是 **`dsh-recall` 的后继者**——后者是更早的会话检索插件（最后更新 2026-08-21）；本插件在其方向上续写：持久 FTS5 索引、中文回退、审批闸门、谱系鉴权。
+- 本插件与 **`dsh-mnemon` 等记忆框架互补**：它们做写入侧的记忆编排；本插件保持只读检索层，只读原始会话日志，不写任何记忆存储。
 ## 路线图
 
 - **P2：证据联动导出** —— 命中后可一键触发对应会话导出。

package/lib/index.d.ts

@@ -136,6 +136,12 @@ interface RecallArgs {
   all_projects?: boolean;
   limit?: number;
   cursor?: string;
+  /** Only return sessions/entries newer than this many days. */
+  since_days?: number;
+  /** Only return tool-related events whose tool name matches one of these (substring, case-insensitive). */
+  tools?: readonly string[];
+  /** Only return failed tool calls (tool results carrying an error). */
+  errors_only?: boolean;
 }
 //#endregion
 //#region src/rank.d.ts

package/lib/index.js

@@ -297,6 +297,34 @@ function cjkZeroHitHint(query, zeroHits, enabled) {
 * calling agent's own project cwd unless the model explicitly widens the
 * scope and the deployment allows it.
 */
+/** Whether a best-match event type is a tool result (vs user/assistant message). */
+function isToolResultType(type) {
+	return type === "tool/result" || type.startsWith("tool/");
+}
+/** Apply the dimensional post-filters (sinceDays / tools / errorsOnly) to recall items. */
+function applyDimensionFilters(items, args, now = Date.now()) {
+	let out = [...items];
+	if (args.since_days !== void 0 && args.since_days > 0) {
+		const cutoff = now - args.since_days * 864e5;
+		out = out.filter((item) => {
+			return Math.max(item.createdAt ?? 0, item.bestMatch?.time ?? 0) >= cutoff;
+		});
+	}
+	if (args.tools !== void 0 && args.tools.length > 0) {
+		const needles = args.tools.map((t) => t.toLowerCase());
+		out = out.filter((item) => {
+			if (!isToolResultType(item.bestMatch?.type ?? "")) return false;
+			const snippet = (item.bestMatch?.snippet ?? "").toLowerCase();
+			return needles.some((n) => snippet.includes(n));
+		});
+	}
+	if (args.errors_only === true) out = out.filter((item) => {
+		if ((item.bestMatch?.type ?? "") !== "tool/result") return false;
+		const snippet = item.bestMatch?.snippet ?? "";
+		return snippet.includes("[error]") || /\berror\b|\bfailed\b/i.test(snippet);
+	});
+	return out;
+}
 /** Walk a lineage trace and collect every session id in the tree. */
 function collectLineageIds(trace) {
 	const ids = /* @__PURE__ */ new Set();
@@ -317,7 +345,7 @@ const RECALL_TOOL_DESCRIPTION = [
 	"Matches whole words/phrases for English and code identifiers; a zero-hit Chinese (CJK) query automatically falls back to a substring scan in which every whitespace-separated term must match. Returns the best-matching event snippet per session plus the session id.",
 	"Then use the read tool on files, or ask the user, to go deeper — this tool only points at history, it does not resume sessions.",
 	"To save a full evidence report of a hit session, call the transcript_export tool (from dsh-session-export) with its sessionId when available.",
-	"Scoping: by default only sessions started in the current project directory; pass all_projects=true to search everywhere (the deployment may ignore it or require user approval).",
+	"Scoping: by default only sessions started in the current project directory; pass all_projects=true to search everywhere (the deployment may ignore it or require user approval). Narrow further with since_days (only sessions newer than N days), tools (only tool events whose tool name matches, e.g. tools=[\"bash\"]), or errors_only=true (only failed tool calls).",
 	"When the deployment enables redaction, secret-looking text in snippets appears as [REDACTED] or a #hash marker — treat it as removed; do not try to reconstruct or echo it.",
 	"The first search after startup may be slow while the index builds."
 ].join(" ");
@@ -600,6 +628,19 @@ function createRecallTool(config, engine, approver) {
 			cursor: {
 				type: "string",
 				description: "Opaque continuation cursor from a previous recall result with hasMore=true."
+			},
+			since_days: {
+				type: "integer",
+				description: "Only return sessions newer than this many days (0 = no time filter)."
+			},
+			tools: {
+				type: "array",
+				items: { type: "string" },
+				description: "Only return tool events whose tool name contains one of these substrings (case-insensitive), e.g. [\"bash\",\"read\"]."
+			},
+			errors_only: {
+				type: "boolean",
+				description: "Only return failed tool calls (tool results carrying an error)."
 			}
 		},
 		output: {
@@ -675,7 +716,7 @@ function createRecallTool(config, engine, approver) {
 						redacted: 0,
 						diagnostics: null
 					};
-					let items = eventItems(page, sessionId);
+					let items = applyDimensionFilters(eventItems(page, sessionId), args);
 					let hint = null;
 					let diagnostics = {
 						source: "fts",
@@ -690,7 +731,7 @@ function createRecallTool(config, engine, approver) {
 							scanBudget: cfg.cjkFallbackScanMax,
 							ranked: false
 						};
-						if (docs.length > 0) items = docs.slice(0, limit).map((doc) => ({
+						if (docs.length > 0) items = applyDimensionFilters(docs.slice(0, limit).map((doc) => ({
 							sessionId,
 							id8: id8(sessionId),
 							title: null,
@@ -704,7 +745,7 @@ function createRecallTool(config, engine, approver) {
 								time: doc.time,
 								snippet: snippetAround(doc.text, highlight, CJK_SNIPPET_CHARS)
 							}
-						}));
+						})), args);
 						hint = items.length > 0 ? cjkFallbackHint(items.length, cfg.cjkHint) : cjkZeroHitHint(query, true, cfg.cjkHint);
 					} else if (items.length === 0) hint = cjkZeroHitHint(query, true, cfg.cjkHint);
 					const red = applyRedaction(items);
@@ -738,6 +779,7 @@ function createRecallTool(config, engine, approver) {
 				const ranked = rankingActive(rankingOptions);
 				let items = rankItems(toItems(page.items, titles).filter((item) => cwdAllowed(item.cwd, cfg)), rankingOptions);
 				if (allowedIds != null) items = items.filter((item) => allowedIds.has(item.sessionId));
+				items = applyDimensionFilters(items, args);
 				let hint = null;
 				let fallbackRan = false;
 				let diagnostics = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-session-recall",
   "description": "Deterministic cross-session transcript retrieval for DeepSeek Harness: the model-facing `recall` tool searches past session logs with explicit scope control",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "publishConfig": {
     "access": "public"
   },