opencode-raven 1.2.6 → 1.2.8

package/README.md

@@ -40,14 +40,14 @@ Restart opencode.
 
 | Command | Action |
 |---------|--------|
-| `/raven` | Show status — enabled/disabled, model, reasoning effort, timeout |
+| `/raven` | Show status — enabled/disabled, version, update availability, model, reasoning effort, timeout (no args) |
 | `/raven on` | Enable search tool redirection (default) |
 | `/raven off` | Disable interception — all agents can use search tools directly |
 | `/raven update` | Check npm for a newer Raven, clear opencode's plugin cache if needed, then restart opencode |
 | `/raven model <name>` | Change Raven's model (requires restart) |
 | `/raven effort <value>` | Change Raven's reasoning effort (requires restart) |
 | `/raven timeout <seconds>` | Change raven_seek timeout (min 10s, takes effect immediately) |
-| `/raven stats` | Show context processed (session + all-time, bytes + tokens) |
+| `/raven stats` | Show context saved (session + all-time, bytes + tokens) |
 
 Config persists across restarts in `~/.config/opencode/raven-config.json` (global, shared across all projects). Auto-created on first run.
 
@@ -55,7 +55,7 @@ Config persists across restarts in `~/.config/opencode/raven-config.json` (globa
 
 opencode caches npm plugins, so `"opencode-raven"` / `"opencode-raven@latest"` may not automatically refresh after a new npm release.
 
-Raven checks npm at startup. If an update is available, it shows a TUI notification. To update:
+Raven checks npm after the TUI starts. If an update is available, it shows a notification. `/raven` also shows the current version and update availability. To update:
 
 ```txt
 /raven update
@@ -168,6 +168,7 @@ To disable an MCP entirely:
 | `config` | Registers Raven agent, merges Context7/Exa/Grep.app MCP defaults, loads MCP guidance |
 | `tool` | Registers `raven_seek` — creates Raven sessions with timeout, error recovery, timing, and session tree visibility. Tracks context processed for stats (both `raven_seek` and direct `@Raven`). |
 | `chat.message` | Tracks agent ↔ session mapping for allowlist and Raven exclusion |
+| `event` | Shows startup update notifications after the TUI event stream is ready |
 | `command.execute.before` | Handles `/raven on\|off\|update\|model\|effort\|timeout\|stats\|status` |
 | `tool.execute.before` | Blocks search tools for non-Raven, non-excluded agents (respects `excludeTools`). Error output gives the next `raven_seek(query="...")` call. Injects concise `<raven_guidance>` into subagent prompts. |
 | `tool.execute.after` | Counts output bytes from direct `@Raven` calls for accurate stats. |

package/index.ts

@@ -262,7 +262,12 @@ export default ((input: PluginInput) => {
   let config = loadConfig()
   const ravenSessions = new Set<string>()
   const ravenTaskCalls = new Set<string>()
+  const ravenTaskPrompts = new Map<string, number>()
   const sessionAgents = new Map<string, string>()
+  const ravenSessionParents = new Map<string, string>()
+  let updateInfo: { current: string; latest?: string; available: boolean } | undefined
+  let updateCheckPromise: Promise<{ current: string; latest?: string; available: boolean }> | undefined
+  let updateToastPending = false
 
   // ── Check if an agent is excluded from Raven enforcement (case-insensitive) ──
   function isExcluded(agent: string | undefined): boolean {
@@ -320,12 +325,19 @@ export default ((input: PluginInput) => {
   }
 
   async function fetchLatestVersion(): Promise<string | undefined> {
-    const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
-      headers: { accept: "application/json" },
-    })
-    if (!res.ok) return undefined
-    const data = await res.json() as { version?: string }
-    return data.version
+    const controller = new AbortController()
+    const timeout = setTimeout(() => controller.abort(), 5000)
+    try {
+      const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+        headers: { accept: "application/json" },
+        signal: controller.signal,
+      })
+      if (!res.ok) return undefined
+      const data = await res.json() as { version?: string }
+      return data.version
+    } finally {
+      clearTimeout(timeout)
+    }
   }
 
   async function checkForUpdate(): Promise<{ current: string; latest?: string; available: boolean }> {
@@ -333,6 +345,50 @@ export default ((input: PluginInput) => {
     return { current: PACKAGE_VERSION, latest, available: !!latest && compareVersions(latest, PACKAGE_VERSION) > 0 }
   }
 
+  async function countRavenSessionBytes(sessionId: string): Promise<number> {
+    // Get last assistant message token counts (matches TUI bottom bar)
+    const messagesResp = await client.session.messages({ path: { id: sessionId }, query: { limit: 200 } })
+    const messages = (messagesResp as any)?.data ?? []
+    // Find last assistant message with output tokens (same logic as TUI subagent-footer.tsx)
+    const last = [...messages].reverse().find((m: any) =>
+      m?.info?.role === "assistant" && m?.info?.tokens?.output > 0
+    )
+    const t = last?.info?.tokens
+    if (!t) return 0
+    const totalTokens = (t.input ?? 0) + (t.output ?? 0) + (t.reasoning ?? 0) + (t.cache?.read ?? 0) + (t.cache?.write ?? 0)
+    return totalTokens * 4
+  }
+
+  async function getUpdateInfo(): Promise<{ current: string; latest?: string; available: boolean }> {
+    if (updateInfo) return updateInfo
+    if (!updateCheckPromise) {
+      updateCheckPromise = checkForUpdate()
+        .then((info) => {
+          updateInfo = info
+          return info
+        })
+        .catch((err) => {
+          updateCheckPromise = undefined
+          throw err
+        })
+    }
+    return updateCheckPromise
+  }
+
+  async function refreshUpdateInfo(): Promise<{ current: string; latest?: string; available: boolean }> {
+    updateInfo = undefined
+    updateCheckPromise = checkForUpdate()
+      .then((info) => {
+        updateInfo = info
+        return info
+      })
+      .catch((err) => {
+        updateCheckPromise = undefined
+        throw err
+      })
+    return updateCheckPromise
+  }
+
   function clearPluginCache(): string[] {
     const packagesDir = join(homedir(), ".cache", "opencode", "packages")
     if (!existsSync(packagesDir)) return []
@@ -353,7 +409,7 @@ export default ((input: PluginInput) => {
 
   async function notifyIfUpdateAvailable() {
     try {
-      const info = await checkForUpdate()
+      const info = await getUpdateInfo()
       if (!info.available || !info.latest) return
       await (client as any).tui?.showToast?.({
         body: {
@@ -417,7 +473,7 @@ export default ((input: PluginInput) => {
         }
       }
 
-      void notifyIfUpdateAvailable()
+      updateToastPending = true
     },
 
     // Register raven_seek tool — lets agents with task:false still search through Raven
@@ -480,10 +536,23 @@ export default ((input: PluginInput) => {
               .map((p: any) => p.text)
             const output = textParts.join("\n") || "Raven returned no results."
 
-            // Track context saved
-            addBytes(output.length)
+            // Get total Raven session context and subtract input/output to get context saved
+            let totalProcessed = 0
+            try {
+              totalProcessed = await countRavenSessionBytes(sessionId)
+            } catch { /* best-effort */ }
+            if (totalProcessed <= 0) {
+              for (const part of parts) {
+                if (part.text) totalProcessed += part.text.length
+                if (part.args) totalProcessed += JSON.stringify(part.args).length
+                if (part.content) totalProcessed += typeof part.content === "string" ? part.content.length : JSON.stringify(part.content).length
+              }
+            }
+            // Context saved = total session context − input query − compact answer returned
+            const saved = Math.max(0, totalProcessed - output.length - String(args.query).length)
+            addBytes(saved)
 
-            return { title: "Raven Seek", metadata: { sessionId }, output: `${output}\n\n*Raven searched for ${elapsed}s — ${formatBytes(output.length)}, ~${formatTokens(output.length)} tokens*` }
+            return { title: "Raven Seek", metadata: { sessionId }, output: `${output}\n\n*Raven searched for ${elapsed}s — ${formatBytes(totalProcessed)} processed, ${formatTokens(totalProcessed)} tokens*` }
           } catch (err: any) {
             const elapsed = ((Date.now() - started) / 1000).toFixed(1)
             const msg = String(err?.message ?? err ?? "").toLowerCase()
@@ -510,6 +579,18 @@ export default ((input: PluginInput) => {
       }
     },
 
+    event(input: { event: any }) {
+      // Track subagent session → parent mapping for accurate context counting
+      const evt = input.event
+      if (evt?.type === "session.created" && evt?.properties?.parentID) {
+        ravenSessionParents.set(evt.properties.parentID, evt.properties.id)
+      }
+
+      if (!updateToastPending) return
+      updateToastPending = false
+      setTimeout(() => void notifyIfUpdateAvailable(), 500)
+    },
+
     // /raven on|off|model <name>|effort <value>|timeout <seconds>|stats|status
     async "command.execute.before"(input: any, output: any) {
       if (input.command !== "raven") return
@@ -526,10 +607,10 @@ export default ((input: PluginInput) => {
         saveConfig(config)
         output.parts.push({ type: "text", text: "Raven search interception disabled. All agents can use search tools directly." })
       } else if (arg === "stats") {
-        output.parts.push({ type: "text", text: `Raven context processed:\n  This session: ${formatBytes(sessionBytes)} (~${formatTokens(sessionBytes)} tokens)\n  All time: ${formatBytes(totalBytes)} (~${formatTokens(totalBytes)} tokens)` })
+        output.parts.push({ type: "text", text: `Raven context saved:\n  This session: ${formatBytes(sessionBytes)} (~${formatTokens(sessionBytes)} context)\n  All time: ${formatBytes(totalBytes)} (~${formatTokens(totalBytes)} context)` })
       } else if (arg === "update") {
         try {
-          const info = await checkForUpdate()
+          const info = await refreshUpdateInfo()
           if (!info.latest) {
             output.parts.push({ type: "text", text: `Could not check npm for ${PACKAGE_NAME}. Try again later.\n\n${manualUpdateText()}` })
           } else if (!info.available) {
@@ -573,7 +654,14 @@ export default ((input: PluginInput) => {
         const model = config.model || fm.model || "(default)"
         const effort = config.reasoning_effort || fm.reasoning_effort || "(default)"
         const timeout = config.timeout ?? 180
-        output.parts.push({ type: "text", text: `Raven is ${enabled}. Model: ${model}. Reasoning: ${effort}. Timeout: ${timeout}s\n\nCommands:\n  /raven on      — enable search interception\n  /raven off     — disable search interception\n  /raven update  — check npm, clear plugin cache if newer, then restart opencode\n  /raven model <name> — change Raven's model (requires restart)\n  /raven effort <value> — change Raven's reasoning effort (requires restart)\n  /raven timeout <seconds> — change raven_seek timeout\n  /raven stats   — show blocked calls and context saved` })
+        let update = "Update: unable to check npm."
+        try {
+          const info = await getUpdateInfo()
+          update = info.available && info.latest
+            ? `Update: ${info.latest} available. Run /raven update, then restart opencode.`
+            : `Update: up to date${info.latest ? ` (latest ${info.latest})` : ""}.`
+        } catch { /* keep fallback */ }
+        output.parts.push({ type: "text", text: `Raven is ${enabled}. Version: ${PACKAGE_VERSION}. Model: ${model}. Reasoning: ${effort}. Timeout: ${timeout}s\n${update}\n\nRaven context saved:\n  This session: ${formatBytes(sessionBytes)} (~${formatTokens(sessionBytes)} context)\n  All time: ${formatBytes(totalBytes)} (~${formatTokens(totalBytes)} context)\n\nCommands:\n  /raven on      — enable search interception\n  /raven off     — disable search interception\n  /raven update  — check npm, clear plugin cache if newer, then restart opencode\n  /raven model <name> — change Raven's model (requires restart)\n  /raven effort <value> — change Raven's reasoning effort (requires restart)\n  /raven timeout <seconds> — change raven_seek timeout\n  /raven stats   — show context saved` })
       }
     },
 
@@ -592,6 +680,10 @@ export default ((input: PluginInput) => {
         const subagentType = input.tool === "task" ? (output.args.subagent_type ?? "") : ""
         if (subagentType === "raven") {
           ravenTaskCalls.add(input.callID)
+          const promptField = ["prompt", "description", "request", "objective", "query"].find(
+            (f) => f in output.args
+          ) ?? "prompt"
+          ravenTaskPrompts.set(input.callID, String(output.args[promptField] ?? "").length)
         }
         if (subagentType !== "raven" && !isExcluded(subagentType)) {
           const field = ["prompt", "description", "request", "objective", "query"].find(
@@ -613,8 +705,27 @@ export default ((input: PluginInput) => {
     "tool.execute.after"(input: any, output: any) {
       if (ravenTaskCalls.has(input.callID)) {
         ravenTaskCalls.delete(input.callID)
-        const outputLen = String(output.output ?? "").length
-        if (outputLen > 0) addBytes(outputLen)
+        const promptBytes = ravenTaskPrompts.get(input.callID) ?? 0
+        ravenTaskPrompts.delete(input.callID)
+        // Try task metadata first (built-in tools preserve metadata)
+        const ravenSessionId = output.metadata?.sessionId ?? ravenSessionParents.get(input.sessionID)
+        if (ravenSessionId) {
+          if (ravenSessionParents.has(input.sessionID)) ravenSessionParents.delete(input.sessionID)
+          void countRavenSessionBytes(ravenSessionId)
+            .then((total) => {
+              const saved = Math.max(0, total - promptBytes - String(output.output ?? "").length)
+              if (saved > 0) addBytes(saved)
+            })
+            .catch(() => {
+              const outputLen = String(output.output ?? "").length
+              const saved = Math.max(0, outputLen - promptBytes)
+              if (saved > 0) addBytes(saved)
+            })
+        } else {
+          const outputLen = String(output.output ?? "").length
+          const saved = Math.max(0, outputLen - promptBytes)
+          if (saved > 0) addBytes(saved)
+        }
       }
     },
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-raven",
-  "version": "1.2.6",
+  "version": "1.2.8",
   "description": "Search-first subagent for opencode — intercepts search tools and routes them through a hidden Raven agent with Context7, Exa AI, and Grep.app MCPs",
   "main": "./index.ts",
   "exports": {