dsh-context-opencode 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-context-zoo contributors
+
+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,51 @@
+# OpenCode Context Strategy
+
+English | [简体中文](README.zh-CN.md)
+
+This package adapts the OpenCode workflow for usage accounting, tool-output pruning, retained-history selection, summary requests, result validation, and overflow recovery. DSH reads the log, calls the model, and commits replacements.
+
+## npm installation
+
+After release, install with `dsh plugin --profile web add dsh-context-opencode`. Apply the host Session patch and generate the activation overlay as described in the [npm guide](https://github.com/zonemeen/dsh-context-zoo/blob/main/docs/publishing.md#using-the-published-packages). Installing the package alone does not replace the active context engine.
+
+## Context flow
+
+Optional tool-output pruning runs before the automatic threshold check. Recent turns stay outside the summary replacement; on overflow, the latest user message is also retained when earlier user history exists. Transcript clipping only affects summary input; original messages remain in the session log.
+
+```mermaid
+flowchart TD
+    A["Automatic check, manual compact,<br/>or overflow recovery"] --> B{"Within failure and recovery limits?"}
+    B -->|No| L["Keep the current context"]
+    B -->|Yes| C["Optional tool-output pruning<br/>Disabled by default"]
+    C --> D{"Automatic threshold met<br/>or manual / overflow trigger?"}
+    D -->|No| E["Keep the current context<br/>Any completed pruning remains"]
+    D -->|Yes| F["Select older history<br/>Keep recent turns and tool pairs intact"]
+    F --> G{"History available to summarize?"}
+    G -->|No| E
+    G -->|Yes| H["Summarize selected history<br/>Merge prior checkpoints"]
+    H --> I{"Summary and replacement valid?"}
+    I -->|Yes| J["Commit checkpoint with retained tail<br/>On overflow, describe retained media"]
+    I -->|No| K["Do not replace history with a summary<br/>Any completed pruning remains"]
+```
+
+## Default behavior
+
+- Uses the provider's total usage when available, or sums input, output, and cache usage. Without usage data, it estimates tokens by dividing the message JSON character count by 4 after removing DSH identity fields.
+- When the model has a separate input limit, subtracts `reserveTokens` from that limit; the default reserve is the smaller of the output budget and 20,000 tokens. With only a total context window, subtracts the output budget, which defaults to 32,000 tokens when unavailable.
+- Triggers when usage reaches the threshold. The retention budget is 25% of the usable window, with a minimum of 2,000 and a maximum of 15,000 tokens. Retains complete recent user turns first; when a turn does not fit, finds a suffix that fits while keeping tool calls and results together.
+- Tool-output pruning is disabled by default. When enabled, scans backward from the newest messages and processes older results only after passing the second user message. Protects the first 40,000 tokens of accumulated tool output and the `skill` tool. Stops at a previous summary or a cleared result. Clears candidate outputs only when their total strictly exceeds 20,000 tokens; error results are retained.
+- Sends a separately serialized transcript for summarization, preserving tool names and arguments. Each tool output is limited to 2,000 characters by default. Merges the previous summary using the headings Objective, Important Details, Work State, Next Move, and Relevant Files.
+- Limits summary output to the smaller of the current output budget and 32,000 tokens by default. Rejects blank, truncated, error, tool-call, and media responses. A failed summary does not commit a summary replacement.
+- On overflow, retains the latest user message at the end when earlier user history is available, and compacts that earlier history first. After success, converts media in retained user messages to attachment descriptions and adds continuation instructions. Original attachments remain intact if summarization fails.
+
+`reserveTokens`, `thresholdRatio`, and `keepRecentTokens` override the budgets; the ratio applies to the window after subtracting the reserve. `tailTurns` limits the maximum number of retained user turns; setting it to 0 summarizes all selected history. `maxSummaryTokens`, `summaryToolChars`, `summarizationProvider`, and `summarizationModel` control the auxiliary request. `maxOverflowRetries` defaults to 1 per request sequence. The optional `maxConsecutiveFailures` setting pauses automatic processing after repeated failures; a successful manual compaction resets the count.
+
+## Implementation scope
+
+Use `createPipeline(config)` directly through `run(host, trigger)` and `summarizeRange(host, entries)`. This package maintains the adapted algorithms, summary text, and state records. Previous summaries and recovery counters are recorded in the session log. `auto: false` disables DSH's automatic hooks; explicit calls still run.
+
+OpenCode's provider-specific message encoders and third-party plugin hooks require its runtime. This package uses DSH's message representation and keeps tool calls and results together where the two representations group messages differently. Media continuation uses DSH user-message replacement records; original attachments remain in the historical log.
+
+DSH's system and developer messages stay in place. The plugin applies OpenCode's retention algorithm to each history segment, skipping segments where only existing checkpoints would be selected. Usage accounting still covers the full context. Summaries merge every checkpoint in the current context and fall back to plugin state records only when the context has no checkpoints, avoiding stale summary metadata when restoring a session.
+
+Original project: [anomalyco/opencode](https://github.com/anomalyco/opencode). The inspected local fork is pinned to `beb99270834db8eb62cf3a369e99234d4d4c2cbd`. The source project uses the MIT license. Budget and pruning behavior come from `packages/opencode/src/session/`; summary headings come from `packages/core/src/session/compaction.ts`, which that implementation calls. Summary instructions are defined in `src/strategy.ts`.

package/README.zh-CN.md

@@ -0,0 +1,51 @@
+# OpenCode 上下文策略
+
+[English](README.md) | 简体中文
+
+本包实现 OpenCode 的用量判断、工具输出裁剪、保留区间选择、摘要请求、结果验证和溢出续接流程。DSH 负责读取日志、调用模型和提交替换。
+
+## npm 安装
+
+发布后可用 `dsh plugin --profile web add dsh-context-opencode` 安装。按 [npm 指南](https://github.com/zonemeen/dsh-context-zoo/blob/main/docs/publishing.zh-CN.md#使用已发布的包) 应用宿主 Session 补丁并生成启用配置。仅安装包不会替换当前上下文引擎。
+
+## 上下文流程图
+
+可选的工具输出裁剪先于自动触发阈值检查。近期回合保留在摘要替换范围外；溢出时若存在更早的用户历史，还会保留最新用户消息。对话转录文本的截短只影响摘要输入，原始消息仍保存在会话日志中。
+
+```mermaid
+flowchart TD
+    A["自动检查、手动压缩或溢出恢复"] --> B{"未超过连续失败与恢复次数限制？"}
+    B -->|否| L["保留当前上下文"]
+    B -->|是| C["可选工具输出裁剪<br/>默认关闭"]
+    C --> D{"达到自动阈值<br/>或由手动、溢出触发？"}
+    D -->|否| E["保留当前上下文<br/>已完成的裁剪仍然生效"]
+    D -->|是| F["选择较早历史<br/>保留近期回合和完整工具配对"]
+    F --> G{"有可汇总的历史？"}
+    G -->|否| E
+    G -->|是| H["汇总选中历史<br/>合并先前检查点"]
+    H --> I{"摘要与替换通过校验？"}
+    I -->|是| J["提交检查点并保留近期尾部<br/>溢出时将保留的媒体转为描述"]
+    I -->|否| K["不以摘要替换历史<br/>已完成的裁剪仍然生效"]
+```
+
+## 默认行为
+
+- 有 provider usage 时使用总用量，或累加输入、输出及缓存用量；无 usage 时，对去除 DSH 身份字段后的消息 JSON 使用字符数除以 4 的估算。
+- 模型提供独立输入上限时，从该上限扣除 `reserveTokens`，缺省预留为输出预算与 20,000 的较小值。只有总窗口时扣除输出预算；输出预算缺失时使用 32,000。
+- 用量达到阈值时触发。保留预算为可用窗口的 25%，最少 2,000、最多 15,000 tokens。先保留完整近期用户回合；一个回合放不下时寻找能容纳的后缀，并保持工具调用与结果完整。
+- 工具输出裁剪默认关闭。开启后向前扫描，经过第二个用户消息才处理旧结果；保护累计前 40,000 tokens 的工具输出及 `skill`。遇到上次摘要或已清理结果时停止。候选输出严格超过 20,000 tokens 才清理，错误结果保留。
+- 摘要请求使用单独序列化的对话文本，保留工具名和参数，每段工具输出默认最多 2,000 字符。前次摘要参与合并；章节为 Objective、Important Details、Work State、Next Move、Relevant Files。
+- 摘要输出上限默认取当前输出预算与 32,000 的较小值。空白、截断、错误、工具调用及媒体响应被拒绝；失败不会提交摘要替换。
+- 溢出时若存在更早的用户历史，将最新用户消息保留在尾部，先压缩之前的历史；成功后把保留用户消息中的媒体转换为附件描述，并附带续接指令。摘要失败时保留原始附件。
+
+`reserveTokens`、`thresholdRatio`、`keepRecentTokens` 可以覆盖预算；比例作用于扣除预留后的窗口。`tailTurns` 限定最多保留的用户回合数，设为 0 时汇总全部选中历史。`maxSummaryTokens`、`summaryToolChars`、`summarizationProvider` 与 `summarizationModel` 控制辅助请求。`maxOverflowRetries` 默认每个请求序列 1 次；`maxConsecutiveFailures` 是可选的失败暂停配置，手动压缩成功后清零。
+
+## 实现范围
+
+可直接使用 `createPipeline(config)` 的 `run(host, trigger)` 和 `summarizeRange(host, entries)`。来源算法、摘要文本和状态记录由本包维护；前次摘要及恢复计数记录在会话日志中。`auto: false` 关闭 DSH 自动钩子，显式调用仍可执行。
+
+OpenCode 的 provider 专用消息编码器和第三方插件钩子依赖其运行时。本包使用 DSH 的消息表示；在两种消息表示的分组不同处，优先保持工具调用与结果完整。媒体续接使用 DSH 用户消息替换记录，原始附件仍留在历史日志中。
+
+DSH 的 system 与 developer 消息保留原位；插件逐段应用 OpenCode 的保留算法，跳过只能选中既有 checkpoint 的段。用量判断仍覆盖完整上下文。摘要合并当前上下文中的全部 checkpoint；只有当前上下文没有 checkpoint 时才回退到插件状态记录，避免恢复会话时使用落后的摘要元数据。
+
+源项目为 [anomalyco/opencode](https://github.com/anomalyco/opencode)；实际参考本地 fork 的提交 `beb99270834db8eb62cf3a369e99234d4d4c2cbd`，源项目采用 MIT 许可证。预算和裁剪行为对应 `packages/opencode/src/session/`；摘要章节来自该实现调用的 `packages/core/src/session/compaction.ts`。摘要指令定义在 `src/strategy.ts` 中。

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { strategy } from './strategy.js';
+export { createPipeline } from './pipeline.js';
+declare const _default: import("dsh-context-core").ContextPlugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;;AAC/C,wBAA+E"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/** Context management plugin based on the OpenCode workflow. */
+import { createContextPlugin } from 'dsh-context-core';
+import { createPipeline } from './pipeline.js';
+export { strategy } from './strategy.js';
+export { createPipeline } from './pipeline.js';
+export default createContextPlugin({ id: 'opencode', create: createPipeline });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,eAAe,mBAAmB,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,4 @@
+import type { ContextConfig, ContextPipeline } from 'dsh-context-core';
+/** Create a source-specific pipeline whose recovery state survives session replay. */
+export declare function createPipeline(config?: ContextConfig): ContextPipeline;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,aAAa,EAA6B,eAAe,EAAmB,MAAM,kBAAkB,CAAC;AAgI/H,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,MAAM,GAAE,aAAkB,GAAG,eAAe,CAyE1E"}

package/dist/pipeline.js

@@ -0,0 +1,236 @@
+import { strategy } from './strategy.js';
+const CLEARED = '[Old tool result content cleared]';
+const textOf = (entry) => entry.message.content.map(block => block.type === 'text' ? block.text : '').join('\n');
+const checkpoint = (entry) => entry.message.source.kind === 'compact-checkpoint';
+const conversational = (entry) => entry.message.role !== 'system' && entry.message.role !== 'developer';
+/** Protected instructions split the surface into separately compactable spans. */
+function spans(entries) {
+    const result = [];
+    let current = [];
+    for (const entry of entries) {
+        if (conversational(entry))
+            current.push(entry);
+        else if (current.length) {
+            result.push(current);
+            current = [];
+        }
+    }
+    if (current.length)
+        result.push(current);
+    return result;
+}
+/** Provider totals include cache reads, cache writes, and output tokens. */
+function usageTokens(snapshot) {
+    const usage = snapshot.entries.findLast(entry => entry.message.role === 'assistant' && entry.usage !== undefined)?.usage;
+    return usage === undefined ? estimate(snapshot.entries) : usage.totalTokens || usage.inputTokens + usage.outputTokens + (usage.cacheReadTokens ?? 0) + (usage.cacheWriteTokens ?? 0);
+}
+function estimate(entries) {
+    return Math.max(0, Math.round(JSON.stringify(entries.map(({ message }) => ({
+        role: message.role, content: message.content,
+        ...message.role === 'tool' ? { toolCallId: message.toolCallId } : {},
+    }))).length / 4));
+}
+function usable(snapshot, config) {
+    const output = snapshot.maxOutputTokens || 32_000;
+    if (snapshot.inputLimit)
+        return Math.max(0, snapshot.inputLimit - (config.reserveTokens ?? Math.min(20_000, output)));
+    return Math.max(0, snapshot.contextWindow - (config.reserveTokens ?? output));
+}
+/** A suffix cannot separate a tool call from its results. */
+function balancedCuts(entries) {
+    const cuts = new Set([0]);
+    const pending = new Set();
+    entries.forEach((entry, index) => {
+        for (const block of entry.message.content)
+            if (block.type === 'tool-call')
+                pending.add(block.id);
+        if (entry.message.role === 'tool')
+            pending.delete(entry.message.toolCallId);
+        if (pending.size === 0)
+            cuts.add(index + 1);
+    });
+    return cuts;
+}
+/** Retain complete turns, then the earliest fitting balanced suffix of one oversized turn. */
+function select(entries, budget, tailTurns) {
+    if (tailTurns === 0)
+        return entries;
+    const turns = entries.flatMap((entry, index) => entry.message.role === 'user' && !checkpoint(entry) ? [index] : []);
+    if (!turns.length)
+        return entries;
+    const candidates = tailTurns === undefined ? turns : turns.slice(-tailTurns);
+    const cuts = balancedCuts(entries);
+    let kept = entries.length;
+    let total = 0;
+    for (let index = candidates.length - 1; index >= 0; index--) {
+        const start = candidates[index];
+        const end = turns[turns.indexOf(start) + 1] ?? entries.length;
+        const size = estimate(entries.slice(start, end));
+        if (total + size <= budget && cuts.has(start)) {
+            total += size;
+            kept = start;
+            continue;
+        }
+        for (let suffix = start + 1; suffix < end; suffix++) {
+            if (!cuts.has(suffix) || entries[suffix].message.role === 'tool')
+                continue;
+            if (estimate(entries.slice(suffix, end)) <= budget - total) {
+                kept = suffix;
+                break;
+            }
+        }
+        break;
+    }
+    return kept === 0 ? entries : entries.slice(0, kept);
+}
+function mediaText(block) {
+    if (block.type === 'image')
+        return { type: 'text', text: `[Attached ${block.attachment.mediaType}: image]` };
+    if (block.type === 'file')
+        return { type: 'text', text: '[Attached file]' };
+    return block;
+}
+function serialize(entries, limit) {
+    return entries.filter(entry => !checkpoint(entry)).map(entry => {
+        const message = entry.message;
+        const blocks = message.content.map(mediaText);
+        if (message.role === 'tool') {
+            const text = blocks.map(block => block.type === 'text' ? block.text : '').join('\n');
+            const output = limit > 0 && text.length > limit ? `${text.slice(0, limit)}\n[truncated]` : text;
+            return `[${message.isError ? 'Tool error' : 'Tool result'}]: ${output}`;
+        }
+        return blocks.map(block => {
+            if (block.type === 'tool-call')
+                return `[Assistant tool call]: ${block.name}(${block.arguments})`;
+            if (block.type === 'reasoning')
+                return `[Assistant reasoning]: ${block.text}`;
+            return block.type === 'text' ? `[${message.role === 'user' ? 'User' : 'Assistant'}]: ${block.text}` : '';
+        }).filter(Boolean).join('\n');
+    }).join('\n\n');
+}
+function prune(host, snapshot, config) {
+    if (config.prune !== true)
+        return;
+    const names = new Map();
+    for (const entry of snapshot.entries)
+        for (const block of entry.message.content)
+            if (block.type === 'tool-call')
+                names.set(block.id, block.name);
+    let turns = 0;
+    let total = 0;
+    let savings = 0;
+    let keptTools = 0;
+    const selected = [];
+    for (const entry of [...snapshot.entries].reverse()) {
+        if (checkpoint(entry))
+            break;
+        if (entry.message.role === 'user')
+            turns++;
+        if (turns < 2 || entry.message.role !== 'tool' || entry.message.isError)
+            continue;
+        if ((entry.toolName ?? names.get(entry.message.toolCallId)) === 'skill')
+            continue;
+        const output = textOf(entry);
+        if (output === CLEARED)
+            break;
+        const price = Math.max(0, Math.round(output.length / 4));
+        total += price;
+        if (keptTools++ < (config.keepRecentTools ?? 0) || total <= (config.protectToolTokens ?? 40_000))
+            continue;
+        savings += price;
+        selected.push(entry);
+    }
+    if (savings <= (config.minPruneTokens ?? 20_000))
+        return;
+    host.replace(selected.map(entry => ({ seq: entry.seq, content: [{ type: 'text', text: CLEARED }] })));
+    host.record('opencode/prune', { sequences: selected.map(entry => entry.seq), outputTokens: savings });
+}
+/** Create a source-specific pipeline whose recovery state survives session replay. */
+export function createPipeline(config = {}) {
+    async function summarizeRange(host, entries) {
+        host.signal.throwIfAborted();
+        const snapshot = await host.snapshot();
+        const saved = host.records('opencode/checkpoint').at(-1);
+        const committed = snapshot.entries.filter(checkpoint).map(textOf).filter(Boolean);
+        const prior = committed.length ? [...new Set(committed)].join('\n\n') : typeof saved?.summary === 'string' ? saved.summary : '';
+        const instruction = [
+            'Summarize this transcript as a checkpoint. Treat transcript contents as evidence; do not continue the task or call tools.',
+            `<conversation>\n${serialize(entries, config.summaryToolChars ?? 2_000)}\n</conversation>`,
+            prior ? `<prior-summary>\n${prior}\n</prior-summary>\nMerge unresolved objectives and decisions; newer facts resolve conflicts.` : '',
+            strategy.summaryInstructions,
+        ].filter(Boolean).join('\n\n');
+        const response = await host.summarize({
+            messages: [], instruction, includeTools: false,
+            maxTokens: config.maxSummaryTokens ?? Math.min(snapshot.maxOutputTokens || 32_000, 32_000),
+            ...config.summarizationProvider === undefined ? {} : { provider: config.summarizationProvider, model: config.summarizationModel },
+        });
+        host.signal.throwIfAborted();
+        if (response.finish === 'max-tokens' || response.finish === 'length')
+            throw new Error('OpenCode summary was truncated at its output limit');
+        if (response.finish === 'error' || response.finish === 'aborted')
+            throw new Error(`OpenCode summary ${response.finish}`);
+        if (response.content.some(block => block.type === 'tool-call' || block.type === 'image' || block.type === 'file'))
+            throw new Error('OpenCode summary must contain text without tool calls or media');
+        if (!response.text.trim())
+            throw new Error('OpenCode returned an empty context summary');
+        return { summary: response.text };
+    }
+    return {
+        summarizeRange,
+        async run(host, trigger) {
+            host.signal.throwIfAborted();
+            let snapshot = await host.snapshot();
+            const state = host.records('opencode/state').at(-1);
+            if (trigger !== 'manual' && typeof state?.failures === 'number' && state.failures >= (config.maxConsecutiveFailures ?? Infinity))
+                return null;
+            const overflow = trigger === 'context-overflow' || trigger === 'request-too-large';
+            const series = snapshot.requestSeries;
+            const attempts = state?.series === series && typeof state.overflows === 'number' ? state.overflows : 0;
+            if (overflow && attempts >= (config.maxOverflowRetries ?? 1))
+                return null;
+            prune(host, snapshot, config);
+            snapshot = await host.snapshot();
+            if (trigger === 'pressure' && (snapshot.contextWindow <= 0 || usageTokens(snapshot) < Math.floor(usable(snapshot, config) * (config.thresholdRatio ?? 1))))
+                return null;
+            const budget = config.keepRecentTokens ?? Math.min(15_000, Math.max(2_000, Math.floor(usable(snapshot, config) * 0.25)));
+            let selected;
+            const latestUser = snapshot.entries.findLastIndex(entry => entry.message.role === 'user' && !checkpoint(entry));
+            const history = overflow && latestUser > 0 && snapshot.entries.slice(0, latestUser).some(entry => entry.message.role === 'user' && !checkpoint(entry))
+                ? snapshot.entries.slice(0, latestUser) : snapshot.entries;
+            for (const span of spans(history)) {
+                const candidate = select(span, budget, config.tailTurns);
+                if (candidate.length && candidate.some(entry => !checkpoint(entry))) {
+                    selected = candidate;
+                    break;
+                }
+            }
+            if (!selected)
+                return null;
+            const range = selected;
+            let generated;
+            try {
+                const result = await host.compact(range, async () => {
+                    generated = await summarizeRange(host, range);
+                    if (trigger !== 'manual')
+                        generated.restored = [{ type: 'text', text: overflow
+                                    ? 'The request exceeded the provider context limit. Continue the latest request using the checkpoint and retained messages; attachments are represented by descriptions.'
+                                    : 'Continue the unfinished work when the next step is clear; otherwise ask for the missing information.' }];
+                    return generated;
+                });
+                if (overflow) {
+                    const live = await host.snapshot();
+                    host.replace(live.entries.filter(entry => entry.message.role === 'user' && entry.message.content.some(block => block.type === 'image' || block.type === 'file')).map(entry => ({ seq: entry.seq, content: entry.message.content.map(mediaText) })));
+                }
+                host.record('opencode/checkpoint', { summary: generated.summary, time: snapshot.now, selected: range.map(entry => entry.seq) });
+                host.record('opencode/state', { failures: 0, series, overflows: overflow ? attempts + 1 : 0 });
+                return result;
+            }
+            catch (error) {
+                if (!host.signal.aborted)
+                    host.record('opencode/state', { failures: (typeof state?.failures === 'number' ? state.failures : 0) + 1, series, overflows: overflow ? attempts + 1 : attempts });
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

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

package/dist/strategy.d.ts

@@ -0,0 +1,5 @@
+/** OpenCode context-budget, recent-history, and optional output-pruning strategy. */
+import type { ContextStrategy } from 'dsh-context-core';
+/** Adaptation of the pinned OpenCode session compaction implementation. */
+export declare const strategy: ContextStrategy;
+//# sourceMappingURL=strategy.d.ts.map

package/dist/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../src/strategy.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,EAAE,eA2CtB,CAAC"}

package/dist/strategy.js

@@ -0,0 +1,46 @@
+/** Adaptation of the pinned OpenCode session compaction implementation. */
+export const strategy = {
+    id: 'opencode',
+    name: 'OpenCode',
+    source: {
+        url: 'https://github.com/anomalyco/opencode',
+        revision: 'beb99270834db8eb62cf3a369e99234d4d4c2cbd',
+        license: 'MIT',
+    },
+    limitations: [
+        'DSH message blocks are serialized by this package; provider-specific OpenCode wire encoders and third-party OpenCode hooks require their native runtime.',
+        'Tool-call pairs remain complete when a DSH message boundary differs from an OpenCode assistant part.',
+    ],
+    budget(input) {
+        const reserve = input.reserveTokens ?? (input.maxOutputTokens || 32_000);
+        const usable = Math.max(0, input.contextWindow - reserve);
+        return {
+            triggerTokens: Math.floor(usable * (input.thresholdRatio ?? 1)),
+            retainTokens: input.keepRecentTokens ?? Math.min(15_000, Math.max(2_000, Math.floor(usable * 0.25))),
+            tailMode: 'maximum',
+        };
+    },
+    summaryInstructions: `Write a concise handoff using these headings in order:
+## Objective
+## Important Details
+## Work State
+### Completed
+### Active
+### Blocked
+## Next Move
+## Relevant Files
+
+Record the user's goal, constraints, decisions, completed work, pending work, blockers, and next actions. Include exact paths, symbols, commands, and errors needed to continue. Integrate any prior summary; resolve conflicting facts using the newer conversation. Keep unfinished requests and relevant earlier decisions. Use short bullets and keep empty sections with "(none)".`,
+    maxSummaryTokens: 32_000,
+    summaryToolChars: 2_000,
+    prune: {
+        enabled: false,
+        keepRecentTools: 0,
+        keepRecentTurns: 2,
+        protectTokens: 40_000,
+        minSavingsTokens: 20_000,
+        strictSavings: true,
+        protectedTools: ['skill'],
+    },
+};
+//# sourceMappingURL=strategy.js.map

package/dist/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../src/strategy.ts"],"names":[],"mappings":"AAGA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE;QACN,GAAG,EAAE,uCAAuC;QAC5C,QAAQ,EAAE,0CAA0C;QACpD,OAAO,EAAE,KAAK;KACf;IACD,WAAW,EAAE;QACX,0JAA0J;QAC1J,sGAAsG;KACvG;IACD,MAAM,CAAC,KAAK;QACV,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC,CAAC;QAC1D,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC;YAC/D,YAAY,EAAE,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;YACpG,QAAQ,EAAE,SAAS;SACpB,CAAC;IACJ,CAAC;IACD,mBAAmB,EAAE;;;;;;;;;;wXAUiW;IACtX,gBAAgB,EAAE,MAAM;IACxB,gBAAgB,EAAE,KAAK;IACvB,KAAK,EAAE;QACL,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,aAAa,EAAE,MAAM;QACrB,gBAAgB,EAAE,MAAM;QACxB,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,CAAC,OAAO,CAAC;KAC1B;CACF,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "dsh-context-opencode",
+  "version": "0.1.1",
+  "type": "module",
+  "license": "MIT",
+  "description": "opencode context management strategy adapted for DeepSeek Harness.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zonemeen/dsh-context-zoo.git",
+    "directory": "packages/opencode"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "README.md",
+    "README.zh-CN.md",
+    "src",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "dsh-context-core": "^0.1.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-commands": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-compaction": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-token-meter": "0.1.7-rc.2",
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-fs": "0.1.7-rc.2"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": []
+    }
+  },
+  "homepage": "https://github.com/zonemeen/dsh-context-zoo/tree/main/packages/opencode#readme",
+  "bugs": {
+    "url": "https://github.com/zonemeen/dsh-context-zoo/issues"
+  }
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+/** Context management plugin based on the OpenCode workflow. */
+import { createContextPlugin } from 'dsh-context-core';
+import { createPipeline } from './pipeline.js';
+export { strategy } from './strategy.js';
+export { createPipeline } from './pipeline.js';
+export default createContextPlugin({ id: 'opencode', create: createPipeline });

package/src/pipeline.ts

@@ -0,0 +1,205 @@
+/** Usage accounting, pruning, tail selection, and continuation based on the OpenCode workflow. */
+import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+import type { Checkpoint, ContextConfig, ContextEntry, ContextHost, ContextPipeline, ContextSnapshot } from 'dsh-context-core';
+import { strategy } from './strategy.js';
+
+const CLEARED = '[Old tool result content cleared]';
+const textOf = (entry: ContextEntry): string => entry.message.content.map(block => block.type === 'text' ? block.text : '').join('\n');
+const checkpoint = (entry: ContextEntry): boolean => entry.message.source.kind === 'compact-checkpoint';
+const conversational = (entry: ContextEntry): boolean => entry.message.role !== 'system' && entry.message.role !== 'developer';
+
+/** Protected instructions split the surface into separately compactable spans. */
+function spans(entries: readonly ContextEntry[]): ContextEntry[][] {
+  const result: ContextEntry[][] = [];
+  let current: ContextEntry[] = [];
+  for (const entry of entries) {
+    if (conversational(entry)) current.push(entry);
+    else if (current.length) { result.push(current); current = []; }
+  }
+  if (current.length) result.push(current);
+  return result;
+}
+
+/** Provider totals include cache reads, cache writes, and output tokens. */
+function usageTokens(snapshot: ContextSnapshot): number {
+  const usage = snapshot.entries.findLast(entry => entry.message.role === 'assistant' && entry.usage !== undefined)?.usage;
+  return usage === undefined ? estimate(snapshot.entries) : usage.totalTokens || usage.inputTokens + usage.outputTokens + (usage.cacheReadTokens ?? 0) + (usage.cacheWriteTokens ?? 0);
+}
+
+function estimate(entries: readonly ContextEntry[]): number {
+  return Math.max(0, Math.round(JSON.stringify(entries.map(({ message }) => ({
+    role: message.role, content: message.content,
+    ...message.role === 'tool' ? { toolCallId: message.toolCallId } : {},
+  }))).length / 4));
+}
+
+function usable(snapshot: ContextSnapshot, config: ContextConfig): number {
+  const output = snapshot.maxOutputTokens || 32_000;
+  if (snapshot.inputLimit) return Math.max(0, snapshot.inputLimit - (config.reserveTokens ?? Math.min(20_000, output)));
+  return Math.max(0, snapshot.contextWindow - (config.reserveTokens ?? output));
+}
+
+/** A suffix cannot separate a tool call from its results. */
+function balancedCuts(entries: readonly ContextEntry[]): Set<number> {
+  const cuts = new Set([0]);
+  const pending = new Set<string>();
+  entries.forEach((entry, index) => {
+    for (const block of entry.message.content) if (block.type === 'tool-call') pending.add(block.id);
+    if (entry.message.role === 'tool') pending.delete(entry.message.toolCallId);
+    if (pending.size === 0) cuts.add(index + 1);
+  });
+  return cuts;
+}
+
+/** Retain complete turns, then the earliest fitting balanced suffix of one oversized turn. */
+function select(entries: readonly ContextEntry[], budget: number, tailTurns?: number): readonly ContextEntry[] {
+  if (tailTurns === 0) return entries;
+  const turns = entries.flatMap((entry, index) => entry.message.role === 'user' && !checkpoint(entry) ? [index] : []);
+  if (!turns.length) return entries;
+  const candidates = tailTurns === undefined ? turns : turns.slice(-tailTurns);
+  const cuts = balancedCuts(entries);
+  let kept = entries.length;
+  let total = 0;
+  for (let index = candidates.length - 1; index >= 0; index--) {
+    const start = candidates[index]!;
+    const end = turns[turns.indexOf(start) + 1] ?? entries.length;
+    const size = estimate(entries.slice(start, end));
+    if (total + size <= budget && cuts.has(start)) {
+      total += size;
+      kept = start;
+      continue;
+    }
+    for (let suffix = start + 1; suffix < end; suffix++) {
+      if (!cuts.has(suffix) || entries[suffix]!.message.role === 'tool') continue;
+      if (estimate(entries.slice(suffix, end)) <= budget - total) { kept = suffix; break; }
+    }
+    break;
+  }
+  return kept === 0 ? entries : entries.slice(0, kept);
+}
+
+function mediaText(block: ContentBlock): ContentBlock {
+  if (block.type === 'image') return { type: 'text', text: `[Attached ${block.attachment.mediaType}: image]` };
+  if (block.type === 'file') return { type: 'text', text: '[Attached file]' };
+  return block;
+}
+
+function serialize(entries: readonly ContextEntry[], limit: number): string {
+  return entries.filter(entry => !checkpoint(entry)).map(entry => {
+    const message = entry.message;
+    const blocks = message.content.map(mediaText);
+    if (message.role === 'tool') {
+      const text = blocks.map(block => block.type === 'text' ? block.text : '').join('\n');
+      const output = limit > 0 && text.length > limit ? `${text.slice(0, limit)}\n[truncated]` : text;
+      return `[${message.isError ? 'Tool error' : 'Tool result'}]: ${output}`;
+    }
+    return blocks.map(block => {
+      if (block.type === 'tool-call') return `[Assistant tool call]: ${block.name}(${block.arguments})`;
+      if (block.type === 'reasoning') return `[Assistant reasoning]: ${block.text}`;
+      return block.type === 'text' ? `[${message.role === 'user' ? 'User' : 'Assistant'}]: ${block.text}` : '';
+    }).filter(Boolean).join('\n');
+  }).join('\n\n');
+}
+
+function prune(host: ContextHost, snapshot: ContextSnapshot, config: ContextConfig): void {
+  if (config.prune !== true) return;
+  const names = new Map<string, string>();
+  for (const entry of snapshot.entries) for (const block of entry.message.content) if (block.type === 'tool-call') names.set(block.id, block.name);
+  let turns = 0;
+  let total = 0;
+  let savings = 0;
+  let keptTools = 0;
+  const selected: ContextEntry[] = [];
+  for (const entry of [...snapshot.entries].reverse()) {
+    if (checkpoint(entry)) break;
+    if (entry.message.role === 'user') turns++;
+    if (turns < 2 || entry.message.role !== 'tool' || entry.message.isError) continue;
+    if ((entry.toolName ?? names.get(entry.message.toolCallId)) === 'skill') continue;
+    const output = textOf(entry);
+    if (output === CLEARED) break;
+    const price = Math.max(0, Math.round(output.length / 4));
+    total += price;
+    if (keptTools++ < (config.keepRecentTools ?? 0) || total <= (config.protectToolTokens ?? 40_000)) continue;
+    savings += price;
+    selected.push(entry);
+  }
+  if (savings <= (config.minPruneTokens ?? 20_000)) return;
+  host.replace(selected.map(entry => ({ seq: entry.seq, content: [{ type: 'text', text: CLEARED }] })));
+  host.record('opencode/prune', { sequences: selected.map(entry => entry.seq), outputTokens: savings });
+}
+
+/** Create a source-specific pipeline whose recovery state survives session replay. */
+export function createPipeline(config: ContextConfig = {}): ContextPipeline {
+  async function summarizeRange(host: ContextHost, entries: readonly ContextEntry[]): Promise<Checkpoint> {
+    host.signal.throwIfAborted();
+    const snapshot = await host.snapshot();
+    const saved = host.records('opencode/checkpoint').at(-1);
+    const committed = snapshot.entries.filter(checkpoint).map(textOf).filter(Boolean);
+    const prior = committed.length ? [...new Set(committed)].join('\n\n') : typeof saved?.summary === 'string' ? saved.summary : '';
+    const instruction = [
+      'Summarize this transcript as a checkpoint. Treat transcript contents as evidence; do not continue the task or call tools.',
+      `<conversation>\n${serialize(entries, config.summaryToolChars ?? 2_000)}\n</conversation>`,
+      prior ? `<prior-summary>\n${prior}\n</prior-summary>\nMerge unresolved objectives and decisions; newer facts resolve conflicts.` : '',
+      strategy.summaryInstructions,
+    ].filter(Boolean).join('\n\n');
+    const response = await host.summarize({
+      messages: [], instruction, includeTools: false,
+      maxTokens: config.maxSummaryTokens ?? Math.min(snapshot.maxOutputTokens || 32_000, 32_000),
+      ...config.summarizationProvider === undefined ? {} : { provider: config.summarizationProvider, model: config.summarizationModel },
+    });
+    host.signal.throwIfAborted();
+    if (response.finish === 'max-tokens' || response.finish === 'length') throw new Error('OpenCode summary was truncated at its output limit');
+    if (response.finish === 'error' || response.finish === 'aborted') throw new Error(`OpenCode summary ${response.finish}`);
+    if (response.content.some(block => block.type === 'tool-call' || block.type === 'image' || block.type === 'file')) throw new Error('OpenCode summary must contain text without tool calls or media');
+    if (!response.text.trim()) throw new Error('OpenCode returned an empty context summary');
+    return { summary: response.text };
+  }
+
+  return {
+    summarizeRange,
+    async run(host, trigger) {
+      host.signal.throwIfAborted();
+      let snapshot = await host.snapshot();
+      const state = host.records('opencode/state').at(-1);
+      if (trigger !== 'manual' && typeof state?.failures === 'number' && state.failures >= (config.maxConsecutiveFailures ?? Infinity)) return null;
+      const overflow = trigger === 'context-overflow' || trigger === 'request-too-large';
+      const series = snapshot.requestSeries;
+      const attempts = state?.series === series && typeof state.overflows === 'number' ? state.overflows : 0;
+      if (overflow && attempts >= (config.maxOverflowRetries ?? 1)) return null;
+      prune(host, snapshot, config);
+      snapshot = await host.snapshot();
+      if (trigger === 'pressure' && (snapshot.contextWindow <= 0 || usageTokens(snapshot) < Math.floor(usable(snapshot, config) * (config.thresholdRatio ?? 1)))) return null;
+      const budget = config.keepRecentTokens ?? Math.min(15_000, Math.max(2_000, Math.floor(usable(snapshot, config) * 0.25)));
+      let selected: readonly ContextEntry[] | undefined;
+      const latestUser = snapshot.entries.findLastIndex(entry => entry.message.role === 'user' && !checkpoint(entry));
+      const history = overflow && latestUser > 0 && snapshot.entries.slice(0, latestUser).some(entry => entry.message.role === 'user' && !checkpoint(entry))
+        ? snapshot.entries.slice(0, latestUser) : snapshot.entries;
+      for (const span of spans(history)) {
+        const candidate = select(span, budget, config.tailTurns);
+        if (candidate.length && candidate.some(entry => !checkpoint(entry))) { selected = candidate; break; }
+      }
+      if (!selected) return null;
+      const range = selected;
+      let generated: Checkpoint | undefined;
+      try {
+        const result = await host.compact(range, async () => {
+          generated = await summarizeRange(host, range);
+          if (trigger !== 'manual') generated.restored = [{ type: 'text', text: overflow
+            ? 'The request exceeded the provider context limit. Continue the latest request using the checkpoint and retained messages; attachments are represented by descriptions.'
+            : 'Continue the unfinished work when the next step is clear; otherwise ask for the missing information.' }];
+          return generated;
+        });
+        if (overflow) {
+          const live = await host.snapshot();
+          host.replace(live.entries.filter(entry => entry.message.role === 'user' && entry.message.content.some(block => block.type === 'image' || block.type === 'file')).map(entry => ({ seq: entry.seq, content: entry.message.content.map(mediaText) })));
+        }
+        host.record('opencode/checkpoint', { summary: generated!.summary, time: snapshot.now, selected: range.map(entry => entry.seq) });
+        host.record('opencode/state', { failures: 0, series, overflows: overflow ? attempts + 1 : 0 });
+        return result;
+      } catch (error) {
+        if (!host.signal.aborted) host.record('opencode/state', { failures: (typeof state?.failures === 'number' ? state.failures : 0) + 1, series, overflows: overflow ? attempts + 1 : attempts });
+        throw error;
+      }
+    },
+  };
+}

package/src/strategy.ts

@@ -0,0 +1,48 @@
+/** OpenCode context-budget, recent-history, and optional output-pruning strategy. */
+import type { ContextStrategy } from 'dsh-context-core';
+
+/** Adaptation of the pinned OpenCode session compaction implementation. */
+export const strategy: ContextStrategy = {
+  id: 'opencode',
+  name: 'OpenCode',
+  source: {
+    url: 'https://github.com/anomalyco/opencode',
+    revision: 'beb99270834db8eb62cf3a369e99234d4d4c2cbd',
+    license: 'MIT',
+  },
+  limitations: [
+    'DSH message blocks are serialized by this package; provider-specific OpenCode wire encoders and third-party OpenCode hooks require their native runtime.',
+    'Tool-call pairs remain complete when a DSH message boundary differs from an OpenCode assistant part.',
+  ],
+  budget(input) {
+    const reserve = input.reserveTokens ?? (input.maxOutputTokens || 32_000);
+    const usable = Math.max(0, input.contextWindow - reserve);
+    return {
+      triggerTokens: Math.floor(usable * (input.thresholdRatio ?? 1)),
+      retainTokens: input.keepRecentTokens ?? Math.min(15_000, Math.max(2_000, Math.floor(usable * 0.25))),
+      tailMode: 'maximum',
+    };
+  },
+  summaryInstructions: `Write a concise handoff using these headings in order:
+## Objective
+## Important Details
+## Work State
+### Completed
+### Active
+### Blocked
+## Next Move
+## Relevant Files
+
+Record the user's goal, constraints, decisions, completed work, pending work, blockers, and next actions. Include exact paths, symbols, commands, and errors needed to continue. Integrate any prior summary; resolve conflicting facts using the newer conversation. Keep unfinished requests and relevant earlier decisions. Use short bullets and keep empty sections with "(none)".`,
+  maxSummaryTokens: 32_000,
+  summaryToolChars: 2_000,
+  prune: {
+    enabled: false,
+    keepRecentTools: 0,
+    keepRecentTurns: 2,
+    protectTokens: 40_000,
+    minSavingsTokens: 20_000,
+    strictSavings: true,
+    protectedTools: ['skill'],
+  },
+};