dsh-ptc-plus 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-ptc-plus 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,137 @@
+# dsh-ptc-plus
+
+[![Node.js ^22.19.0 || >=24.0.0](https://img.shields.io/badge/Node.js-%5E22.19.0%20%7C%7C%20%3E%3D24.0.0-5fa04e?logo=nodedotjs&logoColor=white)](package.json)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-PTC%20mode-4b6bfb)](https://github.com/deepseek-ai/deepseek-harness)
+[![Status: community plugin](https://img.shields.io/badge/Status-community%20plugin-lightgrey)](docs/publishing.md)
+
+<p align="center">
+  <img src="assets/dsh-ptc-plus-banner.webp" alt="dsh-ptc-plus banner">
+</p>
+
+**PTC Plus gives DSH PTC mode a session-bound persistent TypeScript REPL.** Every `run_code` continues in the same session. Variables, imports, and results from one `run_code` are still available in the next one.
+
+> [!NOTE]
+> Community plugin, no affiliation with or endorsement from DeepSeek or DSH.
+
+> [!IMPORTANT]
+> Built for `danger-full-access`: direct Node.js and OS access with no extra sandbox. Use it only where that permission scope is acceptable.
+
+![PTC Plus settings card](assets/ptc-plus-settings.png)
+
+*The settings card exposes live configuration and the `enabled` kill switch.*
+
+## What default PTC mode gets wrong
+
+DSH PTC mode starts every `run_code` in a fresh environment. The model computes something, then has to send the same setup code again. One bad line means the whole thing is resent. This plugin attaches `run_code` to a session-backed environment, so later calls reuse what was already there.
+
+| Situation | Default PTC mode | With PTC Plus |
+| --- | --- | --- |
+| State | starts from zero, setup resent ❌ | previous `run_code` results stay ✅ |
+| Fixing | wrong result resends the code ❌ | one diff ✅ |
+| Modules | `import` / `export` cannot be written ❌ | written normally, AST handles it ✅ |
+| Values | JSON changes or loses special values ❌ | those values stay intact ✅ |
+| Restart | everything is lost ❌ | recoverable parts come back ✅ |
+| Output and errors | printing floods, errors point elsewhere ❌ | output trimmed, errors map to your line ✅ |
+| Tools | list invisible, miscalls fail ❌ | can inspect; known miscalls become `run_code` ✅ |
+| Paths | relative paths can drift ❌ | session remembers the project directory ✅ |
+| Agent tools | tools needing the agent are rejected ❌ | context restored, goal works ✅ |
+
+## Three scenes that matter most
+
+### State carries over
+
+First `run_code`:
+
+```ts
+import { readFile } from 'node:fs/promises'
+const manifest = JSON.parse(await readFile('package.json', 'utf8'))
+const deps = Object.keys(manifest.dependencies ?? {})
+return deps.length
+```
+
+The next one keeps going:
+
+```ts
+return deps.map(dep => dep + '@' + manifest.dependencies[dep])
+```
+
+`deps` and `manifest` are still there. The setup code is sent only once.
+
+### Fix without resending
+
+By default, a wrong result or a failure sends the whole code block again.
+
+With PTC Plus, it sends one line:
+
+```ts
+edit_run_code({ edits: [{ old_string: 'deps.length', new_string: 'deps' }] })
+```
+
+Only the diff goes in. The full source stays out of the conversation. Exact replacements and regular expressions both have limits, so a bad pattern cannot hang.
+
+### Module syntax
+
+DSH PTC mode executes each `run_code` as an async function body, where static `import` and `export` declarations are invalid. PTC Plus adapts those forms before execution with AST analysis.
+
+The model writes normally:
+
+```ts
+import { readFile } from 'node:fs/promises'
+```
+
+Imports resolve from your project, and named/default imports stay live and read-only. The model never has to know that a `run_code` is really a function body.
+
+## One measured A/B
+
+One identity-blind paired run used `opencode-go/deepseek-v4-flash`. Both arms used the same versioned fixture, task prompts, permissions, and two replicates per task, so 18 sessions per arm.
+
+| Across all 9 tasks | PTC Plus | DSH PTC mode (PTC Plus disabled) | Observed change |
+| --- | ---: | ---: | ---: |
+| Model requests | 66 | 88 | 25.0% fewer |
+| Tool calls | 50 | 79 | 36.7% fewer |
+| Token traffic | 729,642 | 942,901 | 22.6% fewer |
+| Identity-blind rubric score | 138 / 162 | 118 / 162 | +12.3 percentage points |
+
+The module-syntax task separated the two arms most clearly. PTC Plus finished both replicates with one `run_code` each. DSH PTC mode without PTC Plus finished neither static-import requirement and used eight tool calls across its attempts.
+
+This is one stochastic paired observation, not a performance guarantee. Machine budgets were exceeded in 2 of the 18 PTC Plus sessions and 5 of the 18 sessions without PTC Plus, so the matrix as a whole did not pass machine acceptance. Token traffic includes input, cache-read, cache-write, and output tokens. The fixture, pairing rules, metrics, and blind-review protocol are documented in [Evaluation](docs/evaluation.md).
+
+![Rejected run_code and the follow-up edit_run_code repair](assets/ptc-plus-repair.png)
+
+*A real session: the long code and the truthful `edit_run_code` repair call. The repair never resends the source.*
+
+## Settings
+
+Open **Settings → Plugin configuration** to use the card shown above. The `enabled` switch is live: turning it off leaves only the card and that switch, while turning it on restores the session runtime and `run_code`/`edit_run_code`.
+
+Every setting applies live and keeps existing bindings. A submitted cell uses one configuration for its complete execution; changes made while it runs apply to cells submitted afterward. A failed change rolls back. Node fixes a worker's V8 old-generation limit when the worker starts, so that one setting is rejected while a session worker is active and can be changed after the session is disposed. A failed enable is rolled back and persisted as disabled.
+
+`cordisToolsEnabled` is off by default. Turning it on atomically adds DSH's official Cordis tools, owner guidance, and `cordis-plugin-development` companion Skill to PTC agents; turning it off removes all three. It neither switches presets nor changes the direct `run_code`/`edit_run_code` surface. Cordis runs model-written plugins against the live DSH runtime, so enabling it requires shell-level trust.
+
+When a Cordis call rejects after a cell has assigned a large host or client source string, that top-level binding remains live. Retry only the Cordis call from a short later cell and reuse the binding instead of resending the source.
+
+See [Client UI](docs/client-ui.md), [ADR 0019](docs/adr/0019-plugin-settings-and-kill-switch.md), and [ADR 0020](docs/adr/0020-optional-cordis-tools-in-ptc-mode.md).
+
+## Scope
+
+PTC Plus provides the session-bound persistent `run_code` layer. DSH and the operating system continue to own native-tool authority, policy, approval, cancellation, sandboxing and process governance.
+
+## Install
+
+Requires Node.js `^22.19.0 || >=24.0.0` and DSH with TypeScript PTC mode:
+
+```sh
+dsh plugin --profile <profile> add github:muyuanjin/dsh-ptc-plus#main
+dsh --profile <profile> --dump-config
+```
+
+Other install methods and compatibility details are in the [installation guide](docs/installation.md).
+
+`danger-full-access` is the primary supported experience. The worker isolates lifecycle, not malicious code.
+
+## Documentation
+
+[Installation](docs/installation.md) · [Runtime reference](docs/runtime-reference.md) · [Architecture](docs/architecture.md) · [All docs](docs/README.md)
+
+MIT licensed. See [LICENSE](LICENSE).

package/README.zh.md

@@ -0,0 +1,137 @@
+# dsh-ptc-plus
+
+[![Node.js ^22.19.0 || >=24.0.0](https://img.shields.io/badge/Node.js-%5E22.19.0%20%7C%7C%20%3E%3D24.0.0-5fa04e?logo=nodedotjs&logoColor=white)](package.json)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-PTC%20mode-4b6bfb)](https://github.com/deepseek-ai/deepseek-harness)
+[![Status: community plugin](https://img.shields.io/badge/Status-community%20plugin-lightgrey)](docs/publishing.md)
+
+<p align="center">
+  <img src="assets/dsh-ptc-plus-banner.webp" alt="dsh-ptc-plus 横幅">
+</p>
+
+**PTC Plus 给 DSH 的 PTC 模式一个会话绑定的持久 TypeScript REPL。** 每次 `run_code` 都在同一个会话里继续。上一次 `run_code` 的变量、导入和结果，下一次还能直接用。
+
+> [!NOTE]
+> 社区插件，与 DeepSeek 或 DSH 无隶属、无背书。
+
+> [!IMPORTANT]
+> 面向 `danger-full-access` 设计：可直接访问 Node.js 与操作系统，不另加沙箱。仅在可接受此权限的环境使用。
+
+![PTC Plus 设置卡片](assets/ptc-plus-settings.png)
+
+*设置卡片展示即时配置和 `enabled` 开关。*
+
+## 默认 PTC 模式的问题
+
+DSH 的 PTC 模式让每次 `run_code` 都从新环境开始。模型算过的东西，下一次还要重发。写错一行，整段代码重发。这个插件把 `run_code` 接到一个会话级环境里，后面的调用直接复用之前的东西。
+
+| 场景 | 默认 PTC 模式 | PTC Plus 之后                |
+| --- | --- |----------------------------|
+| 状态 | 每次从零开始，setup 重发 ❌ | 上一次 `run_code` 的结果直接能用 ✅   |
+| 修错 | 结果不对或失败，整段重发 ❌ | 只发一行 diff ✅                |
+| 模块 | `import` / `export` 不能写 ❌ | 照常写，后台 AST 重写 ✅            |
+| 值 | JSON 改掉或丢失特殊值 ❌ | 这些值原样保留 ✅                  |
+| 重启 | 重启后一切丢失 ❌ | 能恢复的会回来 ✅                  |
+| 输出报错 | 大打印刷屏，报错指到别处 ❌ | 输出裁剪，报错回错的行 ✅              |
+| 工具 | 列表看不见，顶层误发失败 ❌ | 可查看；可确定的误发自动转 `run_code` ✅ |
+| 路径 | 相对路径可能跑偏 ❌ | session 记住项目目录 ✅           |
+| agent 工具 | 需要当前 agent 的工具被拒绝 ❌ | 恢复上下文，goal 等可调 ✅           |
+
+## 三个最直接的场景
+
+### 状态跨调用
+
+第一个 `run_code` 算完：
+
+```ts
+import { readFile } from 'node:fs/promises'
+const manifest = JSON.parse(await readFile('package.json', 'utf8'))
+const deps = Object.keys(manifest.dependencies ?? {})
+return deps.length
+```
+
+第二个直接接着用：
+
+```ts
+return deps.map(dep => dep + '@' + manifest.dependencies[dep])
+```
+
+`deps` 和 `manifest` 还在。setup 代码只发一次。
+
+### 修错不重发
+
+默认情况下，结果不对或执行失败，模型只能把整个代码块再发一遍。
+
+PTC Plus 下它只发这一行：
+
+```ts
+edit_run_code({ edits: [{ old_string: 'deps.length', new_string: 'deps' }] })
+```
+
+模型只发改动，完整源码留在对话之外。精确文本替换和正则替换都有限制，坏的正则不会卡住。
+
+### 模块语法
+
+DSH 的 PTC 模式把每个 `run_code` 当作 async function body 执行，静态 `import` 和 `export` 声明在这个函数体里无效。PTC Plus 会在执行前用 AST 分析适配这些形式。
+
+模型照常写：
+
+```ts
+import { readFile } from 'node:fs/promises'
+```
+
+依赖从项目解析，具名和默认导入保持 live 且只读。模型不需要知道 `run_code` 其实是一个函数体。
+
+## 一次配对实测
+
+一次身份盲化的配对实验使用了 `opencode-go/deepseek-v4-flash`。两个 arm 使用同一版本夹具、任务 prompt、权限，每个任务重复两次，每个 arm 共 18 个 session。
+
+| 9 个任务合计 | PTC Plus | DSH PTC 模式（未启用 PTC Plus） | 本次观测变化 |
+| --- | ---: | ---: | ---: |
+| 模型请求 | 66 | 88 | 减少 25.0% |
+| 工具调用 | 50 | 79 | 减少 36.7% |
+| Token 流量 | 729,642 | 942,901 | 减少 22.6% |
+| 身份盲评量表得分 | 138 / 162 | 118 / 162 | 提高 12.3 个百分点 |
+
+模块语法任务的区分最清楚：PTC Plus 两次都只用一次 `run_code` 完成；未启用 PTC Plus 的 DSH PTC 模式两次都未满足静态 import 要求，尝试过程合计用了 8 次工具调用。
+
+这是一次有随机性的配对观测，不是性能保证。预设机器预算在 PTC Plus 的 18 个 session 中有 2 个超限，未启用 PTC Plus 的 18 个 session 中有 5 个超限，因此整组矩阵没有通过 machine acceptance。Token 流量包含 input、cache-read、cache-write 和 output token。夹具、配对规则、指标与盲评流程见[评测说明](docs/evaluation.md)。
+
+![被拒的 run_code 与随后的 edit_run_code 修复调用](assets/ptc-plus-repair.png)
+
+*真实会话：长代码与真实的 `edit_run_code` 修复调用；修复从未重发源码。*
+
+## 设置
+
+打开 **设置 → 插件配置** 使用上面的设置卡片。`enabled` 是即时生效的总开关：关闭后只保留卡片和这个开关，开启后恢复 session runtime 以及 `run_code`/`edit_run_code`。
+
+所有设置都会实时应用，并保留已有 binding。已提交的 cell 在完整执行期间使用同一份配置；执行期间发生的更新用于随后提交的 cell。更新失败会回滚。Node 在 worker 创建时固定 V8 old-generation 上限，因此活动 session worker 存在时修改这一项会被拒绝，释放 session 后才能修改。启用失败时，运行时会回滚并把设置保持为停用。
+
+`cordisToolsEnabled` 默认关闭。打开后，DSH 官方 Cordis 工具、owner guidance 与 `cordis-plugin-development` companion Skill 会作为一个整体加入 PTC agent，关闭时也会一起移除；它不切换 preset，也不改变 `run_code`/`edit_run_code` 的直接调用面。Cordis 能在实时 DSH runtime 中运行模型编写的插件，开启它需要接受 shell 级信任。
+
+如果 Cordis 调用在 cell 已经赋值大段 host 或 client 源码之后才失败，这些顶层 binding 仍会保留。后续只需在短 cell 中重试 Cordis 调用并复用该 binding，无需再次传输源码。
+
+详见 [客户端 UI](docs/client-ui.md)、[ADR 0019](docs/adr/0019-plugin-settings-and-kill-switch.md) 与 [ADR 0020](docs/adr/0020-optional-cordis-tools-in-ptc-mode.md)。
+
+## 范围
+
+PTC Plus 提供会话绑定的持久 `run_code` 层。原生工具的权限、策略、审批、取消、sandbox 和进程治理仍由 DSH 与操作系统负责。
+
+## 安装
+
+要求 Node.js `^22.19.0 || >=24.0.0`，并已安装带 TypeScript PTC 模式的 DSH：
+
+```sh
+dsh plugin --profile <profile> add github:muyuanjin/dsh-ptc-plus#main
+dsh --profile <profile> --dump-config
+```
+
+其他安装方法和兼容性说明见[安装指南](docs/installation.md)。
+
+`danger-full-access` 是首要支持方式。worker 只隔离生命周期，不隔离恶意代码。
+
+## 文档
+
+[安装指南](docs/installation.md) · [运行时参考](docs/runtime-reference.md) · [架构](docs/architecture.md) · [全部文档](docs/README.md)
+
+使用 [MIT License](LICENSE)。

package/client.js

@@ -0,0 +1,366 @@
+(() => {
+  // internal/config-spec.js
+  var MAX_TIMER_DELAY_MS = 2147483647;
+  var SETTINGS_NAMESPACE = "ptc-plus";
+  var CONFIG_FIELDS = Object.freeze([
+    {
+      key: "enabled",
+      type: "boolean",
+      default: true,
+      label: "\u542F\u7528 PTC Plus",
+      description: ""
+    },
+    {
+      key: "cordisToolsEnabled",
+      type: "boolean",
+      default: false,
+      label: "\u5728 PTC \u6A21\u5F0F\u4E2D\u542F\u7528 Cordis \u5DE5\u5177",
+      description: "\u5373\u65F6\u4E3A PTC agent \u52A0\u5165\u6216\u79FB\u9664\u5B98\u65B9 Cordis \u5DE5\u5177\u3002"
+    },
+    {
+      key: "computeMs",
+      type: "integer",
+      default: 6e4,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "\u5355 cell \u6700\u5927 CPU \u65F6\u95F4 (ms)",
+      description: "\u540C\u6B65\u8BA1\u7B97\u8D85\u8FC7\u8BE5\u9884\u7B97\u7684 cell \u4F1A\u88AB\u4E2D\u65AD\u3002"
+    },
+    {
+      key: "maxWallMs",
+      type: "integer",
+      default: 6e5,
+      min: 1,
+      max: MAX_TIMER_DELAY_MS,
+      label: "\u5355 cell \u6700\u5927\u5899\u949F\u65F6\u95F4 (ms)",
+      description: "\u5B8C\u6574 cell \u6267\u884C\uFF08\u542B\u5F02\u6B65\u7B49\u5F85\uFF09\u7684\u6700\u957F\u8017\u65F6\u3002"
+    },
+    {
+      key: "maxOutputBytes",
+      type: "integer",
+      default: 64 * 1024 * 1024,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "\u6700\u5927\u8F93\u51FA\u5B57\u8282",
+      description: "\u9650\u5236\u5355\u4E2A cell \u7684\u8F93\u51FA\u548C\u7ED3\u679C\u6570\u636E\u603B\u5927\u5C0F\u3002"
+    },
+    {
+      key: "maxOldGenerationSizeMb",
+      type: "integer",
+      default: 512,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "worker \u65E7\u751F\u4EE3\u5185\u5B58\u4E0A\u9650 (MiB)",
+      description: "\u6BCF\u4E2A worker \u7684 V8 \u65E7\u751F\u4EE3\u4E0A\u9650\uFF1B\u6D3B\u52A8 worker \u5B58\u5728\u65F6\u4FEE\u6539\u4F1A\u88AB\u62D2\u7EDD\u3002"
+    },
+    {
+      key: "maxValueNodes",
+      type: "integer",
+      default: 1e5,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "Value Graph \u6700\u5927\u8282\u70B9\u6570",
+      description: "\u9650\u5236\u5355\u6B21\u8FD4\u56DE\u503C\u7684\u8282\u70B9\u6570\u3002"
+    },
+    {
+      key: "maxValueEdges",
+      type: "integer",
+      default: 1e6,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "Value Graph \u6700\u5927\u8FB9\u6570",
+      description: "\u9650\u5236\u5355\u6B21\u8FD4\u56DE\u503C\u7684\u5F15\u7528\u5173\u7CFB\u6570\u3002"
+    },
+    {
+      key: "maxValueArrayLength",
+      type: "integer",
+      default: 1e6,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "\u6570\u7EC4\u6700\u5927\u58F0\u660E\u957F\u5EA6",
+      description: "\u9650\u5236\u8FD4\u56DE\u6570\u7EC4\u7684\u6700\u5927\u957F\u5EA6\u3002"
+    },
+    {
+      key: "maxValueBigIntDigits",
+      type: "integer",
+      default: 1e5,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "BigInt \u6700\u5927\u5341\u8FDB\u5236\u4F4D\u6570",
+      description: "\u9650\u5236\u8FD4\u56DE\u503C\u4E2D BigInt \u7684\u5341\u8FDB\u5236\u4F4D\u6570\u3002"
+    },
+    {
+      key: "maxNestedRunCodeDepth",
+      type: "integer",
+      default: 8,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "code.run \u6700\u5927\u9012\u5F52\u6DF1\u5EA6",
+      description: "\u9650\u5236 code.run \u7684\u5D4C\u5957\u5C42\u6570\u3002"
+    },
+    {
+      key: "canonicalizeToolCalls",
+      type: "boolean",
+      default: true,
+      label: "\u89C4\u8303\u9876\u5C42 native \u8BEF\u8C03",
+      description: "\u4FEE\u6B63\u53EF\u4EE5\u660E\u786E\u8BC6\u522B\u7684\u9876\u5C42 native \u8BEF\u8C03\u3002"
+    },
+    {
+      key: "looseTopLevelRedeclarations",
+      type: "boolean",
+      default: true,
+      label: "\u5BBD\u677E\u9876\u5C42\u91CD\u58F0\u660E",
+      description: "\u5141\u8BB8\u9876\u5C42 const/let \u91CD\u58F0\u660E\u5DF2\u6709\u53D8\u91CF\u3002"
+    },
+    {
+      key: "durableReplay",
+      type: "boolean",
+      default: true,
+      label: "\u6301\u4E45\u91CD\u653E",
+      description: "worker \u91CD\u542F\u540E\u6062\u590D\u53EF\u4EE5\u91CD\u5EFA\u7684 REPL \u72B6\u6001\u3002"
+    },
+    {
+      key: "autoRewriteImports",
+      type: "boolean",
+      default: true,
+      label: "\u81EA\u52A8\u6539\u5199 import",
+      description: "\u5141\u8BB8\u5728 run_code \u4E2D\u4F7F\u7528\u9759\u6001 import\u3002"
+    },
+    {
+      key: "autoStripExports",
+      type: "boolean",
+      default: true,
+      label: "\u81EA\u52A8\u5265\u79BB export",
+      description: "\u5141\u8BB8\u5728 run_code \u4E2D\u4F7F\u7528\u9876\u5C42 export\u3002"
+    },
+    {
+      key: "autoSplitRedeclarations",
+      type: "boolean",
+      default: true,
+      label: "\u81EA\u52A8\u62C6\u5206\u6DF7\u5408\u91CD\u58F0\u660E",
+      description: "\u5141\u8BB8\u9876\u5C42\u89E3\u6784\u58F0\u660E\u540C\u65F6\u5305\u542B\u65B0\u65E7\u53D8\u91CF\u3002"
+    },
+    {
+      key: "tipsEnabled",
+      type: "boolean",
+      default: true,
+      label: "\u542F\u7528\u6062\u590D\u63D0\u793A",
+      description: "\u5728\u7B26\u5408\u6761\u4EF6\u7684\u5931\u8D25\u540E\u663E\u793A\u6062\u590D\u63D0\u793A\u3002"
+    },
+    {
+      key: "tipCooldownMessages",
+      type: "integer",
+      default: 3,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "\u6062\u590D\u63D0\u793A\u51B7\u5374\u6B65\u6570",
+      description: "\u540C\u7C7B\u6062\u590D\u63D0\u793A\u4E4B\u95F4\u7684\u6700\u5C0F\u95F4\u9694\u3002"
+    },
+    {
+      key: "tipEscalationFailures",
+      type: "integer",
+      default: 2,
+      min: 1,
+      max: Number.MAX_SAFE_INTEGER,
+      label: "\u6062\u590D\u63D0\u793A\u5347\u7EA7\u5931\u8D25\u6B21\u6570",
+      description: "\u8FDE\u7EED\u5931\u8D25\u8FBE\u5230\u6B64\u6B21\u6570\u540E\u663E\u793A\u66F4\u8BE6\u7EC6\u7684\u6062\u590D\u63D0\u793A\u3002"
+    }
+  ]);
+  var CONFIG_DEFAULTS = Object.freeze(
+    Object.fromEntries(CONFIG_FIELDS.map((field) => [field.key, field.default]))
+  );
+
+  // src/client.js
+  var CLIENT_STYLE_ID = "ptc-plus-client-style";
+  var CLIENT_CSS = `
+.ptcPlusCard{border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1));background:var(--dsw-alias-bg-layer-3,#fff);border-radius:8px;list-style:none;overflow:hidden}
+.ptcPlusHeader{appearance:none;width:100%;display:flex;align-items:center;gap:12px;padding:14px 16px;border:0;background:transparent;color:inherit;font:inherit;text-align:left;cursor:pointer;transition:background-color .16s ease}
+.ptcPlusHeader:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(38,49,72,.06))}.ptcPlusHeader:focus-visible,.ptcPlusButton:focus-visible,.ptcPlusInput:focus-visible{outline:2px solid var(--dsw-alias-interactive-primary,#4d6bfe);outline-offset:-2px}
+.ptcPlusHeadText{display:flex;flex:1;min-width:0;flex-direction:column;align-items:flex-start;gap:1px}.ptcPlusName{font-size:14px;font-weight:600;line-height:20px}.ptcPlusDescription{color:var(--dsw-alias-label-tertiary,#74777d);font-size:12px;line-height:18px;overflow-wrap:anywhere}.ptcPlusStatus{display:inline-flex;align-items:center;flex:none;padding:2px 8px;border-radius:999px;font-size:11px;font-weight:500;line-height:16px}.ptcPlusStatus[data-enabled=true]{color:var(--dsw-alias-state-success-primary,#16794f);background:var(--dsw-alias-state-success-tertiary,#e7f7ef)}.ptcPlusStatus[data-enabled=false]{color:var(--dsw-alias-label-tertiary,#74777d);background:var(--dsw-alias-interactive-bg-hover,rgba(38,49,72,.06))}
+.ptcPlusChevron{display:flex;color:var(--dsw-alias-label-tertiary,#74777d);transition:transform .18s ease}.ptcPlusChevron[data-open=true]{transform:rotate(180deg)}.ptcPlusBody{display:grid;grid-template-rows:0fr;transition:grid-template-rows .2s ease}.ptcPlusBody[data-open=true]{grid-template-rows:1fr}.ptcPlusBodyInner{min-height:0;overflow:hidden}.ptcPlusFields{margin:0 16px;padding:8px 0 12px;border-top:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1))}
+.ptcPlusRow{display:flex;align-items:center;gap:12px;min-height:48px;border-top:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1))}.ptcPlusRow:first-child{border-top:0}.ptcPlusMain{flex:1;min-width:0}.ptcPlusLabel{font-size:14px;font-weight:500;line-height:20px}.ptcPlusDetail,.ptcPlusMessage{color:var(--dsw-alias-label-tertiary,#74777d);font-size:12px;line-height:18px;overflow-wrap:anywhere}.ptcPlusInput{box-sizing:border-box;min-width:72px;width:140px;padding:5px 8px;border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1));border-radius:6px;background:var(--dsw-alias-bg-layer-1,#fff);color:inherit;font:12px/18px ui-monospace,SFMono-Regular,Consolas,monospace}.ptcPlusCheck{width:18px;height:18px;accent-color:var(--dsw-alias-interactive-primary,#4d6bfe)}
+.ptcPlusFooter{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-top:8px}.ptcPlusButton{min-height:32px;padding:0 12px;border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1));border-radius:6px;background:transparent;color:inherit;cursor:pointer;font:500 13px/20px inherit;transition:background-color .16s ease,border-color .16s ease}.ptcPlusButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,rgba(38,49,72,.06))}.ptcPlusButton:disabled,.ptcPlusInput:disabled,.ptcPlusCheck:disabled{cursor:not-allowed;opacity:.55}.ptcPlusActive{display:inline-flex;align-items:center;gap:5px;color:var(--dsw-alias-state-success-primary,#16794f);font-size:12px;line-height:18px;white-space:nowrap}
+@media(max-width:560px){.ptcPlusHeader{padding:12px}.ptcPlusFields{margin:0 12px}.ptcPlusRow{align-items:flex-start;flex-direction:column;gap:6px;padding:10px 0}.ptcPlusInput{width:100%}.ptcPlusFooter{align-items:stretch;flex-direction:column}.ptcPlusButton{width:100%}}
+@media(prefers-reduced-motion:reduce){.ptcPlusHeader,.ptcPlusChevron,.ptcPlusBody,.ptcPlusButton{transition:none}}
+`;
+  window.__ModuleLoader__.load({
+    // Replaced by the bundle entry with the package name from package.json.
+    id: "dsh-ptc-plus",
+    factory: (require2) => {
+      const React = require2("react");
+      const {
+        IconCheckOutline14,
+        IconChevronDownOutline14,
+        IconSettingsOutline16
+      } = require2("@deepseek-ai/dsh-client-ui-primitives");
+      const module = { exports: {} };
+      const h = React.createElement;
+      function installStyles() {
+        if (document.getElementById(CLIENT_STYLE_ID) !== null) return () => {
+        };
+        const style = document.createElement("style");
+        style.id = CLIENT_STYLE_ID;
+        style.textContent = CLIENT_CSS;
+        document.head.append(style);
+        return () => style.remove();
+      }
+      function fieldInput(field, value, disabled, onChange) {
+        if (field.type === "boolean") {
+          return h("input", {
+            type: "checkbox",
+            role: "switch",
+            className: "ptcPlusCheck",
+            checked: value === true,
+            disabled,
+            "aria-label": field.label,
+            onChange: (event) => onChange(field, event.target.checked)
+          });
+        }
+        return h("input", {
+          type: "number",
+          className: "ptcPlusInput",
+          value: Number.isSafeInteger(value) ? String(value) : "",
+          min: field.min,
+          max: field.max,
+          step: 1,
+          disabled,
+          "aria-label": field.label,
+          onChange: (event) => {
+            const input = event.target.value;
+            const parsed = input === "" ? "" : Number(input);
+            onChange(field, Number.isSafeInteger(parsed) ? parsed : input);
+          }
+        });
+      }
+      function apply(ctx) {
+        const preferenceScope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+        ctx.effect(installStyles, "ptc-plus: client styles");
+        function PTCPlusSettingsCard() {
+          const [open, setOpen] = React.useState(false);
+          const [status, setStatus] = React.useState("");
+          const [pending, setPending] = React.useState(() => /* @__PURE__ */ new Set());
+          const writeTail = React.useRef(Promise.resolve());
+          const subscribe = React.useCallback((listener) => preferenceScope.subscribe(listener), []);
+          const getSnapshot = React.useCallback(() => preferenceScope.getSnapshot(), []);
+          const snapshot = React.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+          const value = snapshot.status === "ready" ? snapshot.value ?? {} : {};
+          const enabled = value.enabled === true;
+          const unavailable = snapshot.status !== "ready" || snapshot.writable !== true;
+          const persist = (field, nextValue) => {
+            if (unavailable || pending.has(field.key)) return;
+            const operation = writeTail.current.then(async () => {
+              const before = preferenceScope.getSnapshot();
+              if (before.status !== "ready" || before.writable !== true) return;
+              if (field.key !== "enabled" && before.value?.enabled !== true) return;
+              if (before.value?.[field.key] === nextValue) return;
+              setPending((current) => new Set(current).add(field.key));
+              setStatus("");
+              try {
+                await preferenceScope.set(field.key, nextValue);
+                const after = preferenceScope.getSnapshot();
+                if (after.status !== "ready" || after.value?.[field.key] !== nextValue) {
+                  setStatus("\u8BBE\u7F6E\u672A\u751F\u6548\uFF0C\u8BF7\u68C0\u67E5\u8BBE\u7F6E\u51B2\u7A81");
+                } else {
+                  setStatus("\u8BBE\u7F6E\u5DF2\u7ACB\u5373\u751F\u6548");
+                }
+              } catch (error) {
+                setStatus("\u8BBE\u7F6E\u5931\u8D25\uFF1A" + (error instanceof Error ? error.message : String(error)));
+              } finally {
+                setPending((current) => {
+                  const next = new Set(current);
+                  next.delete(field.key);
+                  return next;
+                });
+              }
+            });
+            writeTail.current = operation.catch(() => {
+            });
+          };
+          const fieldDisabled = (field) => unavailable || pending.has(field.key) || field.key !== "enabled" && !enabled;
+          return h(
+            "li",
+            { className: "ptcPlusCard" },
+            h(
+              "button",
+              {
+                type: "button",
+                className: "ptcPlusHeader",
+                "aria-expanded": open,
+                "aria-label": open ? "\u6536\u8D77 PTC Plus \u8BBE\u7F6E" : "\u5C55\u5F00 PTC Plus \u8BBE\u7F6E",
+                "aria-controls": "ptc-plus-settings-body",
+                onClick: () => setOpen((current) => !current)
+              },
+              h(IconSettingsOutline16, { size: 16 }),
+              h(
+                "span",
+                { className: "ptcPlusHeadText" },
+                h("span", { className: "ptcPlusName" }, "PTC Plus"),
+                h("span", { className: "ptcPlusDescription" }, "PTC \u6A21\u5F0F\u7684\u4F1A\u8BDD\u7EA7 TypeScript REPL\u3002")
+              ),
+              h("span", { className: "ptcPlusStatus", "data-enabled": enabled }, enabled ? "\u5DF2\u542F\u7528" : "\u5DF2\u505C\u7528"),
+              h("span", { className: "ptcPlusChevron", "data-open": open, "aria-hidden": true }, h(IconChevronDownOutline14, { size: 14 }))
+            ),
+            h(
+              "div",
+              { id: "ptc-plus-settings-body", className: "ptcPlusBody", "data-open": open, "aria-hidden": !open },
+              h("div", { className: "ptcPlusBodyInner" }, h(
+                "div",
+                { className: "ptcPlusFields" },
+                snapshot.status === "loading" ? h("p", { className: "ptcPlusMessage" }, "\u6B63\u5728\u540C\u6B65\u8BBE\u7F6E...") : snapshot.status === "unavailable" ? h("p", { className: "ptcPlusMessage" }, "\u5F53\u524D DSH \u5B9E\u4F8B\u672A\u63D0\u4F9B\u8BBE\u7F6E\u670D\u52A1") : [
+                  ...CONFIG_FIELDS.map((field) => h(
+                    "div",
+                    { key: field.key, className: "ptcPlusRow" },
+                    h(
+                      "div",
+                      { className: "ptcPlusMain" },
+                      h("div", { className: "ptcPlusLabel" }, field.label),
+                      field.description === "" ? null : h("div", { className: "ptcPlusDetail" }, field.description)
+                    ),
+                    fieldInput(field, value[field.key], fieldDisabled(field), persist)
+                  )),
+                  h(
+                    "div",
+                    { key: "footer", className: "ptcPlusFooter" },
+                    h("span", { className: "ptcPlusMessage", role: "status" }, status || (snapshot.writable ? "\u8BBE\u7F6E\u4F1A\u5728\u4FEE\u6539\u540E\u7ACB\u5373\u751F\u6548" : "\u5F53\u524D\u8BBE\u7F6E\u4E3A\u53EA\u8BFB"))
+                  )
+                ]
+              ))
+            )
+          );
+        }
+        ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
+          name: "settings.plugin.item",
+          key: SETTINGS_NAMESPACE
+        }, PTCPlusSettingsCard));
+        ctx.inject(["slots", "sessions"], (scope) => {
+          function PTCPlusSessionIndicator({ sessionId }) {
+            const sessions = React.useSyncExternalStore(
+              (listener) => scope.sessions.list.subscribe(listener),
+              () => scope.sessions.list.getSnapshot(),
+              () => scope.sessions.list.getSnapshot()
+            );
+            const settings = React.useSyncExternalStore(
+              (listener) => preferenceScope.subscribe(listener),
+              () => preferenceScope.getSnapshot(),
+              () => preferenceScope.getSnapshot()
+            );
+            if (sessions.byId?.[sessionId]?.agentPreset !== "code" || settings.status !== "ready" || settings.value?.enabled !== true) return null;
+            return h(
+              "span",
+              { className: "ptcPlusActive", title: "PTC Plus \u5DF2\u542F\u7528" },
+              h(IconCheckOutline14, { size: 14 }),
+              "PTC Plus"
+            );
+          }
+          scope.slots.inject("conversation.session.header.actions", () => scope.slots.register({
+            name: "conversation.session.header.actions",
+            id: "ptc-plus-active",
+            order: -9
+          }, PTCPlusSessionIndicator));
+        });
+      }
+      module.exports = { apply, inject: ["settingsScope", "slots", "sessions"] };
+      return module.exports;
+    }
+  });
+})();