dsh-lcx-codex 0.4.1-pre.1 → 0.4.1

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.
Files changed (4) hide show
  1. package/CHANGELOG.md +25 -4
  2. package/README.md +48 -35
  3. package/README_EN.md +78 -77
  4. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,10 +1,30 @@
1
1
  # Changelog
2
2
 
3
- ## 0.4.1-pre.1 - Candidate QA pending / not published
3
+ ## 0.4.1 - 2026-08-25
4
4
 
5
+ ### Stable promotion
6
+
7
+ - Promote the fully QA-passed `0.4.1-pre.1` runtime to stable `0.4.1` with **zero functional/runtime code changes**.
8
+ - Make Alpha stateful continuation/fail-closed fixes, DSH compatibility-seam isolation, typed protocol hardening, conservative token budgeting, and the installed Settings lifecycle fix part of the default stable line.
9
+ - Publish stable `0.4.1` to npm dist-tag `latest`; the prior `prelatest=0.4.1-pre.1` remains historical prerelease state.
10
+
11
+ ### Validation basis
12
+
13
+ - `0.4.1-pre.1` passed Installed Candidate + Cross-feature QA before publication.
14
+ - Public promotion preserved runtime/source parity with the frozen prerelease candidate.
15
+ - Stable promotion requires package/version, typecheck, tests, schema, package/import boundary and zero-runtime-diff checks before publication.
16
+
17
+ ## 0.4.1-pre.1 - 2026-08-25
18
+
19
+ ### Released prerelease
20
+
21
+ - Published as `dsh-lcx-codex@0.4.1-pre.1` on npm dist-tag `prelatest`; stable `latest` remained `0.4.0` at prerelease publication time.
5
22
  - Integrates the accepted Alpha stateful continuation and fail-closed capability work from #20, #21, and #22.
6
23
  - Includes accepted compatibility seam isolation (#24), typed protocol-core hardening (#25), unified conservative token budgeting (#26), and the installed-plugin settings lifecycle fix (#36).
7
- - This is an unpublished candidate for #19 installed-candidate and cross-feature QA; no npm publication, tag, or release is implied.
24
+ - Passed installed-candidate and cross-feature QA before publication, including ordinary/Advanced Hosted Search, Native compaction/replay, restart/resume, model continuation, fork isolation, and fail-closed Alpha behavior where unsupported.
25
+ - Public promotion preserved source/runtime parity with the frozen private candidate; package, schema, typecheck, import, install-chain, and publication gates passed.
26
+ - Post-release registry installation and Loader/client/settings-chain verification passed. The final provider-gated ordinary `web_search` recheck was not covered because the temporary authorized upstream credential returned HTTP 401; this was recorded as an external-auth verification gap rather than a package/source/runtime defect.
27
+ - Superseded as the recommended release by stable `0.4.1` after zero-functional-change promotion.
8
28
 
9
29
  ## 0.4.0 - 2026-08-23
10
30
 
@@ -82,6 +102,7 @@
82
102
  - Restore the Alpha capability/ref-store interfaces consumed by `lib/index.js`; the rc.8 release package could pass its unit tests but fail immediately at module import with missing `AlphaCapabilityStore` / `AlphaRefStore` exports.
83
103
  - Add package-entry import regression coverage so CI fails when the server entry point and internal module exports drift out of sync.
84
104
  - Restore Native-first pressure coordination for isolated agent presets using DSH 0.1.1-rc.2's public `agentPresets.serviceFor(agent, name)` resolver. Preset-local `compaction` / `toolResultPruner` services are not visible through ordinary host or `agent.ctx` lookup; the plugin now addresses the actual per-Agent instances before applying the 90% Native / 95% emergency policy. A root service-lifecycle hook remains for non-preset deployments.
105
+
85
106
  ## 0.4.0-rc.8
86
107
 
87
108
  - Rebase the plugin on DSH `0.1.1-rc.2`; older DSH releases are no longer a supported runtime target.
@@ -94,7 +115,7 @@
94
115
 
95
116
  ### Fixed
96
117
 
97
- - Ordinary DSH `web_search` now follows the active Agent `provider/model` instead of always using the plugin fallback GPT model. A Luna conversation now searches with Luna; a Sol conversation searches with Sol.
118
+ - Ordinary DSH `web_search` now follows the active Agent `provider/model` instead of always using the plugin fallback GPT model. A Luna conversation now searches with Luna; a Sol conversation now searches with Sol.
98
119
  - Added an AsyncLocalStorage route bridge at the DSH `tools/execute` boundary so the provider-only `ctx.web.search()` seam can receive Agent route context without changing the model-visible `web_search` schema.
99
120
  - Hosted Search now uses a separate stable `dsh-lcx-search:<route hash>` `prompt_cache_key`, avoiding intentional cache-key sharing with Native conversation replay.
100
121
  - The settings UI now labels the configured Responses endpoint/model as **fallback** values, matching their actual rc.7 role.
@@ -123,7 +144,7 @@
123
144
 
124
145
  - Adds a bounded conversation-fidelity layer after real DSH testing showed assistant-only facts could be lost by opaque Native V2 compaction.
125
146
  - New `lcx-native-compaction-v5` checkpoints retain selected user/developer/system messages plus user-visible assistant final answers before the opaque compaction item.
126
- - Keeps explicit retained history within an estimated 64k-token ceiling; defaults reserve at most 24k for assistant answers and cap one retained answer at about 3k tokens.
147
+ - Keeps explicit retained history within an estimated 64k-token ceiling; defaults reserve at most 24k for assistant answers and cap one retained assistant answer at about 3k tokens.
127
148
  - Does not copy reasoning, tool calls/results, raw search payloads, or telemetry into the fidelity prefix.
128
149
  - Repairs rc.3/rc.4 v4 checkpoints from append-only `shadowedSeqs`, including assistant-visible answers when the original DSH events still exist.
129
150
  - Stores only the single opaque compaction output item, ignoring unrelated terminal output items from nonstandard proxies.
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  <img src="assets/dsh-lcx-codex-banner.png" alt="dsh-lcx-codex — 为 DSH 增加 GPT Hosted Search、Codex 风格网页操作与 Native V2 Compaction" width="100%" />
4
4
 
5
- [![npm](https://img.shields.io/npm/v/dsh-lcx-codex?color=1677ff&label=npm)](https://www.npmjs.com/package/dsh-lcx-codex)
5
+ [![npm](https://img.shields.io/npm/v/dsh-lcx-codex?color=1677ff&label=npm%20latest)](https://www.npmjs.com/package/dsh-lcx-codex)
6
6
  [![CI](https://github.com/kk3ya03-star/dsh-lcx-codex/actions/workflows/publish.yml/badge.svg)](https://github.com/kk3ya03-star/dsh-lcx-codex/actions/workflows/publish.yml)
7
7
  ![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2-4ea8ff)
8
8
  ![Node](https://img.shields.io/badge/Node-%3E%3D20-2f855a)
@@ -14,9 +14,20 @@
14
14
 
15
15
  > **DSH 仍然是 host。LCX 只补齐 GPT Responses 路径缺失的原生能力，不修改 DSH 核心，也不替换 Agent / Session / Web / Compaction。**
16
16
 
17
+ ## 当前稳定版
18
+
19
+ `0.4.1` 是当前稳定版，也是此前完成完整 Installed Candidate / Cross-feature QA 的 `0.4.1-pre.1` 的 **zero-functional-change stable promotion**。
20
+
21
+ ```powershell
22
+ dsh plugin --profile web add dsh-lcx-codex
23
+ dsh web
24
+ ```
25
+
26
+ npm `latest` 指向 `0.4.1`。历史 `prelatest=0.4.1-pre.1` 与稳定版使用相同的已验收 runtime 基线；新用户直接使用 `latest` 即可。
27
+
17
28
  ## 它解决什么
18
29
 
19
- 如果你的 DSH 已经有一个可工作的 GPT `openai-responses` route，`dsh-lcx-codex` 让这条 route 更完整地使用 GPT Responses 原生能力，同时尽量保持 DSH 原有入口和生命周期不变。
30
+ 如果你的 DSH 已经有一个可工作的 GPT `openai-responses` route，`dsh-lcx-codex` 会在保持 DSH 原有入口和生命周期的前提下补齐 Responses 能力。
20
31
 
21
32
  | 场景 | DSH 原有入口 | LCX 增强后 |
22
33
  |---|---|---|
@@ -31,11 +42,11 @@
31
42
 
32
43
  ### 1. GPT Hosted Search：普通搜索不换入口
33
44
 
34
- 启用后，模型看到的普通搜索工具依然是 DSH 原生 `web_search`。LCX 替换的是 SearchProvider 路径，而不是再注册一个重复的“普通搜索”工具。
45
+ 启用后，模型看到的普通搜索工具依然是 DSH 原生 `web_search`。LCX 替换的是 SearchProvider 路径，而不是再注册一个重复的普通搜索工具。
35
46
 
36
47
  需要更细控制时，再单独启用 `websearch_gpt_advanced`。
37
48
 
38
- ### 2. Codex 风格 Web Actions：需要时再打开
49
+ ### 2. Codex 风格 Web Actions
39
50
 
40
51
  `websearch_alpha` 面向连续浏览和结构化 Web action：
41
52
 
@@ -45,7 +56,9 @@ search → open → find / click → screenshot
45
56
 
46
57
  它默认关闭，并且只有当前 endpoint / provider / model / schema 通过 capability probe 后才注册。未知部署采用 **fail-closed**，不会被误报成“支持 Alpha”。
47
58
 
48
- ### 3. Native V2 Compaction：保留 DSH 会话语义
59
+ `0.4.1` 已包含此前 prerelease 验收通过的 URL/stateful continuation 和 capability fail-closed 修复。
60
+
61
+ ### 3. Native V2 Compaction
49
62
 
50
63
  LCX 不创建第二套 compaction engine。DSH 仍然拥有 pressure、compactable range、`/compact`、durable session transaction、tool-result pruning 与 overflow recovery；LCX 只在已有 compaction LLM seam 上请求 Responses Native V2。
51
64
 
@@ -62,7 +75,20 @@ LCX 不创建第二套 compaction engine。DSH 仍然拥有 pressure、compactab
62
75
  - provider-confirmed context overflow：继续使用 DSH 原有恢复逻辑。
63
76
  - 手动 `/compact`：继续使用 DSH 原生会话事务。
64
77
 
65
- 同一 source session 可以继续复用自己的 Native checkpoint；fork 或模型迁移不会跨 session 发送 parent 的 opaque state，而是走 portable migration；重启后从 DSH session log 恢复。
78
+ 同一 source session 可以继续复用自己的 Native checkpoint；fork 或模型/route migration 不会跨 session 发送 parent opaque state，而是走 portable migration；重启后从 DSH session log 恢复。
79
+
80
+ ## 0.4.1 相比 0.4.0
81
+
82
+ `0.4.1` 将此前 `0.4.1-pre.1` 的已验收改动正式提升到 stable：
83
+
84
+ - Alpha URL/stateful continuation 与 capability fail-closed 修复；
85
+ - DSH compatibility seam 收敛；
86
+ - route / Native V2 / checkpoint typed protocol core；
87
+ - Native retention 与 portable migration 的统一保守 token budgeting；
88
+ - 正式安装态 settings namespace / configuration card lifecycle 修复；
89
+ - Installed Candidate + Cross-feature QA。
90
+
91
+ 该 stable promotion 不引入新的 runtime 行为。
66
92
 
67
93
  ## 30 秒开始使用
68
94
 
@@ -73,6 +99,14 @@ dsh plugin --profile web add dsh-lcx-codex
73
99
  dsh web
74
100
  ```
75
101
 
102
+ 需要固定版本时：
103
+
104
+ ```powershell
105
+ dsh plugin --profile web add dsh-lcx-codex@0.4.1
106
+ ```
107
+
108
+ 升级时请使用 DSH 官方 plugin remove/add 路径；不要为了“清理”删除用户 session 或 `$DSH_HOME/storages/lcx-codex/`。
109
+
76
110
  ### 2. 在 DSH Settings 启用
77
111
 
78
112
  第一次使用建议从最小配置开始：
@@ -94,19 +128,15 @@ dsh web
94
128
 
95
129
  ### 3. 确认它真的生效
96
130
 
97
- 不要只看开关是否打开，按能力检查实际行为：
98
-
99
131
  | 能力 | 应看到什么 |
100
132
  |---|---|
101
133
  | GPT Hosted Search | 普通工具入口仍是 DSH `web_search`，实际请求走当前 GPT Responses route |
102
- | Advanced Hosted | 启用后出现 `websearch_gpt_advanced`，高级参数可以单独控制 |
134
+ | Advanced Hosted | 启用后出现 `websearch_gpt_advanced` |
103
135
  | Alpha Web Actions | 只有 capability probe 通过时才出现 `websearch_alpha` |
104
136
  | Native V2 | compact 时出现 provider-native checkpoint 路径；普通 Basic Compaction 不会被伪装成 Native V2 成功 |
105
137
 
106
138
  ## 搜索工具怎么选
107
139
 
108
- 三个入口用途不同，**不需要全部开启**：
109
-
110
140
  | 你要做什么 | 使用入口 | 适合场景 |
111
141
  |---|---|---|
112
142
  | 普通联网搜索 | DSH `web_search` | 找资料、查网页、一般检索 |
@@ -128,13 +158,13 @@ checkpoint、canonical replay、Pi serializer、cache identity、fork safety 与
128
158
 
129
159
  ## 兼容性
130
160
 
131
- 当前正式验证组合：
161
+ 当前正式稳定组合：
132
162
 
133
163
  | Plugin | DSH | DSH host Pi | Plugin Pi | 状态 |
134
164
  |---|---|---|---|---|
135
- | `0.4.0` | `0.1.1-rc.2` | `0.82.1` | `0.82.1` | **VERIFIED** |
165
+ | `0.4.1` | `0.1.1-rc.2` | `0.82.1` | `0.82.1` | **VERIFIED STABLE** |
136
166
 
137
- 新的 DSH 版本**不会自动视为兼容**。项目会先检查受影响的 DSH / Pi seam，再按风险运行对应测试；Pi registry 单独出现新版本也不会自动升级插件依赖。
167
+ `0.4.1` 的 runtime 来自完整 QA 通过的 `0.4.1-pre.1`，stable promotion 本身保持 zero-functional-change。新的 DSH 版本**不会自动视为兼容**；项目会先检查受影响 seam，再按风险运行对应测试。
138
168
 
139
169
  <details>
140
170
  <summary><strong>完整推荐设置</strong></summary>
@@ -155,27 +185,6 @@ checkpoint、canonical replay、Pi serializer、cache identity、fork safety 与
155
185
 
156
186
  </details>
157
187
 
158
- <details>
159
- <summary><strong>其他安装方式</strong></summary>
160
-
161
- **预发布版**
162
-
163
- ```powershell
164
- dsh plugin --profile web add dsh-lcx-codex@next
165
- ```
166
-
167
- **本地 tarball**
168
-
169
- ```powershell
170
- dsh plugin --profile web remove dsh-lcx-codex
171
- dsh plugin --profile web add .\dsh-lcx-codex-0.4.0.tgz
172
- dsh web
173
- ```
174
-
175
- 升级插件时，不要为了“清理”删除 DSH session 或 `$DSH_HOME/storages/lcx-codex/`。旧会话可能仍引用历史兼容数据。
176
-
177
- </details>
178
-
179
188
  <details>
180
189
  <summary><strong>常见情况</strong></summary>
181
190
 
@@ -188,12 +197,16 @@ dsh web
188
197
  **Native V2 没有生效**
189
198
  确认当前 GPT Responses endpoint 实际支持 `remote_compaction_v2`。插件不会把普通 Basic Compaction 假装成 Native V2 成功。
190
199
 
200
+ **安装成功但配置卡不可见**
201
+ 确认安装的是 `0.4.1` 或更高版本，并重启/刷新 DSH Web；`0.4.1` 已包含正式安装态 settings lifecycle 修复。
202
+
191
203
  </details>
192
204
 
193
205
  <details>
194
206
  <summary><strong>开发</strong></summary>
195
207
 
196
208
  ```bash
209
+ npm run typecheck
197
210
  npm test
198
211
  npm run test:schema
199
212
  npm pack --ignore-scripts
package/README_EN.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  <img src="assets/dsh-lcx-codex-banner-en.png" alt="dsh-lcx-codex — GPT Hosted Search, Codex-style Web Actions, and Native V2 Compaction for DSH" width="100%" />
4
4
 
5
- [![npm](https://img.shields.io/npm/v/dsh-lcx-codex?color=1677ff&label=npm)](https://www.npmjs.com/package/dsh-lcx-codex)
5
+ [![npm](https://img.shields.io/npm/v/dsh-lcx-codex?color=1677ff&label=npm%20latest)](https://www.npmjs.com/package/dsh-lcx-codex)
6
6
  [![CI](https://github.com/kk3ya03-star/dsh-lcx-codex/actions/workflows/publish.yml/badge.svg)](https://github.com/kk3ya03-star/dsh-lcx-codex/actions/workflows/publish.yml)
7
7
  ![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2-4ea8ff)
8
8
  ![Node](https://img.shields.io/badge/Node-%3E%3D20-2f855a)
@@ -12,44 +12,53 @@
12
12
 
13
13
  </div>
14
14
 
15
- > **DSH remains the host. LCX fills missing native capabilities on GPT Responses routes without modifying DSH core or replacing Agent / Session / Web / Compaction.**
15
+ > **DSH remains the host. LCX adds missing native capabilities to GPT Responses routes without modifying DSH core or replacing Agent / Session / Web / Compaction.**
16
+
17
+ ## Current stable release
18
+
19
+ `0.4.1` is the current stable release. It is a **zero-functional-change stable promotion** of `0.4.1-pre.1`, which already passed full Installed Candidate and Cross-feature QA.
20
+
21
+ ```powershell
22
+ dsh plugin --profile web add dsh-lcx-codex
23
+ dsh web
24
+ ```
25
+
26
+ npm `latest` points to `0.4.1`. Historical `prelatest=0.4.1-pre.1` uses the same accepted runtime baseline; new users should install `latest`.
16
27
 
17
28
  ## What it solves
18
29
 
19
- If DSH already has a working GPT `openai-responses` route, `dsh-lcx-codex` lets that route use more of the native GPT Responses capability set while keeping DSH's existing entries and lifecycle ownership intact.
30
+ If DSH already has a working GPT `openai-responses` route, `dsh-lcx-codex` fills Responses capability gaps while preserving DSH entry points and lifecycle ownership.
20
31
 
21
32
  | Scenario | Existing DSH surface | With LCX |
22
33
  |---|---|---|
23
- | Ordinary web search | DSH `web_search` | **Keep the same `web_search` entry** while LCX maps its SearchProvider to the active GPT Hosted Search route |
24
- | Advanced Hosted Search controls | Keep ordinary search simple | Optionally add `websearch_gpt_advanced` for domain filters, approximate location, search context, image search, and related controls |
25
- | Stateful page / PDF browsing | DSH keeps Web lifecycle ownership | Optionally add Codex / Alpha Web Actions: `search → open → find/click → screenshot` |
34
+ | Ordinary web search | DSH `web_search` | Keep the same `web_search`; LCX maps its SearchProvider to GPT Hosted Search |
35
+ | Advanced Hosted controls | Ordinary search stays simple | Optional `websearch_gpt_advanced` for domain filters, approximate location, search context, image search, and related controls |
36
+ | Stateful page / PDF browsing | DSH keeps Web lifecycle ownership | Optional Codex / Alpha actions: `search → open → find/click → screenshot` |
26
37
  | Long-session compaction | DSH keeps pressure, transactions, and recovery | Prefer Responses Native V2 checkpoints at the existing compaction seam |
27
38
 
28
39
  **The goal is not to build another Agent stack. It is to let a DSH GPT route use the native capabilities it should already have access to.**
29
40
 
30
- ## Three core capabilities
31
-
32
- ### 1. GPT Hosted Search: keep the ordinary search entry
41
+ ## Core capabilities
33
42
 
34
- When enabled, the model still sees the native DSH `web_search` tool for ordinary search. LCX changes the SearchProvider path instead of registering a second duplicate search tool.
43
+ ### GPT Hosted Search
35
44
 
36
- Enable `websearch_gpt_advanced` only when you need finer Hosted Search controls.
45
+ The model still sees DSH's ordinary `web_search`; LCX changes the SearchProvider path instead of registering a duplicate ordinary-search tool. Enable `websearch_gpt_advanced` only when you need additional Hosted Search controls.
37
46
 
38
- ### 2. Codex-style Web Actions: opt in when needed
47
+ ### Codex-style Web Actions
39
48
 
40
- `websearch_alpha` is for stateful browsing and structured Web actions:
49
+ `websearch_alpha` supports stateful browsing:
41
50
 
42
51
  ```text
43
52
  search → open → find / click → screenshot
44
53
  ```
45
54
 
46
- It is off by default and is registered only after the exact endpoint / provider / model / schema passes a capability probe. Unknown deployments are **fail-closed** rather than mislabeled as Alpha-capable.
55
+ It is off by default and registered only when the current endpoint / provider / model / schema passes capability checks. Unknown deployments fail closed.
47
56
 
48
- ### 3. Native V2 Compaction: preserve DSH session semantics
57
+ `0.4.1` includes the URL/stateful-continuation and capability fail-closed fixes that were accepted on the prerelease line.
49
58
 
50
- LCX does not create a second compaction engine. DSH still owns pressure, compactable ranges, `/compact`, durable session transactions, tool-result pruning, and overflow recovery. LCX only requests Responses Native V2 at the existing compaction LLM seam.
59
+ ### Native V2 Compaction
51
60
 
52
- Default automatic policy:
61
+ LCX does not create a second compaction engine. DSH still owns pressure, compactable ranges, `/compact`, durable session transactions, pruning, and overflow recovery. LCX requests Responses Native V2 through the existing compaction seam.
53
62
 
54
63
  ```text
55
64
  0% ─────────────────── 90% ───── 95% ───── 100%
@@ -59,55 +68,66 @@ Default automatic policy:
59
68
 
60
69
  - **90%**: prefer Native V2.
61
70
  - **95%**: allow emergency DSH pruning.
62
- - provider-confirmed context overflow: keep DSH's original recovery path.
63
- - manual `/compact`: keep the native DSH session transaction.
71
+ - provider-confirmed context overflow: keep DSH's original recovery.
72
+ - manual `/compact`: keep the native DSH transaction.
64
73
 
65
- The exact source session can reuse its own Native checkpoint. Forks or model migrations never send a parent's opaque state across sessions and use portable migration instead. Restart/resume rebuilds from the DSH session log.
74
+ Native opaque state stays source-session bound. Forks and model/route migrations use portable migration rather than sending a parent's opaque state across sessions; restart/resume rebuilds from the DSH session log.
66
75
 
67
- ## Get started in 30 seconds
76
+ ## What changed from 0.4.0
68
77
 
69
- ### 1. Install
78
+ `0.4.1` promotes the already accepted `0.4.1-pre.1` changes to stable:
79
+
80
+ - Alpha URL/stateful continuation and fail-closed capability fixes;
81
+ - DSH compatibility-seam isolation;
82
+ - typed protocol core for route / Native V2 / checkpoint handling;
83
+ - unified conservative token budgeting for Native retention and portable migration;
84
+ - installed settings namespace / configuration-card lifecycle fix;
85
+ - Installed Candidate + Cross-feature QA.
86
+
87
+ The stable promotion itself adds no new runtime behavior.
88
+
89
+ ## Get started
90
+
91
+ ### Install stable
70
92
 
71
93
  ```powershell
72
94
  dsh plugin --profile web add dsh-lcx-codex
73
95
  dsh web
74
96
  ```
75
97
 
76
- ### 2. Enable it in DSH Settings
98
+ Pin the exact version if needed:
77
99
 
78
- For a first run, start with the smallest useful configuration:
100
+ ```powershell
101
+ dsh plugin --profile web add dsh-lcx-codex@0.4.1
102
+ ```
79
103
 
80
- | Setting | Suggested first-run value |
81
- |---|---:|
82
- | Enable plugin | **On** |
83
- | Use GPT Hosted Search | **On** when you want GPT Hosted Search |
84
- | Advanced Hosted Search | **Off** until you need advanced controls |
85
- | Alpha Search | **Off** until the current route is confirmed compatible |
86
- | Native V2 remote compaction | **On** only when the upstream actually supports Native V2 |
87
- | Native-first auto compaction | **On** when using Native V2 |
104
+ Use the official DSH plugin remove/add path when upgrading. Do not delete user sessions or `$DSH_HOME/storages/lcx-codex/` just to change versions.
88
105
 
89
- **Requirements**
106
+ ### Suggested first-run settings
90
107
 
91
- - Node.js `>=20`
92
- - a working GPT `openai-responses` route in DSH
93
- - actual upstream support for the Hosted Search / Native V2 / Alpha capabilities you plan to enable
108
+ | Setting | Suggested value |
109
+ |---|---:|
110
+ | Enable plugin | **On** |
111
+ | Use GPT Hosted Search | On when needed |
112
+ | Advanced Hosted Search | Off until needed |
113
+ | Alpha Search | Off until route capability is confirmed |
114
+ | Native V2 remote compaction | On only when upstream supports it |
115
+ | Native-first auto compaction | On when using Native V2 |
94
116
 
95
- ### 3. Verify that it is actually active
117
+ Requirements: Node.js `>=20`, a working GPT `openai-responses` route in DSH, and actual upstream support for the capabilities you enable.
96
118
 
97
- Do not stop at checking toggles. Verify observable behavior for each capability:
119
+ ## Verify observable behavior
98
120
 
99
- | Capability | What you should observe |
121
+ | Capability | Expected behavior |
100
122
  |---|---|
101
- | GPT Hosted Search | The ordinary tool entry remains DSH `web_search`, while the actual request follows the active GPT Responses route |
102
- | Advanced Hosted | `websearch_gpt_advanced` appears after enablement and exposes the advanced controls separately |
103
- | Alpha Web Actions | `websearch_alpha` appears only after the capability probe succeeds |
104
- | Native V2 | Compaction follows the provider-native checkpoint path; ordinary Basic Compaction is never presented as a successful Native V2 run |
123
+ | GPT Hosted Search | Ordinary entry remains DSH `web_search`; the request follows the active GPT Responses route |
124
+ | Advanced Hosted | `websearch_gpt_advanced` appears only when enabled |
125
+ | Alpha Web Actions | `websearch_alpha` appears only after capability validation |
126
+ | Native V2 | Compaction follows the provider-native checkpoint path; Basic Compaction is not mislabeled as Native V2 |
105
127
 
106
128
  ## Which search tool should I use?
107
129
 
108
- The three entries serve different jobs. **You do not need to enable all of them.**
109
-
110
- | What you want to do | Entry | Best for |
130
+ | Goal | Entry | Best for |
111
131
  |---|---|---|
112
132
  | Ordinary web lookup | DSH `web_search` | General search, research, and retrieval |
113
133
  | Control Hosted Search parameters | `websearch_gpt_advanced` | Domain allow/block, approximate location, search context, image search, and related controls |
@@ -122,22 +142,22 @@ DSH Agent / Session / Web
122
142
  └─ compact / replay ────> LCX Native bridge ───> Responses Native V2
123
143
  ```
124
144
 
125
- **DSH is the host; LCX is a compatibility extension.** The plugin prefers the active DSH route's `baseURL`, credential reference, headers, model, and retry policy instead of maintaining a second account configuration.
145
+ **DSH is the host; LCX is a compatibility extension.** It reuses the active DSH route's `baseURL`, configured authentication reference, headers, model, and retry policy rather than maintaining a second account configuration.
126
146
 
127
- For checkpoint internals, canonical replay, Pi serialization, cache identity, fork safety, and pressure coordination, see [ARCHITECTURE.md](ARCHITECTURE.md).
147
+ See [ARCHITECTURE.md](ARCHITECTURE.md) for checkpoint, replay, Pi serialization, cache identity, fork safety, and pressure-coordination details.
128
148
 
129
149
  ## Compatibility
130
150
 
131
- Current formally verified stack:
151
+ Current formally stable stack:
132
152
 
133
153
  | Plugin | DSH | DSH host Pi | Plugin Pi | Status |
134
154
  |---|---|---|---|---|
135
- | `0.4.0` | `0.1.1-rc.2` | `0.82.1` | `0.82.1` | **VERIFIED** |
155
+ | `0.4.1` | `0.1.1-rc.2` | `0.82.1` | `0.82.1` | **VERIFIED STABLE** |
136
156
 
137
- A new DSH release is **not** assumed compatible. The project first reviews the DSH / Pi seams that changed and then runs risk-appropriate tests. A newer Pi registry version alone does not automatically upgrade the plugin dependency.
157
+ `0.4.1` uses the fully QA-passed `0.4.1-pre.1` runtime, and the stable promotion is zero-functional-change. New DSH releases are **not** assumed compatible without seam review and risk-appropriate testing.
138
158
 
139
159
  <details>
140
- <summary><strong>Full recommended settings</strong></summary>
160
+ <summary><strong>Recommended settings</strong></summary>
141
161
 
142
162
  | Setting | Recommended | Notes |
143
163
  |---|---:|---|
@@ -151,29 +171,6 @@ A new DSH release is **not** assumed compatible. The project first reviews the D
151
171
  | Emergency DSH prune | 95% | Allow emergency prune from 95% |
152
172
  | `web_search` timeout | 240 s | Avoid false timeout on longer searches |
153
173
 
154
- Key fields: `remoteCompaction`, `autoCompaction`, `fallbackToBasicCompaction`, `autoCompactionThresholdPercent`, `emergencyPruneThresholdPercent`, `webSearchTimeoutSeconds`, `advancedHostedSearch`, `alphaSearch`.
155
-
156
- </details>
157
-
158
- <details>
159
- <summary><strong>Other installation options</strong></summary>
160
-
161
- **Prerelease**
162
-
163
- ```powershell
164
- dsh plugin --profile web add dsh-lcx-codex@next
165
- ```
166
-
167
- **Local tarball**
168
-
169
- ```powershell
170
- dsh plugin --profile web remove dsh-lcx-codex
171
- dsh plugin --profile web add .\dsh-lcx-codex-0.4.0.tgz
172
- dsh web
173
- ```
174
-
175
- Do not delete DSH sessions or `$DSH_HOME/storages/lcx-codex/` just to “clean up” during an upgrade. Older sessions may still reference compatibility data there.
176
-
177
174
  </details>
178
175
 
179
176
  <details>
@@ -188,19 +185,23 @@ That is expected fail-closed behavior. Alpha is registered only after a trusted
188
185
  **Native V2 is not taking effect**
189
186
  Verify that the current GPT Responses endpoint actually supports `remote_compaction_v2`. The plugin does not present ordinary Basic Compaction as a successful Native V2 run.
190
187
 
188
+ **Installed but no configuration card is visible**
189
+ Make sure you are on `0.4.1` or later and restart/refresh DSH Web. `0.4.1` includes the installed settings lifecycle fix.
190
+
191
191
  </details>
192
192
 
193
193
  <details>
194
194
  <summary><strong>Development</strong></summary>
195
195
 
196
196
  ```bash
197
+ npm run typecheck
197
198
  npm test
198
199
  npm run test:schema
199
200
  npm pack --ignore-scripts
200
201
  ```
201
202
 
202
- - Design and protocol details: [ARCHITECTURE.md](ARCHITECTURE.md)
203
- - Release history: [CHANGELOG.md](CHANGELOG.md)
203
+ - Design: [ARCHITECTURE.md](ARCHITECTURE.md)
204
+ - Releases: [CHANGELOG.md](CHANGELOG.md)
204
205
  - npm: [`dsh-lcx-codex`](https://www.npmjs.com/package/dsh-lcx-codex)
205
206
 
206
207
  </details>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-lcx-codex",
3
- "version": "0.4.1-pre.1",
3
+ "version": "0.4.1",
4
4
  "description": "DSH Codex/Responses capabilities for existing openai-responses routes: hosted/alpha search and session-native V2 compaction",
5
5
  "keywords": [
6
6
  "deepseek-harness",