opencode-recall 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tarquinen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,161 @@
+# OpenCode Recall 🧠
+
+> **Tool I/O 越聊越多占满上下文？剪掉它，留指针，随时恢复。**
+
+---
+
+## ⚡️ 核心痛点
+
+OpenCode 已经有"单次工具输出超限就截断，并把完整输出临时写到 `tool-output/`"的兜底机制（通常还会附带如何用 `grep` / `read offset/limit` / 子代理继续处理的提示）。
+但更常见、也更影响体验的问题是：**输出没超限，却在长会话里不断累积** —— 你每一轮都在为同一批历史工具 I/O 反复付 token。
+
+你是否遇到过：
+
+- ❌ 单次日志/文件读取不大，但 10+ 轮后上下文被几十次工具输出拖到很臃肿（慢、贵、容易跑偏）
+- ❌ 同一个命令反复跑、同一个文件反复读：旧输出早就"过期"了，却仍然占着上下文
+- ❌ `write`/`edit` 的大输入（content/patch）在后续 `read` 到最新文件后已经冗余，但还在上下文里付 token
+- ❌ 触发 compaction/summary 后，想回到"当时的原始证据"核对细节，却拿不到
+
+**Recall 的解决方案：把热上下文变成冷存储（可逆、可探索）**
+
+| Before Recall                                 | After Recall                                                    |
+| :-------------------------------------------- | :-------------------------------------------------------------- |
+| 🐢 上下文越聊越胖（重复/过期的工具 I/O 堆积） | ⚡ 用 `[RCL:...]` 指针替代；原文落盘到 `.opencode/rcl/blobs/`   |
+| 🔍 想找关键信息只能翻历史/重跑工具            | 🔎 `rcl_explore` 子会话读取/搜索，只带回结论                    |
+| 💸 每一轮都为历史输出重复付 token             | 💰 自动去重/剪枝（不额外调用 LLM），需要时再 `rcl_restore`/探索 |
+
+```
+┌─────────────────────────────────┬─────────────────────────────────────┐
+│  Before Recall                  │  After Recall                        │
+├─────────────────────────────────┼─────────────────────────────────────┤
+│  [build log ~6KB]               │  [RCL:o:.opencode/rcl/blobs/... ]    │
+│  [git diff ~3KB]                │  (restore_chars≈6K)                  │
+│  [read src/app.ts ~2KB]         │                                      │
+│  ...                            │  ↓ 需要时再恢复/探索                  │
+│                                 │  rcl_explore(path="[RCL:o:...]",     │
+│                                 │             question="找出关键报错") │
+│                                 │  rcl_restore(path="[RCL:o:...],     │
+│                                 │             force=true)              │
+│  上下文: 逐轮膨胀 💥             │  上下文: 保持精简 ✅                   │
+└─────────────────────────────────┴─────────────────────────────────────┘
+```
+
+### 📊 实测效果
+
+以 [Demo 场景](./demo/README.md) 为例：运行构建命令两次（触发去重剪枝）→ 用 `rcl_explore` 从被剪枝的日志中提取报错 → 修复问题并验证 → 生成并保存项目说明（触发 supersedeWrites 剪枝）→ 用 `rcl_restore` 恢复原始日志核对细节。
+
+**启用 Recall 后，上下文占用 ≈ 8%**
+
+![启用 Recall](./assets/image-20260122005619218.png)
+
+**不启用 Recall，上下文占用 ≈ 21%**
+
+![不启用 Recall](./assets/image-20260122010103460.png)
+
+> 同样的 6 轮对话，上下文占用减少约 60%。
+> ┌─────────────────────────────────┬─────────────────────────────────────┐
+> │ Before Recall │ After Recall │
+> ├─────────────────────────────────┼─────────────────────────────────────┤
+> │ [build log ~6KB] │ [RCL:o:.opencode/rcl/blobs/... ] │
+> │ [git diff ~3KB] │ (restore_chars≈6K) │
+> │ [read src/app.ts ~2KB] │ │
+> │ ... │ ↓ 需要时再恢复/探索 │
+> │ │ rcl_explore(path="[RCL:o:...]", │
+> │ │ question="找出关键报错") │
+> │ │ rcl_restore(path="[RCL:o:...]", │
+> │ │ force=true) │
+> │ 上下文: 逐轮膨胀 💥 │ 上下文: 保持精简 ✅ │
+> └─────────────────────────────────┴─────────────────────────────────────┘
+
+````
+
+## 🚀 快速安装
+
+无需复杂配置，即刻生效。
+
+### 1. 安装插件
+
+在项目根目录的 OpenCode 配置文件中添加：
+
+```jsonc
+// .opencode/opencode.jsonc
+{
+    "plugin": ["opencode-recall@latest"],
+}
+```
+
+### 2. 重启 OpenCode
+
+插件会自动开始工作，拦截并优化冗余的工具输出。
+
+## ✨ 核心特性
+
+- **✂️ 智能去重 (Deduplication)**  
+  自动识别重复的 `read` 或 `ls` 操作，只保留最新版本。旧的调用会自动折叠。
+
+- **💾 落盘存档 (Offloading)**  
+  当 Recall 识别到“重复/过期/可替代”的工具 I/O 时，会把原始内容写入 `.opencode/rcl/blobs/`（项目内），上下文中只留 `[RCL:o:...]` / `[RCL:i:...]` 指针。
+
+- **🔍 子代理探索 (Sub-agent Exploration)**  
+  不想把整个大文件恢复到主上下文？使用 `rcl_explore` 启动一个独立子会话，帮你读取大文件并提取关键信息，只把结论传回主会话。
+
+- **🛡️ 可逆剪枝**  
+  所有被剪掉的内容都是**安全**的。随时可以通过 `rcl_restore` 找回当时的完整快照。
+
+## 📖 动手体验
+
+我们准备了一个包含故障排查场景的 5 分钟演示脚本，带你体验“剪枝 -> 探索 -> 恢复”的全流程。
+
+👉 **[点击查看演示指南](./demo/README.md)**
+
+## 🛠️ 配置详解
+
+Recall 开箱即用，但也支持深度定制。配置文件支持 `~/.config/opencode/rcl.jsonc` (全局) 或 `.opencode/rcl.jsonc` (项目级)。
+
+```jsonc
+{
+    "enabled": true,
+    "pruneNotification": "detailed", // "off" | "minimal" | "detailed"
+    // 保护最近 N 轮不被剪枝
+    "turnProtection": {
+        "enabled": false,
+        "turns": 4,
+    },
+    // 永远不剪枝这些文件
+    "protectedFilePatterns": ["**/*.env", "**/secrets/**"],
+    // 子代理配置
+    "explore": {
+        "enabled": true,
+        "agentVariant": "low", // 使用低成本模型探索
+        "maxResultChars": 4000,
+    },
+}
+```
+
+更多配置项请参考 [rcl.schema.json](./rcl.schema.json)。
+
+## ❓ 常见问题 (FAQ)
+
+**Q: 剪枝把文件落盘了，后面要用还要读回来，这有什么意义？**  
+A: Recall 的核心价值是将“**热数据**（会被每一轮反复带入上下文的历史工具 I/O）”转变为“**冷数据**（落盘指针，可按需恢复/探索）”。
+
+- **不剪枝**：哪怕每次只有几 KB，累积到 10+ 轮时仍会被反复计入上下文，持续消耗 Token。
+- **剪枝后**：默认只在需要时才恢复；更推荐用 `rcl_explore` 读取/搜索并带回结论，避免把原文整块塞回主上下文。
+
+**Q: 我怎么知道哪些内容被剪了？**  
+A: 插件会在 OpenCode 中通过 Toast 弹窗（通知栏）提示节省了多少 Token。上下文中也会留下 `[RCL:...]` 标记作为线索。
+
+## 开发与贡献
+
+```bash
+# 构建
+npm run build
+
+# 本地调试 (链接到 OpenCode)
+# .opencode/opencode.jsonc
+{ "plugin": ["file:///abs/path/to/opencode-recall/dist/index.js"] }
+```
+
+## Attribution
+
+本项目灵感来源于 `@tarquinen/opencode-dcp`，并在此基础上增加了“可逆恢复”与“子代理探索”等特性。

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAUjD,QAAA,MAAM,MAAM,EAAE,MA0IK,CAAA;AAEnB,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -0,0 +1,123 @@
+import { getConfig } from "./lib/config";
+import { Logger } from "./lib/logger";
+import { createSessionState } from "./lib/state";
+import { createDiscardTool, createExtractTool } from "./lib/strategies";
+import { createChatMessageTransformHandler, createSystemPromptHandler } from "./lib/hooks";
+import { createRestoreTool } from "./lib/restore-tool";
+import { createExploreTool } from "./lib/explore-tool";
+import { loadPrompt } from "./lib/prompts";
+const plugin = (async (ctx) => {
+    const config = getConfig(ctx);
+    if (!config.enabled) {
+        return {};
+    }
+    const logger = new Logger(config.debug);
+    const state = createSessionState();
+    logger.info("RCL initialized", {
+        strategies: config.strategies,
+    });
+    return {
+        "experimental.chat.system.transform": createSystemPromptHandler(state, logger, config),
+        "experimental.chat.messages.transform": createChatMessageTransformHandler(ctx.client, state, logger, config, ctx.directory),
+        "chat.message": async (input, _output) => {
+            // Cache variant from real user messages (not synthetic)
+            // This avoids scanning all messages to find variant
+            state.variant = input.variant;
+            logger.debug("Cached variant from chat.message hook", { variant: input.variant });
+        },
+        tool: {
+            // Always available: restores pruned content from `.opencode/rcl/blobs/...`.
+            rcl_restore: createRestoreTool({
+                logger,
+                workingDirectory: ctx.directory,
+                config,
+            }),
+            ...(config.explore.enabled && {
+                // Runs a dedicated sub-agent to restore and explore blobs off-context.
+                rcl_explore: createExploreTool({
+                    client: ctx.client,
+                    logger,
+                    config,
+                    workingDirectory: ctx.directory,
+                }),
+            }),
+            ...(config.tools.discard.enabled && {
+                discard: createDiscardTool({
+                    client: ctx.client,
+                    state,
+                    logger,
+                    config,
+                    workingDirectory: ctx.directory,
+                }),
+            }),
+            ...(config.tools.extract.enabled && {
+                extract: createExtractTool({
+                    client: ctx.client,
+                    state,
+                    logger,
+                    config,
+                    workingDirectory: ctx.directory,
+                }),
+            }),
+        },
+        config: async (opencodeConfig) => {
+            // Add enabled tools to primary_tools by mutating the opencode config
+            // This works because config is cached and passed by reference
+            const toolsToAdd = [];
+            toolsToAdd.push("rcl_restore");
+            if (config.explore.enabled)
+                toolsToAdd.push("rcl_explore");
+            if (config.tools.discard.enabled)
+                toolsToAdd.push("discard");
+            if (config.tools.extract.enabled)
+                toolsToAdd.push("extract");
+            if (toolsToAdd.length > 0) {
+                const existingPrimaryTools = opencodeConfig.experimental?.primary_tools ?? [];
+                opencodeConfig.experimental = {
+                    ...opencodeConfig.experimental,
+                    primary_tools: Array.from(new Set([...existingPrimaryTools, ...toolsToAdd])),
+                };
+                logger.info(`Added ${toolsToAdd.map((t) => `'${t}'`).join(" and ")} to experimental.primary_tools via config mutation`);
+            }
+            // Ensure the rcl_explorer agent exists for rcl_explore to use.
+            // We default its model to the OpenCode default agent's model (if present),
+            // so users don't need to hardcode a provider-specific model in rcl.jsonc.
+            const cfgAny = opencodeConfig;
+            const agents = cfgAny.agent ?? {};
+            const defaultAgentName = cfgAny.default_agent;
+            const inferModelFromAgents = () => {
+                if (config.explore.agentModel)
+                    return config.explore.agentModel;
+                if (defaultAgentName && agents[defaultAgentName]?.model)
+                    return agents[defaultAgentName].model;
+                if (agents.code?.model)
+                    return agents.code.model;
+                for (const a of Object.values(agents)) {
+                    if (a && typeof a.model === "string" && a.model.length > 0) {
+                        return a.model;
+                    }
+                }
+                return undefined;
+            };
+            const model = inferModelFromAgents();
+            if (!model) {
+                logger.warn("Could not infer a model for rcl_explorer; set explore.agentModel in rcl.jsonc or define agent.rcl_explorer in your OpenCode config.");
+                return;
+            }
+            if (!cfgAny.agent) {
+                cfgAny.agent = agents;
+            }
+            if (!cfgAny.agent.rcl_explorer) {
+                cfgAny.agent.rcl_explorer = {
+                    model,
+                    temperature: 0.1,
+                    prompt: loadPrompt("agent/rcl-explorer"),
+                    description: "Recall sub-agent: restores and explores pruned RCL blobs, returning small distilled answers.",
+                };
+                logger.info("Injected rcl_explorer agent config via config mutation", { model });
+            }
+        },
+    };
+});
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/lib/config.d.ts

@@ -0,0 +1,73 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export interface Deduplication {
+    enabled: boolean;
+    protectedTools: string[];
+}
+export interface DiscardTool {
+    enabled: boolean;
+}
+export interface ExtractTool {
+    enabled: boolean;
+    showDistillation: boolean;
+}
+export interface ToolSettings {
+    nudgeEnabled: boolean;
+    nudgeFrequency: number;
+    restoreProtectionTurns: number;
+    restoreMaxBytes: number;
+    protectedTools: string[];
+}
+export interface Tools {
+    settings: ToolSettings;
+    discard: DiscardTool;
+    extract: ExtractTool;
+}
+export interface SupersedeWrites {
+    enabled: boolean;
+}
+export interface PurgeErrors {
+    enabled: boolean;
+    turns: number;
+    protectedTools: string[];
+}
+export interface TurnProtection {
+    enabled: boolean;
+    turns: number;
+}
+export interface ExploreConfig {
+    enabled: boolean;
+    /**
+     * Optional model override for the rcl_explorer sub-agent.
+     *
+     * If omitted, Recall will try to infer a sensible default from your OpenCode agent config
+     * (typically the default agent's model).
+     */
+    agentModel?: string;
+    /**
+     * Optional variant override for the rcl_explorer sub-agent (e.g. "low" | "medium" | "high").
+     * If omitted, OpenCode's defaults apply.
+     */
+    agentVariant?: string;
+    /** Maximum time to wait for the sub-agent session to complete. */
+    timeoutMs: number;
+    /** Hard cap for how many characters rcl_explore returns to the main session. */
+    maxResultChars: number;
+}
+export interface PluginConfig {
+    enabled: boolean;
+    debug: boolean;
+    pruneNotification: "off" | "minimal" | "detailed";
+    turnProtection: TurnProtection;
+    protectedFilePatterns: string[];
+    explore: ExploreConfig;
+    tools: Tools;
+    strategies: {
+        deduplication: Deduplication;
+        supersedeWrites: SupersedeWrites;
+        purgeErrors: PurgeErrors;
+    };
+}
+export declare const VALID_CONFIG_KEYS: Set<string>;
+export declare function getInvalidConfigKeys(userConfig: Record<string, any>): string[];
+export declare function getConfig(ctx: PluginInput): PluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,gBAAgB,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE,OAAO,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,KAAK;IAClB,QAAQ,EAAE,YAAY,CAAA;IACtB,OAAO,EAAE,WAAW,CAAA;IACpB,OAAO,EAAE,WAAW,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAA;IACjB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,iBAAiB,EAAE,KAAK,GAAG,SAAS,GAAG,UAAU,CAAA;IACjD,cAAc,EAAE,cAAc,CAAA;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,OAAO,EAAE,aAAa,CAAA;IACtB,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE;QACR,aAAa,EAAE,aAAa,CAAA;QAC5B,eAAe,EAAE,eAAe,CAAA;QAChC,WAAW,EAAE,WAAW,CAAA;KAC3B,CAAA;CACJ;AAiBD,eAAO,MAAM,iBAAiB,aA0C5B,CAAA;AAgBF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAG9E;AAmpBD,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAgIxD"}