dsh-context-core 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,80 @@
+# dsh-context-core
+
+English | [简体中文](README.zh-CN.md)
+
+The DSH integration layer for independent context plugins. Core provides session observations, model calls, file reads subject to host permissions, and commit transactions. Each plugin chooses its thresholds, history ranges, prompts, retries, and recovery content.
+
+DSH peer dependencies are pinned to `0.1.7-rc.2`; Cordis is `~4.0.4`. Apply the [Session patch](https://github.com/zonemeen/dsh-context-zoo/blob/main/patches/README.md) to the actual host dependencies before use.
+
+## Published tools
+
+The package includes the `dsh-context-patch` CLI for generating a profile overlay and exports `./compat/*` with the required Session patches, instructions, and license. The files are stored in `dist/compat/`. See the [npm guide](https://github.com/zonemeen/dsh-context-zoo/blob/main/docs/publishing.md#using-the-published-packages) for commands. Applying a host patch remains an explicit operation.
+
+## Interface
+
+```ts
+import { createContextPlugin } from 'dsh-context-core';
+import { createPipeline } from './pipeline.js';
+
+export default createContextPlugin({ id: 'my-agent', create: createPipeline });
+```
+
+`ContextPipeline.run(host, trigger)` owns one complete workflow. The trigger is `pressure`, `manual`, `context-overflow`, or `request-too-large`; explicit range compaction uses `summarizeRange()`. Each session has its own pipeline instance. State needed after restoration is written with `host.record()` and read with `host.records()`.
+
+`ContextHost` provides:
+
+| Method | Behavior |
+| --- | --- |
+| `snapshot()` | Current messages, the full message archive, usage, routing, capacity, tools, time, and session identity |
+| `summarize()` | Call the model with the plugin's messages and instructions; record the actual input, output, finish reason, and errors |
+| `replace()` | Record replayable replacements for selected user/tool content while preserving role, identity, and source |
+| `compact()` | Lock a selected contiguous range, run summarization and recovery, validate the result, and commit the checkpoint |
+| `readFile()` | Stream a bounded number of characters through DSH `fs`; return null and record the reason if unavailable |
+| `record()` / `records()` | Append and read durable state scoped to the plugin |
+
+A `Checkpoint` can contain `beforeSummary`, `summary`, and `restored`. All three are committed in one checkpoint. The plugin must explicitly adapt recovered content when the native role structure differs. This interface does not create another agent's session tree or tool cache.
+
+## Commit and recovery
+
+Core checks tool-call pairing, contiguous ranges, concurrent compaction locks, and history stability after summarization. Automatic compaction requires the whole current history to remain unchanged. Manual compaction allows context to be appended outside its selected range. The replacement must be smaller than that range, and system and developer messages remain in place. When those messages occur within history, each plugin applies its selection algorithm to contiguous conversation segments, skipping segments already summarized or unable to shrink further.
+
+Auxiliary calls are recorded individually, including Pi's two summaries, failed retries, and model fallback. `compaction/summary` carries the single-call marker only when exactly one model call occurred. The summary event and its replacement `user/message` stay adjacent; original records remain in the log.
+
+Manual workflows run under the DSH maintenance lock and wait for the session to flush. Cancellation reaches the model and file services and prevents checkpoint submission. Model overflow requests a retry only after the plugin has durably replaced history and the operation remains active. The plugin owns retry limits and failure counts.
+
+## Configuration
+
+Configuration is validated at load time. These fields form the shared configuration vocabulary; a plugin uses the fields supported by its source workflow. Defaults are documented in each package README.
+
+| Field | Purpose |
+| --- | --- |
+| `auto` | Enable automatic event hooks; explicit compaction methods remain available |
+| `reserveTokens`, `thresholdRatio`, `keepRecentTokens` | Source-specific trigger and retention budgets |
+| `maxSummaryTokens`, `summaryToolChars` | Summary output limit and auxiliary tool-text length |
+| `summarizationProvider`, `summarizationModel` | Summary routing; both must be set together |
+| `maxOverflowRetries`, `maxConsecutiveFailures` | Overflow recovery and consecutive-failure limits |
+| `maxSummaryAttempts`, `summaryRetryDelayMs` | Model attempt count and retry delay where supported |
+| `prune`, `keepRecentTools`, `protectToolTokens`, `minPruneTokens` | Microcompaction controls where supported |
+| `idleMinutes`, `toolHighWaterChars`, `toolLowWaterChars` | Idle-time and tool-output size thresholds |
+| `tailTurns` | OpenCode's retained turn count |
+| `screenshotTriggerImages` | Qwen's tool-screenshot trigger count; 0 disables it |
+| `restoreContext`, `maxRestoredFiles`, `maxFileTokens`, `maxRestoreTokens` | File and context recovery budgets |
+| `maxRestoredImages`, `maxSkillTokens` | Image and skill recovery budgets |
+
+Budgets, counts, and delays are nonnegative safe integers. Summary output, summary attempt count, and the consecutive-failure limit must be positive. Ratios must be in `(0, 1]`. Each plugin documents the meaning of zero where applicable.
+
+## Host integration
+
+External runtimes can return observed `approvedPlanPath`, `transcriptPath`, `wirePath`, `windowLines`, `todos`, `reminders`, or `replStateCleared` values through the `context-zoo/recovery` waterfall. Call `next()` when there are no observations. Return `replStateCleared: true` only after actually clearing the REPL. Core requires observed file locations and log recovery information.
+
+Pi branch navigation calls:
+
+```ts
+import { summarizeBranch } from 'dsh-context-core';
+
+const summary = await summarizeBranch(ctx, idleAgent, abandonedBranchSeqs, signal);
+```
+
+This function runs the plugin's branch workflow under the maintenance lock, records the summary, and flushes it. The navigation integration writes the returned text into a model-visible message in the target branch. Plugins without a branch workflow return `undefined`.
+
+`ContextStrategy` and `budget()` expose metadata for budget comparisons. `ContextPipeline` executes the actual workflow. History selection and tool-pruning algorithms belong to the individual plugins.

package/README.zh-CN.md

@@ -0,0 +1,80 @@
+# dsh-context-core
+
+[English](README.md) | 简体中文
+
+独立上下文插件的 DSH 接入层。core 提供会话观察、模型调用、受宿主权限约束的文件读取和提交事务，不选择压缩阈值、历史范围、提示词、重试次数或恢复内容。
+
+DSH peer dependencies 固定为 `0.1.7-rc.2`，Cordis 为 `~4.0.4`。使用前须按仓库的 [Session 补丁说明](https://github.com/zonemeen/dsh-context-zoo/blob/main/patches/README.zh-CN.md) 处理实际宿主依赖。
+
+## 随包发布的工具
+
+本包包含用于生成 profile 覆盖补丁的 `dsh-context-patch` CLI，并通过 `./compat/*` 导出所需的 Session 补丁、说明和许可证；文件位于 `dist/compat/`。命令见 [npm 指南](https://github.com/zonemeen/dsh-context-zoo/blob/main/docs/publishing.zh-CN.md#使用已发布的包)。宿主补丁仍需显式应用。
+
+## 接口
+
+```ts
+import { createContextPlugin } from 'dsh-context-core';
+import { createPipeline } from './pipeline.js';
+
+export default createContextPlugin({ id: 'my-agent', create: createPipeline });
+```
+
+`ContextPipeline` 的 `run(host, trigger)` 拥有一次完整执行流程。触发原因是 `pressure`、`manual`、`context-overflow` 或 `request-too-large`；显式范围压缩调用 `summarizeRange()`。每个会话有自己的 pipeline 实例，需恢复的状态通过 `host.record()` 和 `host.records()` 存取。
+
+`ContextHost` 提供：
+
+| 方法 | 行为 |
+| --- | --- |
+| `snapshot()` | 当前消息、完整消息归档、usage、路由、窗口、工具、时间与会话标识 |
+| `summarize()` | 按插件给出的消息和指令调用模型，记录实际输入、输出、finish 和错误 |
+| `replace()` | 把插件选中的 user/tool 内容写成可回放的替换；保留角色、标识和来源 |
+| `compact()` | 对选定连续范围加锁，运行摘要与恢复，校验后提交检查点 |
+| `readFile()` | 经 DSH `fs` 流式读取指定字符数；不可用时返回 null 并记录原因 |
+| `record()` / `records()` | 追加与读取带插件命名空间的持久状态 |
+
+`Checkpoint` 可包含 `beforeSummary`、`summary` 和 `restored`。三部分在一个检查点中提交。原生角色结构不同的恢复内容需要插件做明确适配；这个接口不会创建其他 agent 的会话树或工具缓存。
+
+## 提交和恢复
+
+core 校验工具调用配对、连续范围、并发压缩锁和摘要后的历史稳定性。自动压缩要求整个当前历史保持一致；手动压缩允许范围外追加上下文。替换后的总内容必须小于被替换范围；系统和开发者消息不参与替换。遇到历史中途的系统或开发者更新，各插件分别在连续会话段上运行自己的选择算法，跳过已经压缩或无法继续缩减的段，保留这些更新的位置。
+
+辅助调用单独记录，所以 Pi 的两次摘要、失败重试和模型回退都可追查。`compaction/summary` 只在恰好一次模型调用时写入单调用标记。`compaction/summary` 和对应 `user/message` 保持相邻；原始记录仍在日志中。
+
+手动流程在 DSH maintenance 锁内执行，并等待会话 flush。取消信号传入模型与文件服务；取消后不提交检查点。模型溢出仅在插件造成实际历史替换且未取消时请求重试，次数和失败计数由插件决定。
+
+## 配置
+
+配置在加载时验证。以下字段属于统一配置词汇，各插件只使用有对应源流程的字段；默认值见对应包 README。
+
+| 字段 | 用途 |
+| --- | --- |
+| `auto` | 自动事件钩子开关；不禁止显式调用压缩方法 |
+| `reserveTokens`, `thresholdRatio`, `keepRecentTokens` | 来源特定的触发与保留预算 |
+| `maxSummaryTokens`, `summaryToolChars` | 摘要输出上限、辅助输入的工具文本长度 |
+| `summarizationProvider`, `summarizationModel` | 摘要路由；必须一起设置 |
+| `maxOverflowRetries`, `maxConsecutiveFailures` | 溢出恢复和连续失败限制 |
+| `maxSummaryAttempts`, `summaryRetryDelayMs` | 源流程支持的模型重试次数和延迟 |
+| `prune`, `keepRecentTools`, `protectToolTokens`, `minPruneTokens` | 源流程支持的微压缩控制 |
+| `idleMinutes`, `toolHighWaterChars`, `toolLowWaterChars` | 空闲与工具输出体积阈值 |
+| `tailTurns` | OpenCode 的保留回合数 |
+| `screenshotTriggerImages` | Qwen 工具截图触发数；0 关闭 |
+| `restoreContext`, `maxRestoredFiles`, `maxFileTokens`, `maxRestoreTokens` | 文件和上下文恢复预算 |
+| `maxRestoredImages`, `maxSkillTokens` | 图片与技能恢复预算 |
+
+预算、计数和延迟使用非负安全整数；摘要输出、摘要尝试数与连续失败上限必须大于零。比例属于 `(0, 1]`。值为零的含义由各插件说明。
+
+## 宿主集成
+
+外部运行时可以通过 `context-zoo/recovery` waterfall 返回实际观察到的 `approvedPlanPath`、`transcriptPath`、`wirePath`、`windowLines`、`todos`、`reminders` 或 `replStateCleared`。没有观察时调用 `next()`；只有确实清理了 REPL 才能返回 `replStateCleared: true`。文件路径和日志恢复提示不会由 core 猜测。
+
+Pi 分支导航调用：
+
+```ts
+import { summarizeBranch } from 'dsh-context-core';
+
+const summary = await summarizeBranch(ctx, idleAgent, abandonedBranchSeqs, signal);
+```
+
+该函数在 maintenance 锁内调用插件分支流程，记录并 flush 摘要。导航集成负责把返回文本写入目标分支的模型可见消息；没有分支流程的插件返回 `undefined`。
+
+`ContextStrategy` 和 `budget()` 是预算比较所需的元数据，实际流程由 `ContextPipeline` 执行。core 不再导出公共历史选择器或工具裁剪算法。

package/dist/compat/@deepseek-ai__dsh-session@0.1.7-rc.2.patch

@@ -0,0 +1,25 @@
+diff --git a/lib/index.js b/lib/index.js
+index 48bc365ca7021dcf0d69a2d07ac49995034357c4..141fb92e59c0b7b8190fabf4f10a61ff6a60d788 100644
+--- a/lib/index.js
++++ b/lib/index.js
+@@ -1401,6 +1401,7 @@ var Session = class Session {
+ 	append(type, data, ...opts) {
+ 		const surfaceOpts = opts[0];
+ 		const surfaceMetadata = {
++			...surfaceOpts?.ignorable === true ? { ignorable: true } : {},
+ 			...surfaceOpts?.sourceEventSeqs === void 0 ? {} : { sourceEventSeqs: surfaceOpts.sourceEventSeqs },
+ 			...surfaceOpts?.surfaceOp === void 0 ? {} : { surfaceOp: surfaceOpts.surfaceOp }
+ 		};
+diff --git a/lib/types/index.d.ts b/lib/types/index.d.ts
+index 3d6aa837b6ab4c40b4c84c178a9579e261731010..912e93b0c2ee86bafe025470941748a2bda266ef 100644
+--- a/lib/types/index.d.ts
++++ b/lib/types/index.d.ts
+@@ -243,7 +243,7 @@ export declare class Session {
+      *   append reentered while this acceptance/publication boundary is open also
+      *   rejects before the log changes.
+      */
+-    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [opts: SurfaceIntent<T>] : []): SessionEvent<T>;
++    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [opts: SurfaceIntent<T>] : [opts?: { ignorable: true }]): SessionEvent<T>;
+     /** Cached fold of the request-header events — see {@link requestHeader}. */
+     private headerFold;
+     /** Log position (events consumed) the header fold has reached. */

package/dist/compat/DSH-LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+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/dist/compat/README.md

@@ -0,0 +1,28 @@
+# DSH Session Compatibility Patch
+
+English | [简体中文](README.zh-CN.md)
+
+DSH `0.1.7-rc.2` can restore external plugin events marked `ignorable: true`, but `Session.append()` does not expose an argument for writing that marker. Context plugins need durable failure counts, file lists, and auxiliary model-call records so these values survive session restoration.
+
+This patch allows non-message events to call `append(type, data, { ignorable: true })` and writes the marker into the event envelope. It leaves the session format version, existing events, and compaction algorithms unchanged. Model-visible changes still use standard DSH message and compaction events.
+
+## This repository
+
+`pnpm-workspace.yaml` declares the published-package patch in `patchedDependencies`. Running `pnpm install` applies it automatically. Tests use DSH's `validateStoredEvents()` to check that the resulting records can be restored.
+
+## The actual DSH host
+
+**Apply the patch to the DSH runtime that creates the actual sessions.** Patching this library's development dependency does not patch a separate host installation. The plugin probes both its imported Session class and the active session implementation in isolation; these probes do not write to user sessions.
+
+For a DSH host installed through a pnpm project, copy `@deepseek-ai__dsh-session@0.1.7-rc.2.patch` from this directory into that project's `patches/` directory. Merge the following entry into its `pnpm-workspace.yaml`, then run `pnpm install`:
+
+```yaml
+patchedDependencies:
+  '@deepseek-ai/dsh-session@0.1.7-rc.2': patches/@deepseek-ai__dsh-session@0.1.7-rc.2.patch
+```
+
+When running DSH from its source workspace, the published-package patch does not change workspace source. Check and apply `dsh-session-source.patch` from the DSH repository root, then rebuild according to DSH's development instructions. The patch targets the source location used by this library's pinned version. Run `git apply --check <absolute-patch-path>` first to confirm that it applies to your checkout.
+
+This repository does not automatically modify a user's DSH installation or profile. If the host lacks the patch, the plugin rejects workflows that require durable records and reports the reason. Once DSH exposes this parameter publicly, the patch can be removed when updating the pinned dependency version.
+
+The patch includes a small amount of DSH context code under the [MIT license](DSH-LICENSE).

package/dist/compat/README.zh-CN.md

@@ -0,0 +1,28 @@
+# DSH Session 兼容补丁
+
+[English](README.md) | 简体中文
+
+DSH `0.1.7-rc.2` 的持久化读取器接受 `ignorable: true` 的外部插件事件，但 `Session.append()` 没有暴露写入该标记的参数。上下文插件需要记录失败计数、文件清单以及多次摘要调用，否则会话恢复后会丢失这些状态。
+
+这里的补丁只允许非消息事件调用 `append(type, data, { ignorable: true })`，并把标记写入事件信封。它不修改会话格式版本、已有事件或压缩算法。插件的模型可见变化仍使用标准 DSH 消息与 compaction 事件。
+
+## 本仓库
+
+`pnpm-workspace.yaml` 已声明 `patchedDependencies`，执行 `pnpm install` 自动应用发布包补丁。测试调用 DSH 的 `validateStoredEvents()` 检查这些记录可以恢复。
+
+## 实际 DSH 宿主
+
+**补丁必须应用到创建实际会话的 DSH 运行时。** 仅在本库的开发依赖上应用补丁，不能代替宿主补丁。插件对其导入的 Session 类和实际会话的实现分别做隔离探测；探测不会写入用户会话。
+
+如果 DSH 由 pnpm 项目安装，在该宿主项目中复制本目录的 `@deepseek-ai__dsh-session@0.1.7-rc.2.patch`，并合并以下配置到它的 `pnpm-workspace.yaml`，随后执行 `pnpm install`：
+
+```yaml
+patchedDependencies:
+  '@deepseek-ai/dsh-session@0.1.7-rc.2': patches/@deepseek-ai__dsh-session@0.1.7-rc.2.patch
+```
+
+如果从 DSH 源码工作区启动，发布包补丁不会改变 workspace source。可在 DSH 仓库根目录检查并应用本目录的 `dsh-session-source.patch`，再按 DSH 的开发说明重建。补丁对应本库固定版本的源码位置；先用 `git apply --check <absolute-patch-path>` 确认当前 checkout 可以应用。
+
+本仓库不会自动修改用户的 DSH 安装或 profile。宿主缺少补丁时，插件拒绝执行需要持久记录的流程并报告原因。DSH 将来公开支持这个参数后，可以删除这份补丁并更新固定依赖版本。
+
+补丁包含 DSH 的少量上下文代码，使用 [MIT 许可证](DSH-LICENSE)。

package/dist/compat/dsh-session-source.patch

@@ -0,0 +1,16 @@
+--- a/packages/core/session/src/index.ts
++++ b/packages/core/session/src/index.ts
+@@ -722,10 +722,11 @@
+   append<T extends SessionEventType>(
+     type: T,
+     data: SessionEventMap[T],
+-    ...opts: T extends SurfaceEventType ? [opts: SurfaceIntent<T>] : []
++    ...opts: T extends SurfaceEventType ? [opts: SurfaceIntent<T>] : [opts?: { ignorable: true }]
+   ): SessionEvent<T> {
+-    const surfaceOpts: SurfaceIntent | undefined = opts[0]
++    const surfaceOpts: (Partial<SurfaceIntent> & { ignorable?: true }) | undefined = opts[0]
+     const surfaceMetadata = {
++      ...surfaceOpts?.ignorable === true ? { ignorable: true as const } : {},
+       ...surfaceOpts?.sourceEventSeqs === undefined ? {} : { sourceEventSeqs: surfaceOpts.sourceEventSeqs },
+       ...surfaceOpts?.surfaceOp === undefined ? {} : { surfaceOp: surfaceOpts.surfaceOp },
+     }

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { ContextConfig } from './types.js';
+/** Validate YAML/JSON plugin settings before registering any listeners. */
+export declare function validateConfig(config: ContextConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAW1D"}

package/dist/config.js

@@ -0,0 +1,27 @@
+const integerKeys = ['reserveTokens', 'keepRecentTokens', 'maxSummaryTokens', 'summaryToolChars', 'maxOverflowRetries', 'maxConsecutiveFailures', 'keepRecentTools', 'protectToolTokens', 'minPruneTokens', 'screenshotTriggerImages', 'tailTurns', 'summaryRetryDelayMs', 'idleMinutes', 'toolHighWaterChars', 'toolLowWaterChars', 'maxSummaryAttempts', 'maxRestoredFiles', 'maxFileTokens', 'maxRestoreTokens', 'maxRestoredImages', 'maxSkillTokens'];
+const keys = new Set([...integerKeys, 'auto', 'thresholdRatio', 'summarizationProvider', 'summarizationModel', 'prune', 'restoreContext']);
+/** Validate YAML/JSON plugin settings before registering any listeners. */
+export function validateConfig(config) {
+    for (const key of Object.keys(config))
+        if (!keys.has(key))
+            throw new Error(`Unknown context setting: ${key}`);
+    for (const key of integerKeys) {
+        const value = config[key];
+        if (value !== undefined && (!Number.isSafeInteger(value) || value < 0))
+            throw new Error(`${key} must be a non-negative safe integer`);
+    }
+    for (const key of ['maxSummaryTokens', 'maxConsecutiveFailures', 'maxSummaryAttempts'])
+        if (config[key] === 0)
+            throw new Error(`${key} must be positive`);
+    for (const key of ['auto', 'prune', 'restoreContext'])
+        if (config[key] !== undefined && typeof config[key] !== 'boolean')
+            throw new Error(`${key} must be a boolean`);
+    if (config.thresholdRatio !== undefined && (!Number.isFinite(config.thresholdRatio) || config.thresholdRatio <= 0 || config.thresholdRatio > 1))
+        throw new Error('thresholdRatio must be greater than 0 and at most 1');
+    for (const key of ['summarizationProvider', 'summarizationModel'])
+        if (config[key] !== undefined && (typeof config[key] !== 'string' || config[key].trim().length === 0))
+            throw new Error(`${key} must be a non-empty string`);
+    if ((config.summarizationProvider === undefined) !== (config.summarizationModel === undefined))
+        throw new Error('Set summarizationProvider and summarizationModel together');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,CAAC,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,WAAW,EAAE,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,gBAAgB,CAAU,CAAC;AACpc,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEnJ,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;IAC9G,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,sCAAsC,CAAC,CAAC;IACxI,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,oBAAoB,CAAU;QAAE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,mBAAmB,CAAC,CAAC;IACnK,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,gBAAgB,CAAU;QAAE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,oBAAoB,CAAC,CAAC;IAC/K,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,cAAc,IAAI,CAAC,IAAI,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACxN,KAAK,MAAM,GAAG,IAAI,CAAC,uBAAuB,EAAE,oBAAoB,CAAU;QAAE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,6BAA6B,CAAC,CAAC;IACxO,IAAI,CAAC,MAAM,CAAC,qBAAqB,KAAK,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,KAAK,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;AAC/K,CAAC"}

package/dist/host.d.ts

@@ -0,0 +1,30 @@
+/** DSH observations and transport for independently implemented context pipelines. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { CommandId } from '@deepseek-ai/dsh-commands/brand';
+import type { CompactionAgentContext } from '@deepseek-ai/dsh-compaction';
+import type { ContextConfig } from './types.js';
+import type { ContextHost, ContextRecovery } from './pipeline.js';
+declare module '@deepseek-ai/dsh-session/types' {
+    interface SessionEventMap {
+        'context-zoo/state': {
+            plugin: string;
+            kind: string;
+            data: Record<string, unknown>;
+        };
+    }
+}
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        /**
+         * Supply observed external runtime state, such as an actual transcript location.
+         * @param agent - session owner requesting recovery observations.
+         * @param signal - operation cancellation.
+         * @param next - delegate when this integration has no observations.
+         * @mode waterfall
+         */
+        'context-zoo/recovery'(agent: CompactionAgentContext, signal: AbortSignal, next: () => Promise<ContextRecovery | undefined>): Promise<ContextRecovery | undefined>;
+    }
+}
+/** Build low-level operations scoped to one run and its cancellation signal. */
+export declare function createHost(ctx: Context, agent: CompactionAgentContext, id: string, config: ContextConfig, signal: AbortSignal, manual?: boolean, sourceCommandId?: CommandId): ContextHost;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAK1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAgB,WAAW,EAAE,eAAe,EAAmB,MAAM,eAAe,CAAC;AAGjG,OAAO,QAAQ,gCAAgC,CAAC;IAC9C,UAAU,eAAe;QACvB,mBAAmB,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC;KACtF;CACF;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,MAAM;QACd;;;;;;WAMG;QACH,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;KACpK;CACF;AAaD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAQ,EAAE,eAAe,CAAC,EAAE,SAAS,GAAG,WAAW,CAgJxL"}

package/dist/host.js

@@ -0,0 +1,185 @@
+import { assembleAssistantStream, BlockAssembler, freezeMessage, LlmError } from '@deepseek-ai/dsh-llm';
+import { SessionId } from '@deepseek-ai/dsh-session';
+import { assertInactive, compactTransaction } from './transaction.js';
+const checkedSessionClasses = new WeakSet();
+function checkSessionWriter(session, plugin) {
+    const implementation = session.constructor;
+    if (checkedSessionClasses.has(implementation))
+        return;
+    const probe = implementation.create(SessionId('context-zoo-runtime-probe'));
+    const marker = probe.append('context-zoo/state', { plugin, kind: 'probe', data: {} }, { ignorable: true });
+    if (marker.ignorable !== true)
+        throw new Error('The active DSH Session implementation needs the supplied ignorable-event patch; see dsh-context-core/dist/compat/README.md');
+    checkedSessionClasses.add(implementation);
+}
+/** Build low-level operations scoped to one run and its cancellation signal. */
+export function createHost(ctx, agent, id, config, signal, manual = false, sourceCommandId) {
+    const session = agent.session;
+    checkSessionWriter(session, id);
+    const calls = [];
+    const target = () => {
+        const request = session.requestHeader()?.config;
+        const provider = request?.provider ?? agent.options.provider;
+        const model = request?.model ?? agent.options.model;
+        if (!provider || !model)
+            throw new Error('Context management needs a routed provider and model');
+        return { provider, model, maxTokens: request?.maxTokens };
+    };
+    const record = (kind, data) => {
+        // Durable metadata must contain JSON values, including no undefined properties.
+        const durable = JSON.parse(JSON.stringify(data));
+        const event = session.append('context-zoo/state', { plugin: id, kind, data: durable }, { ignorable: true });
+        if (event.ignorable !== true)
+            throw new Error('DSH Session.append needs the supplied ignorable-event patch; see dsh-context-core/dist/compat/README.md');
+    };
+    const host = {
+        signal,
+        record,
+        records: kind => session.snapshotEvents().flatMap(event => event.type === 'context-zoo/state' && event.data.plugin === id && event.data.kind === kind ? [event.data.data] : []),
+        async snapshot() {
+            signal.throwIfAborted();
+            const route = target();
+            const info = await ctx.llm.resolveModelInfo(route.provider, route.model, signal);
+            signal.throwIfAborted();
+            if (!info.context)
+                throw new Error(`No context window configured for ${route.provider}/${route.model}`);
+            const recovery = await ctx.waterfall('context-zoo/recovery', agent, signal, async () => undefined);
+            signal.throwIfAborted();
+            const measurement = ctx.tokenMeter.measure(session);
+            const prices = new Map(measurement.nodes.map(node => [node.seq, node.tokens]));
+            const tools = new Map();
+            let requestSeries = 'initial';
+            let turnKey;
+            const archive = [];
+            for (const event of session.snapshotEvents()) {
+                if (event.type === 'turn/start') {
+                    turnKey = `turn:${event.seq}`;
+                    requestSeries = turnKey;
+                }
+                if (event.type === 'tool/call')
+                    tools.set(event.data.callId, event.data);
+                const message = session.deriveEventMessage(event) ?? (event.type === 'system/message' || event.type === 'developer/message' ? event.data.message : null);
+                if (message === null)
+                    continue;
+                for (const block of message.content)
+                    if (block.type === 'tool-call')
+                        tools.set(block.id, { name: block.name, arguments: block.arguments });
+                const assembled = event.type === 'assistant/message' ? assembleAssistantStream(event.data.stream) : undefined;
+                if (event.type === 'assistant/message' && assembled?.finish.kind !== 'error' && assembled?.finish.kind !== 'aborted')
+                    requestSeries = `response:${event.seq}`;
+                const usage = event.type === 'assistant/message' ? event.data.usage ?? assembled?.usage : undefined;
+                const tool = message.role === 'tool' ? tools.get(message.toolCallId) : undefined;
+                archive.push({
+                    seq: event.seq, message, time: event.time, tokens: prices.get(event.seq) ?? ctx.tokenMeter.estimateMessage(message),
+                    ...assembled === undefined ? {} : { finish: assembled.finish.kind, ...usage === undefined ? {} : { usage } },
+                    ...tool === undefined ? {} : { toolName: tool.name, toolArguments: tool.arguments },
+                });
+            }
+            const bySeq = new Map(archive.map(entry => [entry.seq, entry]));
+            const entries = session.surface.nodes.map(seq => {
+                const entry = bySeq.get(seq);
+                if (!entry)
+                    throw new Error(`Missing message for surface event ${seq}`);
+                return entry;
+            });
+            return {
+                entries, archive, contextWindow: info.context.contextWindow,
+                maxOutputTokens: route.maxTokens ?? info.defaultMaxTokens ?? 32_000,
+                provider: route.provider, model: route.model, tools: session.requestHeader()?.tools ?? [],
+                measuredTokens: measurement.totalTokens, now: Date.now(), cwd: session.header.cwd ?? '', sessionId: session.id, requestSeries, ...turnKey === undefined ? {} : { turnKey },
+                ...recovery === undefined ? {} : { recovery },
+            };
+        },
+        async summarize(request) {
+            signal.throwIfAborted();
+            const route = target();
+            const provider = request.provider ?? config.summarizationProvider ?? route.provider;
+            const model = request.model ?? config.summarizationModel ?? route.model;
+            const messages = [...request.messages, { role: 'user', content: [{ type: 'text', text: request.instruction }] }];
+            const tools = request.includeTools ? session.requestHeader()?.tools : undefined;
+            const requestData = { provider, model, maxTokens: request.maxTokens, messages, ...(tools === undefined ? {} : { tools }) };
+            const callId = `${id}:${session.seq}`;
+            record('model-request', { callId, ...requestData });
+            const callIndex = calls.push(undefined) - 1;
+            try {
+                const assembler = new BlockAssembler();
+                for await (const chunk of ctx.llm.stream({ ...requestData, toolHistory: session.toolHistory(), sessionId: session.id, purpose: 'compaction', signal }))
+                    assembler.push(chunk);
+                signal.throwIfAborted();
+                const finish = assembler.finish;
+                const content = assembler.blocks();
+                const response = {
+                    provider, model, maxTokens: request.maxTokens, content,
+                    text: content.filter(block => block.type === 'text').map(block => block.text).join('\n'),
+                    finish: finish.kind, ...assembler.usage === undefined ? {} : { usage: assembler.usage },
+                };
+                record('model-result', { callId, ...response, ...(finish.kind === 'error' || finish.kind === 'aborted' ? { failure: finish.failure } : {}) });
+                calls[callIndex] = response;
+                if (finish.kind === 'error' || finish.kind === 'aborted')
+                    throw new LlmError(finish.failure.message, finish.failure.code, finish.failure);
+                return response;
+            }
+            catch (error) {
+                record('model-error', { callId, message: error instanceof Error ? error.message : String(error), ...error instanceof LlmError ? { failure: error.failure } : {} });
+                signal.throwIfAborted();
+                throw error;
+            }
+        },
+        replace(replacements) {
+            signal.throwIfAborted();
+            assertInactive(session);
+            const seen = new Set();
+            const changes = replacements.map(replacement => {
+                if (seen.has(replacement.seq))
+                    throw new Error('Duplicate tool replacement');
+                seen.add(replacement.seq);
+                const event = session.eventAt(replacement.seq);
+                if (!session.surface.nodes.includes(replacement.seq) || (event?.type !== 'tool/result' && event?.type !== 'user/message'))
+                    throw new Error('Replacement must target a current user message or tool result');
+                const original = event.type === 'tool/result' ? event.data.message : event.data;
+                const message = freezeMessage({ ...original, content: [...replacement.content] });
+                return { event, message, price: ctx.tokenMeter.estimateMessage(original) };
+            });
+            for (const { event, message, price } of changes) {
+                session.append('compaction/prune', { shadowedRange: { start: event.seq, end: event.seq }, shadowedSeqs: [event.seq], shadowedTokenCount: price });
+                const options = { surfaceOp: { op: 'replace', startSeq: event.seq, endSeq: event.seq }, sourceEventSeqs: [event.seq] };
+                if (event.type === 'tool/result' && message.role === 'tool')
+                    session.append('tool/result', { ...event.data, message }, options);
+                else if (event.type === 'user/message' && message.role === 'user')
+                    session.append('user/message', message, options);
+            }
+        },
+        compact(entries, summarize) {
+            const firstCall = calls.length;
+            return compactTransaction({ session, meter: ctx.tokenMeter, entries, signal, manual, sourceCommandId, summarize, calls: () => calls.slice(firstCall), target: target() });
+        },
+        async readFile(path, maxChars) {
+            signal.throwIfAborted();
+            const fs = ctx.get('fs');
+            if (!fs) {
+                record('file-unavailable', { path, reason: 'No DSH filesystem provider is installed' });
+                return null;
+            }
+            try {
+                const target = await fs.resolve(path, { cwd: session.header.cwd, signal });
+                const chunks = await fs.streamText(target, signal);
+                let text = '';
+                for await (const chunk of chunks) {
+                    signal.throwIfAborted();
+                    text += chunk.slice(0, Math.max(0, maxChars - text.length));
+                    if (text.length >= maxChars)
+                        break;
+                }
+                signal.throwIfAborted();
+                return text;
+            }
+            catch (error) {
+                signal.throwIfAborted();
+                record('file-unavailable', { path, reason: error instanceof Error ? error.message : String(error) });
+                return null;
+            }
+        },
+    };
+    return host;
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/** Independent agent pipelines and their DSH integration. */
+import './host.js';
+export type * from './types.js';
+export { createContextPlugin, summarizeBranch } from './plugin.js';
+export type { ContextPlugin } from './plugin.js';
+export { validateConfig } from './config.js';
+export type * from './pipeline.js';
+//# 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":"AAAA,6DAA6D;AAC7D,OAAO,WAAW,CAAC;AACnB,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,mBAAmB,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/** Independent agent pipelines and their DSH integration. */
+import './host.js';
+export { createContextPlugin, summarizeBranch } from './plugin.js';
+export { validateConfig } from './config.js';
+//# 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,6DAA6D;AAC7D,OAAO,WAAW,CAAC;AAEnB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}