npm - opencode-session-recall - Versions diffs - 0.8.0 → 0.9.0 - Mend

opencode-session-recall 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +110 -11
package/dist/opencode-session-recall.js +111 -90
package/dist/search.d.ts.map +1 -1
package/dist/types.d.ts +5 -0
package/dist/types.d.ts.map +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,5 +1,9 @@
 # opencode-session-recall
+[![npm version](https://img.shields.io/npm/v/opencode-session-recall)](https://www.npmjs.com/package/opencode-session-recall)
+[![npm downloads](https://img.shields.io/npm/dm/opencode-session-recall)](https://www.npmjs.com/package/opencode-session-recall)
+[![license](https://img.shields.io/npm/l/opencode-session-recall)](https://github.com/rmk40/opencode-session-recall/blob/main/LICENSE)
 **Every conversation your agent has ever had — across every session, every project — is already in the database. It's just not looking.**
 [OpenCode](https://github.com/opencode-ai/opencode) stores the full conversation history from every session your agent has ever run — messages, tool calls, tool outputs, reasoning traces. All of it. Not just the current session. Not just the current project. Every project on the machine. Even after compaction shrinks what the model can see, the original content stays in the database — just no longer visible to the agent.
@@ -67,6 +71,47 @@ recall({ query: "chose postgres over", scope: "project", type: "reasoning" })
 Recovers the reasoning behind an architectural decision from three sessions ago. Context that no summary captures.
+**"Find it even with a typo."**
+```
+recall({ query: "prefiltr", match: "fuzzy", scope: "session" })
+```
+Fuzzy search finds `prefilter` even when the agent misremembers the exact spelling. Results ranked by relevance, not just recency.
+**"Which sessions touched this topic?"**
+```
+recall({ query: "rate limiting", scope: "global", match: "smart", group: "session" })
+```
+4 sessions across 3 projects, each with `hitCount` and best representative snippet. One call to discover everywhere a topic came up.
+## Smart and fuzzy search
+Ranked fuzzy retrieval powered by [Fuse.js](https://www.fusejs.io/). Three matching strategies:
+| Mode                | Behavior                            | Best for                                        |
+| ------------------- | ----------------------------------- | ----------------------------------------------- |
+| `literal` (default) | Case-insensitive substring match    | Exact terms, all scopes                         |
+| `smart`             | Fuzzy ranked search (threshold 0.3) | Uncertain wording, typos, separator differences |
+| `fuzzy`             | Looser fuzzy search (threshold 0.5) | Very approximate queries, exploratory search    |
+```
+recall({ query: "rate limit middleware", match: "smart", scope: "project" })
+```
+Smart and fuzzy modes:
+- **Handle typos** — `prefiltr` finds `prefilter`, `ECONNREFUSD` finds `ECONNREFUSED`
+- **Normalize separators** — `rate-limit` matches `rateLimit` matches `rate_limit`
+- **Rank by relevance** — results scored 0–1 with structural boosts for exact phrases, full token coverage, reasoning traces, and recency
+- **Fall back gracefully** — if smart/fuzzy finds nothing, literal search runs automatically
+- **Time-budget degradation** — if ranking takes too long, returns prefilter-ranked results instead of timing out
+- **Explain mode** — add `explain: true` to see scoring breakdowns via `matchReasons`
+Available across all scopes — `"session"`, `"project"`, and `"global"`.
 ## Recall is not memory
 This is not a memory system. Memory is selective and curated. Recall is raw history retrieval — verbatim, exhaustive, on demand.
@@ -107,19 +152,43 @@ The primary tool. Full-text search across messages, tool outputs, tool inputs, r
 recall({ query: "authentication", scope: "project" })
 recall({ query: "error", type: "tool", scope: "session" })
 recall({ query: "JWT", sessionID: "ses_from_another_project" })
+recall({ query: "rate limit", match: "smart", scope: "global", group: "session" })
+recall({ query: "prefiltr", match: "fuzzy", scope: "session", explain: true })
 ```
-| Param            | Default    | Description                                   |
-| ---------------- | ---------- | --------------------------------------------- |
-| `query`          | required   | Text to search for (case-insensitive)         |
-| `scope`          | `"global"` | `"session"`, `"project"`, or `"global"`       |
-| `sessionID`      | —          | Target a specific session (overrides scope)   |
-| `type`           | `"all"`    | `"text"`, `"tool"`, `"reasoning"`, or `"all"` |
-| `role`           | `"all"`    | `"user"`, `"assistant"`, or `"all"`           |
-| `before`/`after` | —          | Timestamp filters (ms epoch)                  |
-| `width`          | `200`      | Snippet size (50–1000 chars)                  |
-| `sessions`       | `10`       | Max sessions to scan                          |
-| `results`        | `10`       | Max results to return                         |
+| Param            | Default     | Description                                                                                                                                                                  |
+| ---------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `query`          | required    | Text to search for                                                                                                                                                           |
+| `scope`          | `"global"`  | `"session"`, `"project"`, or `"global"`                                                                                                                                      |
+| `match`          | `"literal"` | `"literal"`, `"smart"`, or `"fuzzy"`                                                                                                                                         |
+| `explain`        | `false`     | Include scoring metadata in results                                                                                                                                          |
+| `sessionID`      | —           | Target a specific session (overrides scope)                                                                                                                                  |
+| `type`           | `"all"`     | `"text"`, `"tool"`, `"reasoning"`, or `"all"`                                                                                                                                |
+| `role`           | `"all"`     | `"user"`, `"assistant"`, or `"all"`                                                                                                                                          |
+| `before`/`after` | —           | Timestamp filters (ms epoch)                                                                                                                                                 |
+| `width`          | `200`       | Snippet size (50–1000 chars)                                                                                                                                                 |
+| `sessions`       | `10`        | Max sessions to scan                                                                                                                                                         |
+| `title`          | —           | Filter by session title substring (rarely needed)                                                                                                                            |
+| `group`          | `"part"`    | `"part"` or `"session"` — when `"session"`, collapses results by session (one entry per session with the best-scoring or most-recent hit as representative, plus `hitCount`) |
+| `results`        | `10`        | Max results to return                                                                                                                                                        |
+Smart/fuzzy results include additional fields:
+| Field          | Description                                                              |
+| -------------- | ------------------------------------------------------------------------ |
+| `score`        | Relevance score (0–1, higher is better)                                  |
+| `matchMode`    | Which strategy produced this result                                      |
+| `matchedTerms` | Query tokens found in the candidate                                      |
+| `matchReasons` | Scoring breakdown (only when `explain: true`)                            |
+| `hitCount`     | Number of part-level hits in this session (only when `group: "session"`) |
+Response-level metadata for smart/fuzzy:
+| Field         | Description                                                |
+| ------------- | ---------------------------------------------------------- |
+| `matchMode`   | `"smart"`, `"fuzzy"`, or `"literal"` (if fell back)        |
+| `degradeKind` | `"none"`, `"time"`, `"budget"`, or `"fallback"`            |
+| `group`       | `"part"` or `"session"` — echoes back the grouping applied |
 ### `recall_get` — Retrieve
@@ -168,6 +237,18 @@ recall_sessions({ scope: "global", search: "deployment" })
 | `primary` | `boolean` | `true`  | Register tools as primary (available to all agents) |
 | `global`  | `boolean` | `true`  | Allow cross-project search via `scope: "global"`    |
+Advanced limits (all have sensible defaults):
+| Option           | Default | Description             |
+| ---------------- | ------- | ----------------------- |
+| `concurrency`    | `3`     | Parallel session loads  |
+| `maxSessions`    | `50`    | Max sessions per search |
+| `maxResults`     | `50`    | Max results per search  |
+| `maxSessionList` | `100`   | Max sessions in listing |
+| `maxMessages`    | `50`    | Max messages per browse |
+| `maxWindow`      | `10`    | Max context window size |
+| `defaultWidth`   | `200`   | Default snippet width   |
 ## How it works
 When OpenCode compacts a session, it doesn't delete anything. Tool outputs get a `compacted` timestamp and are replaced with placeholder text in the LLM's context — but the original data stays in the database. Messages before a compaction boundary are skipped when building the LLM context — but they're still there.
@@ -179,6 +260,24 @@ This plugin reads all of it through the OpenCode SDK:
 - Sessions scanned newest-first with bounded concurrency
 - Respects abort signals for long-running searches
 - Cross-project search enabled by default (disable with `global: false`)
+- Smart and fuzzy ranking works across all scopes — session, project, and global
+### Smart/fuzzy pipeline
+When `match` is `"smart"` or `"fuzzy"`, the search goes through a multi-stage ranking pipeline:
+1. **Candidate construction** — Messages are scanned newest-first. Each part's searchable text is extracted and tokenized. Per-session and global budgets cap the candidate pool.
+2. **Prefiltering** — Cheap lexical gate using exact substring, quoted phrase, token overlap, and bounded edit-distance (Levenshtein ≤ 1 for tokens ≥ 4 chars). Only candidates with at least one match survive.
+3. **Normalization** — Surviving candidates get full stage-2 normalization (camelCase splitting, separator normalization, whitespace collapse) for Fuse.js field matching.
+4. **Fuse.js ranking** — Weighted search across primary text (0.65), project directory (0.20), session title (0.10), and tool name (0.05). Returns all matches above the mode threshold.
+5. **Structural re-ranking** — Fuse scores are adjusted with deterministic boosts (exact phrase, full token coverage, reasoning traces, error text, user role, recency) and penalties (weak single-token fuzzy, poor coverage).
+6. **Snippet selection** — Token-density sliding window finds the most relevant excerpt from the raw text.
+The entire pipeline runs within a 2-second post-fetch time budget. If the pre-Fuse stage alone exceeds 1.5 seconds, Fuse.js is skipped and prefilter-ranked results are returned with `degradeKind: "time"`. If the full pipeline completes but exceeds the total budget, Fuse-ranked results are still returned but marked as time-degraded.
+## Contributing
+See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture details, module guide, and development setup.
 ## License

package/dist/opencode-session-recall.js CHANGED Viewed

@@ -739,9 +739,9 @@ function smartSnippet(rawText, query, width = 200) {
 }
 // src/search.ts
-var PROMOTED_SCOPES = /* @__PURE__ */ new Set(["session"]);
 var TIME_BUDGET_MS = 2e3;
 var PREFUSE_BUDGET_MS = 1500;
+var MAX_GROUPED_LITERAL_RESULTS = 1e3;
 function meta(s) {
   return { id: s.id, title: s.title, directory: s.directory };
 }
@@ -784,7 +784,7 @@ function scan(messages2, session, query, type, role, limit, before, after, width
   }
   return { results, total };
 }
-function smartScan(allMessages, query, type, role, limit, explain, mode, before, after, width) {
+function smartScan(allMessages, query, type, role, explain, mode, before, after, width) {
   const pq = parseQuery(query);
   const startTime = performance.now();
   const allCandidates = [];
@@ -821,16 +821,10 @@ function smartScan(allMessages, query, type, role, limit, explain, mode, before,
   const prefuseTime = performance.now() - startTime;
   if (prefuseTime > PREFUSE_BUDGET_MS) {
     const ranked2 = rankDegraded(filtered, pq, explain);
-    const results2 = rankedToSearchResults(
-      ranked2.slice(0, limit),
-      mode,
-      explain,
-      pq,
-      width
-    );
+    const results = rankedToSearchResults(ranked2, mode, explain, pq, width);
     return {
-      results: results2,
-      total: filtered.length,
+      results,
+      total: results.length,
       degradeKind: "time",
       matchMode: mode
     };
@@ -842,32 +836,18 @@ function smartScan(allMessages, query, type, role, limit, explain, mode, before,
   const hits = fuseSearch(fuseCandidates, pq, mode);
   const totalTime = performance.now() - startTime;
   const ranked = rank(hits, pq, explain);
-  const fuseTotal = ranked.length;
+  const allResults = rankedToSearchResults(ranked, mode, explain, pq, width);
   if (totalTime > TIME_BUDGET_MS) {
-    const results2 = rankedToSearchResults(
-      ranked.slice(0, limit),
-      mode,
-      explain,
-      pq,
-      width
-    );
     return {
-      results: results2,
-      total: fuseTotal,
+      results: allResults,
+      total: allResults.length,
       degradeKind: "time",
       matchMode: mode
     };
   }
-  const results = rankedToSearchResults(
-    ranked.slice(0, limit),
-    mode,
-    explain,
-    pq,
-    width
-  );
   return {
-    results,
-    total: fuseTotal,
+    results: allResults,
+    total: allResults.length,
     degradeKind: anyBudgetHit ? "budget" : "none",
     matchMode: mode
   };
@@ -898,32 +878,62 @@ function rankedToSearchResults(ranked, mode, explain, query, width) {
     return result;
   });
 }
+function groupBySession(results) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const r of results) {
+    const existing = groups.get(r.sessionID);
+    if (!existing) {
+      groups.set(r.sessionID, { best: r, count: 1 });
+    } else {
+      existing.count++;
+      if (r.score != null && existing.best.score != null) {
+        if (r.score > existing.best.score) {
+          existing.best = r;
+        }
+      } else if (r.time > existing.best.time) {
+        existing.best = r;
+      }
+    }
+  }
+  return [...groups.values()].map(({ best, count }) => ({
+    ...best,
+    hitCount: count
+  }));
+}
 function search(client, unscoped, global, limits) {
   return tool2({
     description: `Search your conversation history in the opencode database. This is the primary discovery tool \u2014 use it before recall_sessions, which only searches titles. Before debugging an issue or implementing a feature, check whether prior sessions already tackled it \u2014 the history shows whether an approach succeeded or was abandoned. If you have access to a memory system, add useful findings to memory so they're available directly next time without searching history.
-Searches text content, tool inputs/outputs, and reasoning via case-insensitive substring matching. Returns matching snippets with session/message IDs you can pass to recall_get for full content, or recall_context if you need surrounding messages.
+Supports three matching strategies via the \`match\` parameter:
+- "literal" (default): case-insensitive substring matching. Works across all scopes. Fast and predictable.
+- "smart": fuzzy ranked search using Fuse.js. Handles typos, separator differences (rate-limit vs rateLimit), and ranks results by relevance. Works across all scopes.
+- "fuzzy": looser fuzzy search with a higher match threshold. Works across all scopes.
+When using smart or fuzzy, results include a relevance \`score\` (0-1, higher is better) and \`matchedTerms\`. Add \`explain: true\` for detailed scoring breakdowns via \`matchReasons\`. If smart/fuzzy finds no matches, it automatically falls back to literal search.
-Searches globally by default \u2014 this is fast and finds results across all projects. Results are ordered by session recency (newest first). Try multiple query terms before concluding no prior work exists. Use role "user" to find original requirements.
+Use \`group: "session"\` to collapse results by session \u2014 returns one entry per session with the best-scoring hit as representative (or most recent for literal), plus a \`hitCount\` showing how many part-level hits that session had. Useful for cross-project discovery: "which sessions are about this topic?"
+Searches globally by default \u2014 this is fast and finds results across all projects. Results are ordered by session recency (newest first) for literal, or by relevance score for smart/fuzzy. Try multiple query terms before concluding no prior work exists. Use role "user" to find original requirements.
 Scope costs: all scopes scan up to \`sessions\` sessions (default 10). "session" scans 1. "project" and "global" scan up to 10 newest. Increase \`sessions\` if nothing found.
 Returns { ok, results: [{ sessionID, messageID, role, time, partID, partType, pruned, snippet, toolName? }], scanned, total, truncated }. Each result includes a pruned flag \u2014 if true, the content was compacted from your context window and recall_get will return the original full output. Check truncated to know if more matches exist beyond your results limit.
-This tool's own outputs are excluded from search results to prevent recursive noise; use recall_get or recall_context to retrieve any message directly.
-Use match:"smart" for fuzzy search when exact wording is uncertain \u2014 it handles typos, separator differences (rate-limit vs rateLimit), and ranks results by relevance. Currently available for scope:"session" only.`,
+This tool's own outputs are excluded from search results to prevent recursive noise; use recall_get or recall_context to retrieve any message directly.`,
     args: {
       query: tool2.schema.string().min(1).describe("Text to search for (case-insensitive substring match)"),
       scope: tool2.schema.enum(["session", "project", "global"]).default("global").describe(
         "global = all projects (default), project = current project, session = current only. Searching broadly is fast."
       ),
       match: tool2.schema.enum(["literal", "smart", "fuzzy"]).default("literal").describe(
-        'Matching strategy: "literal" = exact substring (default), "smart" = fuzzy ranked search (session scope only), "fuzzy" = looser fuzzy search (session scope only)'
+        'Matching strategy: "literal" = exact substring (default), "smart" = fuzzy ranked search, "fuzzy" = looser fuzzy search. All work across all scopes.'
       ),
       explain: tool2.schema.boolean().default(false).describe(
         "Return scoring metadata for debugging. Adds matchReasons to each result."
       ),
+      group: tool2.schema.enum(["part", "session"]).default("part").describe(
+        '"part" (default) = one result per matching part. "session" = collapse by session, returning one entry per session with best-scoring (smart/fuzzy) or most-recent (literal) hit and a hitCount.'
+      ),
       sessionID: tool2.schema.string().optional().describe("Search a specific session (overrides scope)"),
       type: tool2.schema.enum(["text", "tool", "reasoning", "all"]).default("all").describe("Filter by part type"),
       role: tool2.schema.enum(["user", "assistant", "all"]).default("all").describe("Filter by message role"),
@@ -947,16 +957,6 @@ Use match:"smart" for fuzzy search when exact wording is uncertain \u2014 it han
       ctx.metadata({
         title: `Searching ${args.scope} for "${args.query}"${matchMode !== "literal" ? ` (${matchMode})` : ""}`
       });
-      if (matchMode !== "literal") {
-        const effectiveScope = args.sessionID ? "session" : args.scope;
-        if (!PROMOTED_SCOPES.has(effectiveScope)) {
-          const err = {
-            ok: false,
-            error: `match:"${matchMode}" is not yet available for scope:"${effectiveScope}". Try scope:"session" or use match:"literal" for broader searches.`
-          };
-          return JSON.stringify(err);
-        }
-      }
       if (args.scope === "global" && !args.sessionID && !global) {
         const err = {
           ok: false,
@@ -1046,16 +1046,18 @@ Use match:"smart" for fuzzy search when exact wording is uncertain \u2014 it han
           const err = { ok: false, error: "aborted" };
           return JSON.stringify(err);
         }
-        if (matchMode === "literal") {
+        const groupMode = args.group;
+        const isGrouped = groupMode === "session";
+        const literalScan = (scanLimit) => {
           const collected = [];
           let total = 0;
           let early = false;
           for (const { session: sess, messages: msgs } of allLoaded) {
-            if (collected.length >= args.results) {
+            if (collected.length >= scanLimit) {
               early = true;
               break;
             }
-            const remaining = args.results - collected.length;
+            const remaining = scanLimit - collected.length;
             const result = scan(
               msgs,
               sess,
@@ -1070,16 +1072,44 @@ Use match:"smart" for fuzzy search when exact wording is uncertain \u2014 it han
             collected.push(...result.results);
             total += result.total;
           }
-          const final = collected.slice(0, args.results);
+          return { collected, total, early };
+        };
+        const applyGroupAndSlice = (results, partTotal, earlyExit) => {
+          if (isGrouped) {
+            const grouped = groupBySession(results);
+            const final3 = grouped.slice(0, args.results);
+            return {
+              final: final3,
+              total: grouped.length,
+              truncated: earlyExit || grouped.length > final3.length
+            };
+          }
+          const final2 = results.slice(0, args.results);
+          return {
+            final: final2,
+            total: partTotal,
+            truncated: earlyExit || partTotal > final2.length
+          };
+        };
+        if (matchMode === "literal") {
+          const limit = isGrouped ? MAX_GROUPED_LITERAL_RESULTS : args.results;
+          const { collected, total, early } = literalScan(limit);
+          const {
+            final: final2,
+            total: outTotal2,
+            truncated: truncated2
+          } = applyGroupAndSlice(collected, total, early);
+          const unit2 = isGrouped ? "session" : "result";
           ctx.metadata({
-            title: `Found ${final.length} result${final.length !== 1 ? "s" : ""} for "${args.query}" (${scanned} session${scanned !== 1 ? "s" : ""} searched)`
+            title: `Found ${final2.length} ${unit2}${final2.length !== 1 ? "s" : ""} for "${args.query}" (${scanned} session${scanned !== 1 ? "s" : ""} searched)`
           });
           const out2 = {
             ok: true,
-            results: final,
+            results: final2,
             scanned,
-            total,
-            truncated: early || total > final.length
+            total: outTotal2,
+            truncated: truncated2,
+            group: groupMode
           };
           return JSON.stringify(out2);
         }
@@ -1088,7 +1118,6 @@ Use match:"smart" for fuzzy search when exact wording is uncertain \u2014 it han
           args.query,
           args.type,
           args.role,
-          args.results,
           args.explain,
           matchMode,
           args.before,
@@ -1096,57 +1125,49 @@ Use match:"smart" for fuzzy search when exact wording is uncertain \u2014 it han
           args.width
         );
         if (smartResult.results.length === 0) {
-          const collected = [];
-          let total = 0;
-          let early = false;
-          for (const { session: sess, messages: msgs } of allLoaded) {
-            if (collected.length >= args.results) {
-              early = true;
-              break;
-            }
-            const remaining = args.results - collected.length;
-            const result = scan(
-              msgs,
-              sess,
-              args.query,
-              args.type,
-              args.role,
-              remaining,
-              args.before,
-              args.after,
-              args.width
-            );
-            collected.push(...result.results);
-            total += result.total;
-          }
-          const final = collected.slice(0, args.results);
-          if (final.length > 0) {
+          const limit = isGrouped ? MAX_GROUPED_LITERAL_RESULTS : args.results;
+          const { collected, total, early } = literalScan(limit);
+          const {
+            final: final2,
+            total: outTotal2,
+            truncated: truncated2
+          } = applyGroupAndSlice(collected, total, early);
+          if (final2.length > 0) {
+            const unit2 = isGrouped ? "session" : "result";
             ctx.metadata({
-              title: `Found ${final.length} result${final.length !== 1 ? "s" : ""} for "${args.query}" (literal fallback, ${scanned} session${scanned !== 1 ? "s" : ""})`
+              title: `Found ${final2.length} ${unit2}${final2.length !== 1 ? "s" : ""} for "${args.query}" (literal fallback, ${scanned} session${scanned !== 1 ? "s" : ""})`
             });
             const out2 = {
               ok: true,
-              results: final,
+              results: final2,
               scanned,
-              total,
-              truncated: early || total > final.length,
+              total: outTotal2,
+              truncated: truncated2,
               matchMode: "literal",
-              degradeKind: "fallback"
+              degradeKind: "fallback",
+              group: groupMode
             };
             return JSON.stringify(out2);
           }
         }
+        const {
+          final,
+          total: outTotal,
+          truncated
+        } = applyGroupAndSlice(smartResult.results, smartResult.total, false);
+        const unit = isGrouped ? "session" : "result";
         ctx.metadata({
-          title: `Found ${smartResult.results.length} result${smartResult.results.length !== 1 ? "s" : ""} for "${args.query}" (${matchMode}, ${scanned} session${scanned !== 1 ? "s" : ""})`
+          title: `Found ${final.length} ${unit}${final.length !== 1 ? "s" : ""} for "${args.query}" (${matchMode}, ${scanned} session${scanned !== 1 ? "s" : ""})`
         });
         const out = {
           ok: true,
-          results: smartResult.results,
+          results: final,
           scanned,
-          total: smartResult.total,
-          truncated: smartResult.total > smartResult.results.length,
+          total: outTotal,
+          truncated,
           matchMode: smartResult.matchMode,
-          degradeKind: smartResult.degradeKind
+          degradeKind: smartResult.degradeKind,
+          group: groupMode
         };
         return JSON.stringify(out);
       } catch (e) {

package/dist/search.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAKL,KAAK,MAAM,~~EAGZ~~,MAAM,YAAY,CAAC;~~AA0RpB~~,wBAAgB,MAAM,CACpB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb,cAAc,~~CAmVhB~~"}
1	+ {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAKL,KAAK,MAAM,EAIZ,MAAM,YAAY,CAAC;AA+RpB,wBAAgB,MAAM,CACpB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CAgXhB"}

package/dist/types.d.ts CHANGED Viewed

@@ -11,6 +11,7 @@ export type Limits = {
 export declare const DEFAULTS: Limits;
 export type MatchMode = "literal" | "smart" | "fuzzy";
 export type DegradeKind = "none" | "time" | "budget" | "fallback";
+export type GroupMode = "part" | "session";
 export type SearchResult = {
     sessionID: string;
     sessionTitle: string;
@@ -31,6 +32,8 @@ export type SearchResult = {
     matchedTerms?: string[];
     /** Present when explain=true */
     matchReasons?: string[];
+    /** Present when group:"session" — number of part-level hits in this session */
+    hitCount?: number;
 };
 export type SearchOutput = {
     ok: true;
@@ -42,6 +45,8 @@ export type SearchOutput = {
     matchMode?: MatchMode;
     /** What happened during ranking */
     degradeKind?: DegradeKind;
+    /** Which grouping was applied */
+    group?: GroupMode;
 };
 export type MessageOutput = {
     ok: true;

package/dist/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,2FAMR,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAQtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;~~AAElE~~,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;~~CACzB~~,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mCAAmC;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC;~~CAC3B~~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"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,2FAMR,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAQtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAClE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mCAAmC;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iCAAiC;IACjC,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,OAAO,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAYzC"}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "opencode-session-recall",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "type": "module",
   "description": "Everything your agent ever did is already in the database — this plugin lets it look",
   "main": "./dist/opencode-session-recall.js",