dsh-plugin-guide 0.3.15 → 0.3.17

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 (446) hide show
  1. package/README-es.md +43 -40
  2. package/README-hi.md +43 -40
  3. package/README-pt.md +43 -40
  4. package/README-zh.md +43 -40
  5. package/README.md +19 -15
  6. package/dist/dsh-plugin-dev.js +230 -6
  7. package/guide/plugin-dev-guide.md +1 -1
  8. package/guide/release-engineering.md +7 -5
  9. package/guide/release-engineering.zh-CN.md +7 -5
  10. package/guide/unfixed-issues.md +4 -2
  11. package/package.json +5 -4
  12. package/references/official-docs/AGENTS.md +74 -49
  13. package/references/official-docs/README.i18n.yaml +2 -2
  14. package/references/official-docs/README.zh.md +12 -0
  15. package/references/official-docs/SNAPSHOT.md +4 -4
  16. package/references/official-docs/THIRD_PARTY_NOTICES.md +86 -30
  17. package/references/official-docs/docs/AGENTS.md +7 -6
  18. package/references/official-docs/docs/agent-lifecycle.i18n.yaml +2 -2
  19. package/references/official-docs/docs/agent-lifecycle.md +12 -5
  20. package/references/official-docs/docs/agent-lifecycle.zh.md +12 -5
  21. package/references/official-docs/docs/api-gateway.i18n.yaml +2 -2
  22. package/references/official-docs/docs/api-gateway.md +2 -2
  23. package/references/official-docs/docs/api-gateway.zh.md +2 -2
  24. package/references/official-docs/docs/architecture.i18n.yaml +2 -2
  25. package/references/official-docs/docs/architecture.md +26 -12
  26. package/references/official-docs/docs/architecture.zh.md +28 -14
  27. package/references/official-docs/docs/capability-seams.i18n.yaml +2 -2
  28. package/references/official-docs/docs/capability-seams.md +111 -31
  29. package/references/official-docs/docs/capability-seams.zh.md +111 -31
  30. package/references/official-docs/docs/config-catalog.i18n.yaml +2 -2
  31. package/references/official-docs/docs/config-catalog.md +674 -202
  32. package/references/official-docs/docs/config-catalog.zh.md +691 -219
  33. package/references/official-docs/docs/cookbook/adding-a-session-format-version.i18n.yaml +6 -0
  34. package/references/official-docs/docs/cookbook/adding-a-session-format-version.md +111 -0
  35. package/references/official-docs/docs/cookbook/adding-a-session-format-version.zh.md +111 -0
  36. package/references/official-docs/docs/cookbook/adding-a-settings-card.md +8 -8
  37. package/references/official-docs/docs/cookbook/adding-a-settings-card.zh.md +9 -9
  38. package/references/official-docs/docs/cookbook/adding-a-tool.i18n.yaml +2 -2
  39. package/references/official-docs/docs/cookbook/adding-a-tool.md +2 -2
  40. package/references/official-docs/docs/cookbook/adding-a-tool.zh.md +4 -4
  41. package/references/official-docs/docs/cookbook/adding-a-vendored-package.i18n.yaml +2 -2
  42. package/references/official-docs/docs/cookbook/adding-a-vendored-package.md +1 -1
  43. package/references/official-docs/docs/cookbook/adding-a-vendored-package.zh.md +1 -1
  44. package/references/official-docs/docs/cookbook/adding-an-llm-adapter.zh.md +1 -1
  45. package/references/official-docs/docs/cookbook/extension-cookbook.i18n.yaml +2 -2
  46. package/references/official-docs/docs/cookbook/extension-cookbook.md +3 -3
  47. package/references/official-docs/docs/cookbook/extension-cookbook.zh.md +5 -5
  48. package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.i18n.yaml +2 -2
  49. package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.md +1 -1
  50. package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.zh.md +1 -1
  51. package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.i18n.yaml +6 -0
  52. package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.md +108 -0
  53. package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.zh.md +108 -0
  54. package/references/official-docs/docs/cordis-api/fiber.i18n.yaml +2 -2
  55. package/references/official-docs/docs/cordis-api/fiber.md +3 -3
  56. package/references/official-docs/docs/cordis-api/fiber.zh.md +3 -3
  57. package/references/official-docs/docs/cordis-api/inherited.md +0 -3
  58. package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.i18n.yaml +2 -2
  59. package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.md +2 -2
  60. package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.zh.md +2 -2
  61. package/references/official-docs/docs/deepseek-llm-api-wire-extensions.i18n.yaml +2 -2
  62. package/references/official-docs/docs/deepseek-llm-api-wire-extensions.md +14 -15
  63. package/references/official-docs/docs/deepseek-llm-api-wire-extensions.zh.md +15 -16
  64. package/references/official-docs/docs/dependency-catalog.json +7312 -0
  65. package/references/official-docs/docs/development.i18n.yaml +2 -2
  66. package/references/official-docs/docs/development.md +13 -3
  67. package/references/official-docs/docs/development.zh.md +16 -6
  68. package/references/official-docs/docs/event-producer-consumer.i18n.yaml +2 -2
  69. package/references/official-docs/docs/event-producer-consumer.md +50 -39
  70. package/references/official-docs/docs/event-producer-consumer.zh.md +55 -44
  71. package/references/official-docs/docs/glossary.i18n.yaml +2 -2
  72. package/references/official-docs/docs/glossary.md +1 -1
  73. package/references/official-docs/docs/glossary.zh.md +1 -1
  74. package/references/official-docs/docs/i18n/README.i18n.yaml +2 -2
  75. package/references/official-docs/docs/i18n/README.md +8 -3
  76. package/references/official-docs/docs/i18n/README.zh.md +8 -3
  77. package/references/official-docs/docs/i18n/style-samples.md +1 -1
  78. package/references/official-docs/docs/i18n/translation-prompt.md +5 -5
  79. package/references/official-docs/docs/i18n/translation-rules.zh.md +2 -2
  80. package/references/official-docs/docs/module-graph.i18n.yaml +2 -2
  81. package/references/official-docs/docs/module-graph.md +303 -120
  82. package/references/official-docs/docs/module-graph.zh.md +303 -120
  83. package/references/official-docs/docs/persistence-catalog.i18n.yaml +2 -2
  84. package/references/official-docs/docs/persistence-catalog.md +5699 -64
  85. package/references/official-docs/docs/persistence-catalog.zh.md +5708 -73
  86. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.i18n.yaml +6 -0
  87. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.md +280 -0
  88. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.schema.json +13557 -0
  89. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.zh.md +280 -0
  90. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.i18n.yaml +6 -0
  91. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.md +52 -0
  92. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.schema.json +910 -0
  93. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.zh.md +52 -0
  94. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.i18n.yaml +6 -0
  95. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.md +96 -0
  96. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.schema.json +8478 -0
  97. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.zh.md +96 -0
  98. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.i18n.yaml +6 -0
  99. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.md +48 -0
  100. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.schema.json +72 -0
  101. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.zh.md +48 -0
  102. package/references/official-docs/docs/persistence-changes/README.i18n.yaml +6 -0
  103. package/references/official-docs/docs/persistence-changes/README.md +74 -0
  104. package/references/official-docs/docs/persistence-changes/README.zh.md +74 -0
  105. package/references/official-docs/docs/persistence-changes/historical-formats/README.i18n.yaml +6 -0
  106. package/references/official-docs/docs/persistence-changes/historical-formats/README.md +74 -0
  107. package/references/official-docs/docs/persistence-changes/historical-formats/README.zh.md +74 -0
  108. package/references/official-docs/docs/persistence-changes/historical-formats/v0.i18n.yaml +6 -0
  109. package/references/official-docs/docs/persistence-changes/historical-formats/v0.md +5105 -0
  110. package/references/official-docs/docs/persistence-changes/historical-formats/v0.schema.json +49308 -0
  111. package/references/official-docs/docs/persistence-changes/historical-formats/v0.zh.md +5105 -0
  112. package/references/official-docs/docs/persistence-changes/historical-formats/v1.i18n.yaml +6 -0
  113. package/references/official-docs/docs/persistence-changes/historical-formats/v1.md +5107 -0
  114. package/references/official-docs/docs/persistence-changes/historical-formats/v1.schema.json +49411 -0
  115. package/references/official-docs/docs/persistence-changes/historical-formats/v1.zh.md +5107 -0
  116. package/references/official-docs/docs/persistence-changes/historical-formats/v2.i18n.yaml +6 -0
  117. package/references/official-docs/docs/persistence-changes/historical-formats/v2.md +5362 -0
  118. package/references/official-docs/docs/persistence-changes/historical-formats/v2.schema.json +56466 -0
  119. package/references/official-docs/docs/persistence-changes/historical-formats/v2.zh.md +5362 -0
  120. package/references/official-docs/docs/persistence-changes/releases/README.i18n.yaml +6 -0
  121. package/references/official-docs/docs/persistence-changes/releases/README.md +103 -0
  122. package/references/official-docs/docs/persistence-changes/releases/README.zh.md +103 -0
  123. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.i18n.yaml +6 -0
  124. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.md +201 -0
  125. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.schema.json +39868 -0
  126. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.zh.md +201 -0
  127. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.i18n.yaml +6 -0
  128. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.md +261 -0
  129. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.schema.json +43342 -0
  130. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.zh.md +261 -0
  131. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.i18n.yaml +6 -0
  132. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.md +126 -0
  133. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.schema.json +19452 -0
  134. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.zh.md +126 -0
  135. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.i18n.yaml +6 -0
  136. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.md +75 -0
  137. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.schema.json +5 -0
  138. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.zh.md +75 -0
  139. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.i18n.yaml +6 -0
  140. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.md +75 -0
  141. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.schema.json +5 -0
  142. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.zh.md +75 -0
  143. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.i18n.yaml +6 -0
  144. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.md +75 -0
  145. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.schema.json +5 -0
  146. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.zh.md +75 -0
  147. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.i18n.yaml +6 -0
  148. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.md +75 -0
  149. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.schema.json +5 -0
  150. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.zh.md +75 -0
  151. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.i18n.yaml +6 -0
  152. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.md +75 -0
  153. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.schema.json +5 -0
  154. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.zh.md +75 -0
  155. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.i18n.yaml +6 -0
  156. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.md +75 -0
  157. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.schema.json +5 -0
  158. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.zh.md +75 -0
  159. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.i18n.yaml +6 -0
  160. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.md +75 -0
  161. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.schema.json +5 -0
  162. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.zh.md +75 -0
  163. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.i18n.yaml +6 -0
  164. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.md +82 -0
  165. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.schema.json +5320 -0
  166. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.zh.md +82 -0
  167. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.i18n.yaml +6 -0
  168. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.md +110 -0
  169. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.schema.json +21258 -0
  170. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.zh.md +110 -0
  171. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.i18n.yaml +6 -0
  172. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.md +82 -0
  173. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.schema.json +417 -0
  174. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.zh.md +82 -0
  175. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.i18n.yaml +6 -0
  176. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.md +119 -0
  177. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.schema.json +29672 -0
  178. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.zh.md +119 -0
  179. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.i18n.yaml +6 -0
  180. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.md +295 -0
  181. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.schema.json +48429 -0
  182. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.zh.md +295 -0
  183. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.i18n.yaml +6 -0
  184. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.md +286 -0
  185. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.schema.json +49347 -0
  186. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.zh.md +286 -0
  187. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.i18n.yaml +6 -0
  188. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.md +75 -0
  189. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.schema.json +5 -0
  190. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.zh.md +75 -0
  191. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.i18n.yaml +6 -0
  192. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.md +95 -0
  193. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.schema.json +17642 -0
  194. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.zh.md +95 -0
  195. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.i18n.yaml +6 -0
  196. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.md +75 -0
  197. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.schema.json +5 -0
  198. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.zh.md +75 -0
  199. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.i18n.yaml +6 -0
  200. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.md +75 -0
  201. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.schema.json +5 -0
  202. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.zh.md +75 -0
  203. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.i18n.yaml +6 -0
  204. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.md +154 -0
  205. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.schema.json +38678 -0
  206. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.zh.md +154 -0
  207. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.i18n.yaml +6 -0
  208. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.md +86 -0
  209. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.schema.json +783 -0
  210. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.zh.md +86 -0
  211. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.i18n.yaml +6 -0
  212. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.md +139 -0
  213. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.schema.json +24597 -0
  214. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.zh.md +139 -0
  215. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.i18n.yaml +6 -0
  216. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.md +95 -0
  217. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.schema.json +2132 -0
  218. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.zh.md +95 -0
  219. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.i18n.yaml +6 -0
  220. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.md +75 -0
  221. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.schema.json +5 -0
  222. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.zh.md +75 -0
  223. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.i18n.yaml +6 -0
  224. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.md +75 -0
  225. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.schema.json +5 -0
  226. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.zh.md +75 -0
  227. package/references/official-docs/docs/persistence-changes/releases/manifest.json +162 -0
  228. package/references/official-docs/docs/persistence-schema.json +61480 -0
  229. package/references/official-docs/docs/postmortem/README.i18n.yaml +1 -1
  230. package/references/official-docs/docs/postmortem/README.md +1 -1
  231. package/references/official-docs/docs/postmortem/README.zh.md +1 -1
  232. package/references/official-docs/docs/rescope.i18n.yaml +2 -2
  233. package/references/official-docs/docs/rescope.md +2 -2
  234. package/references/official-docs/docs/rescope.zh.md +2 -2
  235. package/references/official-docs/docs/session-format-status.i18n.yaml +6 -0
  236. package/references/official-docs/docs/session-format-status.md +49 -0
  237. package/references/official-docs/docs/session-format-status.zh.md +49 -0
  238. package/references/official-docs/docs/subsystems/README.i18n.yaml +2 -2
  239. package/references/official-docs/docs/subsystems/README.md +12 -3
  240. package/references/official-docs/docs/subsystems/README.zh.md +23 -14
  241. package/references/official-docs/docs/subsystems/agent-team.i18n.yaml +2 -2
  242. package/references/official-docs/docs/subsystems/agent-team.md +1 -1
  243. package/references/official-docs/docs/subsystems/agent-team.zh.md +2 -2
  244. package/references/official-docs/docs/subsystems/approval.i18n.yaml +2 -2
  245. package/references/official-docs/docs/subsystems/approval.md +1 -1
  246. package/references/official-docs/docs/subsystems/approval.zh.md +1 -1
  247. package/references/official-docs/docs/subsystems/attachment.i18n.yaml +2 -2
  248. package/references/official-docs/docs/subsystems/attachment.md +17 -7
  249. package/references/official-docs/docs/subsystems/attachment.zh.md +17 -7
  250. package/references/official-docs/docs/subsystems/{code-runtime.i18n.yaml → boot.i18n.yaml} +3 -3
  251. package/references/official-docs/docs/subsystems/boot.md +223 -0
  252. package/references/official-docs/docs/subsystems/boot.zh.md +223 -0
  253. package/references/official-docs/docs/subsystems/browser-use.i18n.yaml +6 -0
  254. package/references/official-docs/docs/subsystems/browser-use.md +67 -0
  255. package/references/official-docs/docs/subsystems/browser-use.zh.md +67 -0
  256. package/references/official-docs/docs/subsystems/client-modules.i18n.yaml +2 -2
  257. package/references/official-docs/docs/subsystems/client-modules.md +20 -10
  258. package/references/official-docs/docs/subsystems/client-modules.zh.md +21 -11
  259. package/references/official-docs/docs/subsystems/client-resources.i18n.yaml +6 -0
  260. package/references/official-docs/docs/subsystems/client-resources.md +92 -0
  261. package/references/official-docs/docs/subsystems/client-resources.zh.md +92 -0
  262. package/references/official-docs/docs/subsystems/commands.i18n.yaml +2 -2
  263. package/references/official-docs/docs/subsystems/commands.md +4 -0
  264. package/references/official-docs/docs/subsystems/commands.zh.md +5 -1
  265. package/references/official-docs/docs/subsystems/compaction.i18n.yaml +2 -2
  266. package/references/official-docs/docs/subsystems/compaction.md +48 -2
  267. package/references/official-docs/docs/subsystems/compaction.zh.md +50 -4
  268. package/references/official-docs/docs/subsystems/computer-use.i18n.yaml +6 -0
  269. package/references/official-docs/docs/subsystems/computer-use.md +56 -0
  270. package/references/official-docs/docs/subsystems/computer-use.zh.md +56 -0
  271. package/references/official-docs/docs/subsystems/conversation.zh.md +1 -1
  272. package/references/official-docs/docs/subsystems/core.i18n.yaml +2 -2
  273. package/references/official-docs/docs/subsystems/core.md +106 -60
  274. package/references/official-docs/docs/subsystems/core.zh.md +109 -63
  275. package/references/official-docs/docs/subsystems/deliverables.i18n.yaml +6 -0
  276. package/references/official-docs/docs/subsystems/deliverables.md +178 -0
  277. package/references/official-docs/docs/subsystems/deliverables.zh.md +178 -0
  278. package/references/official-docs/docs/subsystems/extensions.zh.md +1 -1
  279. package/references/official-docs/docs/subsystems/feedback.i18n.yaml +2 -2
  280. package/references/official-docs/docs/subsystems/feedback.md +165 -31
  281. package/references/official-docs/docs/subsystems/feedback.zh.md +165 -31
  282. package/references/official-docs/docs/subsystems/filesystem.i18n.yaml +2 -2
  283. package/references/official-docs/docs/subsystems/filesystem.md +15 -0
  284. package/references/official-docs/docs/subsystems/filesystem.zh.md +16 -1
  285. package/references/official-docs/docs/subsystems/goal.i18n.yaml +2 -2
  286. package/references/official-docs/docs/subsystems/goal.md +37 -1
  287. package/references/official-docs/docs/subsystems/goal.zh.md +38 -2
  288. package/references/official-docs/docs/subsystems/invariants.i18n.yaml +2 -2
  289. package/references/official-docs/docs/subsystems/invariants.md +1 -1
  290. package/references/official-docs/docs/subsystems/invariants.zh.md +3 -3
  291. package/references/official-docs/docs/subsystems/jobs.i18n.yaml +1 -1
  292. package/references/official-docs/docs/subsystems/jobs.md +1 -1
  293. package/references/official-docs/docs/subsystems/jobs.zh.md +1 -1
  294. package/references/official-docs/docs/subsystems/llm-streaming.i18n.yaml +2 -2
  295. package/references/official-docs/docs/subsystems/llm-streaming.md +35 -15
  296. package/references/official-docs/docs/subsystems/llm-streaming.zh.md +37 -17
  297. package/references/official-docs/docs/subsystems/lsp.i18n.yaml +2 -2
  298. package/references/official-docs/docs/subsystems/lsp.md +1 -1
  299. package/references/official-docs/docs/subsystems/lsp.zh.md +1 -1
  300. package/references/official-docs/docs/subsystems/mcp.i18n.yaml +6 -0
  301. package/references/official-docs/docs/subsystems/mcp.md +139 -0
  302. package/references/official-docs/docs/subsystems/mcp.zh.md +139 -0
  303. package/references/official-docs/docs/subsystems/office-to-pdf.i18n.yaml +6 -0
  304. package/references/official-docs/docs/subsystems/office-to-pdf.md +87 -0
  305. package/references/official-docs/docs/subsystems/office-to-pdf.zh.md +87 -0
  306. package/references/official-docs/docs/subsystems/permission-presets.i18n.yaml +2 -2
  307. package/references/official-docs/docs/subsystems/permission-presets.md +62 -27
  308. package/references/official-docs/docs/subsystems/permission-presets.zh.md +62 -27
  309. package/references/official-docs/docs/subsystems/persistence.i18n.yaml +2 -2
  310. package/references/official-docs/docs/subsystems/persistence.md +36 -15
  311. package/references/official-docs/docs/subsystems/persistence.zh.md +36 -15
  312. package/references/official-docs/docs/subsystems/plan.zh.md +2 -2
  313. package/references/official-docs/docs/subsystems/ptc-runtime.i18n.yaml +6 -0
  314. package/references/official-docs/docs/subsystems/ptc-runtime.md +232 -0
  315. package/references/official-docs/docs/subsystems/ptc-runtime.zh.md +232 -0
  316. package/references/official-docs/docs/subsystems/sandbox.i18n.yaml +2 -2
  317. package/references/official-docs/docs/subsystems/sandbox.md +5 -4
  318. package/references/official-docs/docs/subsystems/sandbox.zh.md +7 -6
  319. package/references/official-docs/docs/subsystems/schedule.i18n.yaml +2 -2
  320. package/references/official-docs/docs/subsystems/schedule.md +2 -2
  321. package/references/official-docs/docs/subsystems/schedule.zh.md +3 -3
  322. package/references/official-docs/docs/subsystems/scope.i18n.yaml +2 -2
  323. package/references/official-docs/docs/subsystems/scope.md +1 -1
  324. package/references/official-docs/docs/subsystems/scope.zh.md +1 -1
  325. package/references/official-docs/docs/subsystems/session-projection.i18n.yaml +2 -2
  326. package/references/official-docs/docs/subsystems/session-projection.md +1 -1
  327. package/references/official-docs/docs/subsystems/session-projection.zh.md +2 -2
  328. package/references/official-docs/docs/subsystems/session-reference.i18n.yaml +2 -2
  329. package/references/official-docs/docs/subsystems/session-reference.md +11 -6
  330. package/references/official-docs/docs/subsystems/session-reference.zh.md +11 -6
  331. package/references/official-docs/docs/subsystems/session-telemetry.i18n.yaml +2 -2
  332. package/references/official-docs/docs/subsystems/session-telemetry.md +22 -6
  333. package/references/official-docs/docs/subsystems/session-telemetry.zh.md +23 -7
  334. package/references/official-docs/docs/subsystems/session-title.i18n.yaml +2 -2
  335. package/references/official-docs/docs/subsystems/session-title.md +5 -5
  336. package/references/official-docs/docs/subsystems/session-title.zh.md +5 -5
  337. package/references/official-docs/docs/subsystems/session.i18n.yaml +2 -2
  338. package/references/official-docs/docs/subsystems/session.md +149 -61
  339. package/references/official-docs/docs/subsystems/session.zh.md +150 -62
  340. package/references/official-docs/docs/subsystems/shell.i18n.yaml +2 -2
  341. package/references/official-docs/docs/subsystems/shell.md +19 -15
  342. package/references/official-docs/docs/subsystems/shell.zh.md +20 -16
  343. package/references/official-docs/docs/subsystems/sidebar-right.i18n.yaml +6 -0
  344. package/references/official-docs/docs/subsystems/sidebar-right.md +153 -0
  345. package/references/official-docs/docs/subsystems/sidebar-right.zh.md +153 -0
  346. package/references/official-docs/docs/subsystems/skills.i18n.yaml +2 -2
  347. package/references/official-docs/docs/subsystems/skills.md +4 -6
  348. package/references/official-docs/docs/subsystems/skills.zh.md +4 -6
  349. package/references/official-docs/docs/subsystems/slots.i18n.yaml +2 -2
  350. package/references/official-docs/docs/subsystems/slots.md +52 -38
  351. package/references/official-docs/docs/subsystems/slots.zh.md +53 -39
  352. package/references/official-docs/docs/subsystems/spill.i18n.yaml +2 -2
  353. package/references/official-docs/docs/subsystems/spill.md +13 -6
  354. package/references/official-docs/docs/subsystems/spill.zh.md +13 -6
  355. package/references/official-docs/docs/subsystems/ssh.i18n.yaml +6 -0
  356. package/references/official-docs/docs/subsystems/ssh.md +135 -0
  357. package/references/official-docs/docs/subsystems/ssh.zh.md +135 -0
  358. package/references/official-docs/docs/subsystems/storage.zh.md +2 -2
  359. package/references/official-docs/docs/subsystems/subagent.i18n.yaml +2 -2
  360. package/references/official-docs/docs/subsystems/subagent.md +33 -16
  361. package/references/official-docs/docs/subsystems/subagent.zh.md +32 -15
  362. package/references/official-docs/docs/subsystems/subprocess.i18n.yaml +2 -2
  363. package/references/official-docs/docs/subsystems/subprocess.md +41 -44
  364. package/references/official-docs/docs/subsystems/subprocess.zh.md +41 -44
  365. package/references/official-docs/docs/subsystems/system-prompt.i18n.yaml +2 -2
  366. package/references/official-docs/docs/subsystems/system-prompt.md +6 -2
  367. package/references/official-docs/docs/subsystems/system-prompt.zh.md +7 -3
  368. package/references/official-docs/docs/subsystems/todo.zh.md +1 -1
  369. package/references/official-docs/docs/subsystems/token-meter.i18n.yaml +2 -2
  370. package/references/official-docs/docs/subsystems/token-meter.md +2 -1
  371. package/references/official-docs/docs/subsystems/token-meter.zh.md +2 -1
  372. package/references/official-docs/docs/subsystems/tools.i18n.yaml +2 -2
  373. package/references/official-docs/docs/subsystems/tools.md +28 -12
  374. package/references/official-docs/docs/subsystems/tools.zh.md +28 -12
  375. package/references/official-docs/docs/subsystems/typert.i18n.yaml +2 -2
  376. package/references/official-docs/docs/subsystems/typert.md +6 -5
  377. package/references/official-docs/docs/subsystems/typert.zh.md +6 -5
  378. package/references/official-docs/docs/subsystems/user-questions.i18n.yaml +2 -2
  379. package/references/official-docs/docs/subsystems/user-questions.md +2 -0
  380. package/references/official-docs/docs/subsystems/user-questions.zh.md +2 -0
  381. package/references/official-docs/docs/subsystems/web-client.i18n.yaml +2 -2
  382. package/references/official-docs/docs/subsystems/web-client.md +5 -5
  383. package/references/official-docs/docs/subsystems/web-client.zh.md +6 -6
  384. package/references/official-docs/docs/subsystems/web-server.i18n.yaml +2 -2
  385. package/references/official-docs/docs/subsystems/web-server.md +64 -0
  386. package/references/official-docs/docs/subsystems/web-server.zh.md +65 -1
  387. package/references/official-docs/docs/subsystems/webhook.i18n.yaml +1 -1
  388. package/references/official-docs/docs/subsystems/webhook.md +2 -2
  389. package/references/official-docs/docs/subsystems/workflow.i18n.yaml +2 -2
  390. package/references/official-docs/docs/subsystems/workflow.md +8 -8
  391. package/references/official-docs/docs/subsystems/workflow.zh.md +10 -10
  392. package/references/official-docs/docs/subsystems/workspace.i18n.yaml +2 -2
  393. package/references/official-docs/docs/subsystems/workspace.md +199 -1
  394. package/references/official-docs/docs/subsystems/workspace.zh.md +199 -1
  395. package/references/official-docs/docs/testing.i18n.yaml +2 -2
  396. package/references/official-docs/docs/testing.md +5 -4
  397. package/references/official-docs/docs/testing.zh.md +5 -4
  398. package/references/official-docs/docs/tool-catalog.i18n.yaml +2 -2
  399. package/references/official-docs/docs/tool-catalog.md +452 -187
  400. package/references/official-docs/docs/tool-catalog.zh.md +454 -189
  401. package/references/official-docs/docs/tool-execution-pipeline.i18n.yaml +2 -2
  402. package/references/official-docs/docs/tool-execution-pipeline.md +2 -2
  403. package/references/official-docs/docs/tool-execution-pipeline.zh.md +2 -2
  404. package/references/official-docs/docs/user/develop/basic/index.zh.md +1 -1
  405. package/references/official-docs/docs/user/develop/basic/publish.i18n.yaml +2 -2
  406. package/references/official-docs/docs/user/develop/basic/publish.md +2 -2
  407. package/references/official-docs/docs/user/develop/basic/publish.zh.md +5 -5
  408. package/references/official-docs/docs/user/develop/framework/index.i18n.yaml +2 -2
  409. package/references/official-docs/docs/user/develop/framework/index.md +1 -1
  410. package/references/official-docs/docs/user/develop/framework/index.zh.md +1 -1
  411. package/references/official-docs/docs/user/develop/practice/dynamic-cordis.i18n.yaml +2 -2
  412. package/references/official-docs/docs/user/develop/practice/dynamic-cordis.md +8 -8
  413. package/references/official-docs/docs/user/develop/practice/dynamic-cordis.zh.md +8 -8
  414. package/references/official-docs/docs/user/guide/index.zh.md +2 -2
  415. package/references/official-docs/docs/user/guide/mcp-memory.zh.md +1 -1
  416. package/references/official-docs/docs/user/guide/network-proxy.i18n.yaml +2 -2
  417. package/references/official-docs/docs/user/guide/network-proxy.md +1 -1
  418. package/references/official-docs/docs/user/guide/network-proxy.zh.md +1 -1
  419. package/references/official-docs/docs/user/guide/providers.i18n.yaml +2 -2
  420. package/references/official-docs/docs/user/guide/providers.md +12 -8
  421. package/references/official-docs/docs/user/guide/providers.zh.md +14 -10
  422. package/references/official-docs/docs/user/guide/python-sdk.i18n.yaml +2 -2
  423. package/references/official-docs/docs/user/guide/python-sdk.md +59 -23
  424. package/references/official-docs/docs/user/guide/python-sdk.zh.md +60 -24
  425. package/references/official-docs/docs/web-styling.i18n.yaml +2 -2
  426. package/references/official-docs/docs/web-styling.md +2 -1
  427. package/references/official-docs/docs/web-styling.zh.md +3 -2
  428. package/references/official-docs/packages/AGENTS.md +1 -1
  429. package/references/official-docs/packages/README.md +12 -7
  430. package/references/official-docs/vendor/README.md +15 -11
  431. package/references/official-docs/website-docs.ts +4 -2
  432. package/scripts/sync-official-docs.ps1 +5 -5
  433. package/templates/js/README-es.md +1 -1
  434. package/templates/js/README-hi.md +1 -1
  435. package/templates/js/README-pt.md +1 -1
  436. package/templates/js/README-zh.md +1 -1
  437. package/templates/js/README.md +1 -1
  438. package/templates/js/package.json +2 -2
  439. package/templates/ts/README-es.md +1 -1
  440. package/templates/ts/README-hi.md +1 -1
  441. package/templates/ts/README-pt.md +1 -1
  442. package/templates/ts/README-zh.md +1 -1
  443. package/templates/ts/README.md +1 -1
  444. package/templates/ts/package.json +2 -2
  445. package/references/official-docs/docs/subsystems/code-runtime.md +0 -195
  446. package/references/official-docs/docs/subsystems/code-runtime.zh.md +0 -195
@@ -7,7 +7,7 @@ Every `config:` block a `cordis.yml` entry can set: for each loadable harness pa
7
7
 
8
8
  This file is GENERATED from source (`scripts/gen-config-catalog.ts`) and verified fresh by `pnpm run verify-config-catalog` (part of `doc-sync`) — do not edit it by hand. Declaration blocks use a `ts config-catalog` fence (skipped by doc-typecheck, since a lone declaration referencing imports is not standalone-compilable). The generator also cross-checks the runtime schemastery schema against the pasted declaration — every schema-validated key, nested keys included, must be locatable on the declared config type — so the paste cannot hide a loader-accepted field.
9
9
 
10
- A `Requires:` line lists the service keys the plugin `inject`s: its `cordis.yml` tree must also load providers for those services. Scope is the harness tier (`packages/`); the vendored cordis plugins a config tree may also load (`hmr`, the console logger, …) are pinned upstream source ([vendoring policy](../vendor/README.md)) and not catalogued here.
10
+ A `Requires:` line lists the service keys the plugin `inject`s: its `cordis.yml` tree must also load providers for those services. Scope is the harness tier (`packages/`); the vendored cordis plugins a config tree may also load (the console logger, …) are pinned upstream source ([vendoring policy](../vendor/README.md)) and not catalogued here.
11
11
 
12
12
  <a id="deepseek-aidsh-acp"></a>
13
13
 
@@ -213,7 +213,7 @@ export interface Config {
213
213
  }
214
214
  ```
215
215
 
216
- Source: [`packages/api/session-controller/src/index.ts:69`](../packages/api/session-controller/src/index.ts)
216
+ Source: [`packages/api/session-controller/src/index.ts:71`](../packages/api/session-controller/src/index.ts)
217
217
 
218
218
  <a id="deepseek-aidsh-api-settings-controller"></a>
219
219
 
@@ -229,6 +229,79 @@ export interface Config {
229
229
 
230
230
  Source: [`packages/api/settings-controller/src/index.ts:36`](../packages/api/settings-controller/src/index.ts)
231
231
 
232
+ <a id="deepseek-aidsh-api-terminal-controller"></a>
233
+
234
+ ## `@deepseek-ai/dsh-api-terminal-controller`
235
+
236
+ Requires: `subprocess` · `sandboxPolicy` · `typert`
237
+
238
+ ```ts config-catalog
239
+ /** Deployment limits and an optional shell profile. */
240
+ export interface Config {
241
+ /** Explicit shell profile; omission uses the execution environment's default shell. */
242
+ readonly shell?: {
243
+ /** Executable path or PATH name, verified by the subprocess provider. */
244
+ path: string
245
+ /** User-visible profile name. */
246
+ name: string
247
+ /** Arguments passed to the interactive shell. */
248
+ args: string[]
249
+ } | undefined
250
+ /** Executable names or paths checked for the new-terminal shell selector. */
251
+ readonly shellCandidates: string[]
252
+ /** Maximum retained terminals and pending allocations per Session. */
253
+ readonly maxTerminals: number
254
+ /** Maximum terminal width in columns. */
255
+ readonly maxCols: number
256
+ /** Maximum terminal height in rows. */
257
+ readonly maxRows: number
258
+ /** Screen history rows retained for reconnecting clients. */
259
+ readonly scrollback: number
260
+ /** Maximum queued UTF-8 frame bytes per output follower before disconnection. */
261
+ readonly maxBufferedBytes: number
262
+ /** Maximum UTF-8 bytes in one input request. */
263
+ readonly maxInputBytes: number
264
+ /** Provider process-termination grace period in milliseconds. */
265
+ readonly disposeGraceMs: number
266
+ /** Continuous confirmed idle time without window holds before reclamation; zero disables reclamation. */
267
+ readonly unattendedTimeoutMs: number
268
+ /** Interval between unattended shell and process observations. */
269
+ readonly activityPollIntervalMs: number
270
+ /** Delay before retrying failed owned terminal cleanup. */
271
+ readonly cleanupRetryMs: number
272
+ }
273
+ ```
274
+
275
+ Source: [`packages/api/terminal-controller/src/index.ts:26`](../packages/api/terminal-controller/src/index.ts)
276
+
277
+ <a id="deepseek-aidsh-api-workspace-files"></a>
278
+
279
+ ## `@deepseek-ai/dsh-api-workspace-files`
280
+
281
+ Requires: `fs` · `sandboxPolicy` · `sessions` · `typert`
282
+
283
+ ```ts config-catalog
284
+ /** Deployment caps on one page or one listing. */
285
+ export interface Config {
286
+ /**
287
+ * Inclusive byte cap on one page's text and on one byte window.
288
+ *
289
+ * A page above this fails; it is not shortened, because a silently cut page
290
+ * reads as the whole page. A byte window asking for more is refused the same
291
+ * way. The file itself has no size cap: a caller pages through it.
292
+ */
293
+ readonly maxBytes: number
294
+ /** Inclusive byte cap on a complete-file read; larger files are refused, never truncated. */
295
+ readonly maxFileBytes: number
296
+ /** Default and largest page size in lines; a request asking for more is refused. */
297
+ readonly maxLines: number
298
+ /** Cap on returned directory entries; the rest is dropped and reported cut. */
299
+ readonly maxEntries: number
300
+ }
301
+ ```
302
+
303
+ Source: [`packages/api/workspace-files/src/index.ts:69`](../packages/api/workspace-files/src/index.ts)
304
+
232
305
  <a id="deepseek-aidsh-attachment-local"></a>
233
306
 
234
307
  ## `@deepseek-ai/dsh-attachment-local`
@@ -309,17 +382,19 @@ export type Config = LocalConfig
309
382
 
310
383
  Depends on: [`LocalConfig`](#deepseek-aidsh-bash-local)
311
384
 
312
- Source: [`packages/shell/bash-sandbox/src/index.ts:35`](../packages/shell/bash-sandbox/src/index.ts)
385
+ Source: [`packages/shell/bash-sandbox/src/index.ts:36`](../packages/shell/bash-sandbox/src/index.ts)
313
386
 
314
387
  <a id="deepseek-aidsh-client-connection"></a>
315
388
 
316
389
  ## `@deepseek-ai/dsh-client-connection`
317
390
 
318
- Requires: `webServer` · `credentials`
391
+ Requires: `credentials`
319
392
 
320
393
  ```ts config-catalog
321
- /** Plugin config: the deployment's non-loopback serving authorities. */
394
+ /** Browser authentication, request limits, and connection recovery configuration. */
322
395
  export interface ConnectionConfig {
396
+ /** Browser recovery timing, injected into each served page. */
397
+ recovery?: ConnectionRecoveryConfig
323
398
  /**
324
399
  * Authorities this deployment serves beyond loopback: exact `host:port`, or
325
400
  * port-less `host` matching any port. The /api trust fence refuses any
@@ -334,9 +409,26 @@ export interface ConnectionConfig {
334
409
  /** Maximum buffered JSON body for every `/api` request. Default: 300 MiB. */
335
410
  maxRequestBodyBytes?: number
336
411
  }
412
+
413
+ /** Timing for generation readiness and automatic reconnection. */
414
+ export interface ConnectionRecoveryConfig {
415
+ /** First-retry delay cap in ms; actual delay is 50–100% of the cap. Default: 500. */
416
+ backoffBaseMs?: number
417
+ /** Finite growth factor of at least 1 per failed attempt; 1 keeps a fixed cap. Default: 2. */
418
+ backoffFactor?: number
419
+ /** Maximum retry delay cap in ms; retries continue at this cap. Default: 10000. */
420
+ backoffMaxMs?: number
421
+ /**
422
+ * Delay before reporting a slow handshake, without cancelling it. Default: 3000.
423
+ * Omitted when readiness, failure, cancellation, or the hard deadline occurs first.
424
+ */
425
+ generationReadyWarnMs?: number
426
+ /** Deadline in ms for readiness, including physical connection setup. Default: 15000. */
427
+ generationReadyTimeoutMs?: number
428
+ }
337
429
  ```
338
430
 
339
- Source: [`packages/client/connection/src/index.ts:71`](../packages/client/connection/src/index.ts)
431
+ Source: [`packages/client/connection/src/index.ts:87`](../packages/client/connection/src/index.ts)
340
432
 
341
433
  <a id="deepseek-aidsh-client-hmr"></a>
342
434
 
@@ -352,44 +444,30 @@ export interface Config {
352
444
  }
353
445
  ```
354
446
 
355
- Source: [`packages/client/hmr/src/index.ts:31`](../packages/client/hmr/src/index.ts)
447
+ Source: [`packages/client/hmr/src/index.ts:30`](../packages/client/hmr/src/index.ts)
356
448
 
357
- <a id="deepseek-aidsh-code-runtime-worker-thread"></a>
449
+ <a id="deepseek-aidsh-client-ui-sidebar-documentpreview"></a>
358
450
 
359
- ## `@deepseek-ai/dsh-code-runtime-worker-thread`
451
+ ## `@deepseek-ai/dsh-client-ui-sidebar-documentpreview`
360
452
 
361
453
  ```ts config-catalog
362
- /** Plugin config: every execution cap, changeable from `cordis.yml` (no hardcoded tunables). */
454
+ /** Transient Office conversion reuse within one Client connection. */
363
455
  export interface Config {
364
- /**
365
- * Busy-time budget in milliseconds: the run fails with kind `'timeout'`
366
- * once the worker's MEASURED event-loop active time
367
- * (`worker.performance.eventLoopUtilization()`) exceeds this. Metering
368
- * measured busy time not wall time, not host-side pending-call
369
- * bookkeeping — is what makes the budget both fair (a program awaiting a
370
- * slow tool accrues nothing) and ungameable (a hot loop accrues whether
371
- * or not a decoy dispatch is in flight).
372
- */
373
- computeMs?: number
374
- /**
375
- * Wall-clock ceiling in milliseconds; never pauses for anything. The
376
- * backstop for what busy-time cannot see (a program awaiting a promise
377
- * nobody will resolve). At most `2_147_483_647` (Node's maximum
378
- * `setTimeout` delay, about 24.9 days): a longer value is rejected at load
379
- * because `setTimeout` would clamp it to 1 ms.
380
- */
381
- maxWallMs?: number
382
- /**
383
- * Hard cap for serialized log-array, completion-value, and failure-message payloads;
384
- * fixed result-envelope syntax is excluded.
385
- */
386
- maxOutputBytes?: number
387
- /** The worker's max old-generation heap in MiB (`resourceLimits`); overflow kills the worker, surfacing as kind `'worker-exit'`. */
388
- maxOldGenerationSizeMb?: number
456
+ /** Retained PDF limits; pending conversions share cancellation by reader lifetime. */
457
+ office: {
458
+ /** Maximum retained completed PDFs. */
459
+ maxCachedEntries: number
460
+ /** Maximum retained PDF bytes, counted by each binary buffer's byteLength. */
461
+ maxCachedBytes: number
462
+ /** Maximum unsettled Host conversion RPCs, including cancellation teardown. */
463
+ maxPending: number
464
+ /** Maximum readers including source and renderer metadata lookups. */
465
+ maxReaders: number
466
+ }
389
467
  }
390
468
  ```
391
469
 
392
- Source: [`packages/code-runtime/code-runtime-worker-thread/src/index.ts:25`](../packages/code-runtime/code-runtime-worker-thread/src/index.ts)
470
+ Source: [`packages/client/ui-sidebar-documentpreview/src/config.ts:5`](../packages/client/ui-sidebar-documentpreview/src/config.ts)
393
471
 
394
472
  <a id="deepseek-aidsh-compaction-basic"></a>
395
473
 
@@ -493,24 +571,6 @@ export interface Config {
493
571
 
494
572
  Source: [`packages/credentials/credentials-local/src/index.ts:64`](../packages/credentials/credentials-local/src/index.ts)
495
573
 
496
- <a id="deepseek-aidsh-e2b"></a>
497
-
498
- ## `@deepseek-ai/dsh-e2b`
499
-
500
- ```ts config-catalog
501
- /** Configuration for the shared E2B sandbox owner. */
502
- export interface Config {
503
- /** API key; omission reads `E2B_API_KEY`. It is never forwarded into the sandbox. */
504
- apiKey?: string
505
- /** Shared remote working directory, created before adapters receive the sandbox. */
506
- cwd?: string
507
- /** E2B sandbox lifetime in milliseconds; expiry always deletes the sandbox. */
508
- timeoutMs?: number
509
- }
510
- ```
511
-
512
- Source: [`packages/e2b/e2b/src/index.ts:45`](../packages/e2b/e2b/src/index.ts)
513
-
514
574
  <a id="deepseek-aidsh-experimental-agent-team"></a>
515
575
 
516
576
  ## `@deepseek-ai/dsh-experimental-agent-team`
@@ -535,72 +595,101 @@ export interface Config {
535
595
 
536
596
  Source: [`packages/experimental/agent-team/src/types.ts:130`](../packages/experimental/agent-team/src/types.ts)
537
597
 
538
- <a id="deepseek-aidsh-experimental-code-runtime-python"></a>
598
+ <a id="deepseek-aidsh-experimental-browser-use-chrome-devtools-mcp"></a>
599
+
600
+ ## `@deepseek-ai/dsh-experimental-browser-use-chrome-devtools-mcp`
539
601
 
540
- ## `@deepseek-ai/dsh-experimental-code-runtime-python`
602
+ Requires: `browserUse` · `agents` · `tools` · `systemPrompt`
541
603
 
542
604
  ```ts config-catalog
543
- /** Plugin config: every cap, changeable from `cordis.yml` (no hardcoded tunables). */
605
+ /** Fixed Chromium launch or existing-browser attachment settings. */
606
+ export type Config = BrowserMcpConfig
607
+ ```
608
+
609
+ Depends on: `BrowserMcpConfig` (`@deepseek-ai/dsh-experimental-browser-use-runtime/mcp`)
610
+
611
+ Source: [`packages/experimental/browser-use-chrome-devtools-mcp/src/index.ts:14`](../packages/experimental/browser-use-chrome-devtools-mcp/src/index.ts)
612
+
613
+ <a id="deepseek-aidsh-experimental-browser-use-playwright-mcp"></a>
614
+
615
+ ## `@deepseek-ai/dsh-experimental-browser-use-playwright-mcp`
616
+
617
+ Requires: `browserUse` · `agents` · `tools` · `systemPrompt`
618
+
619
+ ```ts config-catalog
620
+ /** Fixed Chromium launch or existing-browser attachment settings. */
621
+ export type Config = BrowserMcpConfig
622
+ ```
623
+
624
+ Depends on: `BrowserMcpConfig` (`@deepseek-ai/dsh-experimental-browser-use-runtime/mcp`)
625
+
626
+ Source: [`packages/experimental/browser-use-playwright-mcp/src/index.ts:15`](../packages/experimental/browser-use-playwright-mcp/src/index.ts)
627
+
628
+ <a id="deepseek-aidsh-experimental-browser-use-stagehand-native"></a>
629
+
630
+ ## `@deepseek-ai/dsh-experimental-browser-use-stagehand-native`
631
+
632
+ Requires: `browserUse` · `agents` · `tools` · `systemPrompt`
633
+
634
+ ```ts config-catalog
635
+ /** Profile-owned browser connection and independent Stagehand model credentials. */
544
636
  export interface Config {
545
- /**
546
- * RLIMIT_CPU in whole seconds (a positive integer — `setrlimit` in the child
547
- * rejects a float). The child sets the soft limit to `cpuSeconds` and the
548
- * hard limit to `cpuSeconds + 1`: the kernel delivers SIGXCPU at the soft
549
- * limit, which the host classifies as a `timeout`; the +1s hard limit is a
550
- * SIGKILL backstop for a program that traps SIGXCPU. Granularity is seconds —
551
- * a coarser counterpart to the worker backend's millisecond `computeMs`.
552
- */
553
- cpuSeconds?: number
554
- /** Wall-clock ceiling in milliseconds; backstops CPU time for programs awaiting a promise nobody resolves. */
555
- maxWallMs?: number
556
- /**
557
- * RLIMIT_AS in mebibytes; caps address space so a runaway allocation fails
558
- * cleanly. Not applied on Darwin, where the dyld shared cache mapped into
559
- * every process at exec exceeds any practical cap and the kernel rejects
560
- * the call; `cpuSeconds` and `maxWallMs` still bound the run there. Bounds
561
- * `maxLogBytes`/`maxValueBytes` at load on EVERY platform (this static check
562
- * runs on Darwin too, where only the runtime `setrlimit` is skipped): each
563
- * budget times a worst-case Unicode expansion must fit this byte count minus a
564
- * fixed interpreter baseline, so a near-budget output cannot breach the address
565
- * space during the child's build-and-encode.
566
- */
567
- addressSpaceMb?: number
568
- /**
569
- * Shared byte budget for captured log text (host-side ledger). Bounded at load
570
- * against `addressSpaceMb`: the child builds and encodes a near-budget entry
571
- * under RLIMIT_AS with several copies live at once, so this cap times the
572
- * worst-case Unicode expansion must fit the address space left after the
573
- * interpreter baseline (see `addressSpaceMb`) — a load-time rejection, not a
574
- * runtime clamp. Also bounded at load by the host's configured heap like
575
- * `maxValueBytes` (see its JSDoc): the effective frame cap minus the frame
576
- * envelope.
577
- */
578
- maxLogBytes?: number
579
- /**
580
- * Byte cap for the completion value. Bounded at load against `addressSpaceMb`
581
- * the same way `maxLogBytes` is: the child builds and encodes a near-budget
582
- * value under RLIMIT_AS with several copies live at once, so this cap times the
583
- * worst-case Unicode expansion must fit the address space left after the
584
- * interpreter baseline. Both budgets are ALSO bounded at load by the host's
585
- * configured heap: the effective frame cap (the protocol cap, or a lower
586
- * heap-derived ceiling when the host heap cannot safely parse a near-cap
587
- * frame — see `hostFrameParseCeiling`) minus the frame envelope, so a budget
588
- * whose honest frame could OOM the host's own JSON.parse is rejected up
589
- * front.
590
- */
591
- maxValueBytes?: number
592
- /** SIGTERM→SIGKILL grace period on kill, matching bash-local's default. */
593
- graceMs?: number
594
- /**
595
- * Absolute path, relative path, or basename of a CPython 3.10+ interpreter.
596
- * Resolved and validated once at plugin load under a five-second force-kill
597
- * deadline; a basename searches `PATH`.
598
- */
599
- pythonBin?: string
637
+ /** Native Stagehand model and credentials; independent of the Session model. */
638
+ model: StagehandModelConfig
639
+ /** Launch a fresh browser or attach to the configured existing endpoint. */
640
+ mode: 'launch' | 'attach'
641
+ /** CDP HTTP or WebSocket endpoint, required only for attach mode. */
642
+ cdpEndpoint?: string
643
+ /** Optional Stagehand extension id for an existing browser. */
644
+ extensionId?: string
645
+ /** Installed Chrome/Chromium executable used in launch mode. */
646
+ executablePath?: string
647
+ /** Hide an owned browser's window. */
648
+ headless?: boolean
649
+ /** Deadline for Chromium startup and Stagehand navigation/action operations. */
650
+ operationTimeoutMs?: number
651
+ /** Grace for native SDK cleanup before its connection Worker is terminated. */
652
+ shutdownGraceMs?: number
653
+ }
654
+
655
+ /** Profile-owned model settings accepted by the pinned Stagehand SDK. */
656
+ export interface StagehandModelConfig {
657
+ /** Provider-prefixed model name from Stagehand's supported model catalog. */
658
+ modelName: ModelConfig['modelName']
659
+ /** Explicit API key sent to Stagehand's browser extension. */
660
+ apiKey: string
661
+ /** Additional headers sent with the extension's model requests. */
662
+ headers?: Record<string, string>
600
663
  }
601
664
  ```
602
665
 
603
- Source: [`packages/experimental/code-runtime-python/src/index.ts:42`](../packages/experimental/code-runtime-python/src/index.ts)
666
+ Depends on: `ModelConfig` (`@browserbasehq/stagehand`)
667
+
668
+ Source: [`packages/experimental/browser-use-stagehand-native/src/index.ts:28`](../packages/experimental/browser-use-stagehand-native/src/index.ts)
669
+
670
+ <a id="deepseek-aidsh-experimental-computer-use-cua-driver-mcp"></a>
671
+
672
+ ## `@deepseek-ai/dsh-experimental-computer-use-cua-driver-mcp`
673
+
674
+ Requires: `computerUse` · `tools`
675
+
676
+ ```ts config-catalog
677
+ /** Installed executable and MCP connection overrides. */
678
+ export interface Config {
679
+ /** Executable path or PATH command; defaults to `cua-driver`. */
680
+ command: string
681
+ /** Arguments passed without a shell; defaults to `['mcp']`. */
682
+ args: string[]
683
+ /** Per-call timeout in milliseconds; omission uses the MCP client's default. */
684
+ toolCallTimeoutMs?: number
685
+ /** Reconnection overrides; defaults to the MCP client's policy. */
686
+ reconnect: McpClient.ReconnectConfig
687
+ }
688
+ ```
689
+
690
+ Depends on: [`McpClient`](../packages/mcp/mcp-client/src/index.ts)
691
+
692
+ Source: [`packages/experimental/computer-use-cua-driver-mcp/src/index.ts:20`](../packages/experimental/computer-use-cua-driver-mcp/src/index.ts)
604
693
 
605
694
  <a id="deepseek-aidsh-experimental-inspector"></a>
606
695
 
@@ -670,6 +759,72 @@ export interface InspectorOptions {
670
759
 
671
760
  Source: [`packages/experimental/inspector/src/index.ts:66`](../packages/experimental/inspector/src/index.ts)
672
761
 
762
+ <a id="deepseek-aidsh-experimental-ptc-runtime-python"></a>
763
+
764
+ ## `@deepseek-ai/dsh-experimental-ptc-runtime-python`
765
+
766
+ ```ts config-catalog
767
+ /** Plugin config: every cap, changeable from `cordis.yml` (no hardcoded tunables). */
768
+ export interface Config {
769
+ /**
770
+ * RLIMIT_CPU in whole seconds (a positive integer — `setrlimit` in the child
771
+ * rejects a float). The child sets the soft limit to `cpuSeconds` and the
772
+ * hard limit to `cpuSeconds + 1`: the kernel delivers SIGXCPU at the soft
773
+ * limit, which the host classifies as a `timeout`; the +1s hard limit is a
774
+ * SIGKILL backstop for a program that traps SIGXCPU. Granularity is whole seconds.
775
+ */
776
+ cpuSeconds?: number
777
+ /** Wall-clock ceiling in milliseconds; backstops CPU time for programs awaiting a promise nobody resolves. */
778
+ maxWallMs?: number
779
+ /**
780
+ * RLIMIT_AS in mebibytes; caps address space so a runaway allocation fails
781
+ * cleanly. Not applied on Darwin, where the dyld shared cache mapped into
782
+ * every process at exec exceeds any practical cap and the kernel rejects
783
+ * the call; `cpuSeconds` and `maxWallMs` still bound the run there. Bounds
784
+ * `maxLogBytes`/`maxValueBytes` at load on EVERY platform (this static check
785
+ * runs on Darwin too, where only the runtime `setrlimit` is skipped): each
786
+ * budget times a worst-case Unicode expansion must fit this byte count minus a
787
+ * fixed interpreter baseline, so a near-budget output cannot breach the address
788
+ * space during the child's build-and-encode.
789
+ */
790
+ addressSpaceMb?: number
791
+ /**
792
+ * Shared byte budget for captured log text (host-side ledger). Bounded at load
793
+ * against `addressSpaceMb`: the child builds and encodes a near-budget entry
794
+ * under RLIMIT_AS with several copies live at once, so this cap times the
795
+ * worst-case Unicode expansion must fit the address space left after the
796
+ * interpreter baseline (see `addressSpaceMb`) — a load-time rejection, not a
797
+ * runtime clamp. Also bounded at load by the host's configured heap like
798
+ * `maxValueBytes` (see its JSDoc): the effective frame cap minus the frame
799
+ * envelope.
800
+ */
801
+ maxLogBytes?: number
802
+ /**
803
+ * Byte cap for the completion value. Bounded at load against `addressSpaceMb`
804
+ * the same way `maxLogBytes` is: the child builds and encodes a near-budget
805
+ * value under RLIMIT_AS with several copies live at once, so this cap times the
806
+ * worst-case Unicode expansion must fit the address space left after the
807
+ * interpreter baseline. Both budgets are ALSO bounded at load by the host's
808
+ * configured heap: the effective frame cap (the protocol cap, or a lower
809
+ * heap-derived ceiling when the host heap cannot safely parse a near-cap
810
+ * frame — see `hostFrameParseCeiling`) minus the frame envelope, so a budget
811
+ * whose honest frame could OOM the host's own JSON.parse is rejected up
812
+ * front.
813
+ */
814
+ maxValueBytes?: number
815
+ /** SIGTERM→SIGKILL grace period on kill, matching bash-local's default. */
816
+ graceMs?: number
817
+ /**
818
+ * Absolute path, relative path, or basename of a CPython 3.10+ interpreter.
819
+ * Resolved and validated once at plugin load under a five-second force-kill
820
+ * deadline; a basename searches `PATH`.
821
+ */
822
+ pythonBin?: string
823
+ }
824
+ ```
825
+
826
+ Source: [`packages/experimental/ptc-runtime-python/src/index.ts:42`](../packages/experimental/ptc-runtime-python/src/index.ts)
827
+
673
828
  <a id="deepseek-aidsh-experimental-tool-agent-team"></a>
674
829
 
675
830
  ## `@deepseek-ai/dsh-experimental-tool-agent-team`
@@ -725,7 +880,7 @@ export interface Config {
725
880
  }
726
881
  ```
727
882
 
728
- Source: [`packages/fs/fs-local/src/index.ts:41`](../packages/fs/fs-local/src/index.ts)
883
+ Source: [`packages/fs/fs-local/src/index.ts:43`](../packages/fs/fs-local/src/index.ts)
729
884
 
730
885
  <a id="deepseek-aidsh-fs-sandbox"></a>
731
886
 
@@ -770,14 +925,40 @@ Source: [`packages/goal/goal/src/index.ts:172`](../packages/goal/goal/src/index.
770
925
  Requires: `agentDefaultModel` · `agents` · `sessions`
771
926
 
772
927
  ```ts config-catalog
773
- /** Plugin config: the task resolved from this app's injected provider service. */
928
+ /** Plugin config: the task and run options resolved from this app's injected provider service. */
774
929
  export interface Config {
775
- /** The prompt text for the single run. */
776
- task: string
930
+ /** The prompt text for the single run; absent when the task arrives on stdin. */
931
+ task?: string
932
+ /** Exact Session identity to adopt; absent for a fresh random identity. An id with no stored Session fails. */
933
+ sessionId?: string
934
+ /** Whether stdout carries the machine-readable event stream instead of final text. */
935
+ json?: boolean
777
936
  }
778
937
  ```
779
938
 
780
- Source: [`packages/bundle/headless/src/index.ts:34`](../packages/bundle/headless/src/index.ts)
939
+ Source: [`packages/bundle/headless/src/index.ts:42`](../packages/bundle/headless/src/index.ts)
940
+
941
+ <a id="deepseek-aidsh-hmr"></a>
942
+
943
+ ## `@deepseek-ai/dsh-hmr`
944
+
945
+ ```ts config-catalog
946
+ /** Module roots and watcher timing, with Chokidar deployment options. */
947
+ export interface HmrConfig extends ChokidarOptions {
948
+ /** Directory resolved against the owning context's base URL. */
949
+ base?: string
950
+ /** Module watch roots; an empty list leaves only explicit configuration watches. */
951
+ root: string[]
952
+ /** Milliseconds for combining module changes. */
953
+ debounce: number
954
+ /** Glob patterns excluded from module watching. */
955
+ ignored: string[]
956
+ }
957
+ ```
958
+
959
+ Depends on: `ChokidarOptions` (`chokidar`)
960
+
961
+ Source: [`packages/boot/hmr/src/index.ts:51`](../packages/boot/hmr/src/index.ts)
781
962
 
782
963
  <a id="deepseek-aidsh-hooks-claude-code"></a>
783
964
 
@@ -815,7 +996,7 @@ export interface Config {
815
996
  }
816
997
  ```
817
998
 
818
- Source: [`packages/hooks/hooks-claude-code/src/index.ts:45`](../packages/hooks/hooks-claude-code/src/index.ts)
999
+ Source: [`packages/hooks/hooks-claude-code/src/index.ts:44`](../packages/hooks/hooks-claude-code/src/index.ts)
819
1000
 
820
1001
  <a id="deepseek-aidsh-hooks-codex"></a>
821
1002
 
@@ -842,7 +1023,7 @@ export interface Config {
842
1023
  }
843
1024
  ```
844
1025
 
845
- Source: [`packages/hooks/hooks-codex/src/index.ts:44`](../packages/hooks/hooks-codex/src/index.ts)
1026
+ Source: [`packages/hooks/hooks-codex/src/index.ts:43`](../packages/hooks/hooks-codex/src/index.ts)
846
1027
 
847
1028
  <a id="deepseek-aidsh-host-directory-picker-browse"></a>
848
1029
 
@@ -874,6 +1055,37 @@ export interface Config {
874
1055
 
875
1056
  Source: [`packages/host/frontend-static/src/index.ts:30`](../packages/host/frontend-static/src/index.ts)
876
1057
 
1058
+ <a id="deepseek-aidsh-host-open-in-app"></a>
1059
+
1060
+ ## `@deepseek-ai/dsh-host-open-in-app`
1061
+
1062
+ Requires: `webServer` · `connection` · `subprocess`
1063
+
1064
+ ```ts config-catalog
1065
+ /** Open-in-app host configuration. */
1066
+ export interface Config {
1067
+ /**
1068
+ * Per-command deadline in milliseconds for catalog-resolution host
1069
+ * commands (`xcode-select`, the Windows registry reads).
1070
+ */
1071
+ readonly probeTimeoutMs: number
1072
+ /**
1073
+ * Per-command deadline in milliseconds for icon-extraction host commands
1074
+ * (`plutil`/`sips` on macOS, the PowerShell extraction on Windows).
1075
+ */
1076
+ readonly iconTimeoutMs: number
1077
+ /**
1078
+ * Early-failure watch window per launch, in milliseconds: a launcher still
1079
+ * running when the window closes counts as launched and keeps running, so
1080
+ * this bounds how long the open route holds a successful launch, not how
1081
+ * long an application may live.
1082
+ */
1083
+ readonly launchWatchMs: number
1084
+ }
1085
+ ```
1086
+
1087
+ Source: [`packages/host/open-in-app/src/index.ts:50`](../packages/host/open-in-app/src/index.ts)
1088
+
877
1089
  <a id="deepseek-aidsh-host-webserver"></a>
878
1090
 
879
1091
  ## `@deepseek-ai/dsh-host-webserver`
@@ -947,6 +1159,8 @@ Requires: `llm`
947
1159
  * reasoning effort resolves to `high`.
948
1160
  */
949
1161
  export interface Config {
1162
+ /** Wire protocol; defaults to messages. Configure through Cordis YAML. */
1163
+ protocol?: DeepSeekProtocol
950
1164
  /** Credential reference (environment-variable name) resolved per request; defaults to `DEEPSEEK_API_KEY`. */
951
1165
  apiKeyEnv?: string
952
1166
  /** Endpoint base; falls back to $DEEPSEEK_BASE_URL from a trusted environment layer, then the public API. */
@@ -959,7 +1173,7 @@ export interface Config {
959
1173
  maxTokens?: number
960
1174
  /** Positive context capacity used when the selected model has no exact value (default 1,000,000). */
961
1175
  defaultContextWindow?: number
962
- /** Advisory models shown by discovery consumers; defaults to V4 Flash, V4 Pro, and V4 Flash Vision Exp. */
1176
+ /** Advisory models shown by discovery consumers; defaults to V41 Flash and V4 Pro. */
963
1177
  models?: DeepSeekCatalogModel[]
964
1178
  /** Maximum provider idle time while one stream read is outstanding (default five minutes). */
965
1179
  streamIdleTimeoutMs?: number
@@ -987,6 +1201,9 @@ export interface Config {
987
1201
  retryPolicy?: RetryPolicyConfig
988
1202
  }
989
1203
 
1204
+ /** Supported wire implementations; Responses is not yet implemented. */
1205
+ export type DeepSeekProtocol = 'chat-completions' | 'messages'
1206
+
990
1207
  /** One optional model entry advertised by the direct-fetch adapter. */
991
1208
  export interface DeepSeekCatalogModel {
992
1209
  /** Wire model id accepted by the configured endpoint. */
@@ -1001,16 +1218,26 @@ export interface DeepSeekCatalogModel {
1001
1218
  maxTokens?: number
1002
1219
  /** Accepted request modalities; omission is text-only. */
1003
1220
  inputModalities?: ModelModality[]
1004
- /** Total-pixel budget for one deterministic request preview, or the 512-by-512 `low` preset. */
1221
+ /**
1222
+ * Total-pixel budget replacing the published token-grid projection for one
1223
+ * deterministic request preview, or the 512-by-512 `low` preset; omission
1224
+ * projects onto the token grid.
1225
+ */
1005
1226
  imagePixelBudget?: number | 'low'
1006
1227
  /** Encoded-byte target for one deterministic request preview; the smallest quality-ladder output is used when no quality fits. */
1007
1228
  imageMaxBytes?: number
1229
+ /**
1230
+ * `'in-history'` declares that the endpoint reads the latest `system`
1231
+ * message at any position of the conversation as the complete effective
1232
+ * system prompt; omission means only a leading system message is read.
1233
+ */
1234
+ systemPromptUpdate?: SystemPromptUpdate
1008
1235
  }
1009
1236
  ```
1010
1237
 
1011
- Depends on: [`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts)
1238
+ Depends on: [`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts)
1012
1239
 
1013
- Source: [`packages/llm/llm-deepseek/src/index.ts:125`](../packages/llm/llm-deepseek/src/index.ts)
1240
+ Source: [`packages/llm/llm-deepseek/src/config.ts:25`](../packages/llm/llm-deepseek/src/config.ts)
1014
1241
 
1015
1242
  <a id="deepseek-aidsh-llm-pi-ai"></a>
1016
1243
 
@@ -1229,8 +1456,14 @@ export interface PiAiCompatProfile {
1229
1456
  chatTemplateKwargs?: NonNullable<OpenAICompletionsCompat['chatTemplateKwargs']>
1230
1457
  /** Arguments sent as `chat_template_args` under the `baseten` thinking format; `openai-completions`. */
1231
1458
  chatTemplateArgs?: NonNullable<OpenAICompletionsCompat['chatTemplateArgs']>
1232
- /** Whether the endpoint accepts `thinking_token_budget` to cap vLLM reasoning; `openai-completions`. */
1459
+ /** Alias for `thinkingTokenBudgetField: "thinking_token_budget"`; an explicit field wins. `openai-completions`. */
1233
1460
  supportsThinkingTokenBudget?: boolean
1461
+ /** Request field carrying the reasoning budget from `thinkingBudgets`; omitted unless configured. `openai-completions`. */
1462
+ thinkingTokenBudgetField?: PiAiThinkingTokenBudgetField
1463
+ /** vLLM scheduler `priority`; lower runs earlier, and the server must enable priority scheduling. Omitted unless configured. */
1464
+ vllmPriority?: number
1465
+ /** Whether `openai-responses` accepts `max_output_tokens`; `false` omits it. Azure and Codex ignore this shared compat field. */
1466
+ supportsMaxOutputTokens?: boolean
1234
1467
  /**
1235
1468
  * Whether the endpoint accepts `strict` in tool definitions;
1236
1469
  * `openai-completions`, the three Responses protocols, `bedrock-converse-stream`.
@@ -1272,11 +1505,14 @@ export type PiAiReasoningEfforts = Partial<Record<ModelThinkingLevel, string | n
1272
1505
 
1273
1506
  /** One reasoning-dispatch wire format a profile may name. */
1274
1507
  export type PiAiThinkingFormat = NonNullable<OpenAICompletionsCompat['thinkingFormat']>
1508
+
1509
+ /** The reasoning-budget field spellings pi-ai accepts. */
1510
+ export type PiAiThinkingTokenBudgetField = NonNullable<OpenAICompletionsCompat['thinkingTokenBudgetField']>
1275
1511
  ```
1276
1512
 
1277
1513
  Depends on: `Api` (`@earendil-works/pi-ai`) · `CacheRetention` (`@earendil-works/pi-ai`) · `Model` (`@earendil-works/pi-ai`) · `ModelThinkingLevel` (`@earendil-works/pi-ai`) · `OpenAICompletionsCompat` (`@earendil-works/pi-ai`) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · `ThinkingBudgets` (`@earendil-works/pi-ai`) · `Transport` (`@earendil-works/pi-ai`)
1278
1514
 
1279
- Source: [`packages/llm/llm-pi-ai/src/config.ts:216`](../packages/llm/llm-pi-ai/src/config.ts)
1515
+ Source: [`packages/llm/llm-pi-ai/src/config.ts:221`](../packages/llm/llm-pi-ai/src/config.ts)
1280
1516
 
1281
1517
  <a id="deepseek-aidsh-llm-replay"></a>
1282
1518
 
@@ -1348,12 +1584,14 @@ export interface ReplayModelConfig {
1348
1584
  * {@link reasoningEfforts} or call resolution rejects the route.
1349
1585
  */
1350
1586
  defaultReasoningEffort?: string
1587
+ /** Optional in-history system prompt replacement for a keyless replay route. */
1588
+ systemPromptUpdate?: SystemPromptUpdate
1351
1589
  }
1352
1590
  ```
1353
1591
 
1354
- Depends on: [`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts)
1592
+ Depends on: [`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts)
1355
1593
 
1356
- Source: [`packages/test-support/llm-replay/src/index.ts:1294`](../packages/test-support/llm-replay/src/index.ts)
1594
+ Source: [`packages/test-support/llm-replay/src/index.ts:1122`](../packages/test-support/llm-replay/src/index.ts)
1357
1595
 
1358
1596
  <a id="deepseek-aidsh-llm-retry"></a>
1359
1597
 
@@ -1438,10 +1676,12 @@ export interface StdioConfig {
1438
1676
  env: Record<string, string>
1439
1677
  /** Working directory for the child process. */
1440
1678
  cwd: string
1441
- /** Per-tool-call timeout in milliseconds. */
1679
+ /** Timeout per tool call or resource request in milliseconds. */
1442
1680
  toolCallTimeoutMs: number
1443
1681
  /** Fail plugin activation when the initial connection or tool synchronization fails. */
1444
1682
  failOnStartupError: boolean
1683
+ /** Maximum UTF-8 bytes of attributed server instructions (default 32768). */
1684
+ maxInstructionBytes?: number
1445
1685
  /** Automatic reconnect policy after a lost connection; omission uses the defaults. */
1446
1686
  reconnect?: ReconnectConfig
1447
1687
  }
@@ -1460,10 +1700,12 @@ export interface StreamableHttpConfig {
1460
1700
  url: string
1461
1701
  /** Additional headers attached to MCP requests. */
1462
1702
  headers: Record<string, string>
1463
- /** Per-tool-call timeout in milliseconds. */
1703
+ /** Timeout per tool call or resource request in milliseconds. */
1464
1704
  toolCallTimeoutMs: number
1465
1705
  /** Fail plugin activation when the initial connection or tool synchronization fails. */
1466
1706
  failOnStartupError: boolean
1707
+ /** Maximum UTF-8 bytes of attributed server instructions (default 32768). */
1708
+ maxInstructionBytes?: number
1467
1709
  /** Automatic reconnect policy after a lost connection; omission uses the defaults. */
1468
1710
  reconnect?: ReconnectConfig
1469
1711
  }
@@ -1481,13 +1723,13 @@ export interface ReconnectConfig {
1481
1723
  }
1482
1724
  ```
1483
1725
 
1484
- Source: [`packages/mcp/mcp-client/src/index.ts:98`](../packages/mcp/mcp-client/src/index.ts)
1726
+ Source: [`packages/mcp/mcp-client/src/index.ts:104`](../packages/mcp/mcp-client/src/index.ts)
1485
1727
 
1486
1728
  <a id="deepseek-aidsh-message-feedback"></a>
1487
1729
 
1488
1730
  ## `@deepseek-ai/dsh-message-feedback`
1489
1731
 
1490
- Requires: `storageDomain` · `sessionPersistence` · `sessions`
1732
+ Requires: `sessionPersistence` · `sessions`
1491
1733
 
1492
1734
  ```ts config-catalog
1493
1735
  /** Required deployment policy for optional notes. */
@@ -1497,7 +1739,57 @@ export interface Config {
1497
1739
  }
1498
1740
  ```
1499
1741
 
1500
- Source: [`packages/feedback/message-feedback/src/index.ts:50`](../packages/feedback/message-feedback/src/index.ts)
1742
+ Source: [`packages/feedback/message-feedback/src/index.ts:40`](../packages/feedback/message-feedback/src/index.ts)
1743
+
1744
+ <a id="deepseek-aidsh-office-to-pdf"></a>
1745
+
1746
+ ## `@deepseek-ai/dsh-office-to-pdf`
1747
+
1748
+ ```ts config-catalog
1749
+ /** Provider concurrency and kit rendering/font configuration. */
1750
+ export interface Config {
1751
+ /** Maximum simultaneous conversions; queued callers remain cancellable. */
1752
+ maxConcurrentConversions: number
1753
+ /** Maximum metadata-only jobs awaiting source admission. */
1754
+ maxQueuedJobs: number
1755
+ /** Maximum outstanding conversion readers. */
1756
+ maxReaders: number
1757
+ /** Maximum reserved bytes across admitted source reads and conversions. */
1758
+ maxSourceBytes: number
1759
+ /** Maximum concurrent background jobs; zero refuses speculative work. */
1760
+ maxBackgroundConversions: number
1761
+ /** Maximum retained content-addressed PDFs. */
1762
+ maxCachedEntries: number
1763
+ /** Maximum retained PDF bytes. */
1764
+ maxCachedBytes: number
1765
+ /** Maximum retained source-version aliases to cached content. */
1766
+ maxSourceEntries: number
1767
+ /** Conversion deadline in milliseconds; excludes the DSH queue. */
1768
+ timeoutMs: number
1769
+ /** Maximum authorized source bytes. */
1770
+ maxInputBytes: number
1771
+ /** Maximum complete PDF bytes. */
1772
+ maxOutputBytes: number
1773
+ /** Exported raster-image DPI. */
1774
+ maxImageResolution: number
1775
+ /** Maximum OOXML ZIP entries. */
1776
+ maxArchiveEntries: number
1777
+ /** Maximum total declared uncompressed OOXML bytes. */
1778
+ maxUncompressedBytes: number
1779
+ /** Absolute font roots; omission uses the kit's platform defaults. */
1780
+ fontDirectories?: string[]
1781
+ /** Ordered font-family preference groups; omission retains the kit defaults. */
1782
+ fontFallbacks?: string[][]
1783
+ /** Maximum physical font files indexed by each converter. */
1784
+ maxFontFiles: number
1785
+ /** Maximum individual font-file bytes. */
1786
+ maxFontFileBytes: number
1787
+ /** Maximum original font bytes loaded for a conversion. */
1788
+ maxLoadedFontBytes: number
1789
+ }
1790
+ ```
1791
+
1792
+ Source: [`packages/document/office-to-pdf/src/index.ts:31`](../packages/document/office-to-pdf/src/index.ts)
1501
1793
 
1502
1794
  <a id="deepseek-aidsh-permission-presets"></a>
1503
1795
 
@@ -1511,7 +1803,8 @@ export interface Config {
1511
1803
  /**
1512
1804
  * The preset table: name → knob bundle. Defaults to `workspace-write`
1513
1805
  * (workspace-write + ask) and `danger-full-access` (danger-full-access +
1514
- * never). The name `custom` is reserved for the derived not-a-preset state.
1806
+ * never). The names `custom` and `auto` are reserved for derived state and
1807
+ * the Auto review integration respectively.
1515
1808
  */
1516
1809
  presets?: Record<string, PresetSpec>
1517
1810
  /**
@@ -1536,7 +1829,7 @@ export interface PresetSpec {
1536
1829
 
1537
1830
  Depends on: [`ApprovalPolicy`](subsystems/approval.md) · [`SandboxMode`](subsystems/sandbox.md)
1538
1831
 
1539
- Source: [`packages/interaction/permission-presets/src/index.ts:143`](../packages/interaction/permission-presets/src/index.ts)
1832
+ Source: [`packages/interaction/permission-presets/src/index.ts:156`](../packages/interaction/permission-presets/src/index.ts)
1540
1833
 
1541
1834
  <a id="deepseek-aidsh-persona"></a>
1542
1835
 
@@ -1548,12 +1841,17 @@ Requires: `systemPrompt`
1548
1841
  /** Plugin config: the persona text this composition contributes. */
1549
1842
  export interface Config {
1550
1843
  /**
1551
- * Persona prose rendered as the `deployment:persona` section. A template:
1844
+ * Persona prose rendered as the `deployment:persona-prefix` section. A template:
1552
1845
  * complete `{{…}}` groups interpolate strictly against registered prompt
1553
1846
  * variables. Empty text drops the section at render, matching the registry.
1554
1847
  */
1555
- text: string
1556
- /** Make this persona the complete system prompt, suppressing every other section. */
1848
+ prefix: string
1849
+ /**
1850
+ * Persona suffix template rendered after first-party guidance. Omitted or empty
1851
+ * text shadows the deployment suffix away; interpolation is strict.
1852
+ */
1853
+ suffix?: string
1854
+ /** Make the prefix the complete system prompt, suppressing the suffix and every other section. */
1557
1855
  complete?: boolean
1558
1856
  /** Suppress dynamic runtime-context snapshots for this persona's agent scope. */
1559
1857
  includeRuntimeContext?: boolean
@@ -1576,7 +1874,29 @@ export interface PlanModeConfig {
1576
1874
  }
1577
1875
  ```
1578
1876
 
1579
- Source: [`packages/plan/plan-mode/src/index.ts:63`](../packages/plan/plan-mode/src/index.ts)
1877
+ Source: [`packages/plan/plan-mode/src/index.ts:64`](../packages/plan/plan-mode/src/index.ts)
1878
+
1879
+ <a id="deepseek-aidsh-plugin-manager"></a>
1880
+
1881
+ ## `@deepseek-ai/dsh-plugin-manager`
1882
+
1883
+ Requires: `loader` · `profileContext`
1884
+
1885
+ ```ts config-catalog
1886
+ /** The pnpm executable and the limits for package diagnostics and registry lookups. */
1887
+ export interface Config {
1888
+ /** The pnpm executable name or path; resolved through `PATH` like the `dsh plugin` command. */
1889
+ pnpmCommand?: string
1890
+ /** Maximum retained pnpm diagnostic bytes per operation. */
1891
+ outputBytes?: number
1892
+ /** Maximum time to wait for another process's profile package operation. */
1893
+ lockWaitMs?: number
1894
+ /** Bound on one registry lookup an inspection runs, in milliseconds. */
1895
+ inspectTimeoutMs?: number
1896
+ }
1897
+ ```
1898
+
1899
+ Source: [`packages/boot/plugin-manager/src/index.ts:33`](../packages/boot/plugin-manager/src/index.ts)
1580
1900
 
1581
1901
  <a id="deepseek-aidsh-plugin-package-inventory-deepseek"></a>
1582
1902
 
@@ -1592,7 +1912,43 @@ export interface Config {
1592
1912
  }
1593
1913
  ```
1594
1914
 
1595
- Source: [`packages/llm/plugin-package-inventory-deepseek/src/index.ts:31`](../packages/llm/plugin-package-inventory-deepseek/src/index.ts)
1915
+ Source: [`packages/llm/plugin-package-inventory-deepseek/src/index.ts:32`](../packages/llm/plugin-package-inventory-deepseek/src/index.ts)
1916
+
1917
+ <a id="deepseek-aidsh-ptc-runtime-node"></a>
1918
+
1919
+ ## `@deepseek-ai/dsh-ptc-runtime-node`
1920
+
1921
+ Requires: `fs` · `subprocess` · `sandbox` · `sandboxPolicy`
1922
+
1923
+ ```ts config-catalog
1924
+ /** Deployment-varying runtime bounds and launch choices. */
1925
+ export interface Config extends LaunchConfig {
1926
+ /** Default elapsed deadline, including nested tool and approval waits. */
1927
+ timeoutMs?: number
1928
+ /** Maximum numeric elapsed budget accepted by resolve. */
1929
+ maxTimeoutMs?: number
1930
+ /** Combined serialized logs, completion and diagnostic byte cap. */
1931
+ maxOutputBytes?: number
1932
+ /** V8 old-generation heap limit in MiB; native allocations are excluded. */
1933
+ maxOldGenerationSizeMb?: number
1934
+ /** Maximum control frame, outstanding argument and queued control-output bytes. */
1935
+ maxMessageBytes?: number
1936
+ /** Maximum simultaneous host binding calls accepted from a program. */
1937
+ maxPendingCalls?: number
1938
+ /** Managed process termination and output-drain grace in milliseconds. */
1939
+ graceMs?: number
1940
+ }
1941
+
1942
+ /** Deployment-owned Node executable and optional preinstalled built bootstrap. */
1943
+ export interface LaunchConfig {
1944
+ /** Executable in the subprocess world; defaults to the current Node executable. */
1945
+ nodeExecutable?: string
1946
+ /** Absolute preinstalled built bootstrap in the execution world. */
1947
+ bootstrapPath?: string
1948
+ }
1949
+ ```
1950
+
1951
+ Source: [`packages/ptc-runtime/ptc-runtime-node/src/index.ts:26`](../packages/ptc-runtime/ptc-runtime-node/src/index.ts)
1596
1952
 
1597
1953
  <a id="deepseek-aidsh-pwsh-local"></a>
1598
1954
 
@@ -1733,7 +2089,7 @@ export interface Config {
1733
2089
  /** File-sandbox mode a session starts from (default: `read-only`). */
1734
2090
  mode?: SandboxMode
1735
2091
  /**
1736
- * Fallback root for agentless calls and sessions without a cwd (default:
2092
+ * Absolute fallback root for agentless calls and sessions without a cwd (default:
1737
2093
  * `process.cwd()`). Normal agent calls use their session cwd instead.
1738
2094
  */
1739
2095
  workspaceRoot?: string
@@ -1742,7 +2098,7 @@ export interface Config {
1742
2098
 
1743
2099
  Depends on: [`SandboxMode`](subsystems/sandbox.md)
1744
2100
 
1745
- Source: [`packages/sandbox/sandbox-policy/src/index.ts:70`](../packages/sandbox/sandbox-policy/src/index.ts)
2101
+ Source: [`packages/sandbox/sandbox-policy/src/index.ts:71`](../packages/sandbox/sandbox-policy/src/index.ts)
1746
2102
 
1747
2103
  <a id="deepseek-aidsh-sdk-app"></a>
1748
2104
 
@@ -1793,12 +2149,12 @@ Requires: `deepseekLlmApiExtensions` · `sessions`
1793
2149
  ```ts config-catalog
1794
2150
  /** Session-log request contribution configuration. */
1795
2151
  export interface Config {
1796
- /** Contribute `dsh_session_log` to official DeepSeek requests. Defaults to `false`. */
2152
+ /** Contribute `dsh_session_log` to official DeepSeek requests. Defaults to `true`. */
1797
2153
  enabled?: boolean
1798
2154
  }
1799
2155
  ```
1800
2156
 
1801
- Source: [`packages/session/session-log-deepseek/src/index.ts:36`](../packages/session/session-log-deepseek/src/index.ts)
2157
+ Source: [`packages/session/session-log-deepseek/src/index.ts:38`](../packages/session/session-log-deepseek/src/index.ts)
1802
2158
 
1803
2159
  <a id="deepseek-aidsh-session-log-export"></a>
1804
2160
 
@@ -1817,7 +2173,7 @@ export interface Config {
1817
2173
  export type SessionLogCompressionLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
1818
2174
  ```
1819
2175
 
1820
- Source: [`packages/session-query/session-log-export/src/index.ts:45`](../packages/session-query/session-log-export/src/index.ts)
2176
+ Source: [`packages/session-query/session-log-export/src/index.ts:46`](../packages/session-query/session-log-export/src/index.ts)
1821
2177
 
1822
2178
  <a id="deepseek-aidsh-session-persistence-jsonl"></a>
1823
2179
 
@@ -1842,7 +2198,7 @@ export interface Config {
1842
2198
  export type JsonlCompression = 'zstd' | 'none'
1843
2199
  ```
1844
2200
 
1845
- Source: [`packages/session/session-persistence-jsonl/src/index.ts:86`](../packages/session/session-persistence-jsonl/src/index.ts)
2201
+ Source: [`packages/session/session-persistence-jsonl/src/index.ts:88`](../packages/session/session-persistence-jsonl/src/index.ts)
1846
2202
 
1847
2203
  <a id="deepseek-aidsh-session-projection-cache"></a>
1848
2204
 
@@ -1929,8 +2285,10 @@ export interface Config {
1929
2285
  maxReferences?: number
1930
2286
  /** Default host candidate-list limit. */
1931
2287
  candidateLimit?: number
1932
- /** Maximum rendered UTF-8 bytes for one source snapshot. */
2288
+ /** Explicit maximum rendered UTF-8 bytes per source; absent uses the model-relative budget with a 64 KiB floor. */
1933
2289
  maxReferenceBytes?: number
2290
+ /** Fraction of the model context window per source, estimated at four bytes per token; between zero and one. */
2291
+ referenceContextFraction?: number
1934
2292
  }
1935
2293
  ```
1936
2294
 
@@ -1949,7 +2307,7 @@ Requires: `sessions`
1949
2307
  * and shutdown deadline at plugin load; `DISABLED` reads neither.
1950
2308
  */
1951
2309
  export interface Config {
1952
- /** Sharing policy; defaults to local-only `DISABLED` behavior. */
2310
+ /** Defaults to `FEEDBACK_ONLY`: capture session history only when feedback is explicitly submitted. */
1953
2311
  mode?: SessionTelemetryMode
1954
2312
  /**
1955
2313
  * Passed verbatim to the SDK's OTLP/HTTP log exporter — the complete
@@ -1972,7 +2330,6 @@ export interface Config {
1972
2330
 
1973
2331
  /** Session-sharing policy selected by {@link Config.mode}. */
1974
2332
  export enum SessionTelemetryMode {
1975
- FULL = 'FULL',
1976
2333
  FEEDBACK_ONLY = 'FEEDBACK_ONLY',
1977
2334
  DISABLED = 'DISABLED',
1978
2335
  }
@@ -1980,7 +2337,7 @@ export enum SessionTelemetryMode {
1980
2337
 
1981
2338
  Depends on: `BatchLogRecordProcessorOptions` (`@opentelemetry/sdk-logs`) · `OTLPExporterNodeConfigBase` (`@opentelemetry/otlp-exporter-base`)
1982
2339
 
1983
- Source: [`packages/session/session-telemetry-otel/src/index.ts:91`](../packages/session/session-telemetry-otel/src/index.ts)
2340
+ Source: [`packages/session/session-telemetry-otel/src/index.ts:100`](../packages/session/session-telemetry-otel/src/index.ts)
1984
2341
 
1985
2342
  <a id="deepseek-aidsh-session-title"></a>
1986
2343
 
@@ -2078,7 +2435,7 @@ export interface Config {
2078
2435
  }
2079
2436
  ```
2080
2437
 
2081
- Source: [`packages/skill/skill/src/index.ts:280`](../packages/skill/skill/src/index.ts)
2438
+ Source: [`packages/skill/skill/src/index.ts:278`](../packages/skill/skill/src/index.ts)
2082
2439
 
2083
2440
  <a id="deepseek-aidsh-skill-filesystem"></a>
2084
2441
 
@@ -2118,6 +2475,22 @@ export interface Config {
2118
2475
 
2119
2476
  Source: [`packages/skill/skill-filesystem/src/index.ts:49`](../packages/skill/skill-filesystem/src/index.ts)
2120
2477
 
2478
+ <a id="deepseek-aidsh-skill-office"></a>
2479
+
2480
+ ## `@deepseek-ai/dsh-skill-office`
2481
+
2482
+ Requires: `skills`
2483
+
2484
+ ```ts config-catalog
2485
+ /** Office skill resource location. */
2486
+ export interface Config {
2487
+ /** Absolute assets directory containing the three skill folders and shared scripts; defaults to packaged assets. */
2488
+ assetRoot?: string
2489
+ }
2490
+ ```
2491
+
2492
+ Source: [`packages/skill/skill-office/src/index.ts:15`](../packages/skill/skill-office/src/index.ts)
2493
+
2121
2494
  <a id="deepseek-aidsh-spill-local"></a>
2122
2495
 
2123
2496
  ## `@deepseek-ai/dsh-spill-local`
@@ -2165,7 +2538,41 @@ export interface Config {
2165
2538
  }
2166
2539
  ```
2167
2540
 
2168
- Source: [`packages/spill/spill-policy/src/index.ts:60`](../packages/spill/spill-policy/src/index.ts)
2541
+ Source: [`packages/spill/spill-policy/src/index.ts:61`](../packages/spill/spill-policy/src/index.ts)
2542
+
2543
+ <a id="deepseek-aidsh-ssh"></a>
2544
+
2545
+ ## `@deepseek-ai/dsh-ssh`
2546
+
2547
+ ```ts config-catalog
2548
+ /** Deployment-owned SSH identity and installed helper; no model argument selects these values. */
2549
+ export interface Config {
2550
+ /** OpenSSH host alias, including its existing user, key and known-host configuration. */
2551
+ host: string
2552
+ /** Absolute remote Node executable. */
2553
+ node: string
2554
+ /** Absolute path to the installed, bundled helper entry. */
2555
+ helper: string
2556
+ /** SHA-256 of that bundled helper; mismatches refuse the connection. */
2557
+ helperHash: string
2558
+ /** Absolute remote default workspace. */
2559
+ workspace: string
2560
+ /** Optional preinstalled built PTC entry, paired with its expected digest. */
2561
+ bootstrapPath?: string
2562
+ /** SHA-256 of bootstrapPath; both fields must be supplied together. */
2563
+ bootstrapHash?: string
2564
+ /** Connection and administrative-request deadline, at most 2,147,483,647 milliseconds. */
2565
+ requestTimeoutMs?: number
2566
+ /** Maximum JSON payload bytes per helper request or response. */
2567
+ maxFrameBytes?: number
2568
+ /** Maximum ordinary requests; heartbeat and bounded resource cleanup have reserved capacity. */
2569
+ maxPending?: number
2570
+ /** Remote helper lease; loss of heartbeats starts remote managed cleanup. */
2571
+ leaseMs?: number
2572
+ }
2573
+ ```
2574
+
2575
+ Source: [`packages/ssh/ssh/src/index.ts:17`](../packages/ssh/ssh/src/index.ts)
2169
2576
 
2170
2577
  <a id="deepseek-aidsh-storage-domain"></a>
2171
2578
 
@@ -2251,6 +2658,22 @@ export type JournalMode = 'wal' | 'delete' | 'truncate' | 'persist'
2251
2658
 
2252
2659
  Source: [`packages/storage/storage-sqlite/src/index.ts:24`](../packages/storage/storage-sqlite/src/index.ts)
2253
2660
 
2661
+ <a id="deepseek-aidsh-subagent"></a>
2662
+
2663
+ ## `@deepseek-ai/dsh-subagent`
2664
+
2665
+ ```ts config-catalog
2666
+ /** Host configuration for continuable subagent capacity. */
2667
+ export interface Config {
2668
+ /** Maximum live children sharing uninterrupted continuable parent links; defaults to 8. */
2669
+ maxActiveSubagents?: number
2670
+ /** Default delegation depth for tools without an explicit limit; defaults to 1. */
2671
+ maxDepth?: number
2672
+ }
2673
+ ```
2674
+
2675
+ Source: [`packages/subagent/subagent/src/index.ts:190`](../packages/subagent/subagent/src/index.ts)
2676
+
2254
2677
  <a id="deepseek-aidsh-subagent-acp"></a>
2255
2678
 
2256
2679
  ## `@deepseek-ai/dsh-subagent-acp`
@@ -2329,7 +2752,7 @@ export interface Config {
2329
2752
  * `bypassPermissions` explicitly skips permission checks.
2330
2753
  */
2331
2754
  permissionMode?: ClaudeCodePermissionMode
2332
- /** Grace in milliseconds for Claude Code process-tree termination. */
2755
+ /** Grace in milliseconds between Claude Code managed-range termination tiers. */
2333
2756
  disposeGraceMs?: number
2334
2757
  }
2335
2758
 
@@ -2359,7 +2782,7 @@ export interface Config {
2359
2782
  env?: Record<string, string>
2360
2783
  /** Native non-interactive permission mode fixed for this Provider instance. */
2361
2784
  permissionMode?: CodexPermissionMode
2362
- /** Grace in milliseconds for app-server process-tree termination. */
2785
+ /** Grace in milliseconds between app-server managed-range termination tiers. */
2363
2786
  disposeGraceMs?: number
2364
2787
  }
2365
2788
 
@@ -2460,38 +2883,27 @@ export interface Config {
2460
2883
 
2461
2884
  Source: [`packages/subagent/subagent-spawn-in-process/src/index.ts:25`](../packages/subagent/subagent-spawn-in-process/src/index.ts)
2462
2885
 
2463
- <a id="deepseek-aidsh-subprocess-e2b"></a>
2464
-
2465
- ## `@deepseek-ai/dsh-subprocess-e2b`
2466
-
2467
- Requires: `e2b`
2468
-
2469
- ```ts config-catalog
2470
- /** Configuration for the E2B subprocess adapter. */
2471
- export interface Config {
2472
- /** Remote status/liveness poll cadence in milliseconds; each tick is one control-plane request. */
2473
- pollMs?: number
2474
- }
2475
- ```
2476
-
2477
- Source: [`packages/e2b/subprocess-e2b/src/index.ts:25`](../packages/e2b/subprocess-e2b/src/index.ts)
2478
-
2479
2886
  <a id="deepseek-aidsh-system-prompt"></a>
2480
2887
 
2481
2888
  ## `@deepseek-ai/dsh-system-prompt`
2482
2889
 
2483
2890
  ```ts config-catalog
2484
- /** Plugin config: the deployment-authored fragment of the system prompt (see {@link Config.persona} for its contract). */
2891
+ /** Plugin config: the deployment-authored fragment of the system prompt (see {@link Config.personaPrefix} for its contract). */
2485
2892
  export interface Config {
2486
2893
  /** Include the fixed DeepSeek Harness identity before the deployment persona (default true). */
2487
2894
  includeHarnessIdentity?: boolean
2488
2895
  /** Include dynamic runtime-context snapshots in model history (default true). */
2489
2896
  includeRuntimeContext?: boolean
2490
2897
  /**
2491
- * Deployment-wide order-0 persona template. A scoped section named
2492
- * `deployment:persona` shadows it; `{{variable}}` references are strict.
2898
+ * Deployment-wide persona prefix template before first-party guidance. A scoped section named
2899
+ * `deployment:persona-prefix` shadows it; `{{variable}}` references are strict.
2493
2900
  */
2494
- persona?: string
2901
+ personaPrefix?: string
2902
+ /**
2903
+ * Persona suffix template after first-party guidance. A scoped `deployment:persona-suffix`
2904
+ * section shadows it; `{{variable}}` references are strict. Defaults to empty.
2905
+ */
2906
+ personaSuffix?: string
2495
2907
  /**
2496
2908
  * Model-facing tool names in order, with {@link TOOL_ORDER_REST} exactly once.
2497
2909
  * Invalid fields fail at load and unknown names fail at assembly; known names
@@ -2501,7 +2913,7 @@ export interface Config {
2501
2913
  }
2502
2914
  ```
2503
2915
 
2504
- Source: [`packages/core/system-prompt/src/index.ts:237`](../packages/core/system-prompt/src/index.ts)
2916
+ Source: [`packages/core/system-prompt/src/index.ts:248`](../packages/core/system-prompt/src/index.ts)
2505
2917
 
2506
2918
  <a id="deepseek-aidsh-terminal-bash"></a>
2507
2919
 
@@ -2636,7 +3048,7 @@ export interface Config {
2636
3048
  }
2637
3049
  ```
2638
3050
 
2639
- Source: [`packages/shell/tool-bash-persistent/src/index.ts:432`](../packages/shell/tool-bash-persistent/src/index.ts)
3051
+ Source: [`packages/shell/tool-bash-persistent/src/index.ts:435`](../packages/shell/tool-bash-persistent/src/index.ts)
2640
3052
 
2641
3053
  <a id="deepseek-aidsh-tool-fs"></a>
2642
3054
 
@@ -2765,6 +3177,22 @@ export interface Config {
2765
3177
 
2766
3178
  Source: [`packages/lsp/tool-lsp/src/index.ts:57`](../packages/lsp/tool-lsp/src/index.ts)
2767
3179
 
3180
+ <a id="deepseek-aidsh-tool-present"></a>
3181
+
3182
+ ## `@deepseek-ai/dsh-tool-present`
3183
+
3184
+ Requires: `tools` · `fs` · `sessionProjections`
3185
+
3186
+ ```ts config-catalog
3187
+ /** Per-call delivery limit. */
3188
+ export interface Config {
3189
+ /** Maximum number of files in one call. */
3190
+ maxFiles: number
3191
+ }
3192
+ ```
3193
+
3194
+ Source: [`packages/deliverables/tool-present/src/index.ts:15`](../packages/deliverables/tool-present/src/index.ts)
3195
+
2768
3196
  <a id="deepseek-aidsh-tool-pwsh"></a>
2769
3197
 
2770
3198
  ## `@deepseek-ai/dsh-tool-pwsh`
@@ -2894,8 +3322,8 @@ export interface Config {
2894
3322
  */
2895
3323
  toolName?: string
2896
3324
  /**
2897
- * Sample the Host `subagent-model-selection` user setting for each new
2898
- * top-level session and inherit that decision in its child sessions.
3325
+ * Sample the Host `subagent-model-selection` setting for each new top-level
3326
+ * Session and inherit that decision in its child Sessions.
2899
3327
  */
2900
3328
  modelSelectionSettings?: boolean
2901
3329
  /**
@@ -2915,7 +3343,7 @@ export interface Config {
2915
3343
  */
2916
3344
  agentOptions?: AgentOptions
2917
3345
  /**
2918
- * Per-child persona that shadows `deployment:persona`. Requires the
3346
+ * Per-child persona that shadows `deployment:persona-prefix`. Requires the
2919
3347
  * provider's `persona` capability; omission preserves the deployment persona.
2920
3348
  */
2921
3349
  persona?: string
@@ -2931,13 +3359,14 @@ export interface Config {
2931
3359
  deny?: string[]
2932
3360
  }
2933
3361
  /**
2934
- * Maximum child depth: a non-negative safe integer (default `3`; `0` forbids
2935
- * delegation entirely), or `'provider-managed'` to send no cap. A numeric cap
3362
+ * Maximum child depth: a non-negative safe integer (`0` forbids delegation),
3363
+ * or `'provider-managed'` to send no cap. A numeric cap
2936
3364
  * requires the provider's `depthLimit` capability (mount fails loud
2937
3365
  * otherwise). The provider checks the calling agent's current depth at every
2938
3366
  * start; the tool remains model-visible so runtime policy owns rejection.
2939
3367
  * `'provider-managed'` is for an out-of-process provider whose recursion
2940
- * budget belongs to the child runtime or its own deployment.
3368
+ * budget belongs to the child runtime or its own deployment. Omission reads
3369
+ * the current Host subagent depth setting (default `1`) at each delegation.
2941
3370
  */
2942
3371
  maxDepth?: number | 'provider-managed'
2943
3372
  }
@@ -2945,7 +3374,7 @@ export interface Config {
2945
3374
 
2946
3375
  Depends on: [`AgentOptions`](subsystems/core.md)
2947
3376
 
2948
- Source: [`packages/subagent/tool-subagent/src/index.ts:47`](../packages/subagent/tool-subagent/src/index.ts)
3377
+ Source: [`packages/subagent/tool-subagent/src/index.ts:48`](../packages/subagent/tool-subagent/src/index.ts)
2949
3378
 
2950
3379
  <a id="deepseek-aidsh-tool-terminal"></a>
2951
3380
 
@@ -3047,7 +3476,7 @@ export interface Config {
3047
3476
  * sends only `run_code` plus a generated SDK prompt and collapses the
3048
3477
  * executor to the same surface (a model-direct call may only name
3049
3478
  * `run_code`; `run_code` SDK sub-dispatches keep every visible tool); `both`
3050
- * sends both forms. PTC mode requires a `ctx.codeRuntime` whose `language`
3479
+ * sends both forms. PTC mode requires a `ctx.ptcRuntime` whose `language`
3051
3480
  * has a registered SDK renderer (TypeScript or Python) and fail prompt
3052
3481
  * assembly when it is absent or has no renderer. Under `ptc`, native names
3053
3482
  * in `toolOrder` are invalid.
@@ -3067,7 +3496,7 @@ export interface Config {
3067
3496
  export type ToolPresentationMode = 'native' | 'ptc' | 'both'
3068
3497
  ```
3069
3498
 
3070
- Source: [`packages/core/tools/src/index.ts:647`](../packages/core/tools/src/index.ts)
3499
+ Source: [`packages/core/tools/src/index.ts:656`](../packages/core/tools/src/index.ts)
3071
3500
 
3072
3501
  <a id="deepseek-aidsh-typert-loader"></a>
3073
3502
 
@@ -3083,7 +3512,7 @@ export interface Config {
3083
3512
  }
3084
3513
  ```
3085
3514
 
3086
- Source: [`packages/typert/loader/src/index.ts:47`](../packages/typert/loader/src/index.ts)
3515
+ Source: [`packages/typert/loader/src/index.ts:48`](../packages/typert/loader/src/index.ts)
3087
3516
 
3088
3517
  <a id="deepseek-aidsh-user-approval"></a>
3089
3518
 
@@ -3114,7 +3543,7 @@ export interface Config {
3114
3543
  export type ApprovalPolicy = 'ask' | 'never'
3115
3544
  ```
3116
3545
 
3117
- Source: [`packages/interaction/user-approval/src/index.ts:127`](../packages/interaction/user-approval/src/index.ts)
3546
+ Source: [`packages/interaction/user-approval/src/index.ts:128`](../packages/interaction/user-approval/src/index.ts)
3118
3547
 
3119
3548
  <a id="deepseek-aidsh-web"></a>
3120
3549
 
@@ -3286,11 +3715,11 @@ export interface Config {
3286
3715
 
3287
3716
  Source: [`packages/webhook/webhook-github/src/index.ts:17`](../packages/webhook/webhook-github/src/index.ts)
3288
3717
 
3289
- <a id="deepseek-aidsh-workflow-worker-thread"></a>
3718
+ <a id="deepseek-aidsh-workflow-ptc"></a>
3290
3719
 
3291
- ## `@deepseek-ai/dsh-workflow-worker-thread`
3720
+ ## `@deepseek-ai/dsh-workflow-ptc`
3292
3721
 
3293
- Requires: `subagents`
3722
+ Requires: `subagents` · `ptcRuntime` · `sandboxPolicy`
3294
3723
 
3295
3724
  ```ts config-catalog
3296
3725
  /** Plugin config (all optional — `static Config` supplies the defaults). */
@@ -3303,18 +3732,39 @@ export interface Config {
3303
3732
  maxTotalAgents?: number
3304
3733
  /** Items accepted by a single `parallel()`/`pipeline()` call (default 4096). */
3305
3734
  maxItemsPerCall?: number
3306
- /** vm timeout for the script's initial synchronous slice, inside the worker (default 5000 ms). */
3735
+ /** VM timeout for the script's initial synchronous slice (default 5000 ms). */
3307
3736
  syncTimeoutMs?: number
3737
+ }
3738
+ ```
3739
+
3740
+ Source: [`packages/workflow/workflow-ptc/src/index.ts:32`](../packages/workflow/workflow-ptc/src/index.ts)
3741
+
3742
+ <a id="deepseek-aidsh-workspace-changes"></a>
3743
+
3744
+ ## `@deepseek-ai/dsh-workspace-changes`
3745
+
3746
+ Requires: `subprocess`
3747
+
3748
+ ```ts config-catalog
3749
+ /** Snapshot, capture, and comparison bounds. Invalid values fail plugin load. */
3750
+ export interface Config {
3751
+ /** Milliseconds one git command may run before the turn's record is abandoned. */
3752
+ timeoutMs: number
3753
+ /** Bytes of git output retained per command; a larger diff listing abandons the record. */
3754
+ outputMaxBytes: number
3755
+ /** Maximum files carried by one summary; `total` still reports the complete count. */
3756
+ maxFiles: number
3308
3757
  /**
3309
- * How long after a cancellation an unsettled script may keep running before
3310
- * the run force-settles `cancelled` and its worker is TERMINATED (default
3311
- * 5000 ms); also bounds `dispose()`.
3758
+ * Bytes a file may hold to be captured around a file-tool edit or read from a snapshot for its comparison.
3759
+ * A larger file gets no comparison; one captured around a file-tool edit is also listed without counts.
3312
3760
  */
3313
- disposeGraceMs?: number
3761
+ maxFileBytes: number
3762
+ /** Milliseconds a line comparison may run before it degrades to whole-file replacement. */
3763
+ diffTimeoutMs: number
3314
3764
  }
3315
3765
  ```
3316
3766
 
3317
- Source: [`packages/workflow/workflow-worker-thread/src/index.ts:32`](../packages/workflow/workflow-worker-thread/src/index.ts)
3767
+ Source: [`packages/deliverables/workspace-changes/src/index.ts:33`](../packages/deliverables/workspace-changes/src/index.ts)
3318
3768
 
3319
3769
  ## Loadable plugins with no config
3320
3770
 
@@ -3325,9 +3775,11 @@ These load from a `cordis.yml` entry with no `config:` block; they declare no co
3325
3775
  - `@deepseek-ai/dsh-api-remotes` — requires `typertGateway` ([`packages/api/remotes/src/index.ts`](../packages/api/remotes/src/index.ts))
3326
3776
  - `@deepseek-ai/dsh-api-workspace-controller` — requires `typert` · `workspaceRegistry` ([`packages/api/workspace-controller/src/index.ts`](../packages/api/workspace-controller/src/index.ts))
3327
3777
  - `@deepseek-ai/dsh-authorization` — requires `credentials` ([`packages/credentials/authorization/src/index.ts`](../packages/credentials/authorization/src/index.ts))
3778
+ - `@deepseek-ai/dsh-browser-use` ([`packages/browser-use/browser-use/src/index.ts`](../packages/browser-use/browser-use/src/index.ts))
3328
3779
  - `@deepseek-ai/dsh-client-file-upload` — requires `agents` · `attachments` · `commands` · `connection` ([`packages/client/file-upload/src/index.ts`](../packages/client/file-upload/src/index.ts))
3329
3780
  - `@deepseek-ai/dsh-client-locale` ([`packages/client/locale/src/index.ts`](../packages/client/locale/src/index.ts))
3330
- - `@deepseek-ai/dsh-client-modules` — requires `webServer` · `loader` ([`packages/client/modules/src/index.ts`](../packages/client/modules/src/index.ts))
3781
+ - `@deepseek-ai/dsh-client-modules` — requires `loader` ([`packages/client/modules/src/index.ts`](../packages/client/modules/src/index.ts))
3782
+ - `@deepseek-ai/dsh-client-resources` ([`packages/client/resources/src/index.ts`](../packages/client/resources/src/index.ts))
3331
3783
  - `@deepseek-ai/dsh-client-ui-agent-preset` ([`packages/client/ui-agent-preset/src/index.ts`](../packages/client/ui-agent-preset/src/index.ts))
3332
3784
  - `@deepseek-ai/dsh-client-ui-approval` ([`packages/client/ui-approval/src/index.ts`](../packages/client/ui-approval/src/index.ts))
3333
3785
  - `@deepseek-ai/dsh-client-ui-attachment` ([`packages/client/ui-attachment/src/index.ts`](../packages/client/ui-attachment/src/index.ts))
@@ -3336,7 +3788,7 @@ These load from a `cordis.yml` entry with no `config:` block; they declare no co
3336
3788
  - `@deepseek-ai/dsh-client-ui-commands` ([`packages/client/ui-commands/src/index.ts`](../packages/client/ui-commands/src/index.ts))
3337
3789
  - `@deepseek-ai/dsh-client-ui-conversation` ([`packages/client/ui-conversation/src/index.ts`](../packages/client/ui-conversation/src/index.ts))
3338
3790
  - `@deepseek-ai/dsh-client-ui-cordis` ([`packages/extensions/ui-cordis/src/index.ts`](../packages/extensions/ui-cordis/src/index.ts))
3339
- - `@deepseek-ai/dsh-client-ui-deliverables` — requires `systemPrompt` ([`packages/client/ui-deliverables/src/index.ts`](../packages/client/ui-deliverables/src/index.ts))
3791
+ - `@deepseek-ai/dsh-client-ui-deliverables` — requires `systemPrompt` · `connection` · `sessionQuery` · `sessionController` · `workspaceFiles` · `fs` · `sandboxPolicy` · `workspaceChanges` ([`packages/client/ui-deliverables/src/index.ts`](../packages/client/ui-deliverables/src/index.ts))
3340
3792
  - `@deepseek-ai/dsh-client-ui-directory-picker-browse` ([`packages/client/ui-directory-picker-browse/src/index.ts`](../packages/client/ui-directory-picker-browse/src/index.ts))
3341
3793
  - `@deepseek-ai/dsh-client-ui-directory-picker-native` ([`packages/client/ui-directory-picker-native/src/index.ts`](../packages/client/ui-directory-picker-native/src/index.ts))
3342
3794
  - `@deepseek-ai/dsh-client-ui-goal` ([`packages/client/ui-goal/src/index.ts`](../packages/client/ui-goal/src/index.ts))
@@ -3345,8 +3797,10 @@ These load from a `cordis.yml` entry with no `config:` block; they declare no co
3345
3797
  - `@deepseek-ai/dsh-client-ui-layout` ([`packages/client/ui-layout/src/index.ts`](../packages/client/ui-layout/src/index.ts))
3346
3798
  - `@deepseek-ai/dsh-client-ui-message-feedback` ([`packages/client/ui-message-feedback/src/index.ts`](../packages/client/ui-message-feedback/src/index.ts))
3347
3799
  - `@deepseek-ai/dsh-client-ui-model-selection` ([`packages/client/ui-model-selection/src/index.ts`](../packages/client/ui-model-selection/src/index.ts))
3800
+ - `@deepseek-ai/dsh-client-ui-open-in-app` ([`packages/client/ui-open-in-app/src/index.ts`](../packages/client/ui-open-in-app/src/index.ts))
3348
3801
  - `@deepseek-ai/dsh-client-ui-permission-presets` ([`packages/client/ui-permission-presets/src/index.ts`](../packages/client/ui-permission-presets/src/index.ts))
3349
3802
  - `@deepseek-ai/dsh-client-ui-plan` ([`packages/client/ui-plan/src/index.ts`](../packages/client/ui-plan/src/index.ts))
3803
+ - `@deepseek-ai/dsh-client-ui-plugin-manager` ([`packages/client/ui-plugin-manager/src/index.ts`](../packages/client/ui-plugin-manager/src/index.ts))
3350
3804
  - `@deepseek-ai/dsh-client-ui-reference` ([`packages/client/ui-reference/src/index.ts`](../packages/client/ui-reference/src/index.ts))
3351
3805
  - `@deepseek-ai/dsh-client-ui-renderer` ([`packages/client/ui-renderer/src/index.ts`](../packages/client/ui-renderer/src/index.ts))
3352
3806
  - `@deepseek-ai/dsh-client-ui-schedule` ([`packages/client/ui-schedule/src/index.ts`](../packages/client/ui-schedule/src/index.ts))
@@ -3356,7 +3810,12 @@ These load from a `cordis.yml` entry with no `config:` block; they declare no co
3356
3810
  - `@deepseek-ai/dsh-client-ui-settings-models` ([`packages/client/ui-settings-models/src/index.ts`](../packages/client/ui-settings-models/src/index.ts))
3357
3811
  - `@deepseek-ai/dsh-client-ui-settings-plugin-inventory` ([`packages/client/ui-settings-plugin-inventory/src/index.ts`](../packages/client/ui-settings-plugin-inventory/src/index.ts))
3358
3812
  - `@deepseek-ai/dsh-client-ui-settings-plugins` ([`packages/client/ui-settings-plugins/src/index.ts`](../packages/client/ui-settings-plugins/src/index.ts))
3813
+ - `@deepseek-ai/dsh-client-ui-settings-unarchive-sessions` ([`packages/client/ui-settings-unarchive-sessions/src/index.ts`](../packages/client/ui-settings-unarchive-sessions/src/index.ts))
3359
3814
  - `@deepseek-ai/dsh-client-ui-sidebar` ([`packages/client/ui-sidebar/src/index.ts`](../packages/client/ui-sidebar/src/index.ts))
3815
+ - `@deepseek-ai/dsh-client-ui-sidebar-browser` ([`packages/client/ui-sidebar-browser/src/index.ts`](../packages/client/ui-sidebar-browser/src/index.ts))
3816
+ - `@deepseek-ai/dsh-client-ui-sidebar-files` ([`packages/client/ui-sidebar-files/src/index.ts`](../packages/client/ui-sidebar-files/src/index.ts))
3817
+ - `@deepseek-ai/dsh-client-ui-sidebar-right` ([`packages/client/ui-sidebar-right/src/index.ts`](../packages/client/ui-sidebar-right/src/index.ts))
3818
+ - `@deepseek-ai/dsh-client-ui-sidebar-terminal` ([`packages/client/ui-sidebar-terminal/src/index.ts`](../packages/client/ui-sidebar-terminal/src/index.ts))
3360
3819
  - `@deepseek-ai/dsh-client-ui-skill` ([`packages/client/ui-skill/src/index.ts`](../packages/client/ui-skill/src/index.ts))
3361
3820
  - `@deepseek-ai/dsh-client-ui-subagent` ([`packages/client/ui-subagent/src/index.ts`](../packages/client/ui-subagent/src/index.ts))
3362
3821
  - `@deepseek-ai/dsh-client-ui-theme` ([`packages/client/ui-theme/src/index.ts`](../packages/client/ui-theme/src/index.ts))
@@ -3369,17 +3828,23 @@ These load from a `cordis.yml` entry with no `config:` block; they declare no co
3369
3828
  - `@deepseek-ai/dsh-command-feedback` — requires `commands` ([`packages/feedback/command-feedback/src/index.ts`](../packages/feedback/command-feedback/src/index.ts))
3370
3829
  - `@deepseek-ai/dsh-command-goal` — requires `commands` · `goals` ([`packages/goal/command-goal/src/index.ts`](../packages/goal/command-goal/src/index.ts))
3371
3830
  - `@deepseek-ai/dsh-commands` ([`packages/interaction/commands/src/index.ts`](../packages/interaction/commands/src/index.ts))
3831
+ - `@deepseek-ai/dsh-compaction-image-offload` — requires `agents` · `sessions` ([`packages/compaction/compaction-image-offload/src/index.ts`](../packages/compaction/compaction-image-offload/src/index.ts))
3832
+ - `@deepseek-ai/dsh-computer-use` ([`packages/computer-use/computer-use/src/index.ts`](../packages/computer-use/computer-use/src/index.ts))
3372
3833
  - `@deepseek-ai/dsh-cordis-client-runner` ([`packages/extensions/cordis-client-runner/src/index.ts`](../packages/extensions/cordis-client-runner/src/index.ts))
3373
3834
  - `@deepseek-ai/dsh-deepseek-llm-api-extensions` ([`packages/llm/deepseek-llm-api-extensions/src/index.ts`](../packages/llm/deepseek-llm-api-extensions/src/index.ts))
3835
+ - `@deepseek-ai/dsh-experimental-auto-review` — requires `llm` · `permissionPresets` · `sessions` · `tools` ([`packages/experimental/auto-review/src/index.ts`](../packages/experimental/auto-review/src/index.ts))
3374
3836
  - `@deepseek-ai/dsh-experimental-client-ui-agent-team` ([`packages/experimental/client-ui-agent-team/src/index.ts`](../packages/experimental/client-ui-agent-team/src/index.ts))
3375
- - `@deepseek-ai/dsh-fs-e2b` — requires `e2b` ([`packages/e2b/fs-e2b/src/index.ts`](../packages/e2b/fs-e2b/src/index.ts))
3837
+ - `@deepseek-ai/dsh-experimental-computer-use-cua-driver-native` — requires `computerUse` · `tools` · `systemPrompt` ([`packages/experimental/computer-use-cua-driver-native/src/index.ts`](../packages/experimental/computer-use-cua-driver-native/src/index.ts))
3376
3838
  - `@deepseek-ai/dsh-fs-observation-policy` ([`packages/fs/fs-observation-policy/src/index.ts`](../packages/fs/fs-observation-policy/src/index.ts))
3839
+ - `@deepseek-ai/dsh-fs-ssh` — requires `ssh` · `sandboxPolicy` ([`packages/ssh/fs-ssh/src/index.ts`](../packages/ssh/fs-ssh/src/index.ts))
3377
3840
  - `@deepseek-ai/dsh-goal-round-driver` — requires `agents` · `goals` · `sessions` ([`packages/goal/goal-round-driver/src/index.ts`](../packages/goal/goal-round-driver/src/index.ts))
3378
3841
  - `@deepseek-ai/dsh-host-directory-picker-auto` — requires `webServer` · `loader` ([`packages/host/directory-picker-auto/src/index.ts`](../packages/host/directory-picker-auto/src/index.ts))
3379
3842
  - `@deepseek-ai/dsh-host-directory-picker-native` ([`packages/host/directory-picker-native/src/index.ts`](../packages/host/directory-picker-native/src/index.ts))
3380
3843
  - `@deepseek-ai/dsh-host-plugin-inventory` — requires `loader` ([`packages/host/plugin-inventory/src/index.ts`](../packages/host/plugin-inventory/src/index.ts))
3381
3844
  - `@deepseek-ai/dsh-llm` ([`packages/llm/llm/src/index.ts`](../packages/llm/llm/src/index.ts))
3382
3845
  - `@deepseek-ai/dsh-lsp` ([`packages/lsp/lsp/src/index.ts`](../packages/lsp/lsp/src/index.ts))
3846
+ - `@deepseek-ai/dsh-mcp-resources` — requires `tools` ([`packages/mcp/mcp-resources/src/index.ts`](../packages/mcp/mcp-resources/src/index.ts))
3847
+ - `@deepseek-ai/dsh-sandbox-ssh` — requires `ssh` ([`packages/ssh/sandbox-ssh/src/index.ts`](../packages/ssh/sandbox-ssh/src/index.ts))
3383
3848
  - `@deepseek-ai/dsh-schedule` — requires `agents` · `sessions` · `tools` · `sessionPersistence` ([`packages/schedule/schedule/src/index.ts`](../packages/schedule/schedule/src/index.ts))
3384
3849
  - `@deepseek-ai/dsh-session` ([`packages/core/session/src/index.ts`](../packages/core/session/src/index.ts))
3385
3850
  - `@deepseek-ai/dsh-session-checkpoint-policy` — requires `llm` · `sessionPersistence` · `sessions` · `tools` ([`packages/session/session-checkpoint-policy/src/index.ts`](../packages/session/session-checkpoint-policy/src/index.ts))
@@ -3388,12 +3853,12 @@ These load from a `cordis.yml` entry with no `config:` block; they declare no co
3388
3853
  - `@deepseek-ai/dsh-session-turn-outline` — requires `sessionProjections` ([`packages/session/session-turn-outline/src/index.ts`](../packages/session/session-turn-outline/src/index.ts))
3389
3854
  - `@deepseek-ai/dsh-skill-badge` — requires `skills` ([`packages/skill/skill-badge/src/index.ts`](../packages/skill/skill-badge/src/index.ts))
3390
3855
  - `@deepseek-ai/dsh-storage` ([`packages/storage/storage/src/index.ts`](../packages/storage/storage/src/index.ts))
3391
- - `@deepseek-ai/dsh-subagent` ([`packages/subagent/subagent/src/index.ts`](../packages/subagent/subagent/src/index.ts))
3392
3856
  - `@deepseek-ai/dsh-subprocess-local` ([`packages/subprocess/subprocess-local/src/index.ts`](../packages/subprocess/subprocess-local/src/index.ts))
3857
+ - `@deepseek-ai/dsh-subprocess-ssh` — requires `ssh` ([`packages/ssh/subprocess-ssh/src/index.ts`](../packages/ssh/subprocess-ssh/src/index.ts))
3393
3858
  - `@deepseek-ai/dsh-terminal` ([`packages/terminal/terminal/src/index.ts`](../packages/terminal/terminal/src/index.ts))
3394
3859
  - `@deepseek-ai/dsh-tool-ask-user` — requires `tools` · `userQuestions` ([`packages/interaction/tool-ask-user/src/index.ts`](../packages/interaction/tool-ask-user/src/index.ts))
3395
3860
  - `@deepseek-ai/dsh-tool-call-timeout-policy` — requires `tools` ([`packages/guard/timeout-policy/src/index.ts`](../packages/guard/timeout-policy/src/index.ts))
3396
- - `@deepseek-ai/dsh-tool-cordis` — requires `tools` · `systemPrompt` · `dynamicCordisRunner` · `cordisInspect` ([`packages/extensions/tool-cordis/src/index.ts`](../packages/extensions/tool-cordis/src/index.ts))
3861
+ - `@deepseek-ai/dsh-tool-cordis` — requires `tools` · `systemPrompt` · `cordisInspect` ([`packages/extensions/tool-cordis/src/index.ts`](../packages/extensions/tool-cordis/src/index.ts))
3397
3862
  - `@deepseek-ai/dsh-tool-subagent-control` — requires `tools` · `subagents` ([`packages/subagent/tool-subagent-control/src/index.ts`](../packages/subagent/tool-subagent-control/src/index.ts))
3398
3863
  - `@deepseek-ai/dsh-user-questions` ([`packages/interaction/user-questions/src/index.ts`](../packages/interaction/user-questions/src/index.ts))
3399
3864
  - `@deepseek-ai/dsh-webhook` — requires `agents` · `agentDefaultModel` · `agentPresets` · `permissionPresets` · `sessionTitle` · `workspaceRegistry` ([`packages/webhook/webhook/src/index.ts`](../packages/webhook/webhook/src/index.ts))
@@ -3404,13 +3869,13 @@ These load from a `cordis.yml` entry with no `config:` block; they declare no co
3404
3869
  Abstract service classes — a deployment loads a concrete implementation package instead ([capability seams](../.agents/notes/implemented/architecture/2026-06-13-capability-seams.md)).
3405
3870
 
3406
3871
  - `@deepseek-ai/dsh-attachment` — abstract `AttachmentStore` ([`packages/attachment/attachment/src/index.ts`](../packages/attachment/attachment/src/index.ts))
3407
- - `@deepseek-ai/dsh-code-runtime` — abstract `CodeRuntime` ([`packages/code-runtime/code-runtime/src/index.ts`](../packages/code-runtime/code-runtime/src/index.ts))
3408
3872
  - `@deepseek-ai/dsh-compaction` — abstract `CompactionEngine` ([`packages/compaction/compaction/src/index.ts`](../packages/compaction/compaction/src/index.ts))
3409
3873
  - `@deepseek-ai/dsh-credentials` — abstract `CredentialProvider` ([`packages/credentials/credentials/src/index.ts`](../packages/credentials/credentials/src/index.ts))
3410
3874
  - `@deepseek-ai/dsh-file-reference` — abstract `FileReferenceService` ([`packages/context/file-reference/src/index.ts`](../packages/context/file-reference/src/index.ts))
3411
3875
  - `@deepseek-ai/dsh-fs` — abstract `FileSystem` ([`packages/fs/fs/src/index.ts`](../packages/fs/fs/src/index.ts))
3412
3876
  - `@deepseek-ai/dsh-host-directory-picker` — abstract `DirectoryPicker` ([`packages/host/directory-picker/src/index.ts`](../packages/host/directory-picker/src/index.ts))
3413
3877
  - `@deepseek-ai/dsh-jobs` — abstract `JobRegistry` ([`packages/jobs/jobs/src/index.ts`](../packages/jobs/jobs/src/index.ts))
3878
+ - `@deepseek-ai/dsh-ptc-runtime` — abstract `PtcRuntime` ([`packages/ptc-runtime/ptc-runtime/src/index.ts`](../packages/ptc-runtime/ptc-runtime/src/index.ts))
3414
3879
  - `@deepseek-ai/dsh-sandbox` — abstract `SandboxProvider` ([`packages/sandbox/sandbox/src/index.ts`](../packages/sandbox/sandbox/src/index.ts))
3415
3880
  - `@deepseek-ai/dsh-session-persistence` — abstract `SessionPersistence` ([`packages/session/session-persistence/src/index.ts`](../packages/session/session-persistence/src/index.ts))
3416
3881
  - `@deepseek-ai/dsh-session-query` — abstract `SessionQueryEngine` ([`packages/session-query/session-query/src/index.ts`](../packages/session-query/session-query/src/index.ts))
@@ -3430,8 +3895,10 @@ Imported as libraries by other packages; a `cordis.yml` cannot load them.
3430
3895
  - `@deepseek-ai/dsh-atomic-write` ([`packages/util/atomic-write/src/index.ts`](../packages/util/atomic-write/src/index.ts))
3431
3896
  - `@deepseek-ai/dsh-base` ([`packages/bundle/base/src/index.ts`](../packages/bundle/base/src/index.ts))
3432
3897
  - `@deepseek-ai/dsh-brand` ([`packages/util/brand/src/index.ts`](../packages/util/brand/src/index.ts))
3898
+ - `@deepseek-ai/dsh-chunked-list` ([`packages/util/chunked-list/src/index.ts`](../packages/util/chunked-list/src/index.ts))
3433
3899
  - `@deepseek-ai/dsh-client-store` ([`packages/client/store/src/index.ts`](../packages/client/store/src/index.ts))
3434
3900
  - `@deepseek-ai/dsh-client-test-runtime` ([`packages/test-support/client-runtime/src/index.ts`](../packages/test-support/client-runtime/src/index.ts))
3901
+ - `@deepseek-ai/dsh-client-ui-dockkit` ([`packages/client/ui-dockkit/src/index.ts`](../packages/client/ui-dockkit/src/index.ts))
3435
3902
  - `@deepseek-ai/dsh-client-ui-primitives` ([`packages/client/ui-primitives/src/index.ts`](../packages/client/ui-primitives/src/index.ts))
3436
3903
  - `@deepseek-ai/dsh-client-ui-slots` ([`packages/client/ui-slots/src/index.ts`](../packages/client/ui-slots/src/index.ts))
3437
3904
  - `@deepseek-ai/dsh-client-web` ([`packages/client/web/src/index.ts`](../packages/client/web/src/index.ts))
@@ -3439,16 +3906,20 @@ Imported as libraries by other packages; a `cordis.yml` cannot load them.
3439
3906
  - `@deepseek-ai/dsh-deque` ([`packages/util/deque/src/index.ts`](../packages/util/deque/src/index.ts))
3440
3907
  - `@deepseek-ai/dsh-experimental-agent-team-profile` ([`packages/experimental/agent-team-profile/src/index.ts`](../packages/experimental/agent-team-profile/src/index.ts))
3441
3908
  - `@deepseek-ai/dsh-experimental-agent-team-web-profile` ([`packages/experimental/agent-team-web-profile/src/index.ts`](../packages/experimental/agent-team-web-profile/src/index.ts))
3909
+ - `@deepseek-ai/dsh-experimental-browser-use-runtime` ([`packages/experimental/browser-use-runtime/src/index.ts`](../packages/experimental/browser-use-runtime/src/index.ts))
3442
3910
  - `@deepseek-ai/dsh-experimental-webworker-packer` ([`packages/experimental/webworker-packer/src/index.ts`](../packages/experimental/webworker-packer/src/index.ts))
3443
3911
  - `@deepseek-ai/dsh-experimental-webworker-runtime` ([`packages/experimental/webworker-runtime/src/index.ts`](../packages/experimental/webworker-runtime/src/index.ts))
3444
3912
  - `@deepseek-ai/dsh-home-paths` ([`packages/util/home-paths/src/index.ts`](../packages/util/home-paths/src/index.ts))
3445
3913
  - `@deepseek-ai/dsh-hook-protocol` ([`packages/hooks/hook-protocol/src/index.ts`](../packages/hooks/hook-protocol/src/index.ts))
3446
3914
  - `@deepseek-ai/dsh-http-proxy` ([`packages/util/http-proxy/src/index.ts`](../packages/util/http-proxy/src/index.ts))
3447
3915
  - `@deepseek-ai/dsh-launch-environment` ([`packages/util/launch-environment/src/index.ts`](../packages/util/launch-environment/src/index.ts))
3916
+ - `@deepseek-ai/dsh-lazy-require` ([`packages/util/lazy-require/src/index.ts`](../packages/util/lazy-require/src/index.ts))
3448
3917
  - `@deepseek-ai/dsh-llm-mock-server` ([`packages/test-support/llm-mock-server/src/index.ts`](../packages/test-support/llm-mock-server/src/index.ts))
3449
3918
  - `@deepseek-ai/dsh-loader-smoke` ([`packages/test-support/loader-smoke/src/index.ts`](../packages/test-support/loader-smoke/src/index.ts))
3450
3919
  - `@deepseek-ai/dsh-native-command` ([`packages/util/native-command/src/index.ts`](../packages/util/native-command/src/index.ts))
3451
3920
  - `@deepseek-ai/dsh-output-retention` ([`packages/util/output-retention/src/index.ts`](../packages/util/output-retention/src/index.ts))
3921
+ - `@deepseek-ai/dsh-package-manifest` ([`packages/util/package-manifest/src/index.ts`](../packages/util/package-manifest/src/index.ts))
3922
+ - `@deepseek-ai/dsh-remote-mock` ([`packages/test-support/remote-mock/src/index.ts`](../packages/test-support/remote-mock/src/index.ts))
3452
3923
  - `@deepseek-ai/dsh-sandbox-windows-acl` ([`packages/sandbox/sandbox-windows-acl/src/index.ts`](../packages/sandbox/sandbox-windows-acl/src/index.ts))
3453
3924
  - `@deepseek-ai/dsh-scope` ([`packages/core/scope/src/index.ts`](../packages/core/scope/src/index.ts))
3454
3925
  - `@deepseek-ai/dsh-sdk-client` ([`packages/sdk/client/src/index.ts`](../packages/sdk/client/src/index.ts))
@@ -3458,6 +3929,7 @@ Imported as libraries by other packages; a `cordis.yml` cannot load them.
3458
3929
  - `@deepseek-ai/dsh-session-format-catalog` ([`packages/session/session-format-catalog/src/index.ts`](../packages/session/session-format-catalog/src/index.ts))
3459
3930
  - `@deepseek-ai/dsh-session-format-v0-to-v1` ([`packages/session/session-format-v0-to-v1/src/index.ts`](../packages/session/session-format-v0-to-v1/src/index.ts))
3460
3931
  - `@deepseek-ai/dsh-session-format-v1-to-v2` ([`packages/session/session-format-v1-to-v2/src/index.ts`](../packages/session/session-format-v1-to-v2/src/index.ts))
3932
+ - `@deepseek-ai/dsh-session-format-v2-to-v3` ([`packages/session/session-format-v2-to-v3/src/index.ts`](../packages/session/session-format-v2-to-v3/src/index.ts))
3461
3933
  - `@deepseek-ai/dsh-session-snapshot` ([`packages/test-support/session-snapshot/src/index.ts`](../packages/test-support/session-snapshot/src/index.ts))
3462
3934
  - `@deepseek-ai/dsh-session-telemetry` ([`packages/session/session-telemetry/src/index.ts`](../packages/session/session-telemetry/src/index.ts))
3463
3935
  - `@deepseek-ai/dsh-session-title-llm` ([`packages/session/session-title-llm/src/index.ts`](../packages/session/session-title-llm/src/index.ts))