@infituit/opencode-acp 0.0.0-stage → 2.0.0-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +622 -0
- package/NOTICE +29 -0
- package/README.md +203 -2
- package/dist/auth.d.ts +4 -0
- package/dist/auth.d.ts.map +1 -0
- package/dist/commands/compression-targets.d.ts +13 -0
- package/dist/commands/compression-targets.d.ts.map +1 -0
- package/dist/commands/context.d.ts +52 -0
- package/dist/commands/context.d.ts.map +1 -0
- package/dist/commands/export.d.ts +56 -0
- package/dist/commands/export.d.ts.map +1 -0
- package/dist/commands/index.d.ts +4 -0
- package/dist/commands/index.d.ts.map +1 -0
- package/dist/commands/stats.d.ts +19 -0
- package/dist/commands/stats.d.ts.map +1 -0
- package/dist/compress/decompress-logic.d.ts +62 -0
- package/dist/compress/decompress-logic.d.ts.map +1 -0
- package/dist/compress/decompress.d.ts +4 -0
- package/dist/compress/decompress.d.ts.map +1 -0
- package/dist/compress/hide-consumed.d.ts +15 -0
- package/dist/compress/hide-consumed.d.ts.map +1 -0
- package/dist/compress/hide-failed.d.ts +3 -0
- package/dist/compress/hide-failed.d.ts.map +1 -0
- package/dist/compress/image-archive.d.ts +43 -0
- package/dist/compress/image-archive.d.ts.map +1 -0
- package/dist/compress/index.d.ts +9 -0
- package/dist/compress/index.d.ts.map +1 -0
- package/dist/compress/keep-markers.d.ts +11 -0
- package/dist/compress/keep-markers.d.ts.map +1 -0
- package/dist/compress/parts.d.ts +4 -0
- package/dist/compress/parts.d.ts.map +1 -0
- package/dist/compress/pipeline.d.ts +141 -0
- package/dist/compress/pipeline.d.ts.map +1 -0
- package/dist/compress/protected-content.d.ts +12 -0
- package/dist/compress/protected-content.d.ts.map +1 -0
- package/dist/compress/quality-gate/algorithms/index.d.ts +3 -0
- package/dist/compress/quality-gate/algorithms/index.d.ts.map +1 -0
- package/dist/compress/quality-gate/evaluate.d.ts +21 -0
- package/dist/compress/quality-gate/evaluate.d.ts.map +1 -0
- package/dist/compress/quality-gate/index.d.ts +7 -0
- package/dist/compress/quality-gate/index.d.ts.map +1 -0
- package/dist/compress/quality-gate/registry.d.ts +6 -0
- package/dist/compress/quality-gate/registry.d.ts.map +1 -0
- package/dist/compress/quality-gate/rejection.d.ts +18 -0
- package/dist/compress/quality-gate/rejection.d.ts.map +1 -0
- package/dist/compress/quality-gate/types.d.ts +51 -0
- package/dist/compress/quality-gate/types.d.ts.map +1 -0
- package/dist/compress/range-utils.d.ts +28 -0
- package/dist/compress/range-utils.d.ts.map +1 -0
- package/dist/compress/range.d.ts +8 -0
- package/dist/compress/range.d.ts.map +1 -0
- package/dist/compress/recap.d.ts +4 -0
- package/dist/compress/recap.d.ts.map +1 -0
- package/dist/compress/search.d.ts +17 -0
- package/dist/compress/search.d.ts.map +1 -0
- package/dist/compress/smart-plan.d.ts +28 -0
- package/dist/compress/smart-plan.d.ts.map +1 -0
- package/dist/compress/state.d.ts +10 -0
- package/dist/compress/state.d.ts.map +1 -0
- package/dist/compress/status.d.ts +19 -0
- package/dist/compress/status.d.ts.map +1 -0
- package/dist/compress/timing.d.ts +17 -0
- package/dist/compress/timing.d.ts.map +1 -0
- package/dist/compress/types.d.ts +120 -0
- package/dist/compress/types.d.ts.map +1 -0
- package/dist/compress-permission.d.ts +6 -0
- package/dist/compress-permission.d.ts.map +1 -0
- package/dist/config-validation.d.ts +13 -0
- package/dist/config-validation.d.ts.map +1 -0
- package/dist/config.d.ts +248 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/gc/merge.d.ts +17 -0
- package/dist/gc/merge.d.ts.map +1 -0
- package/dist/hooks.d.ts +41 -0
- package/dist/hooks.d.ts.map +1 -0
- package/dist/host-permissions.d.ts +31 -0
- package/dist/host-permissions.d.ts.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +14411 -0
- package/dist/index.js.map +1 -0
- package/dist/logger.d.ts +48 -0
- package/dist/logger.d.ts.map +1 -0
- package/dist/message-ids.d.ts +27 -0
- package/dist/message-ids.d.ts.map +1 -0
- package/dist/messages/enforce-budget.d.ts +65 -0
- package/dist/messages/enforce-budget.d.ts.map +1 -0
- package/dist/messages/filter/apply.d.ts +14 -0
- package/dist/messages/filter/apply.d.ts.map +1 -0
- package/dist/messages/filter/builtin/index.d.ts +2 -0
- package/dist/messages/filter/builtin/index.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-context.d.ts +4 -0
- package/dist/messages/filter/builtin/omo-context.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-mode-injection.d.ts +4 -0
- package/dist/messages/filter/builtin/omo-mode-injection.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-system-reminder.d.ts +4 -0
- package/dist/messages/filter/builtin/omo-system-reminder.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-task-directive.d.ts +4 -0
- package/dist/messages/filter/builtin/omo-task-directive.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-todo-continuation.d.ts +4 -0
- package/dist/messages/filter/builtin/omo-todo-continuation.d.ts.map +1 -0
- package/dist/messages/filter/index.d.ts +6 -0
- package/dist/messages/filter/index.d.ts.map +1 -0
- package/dist/messages/filter/registry.d.ts +6 -0
- package/dist/messages/filter/registry.d.ts.map +1 -0
- package/dist/messages/filter/types.d.ts +95 -0
- package/dist/messages/filter/types.d.ts.map +1 -0
- package/dist/messages/index.d.ts +9 -0
- package/dist/messages/index.d.ts.map +1 -0
- package/dist/messages/inject/candidates.d.ts +30 -0
- package/dist/messages/inject/candidates.d.ts.map +1 -0
- package/dist/messages/inject/inject.d.ts +26 -0
- package/dist/messages/inject/inject.d.ts.map +1 -0
- package/dist/messages/inject/policy/index.d.ts +5 -0
- package/dist/messages/inject/policy/index.d.ts.map +1 -0
- package/dist/messages/inject/policy/registry.d.ts +8 -0
- package/dist/messages/inject/policy/registry.d.ts.map +1 -0
- package/dist/messages/inject/policy/types.d.ts +2 -0
- package/dist/messages/inject/policy/types.d.ts.map +1 -0
- package/dist/messages/inject/utils.d.ts +235 -0
- package/dist/messages/inject/utils.d.ts.map +1 -0
- package/dist/messages/priority.d.ts +13 -0
- package/dist/messages/priority.d.ts.map +1 -0
- package/dist/messages/prune.d.ts +5 -0
- package/dist/messages/prune.d.ts.map +1 -0
- package/dist/messages/query.d.ts +36 -0
- package/dist/messages/query.d.ts.map +1 -0
- package/dist/messages/reasoning-strip.d.ts +32 -0
- package/dist/messages/reasoning-strip.d.ts.map +1 -0
- package/dist/messages/shape.d.ts +5 -0
- package/dist/messages/shape.d.ts.map +1 -0
- package/dist/messages/sticky-truncation.d.ts +55 -0
- package/dist/messages/sticky-truncation.d.ts.map +1 -0
- package/dist/messages/sync.d.ts +4 -0
- package/dist/messages/sync.d.ts.map +1 -0
- package/dist/messages/truncate-tools.d.ts +12 -0
- package/dist/messages/truncate-tools.d.ts.map +1 -0
- package/dist/messages/utils.d.ts +30 -0
- package/dist/messages/utils.d.ts.map +1 -0
- package/dist/prompts/compress-range.d.ts +10 -0
- package/dist/prompts/compress-range.d.ts.map +1 -0
- package/dist/prompts/context-limit-nudge.d.ts +8 -0
- package/dist/prompts/context-limit-nudge.d.ts.map +1 -0
- package/dist/prompts/extensions/nudge.d.ts +16 -0
- package/dist/prompts/extensions/nudge.d.ts.map +1 -0
- package/dist/prompts/extensions/system.d.ts +4 -0
- package/dist/prompts/extensions/system.d.ts.map +1 -0
- package/dist/prompts/extensions/tool.d.ts +3 -0
- package/dist/prompts/extensions/tool.d.ts.map +1 -0
- package/dist/prompts/index.d.ts +4 -0
- package/dist/prompts/index.d.ts.map +1 -0
- package/dist/prompts/iteration-nudge.d.ts +7 -0
- package/dist/prompts/iteration-nudge.d.ts.map +1 -0
- package/dist/prompts/store.d.ts +25 -0
- package/dist/prompts/store.d.ts.map +1 -0
- package/dist/prompts/system.d.ts +11 -0
- package/dist/prompts/system.d.ts.map +1 -0
- package/dist/prompts/turn-nudge.d.ts +7 -0
- package/dist/prompts/turn-nudge.d.ts.map +1 -0
- package/dist/protected-patterns.d.ts +5 -0
- package/dist/protected-patterns.d.ts.map +1 -0
- package/dist/state/index.d.ts +6 -0
- package/dist/state/index.d.ts.map +1 -0
- package/dist/state/message-types.d.ts +90 -0
- package/dist/state/message-types.d.ts.map +1 -0
- package/dist/state/model-limits.d.ts +27 -0
- package/dist/state/model-limits.d.ts.map +1 -0
- package/dist/state/persistence.d.ts +93 -0
- package/dist/state/persistence.d.ts.map +1 -0
- package/dist/state/rebuild.d.ts +40 -0
- package/dist/state/rebuild.d.ts.map +1 -0
- package/dist/state/state.d.ts +36 -0
- package/dist/state/state.d.ts.map +1 -0
- package/dist/state/tool-cache.d.ts +13 -0
- package/dist/state/tool-cache.d.ts.map +1 -0
- package/dist/state/types.d.ts +221 -0
- package/dist/state/types.d.ts.map +1 -0
- package/dist/state/utils.d.ts +57 -0
- package/dist/state/utils.d.ts.map +1 -0
- package/dist/token-utils.d.ts +42 -0
- package/dist/token-utils.d.ts.map +1 -0
- package/dist/ui/notification.d.ts +13 -0
- package/dist/ui/notification.d.ts.map +1 -0
- package/dist/ui/utils.d.ts +6 -0
- package/dist/ui/utils.d.ts.map +1 -0
- package/dist/update.d.ts +24 -0
- package/dist/update.d.ts.map +1 -0
- package/dist/v2/messages.d.ts +7 -0
- package/dist/v2/messages.d.ts.map +1 -0
- package/dist/v2/plugin.d.ts +3 -0
- package/dist/v2/plugin.d.ts.map +1 -0
- package/package.json +76 -5
package/README.md
CHANGED
|
@@ -1,3 +1,204 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Active Context Pruning
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
ACP 是 [OpenCode](https://opencode.ai) 的上下文管理插件。它向模型提供压缩、恢复、搜索摘要和查看上下文用量的工具,用摘要替换暂时不需要的历史内容。
|
|
4
|
+
|
|
5
|
+
> **ACP 2.0 要求 OpenCode >=2.1.4 且 <3。** 本版本使用 V2 插件 API,不支持 OpenCode 1.x。通过 GitHub Release 和 npm 包 `@infituit/opencode-acp` 分发;无 scope 的 `opencode-acp` 不是本项目发布的包。
|
|
6
|
+
|
|
7
|
+
## 安装
|
|
8
|
+
|
|
9
|
+
需要 OpenCode **>=2.1.4 且 <3**。通过 npm 包全局安装(已包含预构建代码,无需从 Git 构建):
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
opencode plugin add @infituit/opencode-acp@2.0.0-beta.1
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
也可使用 `opencode plugin add @infituit/opencode-acp@beta` 跟随 Beta 渠道,或者在 `opencode.json(c)` 中添加固定版本:
|
|
16
|
+
|
|
17
|
+
```json
|
|
18
|
+
{
|
|
19
|
+
"$schema": "https://opencode.ai/config.json",
|
|
20
|
+
"plugins": ["@infituit/opencode-acp@2.0.0-beta.1"]
|
|
21
|
+
}
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
移除已有的 npm、Git 或本地 ACP 插件项,避免重复加载。修改配置后执行 `/reload`,新建会话并运行 `/acp` 确认插件可用。
|
|
25
|
+
GitHub Release 仍保留预构建 tarball;Git tag 安装会从源码执行 `prepare` 构建,需要 Git 和 Node.js/npm。GitHub 自动生成的源码归档不含 `dist/`。
|
|
26
|
+
|
|
27
|
+
> [!IMPORTANT]
|
|
28
|
+
> **禁用 OpenCode 的内置自动压缩。** ACP 自行处理上下文管理,两者同时运行可能导致消息重新展开、压缩状态丢失。请在 `opencode.json` 中添加:
|
|
29
|
+
>
|
|
30
|
+
> ```jsonc
|
|
31
|
+
> {
|
|
32
|
+
> "compaction": {
|
|
33
|
+
> "auto": false,
|
|
34
|
+
> },
|
|
35
|
+
> }
|
|
36
|
+
> ```
|
|
37
|
+
>
|
|
38
|
+
> 或设置环境变量:`OPENCODE_DISABLE_AUTOCOMPACT=1`
|
|
39
|
+
|
|
40
|
+
## 命令
|
|
41
|
+
|
|
42
|
+
ACP 提供 `/acp` 斜杠命令:
|
|
43
|
+
|
|
44
|
+
| 命令 | 说明 |
|
|
45
|
+
| -------------- | -------------------------------------------------------------------------------------------------- |
|
|
46
|
+
| `/acp` | 显示压缩状态(同 `/acp stats`);`/acp help` 查看命令列表 |
|
|
47
|
+
| `/acp context` | 按类别(system、user、assistant、tools 等)显示 token 用量明细,以及通过剪枝节省的量 |
|
|
48
|
+
| `/acp stats` | 压缩状态:压缩块、上下文用量、推荐范围(与 `acp_status` 工具同一报告) |
|
|
49
|
+
| `/acp export` | 导出活动压缩块到 markdown 文件。选项:`--output <path>`、`--tier t1,t2,t3`、`--stdout`、`--append` |
|
|
50
|
+
|
|
51
|
+
## 工作原理
|
|
52
|
+
|
|
53
|
+
ACP 根据上下文用量和配置向模型注入压缩提示,由模型选择范围并编写摘要。主要工具包括:
|
|
54
|
+
|
|
55
|
+
- `acp_compress`:将选定范围替换为摘要。
|
|
56
|
+
- `acp_decompress`:按需恢复压缩范围的原始内容。
|
|
57
|
+
- `acp_status`:查看上下文用量、压缩块和可压缩范围。
|
|
58
|
+
- `acp_search_context`:在活动压缩块的摘要中搜索,帮助定位需要恢复的内容。
|
|
59
|
+
|
|
60
|
+
### 分层压缩
|
|
61
|
+
|
|
62
|
+
摘要可以再次压缩,分为三个层级:
|
|
63
|
+
|
|
64
|
+
| 层级 | 名称 | 输入 | 输出 |
|
|
65
|
+
| ---- | ---- | -------- | ---------------- |
|
|
66
|
+
| T1 | 捕获 | 原始对话 | 保留细节的摘要 |
|
|
67
|
+
| T2 | 蒸馏 | T1 摘要 | 决策和结果 |
|
|
68
|
+
| T3 | 浓缩 | T2 摘要 | 进一步精简的事实 |
|
|
69
|
+
|
|
70
|
+
各层使用同一个 `acp_compress` 工具。原始消息使用 `mNNNNN` 引用,压缩块使用 `bN` 引用,层级根据被消费的块检测。例如:
|
|
71
|
+
|
|
72
|
+
```text
|
|
73
|
+
acp_compress({ content: [{ startId: "b5", endId: "b20", summary: "..." }] })
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
压缩时机受上下文阈值、摘要增长量和提醒频率等配置影响,不是固定每若干轮执行一次。压缩提示优先建议处理冗长工具输出、重复探索、已完成任务的中间步骤和不再需要的历史内容。
|
|
77
|
+
|
|
78
|
+
### 限制
|
|
79
|
+
|
|
80
|
+
- 摘要由模型生成,可能遗漏信息。需要原始细节时,应搜索摘要并按需解压;不要把压缩当作无损存档。
|
|
81
|
+
- GC 截断是上下文管理的兜底机制,不能替代正常压缩。
|
|
82
|
+
- 压缩比、缓存命中率和可持续会话长度取决于模型、服务商、配置及任务内容,不保证固定数值或无限会话寿命。
|
|
83
|
+
|
|
84
|
+
## 配置
|
|
85
|
+
|
|
86
|
+
ACP 使用自己的配置文件,按以下顺序加载:
|
|
87
|
+
|
|
88
|
+
1. **全局:** `~/.config/opencode/acp.jsonc`(或 `acp.json`),首次运行时自动创建;设置 `XDG_CONFIG_HOME` 时使用其下的 `opencode` 目录。
|
|
89
|
+
2. **自定义配置目录:** `$OPENCODE_CONFIG_DIR/acp.jsonc`(或 `acp.json`),当设置了 `OPENCODE_CONFIG_DIR` 时。
|
|
90
|
+
3. **项目级:** 项目 `.opencode` 目录下的 `.opencode/acp.jsonc`(或 `acp.json`)。
|
|
91
|
+
|
|
92
|
+
每一层覆盖前一层,因此项目设置优先于全局设置。修改 ACP 配置后请重启 OpenCode。
|
|
93
|
+
|
|
94
|
+
完整字段结构见 [`acp.schema.json`](./acp.schema.json),默认值见 [`src/config.ts`](./src/config.ts) 中的 `defaultConfig`。不需要在配置文件中复制所有默认值,只填写需要覆盖的字段。
|
|
95
|
+
|
|
96
|
+
### 配置示例
|
|
97
|
+
|
|
98
|
+
以下示例设置日志级别、上下文提醒阈值和工具保护,不是完整配置:
|
|
99
|
+
|
|
100
|
+
```jsonc
|
|
101
|
+
{
|
|
102
|
+
"$schema": "https://raw.githubusercontent.com/infituit/opencode-acp/master/acp.schema.json",
|
|
103
|
+
"logLevel": "info",
|
|
104
|
+
"compress": {
|
|
105
|
+
"maxContextLimit": "80%",
|
|
106
|
+
"nudgeFrequency": 5,
|
|
107
|
+
"protectedTools": ["skill", "acp_compress"],
|
|
108
|
+
},
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
上下文阈值接受 token 数或模型上下文窗口的百分比。`maxContextLimit` 是触发压缩提示的软阈值,不是硬性截断上限;达到阈值不代表模型一定立即执行压缩。根据模型的可用上下文调整阈值。
|
|
113
|
+
|
|
114
|
+
### 按 Provider / 按模型覆盖
|
|
115
|
+
|
|
116
|
+
支持的 `compress` 字段可通过嵌套的 `compress.providers` 按 provider 和按模型覆盖:
|
|
117
|
+
|
|
118
|
+
```jsonc
|
|
119
|
+
{
|
|
120
|
+
"compress": {
|
|
121
|
+
"maxContextLimit": "80%",
|
|
122
|
+
"providers": {
|
|
123
|
+
"anthropic": {
|
|
124
|
+
"nudgeGrowthTokens": 20000,
|
|
125
|
+
"models": {
|
|
126
|
+
"claude-sonnet-4.6": { "maxContextLimit": "70%", "nudgeForce": "strong" },
|
|
127
|
+
},
|
|
128
|
+
},
|
|
129
|
+
"openai": { "nudgeGrowthTokens": 40000 },
|
|
130
|
+
},
|
|
131
|
+
},
|
|
132
|
+
}
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
解析为**逐字段**优先级:model > provider > 全局。未知的 provider/model ID 回退到全局值。嵌套的 `maxContextLimit` 同时优先于旧版扁平 `modelMaxLimits` 映射。多层配置(全局 → 配置目录 → 项目)按 provider/model 键深合并。
|
|
136
|
+
|
|
137
|
+
不可覆盖:`permission`、已废弃的 `minContextLimit` / `modelMinLimits` 系列、以及扁平 `modelMaxLimits` / `modelMinLimits` 映射自身。`modelMaxLimits` 仍受支持,只是优先级低于嵌套的 `maxContextLimit`。
|
|
138
|
+
|
|
139
|
+
完整的 `compress.providers` 字段结构见 [`acp.schema.json`](./acp.schema.json)。
|
|
140
|
+
|
|
141
|
+
### 受保护工具
|
|
142
|
+
|
|
143
|
+
默认情况下,以下工具受命令剪枝保护:
|
|
144
|
+
`task`、`skill`、`todowrite`、`todoread`、`acp_compress`、`decompress`、`batch`、`plan_enter`、`plan_exit`、`write`、`edit`。
|
|
145
|
+
|
|
146
|
+
`commands.protectedTools` 数组会添加到此默认列表。
|
|
147
|
+
|
|
148
|
+
`compress.protectedTools` 则控制模型压缩时的工具输出保护:当压缩范围包含这些工具的消息时,其内容完整保留在可见上下文中,只有周围的非受保护消息被压缩。
|
|
149
|
+
|
|
150
|
+
- 默认值为 `["skill", "acp_compress"]`,显式数组替换继承的策略。
|
|
151
|
+
- `"acp_compress"` 始终被强制保护,因为工具调用的 `summary` 参数承载已压缩对话的记录。
|
|
152
|
+
- 设置 `[]` 仅保留对 `acp_compress` 的强制保护;设置 `["task"]` 保护 `task` 和 `acp_compress`。
|
|
153
|
+
|
|
154
|
+
### 质量门控
|
|
155
|
+
|
|
156
|
+
质量门控默认关闭,使用 `rouge-recall-v1` 算法检查摘要长度、留存比例和词汇覆盖。启用方式:
|
|
157
|
+
|
|
158
|
+
```jsonc
|
|
159
|
+
{
|
|
160
|
+
"qualityGate": {
|
|
161
|
+
"enabled": true,
|
|
162
|
+
"algorithm": "rouge-recall-v1",
|
|
163
|
+
},
|
|
164
|
+
}
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
启用后,范围压缩会在提交前检查摘要;未通过时拒绝本次压缩并返回原因。应补充摘要中的关键细节后重试。提交后的检查失败会记录警告,不回滚已完成的压缩。质量指标不能保证摘要在语义上完整或正确。
|
|
168
|
+
|
|
169
|
+
### 日志
|
|
170
|
+
|
|
171
|
+
`logLevel` 支持 `debug`、`info`、`warn`、`error` 和 `silent`,默认值为 `info`。`debug: true` 会覆盖日志级别并启用完整调试日志及按请求快照。
|
|
172
|
+
|
|
173
|
+
### Prompt 覆盖
|
|
174
|
+
|
|
175
|
+
ACP 暴露六个可编辑的 prompt:
|
|
176
|
+
|
|
177
|
+
- `system`
|
|
178
|
+
- `compress-range`
|
|
179
|
+
- `compress-message`
|
|
180
|
+
- `context-limit-nudge`
|
|
181
|
+
- `turn-nudge`
|
|
182
|
+
- `iteration-nudge`
|
|
183
|
+
|
|
184
|
+
此功能默认禁用。在 ACP 配置中将 `experimental.customPrompts` 设为 `true` 以激活。
|
|
185
|
+
|
|
186
|
+
启用后,托管的默认值会作为纯文本 prompt 文件写入 `~/.config/opencode/acp-prompts/defaults/`。该目录中的 `README.md` 解释了每个 prompt 以及如何创建覆盖。
|
|
187
|
+
|
|
188
|
+
要自定义行为,在覆盖目录下添加同名文件并作为纯文本编辑。要重置覆盖,从覆盖目录中删除对应文件。
|
|
189
|
+
|
|
190
|
+
## 更新日志
|
|
191
|
+
|
|
192
|
+
版本历史见 [`support-files/changelog/zh/`](./support-files/changelog/zh/)。
|
|
193
|
+
|
|
194
|
+
## 项目来源与维护
|
|
195
|
+
|
|
196
|
+
本项目 fork 自 [ranxianglei/opencode-acp](https://github.com/ranxianglei/opencode-acp),其最早来源为 [Tarquinen/opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning)。
|
|
197
|
+
|
|
198
|
+
自 v2 起,本项目由 infituit 相关成员独立维护,进行系统性重构,并将插件迁移至 OpenCode V2 API,不再兼容 OpenCode 1.x。
|
|
199
|
+
|
|
200
|
+
**维护原则:不继承历史债务。** 不会为了维持历史兼容性而保留已知问题或延续不合理设计;必要时接受不兼容变更。
|
|
201
|
+
|
|
202
|
+
## 许可证
|
|
203
|
+
|
|
204
|
+
本项目采用 AGPL-3.0-or-later 许可证,见 [LICENSE](./LICENSE)。历史作者及第三方组件的版权和许可声明予以保留,见 [LICENSE](./LICENSE) 和 [NOTICE](./NOTICE)。
|
package/dist/auth.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAQ3D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAsBpD"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { CompressionBlock, PruneMessagesState } from "../state";
|
|
2
|
+
export interface CompressionTarget {
|
|
3
|
+
displayId: number;
|
|
4
|
+
runId: number;
|
|
5
|
+
topic: string;
|
|
6
|
+
compressedTokens: number;
|
|
7
|
+
durationMs: number;
|
|
8
|
+
grouped: boolean;
|
|
9
|
+
blocks: CompressionBlock[];
|
|
10
|
+
}
|
|
11
|
+
export declare function getActiveCompressionTargets(messagesState: PruneMessagesState): CompressionTarget[];
|
|
12
|
+
export declare function resolveCompressionTarget(messagesState: PruneMessagesState, blockId: number): CompressionTarget | null;
|
|
13
|
+
//# sourceMappingURL=compression-targets.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compression-targets.d.ts","sourceRoot":"","sources":["../../src/commands/compression-targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAEpE,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AA8DD,wBAAgB,2BAA2B,CACvC,aAAa,EAAE,kBAAkB,GAClC,iBAAiB,EAAE,CAMrB;AAED,wBAAgB,wBAAwB,CACpC,aAAa,EAAE,kBAAkB,EACjC,OAAO,EAAE,MAAM,GAChB,iBAAiB,GAAG,IAAI,CAkB1B"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ACP Context Command
|
|
3
|
+
* Shows a visual breakdown of token usage in the current session.
|
|
4
|
+
*
|
|
5
|
+
* TOKEN CALCULATION STRATEGY
|
|
6
|
+
* ==========================
|
|
7
|
+
* We minimize tokenizer estimation by leveraging API-reported values wherever possible.
|
|
8
|
+
*
|
|
9
|
+
* WHAT WE GET FROM THE API (exact):
|
|
10
|
+
* - tokens.input : Input tokens for each assistant response
|
|
11
|
+
* - tokens.output : Output tokens generated (includes text + tool calls)
|
|
12
|
+
* - tokens.reasoning: Reasoning tokens used
|
|
13
|
+
* - tokens.cache : Cache read/write tokens
|
|
14
|
+
*
|
|
15
|
+
* HOW WE CALCULATE EACH CATEGORY:
|
|
16
|
+
*
|
|
17
|
+
* SYSTEM = firstAssistant.input + cache.read + cache.write - tokenizer(firstUserMessage)
|
|
18
|
+
* The first response's total input (input + cache.read + cache.write)
|
|
19
|
+
* contains system + first user message. On the first request of a
|
|
20
|
+
* session, the system prompt appears in cache.write (cache creation),
|
|
21
|
+
* not cache.read.
|
|
22
|
+
*
|
|
23
|
+
* TOOLS = tokenizer(toolInputs + toolOutputs) - prunedTokens
|
|
24
|
+
* We must tokenize tools anyway for pruning decisions.
|
|
25
|
+
*
|
|
26
|
+
* USER = tokenizer(all user messages)
|
|
27
|
+
* User messages are typically small, so estimation is acceptable.
|
|
28
|
+
*
|
|
29
|
+
* ASSISTANT = total - system - user - tools
|
|
30
|
+
* Calculated as residual. This absorbs:
|
|
31
|
+
* - Assistant text output tokens
|
|
32
|
+
* - Reasoning tokens (if persisted by the model)
|
|
33
|
+
* - Any estimation errors
|
|
34
|
+
*
|
|
35
|
+
* TOTAL = input + output + reasoning + cache.read + cache.write
|
|
36
|
+
* Matches opencode's UI display.
|
|
37
|
+
*
|
|
38
|
+
* WHY ASSISTANT IS THE RESIDUAL:
|
|
39
|
+
* If reasoning tokens persist in context (model-dependent), they semantically
|
|
40
|
+
* belong with "Assistant" since reasoning IS assistant-generated content.
|
|
41
|
+
*/
|
|
42
|
+
import type { Logger } from "../logger";
|
|
43
|
+
import type { SessionState, WithParts } from "../state";
|
|
44
|
+
export interface ContextCommandContext {
|
|
45
|
+
client: any;
|
|
46
|
+
state: SessionState;
|
|
47
|
+
logger: Logger;
|
|
48
|
+
sessionId: string;
|
|
49
|
+
messages: WithParts[];
|
|
50
|
+
}
|
|
51
|
+
export declare function handleContextCommand(ctx: ContextCommandContext): Promise<void>;
|
|
52
|
+
//# sourceMappingURL=context.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAQvD,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,GAAG,CAAA;IACX,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,EAAE,CAAA;CACxB;AAqOD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* /acp export command — user-initiated export of active compression-block
|
|
3
|
+
* summaries to a markdown file.
|
|
4
|
+
*
|
|
5
|
+
* - Exports ACTIVE blocks only. Consumed/inactive blocks are already
|
|
6
|
+
* distilled into the T2/T3 blocks that superseded them.
|
|
7
|
+
* - Default tier selection = ALL active tiers (T1+T2+T3). A session may have
|
|
8
|
+
* only T1 blocks; defaulting to T2+T3 (as initially proposed in #40) would
|
|
9
|
+
* export nothing for those sessions. Users who want only distilled output
|
|
10
|
+
* can pass `--tier t2,t3`.
|
|
11
|
+
* - Default output path = {cwd}/.opencode/acp-export-{shortSessionId}.md.
|
|
12
|
+
* - `--output -` streams the markdown back to chat instead of writing a file.
|
|
13
|
+
* - Zero new dependencies — pure fs/promises I/O.
|
|
14
|
+
*/
|
|
15
|
+
import type { Logger } from "../logger";
|
|
16
|
+
import type { PluginConfig } from "../config";
|
|
17
|
+
import type { CompressionBlock, CompressionTier, SessionState, WithParts } from "../state/types";
|
|
18
|
+
export interface ExportCommandContext {
|
|
19
|
+
client: any;
|
|
20
|
+
state: SessionState;
|
|
21
|
+
config: PluginConfig;
|
|
22
|
+
logger: Logger;
|
|
23
|
+
sessionId: string;
|
|
24
|
+
messages: WithParts[];
|
|
25
|
+
workingDirectory: string;
|
|
26
|
+
}
|
|
27
|
+
export interface ExportOptions {
|
|
28
|
+
/** Resolved output path. `"-"` means stream to chat (stdout equivalent). */
|
|
29
|
+
outputPath: string;
|
|
30
|
+
/** Which tiers to include. Empty set = include all. */
|
|
31
|
+
tiers: Set<CompressionTier>;
|
|
32
|
+
includeMetadata: boolean;
|
|
33
|
+
append: boolean;
|
|
34
|
+
}
|
|
35
|
+
/** @internal exported for tests */
|
|
36
|
+
export declare function parseExportArgs(rawArgs: string): ExportOptions;
|
|
37
|
+
/** @internal exported for tests */
|
|
38
|
+
export declare function parseTiers(raw: string): Set<CompressionTier>;
|
|
39
|
+
/** @internal exported for tests */
|
|
40
|
+
export declare function resolveDefaultOutputPath(sessionId: string, cwd: string): string;
|
|
41
|
+
/**
|
|
42
|
+
* Render the export markdown. Pure function — no I/O. Exported for testing.
|
|
43
|
+
*/
|
|
44
|
+
export declare function renderExportMarkdown(params: {
|
|
45
|
+
sessionId: string;
|
|
46
|
+
generatedAt: Date;
|
|
47
|
+
blocks: CompressionBlock[];
|
|
48
|
+
tiers: Set<CompressionTier>;
|
|
49
|
+
includeMetadata: boolean;
|
|
50
|
+
}): string;
|
|
51
|
+
/**
|
|
52
|
+
* Main handler invoked by the command hook.
|
|
53
|
+
* @param args raw argument string following `/acp export` (may be empty).
|
|
54
|
+
*/
|
|
55
|
+
export declare function handleExportCommand(ctx: ExportCommandContext, args: string): Promise<void>;
|
|
56
|
+
//# sourceMappingURL=export.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EACR,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,SAAS,EACZ,MAAM,gBAAgB,CAAA;AAWvB,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,GAAG,CAAA;IACX,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC1B,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,KAAK,EAAE,GAAG,CAAC,eAAe,CAAC,CAAA;IAC3B,eAAe,EAAE,OAAO,CAAA;IACxB,MAAM,EAAE,OAAO,CAAA;CAClB;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAuE9D;AAkBD,mCAAmC;AACnC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,CAwB5D;AAED,mCAAmC;AACnC,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/E;AAsDD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,IAAI,CAAA;IACjB,MAAM,EAAE,gBAAgB,EAAE,CAAA;IAC1B,KAAK,EAAE,GAAG,CAAC,eAAe,CAAC,CAAA;IAC3B,eAAe,EAAE,OAAO,CAAA;CAC3B,GAAG,MAAM,CA0ET;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,GAAG,EAAE,oBAAoB,EACzB,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAyEf"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { Logger } from "../logger";
|
|
2
|
+
import type { PluginConfig } from "../config";
|
|
3
|
+
import type { SessionState, WithParts } from "../state";
|
|
4
|
+
export interface StatsCommandContext {
|
|
5
|
+
client: any;
|
|
6
|
+
state: SessionState;
|
|
7
|
+
config: PluginConfig;
|
|
8
|
+
logger: Logger;
|
|
9
|
+
sessionId: string;
|
|
10
|
+
messages: WithParts[];
|
|
11
|
+
userInfo?: {
|
|
12
|
+
providerId?: string;
|
|
13
|
+
modelId?: string;
|
|
14
|
+
agent?: string;
|
|
15
|
+
variant?: string;
|
|
16
|
+
};
|
|
17
|
+
}
|
|
18
|
+
export declare function handleStatsCommand(ctx: StatsCommandContext): Promise<void>;
|
|
19
|
+
//# sourceMappingURL=stats.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAIvD,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,GAAG,CAAA;IACX,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACJ;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhF"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import type { CompressionBlock, PruneMessagesState, WithParts } from "../state";
|
|
2
|
+
import type { CompressionTarget } from "../commands/compression-targets";
|
|
3
|
+
export declare function parseBlockIdArg(arg: string): number | null;
|
|
4
|
+
export type DecompressMode = "block" | "range";
|
|
5
|
+
export declare function resolveDecompressMode(args: Record<string, unknown>): {
|
|
6
|
+
ok: true;
|
|
7
|
+
mode: DecompressMode;
|
|
8
|
+
} | {
|
|
9
|
+
ok: false;
|
|
10
|
+
error: string;
|
|
11
|
+
};
|
|
12
|
+
export declare function findActiveBlocksOverlappingMessages(messagesState: PruneMessagesState, messageIds: Set<string>): CompressionBlock[];
|
|
13
|
+
export declare function findActiveParentBlockId(messagesState: PruneMessagesState, block: CompressionBlock): number | null;
|
|
14
|
+
export declare function findActiveAncestorBlockId(messagesState: PruneMessagesState, target: CompressionTarget): number | null;
|
|
15
|
+
export declare function snapshotActiveMessages(messagesState: PruneMessagesState): Map<string, number>;
|
|
16
|
+
export declare function deactivateCompressionTarget(messagesState: PruneMessagesState, target: CompressionTarget, options?: {
|
|
17
|
+
full?: boolean;
|
|
18
|
+
}): void;
|
|
19
|
+
export interface RestoredMessagesResult {
|
|
20
|
+
restoredMessageCount: number;
|
|
21
|
+
restoredTokens: number;
|
|
22
|
+
}
|
|
23
|
+
export declare function computeRestoredMessages(messagesState: PruneMessagesState, activeMessagesBefore: Map<string, number>): RestoredMessagesResult;
|
|
24
|
+
export interface DecompressAvailabilityResult {
|
|
25
|
+
/** Message IDs whose visibility this decompression would restore (membership-wise). */
|
|
26
|
+
requiredMessageIds: string[];
|
|
27
|
+
/** Subset of requiredMessageIds present in the fetched host history. */
|
|
28
|
+
availableMessageIds: string[];
|
|
29
|
+
/** Subset of requiredMessageIds absent from the fetched host history.
|
|
30
|
+
* Non-empty ⇒ committing would claim restored content that does not exist. */
|
|
31
|
+
missingMessageIds: string[];
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Compute the message IDs whose visibility changes if `targets` are deactivated.
|
|
35
|
+
*
|
|
36
|
+
* A message becomes visible iff every block currently covering it belongs to the
|
|
37
|
+
* deactivation set AND (one-tier only) it is not re-covered by a consumed block
|
|
38
|
+
* that syncCompressionBlocks will reactivate. One-tier decompression leaves
|
|
39
|
+
* non-user-deactivated consumed blocks alive, so their covered messages stay
|
|
40
|
+
* hidden and are not required sources; full decompression deep-deactivates them,
|
|
41
|
+
* so everything under the targets must be present in history.
|
|
42
|
+
*
|
|
43
|
+
* The result is conservative by design: over-requiring an ID can only cause a
|
|
44
|
+
* safe-direction abort, never a false "restored" claim.
|
|
45
|
+
*/
|
|
46
|
+
export declare function collectRequiredDecompressMessageIds(messagesState: PruneMessagesState, targets: CompressionTarget[], options?: {
|
|
47
|
+
full?: boolean;
|
|
48
|
+
}): string[];
|
|
49
|
+
/**
|
|
50
|
+
* [Issue #446] Verify that every source message a decompression would restore is
|
|
51
|
+
* actually present in the fetched host history. Membership transitions alone prove
|
|
52
|
+
* nothing about content: if the host removed the originals (native compaction,
|
|
53
|
+
* external deletion), deactivating the target still reports "Restored N" while
|
|
54
|
+
* nothing returns to context, stats are decremented by phantom tokens, and the
|
|
55
|
+
* terminal user-deactivation discards the summary coverage.
|
|
56
|
+
*/
|
|
57
|
+
export declare function checkDecompressSourceAvailability(messagesState: PruneMessagesState, targets: CompressionTarget[], options: {
|
|
58
|
+
full?: boolean;
|
|
59
|
+
}, presentInHistory: Set<string>): DecompressAvailabilityResult;
|
|
60
|
+
export declare function computeReactivatedBlockIds(messagesState: PruneMessagesState, activeBlockIdsBefore: Set<number>): number[];
|
|
61
|
+
export declare function buildRestoredContentPreview(messages: WithParts[], activeMessagesBefore: Map<string, number>, messagesState: PruneMessagesState): string;
|
|
62
|
+
//# sourceMappingURL=decompress-logic.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"decompress-logic.d.ts","sourceRoot":"","sources":["../../src/compress/decompress-logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAG/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAExE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa1D;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAA;AAE9C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAYjC;AAED,wBAAgB,mCAAmC,CAC/C,aAAa,EAAE,kBAAkB,EACjC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,gBAAgB,EAAE,CAoBpB;AAED,wBAAgB,uBAAuB,CACnC,aAAa,EAAE,kBAAkB,EACjC,KAAK,EAAE,gBAAgB,GACxB,MAAM,GAAG,IAAI,CA4Bf;AAED,wBAAgB,yBAAyB,CACrC,aAAa,EAAE,kBAAkB,EACjC,MAAM,EAAE,iBAAiB,GAC1B,MAAM,GAAG,IAAI,CASf;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ7F;AAED,wBAAgB,2BAA2B,CACvC,aAAa,EAAE,kBAAkB,EACjC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,IAAI,CA8BN;AAED,MAAM,WAAW,sBAAsB;IACnC,oBAAoB,EAAE,MAAM,CAAA;IAC5B,cAAc,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,uBAAuB,CACnC,aAAa,EAAE,kBAAkB,EACjC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1C,sBAAsB,CAYxB;AAED,MAAM,WAAW,4BAA4B;IACzC,uFAAuF;IACvF,kBAAkB,EAAE,MAAM,EAAE,CAAA;IAC5B,wEAAwE;IACxE,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B;kFAC8E;IAC9E,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mCAAmC,CAC/C,aAAa,EAAE,kBAAkB,EACjC,OAAO,EAAE,iBAAiB,EAAE,EAC5B,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,MAAM,EAAE,CAkEV;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC7C,aAAa,EAAE,kBAAkB,EACjC,OAAO,EAAE,iBAAiB,EAAE,EAC5B,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,4BAA4B,CAY9B;AAED,wBAAgB,0BAA0B,CACtC,aAAa,EAAE,kBAAkB,EACjC,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,GAClC,MAAM,EAAE,CAIV;AAKD,wBAAgB,2BAA2B,CACvC,QAAQ,EAAE,SAAS,EAAE,EACrB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,aAAa,EAAE,kBAAkB,GAClC,MAAM,CAoCR"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"decompress.d.ts","sourceRoot":"","sources":["../../src/compress/decompress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,IAAI,IAAI,UAAU,EAErB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAoB,KAAK,kBAAkB,EAAsB,MAAM,SAAS,CAAA;AAmSvF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,kBAAkB,GAAG,UAAU,CA0M/E"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { SessionState, WithParts } from "../state";
|
|
2
|
+
/**
|
|
3
|
+
* Hide compress tool calls whose blocks have all been consumed by a higher-tier
|
|
4
|
+
* distillation, and for batched calls where only some sibling blocks are
|
|
5
|
+
* consumed, rewrite the surviving tool part to carry only the still-live
|
|
6
|
+
* entries' summaries.
|
|
7
|
+
*
|
|
8
|
+
* Decided per-block, not per-callID: a single batched `compress` call (multiple
|
|
9
|
+
* `content[]` entries) creates multiple blocks sharing one `compressCallId`.
|
|
10
|
+
* Keying on the callId (1:N) lets one live sibling rescue consumed batch-mates,
|
|
11
|
+
* permanently leaking their summary text — unreclaimable because `compress` is
|
|
12
|
+
* in the default protected-tools list. See upstream issue #288.
|
|
13
|
+
*/
|
|
14
|
+
export declare function hideConsumedCompressCalls(state: SessionState, messages: WithParts[]): number;
|
|
15
|
+
//# sourceMappingURL=hide-consumed.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hide-consumed.d.ts","sourceRoot":"","sources":["../../src/compress/hide-consumed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAgDzE;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CA8F5F"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hide-failed.d.ts","sourceRoot":"","sources":["../../src/compress/hide-failed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAUzC,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CA+CrE"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type { CompressImagesConfig } from "../config";
|
|
2
|
+
import type { Logger } from "../logger";
|
|
3
|
+
import type { SessionState, WithParts } from "../state/types";
|
|
4
|
+
import type { SelectionResolution } from "./types";
|
|
5
|
+
/**
|
|
6
|
+
* [Issue #478] Parse an inline data-URL image attachment. Returns undefined for
|
|
7
|
+
* non-data URLs (file paths, http(s) links) which v1 does not archive.
|
|
8
|
+
*/
|
|
9
|
+
export declare function parseImageDataUrl(url: string): {
|
|
10
|
+
mediaType: string;
|
|
11
|
+
base64: string;
|
|
12
|
+
} | undefined;
|
|
13
|
+
export declare function extForMediaType(mediaType: string): string | undefined;
|
|
14
|
+
/**
|
|
15
|
+
* [Issue #478] Map a session ID to a safe archive directory name. The salt
|
|
16
|
+
* (sha8 of the raw ID) is appended whenever sanitization changed the string,
|
|
17
|
+
* so two distinct session IDs can never collide on one directory even after
|
|
18
|
+
* aggressive character replacement.
|
|
19
|
+
*/
|
|
20
|
+
export declare function archiveDirName(sessionId: string): string;
|
|
21
|
+
/**
|
|
22
|
+
* [Issue #478] Spill inline image attachments of known messages to disk so that
|
|
23
|
+
* later compression folds keep a re-readable file pointer instead of silently
|
|
24
|
+
* losing the pixels. Metadata-only index in `state.imageArchive` (keyed by RAW
|
|
25
|
+
* message ID — stable across compaction ref re-issue); pixels never enter state.
|
|
26
|
+
* Never throws: any I/O failure downgrades to a warn log and skips the entry.
|
|
27
|
+
* Returns the number of newly archived images.
|
|
28
|
+
*/
|
|
29
|
+
export declare function archiveSessionImages(state: SessionState, messages: WithParts[], images: CompressImagesConfig, logger: Logger): number;
|
|
30
|
+
/**
|
|
31
|
+
* [Issue #478] Best-effort TTL sweep of the session's archived image files,
|
|
32
|
+
* run at most once per process per session (transient `imagePruneDone` flag).
|
|
33
|
+
* Files older than `ttlDays` are deleted along with their index entries; the
|
|
34
|
+
* now-empty directory is removed too. Never throws.
|
|
35
|
+
*/
|
|
36
|
+
export declare function pruneImageArchive(state: SessionState, images: CompressImagesConfig, logger: Logger): void;
|
|
37
|
+
/**
|
|
38
|
+
* [Issue #478] Append a pointer appendix to a folded block summary listing every
|
|
39
|
+
* archived image whose source message falls inside the compressed range, so the
|
|
40
|
+
* model can re-read the pixels with its own file tools after folding.
|
|
41
|
+
*/
|
|
42
|
+
export declare function appendArchivedImagePointers(summary: string, selection: SelectionResolution, state: SessionState, enabled: boolean): string;
|
|
43
|
+
//# sourceMappingURL=image-archive.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"image-archive.d.ts","sourceRoot":"","sources":["../../src/compress/image-archive.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEvC,OAAO,KAAK,EAAsB,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAuBlD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GACvC;IACI,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACjB,GACD,SAAS,CAKd;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMxD;AAMD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,SAAS,EAAE,EACrB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,GACf,MAAM,CAgER;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,GACf,IAAI,CA6CN;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,OAAO,GACjB,MAAM,CAkBR"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export type { ToolContext } from "./types";
|
|
2
|
+
export { createCompressRangeTool } from "./range";
|
|
3
|
+
export { createDecompressTool } from "./decompress";
|
|
4
|
+
export { createSearchContextToolV2 } from "./search";
|
|
5
|
+
export { createAcpStatusToolV2 } from "./status";
|
|
6
|
+
export { createAcpContextRecapToolV2 } from "./recap";
|
|
7
|
+
export { hideConsumedCompressCalls } from "./hide-consumed";
|
|
8
|
+
export { hideFailedCompressCalls } from "./hide-failed";
|
|
9
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compress/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { WithParts } from "../state";
|
|
2
|
+
import type { SessionState } from "../state";
|
|
3
|
+
import type { PluginConfig } from "../config";
|
|
4
|
+
export interface KeepMarkerResult {
|
|
5
|
+
summary: string;
|
|
6
|
+
expandedCount: number;
|
|
7
|
+
refCount: number;
|
|
8
|
+
unresolvedRefs: string[];
|
|
9
|
+
}
|
|
10
|
+
export declare function resolveKeepMarkers(summary: string, messages: WithParts[], state: SessionState, config: PluginConfig): KeepMarkerResult;
|
|
11
|
+
//# sourceMappingURL=keep-markers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"keep-markers.d.ts","sourceRoot":"","sources":["../../src/compress/keep-markers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAM7C,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,GACrB,gBAAgB,CAmClB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../src/compress/parts.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,OAAO,CAEvE"}
|