dsh-session-recall 0.6.0 → 0.7.0

package/README.md

@@ -21,7 +21,7 @@ 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** |
 

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.0",
   "publishConfig": {
     "access": "public"
   },