opencode-session-recall 0.6.0 → 0.7.0

package/dist/opencode-session-recall.js

@@ -40,9 +40,9 @@ function errmsg(e) {
 // src/sessions.ts
 function sessions(client, unscoped, global, limits) {
   return tool({
-    description: `List sessions from the opencode database. Use this FIRST to discover which sessions exist, then search their content with recall. Also use at session start to check if related work exists in other sessions or projects.
+    description: `List sessions from the opencode database. Returns session titles, directories, and timestamps. For cross-project discovery, use scope "global" (enabled by default, disable with plugin option global: false).
 
-Search filters by session title only (case-insensitive substring match \u2014 use recall for content search). Sessions are returned newest-updated first. This is a cheap metadata-only call.
+This is a metadata-only listing tool, NOT a content search. Session titles are usually auto-generated timestamps and won't match topic keywords. To find prior work on a topic, use recall (content search) instead \u2014 it searches inside actual messages and tool outputs. Use recall_sessions to browse recent sessions by project, check session recency, or get session IDs for recall_messages.
 
 Returns { ok, sessions: [{ id, title, directory, time, archived }], returned, scope }. All tools return JSON with ok: true on success or ok: false with error on failure.`,
     args: {
@@ -312,33 +312,33 @@ function scan(messages2, session, query, type, role, limit, before, after, width
 }
 function search(client, unscoped, global, limits) {
   return tool2({
-    description: `Search your conversation history in the opencode database. Use this to recover context lost to compaction \u2014 original tool outputs, earlier messages, reasoning, and user instructions that were pruned from your context window. 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.
+    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.
 
-Start with scope "session" (fastest). Widen to "project" if not found. Use sessionID param to target a specific session found via recall_sessions. Use role "user" to find original requirements.
+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.
 
-Scope costs: "session" scans 1 session. "project" scans up to \`sessions\` sessions (default 10). "global" scans across all projects.
+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.`,
     args: {
       query: tool2.schema.string().min(1).describe("Text to search for (case-insensitive substring match)"),
-      scope: tool2.schema.enum(["session", "project", "global"]).default("session").describe(
-        "session = current, project = all project sessions, global = all"
+      scope: tool2.schema.enum(["session", "project", "global"]).default("global").describe(
+        "global = all projects (default), project = current project, session = current only. Searching broadly is fast."
       ),
       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"),
       sessions: tool2.schema.number().min(1).max(limits.maxSessions).default(Math.min(10, limits.maxSessions)).describe(
-        "Max sessions to scan (controls cost for project/global scope)"
+        "Max sessions to scan. Increase if nothing found \u2014 default 10 may miss older sessions."
       ),
       results: tool2.schema.number().min(1).max(limits.maxResults).default(Math.min(10, limits.maxResults)).describe(
         "Max results to return. Check truncated in response for more."
       ),
       title: tool2.schema.string().optional().describe(
-        "Filter sessions by title before scanning (same as recall_sessions search)"
+        "Filter sessions by title before scanning (rarely useful \u2014 titles are usually auto-generated)"
       ),
       before: tool2.schema.number().optional().describe("Only match messages before this timestamp (ms epoch)"),
       after: tool2.schema.number().optional().describe("Only match messages after this timestamp (ms epoch)"),

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "opencode-session-recall",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "Agent memory without a memory system — search and retrieve opencode conversation history that was lost to compaction, across sessions and projects",
   "main": "./dist/opencode-session-recall.js",