@acryldev/plugin-context 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (284) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +12 -2
  3. package/docs/README.md +160 -0
  4. package/docs/delivery/local-live.md +113 -0
  5. package/docs/delivery/marketplace.md +16 -0
  6. package/docs/docs.json +2836 -0
  7. package/docs/extending/agent-preset.md +37 -0
  8. package/docs/extending/chat-command.md +28 -0
  9. package/docs/extending/client-slot.md +135 -0
  10. package/docs/extending/config-schema.md +7 -0
  11. package/docs/extending/cordis-core.md +63 -0
  12. package/docs/extending/desktop-app.md +53 -0
  13. package/docs/extending/desktop-main.md +25 -0
  14. package/docs/extending/event-hook.md +14 -0
  15. package/docs/extending/host-route.md +33 -0
  16. package/docs/extending/llm-adapter.md +38 -0
  17. package/docs/extending/packaging.md +53 -0
  18. package/docs/extending/prompt-contribution.md +9 -0
  19. package/docs/extending/service.md +13 -0
  20. package/docs/extending/skill-provider.md +9 -0
  21. package/docs/extending/state-and-persistence.md +71 -0
  22. package/docs/extending/three-role-capability.md +33 -0
  23. package/docs/extending/tool-plugin.md +24 -0
  24. package/docs/extending/tui-command.md +8 -0
  25. package/docs/extending/tui-components.md +61 -0
  26. package/docs/extending/ui-branding.md +43 -0
  27. package/docs/extending/ui-components.md +56 -0
  28. package/docs/extending/ui-customization.md +41 -0
  29. package/docs/extending/ui-library.md +66 -0
  30. package/docs/extending/ui-theme.md +55 -0
  31. package/docs/extending/workspace-tab.md +50 -0
  32. package/docs/maps/events.md +108 -0
  33. package/docs/maps/mount-points.md +154 -0
  34. package/docs/maps/slot-contracts.md +3376 -0
  35. package/docs/maps/taxonomy.md +306 -0
  36. package/docs/maps/theme-tokens.md +115 -0
  37. package/docs/maps/ui-components.md +26 -0
  38. package/docs/reference/cookbook/adding-a-package.md +174 -0
  39. package/docs/reference/cookbook/adding-a-remote-api.md +199 -0
  40. package/docs/reference/cookbook/adding-a-settings-card.md +74 -0
  41. package/docs/reference/cookbook/adding-a-tool.md +103 -0
  42. package/docs/reference/cookbook/adding-an-llm-adapter.md +45 -0
  43. package/docs/reference/cookbook/extension-cookbook.md +134 -0
  44. package/docs/reference/cordis-api/context.md +366 -0
  45. package/docs/reference/cordis-api/events.md +209 -0
  46. package/docs/reference/cordis-api/fiber.md +377 -0
  47. package/docs/reference/cordis-api/inherited.md +40 -0
  48. package/docs/reference/cordis-api/registry.md +154 -0
  49. package/docs/reference/cordis-api/service.md +104 -0
  50. package/docs/reference/cordis-guides/cordis-usage-cheatsheet.md +167 -0
  51. package/docs/reference/cordis-guides/cordis_system_guide_for_coding_agents.md +4666 -0
  52. package/docs/reference/cordis-guides/development-canvas-plugin.md +109 -0
  53. package/docs/reference/cordis-guides/hello-world-plugin-guide.md +517 -0
  54. package/docs/reference/harness/agent-lifecycle.md +93 -0
  55. package/docs/reference/harness/architecture.md +168 -0
  56. package/docs/reference/harness/capability-seams.md +675 -0
  57. package/docs/reference/harness/config-catalog.md +4523 -0
  58. package/docs/reference/harness/cordis-primer.md +47 -0
  59. package/docs/reference/harness/defensive-patterns.md +35 -0
  60. package/docs/reference/harness/event-producer-consumer.md +111 -0
  61. package/docs/reference/harness/glossary.md +47 -0
  62. package/docs/reference/harness/tool-catalog.md +2721 -0
  63. package/docs/reference/harness/tool-execution-pipeline.md +67 -0
  64. package/docs/reference/subsystems/README.md +75 -0
  65. package/docs/reference/subsystems/agent-team.md +233 -0
  66. package/docs/reference/subsystems/approval.md +172 -0
  67. package/docs/reference/subsystems/attachment.md +363 -0
  68. package/docs/reference/subsystems/boot.md +324 -0
  69. package/docs/reference/subsystems/browser-use.md +69 -0
  70. package/docs/reference/subsystems/client-modules.md +186 -0
  71. package/docs/reference/subsystems/client-resources.md +94 -0
  72. package/docs/reference/subsystems/commands.md +225 -0
  73. package/docs/reference/subsystems/compaction.md +286 -0
  74. package/docs/reference/subsystems/computer-use.md +58 -0
  75. package/docs/reference/subsystems/conversation.md +287 -0
  76. package/docs/reference/subsystems/core.md +1107 -0
  77. package/docs/reference/subsystems/credentials.md +497 -0
  78. package/docs/reference/subsystems/deliverables.md +180 -0
  79. package/docs/reference/subsystems/extensions.md +386 -0
  80. package/docs/reference/subsystems/feedback.md +402 -0
  81. package/docs/reference/subsystems/filesystem.md +532 -0
  82. package/docs/reference/subsystems/goal.md +315 -0
  83. package/docs/reference/subsystems/invariants.md +90 -0
  84. package/docs/reference/subsystems/jobs.md +501 -0
  85. package/docs/reference/subsystems/llm-streaming.md +1131 -0
  86. package/docs/reference/subsystems/lsp.md +204 -0
  87. package/docs/reference/subsystems/mcp.md +141 -0
  88. package/docs/reference/subsystems/office-to-pdf.md +89 -0
  89. package/docs/reference/subsystems/otel.md +46 -0
  90. package/docs/reference/subsystems/permission-presets.md +169 -0
  91. package/docs/reference/subsystems/persistence.md +418 -0
  92. package/docs/reference/subsystems/plan.md +89 -0
  93. package/docs/reference/subsystems/product-telemetry.md +81 -0
  94. package/docs/reference/subsystems/ptc-runtime.md +234 -0
  95. package/docs/reference/subsystems/sandbox.md +223 -0
  96. package/docs/reference/subsystems/schedule.md +545 -0
  97. package/docs/reference/subsystems/scope.md +61 -0
  98. package/docs/reference/subsystems/session-projection.md +358 -0
  99. package/docs/reference/subsystems/session-query.md +511 -0
  100. package/docs/reference/subsystems/session-reference.md +226 -0
  101. package/docs/reference/subsystems/session-telemetry.md +214 -0
  102. package/docs/reference/subsystems/session-title.md +206 -0
  103. package/docs/reference/subsystems/session.md +1300 -0
  104. package/docs/reference/subsystems/settings.md +157 -0
  105. package/docs/reference/subsystems/shell.md +316 -0
  106. package/docs/reference/subsystems/sidebar-right.md +160 -0
  107. package/docs/reference/subsystems/skills.md +354 -0
  108. package/docs/reference/subsystems/slots.md +201 -0
  109. package/docs/reference/subsystems/spill.md +126 -0
  110. package/docs/reference/subsystems/ssh.md +137 -0
  111. package/docs/reference/subsystems/storage.md +262 -0
  112. package/docs/reference/subsystems/subagent.md +762 -0
  113. package/docs/reference/subsystems/subprocess.md +323 -0
  114. package/docs/reference/subsystems/system-prompt.md +226 -0
  115. package/docs/reference/subsystems/terminal.md +186 -0
  116. package/docs/reference/subsystems/todo.md +34 -0
  117. package/docs/reference/subsystems/token-meter.md +108 -0
  118. package/docs/reference/subsystems/tools.md +749 -0
  119. package/docs/reference/subsystems/typert.md +489 -0
  120. package/docs/reference/subsystems/user-questions.md +309 -0
  121. package/docs/reference/subsystems/voice-input.md +166 -0
  122. package/docs/reference/subsystems/web-client.md +102 -0
  123. package/docs/reference/subsystems/web-server.md +228 -0
  124. package/docs/reference/subsystems/web.md +208 -0
  125. package/docs/reference/subsystems/webhook.md +72 -0
  126. package/docs/reference/subsystems/workflow.md +280 -0
  127. package/docs/reference/subsystems/workspace.md +661 -0
  128. package/docs/start-here/blueprints.md +33 -0
  129. package/docs/start-here/this-runtime.md +84 -0
  130. package/docs/start-here/troubleshooting.md +29 -0
  131. package/docs/start-here/trust-and-safety.md +39 -0
  132. package/docs/start-here/verify-before-done.md +46 -0
  133. package/example-plugins/README.md +45 -0
  134. package/example-plugins/packages/agent-preset-reviewer/agent.cordis.yml +18 -0
  135. package/example-plugins/packages/agent-preset-reviewer/preset.yml +3 -0
  136. package/example-plugins/packages/capability-swap-consumer/cordis.patch.yml +3 -0
  137. package/example-plugins/packages/capability-swap-consumer/index.js +14 -0
  138. package/example-plugins/packages/capability-swap-consumer/package.json +25 -0
  139. package/example-plugins/packages/capability-swap-provider-loud/cordis.patch.yml +3 -0
  140. package/example-plugins/packages/capability-swap-provider-loud/index.js +20 -0
  141. package/example-plugins/packages/capability-swap-provider-loud/package.json +25 -0
  142. package/example-plugins/packages/capability-swap-provider-quiet/cordis.patch.yml +3 -0
  143. package/example-plugins/packages/capability-swap-provider-quiet/index.js +20 -0
  144. package/example-plugins/packages/capability-swap-provider-quiet/package.json +25 -0
  145. package/example-plugins/packages/chat-command-basic/cordis.patch.yml +3 -0
  146. package/example-plugins/packages/chat-command-basic/index.js +26 -0
  147. package/example-plugins/packages/chat-command-basic/package.json +25 -0
  148. package/example-plugins/packages/client-chat-message-action/client.js +46 -0
  149. package/example-plugins/packages/client-chat-message-action/cordis.patch.yml +3 -0
  150. package/example-plugins/packages/client-chat-message-action/index.js +9 -0
  151. package/example-plugins/packages/client-chat-message-action/package.json +31 -0
  152. package/example-plugins/packages/client-slot-header-action/client.js +57 -0
  153. package/example-plugins/packages/client-slot-header-action/cordis.patch.yml +3 -0
  154. package/example-plugins/packages/client-slot-header-action/index.js +13 -0
  155. package/example-plugins/packages/client-slot-header-action/package.json +31 -0
  156. package/example-plugins/packages/client-slot-sidebar-tab/client.js +57 -0
  157. package/example-plugins/packages/client-slot-sidebar-tab/cordis.patch.yml +3 -0
  158. package/example-plugins/packages/client-slot-sidebar-tab/index.js +9 -0
  159. package/example-plugins/packages/client-slot-sidebar-tab/package.json +32 -0
  160. package/example-plugins/packages/client-theme-override/client.js +52 -0
  161. package/example-plugins/packages/client-theme-override/cordis.patch.yml +3 -0
  162. package/example-plugins/packages/client-theme-override/index.js +9 -0
  163. package/example-plugins/packages/client-theme-override/package.json +30 -0
  164. package/example-plugins/packages/client-tool-view/client.js +47 -0
  165. package/example-plugins/packages/client-tool-view/cordis.patch.yml +3 -0
  166. package/example-plugins/packages/client-tool-view/index.js +24 -0
  167. package/example-plugins/packages/client-tool-view/package.json +34 -0
  168. package/example-plugins/packages/client-ui-components/client.js +77 -0
  169. package/example-plugins/packages/client-ui-components/cordis.patch.yml +3 -0
  170. package/example-plugins/packages/client-ui-components/index.js +9 -0
  171. package/example-plugins/packages/client-ui-components/package.json +31 -0
  172. package/example-plugins/packages/client-ui-library/client.js +715 -0
  173. package/example-plugins/packages/client-ui-library/cordis.patch.yml +3 -0
  174. package/example-plugins/packages/client-ui-library/index.js +9 -0
  175. package/example-plugins/packages/client-ui-library/package.json +37 -0
  176. package/example-plugins/packages/client-workspace-tab/client.js +72 -0
  177. package/example-plugins/packages/client-workspace-tab/cordis.patch.yml +3 -0
  178. package/example-plugins/packages/client-workspace-tab/index.js +9 -0
  179. package/example-plugins/packages/client-workspace-tab/package.json +30 -0
  180. package/example-plugins/packages/config-schema-basic/cordis.patch.yml +3 -0
  181. package/example-plugins/packages/config-schema-basic/index.js +19 -0
  182. package/example-plugins/packages/config-schema-basic/package.json +25 -0
  183. package/example-plugins/packages/desktop-main-profile-info/cordis.patch.yml +3 -0
  184. package/example-plugins/packages/desktop-main-profile-info/index.js +22 -0
  185. package/example-plugins/packages/desktop-main-profile-info/package.json +25 -0
  186. package/example-plugins/packages/event-hook-basic/cordis.patch.yml +3 -0
  187. package/example-plugins/packages/event-hook-basic/index.js +17 -0
  188. package/example-plugins/packages/event-hook-basic/package.json +22 -0
  189. package/example-plugins/packages/generated-capability-template/cordis.patch.yml +3 -0
  190. package/example-plugins/packages/generated-capability-template/index.js +16 -0
  191. package/example-plugins/packages/generated-capability-template/package.json +42 -0
  192. package/example-plugins/packages/host-route-basic/cordis.patch.yml +3 -0
  193. package/example-plugins/packages/host-route-basic/index.js +20 -0
  194. package/example-plugins/packages/host-route-basic/package.json +29 -0
  195. package/example-plugins/packages/lifecycle-function-basic/cordis.patch.yml +3 -0
  196. package/example-plugins/packages/lifecycle-function-basic/index.js +12 -0
  197. package/example-plugins/packages/lifecycle-function-basic/package.json +15 -0
  198. package/example-plugins/packages/lifecycle-function-hot-shim/cordis.patch.yml +3 -0
  199. package/example-plugins/packages/lifecycle-function-hot-shim/impl.js +5 -0
  200. package/example-plugins/packages/lifecycle-function-hot-shim/index.js +18 -0
  201. package/example-plugins/packages/lifecycle-function-hot-shim/package.json +23 -0
  202. package/example-plugins/packages/lifecycle-hooks-observer/cordis.patch.yml +3 -0
  203. package/example-plugins/packages/lifecycle-hooks-observer/index.js +23 -0
  204. package/example-plugins/packages/lifecycle-hooks-observer/package.json +22 -0
  205. package/example-plugins/packages/llm-adapter-echo/cordis.patch.yml +3 -0
  206. package/example-plugins/packages/llm-adapter-echo/index.js +42 -0
  207. package/example-plugins/packages/llm-adapter-echo/package.json +25 -0
  208. package/example-plugins/packages/prompt-assemble-hook/cordis.patch.yml +3 -0
  209. package/example-plugins/packages/prompt-assemble-hook/index.js +22 -0
  210. package/example-plugins/packages/prompt-assemble-hook/package.json +22 -0
  211. package/example-plugins/packages/prompt-contribution-basic/cordis.patch.yml +3 -0
  212. package/example-plugins/packages/prompt-contribution-basic/index.js +18 -0
  213. package/example-plugins/packages/prompt-contribution-basic/package.json +22 -0
  214. package/example-plugins/packages/service-consumer-greeter/cordis.patch.yml +3 -0
  215. package/example-plugins/packages/service-consumer-greeter/index.js +14 -0
  216. package/example-plugins/packages/service-consumer-greeter/package.json +22 -0
  217. package/example-plugins/packages/service-provider-greeter/cordis.patch.yml +3 -0
  218. package/example-plugins/packages/service-provider-greeter/index.js +22 -0
  219. package/example-plugins/packages/service-provider-greeter/package.json +25 -0
  220. package/example-plugins/packages/settings-section-basic/cordis.patch.yml +3 -0
  221. package/example-plugins/packages/settings-section-basic/index.js +34 -0
  222. package/example-plugins/packages/settings-section-basic/package.json +26 -0
  223. package/example-plugins/packages/skill-provider-basic/cordis.patch.yml +3 -0
  224. package/example-plugins/packages/skill-provider-basic/index.js +31 -0
  225. package/example-plugins/packages/skill-provider-basic/package.json +22 -0
  226. package/example-plugins/packages/state-host-store/client.js +57 -0
  227. package/example-plugins/packages/state-host-store/cordis.patch.yml +3 -0
  228. package/example-plugins/packages/state-host-store/index.js +90 -0
  229. package/example-plugins/packages/state-host-store/package.json +31 -0
  230. package/example-plugins/packages/state-workspace-file/cordis.patch.yml +3 -0
  231. package/example-plugins/packages/state-workspace-file/index.js +52 -0
  232. package/example-plugins/packages/state-workspace-file/package.json +25 -0
  233. package/example-plugins/packages/tool-basic/cordis.patch.yml +3 -0
  234. package/example-plugins/packages/tool-basic/index.js +25 -0
  235. package/example-plugins/packages/tool-basic/package.json +25 -0
  236. package/example-plugins/packages/tool-policy-hook/cordis.patch.yml +3 -0
  237. package/example-plugins/packages/tool-policy-hook/index.js +28 -0
  238. package/example-plugins/packages/tool-policy-hook/package.json +25 -0
  239. package/example-plugins/packages/tui-command-basic/cordis.patch.yml +3 -0
  240. package/example-plugins/packages/tui-command-basic/index.js +24 -0
  241. package/example-plugins/packages/tui-command-basic/package.json +22 -0
  242. package/example-plugins/packages/tui-overlay-themed/cordis.patch.yml +3 -0
  243. package/example-plugins/packages/tui-overlay-themed/index.js +65 -0
  244. package/example-plugins/packages/tui-overlay-themed/package.json +25 -0
  245. package/example-plugins/packages/tui-ui-library/cordis.patch.yml +3 -0
  246. package/example-plugins/packages/tui-ui-library/index.js +73 -0
  247. package/example-plugins/packages/tui-ui-library/package.json +29 -0
  248. package/example-plugins/packages/web-page-branding/cordis.patch.yml +3 -0
  249. package/example-plugins/packages/web-page-branding/index.js +31 -0
  250. package/example-plugins/packages/web-page-branding/package.json +22 -0
  251. package/example-plugins/scenarios.json +11 -0
  252. package/index.js +384 -0
  253. package/lib/blend-apply.js +107 -0
  254. package/lib/blend-capture.js +249 -0
  255. package/lib/blend-ledger.js +76 -0
  256. package/lib/contract.js +5 -0
  257. package/lib/install.js +516 -0
  258. package/lib/lookup.js +67 -0
  259. package/lib/manifest.js +56 -0
  260. package/lib/pack-root.js +22 -0
  261. package/lib/provenance.js +110 -0
  262. package/lib/publish.js +64 -0
  263. package/lib/reconcile.js +83 -0
  264. package/lib/router.js +55 -0
  265. package/lib/scopes.js +82 -0
  266. package/lib/skills.js +54 -0
  267. package/lib/stage.js +157 -0
  268. package/lib/verify.js +77 -0
  269. package/package.json +58 -3
  270. package/scripts/lib/indexes.mjs +45 -0
  271. package/scripts/lib/manifest.mjs +127 -0
  272. package/scripts/lib/maps.mjs +482 -0
  273. package/skills/acryl-add-provider-or-capability/SKILL.md +12 -0
  274. package/skills/acryl-add-ui/SKILL.md +18 -0
  275. package/skills/acryl-build-plugin/SKILL.md +21 -0
  276. package/skills/acryl-change-plugin/SKILL.md +16 -0
  277. package/skills/acryl-desktop-shell/SKILL.md +12 -0
  278. package/skills/acryl-diagnose-plugin/SKILL.md +10 -0
  279. package/skills/acryl-fix-plugin/SKILL.md +12 -0
  280. package/skills/acryl-improve-ui/SKILL.md +10 -0
  281. package/skills/acryl-remove-plugin/SKILL.md +11 -0
  282. package/skills/acryl-restyle-ui/SKILL.md +14 -0
  283. package/skills/acryl-share-plugin/SKILL.md +23 -0
  284. package/skills/acryl-tui-ui/SKILL.md +12 -0
@@ -0,0 +1,4523 @@
1
+ <!-- Synced from deepseek-harness:docs/config-catalog.md @ 639ed01539. Do not edit; run scripts/sync-corpus.mjs. Relative links inside may not resolve here. -->
2
+
3
+ <!-- Generated by scripts/gen-config-catalog.ts - do not edit by hand.
4
+ Run `pnpm run gen-config-catalog` to regenerate. -->
5
+
6
+ # Plugin Config Catalog
7
+
8
+ Every `config:` block a `cordis.yml` entry can set: for each loadable harness package, the verbatim config declaration (JSDoc included) its `apply` function or service constructor receives, with every referenced type pasted alongside (package-local types) or linked (everything else). The paste is the plugin's full declared config type - a field the runtime schema deliberately excludes is a runtime-only seam (its own JSDoc says so) and is not settable from `cordis.yml`. This is the **deployment**-axis reference - the wiring a plugin author works against is the generated Cordis API region on each [subsystem page](subsystems/core.md), the model-facing tool schemas are the [tool catalog](tool-catalog.md), and [subsystems/](subsystems/core.md) documents the types these declarations reference.
9
+
10
+ Both language versions of this file are GENERATED from source (`scripts/gen-config-catalog.ts`) and verified fresh by `pnpm run verify-config-catalog` (part of `doc-sync`) - do not edit them 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.
11
+
12
+ Each package entry labels its data with three identifiers: `inject` lists the service keys the plugin injects, so its `cordis.yml` tree must also load providers for those services; `refs` lists the referenced types that are not pasted here; `source` links the file that declares the config. 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.
13
+
14
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-acp -->
15
+ <a id="deepseek-aidsh-acp"></a>
16
+
17
+ ## `@deepseek-ai/dsh-acp`
18
+
19
+ - `inject`: `agents` · `llm` · `sessionPersistence` · `sessions`
20
+ - `refs`: `Stream` (`@agentclientprotocol/sdk`)
21
+ - `source`: [`packages/acp/acp/src/index.ts:75`](../packages/acp/acp/src/index.ts)
22
+
23
+ ```ts config-catalog
24
+ /** Plugin config: the provider/model selection used for each ACP-created agent. */
25
+ export interface AcpConfig {
26
+ /** Provider route for created agents. */
27
+ provider?: string
28
+ /** Model name for created agents. */
29
+ model?: string
30
+ /** Maximum summaries returned by one session/list page. */
31
+ sessionListPageSize?: number
32
+ /** Runtime-only transport override; production uses stdio. */
33
+ stream?: Stream
34
+ }
35
+ ```
36
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-acp -->
37
+
38
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-agent-default-model -->
39
+ <a id="deepseek-aidsh-agent-default-model"></a>
40
+
41
+ ## `@deepseek-ai/dsh-agent-default-model`
42
+
43
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
44
+ - `source`: [`packages/core/agent-default-model/src/index.ts:24`](../packages/core/agent-default-model/src/index.ts)
45
+
46
+ ```ts config-catalog
47
+ /** Default model selection supplied by plugin configuration. */
48
+ export interface Config {
49
+ /** Registered provider route. */
50
+ provider: Volatile<string>
51
+ /** Provider-owned model id. */
52
+ model: Volatile<string>
53
+ /** Adapter-owned reasoning effort; omission follows the provider default. */
54
+ reasoningEffort: Volatile<string | undefined>
55
+ }
56
+ ```
57
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-agent-default-model -->
58
+
59
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-agent-instructions -->
60
+ <a id="deepseek-aidsh-agent-instructions"></a>
61
+
62
+ ## `@deepseek-ai/dsh-agent-instructions`
63
+
64
+ - `inject`: `sessionProjections`
65
+ - `source`: [`packages/context/agent-instructions/src/config.ts:18`](../packages/context/agent-instructions/src/config.ts)
66
+
67
+ ```ts config-catalog
68
+ /** User-facing workspace instruction loader configuration. */
69
+ export interface Config {
70
+ /** Harness home containing the fixed user-global `AGENTS.md`; defaults to `$DSH_HOME` or `~/.dsh`. */
71
+ dshHome?: string
72
+ /** Directory entries that identify the project root while walking upward from the session cwd. */
73
+ projectRootMarkers?: string[]
74
+ /** UTF-8 byte cap for one rendered baseline or dynamic batch; non-positive or non-finite disables loading. */
75
+ maxBytes: number
76
+ /** Maximum UTF-8 bytes read from one instruction file; larger files are ignored. */
77
+ maxSourceBytes?: number
78
+ /**
79
+ * Ordered same-directory project candidates; every existing file loads, with
80
+ * per-directory trimmed-content duplicates collapsed to the earliest candidate.
81
+ */
82
+ instructionFileCandidates?: string[]
83
+ /**
84
+ * Ordered same-directory local-overlay candidates loaded after the base files
85
+ * under the same per-directory trimmed-content dedup; empty disables the overlay.
86
+ */
87
+ localInstructionFileCandidates?: string[]
88
+ }
89
+ ```
90
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-agent-instructions -->
91
+
92
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-agent-loop -->
93
+ <a id="deepseek-aidsh-agent-loop"></a>
94
+
95
+ ## `@deepseek-ai/dsh-agent-loop`
96
+
97
+ - `inject`: `agents` · `sessions` · `llm` · `tools` · `systemPrompt` · `sessionProjections`
98
+ - `refs`: [`AgentOptions`](subsystems/core.md) · [`SessionId`](subsystems/core.md) · `Volatile` (`@deepseek-ai/cosmokit`)
99
+ - `source`: [`packages/core/agent-loop/src/index.ts:292`](../packages/core/agent-loop/src/index.ts)
100
+
101
+ ```ts config-catalog
102
+ /** Agent-loop plugin configuration. */
103
+ export interface Config {
104
+ /**
105
+ * Maximum parallel-safe calls in flight per agent step. `1` is serial;
106
+ * omission defaults to {@link DEFAULT_MAX_PARALLEL_TOOL_CALLS}.
107
+ */
108
+ maxParallelToolCalls: Volatile<number>
109
+ /** Agents created or resumed at plugin startup. */
110
+ agents: (AgentOptions & {
111
+ /** Stable config label used in logs and as the fresh combined-id prefix. */
112
+ id: string
113
+ /** Optional stable identity; remounts resume its materialized history, while first use creates it fresh. */
114
+ sessionId?: SessionId
115
+ /** Optional workspace for a fresh session. */
116
+ cwd?: string
117
+ /** Persisted session to resume instead of creating a fresh session. */
118
+ resumeSessionId?: SessionId
119
+ })[]
120
+ }
121
+ ```
122
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-agent-loop -->
123
+
124
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-agent-preset -->
125
+ <a id="deepseek-aidsh-agent-preset"></a>
126
+
127
+ ## `@deepseek-ai/dsh-agent-preset`
128
+
129
+ - `inject`: `agentPresets`
130
+ - `refs`: [`PresetDefinition`](../packages/preset/agent-preset-registry/src/index.ts)
131
+ - `source`: [`packages/preset/agent-preset/src/index.ts:9`](../packages/preset/agent-preset/src/index.ts)
132
+
133
+ ```ts config-catalog
134
+ /** Definition submitted to the preset registry. */
135
+ export type Config = PresetDefinition
136
+ ```
137
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-agent-preset -->
138
+
139
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-agent-preset-registry -->
140
+ <a id="deepseek-aidsh-agent-preset-registry"></a>
141
+
142
+ ## `@deepseek-ai/dsh-agent-preset-registry`
143
+
144
+ - `inject`: `loader` · `sessionProjections`
145
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
146
+ - `source`: [`packages/preset/agent-preset-registry/src/preset.ts:13`](../packages/preset/agent-preset-registry/src/preset.ts)
147
+
148
+ ```ts config-catalog
149
+ /** Registry selection policy. */
150
+ export interface Config {
151
+ /** Deployment default when the caller omits a preset. */
152
+ default: string
153
+ /** User-selected default; edited through Settings. */
154
+ selectedDefault: Volatile<string | undefined>
155
+ }
156
+ ```
157
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-agent-preset-registry -->
158
+
159
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-agent-tool-presentation -->
160
+ <a id="deepseek-aidsh-agent-tool-presentation"></a>
161
+
162
+ ## `@deepseek-ai/dsh-agent-tool-presentation`
163
+
164
+ - `inject`: `tools`
165
+ - `refs`: [`ToolPresentationMode`](subsystems/tools.md)
166
+ - `source`: [`packages/core/agent-tool-presentation/src/index.ts:38`](../packages/core/agent-tool-presentation/src/index.ts)
167
+
168
+ ```ts config-catalog
169
+ /** Plugin config. */
170
+ export interface Config {
171
+ /**
172
+ * The form this agent's model sees. `native` sends every visible schema,
173
+ * `ptc` sends only `run_code` plus a generated SDK, `both` sends both.
174
+ * Required rather than defaulted: the deployment default is what a preset
175
+ * without this row already gets, so an omitted value would mean the row was
176
+ * composed for nothing.
177
+ */
178
+ mode: ToolPresentationMode
179
+ }
180
+ ```
181
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-agent-tool-presentation -->
182
+
183
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-api-gateway -->
184
+ <a id="deepseek-aidsh-api-gateway"></a>
185
+
186
+ ## `@deepseek-ai/dsh-api-gateway`
187
+
188
+ - `inject`: `typert`
189
+ - `source`: [`packages/api/gateway/src/index.ts:146`](../packages/api/gateway/src/index.ts)
190
+
191
+ ```ts config-catalog
192
+ /** Gateway transport configuration. */
193
+ export interface Config {
194
+ /** WebSocket Ping interval from 1 through 2,147,483,647 milliseconds. @default 2000 */
195
+ readonly websocketHeartbeatIntervalMs?: number
196
+ /** Buffered uplink frame bytes one logical stream may hold before it fails with `gateway/uplink-overflow`. @default 262144 */
197
+ readonly streamInboxBytes?: number
198
+ }
199
+ ```
200
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-api-gateway -->
201
+
202
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-api-job-controller -->
203
+ <a id="deepseek-aidsh-api-job-controller"></a>
204
+
205
+ ## `@deepseek-ai/dsh-api-job-controller`
206
+
207
+ - `inject`: `jobs` · `typert`
208
+ - `source`: [`packages/api/job-controller/src/index.ts:35`](../packages/api/job-controller/src/index.ts)
209
+
210
+ ```ts config-catalog
211
+ /** Job Controller deployment policy. */
212
+ export interface Config {
213
+ /** Coalescing window after a registry commit before the next rows or output read, in milliseconds (default 100). */
214
+ readonly observeFlushMs?: number
215
+ /** Soft byte budget per observation output frame (default 65536); one larger chunk ships whole. */
216
+ readonly observeMaxFrameBytes?: number
217
+ }
218
+ ```
219
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-api-job-controller -->
220
+
221
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-api-session-controller -->
222
+ <a id="deepseek-aidsh-api-session-controller"></a>
223
+
224
+ ## `@deepseek-ai/dsh-api-session-controller`
225
+
226
+ - `inject`: `agentDefaultModel` · `agents` · `attachments` · `fileUploads` · `fs` · `llm` · `sessions` · `sessionProjections` · `sessionQuery` · `typert` · `workspaceRegistry`
227
+ - `source`: [`packages/api/session-controller/src/index.ts:79`](../packages/api/session-controller/src/index.ts)
228
+
229
+ ```ts config-catalog
230
+ /** Session Controller deployment policy. */
231
+ export interface Config {
232
+ /** Override platform desktop-opener detection. */
233
+ readonly nativeOpen?: boolean
234
+ }
235
+ ```
236
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-api-session-controller -->
237
+
238
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-api-settings-controller -->
239
+ <a id="deepseek-aidsh-api-settings-controller"></a>
240
+
241
+ ## `@deepseek-ai/dsh-api-settings-controller`
242
+
243
+ - `source`: [`packages/api/settings-controller/src/index.ts:35`](../packages/api/settings-controller/src/index.ts)
244
+
245
+ ```ts config-catalog
246
+ /** Host integrations replaceable by direct unit tests. */
247
+ export interface SettingsControllerInternals {
248
+ /** Host text-editor integration used to open the settings document. */
249
+ readonly openTextFile?: (path: string, signal: AbortSignal) => Promise<void>
250
+ }
251
+ ```
252
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-api-settings-controller -->
253
+
254
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-api-terminal-controller -->
255
+ <a id="deepseek-aidsh-api-terminal-controller"></a>
256
+
257
+ ## `@deepseek-ai/dsh-api-terminal-controller`
258
+
259
+ - `inject`: `subprocess` · `sandboxPolicy` · `typert`
260
+ - `source`: [`packages/api/terminal-controller/src/index.ts:26`](../packages/api/terminal-controller/src/index.ts)
261
+
262
+ ```ts config-catalog
263
+ /** Deployment limits and an optional shell profile. */
264
+ export interface Config {
265
+ /** Explicit shell profile; omission uses the execution environment's default shell. */
266
+ readonly shell?: {
267
+ /** Executable path or PATH name, verified by the subprocess provider. */
268
+ path: string
269
+ /** User-visible profile name. */
270
+ name: string
271
+ /** Arguments passed to the interactive shell. */
272
+ args: string[]
273
+ } | undefined
274
+ /** Executable names or paths checked for the new-terminal shell selector. */
275
+ readonly shellCandidates: string[]
276
+ /** Maximum retained terminals and pending allocations per Session. */
277
+ readonly maxTerminals: number
278
+ /** Maximum terminal width in columns. */
279
+ readonly maxCols: number
280
+ /** Maximum terminal height in rows. */
281
+ readonly maxRows: number
282
+ /** Screen history rows retained for reconnecting clients. */
283
+ readonly scrollback: number
284
+ /** Maximum queued UTF-8 frame bytes per output follower before disconnection. */
285
+ readonly maxBufferedBytes: number
286
+ /** Maximum UTF-8 bytes in one input request. */
287
+ readonly maxInputBytes: number
288
+ /** Provider process-termination grace period in milliseconds. */
289
+ readonly disposeGraceMs: number
290
+ /** Continuous confirmed idle time without window holds before reclamation; zero disables reclamation. */
291
+ readonly unattendedTimeoutMs: number
292
+ /** Interval between unattended shell and process observations. */
293
+ readonly activityPollIntervalMs: number
294
+ /** Delay before retrying failed owned terminal cleanup. */
295
+ readonly cleanupRetryMs: number
296
+ }
297
+ ```
298
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-api-terminal-controller -->
299
+
300
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-api-workspace-controller -->
301
+ <a id="deepseek-aidsh-api-workspace-controller"></a>
302
+
303
+ ## `@deepseek-ai/dsh-api-workspace-controller`
304
+
305
+ - `inject`: `typert` · `workspaceRegistry`
306
+ - `source`: [`packages/api/workspace-controller/src/index.ts:33`](../packages/api/workspace-controller/src/index.ts)
307
+
308
+ ```ts config-catalog
309
+ /** First-use directory policy for the Host account. */
310
+ export interface Config {
311
+ /** Override the system Documents directory with a fully qualified path. */
312
+ documentsDirectory?: string
313
+ /** Maximum duration of the operating system's Documents lookup. */
314
+ documentsLookupTimeoutMs?: number
315
+ }
316
+ ```
317
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-api-workspace-controller -->
318
+
319
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-api-workspace-files -->
320
+ <a id="deepseek-aidsh-api-workspace-files"></a>
321
+
322
+ ## `@deepseek-ai/dsh-api-workspace-files`
323
+
324
+ - `inject`: `fs` · `sandboxPolicy` · `sessions` · `typert`
325
+ - `source`: [`packages/api/workspace-files/src/index.ts:70`](../packages/api/workspace-files/src/index.ts)
326
+
327
+ ```ts config-catalog
328
+ /** Deployment caps on one page or one listing. */
329
+ export interface Config {
330
+ /**
331
+ * Inclusive byte cap on one page's text and on one byte window.
332
+ *
333
+ * A page above this fails; it is not shortened, because a silently cut page
334
+ * reads as the whole page. A byte window asking for more is refused the same
335
+ * way. The file itself has no size cap: a caller pages through it.
336
+ */
337
+ readonly maxBytes: number
338
+ /** Inclusive byte cap on a complete-file read; larger files are refused, never truncated. */
339
+ readonly maxFileBytes: number
340
+ /** Default and largest page size in lines; a request asking for more is refused. */
341
+ readonly maxLines: number
342
+ /** Cap on returned directory entries; the rest is dropped and reported cut. */
343
+ readonly maxEntries: number
344
+ }
345
+ ```
346
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-api-workspace-files -->
347
+
348
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-attachment-local -->
349
+ <a id="deepseek-aidsh-attachment-local"></a>
350
+
351
+ ## `@deepseek-ai/dsh-attachment-local`
352
+
353
+ - `source`: [`packages/attachment/attachment-local/src/index.ts:61`](../packages/attachment/attachment-local/src/index.ts)
354
+
355
+ ```ts config-catalog
356
+ /** Local attachment backend configuration. */
357
+ export interface Config {
358
+ /** Explicit harness home; omitted follows `DSH_HOME`, then `~/.dsh`. */
359
+ dshHome?: string
360
+ /** Maximum encoded bytes accepted for one submitted image. Default: 20 MiB. */
361
+ maxImageBytes?: number
362
+ /** Maximum image count accepted in one submitted message. Default: 20. */
363
+ maxImagesPerMessage?: number
364
+ /** Maximum aggregate encoded image bytes accepted in one submitted message. Default: 200 MiB. */
365
+ maxMessageImageBytes?: number
366
+ /** Maximum intrinsic width multiplied by height accepted for one submitted image. Default: 64,000,000. */
367
+ maxImagePixels?: number
368
+ /** Maximum intrinsic width and maximum intrinsic height accepted for one submitted image. Default: 8192px. */
369
+ maxImageDimension?: number
370
+ /** Total-pixel budget of the stored provider-independent normalized image. */
371
+ normalizedImageMaxPixels?: number
372
+ /** Long-edge pixel cap of the stored provider-independent normalized image, applied after the total-pixel budget. */
373
+ normalizedImageMaxDimension?: number
374
+ /**
375
+ * Encoded-byte target of the stored provider-independent normalized image;
376
+ * the smallest quality-ladder output is kept when no quality fits.
377
+ */
378
+ normalizedImageMaxBytes?: number
379
+ /** Maximum simultaneous normalization or request-image transformations in this service instance. */
380
+ imageCompressionConcurrency?: number
381
+ }
382
+ ```
383
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-attachment-local -->
384
+
385
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-bash-local -->
386
+ <a id="deepseek-aidsh-bash-local"></a>
387
+
388
+ ## `@deepseek-ai/dsh-bash-local`
389
+
390
+ - `inject`: `subprocess`
391
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
392
+ - `source`: [`packages/shell/bash-local/src/index.ts:41`](../packages/shell/bash-local/src/index.ts)
393
+
394
+ ```ts config-catalog
395
+ /** Validated plugin configuration with live command budgets. */
396
+ export interface Config {
397
+ /** Default working directory for commands (default: process.cwd()). */
398
+ cwd: Volatile<string | undefined>
399
+ /** Default foreground timeout in milliseconds. */
400
+ timeoutMs: Volatile<number>
401
+ /** Upper bound for per-call timeout overrides. */
402
+ maxTimeoutMs: Volatile<number>
403
+ /** Per-stream in-memory output cap; overflow spills to a temp file. */
404
+ maxOutputBytes: Volatile<number>
405
+ /** Per-stream spill-file cap; larger streams retain only their in-memory tail. */
406
+ maxSpillBytes: Volatile<number>
407
+ /** Grace period for kill escalation and inherited pipes; at most `MAX_TIMER_DELAY_MS`. */
408
+ graceMs: Volatile<number>
409
+ }
410
+ ```
411
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-bash-local -->
412
+
413
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-bash-sandbox -->
414
+ <a id="deepseek-aidsh-bash-sandbox"></a>
415
+
416
+ ## `@deepseek-ai/dsh-bash-sandbox`
417
+
418
+ - `inject`: `subprocess` · `sandbox` · `sandboxPolicy`
419
+ - `refs`: [`LocalConfig`](#deepseek-aidsh-bash-local)
420
+ - `source`: [`packages/shell/bash-sandbox/src/index.ts:36`](../packages/shell/bash-sandbox/src/index.ts)
421
+
422
+ ```ts config-catalog
423
+ /**
424
+ * Plugin config: the local executor's knobs, verbatim. The sandbox policy -
425
+ * the default mode and fallback `workspace-write` root - is NOT here: it lives
426
+ * on `ctx.sandboxPolicy` (`@deepseek-ai/dsh-sandbox-policy`), which resolves
427
+ * each calling session's mode and cwd for every enforcing capability. The runner
428
+ * choice is likewise the `ctx.sandbox` provider's config, not this executor's.
429
+ */
430
+ export type Config = LocalConfig
431
+ ```
432
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-bash-sandbox -->
433
+
434
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-client-connection -->
435
+ <a id="deepseek-aidsh-client-connection"></a>
436
+
437
+ ## `@deepseek-ai/dsh-client-connection`
438
+
439
+ - `inject`: `credentials`
440
+ - `source`: [`packages/client/connection/src/index.ts:92`](../packages/client/connection/src/index.ts)
441
+
442
+ ```ts config-catalog
443
+ /** Browser authentication, request limits, and connection recovery configuration. */
444
+ export interface ConnectionConfig {
445
+ /** Browser recovery timing, injected into each served page. */
446
+ recovery?: ConnectionRecoveryConfig
447
+ /**
448
+ * Authorities this deployment serves beyond loopback: exact `host:port`, or
449
+ * port-less `host` matching any port. The /api trust fence refuses any
450
+ * request whose Host is neither loopback nor listed here, so a
451
+ * non-loopback (`0.0.0.0`) deployment must declare the names it is reached
452
+ * by; the Web runtime derives LAN IP literals from an active all-interface
453
+ * bind. An entry that is not a bare, canonical authority fails plugin load.
454
+ */
455
+ trustedHosts?: string[]
456
+ /** Absolute browser-session lifetime in days. Default: 30. */
457
+ cookieMaxAgeDays?: number
458
+ /** Maximum buffered JSON body for every `/api` request. Default: 300 MiB. */
459
+ maxRequestBodyBytes?: number
460
+ }
461
+
462
+ /** Timing for generation readiness and automatic reconnection. */
463
+ export interface ConnectionRecoveryConfig {
464
+ /** First-retry delay cap in ms; actual delay is 50-100% of the cap. Default: 500. */
465
+ backoffBaseMs?: number
466
+ /** Finite growth factor of at least 1 per failed attempt; 1 keeps a fixed cap. Default: 2. */
467
+ backoffFactor?: number
468
+ /** Maximum retry delay cap in ms; retries continue at this cap. Default: 10000. */
469
+ backoffMaxMs?: number
470
+ /**
471
+ * Delay before reporting a slow handshake, without cancelling it. Default: 3000.
472
+ * Omitted when readiness, failure, cancellation, or the hard deadline occurs first.
473
+ */
474
+ generationReadyWarnMs?: number
475
+ /** Deadline in ms for readiness, including physical connection setup. Default: 15000. */
476
+ generationReadyTimeoutMs?: number
477
+ }
478
+ ```
479
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-client-connection -->
480
+
481
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-client-hmr -->
482
+ <a id="deepseek-aidsh-client-hmr"></a>
483
+
484
+ ## `@deepseek-ai/dsh-client-hmr`
485
+
486
+ - `inject`: `clientModules` · `webServer`
487
+ - `source`: [`packages/client/hmr/src/index.ts:30`](../packages/client/hmr/src/index.ts)
488
+
489
+ ```ts config-catalog
490
+ /** Plugin config, validated by the same-named schemastery schema. */
491
+ export interface Config {
492
+ /** Bundle stat-poll interval in milliseconds (default 500, the build-side watcher's polling default). */
493
+ pollIntervalMs?: number
494
+ }
495
+ ```
496
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-client-hmr -->
497
+
498
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-client-product-analytics -->
499
+ <a id="deepseek-aidsh-client-product-analytics"></a>
500
+
501
+ ## `@deepseek-ai/dsh-client-product-analytics`
502
+
503
+ - `inject`: `deepseekAccount` · `productTelemetry`
504
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
505
+ - `source`: [`packages/client/product-analytics/src/index.ts:14`](../packages/client/product-analytics/src/index.ts)
506
+
507
+ ```ts config-catalog
508
+ /** Application-owned collection policy; no user settings surface. */
509
+ export interface Config {
510
+ /** Live application collection policy; ordinary Web does not mount this service. */
511
+ enabled: Volatile<boolean>
512
+ /** Running Desktop release, absent when unavailable. */
513
+ appVersion?: string
514
+ }
515
+ ```
516
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-client-product-analytics -->
517
+
518
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-client-shortcuts -->
519
+ <a id="deepseek-aidsh-client-shortcuts"></a>
520
+
521
+ ## `@deepseek-ai/dsh-client-shortcuts`
522
+
523
+ - `source`: [`packages/client/shortcuts/src/config.ts:5`](../packages/client/shortcuts/src/config.ts)
524
+
525
+ ```ts config-catalog
526
+ /** Fixed shortcut sequence settings. */
527
+ export interface Config {
528
+ /** Maximum interval between independent Escape presses for stopping a reply, in milliseconds. */
529
+ stopSequenceMs: number
530
+ }
531
+ ```
532
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-client-shortcuts -->
533
+
534
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-client-ui-plugin-manager -->
535
+ <a id="deepseek-aidsh-client-ui-plugin-manager"></a>
536
+
537
+ ## `@deepseek-ai/dsh-client-ui-plugin-manager`
538
+
539
+ - `source`: [`packages/client/ui-plugin-manager/src/index.ts:15`](../packages/client/ui-plugin-manager/src/index.ts)
540
+
541
+ ```ts config-catalog
542
+ /** Registry-probe deadline and process-local cache policy. */
543
+ export interface Config {
544
+ /** Whether the dialog can compare the public npm registries. */
545
+ registryProbeEnabled: boolean
546
+ /** Deadline for the parallel HTTPS probes, including response cleanup. */
547
+ registryProbeTimeoutMs: number
548
+ /** Lifetime of a winning registry or unavailable result. */
549
+ registryProbeCacheTtlMs: number
550
+ }
551
+ ```
552
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-client-ui-plugin-manager -->
553
+
554
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-client-ui-settings-account -->
555
+ <a id="deepseek-aidsh-client-ui-settings-account"></a>
556
+
557
+ ## `@deepseek-ai/dsh-client-ui-settings-account`
558
+
559
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
560
+ - `source`: [`packages/client/ui-settings-account/src/index.ts:9`](../packages/client/ui-settings-account/src/index.ts)
561
+
562
+ ```ts config-catalog
563
+ /** Public contact options and live device-local onboarding progress. */
564
+ export interface Config extends ContactConfig {
565
+ /** Onboarding progress format version. */
566
+ version: Volatile<1>
567
+ /** Last accepted onboarding page. */
568
+ step: Volatile<OnboardingStep>
569
+ /** Selected work scenario. */
570
+ purpose?: Volatile<OnboardingPurpose | null | undefined>
571
+ /** Selected transcript detail. */
572
+ process?: Volatile<OnboardingProcess | null | undefined>
573
+ /** Completion reason, absent until completion. */
574
+ completion?: Volatile<'completed' | 'skipped' | 'api-key' | null | undefined>
575
+ /** Selected usage detail. */
576
+ usage: Volatile<'compact' | 'detailed'>
577
+ /** Selected developer-tool visibility. */
578
+ developerTools: Volatile<boolean>
579
+ }
580
+
581
+ /** Questionnaire destination and bonus notice timings shared by Host and Client. */
582
+ export interface ContactConfig {
583
+ /** HTTPS questionnaire URL; override for a test form. */
584
+ contactFormUrl: string
585
+ /** Questionnaire source option; empty until Harness is supported by the form. */
586
+ contactSource: string
587
+ /** First delay before retrying a failed bonus acknowledgement. */
588
+ bonusAckRetryDelayMs: number
589
+ /** Ceiling for the acknowledgement retry backoff. */
590
+ bonusAckRetryMaxDelayMs: number
591
+ }
592
+
593
+ /** Persisted steps; a native top-up page leaves the durable step at credit. */
594
+ export type OnboardingStep = 'welcome' | 'credit' | 'purpose' | 'process' | 'done'
595
+
596
+ /** Work scenarios offered by the desktop introduction. */
597
+ export type OnboardingPurpose = 'office' | 'development' | 'both'
598
+
599
+ /** Work-detail mode applied to Chat when onboarding completes. */
600
+ export type OnboardingProcess = 'compact' | 'standard' | 'detailed'
601
+ ```
602
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-client-ui-settings-account -->
603
+
604
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-client-ui-settings-models -->
605
+ <a id="deepseek-aidsh-client-ui-settings-models"></a>
606
+
607
+ ## `@deepseek-ai/dsh-client-ui-settings-models`
608
+
609
+ - `source`: [`packages/client/ui-settings-models/src/onboarding-config.ts:6`](../packages/client/ui-settings-models/src/onboarding-config.ts)
610
+
611
+ ```ts config-catalog
612
+ /** Onboarding options after schema defaults are applied. */
613
+ export interface Config {
614
+ /** Offer the browser API-key step when no native shell owns credential onboarding. */
615
+ credentialOnboarding: boolean
616
+ }
617
+ ```
618
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-client-ui-settings-models -->
619
+
620
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-client-ui-sidebar-documentpreview -->
621
+ <a id="deepseek-aidsh-client-ui-sidebar-documentpreview"></a>
622
+
623
+ ## `@deepseek-ai/dsh-client-ui-sidebar-documentpreview`
624
+
625
+ - `source`: [`packages/client/ui-sidebar-documentpreview/src/config.ts:5`](../packages/client/ui-sidebar-documentpreview/src/config.ts)
626
+
627
+ ```ts config-catalog
628
+ /** Transient Office conversion reuse within one Client connection. */
629
+ export interface Config {
630
+ /** Retained PDF limits; pending conversions share cancellation by reader lifetime. */
631
+ office: {
632
+ /** Maximum retained completed PDFs. */
633
+ maxCachedEntries: number
634
+ /** Maximum retained PDF bytes, counted by each binary buffer's byteLength. */
635
+ maxCachedBytes: number
636
+ /** Maximum unsettled Host conversion RPCs, including cancellation teardown. */
637
+ maxPending: number
638
+ /** Maximum readers including source and renderer metadata lookups. */
639
+ maxReaders: number
640
+ }
641
+ /** Browser spreadsheet parser and dense cell allocation limits. */
642
+ excel: {
643
+ /** Maximum source file bytes. */
644
+ maxBytes: number
645
+ /** Maximum combined rectangular cell area across worksheets. */
646
+ maxCells: number
647
+ /** Maximum parser Worker lifetime in milliseconds. */
648
+ timeoutMs: number
649
+ }
650
+ }
651
+ ```
652
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-client-ui-sidebar-documentpreview -->
653
+
654
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-client-ui-theme -->
655
+ <a id="deepseek-aidsh-client-ui-theme"></a>
656
+
657
+ ## `@deepseek-ai/dsh-client-ui-theme`
658
+
659
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
660
+ - `source`: [`packages/client/ui-theme/src/index.ts:22`](../packages/client/ui-theme/src/index.ts)
661
+
662
+ ```ts config-catalog
663
+ /** Runtime preferences projected to the browser. */
664
+ export interface Config {
665
+ /** Browser palette preference. */
666
+ preference: Volatile<ThemePreference>
667
+ /** Browser font size in pixels. */
668
+ fontSize: Volatile<number>
669
+ }
670
+
671
+ /** Theme preference persisted by the product Appearance row. */
672
+ export type ThemePreference = typeof THEME_PREFERENCES[number]
673
+ ```
674
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-client-ui-theme -->
675
+
676
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-compaction-basic -->
677
+ <a id="deepseek-aidsh-compaction-basic"></a>
678
+
679
+ ## `@deepseek-ai/dsh-compaction-basic`
680
+
681
+ - `inject`: `llm` · `tokenMeter` · `sessions`
682
+ - `source`: [`packages/compaction/compaction-basic/src/types.ts:40`](../packages/compaction/compaction-basic/src/types.ts)
683
+
684
+ ```ts config-catalog
685
+ /** Basic compaction configuration with an optional exact-target policy table. */
686
+ export interface BasicCompactionConfig extends CompactionPolicyConfig {
687
+ /** Exact provider/model overrides; duplicate targets fail plugin load. */
688
+ modelPolicies?: ModelCompactPolicyConfig[]
689
+ /** Enable automatic step-boundary pressure and overflow-recovery listeners. Defaults to `true`. */
690
+ auto?: boolean
691
+ }
692
+
693
+ /** Policy fields shared by the default policy and exact model overrides. */
694
+ export interface CompactionPolicyConfig {
695
+ /** Window fraction for pressure; capped at context window minus reserved output and `headroomTokens`. Defaults to `0.8`. */
696
+ thresholdRatio?: number
697
+ /** Additional pressure headroom beyond the routed output reservation. Non-negative integer; defaults to `65536`. */
698
+ headroomTokens?: number
699
+ /** Recent context retained as a fraction of context window minus reserved output tokens. Defaults to `0.16`. */
700
+ retainRatio?: number
701
+ /** Absolute recent-context budget; mutually exclusive with `retainRatio`. */
702
+ retainTokens?: number
703
+ /** Summary provider; set together with `summarizationModel`, or inherit the conversation target. */
704
+ summarizationProvider?: string
705
+ /** Summary model; set together with `summarizationProvider`, or inherit the conversation target. */
706
+ summarizationModel?: string
707
+ /** Provider generation cap for summarization. Defaults to the resolved `headroomTokens`; an explicit cap must be positive. */
708
+ maxTokens?: number
709
+ /** Extra attempts after the first compaction when pressure remains above threshold. Defaults to `1`. */
710
+ compactionRetries?: number
711
+ /** Maximum retries after canonical context overflow; `0` disables recovery. Defaults to `1`. */
712
+ maxOverflowRetries?: number
713
+ }
714
+
715
+ /** Exact provider/model override merged over the default compaction policy. */
716
+ export interface ModelCompactPolicyConfig extends CompactionPolicyConfig {
717
+ /** Registered provider route to match. */
718
+ provider: string
719
+ /** Exact routed model id to match within `provider`. */
720
+ model: string
721
+ }
722
+ ```
723
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-compaction-basic -->
724
+
725
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-compaction-tool-result-pruner -->
726
+ <a id="deepseek-aidsh-compaction-tool-result-pruner"></a>
727
+
728
+ ## `@deepseek-ai/dsh-compaction-tool-result-pruner`
729
+
730
+ - `inject`: `tokenMeter`
731
+ - `source`: [`packages/compaction/compaction-tool-result-pruner/src/types.ts:5`](../packages/compaction/compaction-tool-result-pruner/src/types.ts)
732
+
733
+ ```ts config-catalog
734
+ /** Character-budget policy for deterministic tool-result pruning. */
735
+ export interface ToolResultPruneConfig {
736
+ /** Prune when total text exceeds this many Unicode code points. Defaults to `8192`. */
737
+ thresholdChars?: number
738
+ /** Maximum leading Unicode code points retained. Defaults to `4096`. */
739
+ headChars?: number
740
+ /** Maximum trailing Unicode code points retained. Defaults to `1024`. */
741
+ tailChars?: number
742
+ }
743
+ ```
744
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-compaction-tool-result-pruner -->
745
+
746
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-cordis-host-runner -->
747
+ <a id="deepseek-aidsh-cordis-host-runner"></a>
748
+
749
+ ## `@deepseek-ai/dsh-cordis-host-runner`
750
+
751
+ - `inject`: `tools`
752
+ - `source`: [`packages/extensions/cordis-host-runner/src/index.ts:93`](../packages/extensions/cordis-host-runner/src/index.ts)
753
+
754
+ ```ts config-catalog
755
+ /** Runner configuration. */
756
+ export interface Config {
757
+ /** Maximum synchronous VM evaluation time in milliseconds. */
758
+ vmTimeoutMs?: number
759
+ /** Maximum wait for a valid Client inspect response in milliseconds. */
760
+ clientInspectTimeoutMs?: number
761
+ }
762
+ ```
763
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-cordis-host-runner -->
764
+
765
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-credentials-local -->
766
+ <a id="deepseek-aidsh-credentials-local"></a>
767
+
768
+ ## `@deepseek-ai/dsh-credentials-local`
769
+
770
+ - `source`: [`packages/credentials/credentials-local/src/index.ts:64`](../packages/credentials/credentials-local/src/index.ts)
771
+
772
+ ```ts config-catalog
773
+ /** Plugin config: file location and hot-reload behavior. */
774
+ export interface Config {
775
+ /** Credentials document path; defaults to `.credentials.yaml` under the harness home. */
776
+ path?: string
777
+ /** Harness home used when `path` is omitted; defaults to `$DSH_HOME` or `~/.dsh`. */
778
+ dshHome?: string
779
+ /** Watch the document and hot-publish external edits; defaults to true. */
780
+ watch?: boolean
781
+ /** Watcher write-settle window in milliseconds; defaults to 100. */
782
+ debounceMs?: number
783
+ }
784
+ ```
785
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-credentials-local -->
786
+
787
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-deepseek-account-platform -->
788
+ <a id="deepseek-aidsh-deepseek-account-platform"></a>
789
+
790
+ ## `@deepseek-ai/dsh-deepseek-account-platform`
791
+
792
+ - `inject`: `credentials` · `authorization`
793
+ - `source`: [`packages/credentials/deepseek-account-platform/src/index.ts:23`](../packages/credentials/deepseek-account-platform/src/index.ts)
794
+
795
+ ```ts config-catalog
796
+ /** Deployment-specific platform and request deadlines. */
797
+ export interface Config {
798
+ /** Platform origin serving auth-api and browser pages. */
799
+ platformOrigin?: string
800
+ /** Native desktop identity for Host API and embedded Platform requests; null identifies the client as web. */
801
+ desktopPlatform?: 'darwin' | 'win32' | null
802
+ /** Optional frontend deployment selector for embedded Usage and Top-up pages. */
803
+ embeddedPageDist?: string
804
+ /** Exact HTTP(S) origin allowed to receive account tokens for inference and files. */
805
+ inferenceOrigin?: string
806
+ /** Allow HTTP only on loopback for the development Mock. */
807
+ allowLoopbackHttp?: boolean
808
+ /** Map authorization and completion pages to platformOrigin for private development proxies. */
809
+ rewriteBrowserOrigin?: boolean
810
+ /** Host-only headers sent exclusively to platformOrigin; account authorization cannot be overridden. */
811
+ requestHeaders?: Record<string, string>
812
+ /** Overrides for profile, balance and embedded Platform requests; Cookie pairs merge by name. Logout retains requestHeaders. */
813
+ accountRequestHeaders?: Record<string, string>
814
+ /** Deadline for each platform HTTP request. */
815
+ requestTimeoutMs?: number
816
+ /** Deadline for recharge-wallet queries; timeout returns a failed balance outcome. */
817
+ balanceTimeoutMs?: number
818
+ /** Additional logout attempts after the first request fails, at most five. */
819
+ logoutMaxRetries?: number
820
+ /** Delay before the first logout retry; each later delay doubles. */
821
+ logoutRetryDelayMs?: number
822
+ /** Upper bound for the entire local attempt, even if the server advertises a longer TTL. */
823
+ attemptTimeoutMs?: number
824
+ }
825
+ ```
826
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-deepseek-account-platform -->
827
+
828
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-agent-team -->
829
+ <a id="deepseek-aidsh-experimental-agent-team"></a>
830
+
831
+ ## `@deepseek-ai/dsh-experimental-agent-team`
832
+
833
+ - `inject`: `agents` · `sessions` · `sessionPersistence` · `sessionProjections` · `subagents`
834
+ - `source`: [`packages/experimental/agent-team/src/types.ts:152`](../packages/experimental/agent-team/src/types.ts)
835
+
836
+ ```ts config-catalog
837
+ /** Team-service deployment limits. */
838
+ export interface Config {
839
+ /** Maximum immutable teammate names retained by one Team. */
840
+ readonly maxMembers?: number
841
+ /** Maximum non-deleted tasks retained by one Team. */
842
+ readonly maxTasks?: number
843
+ /** Maximum queued-minus-delivered messages for one target member. */
844
+ readonly maxPendingMessagesPerMember?: number
845
+ /** Maximum UTF-8 bytes in one complete sender-framed delivery. */
846
+ readonly maxMessageBytes?: number
847
+ /** Maximum milliseconds allowed for Team-owned runtime disposal. */
848
+ readonly disposalTimeoutMs?: number
849
+ }
850
+ ```
851
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-agent-team -->
852
+
853
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-api-speech-to-text -->
854
+ <a id="deepseek-aidsh-experimental-api-speech-to-text"></a>
855
+
856
+ ## `@deepseek-ai/dsh-experimental-api-speech-to-text`
857
+
858
+ - `inject`: `speechToText` · `typert`
859
+ - `source`: [`packages/experimental/api-speech-to-text/src/index.ts:20`](../packages/experimental/api-speech-to-text/src/index.ts)
860
+
861
+ ```ts config-catalog
862
+ /** Limits applied before decoding or calling a provider. */
863
+ export interface Config {
864
+ /** Maximum decoded WAV bytes per request. */
865
+ maxAudioBytes: number
866
+ /** Maximum PCM recording duration in seconds. */
867
+ maxDurationSeconds: number
868
+ }
869
+ ```
870
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-api-speech-to-text -->
871
+
872
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-browser-use-chrome-devtools-mcp -->
873
+ <a id="deepseek-aidsh-experimental-browser-use-chrome-devtools-mcp"></a>
874
+
875
+ ## `@deepseek-ai/dsh-experimental-browser-use-chrome-devtools-mcp`
876
+
877
+ - `inject`: `browserUse` · `agents` · `tools` · `systemPrompt`
878
+ - `refs`: `BrowserMcpConfig` (`@deepseek-ai/dsh-experimental-browser-use-runtime/mcp`)
879
+ - `source`: [`packages/experimental/browser-use-chrome-devtools-mcp/src/index.ts:14`](../packages/experimental/browser-use-chrome-devtools-mcp/src/index.ts)
880
+
881
+ ```ts config-catalog
882
+ /** Fixed Chromium launch or existing-browser attachment settings. */
883
+ export type Config = BrowserMcpConfig
884
+ ```
885
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-browser-use-chrome-devtools-mcp -->
886
+
887
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-browser-use-playwright-mcp -->
888
+ <a id="deepseek-aidsh-experimental-browser-use-playwright-mcp"></a>
889
+
890
+ ## `@deepseek-ai/dsh-experimental-browser-use-playwright-mcp`
891
+
892
+ - `inject`: `browserUse` · `agents` · `tools` · `systemPrompt`
893
+ - `refs`: `BrowserMcpConfig` (`@deepseek-ai/dsh-experimental-browser-use-runtime/mcp`)
894
+ - `source`: [`packages/experimental/browser-use-playwright-mcp/src/index.ts:15`](../packages/experimental/browser-use-playwright-mcp/src/index.ts)
895
+
896
+ ```ts config-catalog
897
+ /** Fixed Chromium launch or existing-browser attachment settings. */
898
+ export type Config = BrowserMcpConfig
899
+ ```
900
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-browser-use-playwright-mcp -->
901
+
902
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-browser-use-stagehand-native -->
903
+ <a id="deepseek-aidsh-experimental-browser-use-stagehand-native"></a>
904
+
905
+ ## `@deepseek-ai/dsh-experimental-browser-use-stagehand-native`
906
+
907
+ - `inject`: `browserUse` · `agents` · `tools` · `systemPrompt`
908
+ - `refs`: `ModelConfig` (`@browserbasehq/stagehand`)
909
+ - `source`: [`packages/experimental/browser-use-stagehand-native/src/index.ts:28`](../packages/experimental/browser-use-stagehand-native/src/index.ts)
910
+
911
+ ```ts config-catalog
912
+ /** Profile-owned browser connection and independent Stagehand model credentials. */
913
+ export interface Config {
914
+ /** Native Stagehand model and credentials; independent of the Session model. */
915
+ model: StagehandModelConfig
916
+ /** Launch a fresh browser or attach to the configured existing endpoint. */
917
+ mode: 'launch' | 'attach'
918
+ /** CDP HTTP or WebSocket endpoint, required only for attach mode. */
919
+ cdpEndpoint?: string
920
+ /** Optional Stagehand extension id for an existing browser. */
921
+ extensionId?: string
922
+ /** Installed Chrome/Chromium executable used in launch mode. */
923
+ executablePath?: string
924
+ /** Hide an owned browser's window. */
925
+ headless?: boolean
926
+ /** Deadline for Chromium startup and Stagehand navigation/action operations. */
927
+ operationTimeoutMs?: number
928
+ /** Grace for native SDK cleanup before its connection Worker is terminated. */
929
+ shutdownGraceMs?: number
930
+ }
931
+
932
+ /** Profile-owned model settings accepted by the pinned Stagehand SDK. */
933
+ export interface StagehandModelConfig {
934
+ /** Provider-prefixed model name from Stagehand's supported model catalog. */
935
+ modelName: ModelConfig['modelName']
936
+ /** Explicit API key sent to Stagehand's browser extension. */
937
+ apiKey: string
938
+ /** Additional headers sent with the extension's model requests. */
939
+ headers?: Record<string, string>
940
+ }
941
+ ```
942
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-browser-use-stagehand-native -->
943
+
944
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-computer-use-cua-driver-mcp -->
945
+ <a id="deepseek-aidsh-experimental-computer-use-cua-driver-mcp"></a>
946
+
947
+ ## `@deepseek-ai/dsh-experimental-computer-use-cua-driver-mcp`
948
+
949
+ - `inject`: `computerUse` · `tools`
950
+ - `refs`: [`McpClient`](../packages/mcp/mcp-client/src/index.ts)
951
+ - `source`: [`packages/experimental/computer-use-cua-driver-mcp/src/index.ts:20`](../packages/experimental/computer-use-cua-driver-mcp/src/index.ts)
952
+
953
+ ```ts config-catalog
954
+ /** Installed executable and MCP connection overrides. */
955
+ export interface Config {
956
+ /** Executable path or PATH command; defaults to `cua-driver`. */
957
+ command: string
958
+ /** Arguments passed without a shell; defaults to `['mcp']`. */
959
+ args: string[]
960
+ /** Per-call timeout in milliseconds; omission uses the MCP client's default. */
961
+ toolCallTimeoutMs?: number
962
+ /** Reconnection overrides; defaults to the MCP client's policy. */
963
+ reconnect: McpClient.ReconnectConfig
964
+ }
965
+ ```
966
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-computer-use-cua-driver-mcp -->
967
+
968
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-inspector -->
969
+ <a id="deepseek-aidsh-experimental-inspector"></a>
970
+
971
+ ## `@deepseek-ai/dsh-experimental-inspector`
972
+
973
+ - `inject`: `webServer`
974
+ - `source`: [`packages/experimental/inspector/src/index.ts:66`](../packages/experimental/inspector/src/index.ts)
975
+
976
+ ```ts config-catalog
977
+ /** Host plugin configuration. Fetch capture is enabled by default. */
978
+ export interface Config extends Omit<InspectorOptions, 'clientOrigins'> {
979
+ /** Browser origins allowed to open the Client ingest WebSocket. */
980
+ clientOrigins?: string[]
981
+ }
982
+
983
+ /** User-facing Host options; every memory and lifecycle bound is configurable. */
984
+ export interface InspectorOptions {
985
+ /** Loopback address used by the Worker HTTP and WebSocket endpoint. */
986
+ readonly host?: '127.0.0.1'
987
+ /** First port to bind; occupied ports advance until one is available. */
988
+ readonly port?: number
989
+ /** Additional exact browser origins admitted to the Client ingest socket. */
990
+ readonly clientOrigins?: readonly string[]
991
+ /** Whether to observe calls made through the current global fetch function. */
992
+ readonly captureFetch?: boolean
993
+ /** Maximum request-body prefix retained for one fetch. */
994
+ readonly maxRequestBodyBytes?: number
995
+ /** Maximum response-body prefix retained for one fetch. */
996
+ readonly maxResponseBodyBytes?: number
997
+ /** Maximum raw bytes encoded into one body observation. */
998
+ readonly maxBodyChunkBytes?: number
999
+ /** Maximum total request and response body bytes retained by the Worker. */
1000
+ readonly maxJournalBytes?: number
1001
+ /** Maximum active and completed fetch requests retained by the Worker. */
1002
+ readonly maxRetainedRequests?: number
1003
+ /** Maximum encoded bytes accepted in one source transport frame. */
1004
+ readonly maxSourceFrameBytes?: number
1005
+ /** Maximum observation records accepted in one source batch. */
1006
+ readonly maxSourceRecordsPerFrame?: number
1007
+ /** Maximum records waiting in one producer queue. */
1008
+ readonly maxQueuedRecords?: number
1009
+ /** Maximum encoded bytes waiting in one producer queue. */
1010
+ readonly maxQueuedBytes?: number
1011
+ /** Maximum time allowed for the Worker to become ready. */
1012
+ readonly startupTimeoutMs?: number
1013
+ /** Grace period before a stopping Worker is terminated. */
1014
+ readonly stopTimeoutMs?: number
1015
+ /** Initial upper bound for randomized Client reconnect delay. */
1016
+ readonly clientReconnectBaseMs?: number
1017
+ /** Maximum upper bound for randomized Client reconnect delay. */
1018
+ readonly clientReconnectMaxMs?: number
1019
+ /** Deadline for one Worker-to-Client Runtime or Sources request. */
1020
+ readonly clientRuntimeTimeoutMs?: number
1021
+ /** Deadline for one non-CDP semantic query. */
1022
+ readonly queryTimeoutMs?: number
1023
+ /** Maximum live object handles retained per Client Runtime session. */
1024
+ readonly maxClientRuntimeObjects?: number
1025
+ /** Maximum descriptors returned by one Client property request. */
1026
+ readonly maxClientRuntimeProperties?: number
1027
+ /** Maximum encoded bytes read for one Client script or source map. */
1028
+ readonly maxClientSourceBytes?: number
1029
+ /** Maximum Context and Fiber nodes retained in one realm snapshot. */
1030
+ readonly maxCordisNodes?: number
1031
+ /** Disconnected Cordis snapshots retained after their live realm closes. */
1032
+ readonly maxDisconnectedCordisTrees?: number
1033
+ }
1034
+ ```
1035
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-inspector -->
1036
+
1037
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-ptc-runtime-python -->
1038
+ <a id="deepseek-aidsh-experimental-ptc-runtime-python"></a>
1039
+
1040
+ ## `@deepseek-ai/dsh-experimental-ptc-runtime-python`
1041
+
1042
+ - `source`: [`packages/experimental/ptc-runtime-python/src/index.ts:42`](../packages/experimental/ptc-runtime-python/src/index.ts)
1043
+
1044
+ ```ts config-catalog
1045
+ /** Plugin config: every cap, changeable from `cordis.yml` (no hardcoded tunables). */
1046
+ export interface Config {
1047
+ /**
1048
+ * RLIMIT_CPU in whole seconds (a positive integer - `setrlimit` in the child
1049
+ * rejects a float). The child sets the soft limit to `cpuSeconds` and the
1050
+ * hard limit to `cpuSeconds + 1`: the kernel delivers SIGXCPU at the soft
1051
+ * limit, which the host classifies as a `timeout`; the +1s hard limit is a
1052
+ * SIGKILL backstop for a program that traps SIGXCPU. Granularity is whole seconds.
1053
+ */
1054
+ cpuSeconds?: number
1055
+ /** Wall-clock ceiling in milliseconds; backstops CPU time for programs awaiting a promise nobody resolves. */
1056
+ maxWallMs?: number
1057
+ /**
1058
+ * RLIMIT_AS in mebibytes; caps address space so a runaway allocation fails
1059
+ * cleanly. Not applied on Darwin, where the dyld shared cache mapped into
1060
+ * every process at exec exceeds any practical cap and the kernel rejects
1061
+ * the call; `cpuSeconds` and `maxWallMs` still bound the run there. Bounds
1062
+ * `maxLogBytes`/`maxValueBytes` at load on EVERY platform (this static check
1063
+ * runs on Darwin too, where only the runtime `setrlimit` is skipped): each
1064
+ * budget times a worst-case Unicode expansion must fit this byte count minus a
1065
+ * fixed interpreter baseline, so a near-budget output cannot breach the address
1066
+ * space during the child's build-and-encode.
1067
+ */
1068
+ addressSpaceMb?: number
1069
+ /**
1070
+ * Shared byte budget for captured log text (host-side ledger). Bounded at load
1071
+ * against `addressSpaceMb`: the child builds and encodes a near-budget entry
1072
+ * under RLIMIT_AS with several copies live at once, so this cap times the
1073
+ * worst-case Unicode expansion must fit the address space left after the
1074
+ * interpreter baseline (see `addressSpaceMb`) - a load-time rejection, not a
1075
+ * runtime clamp. Also bounded at load by the host's configured heap like
1076
+ * `maxValueBytes` (see its JSDoc): the effective frame cap minus the frame
1077
+ * envelope.
1078
+ */
1079
+ maxLogBytes?: number
1080
+ /**
1081
+ * Byte cap for the completion value. Bounded at load against `addressSpaceMb`
1082
+ * the same way `maxLogBytes` is: the child builds and encodes a near-budget
1083
+ * value under RLIMIT_AS with several copies live at once, so this cap times the
1084
+ * worst-case Unicode expansion must fit the address space left after the
1085
+ * interpreter baseline. Both budgets are ALSO bounded at load by the host's
1086
+ * configured heap: the effective frame cap (the protocol cap, or a lower
1087
+ * heap-derived ceiling when the host heap cannot safely parse a near-cap
1088
+ * frame - see `hostFrameParseCeiling`) minus the frame envelope, so a budget
1089
+ * whose honest frame could OOM the host's own JSON.parse is rejected up
1090
+ * front.
1091
+ */
1092
+ maxValueBytes?: number
1093
+ /** SIGTERM→SIGKILL grace period on kill, matching bash-local's default. */
1094
+ graceMs?: number
1095
+ /**
1096
+ * Absolute path, relative path, or basename of a CPython 3.10+ interpreter.
1097
+ * Resolved and validated once at plugin load under a five-second force-kill
1098
+ * deadline; a basename searches `PATH`.
1099
+ */
1100
+ pythonBin?: string
1101
+ }
1102
+ ```
1103
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-ptc-runtime-python -->
1104
+
1105
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-speech-to-text -->
1106
+ <a id="deepseek-aidsh-experimental-speech-to-text"></a>
1107
+
1108
+ ## `@deepseek-ai/dsh-experimental-speech-to-text`
1109
+
1110
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
1111
+ - `source`: [`packages/experimental/speech-to-text/src/index.ts:20`](../packages/experimental/speech-to-text/src/index.ts)
1112
+
1113
+ ```ts config-catalog
1114
+ /** Live selection read before a transcription starts; `configure()` writes it through the profile. */
1115
+ export interface Config {
1116
+ /** Registered provider selected when the caller omits an id. */
1117
+ defaultProvider: Volatile<string>
1118
+ /** Provider language hint selected when the caller omits one. */
1119
+ language: Volatile<string>
1120
+ }
1121
+ ```
1122
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-speech-to-text -->
1123
+
1124
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-speech-to-text-sensevoice -->
1125
+ <a id="deepseek-aidsh-experimental-speech-to-text-sensevoice"></a>
1126
+
1127
+ ## `@deepseek-ai/dsh-experimental-speech-to-text-sensevoice`
1128
+
1129
+ - `inject`: `speechToText` · `subprocess`
1130
+ - `source`: [`packages/experimental/speech-to-text-sensevoice/src/config.ts:6`](../packages/experimental/speech-to-text-sensevoice/src/config.ts)
1131
+
1132
+ ```ts config-catalog
1133
+ /** Local runtime, inference, and retention settings. */
1134
+ export interface Config {
1135
+ /** Unique registration id; consumers select this exact id. */
1136
+ providerId: string
1137
+ /** Absolute directory for verified ONNX models. */
1138
+ dataRoot: string
1139
+ /** Existing directory containing the selected ONNX model and tokens.txt; omission downloads verified files. */
1140
+ modelDirectory?: string | undefined
1141
+ /** Existing Silero VAD ONNX file; omission downloads the verified model. */
1142
+ vadModelPath?: string | undefined
1143
+ /** Weight precision; INT8 minimizes first-use download and model storage. */
1144
+ precision: 'int8' | 'fp32'
1145
+ /** Explicit Hugging Face-compatible origin; bypasses automatic selection and public fallback. */
1146
+ modelOrigin?: string | undefined
1147
+ /** Hugging Face-compatible origins compared before downloading each missing asset. */
1148
+ modelOrigins: string[]
1149
+ /** Deadline for concurrent HEAD probes, including redirects to the actual asset. */
1150
+ modelProbeTimeoutMs: number
1151
+ /** CPU intra-operation thread count. */
1152
+ threads: number
1153
+ /** Maximum speech segment length passed to the recognizer. */
1154
+ segmentSeconds: number
1155
+ /** Silero speech probability threshold. */
1156
+ vadThreshold: number
1157
+ /** Minimum speech duration retained by VAD. */
1158
+ minSpeechSeconds: number
1159
+ /** Silence separating two speech segments. */
1160
+ minSilenceSeconds: number
1161
+ /** Maximum decoded WAV bytes accepted by the private worker. */
1162
+ maxAudioBytes: number
1163
+ /** Deadline for runtime preparation and cold model loading. */
1164
+ prepareTimeoutMs: number
1165
+ /** Deadline for one inference after the worker is ready. */
1166
+ inferenceTimeoutMs: number
1167
+ /** Idle period before stopping the worker; zero keeps it warm. */
1168
+ idleTimeoutMs: number
1169
+ /** Maximum accepted running and waiting transcriptions. */
1170
+ maxPending: number
1171
+ /** Managed process termination grace period. */
1172
+ graceMs: number
1173
+ /** Maximum retained worker diagnostic bytes. */
1174
+ maxLogBytes: number
1175
+ /** Maximum transcript response bytes. */
1176
+ maxResponseBytes: number
1177
+ /** Minimum interval between intermediate download progress notifications. */
1178
+ progressIntervalMs: number
1179
+ }
1180
+ ```
1181
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-speech-to-text-sensevoice -->
1182
+
1183
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-experimental-tool-agent-team -->
1184
+ <a id="deepseek-aidsh-experimental-tool-agent-team"></a>
1185
+
1186
+ ## `@deepseek-ai/dsh-experimental-tool-agent-team`
1187
+
1188
+ - `inject`: `agents` · `agentTeams` · `tools` · `systemPrompt`
1189
+ - `source`: [`packages/experimental/tool-agent-team/src/index.ts:17`](../packages/experimental/tool-agent-team/src/index.ts)
1190
+
1191
+ ```ts config-catalog
1192
+ /** Tool routing configuration. */
1193
+ export interface Config {
1194
+ /** Continuable-subagent provider used for fresh teammates. */
1195
+ readonly freshProvider?: string
1196
+ /** Continuable-subagent provider used for completed-prefix fork teammates. */
1197
+ readonly forkProvider?: string
1198
+ }
1199
+ ```
1200
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-experimental-tool-agent-team -->
1201
+
1202
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-file-reference-local -->
1203
+ <a id="deepseek-aidsh-file-reference-local"></a>
1204
+
1205
+ ## `@deepseek-ai/dsh-file-reference-local`
1206
+
1207
+ - `inject`: `agents`
1208
+ - `source`: [`packages/context/file-reference-local/src/index.ts:34`](../packages/context/file-reference-local/src/index.ts)
1209
+
1210
+ ```ts config-catalog
1211
+ /** Local file-reference discovery configuration. */
1212
+ export interface Config {
1213
+ /** Maximum ranked candidates returned for one query. */
1214
+ maxResults?: number
1215
+ /** Maximum indexed files and directories per agent workspace. */
1216
+ maxEntries?: number
1217
+ /** Directory basenames never traversed or offered. */
1218
+ excludedDirectories?: string[]
1219
+ }
1220
+ ```
1221
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-file-reference-local -->
1222
+
1223
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-fs-local -->
1224
+ <a id="deepseek-aidsh-fs-local"></a>
1225
+
1226
+ ## `@deepseek-ai/dsh-fs-local`
1227
+
1228
+ - `source`: [`packages/fs/fs-local/src/index.ts:45`](../packages/fs/fs-local/src/index.ts)
1229
+
1230
+ ```ts config-catalog
1231
+ /** Configuration for the local filesystem backend. */
1232
+ export interface Config {
1233
+ /** Base directory for relative paths. Defaults to `process.cwd()`. */
1234
+ cwd?: string
1235
+ /**
1236
+ * Exclusive UTF-8 byte limit on each overwrite-diff side, capped by the
1237
+ * runtime's safe allocation/decode maximum. Defaults to 10 MiB.
1238
+ */
1239
+ diffBasisMaxBytes?: number
1240
+ }
1241
+ ```
1242
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-fs-local -->
1243
+
1244
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-fs-sandbox -->
1245
+ <a id="deepseek-aidsh-fs-sandbox"></a>
1246
+
1247
+ ## `@deepseek-ai/dsh-fs-sandbox`
1248
+
1249
+ - `inject`: `sandboxPolicy`
1250
+ - `refs`: [`LocalConfig`](#deepseek-aidsh-fs-local)
1251
+ - `source`: [`packages/fs/fs-sandbox/src/index.ts:45`](../packages/fs/fs-sandbox/src/index.ts)
1252
+
1253
+ ```ts config-catalog
1254
+ /**
1255
+ * Plugin config: the local backend's knobs verbatim (`cwd` resolution default
1256
+ * and `diffBasisMaxBytes` overwrite-presentation bound). The sandbox default
1257
+ * (mode + `workspace-write` fallback root) is NOT here - `ctx.sandboxPolicy`
1258
+ * resolves each calling session for every enforcing capability.
1259
+ */
1260
+ export type Config = LocalConfig
1261
+ ```
1262
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-fs-sandbox -->
1263
+
1264
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-goal -->
1265
+ <a id="deepseek-aidsh-goal"></a>
1266
+
1267
+ ## `@deepseek-ai/dsh-goal`
1268
+
1269
+ - `inject`: `agents` · `sessionProjections`
1270
+ - `source`: [`packages/goal/goal/src/index.ts:172`](../packages/goal/goal/src/index.ts)
1271
+
1272
+ ```ts config-catalog
1273
+ /** Deployment defaults for goal creation. */
1274
+ export interface Config {
1275
+ /** Total rounds used when a create request omits its own cap. */
1276
+ defaultMaxGoalRounds?: number
1277
+ }
1278
+ ```
1279
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-goal -->
1280
+
1281
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-headless -->
1282
+ <a id="deepseek-aidsh-headless"></a>
1283
+
1284
+ ## `@deepseek-ai/dsh-headless`
1285
+
1286
+ - `inject`: `agentDefaultModel` · `agents` · `sessions`
1287
+ - `source`: [`packages/bundle/headless/src/index.ts:42`](../packages/bundle/headless/src/index.ts)
1288
+
1289
+ ```ts config-catalog
1290
+ /** Plugin config: the task and run options resolved from this app's injected provider service. */
1291
+ export interface Config {
1292
+ /** The prompt text for the single run; absent when the task arrives on stdin. */
1293
+ task?: string
1294
+ /** Exact Session identity to adopt; absent for a fresh random identity. An id with no stored Session fails. */
1295
+ sessionId?: string
1296
+ /** Whether stdout carries the machine-readable event stream instead of final text. */
1297
+ json?: boolean
1298
+ }
1299
+ ```
1300
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-headless -->
1301
+
1302
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-hmr -->
1303
+ <a id="deepseek-aidsh-hmr"></a>
1304
+
1305
+ ## `@deepseek-ai/dsh-hmr`
1306
+
1307
+ - `refs`: `ChokidarOptions` (`chokidar`)
1308
+ - `source`: [`packages/boot/hmr/src/index.ts:51`](../packages/boot/hmr/src/index.ts)
1309
+
1310
+ ```ts config-catalog
1311
+ /** Module roots and watcher timing, with Chokidar deployment options. */
1312
+ export interface HmrConfig extends ChokidarOptions {
1313
+ /** Directory resolved against the owning context's base URL. */
1314
+ base?: string
1315
+ /** Module watch roots; an empty list leaves only explicit configuration watches. */
1316
+ root: string[]
1317
+ /** Milliseconds for combining module changes. */
1318
+ debounce: number
1319
+ /** Glob patterns excluded from module watching. */
1320
+ ignored: string[]
1321
+ }
1322
+ ```
1323
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-hmr -->
1324
+
1325
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-hooks-claude-code -->
1326
+ <a id="deepseek-aidsh-hooks-claude-code"></a>
1327
+
1328
+ ## `@deepseek-ai/dsh-hooks-claude-code`
1329
+
1330
+ - `inject`: `shell` · `sessionProjections`
1331
+ - `source`: [`packages/hooks/hooks-claude-code/src/index.ts:51`](../packages/hooks/hooks-claude-code/src/index.ts)
1332
+
1333
+ ```ts config-catalog
1334
+ /** Plugin config: where the CC hook config lives + substitution roots. */
1335
+ export interface Config {
1336
+ /**
1337
+ * Path to a `hooks.json` or a settings file whose `hooks` key holds the config.
1338
+ * Process-level: read once at load, a relative path resolves against the process
1339
+ * launch cwd, so one config applies to the whole process.
1340
+ * TODO(per-session-hook-config): per-session discovery of a project-local
1341
+ * `hooks.json` from each `session/new.cwd`.
1342
+ */
1343
+ configPath: string
1344
+ /**
1345
+ * Replaces `${CLAUDE_PLUGIN_ROOT}` in command strings (the plugin's root dir).
1346
+ */
1347
+ pluginRoot?: string
1348
+ /**
1349
+ * Replaces `${CLAUDE_PROJECT_DIR}` in command strings AND is exported as the
1350
+ * `CLAUDE_PROJECT_DIR` env var for hook processes. When omitted, the env var
1351
+ * defaults per-run to the agent's session workspace (`session.header.cwd`, the
1352
+ * same dir the hook runs in) - Claude Code always exports this var, and common
1353
+ * unmodified hooks reference `$CLAUDE_PROJECT_DIR` for project-relative paths.
1354
+ */
1355
+ projectDir?: string
1356
+ /** Default per-hook timeout in ms when a hook sets none (CC default: 600000). */
1357
+ defaultTimeoutMs?: number
1358
+ /** Character cap for the `hook/result` event's persisted stderr summary. */
1359
+ stderrSummaryMaxChars?: number
1360
+ }
1361
+ ```
1362
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-hooks-claude-code -->
1363
+
1364
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-hooks-codex -->
1365
+ <a id="deepseek-aidsh-hooks-codex"></a>
1366
+
1367
+ ## `@deepseek-ai/dsh-hooks-codex`
1368
+
1369
+ - `inject`: `shell` · `sessionProjections`
1370
+ - `source`: [`packages/hooks/hooks-codex/src/index.ts:50`](../packages/hooks/hooks-codex/src/index.ts)
1371
+
1372
+ ```ts config-catalog
1373
+ /** Plugin config: where the Codex hooks.json lives + the model name for payloads. */
1374
+ export interface Config {
1375
+ /**
1376
+ * Path to a Codex `hooks.json`. Process-level: read once at load, a relative
1377
+ * path resolves against the process launch cwd.
1378
+ * TODO(per-session-hook-config): per-session project-local discovery from each
1379
+ * `session/new.cwd`.
1380
+ */
1381
+ configPath: string
1382
+ /** The model name stamped on every payload (Codex includes `model` on each event). */
1383
+ model?: string
1384
+ /** Default per-hook timeout in ms when a hook sets none (Codex default: 600000). */
1385
+ defaultTimeoutMs?: number
1386
+ /** Character cap for the `hook/result` event's persisted stderr summary. */
1387
+ stderrSummaryMaxChars?: number
1388
+ }
1389
+ ```
1390
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-hooks-codex -->
1391
+
1392
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-host-directory-picker-browse -->
1393
+ <a id="deepseek-aidsh-host-directory-picker-browse"></a>
1394
+
1395
+ ## `@deepseek-ai/dsh-host-directory-picker-browse`
1396
+
1397
+ - `source`: [`packages/host/directory-picker-browse/src/index.ts:181`](../packages/host/directory-picker-browse/src/index.ts)
1398
+
1399
+ ```ts config-catalog
1400
+ /** Validated plugin configuration. */
1401
+ export interface Config {
1402
+ /** Complete-result bound of one listing level; see {@link BrowseDirectoryPicker.Config}. */
1403
+ maxEntries: number
1404
+ }
1405
+ ```
1406
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-host-directory-picker-browse -->
1407
+
1408
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-host-frontend-static -->
1409
+ <a id="deepseek-aidsh-host-frontend-static"></a>
1410
+
1411
+ ## `@deepseek-ai/dsh-host-frontend-static`
1412
+
1413
+ - `inject`: `webServer` · `connection`
1414
+ - `source`: [`packages/host/frontend-static/src/index.ts:30`](../packages/host/frontend-static/src/index.ts)
1415
+
1416
+ ```ts config-catalog
1417
+ /** Plugin config: the dist anchor. */
1418
+ export interface Config {
1419
+ /** Absolute path of index.html inside the dist root. */
1420
+ distIndex: string
1421
+ }
1422
+ ```
1423
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-host-frontend-static -->
1424
+
1425
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-host-open-in-app -->
1426
+ <a id="deepseek-aidsh-host-open-in-app"></a>
1427
+
1428
+ ## `@deepseek-ai/dsh-host-open-in-app`
1429
+
1430
+ - `inject`: `webServer` · `connection` · `subprocess`
1431
+ - `source`: [`packages/host/open-in-app/src/index.ts:50`](../packages/host/open-in-app/src/index.ts)
1432
+
1433
+ ```ts config-catalog
1434
+ /** Open-in-app host configuration. */
1435
+ export interface Config {
1436
+ /**
1437
+ * Per-command deadline in milliseconds for catalog-resolution host
1438
+ * commands (`xcode-select`, the Windows registry reads).
1439
+ */
1440
+ readonly probeTimeoutMs: number
1441
+ /**
1442
+ * Per-command deadline in milliseconds for icon-extraction host commands
1443
+ * (`plutil`/`sips` on macOS, the PowerShell extraction on Windows).
1444
+ */
1445
+ readonly iconTimeoutMs: number
1446
+ /**
1447
+ * Early-failure watch window per launch, in milliseconds: a launcher still
1448
+ * running when the window closes counts as launched and keeps running, so
1449
+ * this bounds how long the open route holds a successful launch, not how
1450
+ * long an application may live.
1451
+ */
1452
+ readonly launchWatchMs: number
1453
+ }
1454
+ ```
1455
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-host-open-in-app -->
1456
+
1457
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-host-product-telemetry-otel -->
1458
+ <a id="deepseek-aidsh-host-product-telemetry-otel"></a>
1459
+
1460
+ ## `@deepseek-ai/dsh-host-product-telemetry-otel`
1461
+
1462
+ - `inject`: `otel`
1463
+ - `source`: [`packages/host/product-telemetry-otel/src/index.ts:18`](../packages/host/product-telemetry-otel/src/index.ts)
1464
+
1465
+ ```ts config-catalog
1466
+ /** Collector routing, application identity, and bounded in-memory batch settings. */
1467
+ export interface Config {
1468
+ /** Full HTTP(S) logs URL. */
1469
+ endpoint: string
1470
+ /** Collector routing header. */
1471
+ channel: string
1472
+ /** Resource service.name supplied by the application composition. */
1473
+ serviceName: string
1474
+ /** Resource service.version supplied by the application composition. */
1475
+ serviceVersion: string
1476
+ /** Omit to honor OTEL_EXPORTER_OTLP_LOGS_COMPRESSION / OTEL_EXPORTER_OTLP_COMPRESSION. */
1477
+ compression?: 'none' | 'gzip'
1478
+ /** Maximum records per export; must not exceed maxQueueSize. */
1479
+ maxExportBatchSize: number
1480
+ /** Maximum queued records; the SDK drops new records when full. */
1481
+ maxQueueSize: number
1482
+ /** Delay before exporting a partial batch. */
1483
+ scheduledDelayMillis: number
1484
+ /** Exporter HTTP deadline, including SDK transient-error retries. */
1485
+ timeoutMillis: number
1486
+ /** Processor deadline for one batch export. */
1487
+ exportTimeoutMillis: number
1488
+ /** Drain deadline; expiry cancels pending exports before disposal completes. */
1489
+ shutdownTimeoutMillis: number
1490
+ }
1491
+ ```
1492
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-host-product-telemetry-otel -->
1493
+
1494
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-host-webserver -->
1495
+ <a id="deepseek-aidsh-host-webserver"></a>
1496
+
1497
+ ## `@deepseek-ai/dsh-host-webserver`
1498
+
1499
+ - `source`: [`packages/host/webserver/src/index.ts:59`](../packages/host/webserver/src/index.ts)
1500
+
1501
+ ```ts config-catalog
1502
+ /** Web server listen and response-compression config. */
1503
+ export interface Config {
1504
+ /** Listen host; the two supported values are loopback and all-interfaces. */
1505
+ host: '127.0.0.1' | '0.0.0.0'
1506
+ /** Listen port; zero requests an OS-assigned port. */
1507
+ port: number
1508
+ /** Response compression for socket-backed HTTP requests. @default 'none' */
1509
+ compression?: 'none' | 'gzip'
1510
+ /** Gzip DEFLATE level from 0 through 9. @default 1 */
1511
+ compressionLevel?: number
1512
+ /** Minimum known response length eligible for gzip; unknown-length streams are eligible. @default 1024 */
1513
+ compressionThresholdBytes?: number
1514
+ }
1515
+ ```
1516
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-host-webserver -->
1517
+
1518
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-invariants -->
1519
+ <a id="deepseek-aidsh-invariants"></a>
1520
+
1521
+ ## `@deepseek-ai/dsh-invariants`
1522
+
1523
+ - `source`: [`packages/runtime-diagnostics/invariants/src/index.ts:15`](../packages/runtime-diagnostics/invariants/src/index.ts)
1524
+
1525
+ ```ts config-catalog
1526
+ /** Runtime invariant selection configured on the service plugin. */
1527
+ export interface Config {
1528
+ /** Global switch; defaults to `true`. */
1529
+ readonly enabled?: boolean
1530
+ /** Case-sensitive JavaScript regex sources that admit package names; empty admits all. */
1531
+ readonly package_allowlist?: string[]
1532
+ /** Case-sensitive JavaScript regex sources that exclude package names after allowlist matching. */
1533
+ readonly package_blocklist?: string[]
1534
+ }
1535
+ ```
1536
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-invariants -->
1537
+
1538
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-jobs-local -->
1539
+ <a id="deepseek-aidsh-jobs-local"></a>
1540
+
1541
+ ## `@deepseek-ai/dsh-jobs-local`
1542
+
1543
+ - `source`: [`packages/jobs/jobs-local/src/index.ts:45`](../packages/jobs/jobs-local/src/index.ts)
1544
+
1545
+ ```ts config-catalog
1546
+ /** Configuration for the process-local job registry. */
1547
+ export interface Config {
1548
+ /**
1549
+ * Maximum `running` plus `stopping` jobs per exact owner or in the shared unowned bucket;
1550
+ * omission defaults to 10.
1551
+ */
1552
+ maxConcurrentJobsPerOwner?: number
1553
+ /** Live ring retention per job in UTF-8 bytes; omission defaults to 262144. */
1554
+ retainBytes?: number
1555
+ /**
1556
+ * Ring retention kept after a job settles, in UTF-8 bytes; omission defaults to 16384.
1557
+ * Settlement keeps every byte the model cursor has not consumed on top of
1558
+ * this cap; the first terminal model read then trims to it.
1559
+ */
1560
+ settledRetainBytes?: number
1561
+ /** Poll interval for a job's pull sources, in milliseconds; omission defaults to 150. */
1562
+ pumpPollMs?: number
1563
+ }
1564
+ ```
1565
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-jobs-local -->
1566
+
1567
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-llm-deepseek-account -->
1568
+ <a id="deepseek-aidsh-llm-deepseek-account"></a>
1569
+
1570
+ ## `@deepseek-ai/dsh-llm-deepseek-account`
1571
+
1572
+ - `inject`: `llm`
1573
+ - `refs`: [`ProtocolConfig`](../packages/llm/llm-deepseek/src/index.ts)
1574
+ - `source`: [`packages/llm/llm-deepseek-account/src/config.ts:5`](../packages/llm/llm-deepseek-account/src/config.ts)
1575
+
1576
+ ```ts config-catalog
1577
+ /** Account route configuration; authentication comes exclusively from the account service. */
1578
+ export type Config = ProtocolConfig
1579
+ ```
1580
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-llm-deepseek-account -->
1581
+
1582
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-llm-deepseek-api-key -->
1583
+ <a id="deepseek-aidsh-llm-deepseek-api-key"></a>
1584
+
1585
+ ## `@deepseek-ai/dsh-llm-deepseek-api-key`
1586
+
1587
+ - `inject`: `llm`
1588
+ - `refs`: [`ProtocolConfig`](../packages/llm/llm-deepseek/src/index.ts) · `Volatile` (`@deepseek-ai/cordis`)
1589
+ - `source`: [`packages/llm/llm-deepseek-api-key/src/config.ts:10`](../packages/llm/llm-deepseek-api-key/src/config.ts)
1590
+
1591
+ ```ts config-catalog
1592
+ /** Messages configuration with a per-request API-key reference. */
1593
+ export interface Config extends ProtocolConfig {
1594
+ /** Credential reference resolved per request; defaults to DEEPSEEK_API_KEY. */
1595
+ apiKeyEnv: Volatile<string>
1596
+ }
1597
+ ```
1598
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-llm-deepseek-api-key -->
1599
+
1600
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-llm-pi-ai -->
1601
+ <a id="deepseek-aidsh-llm-pi-ai"></a>
1602
+
1603
+ ## `@deepseek-ai/dsh-llm-pi-ai`
1604
+
1605
+ - `inject`: `llm`
1606
+ - `refs`: `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`) · `Volatile` (`@deepseek-ai/cordis`)
1607
+ - `source`: [`packages/llm/llm-pi-ai/src/config.ts:222`](../packages/llm/llm-pi-ai/src/config.ts)
1608
+
1609
+ ```ts config-catalog
1610
+ /** Plugin configuration: the provider routes this instance owns. */
1611
+ export interface Config {
1612
+ /**
1613
+ * pi-ai provider routes, keyed by provider. An empty (or omitted) dict is
1614
+ * the dormant settings-driven posture: the adapter mounts with no routes
1615
+ * and registers them the moment a settings section supplies profiles.
1616
+ */
1617
+ providers: Volatile<Record<string, PiAiProviderProfile>>
1618
+ }
1619
+
1620
+ /** Configuration for one pi-ai provider route; the `providers` dict key IS the route. */
1621
+ export interface PiAiProviderProfile {
1622
+ /** Credential reference (environment-variable name) resolved per request through `ctx.credentials`. */
1623
+ apiKeyEnv?: string
1624
+ /** Name shown by configuration surfaces; defaults to the route key. */
1625
+ displayName?: string
1626
+ /**
1627
+ * Wire protocol every model on this route speaks. Omission keeps each
1628
+ * installed catalog model's own protocol, which is why a catalog route needs
1629
+ * no protocol at all; a route the catalog does not ship must name one.
1630
+ */
1631
+ api?: string
1632
+ /** Endpoint for this route's models; defaults to the installed catalog's endpoint. */
1633
+ baseURL?: string
1634
+ /**
1635
+ * This route's model catalog. Omission serves the installed catalog for the
1636
+ * route unchanged; an explicit list replaces it, each entry defaulting its
1637
+ * unset fields from the installed model of the same id.
1638
+ */
1639
+ models?: PiAiModelProfile[]
1640
+ /**
1641
+ * Installed-catalog customizations by model id: each entry reshapes that
1642
+ * one model with the same fields a {@link models} entry takes, while the
1643
+ * rest of the catalog keeps serving untouched. Only meaningful on a catalog
1644
+ * route with no `models` list - `models` already replaces the catalog, so
1645
+ * an override beside it, on a route the catalog does not ship, or naming a
1646
+ * model the catalog does not describe is refused rather than skipped.
1647
+ */
1648
+ modelOverrides?: Record<string, PiAiModelOverride>
1649
+ /**
1650
+ * pi-ai wire-compatibility switches defaulting every model on this route
1651
+ * whose protocol declares them; each model's own `compat` overrides per
1652
+ * field. What neither sets keeps the installed catalog entry's value, then
1653
+ * pi-ai's own detection. A switch no model on the route could read is
1654
+ * refused rather than left looking applied.
1655
+ */
1656
+ compat?: PiAiCompatProfile
1657
+ /**
1658
+ * Context capacity for a model this route lists that neither the entry nor
1659
+ * the installed catalog sizes (default 262,144). A guess by construction, so
1660
+ * a deployment whose gateway serves smaller models corrects it here.
1661
+ */
1662
+ defaultContextWindow?: number
1663
+ /**
1664
+ * Output capability for a model this route lists that neither the entry nor
1665
+ * the installed catalog sizes (default 32,768). This sizes the model; it
1666
+ * never becomes a per-request cap on its own.
1667
+ */
1668
+ defaultMaxTokens?: number
1669
+ /**
1670
+ * Request modalities for a model this route lists that neither its entry's
1671
+ * {@link PiAiModelProfile.input} nor the installed catalog declares (default
1672
+ * `[text]`). A fallback like the capacities above, not an override: a
1673
+ * catalog model keeps the modalities the catalog records for it, and this
1674
+ * value never narrows one. A gateway serving vision models the catalog does
1675
+ * not describe declares `[text, image]` once here instead of on every entry.
1676
+ * Unlike an entry's list, this one may not be empty - nothing sits below it
1677
+ * to answer instead.
1678
+ */
1679
+ defaultInput?: PiAiModality[]
1680
+ /** Provider request headers, validated against Fetch when the profile resolves; Harness attribution wins reserved names. */
1681
+ headers?: Record<string, string>
1682
+ /** Provider-neutral pi-ai reasoning level. */
1683
+ reasoning?: ModelThinkingLevel
1684
+ /** Token budgets used by reasoning providers that support them. */
1685
+ thinkingBudgets?: ThinkingBudgets
1686
+ /** Prompt-cache retention preference. */
1687
+ cacheRetention?: CacheRetention
1688
+ /** Streaming transport preference. */
1689
+ transport?: Transport
1690
+ /** HTTP/provider SDK timeout in milliseconds. */
1691
+ timeoutMs?: number
1692
+ /** WebSocket connection timeout in milliseconds. */
1693
+ websocketConnectTimeoutMs?: number
1694
+ /** Maximum provider idle time while one stream read is outstanding. */
1695
+ streamIdleTimeoutMs?: number
1696
+ /**
1697
+ * Maximum base64-encoded image payload per request. When a request's
1698
+ * accumulated images exceed it, the oldest images are replaced by text
1699
+ * placeholders until the request fits, so a long session keeps completing
1700
+ * requests instead of being rejected by a request-size cap.
1701
+ */
1702
+ maxRequestImageBytes?: number
1703
+ /** Total-pixel budget for each deterministic inline request version. */
1704
+ requestImagePixelBudget?: number
1705
+ /**
1706
+ * Raw encoded-byte target for each deterministic inline request version;
1707
+ * the smallest quality-ladder output is used when no quality fits.
1708
+ */
1709
+ requestImageMaxBytes?: number
1710
+ /** Provider-owned model-request retry policy; omission uses normal mode with five retries. */
1711
+ retryPolicy?: RetryPolicyConfig
1712
+ }
1713
+
1714
+ /** One configured model entry: an id plus the catalog fields it overrides. */
1715
+ export interface PiAiModelProfile {
1716
+ /** Model id sent to the provider and accepted by {@link GenerateOptions.model}. */
1717
+ id: string
1718
+ /** Display name for selectors; defaults to the catalog name, then the id. */
1719
+ name?: string
1720
+ /** Maximum combined request and response context in tokens. */
1721
+ contextWindow?: number
1722
+ /**
1723
+ * Maximum output tokens. Configuring one also makes it this model's
1724
+ * per-request default; a value inherited from the installed catalog, or the
1725
+ * route's fallback, is the model's capability and never becomes a request
1726
+ * default on its own.
1727
+ */
1728
+ maxTokens?: number
1729
+ /**
1730
+ * Request modalities this model accepts. Absent - or empty, which describes
1731
+ * a model that accepts nothing and so states no answer either - keeps the
1732
+ * installed catalog entry's modalities, then the route's `defaultInput`.
1733
+ * Declaring images is what makes a hand-declared vision model usable, and
1734
+ * declaring text alone corrects a catalog model whose gateway does not serve
1735
+ * what the catalog records. This is a claim about the endpoint, not a check
1736
+ * of it: nothing interrogates a gateway for what it accepts, so a model
1737
+ * claiming images its endpoint refuses is refused by the provider instead,
1738
+ * mid-turn.
1739
+ */
1740
+ input?: PiAiModality[]
1741
+ /**
1742
+ * Selectable reasoning efforts. Absent inherits the installed catalog
1743
+ * entry's capability (a hand-declared model has none and does not reason);
1744
+ * `false` declares a non-reasoning model, which is how a profile strips
1745
+ * reasoning from a catalog model its gateway cannot serve; a non-empty dict
1746
+ * declares the offered levels and their wire spellings.
1747
+ */
1748
+ reasoningEfforts?: false | PiAiReasoningEfforts
1749
+ /** pi-ai wire-compatibility switches for this model, winning over the route's per field; one its protocol does not declare is refused. */
1750
+ compat?: PiAiCompatProfile
1751
+ }
1752
+
1753
+ /**
1754
+ * Customization of one installed catalog model, keyed by its id in the
1755
+ * route's `modelOverrides` dict - the same fields a `models` entry may set,
1756
+ * with the id living in the key. Unlike a `models` list, overrides leave the
1757
+ * rest of the catalog serving untouched, which is what makes "correct one
1758
+ * model, keep the other thirty-seven" a three-line edit.
1759
+ */
1760
+ export type PiAiModelOverride = Omit<PiAiModelProfile, 'id'>
1761
+
1762
+ /**
1763
+ * pi-ai wire-compatibility switches, set on the route (its models' default) or
1764
+ * per model (winning over the route, field by field).
1765
+ *
1766
+ * pi-ai decides each of these from the provider id and baseURL when no layer
1767
+ * sets it, and a private gateway's URL says nothing: for an endpoint it does
1768
+ * not recognize the detection answers as though it were OpenAI itself, which
1769
+ * is wrong for most OpenAI-compatible gateways. So every field here is one a
1770
+ * deployment must be able to state because nothing can infer it, while the
1771
+ * fields pi-ai's catalog sets for a named vendor stay withheld.
1772
+ *
1773
+ * A field belongs to the protocols whose upstream compat type declares it: a
1774
+ * model-level switch its protocol does not take fails resolution, and a
1775
+ * route-level one skips past models it cannot fit. "The three Responses
1776
+ * protocols" below means `openai-responses`, `azure-openai-responses`, and
1777
+ * `openai-codex-responses`, which pi-ai gives one shared compat type, so a
1778
+ * switch settable on one is settable on all three.
1779
+ */
1780
+ export interface PiAiCompatProfile {
1781
+ /** Whether the endpoint accepts `store`; `openai-completions`. */
1782
+ supportsStore?: boolean
1783
+ /**
1784
+ * Whether the endpoint accepts the `developer` role for the system prompt,
1785
+ * which pi-ai sends only to a reasoning model; `false` keeps `system`.
1786
+ * `openai-completions` and the three Responses protocols.
1787
+ */
1788
+ supportsDeveloperRole?: boolean
1789
+ /** Whether the endpoint accepts `reasoning_effort`; `openai-completions`. */
1790
+ supportsReasoningEffort?: boolean
1791
+ /** Whether the endpoint accepts `stream_options: {include_usage: true}`; `openai-completions`. */
1792
+ supportsUsageInStreaming?: boolean
1793
+ /**
1794
+ * Whether streams include `finish_reason`; `false` lets pi-ai infer the
1795
+ * terminal reason when the stream ends; `openai-completions`.
1796
+ */
1797
+ supportsFinishReason?: boolean
1798
+ /** Which output-cap field the endpoint reads; `openai-completions`. */
1799
+ maxTokensField?: NonNullable<OpenAICompletionsCompat['maxTokensField']>
1800
+ /** Whether tool results must carry `name`; `openai-completions`. */
1801
+ requiresToolResultName?: boolean
1802
+ /** Whether a user message after tool results needs an assistant message between; `openai-completions`. */
1803
+ requiresAssistantAfterToolResult?: boolean
1804
+ /** Whether thinking blocks must travel as text in `<thinking>` delimiters; `openai-completions`. */
1805
+ requiresThinkingAsText?: boolean
1806
+ /** Whether replayed assistant messages need an empty `reasoning_content` while reasoning is on; `openai-completions`. */
1807
+ requiresReasoningContentOnAssistantMessages?: boolean
1808
+ /** Reasoning parameter format the endpoint expects; `openai-completions`. */
1809
+ thinkingFormat?: PiAiThinkingFormat
1810
+ /**
1811
+ * Kwargs sent as `chat_template_kwargs`, which pi-ai reads only under the
1812
+ * two `chat-template` thinking formats; `openai-completions`. Nothing checks
1813
+ * that pairing: the format in force may come from the installed catalog
1814
+ * entry or from pi-ai's own baseURL detection, neither of which resolution
1815
+ * can read, so kwargs set beside another format are sent nowhere.
1816
+ */
1817
+ chatTemplateKwargs?: NonNullable<OpenAICompletionsCompat['chatTemplateKwargs']>
1818
+ /** Arguments sent as `chat_template_args` under the `baseten` thinking format; `openai-completions`. */
1819
+ chatTemplateArgs?: NonNullable<OpenAICompletionsCompat['chatTemplateArgs']>
1820
+ /** Alias for `thinkingTokenBudgetField: "thinking_token_budget"`; an explicit field wins. `openai-completions`. */
1821
+ supportsThinkingTokenBudget?: boolean
1822
+ /** Request field carrying the reasoning budget from `thinkingBudgets`; omitted unless configured. `openai-completions`. */
1823
+ thinkingTokenBudgetField?: PiAiThinkingTokenBudgetField
1824
+ /** vLLM scheduler `priority`; lower runs earlier, and the server must enable priority scheduling. Omitted unless configured. */
1825
+ vllmPriority?: number
1826
+ /** Whether `openai-responses` accepts `max_output_tokens`; `false` omits it. Azure and Codex ignore this shared compat field. */
1827
+ supportsMaxOutputTokens?: boolean
1828
+ /**
1829
+ * Whether the endpoint accepts `strict` in tool definitions;
1830
+ * `openai-completions`, the three Responses protocols, `bedrock-converse-stream`.
1831
+ */
1832
+ supportsStrictMode?: boolean
1833
+ /** Prompt-cache marker convention; `openai-completions`. */
1834
+ cacheControlFormat?: NonNullable<OpenAICompletionsCompat['cacheControlFormat']>
1835
+ /**
1836
+ * Whether the endpoint accepts long prompt-cache retention;
1837
+ * `openai-completions`, the three Responses protocols, `anthropic-messages`.
1838
+ */
1839
+ supportsLongCacheRetention?: boolean
1840
+ /** Whether the endpoint accepts per-tool `eager_input_streaming`; `anthropic-messages`. */
1841
+ supportsEagerToolInputStreaming?: boolean
1842
+ /** Whether the endpoint accepts `cache_control` on tool definitions; `anthropic-messages`. */
1843
+ supportsCacheControlOnTools?: boolean
1844
+ /** Whether the endpoint accepts the `temperature` request field; `anthropic-messages`. */
1845
+ supportsTemperature?: boolean
1846
+ /** Whether to force adaptive thinking regardless of model id; `anthropic-messages`. */
1847
+ forceAdaptiveThinking?: boolean
1848
+ /** Whether to replay an empty thinking signature instead of converting thinking to text; `anthropic-messages`. */
1849
+ allowEmptySignature?: boolean
1850
+ /** Whether the endpoint accepts Anthropic strict tool schemas; `anthropic-messages`. */
1851
+ supportsStrictTools?: boolean
1852
+ }
1853
+
1854
+ /** One request modality a pi-ai model may accept. */
1855
+ export type PiAiModality = Model<Api>['input'][number]
1856
+
1857
+ /**
1858
+ * Selectable reasoning efforts for one model: each key is a level the model
1859
+ * offers (and selectors show), and its value is the wire spelling dispatch
1860
+ * sends for it. `off` alone may leave its value empty - "supported, send
1861
+ * nothing" - because for most providers not thinking is the parameter's
1862
+ * absence; every other declared level must name a wire value. A level absent
1863
+ * from the dict is not offered.
1864
+ */
1865
+ export type PiAiReasoningEfforts = Partial<Record<ModelThinkingLevel, string | null>>
1866
+
1867
+ /** One reasoning-dispatch wire format a profile may name. */
1868
+ export type PiAiThinkingFormat = NonNullable<OpenAICompletionsCompat['thinkingFormat']>
1869
+
1870
+ /** The reasoning-budget field spellings pi-ai accepts. */
1871
+ export type PiAiThinkingTokenBudgetField = NonNullable<OpenAICompletionsCompat['thinkingTokenBudgetField']>
1872
+ ```
1873
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-llm-pi-ai -->
1874
+
1875
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-llm-replay -->
1876
+ <a id="deepseek-aidsh-llm-replay"></a>
1877
+
1878
+ ## `@deepseek-ai/dsh-llm-replay`
1879
+
1880
+ - `inject`: `llm`
1881
+ - `refs`: [`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts) · [`ToolUpdate`](../packages/llm/llm/src/index.ts)
1882
+ - `source`: [`packages/test-support/llm-replay/src/index.ts:1129`](../packages/test-support/llm-replay/src/index.ts)
1883
+
1884
+ ```ts config-catalog
1885
+ /** Plugin config: the {@link ReplayConfig} inputs, each defaulting to its `DSH_SNAPSHOT_*` env var in `apply`. */
1886
+ export interface Config {
1887
+ /** Override the fixture path; defaults to `$DSH_SNAPSHOT_FILE`. */
1888
+ file?: string
1889
+ /** Override the sidecar path; defaults to `$DSH_SNAPSHOT_OVERRIDE`. */
1890
+ overrideFile?: string
1891
+ /**
1892
+ * Override the child-log paths; defaults to `$DSH_SNAPSHOT_CHILD_FILES` (a
1893
+ * path-separator-delimited list). Each is a recorded subagent session log for
1894
+ * a nested-agent scenario; absent/empty for a single-session scenario.
1895
+ */
1896
+ childFiles?: string[]
1897
+ /** Optional replay-only provider catalog; absent or empty selects catch-all waterfall replay. */
1898
+ providers?: ReplayProviderConfig[]
1899
+ /** Optional per-chunk pacing delay in ms (see {@link ReplayConfig.paceMs}); absent keeps burst yield. */
1900
+ paceMs?: number
1901
+ }
1902
+
1903
+ /** One provider route exposed by the replay adapter. */
1904
+ export interface ReplayProviderConfig {
1905
+ /** Provider route used for replay requests. */
1906
+ id: string
1907
+ /** Selector label; defaults to {@link id}. */
1908
+ name?: string
1909
+ /** Advisory models exposed to replay scenarios that exercise discovery. */
1910
+ models?: ReplayModelConfig[]
1911
+ /** Optional provider-owned retry policy used by assembled recovery snapshots. */
1912
+ retryPolicy?: RetryPolicyConfig
1913
+ }
1914
+
1915
+ /** One model exposed by a replay-only provider catalog. */
1916
+ export interface ReplayModelConfig {
1917
+ /** Model id used for replay requests. */
1918
+ id: string
1919
+ /** Selector label; defaults to {@link id}. */
1920
+ name?: string
1921
+ /** Optional selector description. */
1922
+ description?: string
1923
+ /** Optional positive integer context capacity published by the replay adapter. */
1924
+ contextWindow?: number
1925
+ /** Optional declared input modalities, so a scenario can exercise capability gates (e.g. image-capable `read_image`). */
1926
+ inputModalities?: readonly ModelModality[]
1927
+ /**
1928
+ * Optional per-request output cap the replay route materializes when callers
1929
+ * omit one, so replay reconstructs the request header a live catalog produced.
1930
+ */
1931
+ defaultMaxTokens?: number
1932
+ /**
1933
+ * Optional flat visual-token price the replay route declares for every
1934
+ * retained request image, so keyless scenarios exercise route-priced
1935
+ * request pressure; each occurrence is priced at this value plus its
1936
+ * request-preview handle text. Requires {@link inputModalities} to include
1937
+ * `image` - a text-only route never sends visual tokens. Absent declares
1938
+ * no image pricing.
1939
+ */
1940
+ imageRequestTokens?: number
1941
+ /** Optional reasoning-effort ids the replay route accepts, in display order. */
1942
+ reasoningEfforts?: string[]
1943
+ /**
1944
+ * Optional effort materialized when callers omit one; must appear in
1945
+ * {@link reasoningEfforts} or call resolution rejects the route.
1946
+ */
1947
+ defaultReasoningEffort?: string
1948
+ /** Optional in-history system prompt replacement for a keyless replay route. */
1949
+ systemPromptUpdate?: SystemPromptUpdate
1950
+ /** Optional mid-conversation tool declaration mode for a keyless replay route. */
1951
+ toolUpdate?: ToolUpdate
1952
+ }
1953
+ ```
1954
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-llm-replay -->
1955
+
1956
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-llm-retry -->
1957
+ <a id="deepseek-aidsh-llm-retry"></a>
1958
+
1959
+ ## `@deepseek-ai/dsh-llm-retry`
1960
+
1961
+ - `inject`: `agents` · `sessionProjections`
1962
+ - `source`: [`packages/llm/llm-retry/src/index.ts:25`](../packages/llm/llm-retry/src/index.ts)
1963
+
1964
+ ```ts config-catalog
1965
+ /** This policy executor has no config; providers own `retryPolicy`. */
1966
+ export type Config = Readonly<Record<string, never>>
1967
+ ```
1968
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-llm-retry -->
1969
+
1970
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-lsp-stdio -->
1971
+ <a id="deepseek-aidsh-lsp-stdio"></a>
1972
+
1973
+ ## `@deepseek-ai/dsh-lsp-stdio`
1974
+
1975
+ - `inject`: `fs` · `lsp` · `subprocess`
1976
+ - `source`: [`packages/lsp/lsp-stdio/src/index.ts:82`](../packages/lsp/lsp-stdio/src/index.ts)
1977
+
1978
+ ```ts config-catalog
1979
+ /** Plugin configuration: provider id → local language-server configuration. */
1980
+ export interface Config {
1981
+ /** Non-empty table of stable provider ids to independent local server configurations. */
1982
+ servers: Record<string, LspLocalServerConfig>
1983
+ }
1984
+
1985
+ /** One configured local language server and its host bounds. */
1986
+ export interface LspLocalServerConfig {
1987
+ /** Executable to spawn (absolute, or resolved on PATH at load). */
1988
+ command: string
1989
+ /** Lowercase leading-dot extension → LSP language id (e.g. `{ '.ts': 'typescript' }`). */
1990
+ extensionToLanguage: Record<string, string>
1991
+ /** Arguments passed to the executable (no shell). Default `[]`. */
1992
+ args?: string[]
1993
+ /** Extra env vars merged on top of the scrubbed ambient env. Default `{}`. */
1994
+ env?: Record<string, string>
1995
+ /** Static `initialize` options forwarded to the server. Default `null`. */
1996
+ initializationOptions?: unknown
1997
+ /** Static answer to every `workspace/configuration` item. Default `null`. */
1998
+ configuration?: unknown
1999
+ /** Largest single framed message accepted from the server (bytes). Default 16000000. */
2000
+ maxMessageBytes?: number
2001
+ /** Largest stderr tail retained for diagnostics (bytes). Default 1000000. */
2002
+ maxStderrBytes?: number
2003
+ /** Largest source file this host will open (bytes). Default 4000000. */
2004
+ maxDocumentBytes?: number
2005
+ /** Graceful `shutdown`/`exit` budget before escalation (ms). Default 5000. */
2006
+ shutdownTimeoutMs?: number
2007
+ /** Request-cancel and SIGTERM→SIGKILL grace (ms). Default 2000. */
2008
+ killGraceMs?: number
2009
+ }
2010
+ ```
2011
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-lsp-stdio -->
2012
+
2013
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-mcp-client -->
2014
+ <a id="deepseek-aidsh-mcp-client"></a>
2015
+
2016
+ ## `@deepseek-ai/dsh-mcp-client`
2017
+
2018
+ - `inject`: `tools`
2019
+ - `source`: [`packages/mcp/mcp-client/src/index.ts:104`](../packages/mcp/mcp-client/src/index.ts)
2020
+
2021
+ ```ts config-catalog
2022
+ /** Configuration for one stdio or Streamable HTTP MCP server. */
2023
+ export type Config = StdioConfig | StreamableHttpConfig
2024
+
2025
+ /** Config for connecting to an MCP server via a spawned child process over stdio. */
2026
+ export interface StdioConfig {
2027
+ /** Selects child-process stdio transport. */
2028
+ transport: 'stdio'
2029
+ /**
2030
+ * Stable local namespace for this server's model-facing tool names
2031
+ * (`mcp__<serverName>__<rawName>`). Must match `[A-Za-z0-9_-]{1,32}` and be
2032
+ * unique across live mcp-client instances.
2033
+ */
2034
+ serverName: string
2035
+ /** Executable used to start the server. */
2036
+ command: string
2037
+ /** Arguments passed directly, without shell interpolation. */
2038
+ args: string[]
2039
+ /** Extra env vars merged on top of scrubbed ambient env. */
2040
+ env: Record<string, string>
2041
+ /** Working directory for the child process. */
2042
+ cwd: string
2043
+ /** Timeout per tool call or resource request in milliseconds. */
2044
+ toolCallTimeoutMs: number
2045
+ /** Fail plugin activation when the initial connection or tool synchronization fails. */
2046
+ failOnStartupError: boolean
2047
+ /** Maximum UTF-8 bytes of attributed server instructions (default 32768). */
2048
+ maxInstructionBytes?: number
2049
+ /** Automatic reconnect policy after a lost connection; omission uses the defaults. */
2050
+ reconnect?: ReconnectConfig
2051
+ }
2052
+
2053
+ /** Config for connecting to an MCP server over Streamable HTTP (SSE). */
2054
+ export interface StreamableHttpConfig {
2055
+ /** Selects Streamable HTTP transport. */
2056
+ transport: 'streamable-http'
2057
+ /**
2058
+ * Stable local namespace for this server's model-facing tool names
2059
+ * (`mcp__<serverName>__<rawName>`). Must match `[A-Za-z0-9_-]{1,32}` and be
2060
+ * unique across live mcp-client instances.
2061
+ */
2062
+ serverName: string
2063
+ /** MCP endpoint URL. */
2064
+ url: string
2065
+ /** Additional headers attached to MCP requests. */
2066
+ headers: Record<string, string>
2067
+ /** Timeout per tool call or resource request in milliseconds. */
2068
+ toolCallTimeoutMs: number
2069
+ /** Fail plugin activation when the initial connection or tool synchronization fails. */
2070
+ failOnStartupError: boolean
2071
+ /** Maximum UTF-8 bytes of attributed server instructions (default 32768). */
2072
+ maxInstructionBytes?: number
2073
+ /** Automatic reconnect policy after a lost connection; omission uses the defaults. */
2074
+ reconnect?: ReconnectConfig
2075
+ }
2076
+
2077
+ /** Automatic reconnect policy for one MCP server connection. */
2078
+ export interface ReconnectConfig {
2079
+ /** Reconnect automatically after a lost connection (default true). */
2080
+ enabled?: boolean
2081
+ /** First reconnect delay in milliseconds; doubles per consecutive failed attempt (default 500). */
2082
+ initialDelayMs?: number
2083
+ /** Backoff ceiling in milliseconds; also the uptime after which the attempt budget resets (default 30000). */
2084
+ maxDelayMs?: number
2085
+ /** Consecutive failed attempts per outage before giving up for good (default 10). */
2086
+ maxAttempts?: number
2087
+ }
2088
+ ```
2089
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-mcp-client -->
2090
+
2091
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-message-feedback -->
2092
+ <a id="deepseek-aidsh-message-feedback"></a>
2093
+
2094
+ ## `@deepseek-ai/dsh-message-feedback`
2095
+
2096
+ - `inject`: `sessionPersistence` · `sessions`
2097
+ - `source`: [`packages/feedback/message-feedback/src/index.ts:40`](../packages/feedback/message-feedback/src/index.ts)
2098
+
2099
+ ```ts config-catalog
2100
+ /** Required deployment policy for optional notes. */
2101
+ export interface Config {
2102
+ /** Maximum UTF-8 byte length accepted for one note. */
2103
+ readonly maxNoteBytes: number
2104
+ }
2105
+ ```
2106
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-message-feedback -->
2107
+
2108
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-office-to-pdf -->
2109
+ <a id="deepseek-aidsh-office-to-pdf"></a>
2110
+
2111
+ ## `@deepseek-ai/dsh-office-to-pdf`
2112
+
2113
+ - `source`: [`packages/document/office-to-pdf/src/index.ts:31`](../packages/document/office-to-pdf/src/index.ts)
2114
+
2115
+ ```ts config-catalog
2116
+ /** Provider concurrency and kit rendering/font configuration. */
2117
+ export interface Config {
2118
+ /** Maximum simultaneous conversions; queued callers remain cancellable. */
2119
+ maxConcurrentConversions: number
2120
+ /** Maximum metadata-only jobs awaiting source admission. */
2121
+ maxQueuedJobs: number
2122
+ /** Maximum outstanding conversion readers. */
2123
+ maxReaders: number
2124
+ /** Maximum reserved bytes across admitted source reads and conversions. */
2125
+ maxSourceBytes: number
2126
+ /** Maximum concurrent background jobs; zero refuses speculative work. */
2127
+ maxBackgroundConversions: number
2128
+ /** Maximum retained content-addressed PDFs. */
2129
+ maxCachedEntries: number
2130
+ /** Maximum retained PDF bytes. */
2131
+ maxCachedBytes: number
2132
+ /** Maximum retained source-version aliases to cached content. */
2133
+ maxSourceEntries: number
2134
+ /** Conversion deadline in milliseconds; excludes the DSH queue. */
2135
+ timeoutMs: number
2136
+ /** Maximum authorized source bytes. */
2137
+ maxInputBytes: number
2138
+ /** Maximum complete PDF bytes. */
2139
+ maxOutputBytes: number
2140
+ /** Exported raster-image DPI. */
2141
+ maxImageResolution: number
2142
+ /** Maximum OOXML ZIP entries. */
2143
+ maxArchiveEntries: number
2144
+ /** Maximum total declared uncompressed OOXML bytes. */
2145
+ maxUncompressedBytes: number
2146
+ /** Absolute font roots; omission uses the kit's platform defaults. */
2147
+ fontDirectories?: string[]
2148
+ /** Ordered font-family preference groups; omission retains the kit defaults. */
2149
+ fontFallbacks?: string[][]
2150
+ /** Maximum physical font files indexed by each converter. */
2151
+ maxFontFiles: number
2152
+ /** Maximum individual font-file bytes. */
2153
+ maxFontFileBytes: number
2154
+ /** Maximum original font bytes loaded for a conversion. */
2155
+ maxLoadedFontBytes: number
2156
+ }
2157
+ ```
2158
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-office-to-pdf -->
2159
+
2160
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-permission-presets -->
2161
+ <a id="deepseek-aidsh-permission-presets"></a>
2162
+
2163
+ ## `@deepseek-ai/dsh-permission-presets`
2164
+
2165
+ - `inject`: `shell` · `approval` · `sessions` · `sessionProjections`
2166
+ - `refs`: [`ApprovalPolicy`](subsystems/approval.md) · [`SandboxMode`](subsystems/sandbox.md) · `Volatile` (`@deepseek-ai/cordis`)
2167
+ - `source`: [`packages/interaction/permission-presets/src/index.ts:159`](../packages/interaction/permission-presets/src/index.ts)
2168
+
2169
+ ```ts config-catalog
2170
+ /** The {@link PermissionPresetService} config: preset table and composition default. */
2171
+ export interface Config {
2172
+ /**
2173
+ * The preset table: name → knob bundle. Defaults to `workspace-write`
2174
+ * (workspace-write + ask) and `danger-full-access` (danger-full-access +
2175
+ * never). The names `custom` and `auto` are reserved for derived state and
2176
+ * the Auto review integration respectively.
2177
+ */
2178
+ presets: Record<string, PresetSpec>
2179
+ /**
2180
+ * Default for new sessions. When omitted, the preset matching the composed
2181
+ * sandbox and approval defaults is used.
2182
+ */
2183
+ defaultPreset: Volatile<string | undefined>
2184
+ }
2185
+
2186
+ /** One preset's sandbox/approval bundle and optional client presentation. */
2187
+ export interface PresetSpec {
2188
+ /** The `sandbox/mode` value the preset writes through. */
2189
+ sandbox: SandboxMode
2190
+ /** The `approval/policy` value the preset writes through. */
2191
+ approval: ApprovalPolicy
2192
+ /** The display label a client shows for this preset; the raw table key when omitted. */
2193
+ name?: string
2194
+ /** One user-facing sentence on what the preset means; omitted when not configured. */
2195
+ description?: string
2196
+ }
2197
+ ```
2198
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-permission-presets -->
2199
+
2200
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-persona -->
2201
+ <a id="deepseek-aidsh-persona"></a>
2202
+
2203
+ ## `@deepseek-ai/dsh-persona`
2204
+
2205
+ - `inject`: `systemPrompt`
2206
+ - `source`: [`packages/preset/persona/src/index.ts:30`](../packages/preset/persona/src/index.ts)
2207
+
2208
+ ```ts config-catalog
2209
+ /** Plugin config: the persona text this composition contributes. */
2210
+ export interface Config {
2211
+ /**
2212
+ * Persona prose rendered as the `deployment:persona-prefix` section. A template:
2213
+ * complete `{{…}}` groups interpolate strictly against registered prompt
2214
+ * variables. Empty text drops the section at render, matching the registry.
2215
+ */
2216
+ prefix: string
2217
+ /**
2218
+ * Persona suffix template rendered after first-party guidance. Omitted or empty
2219
+ * text shadows the deployment suffix away; interpolation is strict.
2220
+ */
2221
+ suffix?: string
2222
+ /** Make the prefix the complete system prompt, suppressing the suffix and every other section. */
2223
+ complete?: boolean
2224
+ /** Suppress dynamic runtime-context snapshots for this persona's agent scope. */
2225
+ includeRuntimeContext?: boolean
2226
+ }
2227
+ ```
2228
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-persona -->
2229
+
2230
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-plan-mode -->
2231
+ <a id="deepseek-aidsh-plan-mode"></a>
2232
+
2233
+ ## `@deepseek-ai/dsh-plan-mode`
2234
+
2235
+ - `inject`: `tools` · `systemPrompt` · `sessionProjections`
2236
+ - `source`: [`packages/plan/plan-mode/src/index.ts:70`](../packages/plan/plan-mode/src/index.ts)
2237
+
2238
+ ```ts config-catalog
2239
+ /** Deployment-owned plan guidance. */
2240
+ export interface PlanModeConfig {
2241
+ /** Guidance rendered as the `plan:policy` prompt section while plan mode is active. */
2242
+ section: string
2243
+ }
2244
+ ```
2245
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-plan-mode -->
2246
+
2247
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-plugin-manager -->
2248
+ <a id="deepseek-aidsh-plugin-manager"></a>
2249
+
2250
+ ## `@deepseek-ai/dsh-plugin-manager`
2251
+
2252
+ - `inject`: `loader` · `profileContext`
2253
+ - `source`: [`packages/boot/plugin-manager/src/index.ts:40`](../packages/boot/plugin-manager/src/index.ts)
2254
+
2255
+ ```ts config-catalog
2256
+ /** The pnpm executable, registries, and limits for diagnostics, lookups and connection checks. */
2257
+ export interface Config {
2258
+ /** The pnpm executable name or path; resolved through `PATH` like the `dsh plugin` command. */
2259
+ pnpmCommand?: string
2260
+ /** Maximum retained package-operation diagnostic bytes. */
2261
+ outputBytes?: number
2262
+ /** Maximum time to wait for another process's profile package operation. */
2263
+ lockWaitMs?: number
2264
+ /** Bound on one registry lookup an inspection runs, in milliseconds. */
2265
+ inspectTimeoutMs?: number
2266
+ /** Maximum duration of the GitHub repository connection check before installation, in milliseconds. */
2267
+ githubConnectionTimeoutMs?: number
2268
+ /** Maximum time one captured package run may print nothing before the manager terminates it, in milliseconds. */
2269
+ idleTimeoutMs?: number
2270
+ /** The registry lookups and installations ask first, as an http(s) URL; absent, the one pnpm's own configuration names. */
2271
+ registry?: string
2272
+ /**
2273
+ * Registries asked in turn, as http(s) URLs, while the one before is unreachable or holds no copy of the package.
2274
+ * A registry outside this set and `registry` is asked alone, and so is the one pnpm's own configuration names
2275
+ * unless that is npm's own registry or one of these.
2276
+ */
2277
+ fallbackRegistries?: string[]
2278
+ }
2279
+ ```
2280
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-plugin-manager -->
2281
+
2282
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-plugin-package-inventory-deepseek -->
2283
+ <a id="deepseek-aidsh-plugin-package-inventory-deepseek"></a>
2284
+
2285
+ ## `@deepseek-ai/dsh-plugin-package-inventory-deepseek`
2286
+
2287
+ - `inject`: `agents` · `deepseekLlmApiExtensions` · `loader`
2288
+ - `source`: [`packages/llm/plugin-package-inventory-deepseek/src/index.ts:32`](../packages/llm/plugin-package-inventory-deepseek/src/index.ts)
2289
+
2290
+ ```ts config-catalog
2291
+ /** Plugin-package request contribution configuration. */
2292
+ export interface Config {
2293
+ /** Contribute `dsh_plugin_packages` to official DeepSeek requests. Defaults to `true`. */
2294
+ enabled?: boolean
2295
+ }
2296
+ ```
2297
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-plugin-package-inventory-deepseek -->
2298
+
2299
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-ptc-runtime-node -->
2300
+ <a id="deepseek-aidsh-ptc-runtime-node"></a>
2301
+
2302
+ ## `@deepseek-ai/dsh-ptc-runtime-node`
2303
+
2304
+ - `inject`: `fs` · `subprocess` · `sandbox` · `sandboxPolicy`
2305
+ - `source`: [`packages/ptc-runtime/ptc-runtime-node/src/index.ts:26`](../packages/ptc-runtime/ptc-runtime-node/src/index.ts)
2306
+
2307
+ ```ts config-catalog
2308
+ /** Deployment-varying runtime bounds and launch choices. */
2309
+ export interface Config extends LaunchConfig {
2310
+ /** Default elapsed deadline, including nested tool and approval waits. */
2311
+ timeoutMs?: number
2312
+ /** Maximum numeric elapsed budget accepted by resolve. */
2313
+ maxTimeoutMs?: number
2314
+ /** Combined serialized logs, completion and diagnostic byte cap. */
2315
+ maxOutputBytes?: number
2316
+ /** V8 old-generation heap limit in MiB; native allocations are excluded. */
2317
+ maxOldGenerationSizeMb?: number
2318
+ /** Maximum control frame, outstanding argument and queued control-output bytes. */
2319
+ maxMessageBytes?: number
2320
+ /** Maximum simultaneous host binding calls accepted from a program. */
2321
+ maxPendingCalls?: number
2322
+ /** Managed process termination and output-drain grace in milliseconds. */
2323
+ graceMs?: number
2324
+ }
2325
+
2326
+ /** Deployment-owned Node executable and optional preinstalled built bootstrap. */
2327
+ export interface LaunchConfig {
2328
+ /** Executable in the subprocess world; defaults to the current Node executable. */
2329
+ nodeExecutable?: string
2330
+ /** Absolute preinstalled built bootstrap in the execution world. */
2331
+ bootstrapPath?: string
2332
+ }
2333
+ ```
2334
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-ptc-runtime-node -->
2335
+
2336
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-pwsh-local -->
2337
+ <a id="deepseek-aidsh-pwsh-local"></a>
2338
+
2339
+ ## `@deepseek-ai/dsh-pwsh-local`
2340
+
2341
+ - `inject`: `subprocess`
2342
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
2343
+ - `source`: [`packages/shell/pwsh-local/src/index.ts:58`](../packages/shell/pwsh-local/src/index.ts)
2344
+
2345
+ ```ts config-catalog
2346
+ /** Validated plugin configuration with live command budgets. */
2347
+ export interface Config {
2348
+ /** Default working directory for commands (default: process.cwd()). */
2349
+ cwd: Volatile<string | undefined>
2350
+ /** Default foreground timeout in milliseconds. */
2351
+ timeoutMs: Volatile<number>
2352
+ /** Upper bound for per-call timeout overrides. */
2353
+ maxTimeoutMs: Volatile<number>
2354
+ /** Per-stream in-memory output cap; overflow spills to a temp file. */
2355
+ maxOutputBytes: Volatile<number>
2356
+ /** Per-stream spill-file cap; larger streams retain only their in-memory tail. */
2357
+ maxSpillBytes: Volatile<number>
2358
+ /** Grace period for kill escalation and inherited pipes; at most `MAX_TIMER_DELAY_MS`. */
2359
+ graceMs: Volatile<number>
2360
+ /**
2361
+ * Explicit pwsh executable. When omitted, well-known Windows install
2362
+ * locations and PATH entries are probed in order (PowerShell 7 install,
2363
+ * PATH entries such as the Microsoft Store install, then Windows
2364
+ * PowerShell 5.1), falling back to a bare `pwsh` resolved through PATH.
2365
+ */
2366
+ pwshPath: Volatile<string | undefined>
2367
+ }
2368
+ ```
2369
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-pwsh-local -->
2370
+
2371
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-pwsh-sandbox -->
2372
+ <a id="deepseek-aidsh-pwsh-sandbox"></a>
2373
+
2374
+ ## `@deepseek-ai/dsh-pwsh-sandbox`
2375
+
2376
+ - `inject`: `subprocess` · `sandbox` · `sandboxPolicy`
2377
+ - `refs`: [`LocalConfig`](#deepseek-aidsh-pwsh-local)
2378
+ - `source`: [`packages/shell/pwsh-sandbox/src/index.ts:40`](../packages/shell/pwsh-sandbox/src/index.ts)
2379
+
2380
+ ```ts config-catalog
2381
+ /**
2382
+ * Plugin config: the local executor's knobs, verbatim. The sandbox policy -
2383
+ * the default mode and fallback `workspace-write` root - is NOT here: it lives
2384
+ * on `ctx.sandboxPolicy` (`@deepseek-ai/dsh-sandbox-policy`), which resolves
2385
+ * each calling session's mode and cwd for every enforcing capability. The
2386
+ * runner choice is likewise the `ctx.sandbox` provider's config, not this
2387
+ * executor's.
2388
+ */
2389
+ export type Config = LocalConfig
2390
+ ```
2391
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-pwsh-sandbox -->
2392
+
2393
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-repeat-tool-reminder -->
2394
+ <a id="deepseek-aidsh-repeat-tool-reminder"></a>
2395
+
2396
+ ## `@deepseek-ai/dsh-repeat-tool-reminder`
2397
+
2398
+ - `source`: [`packages/guard/repeat-tool-reminder/src/index.ts:35`](../packages/guard/repeat-tool-reminder/src/index.ts)
2399
+
2400
+ ```ts config-catalog
2401
+ /**
2402
+ * Plugin config, validated by the same-named schemastery schema plus the
2403
+ * load-time checks in `apply` (misconfiguration fails loud: an empty
2404
+ * `thresholds` list, a non-integer, a value below 2, or a duplicate throws at
2405
+ * plugin load, never a silent fall-back). `include`/`exclude` entries are
2406
+ * `*`-wildcard predicates over tool names at call time, not references to
2407
+ * registry entries - a pattern matching no currently registered tool is valid
2408
+ * (`exclude: [mcp_*]` must stay legal in a deployment that loads no MCP tools).
2409
+ */
2410
+ export interface Config {
2411
+ /** Consecutive-repeat counts that trigger a reminder (default `[3, 5, 8]`). */
2412
+ thresholds?: number[]
2413
+ /** Tool-name patterns to track; empty means every tool is tracked. */
2414
+ include?: string[]
2415
+ /** Tool-name patterns transparent to the chain (neither count nor reset). */
2416
+ exclude?: string[]
2417
+ /**
2418
+ * Maximum characters of canonical arguments quoted in the DETAILED reminder
2419
+ * (default 500). Large payloads (a `write` body, a long command) would
2420
+ * otherwise ride into the next request unbounded - precisely in a loop
2421
+ * scenario; the cap bounds the reminder, never the detection (the chain key
2422
+ * always compares the FULL canonical string).
2423
+ */
2424
+ argumentsPreviewChars?: number
2425
+ }
2426
+ ```
2427
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-repeat-tool-reminder -->
2428
+
2429
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-sandbox-local -->
2430
+ <a id="deepseek-aidsh-sandbox-local"></a>
2431
+
2432
+ ## `@deepseek-ai/dsh-sandbox-local`
2433
+
2434
+ - `source`: [`packages/sandbox/sandbox-local/src/index.ts:45`](../packages/sandbox/sandbox-local/src/index.ts)
2435
+
2436
+ ```ts config-catalog
2437
+ /** Plugin config. All optional - `static Config` supplies the defaults. */
2438
+ export interface Config {
2439
+ /**
2440
+ * Override the runner argv; bwrap-compatible profile arguments are appended. A
2441
+ * non-empty override asserts full enforcement and skips built-in selection and
2442
+ * probing. A runner that starts but refuses its profile must be identifiable by
2443
+ * {@link runnerFailureSignatures}. Consumers classify a spawn rejection only after
2444
+ * confirming the workdir is usable. `ENOENT` or `EACCES` identifies the runner when
2445
+ * `error.path` equals argv[0] and `error.syscall` is `spawn` or `spawn <runner>`, or
2446
+ * when `error.path` is absent and `error.syscall` is exactly `spawn <runner>`.
2447
+ */
2448
+ runnerCommand?: string[]
2449
+ /**
2450
+ * Case-insensitive stderr substrings emitted when a configured
2451
+ * {@link runnerCommand} refuses its profile before executing the wrapped
2452
+ * command. Required and non-empty with `runnerCommand`; rejected without
2453
+ * it. Each entry is a non-empty, single-line, case-insensitive substring
2454
+ * covering the executable runner's own failure dialect.
2455
+ */
2456
+ runnerFailureSignatures?: string[]
2457
+ /** Positive timeout for each functional probe; zero would mean unbounded to Node. */
2458
+ probeTimeoutMs?: number
2459
+ }
2460
+ ```
2461
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-sandbox-local -->
2462
+
2463
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-sandbox-policy -->
2464
+ <a id="deepseek-aidsh-sandbox-policy"></a>
2465
+
2466
+ ## `@deepseek-ai/dsh-sandbox-policy`
2467
+
2468
+ - `inject`: `sessionProjections`
2469
+ - `refs`: [`SandboxMode`](subsystems/sandbox.md)
2470
+ - `source`: [`packages/sandbox/sandbox-policy/src/index.ts:71`](../packages/sandbox/sandbox-policy/src/index.ts)
2471
+
2472
+ ```ts config-catalog
2473
+ /**
2474
+ * Plugin config: the deployment's sandbox default. All optional - `Config`
2475
+ * supplies the defaults (`mode: 'read-only'` is the fail-safe default; a
2476
+ * deployment that wants a workspace-writable agent opts in explicitly). The
2477
+ * runner choice is NOT here (it is the `ctx.sandbox` provider's config), nor
2478
+ * is any per-family knob: this is the one shared policy home.
2479
+ */
2480
+ export interface Config {
2481
+ /** File-sandbox mode a session starts from (default: `read-only`). */
2482
+ mode?: SandboxMode
2483
+ /**
2484
+ * Absolute fallback root for agentless calls and sessions without a cwd (default:
2485
+ * `process.cwd()`). Normal agent calls use their session cwd instead.
2486
+ */
2487
+ workspaceRoot?: string
2488
+ }
2489
+ ```
2490
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-sandbox-policy -->
2491
+
2492
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-schedule -->
2493
+ <a id="deepseek-aidsh-schedule"></a>
2494
+
2495
+ ## `@deepseek-ai/dsh-schedule`
2496
+
2497
+ - `inject`: `agents` · `sessions` · `tools` · `storageDomain` · `sessionController` · `sessionPersistence`
2498
+ - `source`: [`packages/schedule/schedule/src/index.ts:73`](../packages/schedule/schedule/src/index.ts)
2499
+
2500
+ ```ts config-catalog
2501
+ /** Configuration for the Host Schedule domain. */
2502
+ export interface Config {
2503
+ /**
2504
+ * Delivery-history window retained per task, in days; omission defaults to 30.
2505
+ * Pruning happens when an acknowledgment is appended, and `lastDelivery` is always retained.
2506
+ */
2507
+ deliveryHistoryDays?: number
2508
+ /**
2509
+ * Retained delivery records per task; omission defaults to 200. The older of this
2510
+ * cap and the window wins, and the newest records survive.
2511
+ */
2512
+ deliveryHistoryRecords?: number
2513
+ }
2514
+ ```
2515
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-schedule -->
2516
+
2517
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-sdk-app -->
2518
+ <a id="deepseek-aidsh-sdk-app"></a>
2519
+
2520
+ ## `@deepseek-ai/dsh-sdk-app`
2521
+
2522
+ - `inject`: `cmdlineArgs`
2523
+ - `source`: [`packages/bundle/sdk-app/src/index.ts:23`](../packages/bundle/sdk-app/src/index.ts)
2524
+
2525
+ ```ts config-catalog
2526
+ /** SDK stdio startup configuration. */
2527
+ export interface Config {
2528
+ /** Profile name rendered in help and diagnostics (default `sdk`). */
2529
+ profile?: string
2530
+ }
2531
+ ```
2532
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-sdk-app -->
2533
+
2534
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-sdk-jsonrpc-server -->
2535
+ <a id="deepseek-aidsh-sdk-jsonrpc-server"></a>
2536
+
2537
+ ## `@deepseek-ai/dsh-sdk-jsonrpc-server`
2538
+
2539
+ - `inject`: `agents`
2540
+ - `refs`: `Readable` (`node:stream`) · `Writable` (`node:stream`)
2541
+ - `source`: [`packages/sdk/server/src/index.ts:25`](../packages/sdk/server/src/index.ts)
2542
+
2543
+ ```ts config-catalog
2544
+ /** JSON-RPC deployment config plus runtime-only test hooks. */
2545
+ export interface JsonRpcConfig {
2546
+ /** Report max-token turn/subagent termination as a successful SDK result. */
2547
+ maxTokensAsSuccess?: boolean
2548
+ /** Transport input override; production uses `process.stdin`. */
2549
+ input?: Readable
2550
+ /** Transport output override; production uses `process.stdout`. */
2551
+ output?: Writable
2552
+ /** Process-exit override; production uses `process.exit`. */
2553
+ exit?: (code: number) => void
2554
+ }
2555
+ ```
2556
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-sdk-jsonrpc-server -->
2557
+
2558
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-log-deepseek -->
2559
+ <a id="deepseek-aidsh-session-log-deepseek"></a>
2560
+
2561
+ ## `@deepseek-ai/dsh-session-log-deepseek`
2562
+
2563
+ - `inject`: `deepseekLlmApiExtensions` · `sessions`
2564
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
2565
+ - `source`: [`packages/session/session-log-deepseek/src/index.ts:39`](../packages/session/session-log-deepseek/src/index.ts)
2566
+
2567
+ ```ts config-catalog
2568
+ /** Session-log request contribution configuration. */
2569
+ export interface Config {
2570
+ /** Contribute `dsh_session_log` to official DeepSeek requests. Defaults to `true`. */
2571
+ enabled: Volatile<boolean>
2572
+ /**
2573
+ * Largest serialized `dsh_session_log` field, in UTF-8 bytes, that one request carries.
2574
+ * A request uploads the longest pending event prefix that fits; later requests continue
2575
+ * after its acceptance. Defaults to 8 MiB.
2576
+ */
2577
+ maxBytes: number
2578
+ }
2579
+ ```
2580
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-log-deepseek -->
2581
+
2582
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-log-export -->
2583
+ <a id="deepseek-aidsh-session-log-export"></a>
2584
+
2585
+ ## `@deepseek-ai/dsh-session-log-export`
2586
+
2587
+ - `inject`: `commands` · `connection`
2588
+ - `source`: [`packages/session-query/session-log-export/src/index.ts:46`](../packages/session-query/session-log-export/src/index.ts)
2589
+
2590
+ ```ts config-catalog
2591
+ /** Session-log archive policy. */
2592
+ export interface Config {
2593
+ /** DEFLATE level for each ZIP entry. @default 6 */
2594
+ readonly compressionLevel?: SessionLogCompressionLevel
2595
+ }
2596
+
2597
+ /** Valid fflate DEFLATE levels accepted by session-log export. */
2598
+ export type SessionLogCompressionLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
2599
+ ```
2600
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-log-export -->
2601
+
2602
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-persistence-jsonl -->
2603
+ <a id="deepseek-aidsh-session-persistence-jsonl"></a>
2604
+
2605
+ ## `@deepseek-ai/dsh-session-persistence-jsonl`
2606
+
2607
+ - `source`: [`packages/session/session-persistence-jsonl/src/index.ts:90`](../packages/session/session-persistence-jsonl/src/index.ts)
2608
+
2609
+ ```ts config-catalog
2610
+ /** Plugin config for the JSONL backend's root and physical encoding. */
2611
+ export interface Config {
2612
+ /**
2613
+ * Root directory for all session files. Required (no default): a default of
2614
+ * `process.cwd()` would scatter session files as the process's cwd changes
2615
+ * (bash calls, subprocesses). Sessions group under human-readable project
2616
+ * directories, then per-session directories. An existing root must be a
2617
+ * readable directory; an absent root is created on first materialization.
2618
+ */
2619
+ root: string
2620
+ /** Physical encoding; defaults to checksummed Zstandard frames. */
2621
+ compression?: JsonlCompression
2622
+ }
2623
+
2624
+ /** Physical encoding selected for JSONL session artifacts. */
2625
+ export type JsonlCompression = 'zstd' | 'none'
2626
+ ```
2627
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-persistence-jsonl -->
2628
+
2629
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-projection-cache -->
2630
+ <a id="deepseek-aidsh-session-projection-cache"></a>
2631
+
2632
+ ## `@deepseek-ai/dsh-session-projection-cache`
2633
+
2634
+ - `inject`: `storageDomain` · `sessionProjections` · `sessions`
2635
+ - `source`: [`packages/session/session-projection-cache/src/index.ts:75`](../packages/session/session-projection-cache/src/index.ts)
2636
+
2637
+ ```ts config-catalog
2638
+ /**
2639
+ * Plugin config. Both throttle triggers are deployment choices with no
2640
+ * universally correct value, so the composition states them explicitly
2641
+ * (cordis.yml); the three mandatory write points (session creation,
2642
+ * `turn/end`, and session disposal) are policy, not tunables, and always
2643
+ * fire.
2644
+ */
2645
+ export interface Config {
2646
+ /** Committed events per session that force a durable checkpoint write between mandatory points. */
2647
+ writeEveryEvents: number
2648
+ /** Longest time (milliseconds) a dirty checkpoint may stay unwritten between mandatory points. */
2649
+ writeIntervalMs: number
2650
+ }
2651
+ ```
2652
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-projection-cache -->
2653
+
2654
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-query-sqlite -->
2655
+ <a id="deepseek-aidsh-session-query-sqlite"></a>
2656
+
2657
+ ## `@deepseek-ai/dsh-session-query-sqlite`
2658
+
2659
+ - `inject`: `sessions`
2660
+ - `refs`: [`SessionQueryConfig`](../packages/session-query/session-query/src/index.ts)
2661
+ - `source`: [`packages/session-query/session-query-sqlite/src/index.ts:92`](../packages/session-query/session-query-sqlite/src/index.ts)
2662
+
2663
+ ```ts config-catalog
2664
+ /** Combined session-query configuration backed by SQLite full-text search. */
2665
+ export interface Config extends SessionQueryConfig {
2666
+ /**
2667
+ * Dedicated derived-index path; `:memory:` is supported for ephemeral
2668
+ * indexes. Missing directories and database files are created owner-only on
2669
+ * POSIX filesystems; existing modes are preserved.
2670
+ */
2671
+ path: string
2672
+ /**
2673
+ * Open the SQLite module and handle at service activation or the first
2674
+ * search, or `never` to disable full-text search: the inherited exact
2675
+ * reads, filters, and traces stay available, while `searchSessions` and
2676
+ * `searchEvents` fail with `SESSION_QUERY_SEARCH_DISABLED` and SQLite is
2677
+ * never imported or opened. Defaults to `startup`.
2678
+ */
2679
+ openAt?: OpenAt
2680
+ /** SQLite journal mode. Defaults to `wal`. */
2681
+ journalMode?: JournalMode
2682
+ /** Page size when a request omits `limit`. At most `Number.MAX_SAFE_INTEGER - 1`; defaults to 20. */
2683
+ defaultLimit?: number
2684
+ /** Largest accepted page size. At most `Number.MAX_SAFE_INTEGER - 1`; defaults to 100. */
2685
+ maxLimit?: number
2686
+ /** Maximum snippet length in Unicode code points. Defaults to 240. */
2687
+ snippetChars?: number
2688
+ /** Maximum concurrent persisted-log reads in one inherited batch read. Defaults to 4. */
2689
+ persistedReadConcurrency?: number
2690
+ /** Maximum cold prepared-Session observations the inherited reader retains for reuse. Defaults to 5. */
2691
+ preparedSessionCacheSize?: number
2692
+ }
2693
+
2694
+ /** SQLite module/handle opening phase; `never` disables full-text search entirely. */
2695
+ export type OpenAt = 'startup' | 'first-search' | 'never'
2696
+
2697
+ /** Supported SQLite journal modes. */
2698
+ export type JournalMode = 'wal' | 'delete' | 'truncate' | 'persist'
2699
+ ```
2700
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-query-sqlite -->
2701
+
2702
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-reference -->
2703
+ <a id="deepseek-aidsh-session-reference"></a>
2704
+
2705
+ ## `@deepseek-ai/dsh-session-reference`
2706
+
2707
+ - `inject`: `sessionQuery`
2708
+ - `source`: [`packages/context/session-reference/src/config.ts:11`](../packages/context/session-reference/src/config.ts)
2709
+
2710
+ ```ts config-catalog
2711
+ /** Session-reference service configuration. */
2712
+ export interface Config {
2713
+ /** Maximum distinct source sessions referenced by one message, from one to three. */
2714
+ maxReferences?: number
2715
+ /** Default host candidate-list limit. */
2716
+ candidateLimit?: number
2717
+ /** Explicit maximum rendered UTF-8 bytes per source; absent uses the model-relative budget with a 64 KiB floor. */
2718
+ maxReferenceBytes?: number
2719
+ /** Fraction of the model context window per source, estimated at four bytes per token; between zero and one. */
2720
+ referenceContextFraction?: number
2721
+ }
2722
+ ```
2723
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-reference -->
2724
+
2725
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-telemetry-otel -->
2726
+ <a id="deepseek-aidsh-session-telemetry-otel"></a>
2727
+
2728
+ ## `@deepseek-ai/dsh-session-telemetry-otel`
2729
+
2730
+ - `inject`: `sessions` · `otel`
2731
+ - `refs`: `BatchLogRecordProcessorOptions` (`@opentelemetry/sdk-logs`) · `OTLPExporterNodeConfigBase` (`@opentelemetry/otlp-exporter-base`)
2732
+ - `source`: [`packages/session/session-telemetry-otel/src/index.ts:87`](../packages/session/session-telemetry-otel/src/index.ts)
2733
+
2734
+ ```ts config-catalog
2735
+ /**
2736
+ * Plugin configuration: sharing policy, SDK transport options, byte/count queue
2737
+ * settings, and an overall shutdown bound. Uploading modes validate their endpoint
2738
+ * and shutdown deadline at plugin load; `DISABLED` reads neither.
2739
+ */
2740
+ export interface Config {
2741
+ /** Defaults to `FEEDBACK_ONLY`: capture session history only when feedback is explicitly submitted. */
2742
+ mode?: SessionTelemetryMode
2743
+ /**
2744
+ * Explicit SDK HTTP transport settings, including optional routing headers.
2745
+ * Ambient credentials are not inherited. URL is required while uploading.
2746
+ */
2747
+ exporter?: OTLPExporterNodeConfigBase & {
2748
+ /** Full logs endpoint (e.g. `https://collector.example.com/v1/logs`). Required outside `DISABLED`; validated at load. */
2749
+ url?: string
2750
+ }
2751
+ /**
2752
+ * Count, queue, cadence, and per-request watchdog settings for the byte-bounded
2753
+ * processor. A watchdog warning never releases an unsettled transport slot.
2754
+ */
2755
+ processor?: Omit<BatchLogRecordProcessorOptions, 'exporter'>
2756
+ /** Maximum time spent awaiting the SDK provider's complete shutdown path. */
2757
+ shutdownTimeoutMillis?: number
2758
+ /** Uncompressed OTLP request byte limit, at most 4,000,000. */
2759
+ maxRequestBytes?: number
2760
+ }
2761
+
2762
+ /** Session-sharing policy selected by {@link Config.mode}. */
2763
+ export enum SessionTelemetryMode {
2764
+ FEEDBACK_ONLY = 'FEEDBACK_ONLY',
2765
+ DISABLED = 'DISABLED',
2766
+ }
2767
+ ```
2768
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-telemetry-otel -->
2769
+
2770
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-title -->
2771
+ <a id="deepseek-aidsh-session-title"></a>
2772
+
2773
+ ## `@deepseek-ai/dsh-session-title`
2774
+
2775
+ - `inject`: `sessions` · `sessionProjections`
2776
+ - `source`: [`packages/session/session-title/src/index.ts:56`](../packages/session/session-title/src/index.ts)
2777
+
2778
+ ```ts config-catalog
2779
+ /** Required deterministic fallback and accepted-title limits. */
2780
+ export interface Config {
2781
+ /** Maximum whitespace-delimited words in the built-in fallback. */
2782
+ readonly fallbackMaxWords: number
2783
+ /** Maximum UTF-8 bytes in the built-in fallback. */
2784
+ readonly fallbackMaxBytes: number
2785
+ /** Maximum UTF-8 bytes in any accepted title. */
2786
+ readonly maxTitleBytes: number
2787
+ }
2788
+ ```
2789
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-title -->
2790
+
2791
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-title-all-prompts-llm -->
2792
+ <a id="deepseek-aidsh-session-title-all-prompts-llm"></a>
2793
+
2794
+ ## `@deepseek-ai/dsh-session-title-all-prompts-llm`
2795
+
2796
+ - `inject`: `sessionTitle` · `llm` · `sessions`
2797
+ - `refs`: [`SessionTitleLlmConfig`](../packages/session/session-title-llm/src/index.ts)
2798
+ - `source`: [`packages/session/session-title-all-prompts-llm/src/index.ts:15`](../packages/session/session-title-all-prompts-llm/src/index.ts)
2799
+
2800
+ ```ts config-catalog
2801
+ /** Required LLM policy; this plugin adds no defaults. */
2802
+ export type Config = SessionTitleLlmConfig
2803
+ ```
2804
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-title-all-prompts-llm -->
2805
+
2806
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-session-title-first-prompt-llm -->
2807
+ <a id="deepseek-aidsh-session-title-first-prompt-llm"></a>
2808
+
2809
+ ## `@deepseek-ai/dsh-session-title-first-prompt-llm`
2810
+
2811
+ - `inject`: `sessionTitle` · `llm` · `sessions`
2812
+ - `refs`: [`SessionTitleLlmConfig`](../packages/session/session-title-llm/src/index.ts)
2813
+ - `source`: [`packages/session/session-title-first-prompt-llm/src/index.ts:15`](../packages/session/session-title-first-prompt-llm/src/index.ts)
2814
+
2815
+ ```ts config-catalog
2816
+ /** Required LLM policy; this plugin adds no defaults. */
2817
+ export type Config = SessionTitleLlmConfig
2818
+ ```
2819
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-session-title-first-prompt-llm -->
2820
+
2821
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-shell-env -->
2822
+ <a id="deepseek-aidsh-shell-env"></a>
2823
+
2824
+ ## `@deepseek-ai/dsh-shell-env`
2825
+
2826
+ - `source`: [`packages/shell/shell-env/src/index.ts:30`](../packages/shell/shell-env/src/index.ts)
2827
+
2828
+ ```ts config-catalog
2829
+ /** Plugin config (all optional - the built-in facts resolve without defaults). */
2830
+ export interface Config {
2831
+ /** DeepSeek Harness home directory exposed as `DSH_HOME`; defaults to `$DSH_HOME` or `~/.dsh`. */
2832
+ dshHome?: string
2833
+ }
2834
+ ```
2835
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-shell-env -->
2836
+
2837
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-skill -->
2838
+ <a id="deepseek-aidsh-skill"></a>
2839
+
2840
+ ## `@deepseek-ai/dsh-skill`
2841
+
2842
+ - `source`: [`packages/skill/skill/src/index.ts:278`](../packages/skill/skill/src/index.ts)
2843
+
2844
+ ```ts config-catalog
2845
+ /** Skill registry configuration. */
2846
+ export interface Config {
2847
+ /** Maximum number of completed cwd/provider catalogs kept in memory. */
2848
+ readonly collectCacheMaxEntries?: number
2849
+ }
2850
+ ```
2851
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-skill -->
2852
+
2853
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-skill-filesystem -->
2854
+ <a id="deepseek-aidsh-skill-filesystem"></a>
2855
+
2856
+ ## `@deepseek-ai/dsh-skill-filesystem`
2857
+
2858
+ - `inject`: `skills`
2859
+ - `source`: [`packages/skill/skill-filesystem/src/index.ts:49`](../packages/skill/skill-filesystem/src/index.ts)
2860
+
2861
+ ```ts config-catalog
2862
+ /** Local filesystem skill provider configuration. */
2863
+ export interface Config {
2864
+ /** Unique provider name. Defaults to `filesystem`. */
2865
+ providerName?: string
2866
+ /** Whether project and user roots are included around custom roots. */
2867
+ includeDefaultRoots?: boolean
2868
+ /** DeepSeek Harness config root. Defaults to `$DSH_HOME` or `~/.dsh`. */
2869
+ dshHome?: string
2870
+ /** Shared agent config root. Defaults to `$DSH_AGENTS_HOME` or `~/.agents`. */
2871
+ agentsHome?: string
2872
+ /** Additional skill roots scanned after project roots and before user roots. */
2873
+ customSkillDirs?: string[]
2874
+ /** Whether host-local skill roots are watched for catalog changes. */
2875
+ watch?: boolean
2876
+ /** Whether Chokidar uses polling instead of native filesystem events. */
2877
+ watchUsePolling?: boolean
2878
+ /** Milliseconds a changed skill entry must remain stable before it is observed. */
2879
+ watchStabilityThresholdMs?: number
2880
+ /** Milliseconds between Chokidar stability or polling probes. */
2881
+ watchPollIntervalMs?: number
2882
+ /** Maximum distinct project roots whose skill directories remain watched. */
2883
+ watchMaxProjects?: number
2884
+ /** Whether watched symbolic links follow their target files. */
2885
+ watchFollowSymlinks?: boolean
2886
+ /** Bundled skill root; defaults to `$DSH_BUNDLED_SKILL_DIR` when default roots are included, otherwise mounts none. */
2887
+ bundledSkillDir?: string
2888
+ }
2889
+ ```
2890
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-skill-filesystem -->
2891
+
2892
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-skill-office -->
2893
+ <a id="deepseek-aidsh-skill-office"></a>
2894
+
2895
+ ## `@deepseek-ai/dsh-skill-office`
2896
+
2897
+ - `inject`: `skills`
2898
+ - `source`: [`packages/skill/skill-office/src/index.ts:16`](../packages/skill/skill-office/src/index.ts)
2899
+
2900
+ ```ts config-catalog
2901
+ /** Office skill resource location. */
2902
+ export interface Config {
2903
+ /** Absolute assets directory containing the three skill folders and shared scripts; defaults to packaged assets. */
2904
+ assetRoot?: string
2905
+ /** Standalone Node executable; defaults to the current executable outside Electron and SEA. */
2906
+ node?: string
2907
+ /** Absolute LibreOffice Kit CLI entry; false explicitly disables CLI access. */
2908
+ cli?: string | false
2909
+ }
2910
+ ```
2911
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-skill-office -->
2912
+
2913
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-spill-local -->
2914
+ <a id="deepseek-aidsh-spill-local"></a>
2915
+
2916
+ ## `@deepseek-ai/dsh-spill-local`
2917
+
2918
+ - `source`: [`packages/spill/spill-local/src/index.ts:31`](../packages/spill/spill-local/src/index.ts)
2919
+
2920
+ ```ts config-catalog
2921
+ /** Plugin config (all optional - `static Config` supplies the defaults). */
2922
+ export interface Config {
2923
+ /**
2924
+ * Root directory for spill files. Omitted uses a lazily-created private
2925
+ * (0700) per-process directory under the OS temp dir - the safe default for
2926
+ * a local deployment. Set it to keep spill files under a known location.
2927
+ */
2928
+ root?: string
2929
+ /**
2930
+ * Age in days after which a spill file is eligible for the one-shot startup
2931
+ * cleanup sweep. Defaults to `30`; `0` disables cleanup entirely. Files whose
2932
+ * `mtime` is strictly older than the cutoff are deleted and emptied
2933
+ * directories are pruned; fresh files, symlinks, and unrelated entries are
2934
+ * left untouched. On POSIX, cleanup skips roots and session directories that
2935
+ * another local user could modify or replace. Retention is deliberate - a
2936
+ * resumed or forked session may still reference an older locator until it
2937
+ * ages out.
2938
+ */
2939
+ cleanupPeriodDays?: number
2940
+ }
2941
+ ```
2942
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-spill-local -->
2943
+
2944
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-spill-policy -->
2945
+ <a id="deepseek-aidsh-spill-policy"></a>
2946
+
2947
+ ## `@deepseek-ai/dsh-spill-policy`
2948
+
2949
+ - `inject`: `tools`
2950
+ - `source`: [`packages/spill/spill-policy/src/index.ts:25`](../packages/spill/spill-policy/src/index.ts)
2951
+
2952
+ ```ts config-catalog
2953
+ /** Optional result-retention budget. */
2954
+ export interface Config {
2955
+ /** Maximum estimated tokens in a retained result, including image descriptors and omission notices. Omitted disables retention. */
2956
+ maxInlineTokens?: number
2957
+ }
2958
+ ```
2959
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-spill-policy -->
2960
+
2961
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-ssh -->
2962
+ <a id="deepseek-aidsh-ssh"></a>
2963
+
2964
+ ## `@deepseek-ai/dsh-ssh`
2965
+
2966
+ - `source`: [`packages/ssh/ssh/src/index.ts:17`](../packages/ssh/ssh/src/index.ts)
2967
+
2968
+ ```ts config-catalog
2969
+ /** Deployment-owned SSH identity and installed helper; no model argument selects these values. */
2970
+ export interface Config {
2971
+ /** OpenSSH host alias, including its existing user, key and known-host configuration. */
2972
+ host: string
2973
+ /** Absolute remote Node executable. */
2974
+ node: string
2975
+ /** Absolute path to the installed, bundled helper entry. */
2976
+ helper: string
2977
+ /** SHA-256 of that bundled helper; mismatches refuse the connection. */
2978
+ helperHash: string
2979
+ /** Absolute remote default workspace. */
2980
+ workspace: string
2981
+ /** Optional preinstalled built PTC entry, paired with its expected digest. */
2982
+ bootstrapPath?: string
2983
+ /** SHA-256 of bootstrapPath; both fields must be supplied together. */
2984
+ bootstrapHash?: string
2985
+ /** Connection and administrative-request deadline, at most 2,147,483,647 milliseconds. */
2986
+ requestTimeoutMs?: number
2987
+ /** Maximum JSON payload bytes per helper request or response. */
2988
+ maxFrameBytes?: number
2989
+ /** Maximum ordinary requests; heartbeat and bounded resource cleanup have reserved capacity. */
2990
+ maxPending?: number
2991
+ /** Remote helper lease; loss of heartbeats starts remote managed cleanup. */
2992
+ leaseMs?: number
2993
+ }
2994
+ ```
2995
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-ssh -->
2996
+
2997
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-storage-domain -->
2998
+ <a id="deepseek-aidsh-storage-domain"></a>
2999
+
3000
+ ## `@deepseek-ai/dsh-storage-domain`
3001
+
3002
+ - `inject`: `storage`
3003
+ - `source`: [`packages/storage/storage-domain/src/index.ts:52`](../packages/storage/storage-domain/src/index.ts)
3004
+
3005
+ ```ts config-catalog
3006
+ /**
3007
+ * Plugin config. Which backend serves which domain is decided here, not
3008
+ * globally on the hub: `backend` is the default route and `routes` overrides
3009
+ * it per domain name. A route naming an unregistered backend fails loud at
3010
+ * `open` with `backend-not-found`.
3011
+ */
3012
+ export interface Config {
3013
+ /** Default backend name for every domain without an explicit route. Required: there is no universally correct medium. */
3014
+ backend: string
3015
+ /** Per-domain overrides: domain name → backend name. */
3016
+ routes?: Record<string, string>
3017
+ }
3018
+ ```
3019
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-storage-domain -->
3020
+
3021
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-storage-json -->
3022
+ <a id="deepseek-aidsh-storage-json"></a>
3023
+
3024
+ ## `@deepseek-ai/dsh-storage-json`
3025
+
3026
+ - `inject`: `storage`
3027
+ - `source`: [`packages/storage/storage-json/src/index.ts:28`](../packages/storage/storage-json/src/index.ts)
3028
+
3029
+ ```ts config-catalog
3030
+ /**
3031
+ * Plugin configuration.
3032
+ * `root` has NO default on purpose: a `process.cwd()` fallback would scatter
3033
+ * unit files wherever the process happens to start; assemblies state the
3034
+ * location explicitly.
3035
+ */
3036
+ export interface Config {
3037
+ /** Directory holding one `<unit>.json` file (or `<unit>/` tree) per unit. */
3038
+ root: string
3039
+ }
3040
+ ```
3041
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-storage-json -->
3042
+
3043
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-storage-sqlite -->
3044
+ <a id="deepseek-aidsh-storage-sqlite"></a>
3045
+
3046
+ ## `@deepseek-ai/dsh-storage-sqlite`
3047
+
3048
+ - `inject`: `storage`
3049
+ - `source`: [`packages/storage/storage-sqlite/src/index.ts:24`](../packages/storage/storage-sqlite/src/index.ts)
3050
+
3051
+ ```ts config-catalog
3052
+ /** Plugin configuration. */
3053
+ export interface Config {
3054
+ /**
3055
+ * Filesystem path to the SQLite database file. The special value `:memory:`
3056
+ * opens an in-process database (tests). On filesystems with POSIX modes,
3057
+ * missing directories and databases are created owner-only; existing path
3058
+ * modes are preserved. Filesystem setup errors other than an existing
3059
+ * database fail the open. The backend does not protect confidentiality or
3060
+ * integrity when another principal can replace the database entry in its
3061
+ * parent directory.
3062
+ */
3063
+ path: string
3064
+ /**
3065
+ * SQLite `journal_mode` pragma. `wal` (the default) suits local disks; pick
3066
+ * a rollback-journal mode (`delete`/`truncate`/`persist`) on filesystems
3067
+ * where WAL's shared-memory files do not work (network mounts). See
3068
+ * {@link JournalMode}.
3069
+ */
3070
+ journalMode?: JournalMode
3071
+ }
3072
+
3073
+ /**
3074
+ * Journal modes the backend will run under. `wal` is the default; the
3075
+ * rollback-journal modes (`delete`/`truncate`/`persist`) exist for
3076
+ * filesystems where WAL's shared-memory files do not work (network mounts).
3077
+ * `memory`/`off` are excluded: dropping journal durability silently
3078
+ * contradicts the durability clause of the KV backend contract.
3079
+ */
3080
+ export type JournalMode = 'wal' | 'delete' | 'truncate' | 'persist'
3081
+ ```
3082
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-storage-sqlite -->
3083
+
3084
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-subagent -->
3085
+ <a id="deepseek-aidsh-subagent"></a>
3086
+
3087
+ ## `@deepseek-ai/dsh-subagent`
3088
+
3089
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
3090
+ - `source`: [`packages/subagent/subagent/src/index.ts:192`](../packages/subagent/subagent/src/index.ts)
3091
+
3092
+ ```ts config-catalog
3093
+ /** Host configuration for continuable subagent capacity. */
3094
+ export interface Config {
3095
+ /** Maximum live children sharing uninterrupted continuable parent links; defaults to 8. */
3096
+ maxActiveSubagents: Volatile<number>
3097
+ /** Default delegation depth for tools without an explicit limit; defaults to 1. */
3098
+ maxDepth: Volatile<number>
3099
+ }
3100
+ ```
3101
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-subagent -->
3102
+
3103
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-subagent-acp -->
3104
+ <a id="deepseek-aidsh-subagent-acp"></a>
3105
+
3106
+ ## `@deepseek-ai/dsh-subagent-acp`
3107
+
3108
+ - `inject`: `subagents` · `subprocess`
3109
+ - `source`: [`packages/subagent/subagent-acp/src/index.ts:27`](../packages/subagent/subagent-acp/src/index.ts)
3110
+
3111
+ ```ts config-catalog
3112
+ /** Config: how to spawn and drive the child ACP agent process. */
3113
+ export interface Config {
3114
+ /** Provider name on `ctx.subagents` (default `acp`). */
3115
+ providerName: string
3116
+ /** The executable to spawn for each run (the child ACP agent). */
3117
+ command: string
3118
+ /** Arguments passed to {@link command}. */
3119
+ args: string[]
3120
+ /**
3121
+ * Working directory override for the child process and its ACP session.
3122
+ * Must be non-empty; a relative path resolves against the harness launch
3123
+ * directory at load, and the result must be an existing directory. When
3124
+ * omitted, each child inherits its delegating parent session's cwd - and
3125
+ * starting one from a parent session that has no cwd fails.
3126
+ */
3127
+ cwd?: string
3128
+ /**
3129
+ * How to auto-answer the child's `session/request_permission` prompts:
3130
+ * `reject` (default - decline every prompt) or `allow` (approve via the first
3131
+ * `allow_once` or `allow_always` option). No prompt is surfaced to a human.
3132
+ */
3133
+ permission: PermissionPolicy
3134
+ /**
3135
+ * Extra environment variables for the child process - e.g. the child
3136
+ * harness's own `DEEPSEEK_API_KEY`. Forwarded on top of a credential-scrubbed
3137
+ * copy of the parent env, so an explicit key here reaches the child while
3138
+ * ambient secrets do not leak implicitly.
3139
+ */
3140
+ env: Record<string, string>
3141
+ /**
3142
+ * Grace period (ms) for the child's EOF-driven quiesce on dispose - its
3143
+ * window to flush persistence and tear down its own nested subprocesses
3144
+ * before the parent escalates to a signal. Must not exceed
3145
+ * `MAX_TIMER_DELAY_MS`.
3146
+ */
3147
+ disposeEofGraceMs?: number
3148
+ /** Failure-observation and termination-escalation grace (ms); must not exceed `MAX_TIMER_DELAY_MS`. */
3149
+ disposeGraceMs?: number
3150
+ }
3151
+
3152
+ /** Fixed response to child permission requests: reject by default, or select the first allow option. */
3153
+ export type PermissionPolicy = 'allow' | 'reject'
3154
+ ```
3155
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-subagent-acp -->
3156
+
3157
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-subagent-claude-code -->
3158
+ <a id="deepseek-aidsh-subagent-claude-code"></a>
3159
+
3160
+ ## `@deepseek-ai/dsh-subagent-claude-code`
3161
+
3162
+ - `inject`: `subagents` · `subprocess`
3163
+ - `source`: [`packages/subagent/subagent-claude-code/src/index.ts:38`](../packages/subagent/subagent-claude-code/src/index.ts)
3164
+
3165
+ ```ts config-catalog
3166
+ /** Deployment-owned model, permission, environment, and process-release settings. */
3167
+ export interface Config {
3168
+ /** Provider name on `ctx.subagents` (default `claude-code`). */
3169
+ providerName?: string
3170
+ /** Native Claude model fixed for this instance; omitted to inherit Claude settings. */
3171
+ model?: string
3172
+ /**
3173
+ * Explicit environment entries layered over the subprocess seam's
3174
+ * credential-scrubbed parent environment.
3175
+ */
3176
+ env?: Record<string, string>
3177
+ /**
3178
+ * Native non-interactive mode fixed for this Provider instance. Defaults to
3179
+ * `dontAsk`; `acceptEdits` accepts edits, `auto` uses the native classifier,
3180
+ * `plan` returns a plan without approving execution, and
3181
+ * `bypassPermissions` explicitly skips permission checks.
3182
+ */
3183
+ permissionMode?: ClaudeCodePermissionMode
3184
+ /** Grace in milliseconds between Claude Code managed-range termination tiers. */
3185
+ disposeGraceMs?: number
3186
+ }
3187
+
3188
+ /** Profile-selectable non-interactive Claude Code permission mode. */
3189
+ export type ClaudeCodePermissionMode = typeof CLAUDE_CODE_PERMISSION_MODES[number]
3190
+ ```
3191
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-subagent-claude-code -->
3192
+
3193
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-subagent-codex -->
3194
+ <a id="deepseek-aidsh-subagent-codex"></a>
3195
+
3196
+ ## `@deepseek-ai/dsh-subagent-codex`
3197
+
3198
+ - `inject`: `subagents` · `subprocess`
3199
+ - `source`: [`packages/subagent/subagent-codex/src/index.ts:36`](../packages/subagent/subagent-codex/src/index.ts)
3200
+
3201
+ ```ts config-catalog
3202
+ /** Deployment-owned model, permission, environment, and process-release settings. */
3203
+ export interface Config {
3204
+ /** Provider name on `ctx.subagents` (default `codex`). */
3205
+ providerName?: string
3206
+ /** Native Codex model fixed for this instance; omitted to inherit Codex settings. */
3207
+ model?: string
3208
+ /**
3209
+ * Explicit environment entries layered over the subprocess seam's
3210
+ * credential-scrubbed parent environment.
3211
+ */
3212
+ env?: Record<string, string>
3213
+ /** Native non-interactive permission mode fixed for this Provider instance. */
3214
+ permissionMode?: CodexPermissionMode
3215
+ /** Grace in milliseconds between app-server managed-range termination tiers. */
3216
+ disposeGraceMs?: number
3217
+ }
3218
+
3219
+ /** Profile-selectable non-interactive Codex permission mode. */
3220
+ export type CodexPermissionMode =
3221
+ | 'never'
3222
+ | 'approve-for-me'
3223
+ | 'dangerously-bypass-approvals-and-sandbox'
3224
+ ```
3225
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-subagent-codex -->
3226
+
3227
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-subagent-dsh-sdk -->
3228
+ <a id="deepseek-aidsh-subagent-dsh-sdk"></a>
3229
+
3230
+ ## `@deepseek-ai/dsh-subagent-dsh-sdk`
3231
+
3232
+ - `inject`: `subagents`
3233
+ - `source`: [`packages/subagent/subagent-dsh-sdk/src/index.ts:34`](../packages/subagent/subagent-dsh-sdk/src/index.ts)
3234
+
3235
+ ```ts config-catalog
3236
+ /** Config: how to spawn and drive the child SDK runtime process. */
3237
+ export interface Config {
3238
+ /** Provider name on `ctx.subagents` (default `dsh-sdk`). */
3239
+ providerName: string
3240
+ /** Explicit dsh CLI module, resolved and checked at plugin load; omission uses the SDK dependency. */
3241
+ dshBin?: string
3242
+ /** Named child profile (default `sdk`). */
3243
+ profile: string
3244
+ /** Ordered per-launch profile patch files, resolved and checked at plugin load. */
3245
+ patches: string[]
3246
+ /** Absolute isolated Harness home for every nested child process. */
3247
+ dshHome: string
3248
+ /**
3249
+ * Working directory override for the child process and its SDK session
3250
+ * workspace. Must be non-empty; a relative path resolves against the
3251
+ * harness launch directory at load, and the result must be an existing
3252
+ * directory. When omitted, each child inherits its delegating parent
3253
+ * session's cwd - and starting one from a parent session that has no cwd
3254
+ * fails.
3255
+ */
3256
+ cwd?: string
3257
+ /** Provider route the child runtime initializes with (default `deepseek-official`). */
3258
+ provider: string
3259
+ /** Model the child runtime initializes with (default `deepseek-v4-flash`). */
3260
+ model: string
3261
+ /** Optional per-request output-token cap for the child runtime. */
3262
+ maxTokens?: number
3263
+ /**
3264
+ * Extra environment variables for the child process - e.g. the child
3265
+ * runtime's own `DEEPSEEK_API_KEY`. Forwarded on top of a credential-scrubbed copy of the parent
3266
+ * env, so an explicit key here reaches the child while ambient secrets do
3267
+ * not leak implicitly.
3268
+ */
3269
+ env: Record<string, string>
3270
+ /** Bound (ms) on the protocol `shutdown` exchange during dispose. */
3271
+ shutdownTimeoutMs?: number
3272
+ /**
3273
+ * Grace period (ms) for the child's EOF-driven quiesce on dispose - its
3274
+ * window to flush persistence and tear down its own nested subprocesses
3275
+ * before the parent escalates to a signal.
3276
+ */
3277
+ disposeEofGraceMs?: number
3278
+ /** Termination confirmation window (ms), including forced exit on every platform. */
3279
+ disposeGraceMs?: number
3280
+ }
3281
+ ```
3282
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-subagent-dsh-sdk -->
3283
+
3284
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-subagent-fork-in-process -->
3285
+ <a id="deepseek-aidsh-subagent-fork-in-process"></a>
3286
+
3287
+ ## `@deepseek-ai/dsh-subagent-fork-in-process`
3288
+
3289
+ - `inject`: `subagents`
3290
+ - `source`: [`packages/subagent/subagent-fork-in-process/src/index.ts:31`](../packages/subagent/subagent-fork-in-process/src/index.ts)
3291
+
3292
+ ```ts config-catalog
3293
+ /** Config: the registry name to register the provider under. */
3294
+ export interface Config {
3295
+ /** Provider name on `ctx.subagents` (default `fork`). */
3296
+ providerName: string
3297
+ }
3298
+ ```
3299
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-subagent-fork-in-process -->
3300
+
3301
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-subagent-spawn-in-process -->
3302
+ <a id="deepseek-aidsh-subagent-spawn-in-process"></a>
3303
+
3304
+ ## `@deepseek-ai/dsh-subagent-spawn-in-process`
3305
+
3306
+ - `inject`: `subagents`
3307
+ - `source`: [`packages/subagent/subagent-spawn-in-process/src/index.ts:25`](../packages/subagent/subagent-spawn-in-process/src/index.ts)
3308
+
3309
+ ```ts config-catalog
3310
+ /** Config: the registry name to register the provider under. */
3311
+ export interface Config {
3312
+ /** Provider name on `ctx.subagents` (default `spawn`). */
3313
+ providerName: string
3314
+ }
3315
+ ```
3316
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-subagent-spawn-in-process -->
3317
+
3318
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-system-prompt -->
3319
+ <a id="deepseek-aidsh-system-prompt"></a>
3320
+
3321
+ ## `@deepseek-ai/dsh-system-prompt`
3322
+
3323
+ - `source`: [`packages/core/system-prompt/src/index.ts:247`](../packages/core/system-prompt/src/index.ts)
3324
+
3325
+ ```ts config-catalog
3326
+ /** Plugin config: the deployment-authored fragment of the system prompt (see {@link Config.personaPrefix} for its contract). */
3327
+ export interface Config {
3328
+ /** Include the fixed DeepSeek Harness identity before the deployment persona (default true). */
3329
+ includeHarnessIdentity?: boolean
3330
+ /** Include dynamic runtime-context snapshots in model history (default true). */
3331
+ includeRuntimeContext?: boolean
3332
+ /**
3333
+ * Deployment-wide persona prefix template before first-party guidance. A scoped section named
3334
+ * `deployment:persona-prefix` shadows it; `{{variable}}` references are strict.
3335
+ */
3336
+ personaPrefix?: string
3337
+ /**
3338
+ * Persona suffix template after first-party guidance. A scoped `deployment:persona-suffix`
3339
+ * section shadows it; `{{variable}}` references are strict. Defaults to empty.
3340
+ */
3341
+ personaSuffix?: string
3342
+ /**
3343
+ * Model-facing tool names in order, with {@link TOOL_ORDER_REST} exactly once.
3344
+ * Invalid fields fail at load and unknown names fail at assembly; known names
3345
+ * hidden in one scope may be absent there. Omitted means lexicographic order.
3346
+ */
3347
+ toolOrder?: string[]
3348
+ }
3349
+ ```
3350
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-system-prompt -->
3351
+
3352
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-terminal-bash -->
3353
+ <a id="deepseek-aidsh-terminal-bash"></a>
3354
+
3355
+ ## `@deepseek-ai/dsh-terminal-bash`
3356
+
3357
+ - `inject`: `terminals` · `sandboxPolicy` · `sessionProjections` · `subprocess`
3358
+ - `source`: [`packages/terminal/terminal-bash/src/config.ts:10`](../packages/terminal/terminal-bash/src/config.ts)
3359
+
3360
+ ```ts config-catalog
3361
+ /** Public plugin configuration. */
3362
+ export interface Config {
3363
+ /** Backend registry type (default: `shell`). */
3364
+ backendType?: string
3365
+ /** Interactive shell dialect (default: `bash`); selects the argv/env/startup defaults. */
3366
+ shellDialect?: ShellDialect
3367
+ /** Interactive shell executable (default per dialect: `/bin/bash`, or the resolved pwsh). */
3368
+ shellPath?: string
3369
+ /** Shell arguments (default per dialect: bash `--noprofile --norc -i`, pwsh `-NoLogo -NoProfile`). */
3370
+ shellArgs?: string[]
3371
+ /** Terminal rows. */
3372
+ rows?: number
3373
+ /** Terminal columns. */
3374
+ cols?: number
3375
+ /** Maximum retained logical lines. */
3376
+ scrollbackLines?: number
3377
+ /** Maximum retained UTF-8 bytes. */
3378
+ scrollbackMaxBytes?: number
3379
+ /** Maximum bytes returned by one read or settled viewport. */
3380
+ maxReadBytes?: number
3381
+ /** Readiness polling interval. */
3382
+ pollIntervalMs?: number
3383
+ /** Delay before Linux exact syscall probes. */
3384
+ exactProbeAfterMs?: number
3385
+ /** Silence duration that yields `inferred_idle`. */
3386
+ idleSilenceMs?: number
3387
+ /**
3388
+ * Extra wait beyond `idleSilenceMs`, once a prompt marker was seen, for the shell to
3389
+ * regain the foreground before `inferred_idle` settles; at least one `pollIntervalMs`.
3390
+ */
3391
+ handoffGraceMs?: number
3392
+ /**
3393
+ * Extra wait beyond `idleSilenceMs` and `handoffGraceMs`, once a prompt marker was seen but
3394
+ * its printable tail has not arrived, before `inferred_idle` settles. The marker is written
3395
+ * by the shell's own prompt function and the tail by the same render, so a missing tail is a
3396
+ * delivery delay on a contended host rather than an absent prompt. Zero keeps the bound at
3397
+ * `idleSilenceMs + handoffGraceMs`; any other value covers at least one `pollIntervalMs`, so a
3398
+ * nonzero tolerance always contains a readiness poll.
3399
+ */
3400
+ promptTailGraceMs?: number
3401
+ /** Absolute bound for one send and the complete pwsh startup sequence. */
3402
+ timeoutMs?: number
3403
+ /** Grace before teardown escalates to `SIGKILL`. */
3404
+ disposeGraceMs?: number
3405
+ }
3406
+
3407
+ /** One supported interactive shell dialect. */
3408
+ export type ShellDialect = 'bash' | 'pwsh'
3409
+ ```
3410
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-terminal-bash -->
3411
+
3412
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-time-context -->
3413
+ <a id="deepseek-aidsh-time-context"></a>
3414
+
3415
+ ## `@deepseek-ai/dsh-time-context`
3416
+
3417
+ - `inject`: `agents` · `sessionProjections`
3418
+ - `source`: [`packages/context/time-context/src/index.ts:56`](../packages/context/time-context/src/index.ts)
3419
+
3420
+ ```ts config-catalog
3421
+ /** Request-preparation clock formatting and append scheduling. Invalid values fail plugin load. */
3422
+ export interface Config {
3423
+ /** Fallback display zone when the open turn has no unique browser zone. Omit to use the process zone. */
3424
+ timeZone?: string
3425
+ /** Minimum milliseconds between durable injections in one session. Defaults to 600000 (10 minutes); 0 injects at every eligible step. */
3426
+ refreshIntervalMs?: number
3427
+ }
3428
+ ```
3429
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-time-context -->
3430
+
3431
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tmux-context -->
3432
+ <a id="deepseek-aidsh-tmux-context"></a>
3433
+
3434
+ ## `@deepseek-ai/dsh-tmux-context`
3435
+
3436
+ - `inject`: `agents` · `sessionProjections`
3437
+ - `source`: [`packages/context/tmux-context/src/index.ts:47`](../packages/context/tmux-context/src/index.ts)
3438
+
3439
+ ```ts config-catalog
3440
+ /** Per-turn tmux-location scheduling. Invalid values fail plugin load. */
3441
+ export interface Config {
3442
+ /** Minimum milliseconds between durable injections in one session. Omit or set to 0 to inject on every eligible change. */
3443
+ refreshIntervalMs?: number
3444
+ }
3445
+ ```
3446
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tmux-context -->
3447
+
3448
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-token-meter -->
3449
+ <a id="deepseek-aidsh-token-meter"></a>
3450
+
3451
+ ## `@deepseek-ai/dsh-token-meter`
3452
+
3453
+ - `inject`: `sessionProjections`
3454
+ - `source`: [`packages/llm/token-meter/src/types.ts:13`](../packages/llm/token-meter/src/types.ts)
3455
+
3456
+ ```ts config-catalog
3457
+ /** Token-meter plugin configuration; the fixed estimator has no settings. */
3458
+ export type TokenMeterConfig = Record<string, never>
3459
+ ```
3460
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-token-meter -->
3461
+
3462
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-ask-user -->
3463
+ <a id="deepseek-aidsh-tool-ask-user"></a>
3464
+
3465
+ ## `@deepseek-ai/dsh-tool-ask-user`
3466
+
3467
+ - `inject`: `tools` · `userQuestions`
3468
+ - `source`: [`packages/interaction/tool-ask-user/src/index.ts:16`](../packages/interaction/tool-ask-user/src/index.ts)
3469
+
3470
+ ```ts config-catalog
3471
+ /** Cordis row selecting the tool schema and its default foreground wait. */
3472
+ export interface Config {
3473
+ /** Tool definition selected by this Cordis row. Defaults to the blocking legacy tool. */
3474
+ mode?: 'legacy' | 'timed'
3475
+ /** Foreground wait before automatic continuation. Defaults to 120 seconds. */
3476
+ timeout?: number
3477
+ }
3478
+ ```
3479
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-ask-user -->
3480
+
3481
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-bash -->
3482
+ <a id="deepseek-aidsh-tool-bash"></a>
3483
+
3484
+ ## `@deepseek-ai/dsh-tool-bash`
3485
+
3486
+ - `inject`: `tools` · `shell` · `systemPrompt` · `shellEnv`
3487
+ - `source`: [`packages/shell/tool-bash/src/index.ts:37`](../packages/shell/tool-bash/src/index.ts)
3488
+
3489
+ ```ts config-catalog
3490
+ /** Configuration for the bash tool. */
3491
+ export interface Config {
3492
+ /**
3493
+ * Expose `run_in_background` while a job registry is composed (default
3494
+ * true); disabled calls are also rejected. Without a registry the tool is
3495
+ * foreground-only regardless.
3496
+ */
3497
+ enableRunInBackground?: boolean
3498
+ /**
3499
+ * Keep a foreground command that reaches its timeout running as a
3500
+ * background job instead of killing it (default true). Applies only while
3501
+ * background execution is available: with `enableRunInBackground` false or
3502
+ * no job registry, the executor's deadline kills the command. A foreground
3503
+ * command the registry refuses at its start (admission or a missing
3504
+ * controller) also runs under the deadline kill.
3505
+ */
3506
+ promoteOnTimeout?: boolean
3507
+ }
3508
+ ```
3509
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-bash -->
3510
+
3511
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-bash-persistent -->
3512
+ <a id="deepseek-aidsh-tool-bash-persistent"></a>
3513
+
3514
+ ## `@deepseek-ai/dsh-tool-bash-persistent`
3515
+
3516
+ - `inject`: `tools` · `terminals`
3517
+ - `source`: [`packages/shell/tool-bash-persistent/src/index.ts:444`](../packages/shell/tool-bash-persistent/src/index.ts)
3518
+
3519
+ ```ts config-catalog
3520
+ /** Configuration for the persistent Bash tool. */
3521
+ export interface Config {
3522
+ /** PTY backend used for each owner-isolated persistent shell (default `shell`). */
3523
+ backendType?: string
3524
+ /** Wall-clock limit for one command (default 300000). */
3525
+ timeoutMs?: number
3526
+ /** Maximum returned command-output characters before clipping (default 16000). */
3527
+ maxOutputChars?: number
3528
+ /** Model-facing tool description; deployments may describe their environment. */
3529
+ description?: string
3530
+ }
3531
+ ```
3532
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-bash-persistent -->
3533
+
3534
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-fs -->
3535
+ <a id="deepseek-aidsh-tool-fs"></a>
3536
+
3537
+ ## `@deepseek-ai/dsh-tool-fs`
3538
+
3539
+ - `inject`: `tools` · `fs` · `systemPrompt`
3540
+ - `source`: [`packages/fs/tool-fs/src/index.ts:25`](../packages/fs/tool-fs/src/index.ts)
3541
+
3542
+ ```ts config-catalog
3543
+ /** Plugin config (all optional - `Config` supplies the defaults). */
3544
+ export interface Config {
3545
+ /** Default and maximum number of lines returned by one `read` call. */
3546
+ readLimit?: number
3547
+ /** Maximum characters returned for a single line before truncation. */
3548
+ readMaxLineLength?: number
3549
+ /** Maximum bytes returned for the selected lines of one `read` call. */
3550
+ readMaxBytes?: number
3551
+ /** Files at or above this size stream instead of loading whole into memory. */
3552
+ readStreamMinSize?: number
3553
+ }
3554
+ ```
3555
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-fs -->
3556
+
3557
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-fs-search -->
3558
+ <a id="deepseek-aidsh-tool-fs-search"></a>
3559
+
3560
+ ## `@deepseek-ai/dsh-tool-fs-search`
3561
+
3562
+ - `inject`: `tools` · `systemPrompt` · `subprocess`
3563
+ - `source`: [`packages/fs/tool-fs-search/src/index.ts:73`](../packages/fs/tool-fs-search/src/index.ts)
3564
+
3565
+ ```ts config-catalog
3566
+ /** Plugin config; over-cap glob sampling is an explicit deployment choice and the remaining fields have defaults. */
3567
+ export interface Config {
3568
+ /** Whether an over-cap `glob` page is sampled across top-level entries instead of taking the modification-time head. */
3569
+ sampleOverCapGlobResults: boolean
3570
+ /** Max paths one `glob` call retains inline; later paths go to the formatted spill file. */
3571
+ globMaxResults?: number
3572
+ /** Max flat matches one `grep` call retains inline; later matches go to the formatted spill file. */
3573
+ grepMaxMatches?: number
3574
+ /** Max bytes retained for one matched-line preview (the cut preserves UTF-8 boundaries). */
3575
+ grepMaxLineBytes?: number
3576
+ /** Max bytes of one search's serialized `presentationMeta`; trailing groups/paths drop past it so the persisted card stays bounded. */
3577
+ searchMetaMaxBytes?: number
3578
+ /** Max complete raw `rg` stdout bytes a search will parse; larger raw output fails with `SEARCH_RAW_OUTPUT_OVERFLOW`. */
3579
+ rawOutputMaxBytes?: number
3580
+ /** Terminate-escalation grace (ms), handed to the subprocess seam and bounded by `MAX_TIMER_DELAY_MS`. */
3581
+ graceMs?: number
3582
+ /** Max bytes retained for one search's stderr tail; the excerpt is embedded in `SEARCH_*` error messages, never shown on success. */
3583
+ stderrMaxBytes?: number
3584
+ /**
3585
+ * Cooperative tool-call timeout budget (ms) on both tools, enforced by
3586
+ * `@deepseek-ai/dsh-tool-call-timeout-policy` through `exec.signal`.
3587
+ */
3588
+ timeoutMs?: number
3589
+ }
3590
+ ```
3591
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-fs-search -->
3592
+
3593
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-goal -->
3594
+ <a id="deepseek-aidsh-tool-goal"></a>
3595
+
3596
+ ## `@deepseek-ai/dsh-tool-goal`
3597
+
3598
+ - `inject`: `agents` · `goals` · `tools` · `systemPrompt` · `sessionProjections`
3599
+ - `source`: [`packages/goal/tool-goal/src/index.ts:32`](../packages/goal/tool-goal/src/index.ts)
3600
+
3601
+ ```ts config-catalog
3602
+ /** Model policy and hard lower bounds for goal-state updates. */
3603
+ export interface Config {
3604
+ /** Minimum admitted goal rounds before the model may self-report `blocked`. */
3605
+ blockedAfterConsecutiveRounds?: number
3606
+ }
3607
+ ```
3608
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-goal -->
3609
+
3610
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-jobs -->
3611
+ <a id="deepseek-aidsh-tool-jobs"></a>
3612
+
3613
+ ## `@deepseek-ai/dsh-tool-jobs`
3614
+
3615
+ - `inject`: `tools` · `jobs` · `systemPrompt`
3616
+ - `source`: [`packages/jobs/tool-jobs/src/index.ts:41`](../packages/jobs/tool-jobs/src/index.ts)
3617
+
3618
+ ```ts config-catalog
3619
+ /** Configures bounded `job_output` waits and completion-notice delivery. */
3620
+ export interface Config {
3621
+ /** Wait duration applied when `job_output` sets `wait` without `timeout_ms` (default 30s). */
3622
+ waitTimeoutMs?: number
3623
+ /** Hard cap on any single wait; a larger model-supplied `timeout_ms` is clamped down to it (default 10min). */
3624
+ maxWaitTimeoutMs?: number
3625
+ /** Whether a completion opens a turn on an idle owner (default `wakeup`). */
3626
+ completionDelivery?: CompletionDelivery
3627
+ /**
3628
+ * Turns one owner may have opened by completion wakes before the next
3629
+ * notice degrades to injection, reset by any user-authored input. Absent by
3630
+ * default: every idle completion wakes its owner. Set it to bound the
3631
+ * self-exciting chain where a woken turn starts the job whose completion
3632
+ * wakes it again, at the cost of notices past the cap waiting silently for
3633
+ * the next user input.
3634
+ */
3635
+ maxConsecutiveWakes?: number
3636
+ }
3637
+
3638
+ /**
3639
+ * How an uncollected completion reaches an owner that is already idle: `wakeup`
3640
+ * opens a turn for it, `quiet` leaves it pending until something else wakes the
3641
+ * owner. A busy owner is injected either way.
3642
+ */
3643
+ export type CompletionDelivery = 'quiet' | 'wakeup'
3644
+ ```
3645
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-jobs -->
3646
+
3647
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-lsp -->
3648
+ <a id="deepseek-aidsh-tool-lsp"></a>
3649
+
3650
+ ## `@deepseek-ai/dsh-tool-lsp`
3651
+
3652
+ - `inject`: `tools` · `lsp` · `systemPrompt`
3653
+ - `source`: [`packages/lsp/tool-lsp/src/index.ts:57`](../packages/lsp/tool-lsp/src/index.ts)
3654
+
3655
+ ```ts config-catalog
3656
+ /** Plugin configuration: result caps and the timeout budget. */
3657
+ export interface Config {
3658
+ /** Largest number of rendered locations before an omission marker (default 100). */
3659
+ maxLocations?: number
3660
+ /** Largest complete rendered result in characters, including truncation metadata (default 16000). */
3661
+ maxResultChars?: number
3662
+ /** Tool-call timeout budget in ms (default 60000). */
3663
+ timeoutMs?: number
3664
+ }
3665
+ ```
3666
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-lsp -->
3667
+
3668
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-present -->
3669
+ <a id="deepseek-aidsh-tool-present"></a>
3670
+
3671
+ ## `@deepseek-ai/dsh-tool-present`
3672
+
3673
+ - `inject`: `tools` · `fs` · `sessionProjections`
3674
+ - `source`: [`packages/deliverables/tool-present/src/index.ts:15`](../packages/deliverables/tool-present/src/index.ts)
3675
+
3676
+ ```ts config-catalog
3677
+ /** Per-call delivery limit. */
3678
+ export interface Config {
3679
+ /** Maximum number of files in one call. */
3680
+ maxFiles: number
3681
+ }
3682
+ ```
3683
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-present -->
3684
+
3685
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-pwsh -->
3686
+ <a id="deepseek-aidsh-tool-pwsh"></a>
3687
+
3688
+ ## `@deepseek-ai/dsh-tool-pwsh`
3689
+
3690
+ - `inject`: `tools` · `shell` · `systemPrompt` · `shellEnv`
3691
+ - `source`: [`packages/shell/tool-pwsh/src/index.ts:54`](../packages/shell/tool-pwsh/src/index.ts)
3692
+
3693
+ ```ts config-catalog
3694
+ /** Configuration for the pwsh tool. */
3695
+ export interface Config {
3696
+ /**
3697
+ * Expose `run_in_background` while a job registry is composed (default
3698
+ * true); disabled calls are also rejected. Without a registry the tool is
3699
+ * foreground-only regardless.
3700
+ */
3701
+ enableRunInBackground?: boolean
3702
+ /**
3703
+ * Keep a foreground command that reaches its timeout running as a
3704
+ * background job instead of killing it (default true). Applies only while
3705
+ * background execution is available: with `enableRunInBackground` false or
3706
+ * no job registry, the executor's deadline kills the command. A foreground
3707
+ * command the registry refuses at its start (admission or a missing
3708
+ * controller) also runs under the deadline kill.
3709
+ */
3710
+ promoteOnTimeout?: boolean
3711
+ }
3712
+ ```
3713
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-pwsh -->
3714
+
3715
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-pwsh-persistent -->
3716
+ <a id="deepseek-aidsh-tool-pwsh-persistent"></a>
3717
+
3718
+ ## `@deepseek-ai/dsh-tool-pwsh-persistent`
3719
+
3720
+ - `inject`: `tools` · `terminals`
3721
+ - `source`: [`packages/shell/tool-pwsh-persistent/src/index.ts:457`](../packages/shell/tool-pwsh-persistent/src/index.ts)
3722
+
3723
+ ```ts config-catalog
3724
+ /** Configuration for the persistent pwsh tool. */
3725
+ export interface Config {
3726
+ /** PTY backend used for each owner-isolated persistent shell (default `shell`). */
3727
+ backendType?: string
3728
+ /** Wall-clock limit for one command (default 300000). */
3729
+ timeoutMs?: number
3730
+ /** Maximum returned command-output characters before clipping (default 16000). */
3731
+ maxOutputChars?: number
3732
+ /** Model-facing tool description; deployments may describe their environment. */
3733
+ description?: string
3734
+ }
3735
+ ```
3736
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-pwsh-persistent -->
3737
+
3738
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-ralph -->
3739
+ <a id="deepseek-aidsh-tool-ralph"></a>
3740
+
3741
+ ## `@deepseek-ai/dsh-tool-ralph`
3742
+
3743
+ - `inject`: `tools` · `workflowEngine` · `subagents` · `systemPrompt`
3744
+ - `source`: [`packages/workflow/tool-ralph/src/index.ts:21`](../packages/workflow/tool-ralph/src/index.ts)
3745
+
3746
+ ```ts config-catalog
3747
+ /** Deployment policy for the fixed Ralph workflow. */
3748
+ export interface Config {
3749
+ /** Fresh structured-output provider used for every round (default `spawn`). */
3750
+ subagentProvider?: string
3751
+ /** Default and deployment ceiling for one call's round count (default 256). */
3752
+ maxRounds?: number
3753
+ /** Maximum serialized characters in one structured handoff (default 16384). */
3754
+ maxHandoffChars?: number
3755
+ /** Maximum characters in a successful parent-facing terminal text (default 16384). */
3756
+ maxResultChars?: number
3757
+ }
3758
+ ```
3759
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-ralph -->
3760
+
3761
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-session-query -->
3762
+ <a id="deepseek-aidsh-tool-session-query"></a>
3763
+
3764
+ ## `@deepseek-ai/dsh-tool-session-query`
3765
+
3766
+ - `inject`: `tools` · `systemPrompt` · `sessionQuery` · `sessionProjections`
3767
+ - `source`: [`packages/session-query/tool-session-query/src/index.ts:28`](../packages/session-query/tool-session-query/src/index.ts)
3768
+
3769
+ ```ts config-catalog
3770
+ /** Deployment-owned search count and timeout bounds. */
3771
+ export interface Config {
3772
+ /** Maximum authorized hits returned by one search call. Defaults to 100. */
3773
+ maxSearchResults?: number
3774
+ /** Cooperative full-text search deadline in milliseconds. Defaults to 30000. */
3775
+ searchTimeoutMs?: number
3776
+ }
3777
+ ```
3778
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-session-query -->
3779
+
3780
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-skill -->
3781
+ <a id="deepseek-aidsh-tool-skill"></a>
3782
+
3783
+ ## `@deepseek-ai/dsh-tool-skill`
3784
+
3785
+ - `inject`: `agents` · `tools` · `skills`
3786
+ - `source`: [`packages/skill/tool-skill/src/index.ts:61`](../packages/skill/tool-skill/src/index.ts)
3787
+
3788
+ ```ts config-catalog
3789
+ /** Model-facing skill catalog configuration. */
3790
+ export interface Config {
3791
+ /** Maximum normalized description length rendered in the session catalog; minimum 3. */
3792
+ catalogDescriptionMaxLength?: number
3793
+ }
3794
+ ```
3795
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-skill -->
3796
+
3797
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-str-replace-editor -->
3798
+ <a id="deepseek-aidsh-tool-str-replace-editor"></a>
3799
+
3800
+ ## `@deepseek-ai/dsh-tool-str-replace-editor`
3801
+
3802
+ - `inject`: `tools` · `fs`
3803
+ - `source`: [`packages/fs/tool-str-replace-editor/src/index.ts:506`](../packages/fs/tool-str-replace-editor/src/index.ts)
3804
+
3805
+ ```ts config-catalog
3806
+ /** Configuration for the string-replacement editor tool. */
3807
+ export interface Config {
3808
+ /** Maximum returned view characters before clipping (default 16000). */
3809
+ maxOutputChars?: number
3810
+ /** Model-facing tool description. */
3811
+ description?: string
3812
+ }
3813
+ ```
3814
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-str-replace-editor -->
3815
+
3816
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-subagent -->
3817
+ <a id="deepseek-aidsh-tool-subagent"></a>
3818
+
3819
+ ## `@deepseek-ai/dsh-tool-subagent`
3820
+
3821
+ - `inject`: `tools` · `subagents` · `systemPrompt` · `sessionProjections`
3822
+ - `refs`: [`AgentOptions`](subsystems/core.md)
3823
+ - `source`: [`packages/subagent/tool-subagent/src/index.ts:48`](../packages/subagent/tool-subagent/src/index.ts)
3824
+
3825
+ ```ts config-catalog
3826
+ /** Config: which registered provider this tool delegates to, plus child defaults. */
3827
+ export interface Config {
3828
+ /** The `ctx.subagents` provider name to start runs on (e.g. `spawn`, `acp`). */
3829
+ provider: string
3830
+ /**
3831
+ * Model-facing tool name (default `subagent`). Each loaded instance must use
3832
+ * a distinct name.
3833
+ */
3834
+ toolName?: string
3835
+ /**
3836
+ * Sample the Host `subagent-model-selection` setting for each new top-level
3837
+ * Session and inherit that decision in its child Sessions.
3838
+ */
3839
+ modelSelectionSettings?: boolean
3840
+ /**
3841
+ * Expose `run_in_background` (default true). Disabled instances omit the
3842
+ * parameter and reject forced background calls.
3843
+ */
3844
+ enableRunInBackground?: boolean
3845
+ /**
3846
+ * Background execution policy (default `one-shot`). `one-shot` defaults calls
3847
+ * to foreground; `continuable` defaults them to background, requires a provider
3848
+ * with the `prepareContinuable` capability, and returns the durable child id.
3849
+ * Follow-up adapters remain independently optional.
3850
+ */
3851
+ backgroundMode?: 'one-shot' | 'continuable'
3852
+ /**
3853
+ * Agent options applied to every child; omitted fields use child-loop defaults.
3854
+ */
3855
+ agentOptions?: AgentOptions
3856
+ /**
3857
+ * Per-child persona that shadows `deployment:persona-prefix`. Requires the
3858
+ * provider's `persona` capability; omission preserves the deployment persona.
3859
+ */
3860
+ persona?: string
3861
+ /**
3862
+ * Tool filter applied to every child. Filtered tools disappear from its
3863
+ * prompt and reject execution. Requires the provider's `toolFilter`
3864
+ * capability; unknown names fail startup.
3865
+ */
3866
+ toolFilter?: {
3867
+ /** Global tool names the child keeps; everything else is removed. */
3868
+ allow?: string[]
3869
+ /** Global tool names removed from the child. */
3870
+ deny?: string[]
3871
+ }
3872
+ /**
3873
+ * Maximum child depth: a non-negative safe integer (`0` forbids delegation),
3874
+ * or `'provider-managed'` to send no cap. A numeric cap
3875
+ * requires the provider's `depthLimit` capability (mount fails loud
3876
+ * otherwise). The provider checks the calling agent's current depth at every
3877
+ * start; the tool remains model-visible so runtime policy owns rejection.
3878
+ * `'provider-managed'` is for an out-of-process provider whose recursion
3879
+ * budget belongs to the child runtime or its own deployment. Omission reads
3880
+ * the current Host subagent depth setting (default `1`) at each delegation.
3881
+ */
3882
+ maxDepth?: number | 'provider-managed'
3883
+ }
3884
+ ```
3885
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-subagent -->
3886
+
3887
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-terminal -->
3888
+ <a id="deepseek-aidsh-tool-terminal"></a>
3889
+
3890
+ ## `@deepseek-ai/dsh-tool-terminal`
3891
+
3892
+ - `inject`: `terminals` · `tools` · `systemPrompt`
3893
+ - `source`: [`packages/terminal/tool-terminal/src/index.ts:36`](../packages/terminal/tool-terminal/src/index.ts)
3894
+
3895
+ ```ts config-catalog
3896
+ /** Model-facing terminal tool configuration. */
3897
+ export interface Config {
3898
+ /** Expose `run_in_background` and accept background sends (default true). */
3899
+ enableRunInBackground?: boolean
3900
+ /** Maximum UTF-8 bytes in one complete terminal or task-output result. */
3901
+ maxResultBytes?: number
3902
+ }
3903
+ ```
3904
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-terminal -->
3905
+
3906
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-todo -->
3907
+ <a id="deepseek-aidsh-tool-todo"></a>
3908
+
3909
+ ## `@deepseek-ai/dsh-tool-todo`
3910
+
3911
+ - `inject`: `tools` · `sessionProjections`
3912
+ - `source`: [`packages/todo/tool-todo/src/index.ts:29`](../packages/todo/tool-todo/src/index.ts)
3913
+
3914
+ ```ts config-catalog
3915
+ /** Model-facing todo tool configuration. */
3916
+ export interface Config {
3917
+ /**
3918
+ * Required deployment choice for whether several todos may be `in_progress` at once. True suits
3919
+ * agents that run work concurrently - subagents, background commands, workflow fan-out - and the
3920
+ * description then instructs the model to mark every actively worked task. False restores the
3921
+ * single-active discipline: the description asks for exactly one, and a call marking more is
3922
+ * rejected.
3923
+ */
3924
+ allowParallelInProgress: boolean
3925
+ }
3926
+ ```
3927
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-todo -->
3928
+
3929
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-web -->
3930
+ <a id="deepseek-aidsh-tool-web"></a>
3931
+
3932
+ ## `@deepseek-ai/dsh-tool-web`
3933
+
3934
+ - `inject`: `tools` · `web` · `systemPrompt`
3935
+ - `source`: [`packages/web/tool-web/src/index.ts:37`](../packages/web/tool-web/src/index.ts)
3936
+
3937
+ ```ts config-catalog
3938
+ /** Plugin config: which web tools to register, search bounds, per-tool budgets, and the fetch output cap. */
3939
+ export interface Config {
3940
+ /** Register `web_search`. Defaults to true. */
3941
+ search?: boolean
3942
+ /** Register `web_fetch`. Defaults to true. */
3943
+ fetch?: boolean
3944
+ /** Upper bound on sources returned by one `web_search` call. */
3945
+ searchMaxResults?: number
3946
+ /** Upper bound on queries accepted by one `web_search` call. */
3947
+ searchMaxQueries?: number
3948
+ /** Cooperative timeout budget (ms) for `web_fetch`. Defaults to 30000. */
3949
+ fetchTimeoutMs?: number
3950
+ /** Cooperative timeout budget (ms) for `web_search`. Defaults to 30000. */
3951
+ searchTimeoutMs?: number
3952
+ /** Cap on source characters converted and complete `web_fetch` output characters. Defaults to 200000. */
3953
+ fetchMaxOutputChars?: number
3954
+ }
3955
+ ```
3956
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-web -->
3957
+
3958
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-workflow -->
3959
+ <a id="deepseek-aidsh-tool-workflow"></a>
3960
+
3961
+ ## `@deepseek-ai/dsh-tool-workflow`
3962
+
3963
+ - `inject`: `tools` · `workflowEngine` · `systemPrompt`
3964
+ - `source`: [`packages/workflow/tool-workflow/src/index.ts:44`](../packages/workflow/tool-workflow/src/index.ts)
3965
+
3966
+ ```ts config-catalog
3967
+ /** Config: the model-facing tool name plus result rendering caps. */
3968
+ export interface Config {
3969
+ /** The model-facing tool name to register (default `workflow`). */
3970
+ toolName?: string
3971
+ /** Rendered-result ceiling, in characters: a longer JSON value is truncated with a notice (default 50000). */
3972
+ maxResultChars?: number
3973
+ /**
3974
+ * Expose `run_in_background` (default true); disabled calls are also
3975
+ * rejected. A background run needs a live `ctx.jobs` registry with a
3976
+ * controller serving the caller (`dsh-jobs-local` plus `dsh-tool-jobs` in
3977
+ * the shipped composition); without one the call fails with the missing
3978
+ * piece named.
3979
+ */
3980
+ enableRunInBackground?: boolean
3981
+ }
3982
+ ```
3983
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-workflow -->
3984
+
3985
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tool-workspace-dependencies -->
3986
+ <a id="deepseek-aidsh-tool-workspace-dependencies"></a>
3987
+
3988
+ ## `@deepseek-ai/dsh-tool-workspace-dependencies`
3989
+
3990
+ - `inject`: `tools`
3991
+ - `source`: [`packages/skill/tool-workspace-dependencies/src/index.ts:15`](../packages/skill/tool-workspace-dependencies/src/index.ts)
3992
+
3993
+ ```ts config-catalog
3994
+ /** Payload location and optional installation directory. */
3995
+ export interface Config {
3996
+ /** Payload directory carrying `runtime.json` and `dependencies/`. */
3997
+ readonly source: string
3998
+ /**
3999
+ * Installation directory under the Harness home. When set, the payload is copied there on the
4000
+ * first call (the Desktop behavior); when omitted, the payload is used in place without copying,
4001
+ * which suits read-only carriers such as container image layers.
4002
+ */
4003
+ readonly root?: string
4004
+ }
4005
+ ```
4006
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tool-workspace-dependencies -->
4007
+
4008
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-tools -->
4009
+ <a id="deepseek-aidsh-tools"></a>
4010
+
4011
+ ## `@deepseek-ai/dsh-tools`
4012
+
4013
+ - `inject`: `systemPrompt`
4014
+ - `source`: [`packages/core/tools/src/index.ts:674`](../packages/core/tools/src/index.ts)
4015
+
4016
+ ```ts config-catalog
4017
+ /** Plugin config: how the registered tools are presented to the model. */
4018
+ export interface Config {
4019
+ /**
4020
+ * Model presentation. `native` (default) sends every visible schema; `ptc`
4021
+ * sends only `run_code` plus a generated SDK prompt and collapses the
4022
+ * executor to the same surface (a model-direct call may only name
4023
+ * `run_code`; `run_code` SDK sub-dispatches keep every visible tool); `both`
4024
+ * sends both forms. PTC mode requires a `ctx.ptcRuntime` whose `language`
4025
+ * has a registered SDK renderer (TypeScript or Python) and fail prompt
4026
+ * assembly when it is absent or has no renderer. Under `ptc`, native names
4027
+ * in `toolOrder` are invalid.
4028
+ */
4029
+ mode?: ToolPresentationMode
4030
+ /**
4031
+ * Concurrency cap for a `run_code` program's overlapping sub-calls
4032
+ * (default 10, the loop scheduler's own default). Sub-calls follow the
4033
+ * native scheduling contract - only calls whose tools classify
4034
+ * concurrency-safe overlap; exclusive calls form barriers - so `1`
4035
+ * restores strictly serial dispatch. Must be a positive integer.
4036
+ */
4037
+ maxParallelSubCalls?: number
4038
+ }
4039
+
4040
+ /** How the registry presents its tools to the model (see {@link Config.mode}). */
4041
+ export type ToolPresentationMode = 'native' | 'ptc' | 'both'
4042
+ ```
4043
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-tools -->
4044
+
4045
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-typert-loader -->
4046
+ <a id="deepseek-aidsh-typert-loader"></a>
4047
+
4048
+ ## `@deepseek-ai/dsh-typert-loader`
4049
+
4050
+ - `inject`: `typert` · `loader`
4051
+ - `source`: [`packages/typert/loader/src/index.ts:48`](../packages/typert/loader/src/index.ts)
4052
+
4053
+ ```ts config-catalog
4054
+ /** Additional package artifacts whose owning plugins are nested behind another Loader entry. */
4055
+ export interface Config {
4056
+ /** Exact npm package names that must resolve and export `./typert`. */
4057
+ packages?: string[]
4058
+ }
4059
+ ```
4060
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-typert-loader -->
4061
+
4062
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-user-approval -->
4063
+ <a id="deepseek-aidsh-user-approval"></a>
4064
+
4065
+ ## `@deepseek-ai/dsh-user-approval`
4066
+
4067
+ - `source`: [`packages/interaction/user-approval/src/index.ts:135`](../packages/interaction/user-approval/src/index.ts)
4068
+
4069
+ ```ts config-catalog
4070
+ /** Plugin config. All optional - `static Config` supplies the defaults. */
4071
+ export interface Config {
4072
+ /**
4073
+ * The deployment's default {@link ApprovalPolicy} for sessions without an
4074
+ * `approval/policy` override - `'ask'` delegates to the composed answerers
4075
+ * (fail-closed with none); `'never'` auto-rejects every ask without
4076
+ * prompting (the deterministic CI/unattended stance).
4077
+ */
4078
+ readonly policy?: ApprovalPolicy
4079
+ }
4080
+
4081
+ /**
4082
+ * A session's approval policy - what happens to an {@link ApprovalService}
4083
+ * ask BEFORE any interactive answerer sees it:
4084
+ *
4085
+ * - `'ask'` (the default) - delegate to the composed answerers; with none
4086
+ * composed the chain falls through to the fail-closed `'unavailable'`.
4087
+ * - `'never'` - never prompt anyone: every ask resolves `'rejected'`
4088
+ * deterministically. The strict headless stance (CI, unattended runs) and
4089
+ * the policy whose outcome is knowable without asking.
4090
+ */
4091
+ export type ApprovalPolicy = 'ask' | 'never'
4092
+ ```
4093
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-user-approval -->
4094
+
4095
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-web -->
4096
+ <a id="deepseek-aidsh-web"></a>
4097
+
4098
+ ## `@deepseek-ai/dsh-web`
4099
+
4100
+ - `source`: [`packages/web/web/src/index.ts:55`](../packages/web/web/src/index.ts)
4101
+
4102
+ ```ts config-catalog
4103
+ /**
4104
+ * Config for the web seam. `searchProvider` / `fetchProvider` pin which provider
4105
+ * wins for each capability; both are optional (a single registered usable
4106
+ * provider auto-selects). Operational overrides such as environment variables
4107
+ * must feed these same fields rather than introduce a hidden priority chain.
4108
+ */
4109
+ export interface WebRuntimeConfig {
4110
+ /** Explicit search provider id. Omitted = auto-select when exactly one usable. */
4111
+ readonly searchProvider?: string
4112
+ /** Explicit fetch provider id. Omitted = auto-select when exactly one usable. */
4113
+ readonly fetchProvider?: string
4114
+ }
4115
+ ```
4116
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-web -->
4117
+
4118
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-web-app -->
4119
+ <a id="deepseek-aidsh-web-app"></a>
4120
+
4121
+ ## `@deepseek-ai/dsh-web-app`
4122
+
4123
+ - `inject`: `webServer`
4124
+ - `source`: [`packages/bundle/web-app/src/index.ts:44`](../packages/bundle/web-app/src/index.ts)
4125
+
4126
+ ```ts config-catalog
4127
+ /** Plugin config: composed deployment settings plus per-invocation command-line values. */
4128
+ export interface Config {
4129
+ /** Permit default-browser handoff after the Loader tree settles; an SSH launch suppresses it. */
4130
+ openBrowser: boolean
4131
+ /** Print the URL line on activation; a non-interactive layer can turn it off. */
4132
+ printUrl: boolean
4133
+ /**
4134
+ * Register the model-visible surface context (the `app:web-surface` prompt
4135
+ * section and the `DSH_WEB_URL` bash variable). A one-shot non-interactive
4136
+ * layer can turn it off when its user is not in the GUI, so the
4137
+ * orientation text would be false.
4138
+ */
4139
+ surfaceContext: boolean
4140
+ /** Explicit `--trusted-host` authorities from this invocation. */
4141
+ trustedHosts: string[]
4142
+ }
4143
+ ```
4144
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-web-app -->
4145
+
4146
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-web-fetch-http -->
4147
+ <a id="deepseek-aidsh-web-fetch-http"></a>
4148
+
4149
+ ## `@deepseek-ai/dsh-web-fetch-http`
4150
+
4151
+ - `inject`: `web`
4152
+ - `source`: [`packages/web/web-fetch-http/src/index.ts:32`](../packages/web/web-fetch-http/src/index.ts)
4153
+
4154
+ ```ts config-catalog
4155
+ /** Plugin config: the provider's transport and size limits plus its `User-Agent` (all defaulted). */
4156
+ export interface Config {
4157
+ /** Maximum response body size in bytes. */
4158
+ maxResponseBytes?: number
4159
+ /** Maximum decoded body length in characters. */
4160
+ maxBodyChars?: number
4161
+ /** Default fetch timeout in milliseconds, within Node's timer range. */
4162
+ timeoutMs?: number
4163
+ /** Maximum number of same-origin redirect hops to follow. */
4164
+ maxRedirects?: number
4165
+ /** `User-Agent` header sent on every request. */
4166
+ userAgent?: string
4167
+ }
4168
+ ```
4169
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-web-fetch-http -->
4170
+
4171
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-web-search-deepseek -->
4172
+ <a id="deepseek-aidsh-web-search-deepseek"></a>
4173
+
4174
+ ## `@deepseek-ai/dsh-web-search-deepseek`
4175
+
4176
+ - `inject`: `web`
4177
+ - `refs`: `Volatile` (`@deepseek-ai/cordis`)
4178
+ - `source`: [`packages/web/web-search-deepseek/src/index.ts:49`](../packages/web/web-search-deepseek/src/index.ts)
4179
+
4180
+ ```ts config-catalog
4181
+ /** Plugin config (all optional - `apply` fills env-var and constant defaults). */
4182
+ export interface Config {
4183
+ /** Literal DeepSeek API key; prefer {@link apiKeyEnv} so no secret enters configuration files. */
4184
+ apiKey: Volatile<string | undefined>
4185
+ /** Credential reference resolved for each search; defaults to `DEEPSEEK_API_KEY`. */
4186
+ apiKeyEnv: Volatile<string>
4187
+ /** Anthropic-compatible endpoint base; `/messages` is appended. */
4188
+ baseURL: Volatile<string | undefined>
4189
+ /** Anthropic-format model name. Defaults to `deepseek-v4-flash`. */
4190
+ model: Volatile<string>
4191
+ /** `anthropic-version` header value. Defaults to `2023-06-01`. */
4192
+ apiVersion: Volatile<string>
4193
+ /** Upper bound on generated tokens for the Messages request. Defaults to 4096. */
4194
+ maxTokens: Volatile<number>
4195
+ /** Maximum `web_search` server-tool uses per request. Defaults to 5. */
4196
+ maxUses: Volatile<number>
4197
+ }
4198
+ ```
4199
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-web-search-deepseek -->
4200
+
4201
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-web-search-exa -->
4202
+ <a id="deepseek-aidsh-web-search-exa"></a>
4203
+
4204
+ ## `@deepseek-ai/dsh-web-search-exa`
4205
+
4206
+ - `inject`: `web`
4207
+ - `source`: [`packages/web/web-search-exa/src/index.ts:35`](../packages/web/web-search-exa/src/index.ts)
4208
+
4209
+ ```ts config-catalog
4210
+ /** Plugin config (all optional - `apply` fills env-var and constant defaults). */
4211
+ export interface Config {
4212
+ /** Exa API key. Falls back to `$EXA_API_KEY`. Empty → provider unavailable. */
4213
+ apiKey?: string
4214
+ /** Endpoint base; `/search` is appended. Defaults to the public API. */
4215
+ baseURL?: string
4216
+ /** Retrieval mode sent as Exa's `type`. Defaults to `auto`. */
4217
+ searchType?: 'auto' | 'keyword' | 'neural'
4218
+ /** Default result count when a request carries no `maxResults`. Omitted = none. */
4219
+ numResults?: number
4220
+ /** Highlight sentences requested per result. Defaults to 1. */
4221
+ highlightsPerResult?: number
4222
+ }
4223
+ ```
4224
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-web-search-exa -->
4225
+
4226
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-web-search-perplexity -->
4227
+ <a id="deepseek-aidsh-web-search-perplexity"></a>
4228
+
4229
+ ## `@deepseek-ai/dsh-web-search-perplexity`
4230
+
4231
+ - `inject`: `web`
4232
+ - `source`: [`packages/web/web-search-perplexity/src/index.ts:30`](../packages/web/web-search-perplexity/src/index.ts)
4233
+
4234
+ ```ts config-catalog
4235
+ /** Plugin config (all optional - `apply` fills env-var and constant defaults). */
4236
+ export interface Config {
4237
+ /** Perplexity API key. Falls back to `$PERPLEXITY_API_KEY`. Empty → unavailable. */
4238
+ apiKey?: string
4239
+ /** Endpoint base; `/chat/completions` is appended. Defaults to the public API. */
4240
+ baseURL?: string
4241
+ /** Search model name. Defaults to `sonar`. */
4242
+ model?: string
4243
+ /** Upper bound on generated answer tokens. Defaults to 1024. */
4244
+ maxTokens?: number
4245
+ /** Recency window sent as `search_recency_filter`. Omitted = no filter. */
4246
+ searchRecency?: 'day' | 'week' | 'month' | 'year'
4247
+ }
4248
+ ```
4249
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-web-search-perplexity -->
4250
+
4251
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-webhook-github -->
4252
+ <a id="deepseek-aidsh-webhook-github"></a>
4253
+
4254
+ ## `@deepseek-ai/dsh-webhook-github`
4255
+
4256
+ - `inject`: `webServer` · `webhookRuntime` · `credentials`
4257
+ - `source`: [`packages/webhook/webhook-github/src/index.ts:17`](../packages/webhook/webhook-github/src/index.ts)
4258
+
4259
+ ```ts config-catalog
4260
+ /** Required GitHub ingress configuration. */
4261
+ export interface Config {
4262
+ /** Adapter instance name carried to rules. */
4263
+ readonly source: string
4264
+ /** Exact absolute route path. */
4265
+ readonly path: string
4266
+ /** Credential reference containing the shared webhook secret. */
4267
+ readonly secretEnv: string
4268
+ /** Positive raw body ceiling in bytes. */
4269
+ readonly maxBodyBytes: number
4270
+ }
4271
+ ```
4272
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-webhook-github -->
4273
+
4274
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-workflow-ptc -->
4275
+ <a id="deepseek-aidsh-workflow-ptc"></a>
4276
+
4277
+ ## `@deepseek-ai/dsh-workflow-ptc`
4278
+
4279
+ - `inject`: `subagents` · `ptcRuntime` · `sandboxPolicy`
4280
+ - `source`: [`packages/workflow/workflow-ptc/src/index.ts:32`](../packages/workflow/workflow-ptc/src/index.ts)
4281
+
4282
+ ```ts config-catalog
4283
+ /** Plugin config (all optional - `static Config` supplies the defaults). */
4284
+ export interface Config {
4285
+ /** The `ctx.subagents` provider children run on (default `spawn`). */
4286
+ provider?: string
4287
+ /** Concurrent `agent()` ceiling; `0` (the default) auto-resolves to `min(16, max(1, cores - 2))`. */
4288
+ maxConcurrentAgents?: number
4289
+ /** Total `agent()` calls one run may start - the runaway-loop backstop (default 1000). */
4290
+ maxTotalAgents?: number
4291
+ /** Items accepted by a single `parallel()`/`pipeline()` call (default 4096). */
4292
+ maxItemsPerCall?: number
4293
+ /** VM timeout for the script's initial synchronous slice (default 5000 ms). */
4294
+ syncTimeoutMs?: number
4295
+ }
4296
+ ```
4297
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-workflow-ptc -->
4298
+
4299
+ <!-- BEGIN GENERATED config-catalog:@deepseek-ai/dsh-workspace-changes -->
4300
+ <a id="deepseek-aidsh-workspace-changes"></a>
4301
+
4302
+ ## `@deepseek-ai/dsh-workspace-changes`
4303
+
4304
+ - `inject`: `subprocess`
4305
+ - `source`: [`packages/deliverables/workspace-changes/src/index.ts:33`](../packages/deliverables/workspace-changes/src/index.ts)
4306
+
4307
+ ```ts config-catalog
4308
+ /** Snapshot, capture, and comparison bounds. Invalid values fail plugin load. */
4309
+ export interface Config {
4310
+ /** Milliseconds one git command may run before the turn's record is abandoned. */
4311
+ timeoutMs: number
4312
+ /** Bytes of git output retained per command; a larger diff listing abandons the record. */
4313
+ outputMaxBytes: number
4314
+ /** Maximum files carried by one summary; `total` still reports the complete count. */
4315
+ maxFiles: number
4316
+ /**
4317
+ * Bytes a file may hold to be captured around a file-tool edit or read from a snapshot for its comparison.
4318
+ * A larger file gets no comparison; one captured around a file-tool edit is also listed without counts.
4319
+ */
4320
+ maxFileBytes: number
4321
+ /** Milliseconds a line comparison may run before it degrades to whole-file replacement. */
4322
+ diffTimeoutMs: number
4323
+ }
4324
+ ```
4325
+ <!-- END GENERATED config-catalog:@deepseek-ai/dsh-workspace-changes -->
4326
+
4327
+ ## Loadable plugins with no config
4328
+
4329
+ These load from a `cordis.yml` entry with no `config:` block; they declare no configuration API.
4330
+
4331
+ <!-- BEGIN GENERATED config-catalog:no-config -->
4332
+ | `package` | `inject` | `source` |
4333
+ | --- | --- | --- |
4334
+ | `@deepseek-ai/dsh-acp-app` | `cmdlineArgs` | [`packages/bundle/acp-app/src/index.ts`](../packages/bundle/acp-app/src/index.ts) |
4335
+ | `@deepseek-ai/dsh-agent` | - | [`packages/core/agent/src/index.ts`](../packages/core/agent/src/index.ts) |
4336
+ | `@deepseek-ai/dsh-api-account-controller` | `deepseekAccount` · `agents` | [`packages/api/account-controller/src/index.ts`](../packages/api/account-controller/src/index.ts) |
4337
+ | `@deepseek-ai/dsh-api-remotes` | `typertGateway` | [`packages/api/remotes/src/index.ts`](../packages/api/remotes/src/index.ts) |
4338
+ | `@deepseek-ai/dsh-authorization` | `credentials` | [`packages/credentials/authorization/src/index.ts`](../packages/credentials/authorization/src/index.ts) |
4339
+ | `@deepseek-ai/dsh-browser-use` | - | [`packages/browser-use/browser-use/src/index.ts`](../packages/browser-use/browser-use/src/index.ts) |
4340
+ | `@deepseek-ai/dsh-client-file-upload` | `agents` · `attachments` · `commands` · `connection` | [`packages/client/file-upload/src/index.ts`](../packages/client/file-upload/src/index.ts) |
4341
+ | `@deepseek-ai/dsh-client-locale` | - | [`packages/client/locale/src/index.ts`](../packages/client/locale/src/index.ts) |
4342
+ | `@deepseek-ai/dsh-client-modules` | `loader` | [`packages/client/modules/src/index.ts`](../packages/client/modules/src/index.ts) |
4343
+ | `@deepseek-ai/dsh-client-resources` | - | [`packages/client/resources/src/index.ts`](../packages/client/resources/src/index.ts) |
4344
+ | `@deepseek-ai/dsh-client-ui-agent-preset` | - | [`packages/client/ui-agent-preset/src/index.ts`](../packages/client/ui-agent-preset/src/index.ts) |
4345
+ | `@deepseek-ai/dsh-client-ui-approval` | - | [`packages/client/ui-approval/src/index.ts`](../packages/client/ui-approval/src/index.ts) |
4346
+ | `@deepseek-ai/dsh-client-ui-attachment` | - | [`packages/client/ui-attachment/src/index.ts`](../packages/client/ui-attachment/src/index.ts) |
4347
+ | `@deepseek-ai/dsh-client-ui-brand-official` | - | [`packages/client/ui-brand-official/src/index.ts`](../packages/client/ui-brand-official/src/index.ts) |
4348
+ | `@deepseek-ai/dsh-client-ui-chat` | - | [`packages/client/ui-chat/src/index.ts`](../packages/client/ui-chat/src/index.ts) |
4349
+ | `@deepseek-ai/dsh-client-ui-commands` | - | [`packages/client/ui-commands/src/index.ts`](../packages/client/ui-commands/src/index.ts) |
4350
+ | `@deepseek-ai/dsh-client-ui-conversation` | - | [`packages/client/ui-conversation/src/index.ts`](../packages/client/ui-conversation/src/index.ts) |
4351
+ | `@deepseek-ai/dsh-client-ui-cordis` | - | [`packages/extensions/ui-cordis/src/index.ts`](../packages/extensions/ui-cordis/src/index.ts) |
4352
+ | `@deepseek-ai/dsh-client-ui-deliverables` | `systemPrompt` · `connection` · `sessionQuery` · `sessionController` · `workspaceFiles` · `fs` · `sandboxPolicy` · `workspaceChanges` | [`packages/client/ui-deliverables/src/index.ts`](../packages/client/ui-deliverables/src/index.ts) |
4353
+ | `@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) |
4354
+ | `@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) |
4355
+ | `@deepseek-ai/dsh-client-ui-goal` | - | [`packages/client/ui-goal/src/index.ts`](../packages/client/ui-goal/src/index.ts) |
4356
+ | `@deepseek-ai/dsh-client-ui-input-trigger` | - | [`packages/client/ui-input-trigger/src/index.ts`](../packages/client/ui-input-trigger/src/index.ts) |
4357
+ | `@deepseek-ai/dsh-client-ui-jobs` | - | [`packages/client/ui-jobs/src/index.ts`](../packages/client/ui-jobs/src/index.ts) |
4358
+ | `@deepseek-ai/dsh-client-ui-layout` | - | [`packages/client/ui-layout/src/index.ts`](../packages/client/ui-layout/src/index.ts) |
4359
+ | `@deepseek-ai/dsh-client-ui-message-feedback` | - | [`packages/client/ui-message-feedback/src/index.ts`](../packages/client/ui-message-feedback/src/index.ts) |
4360
+ | `@deepseek-ai/dsh-client-ui-model-selection` | - | [`packages/client/ui-model-selection/src/index.ts`](../packages/client/ui-model-selection/src/index.ts) |
4361
+ | `@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) |
4362
+ | `@deepseek-ai/dsh-client-ui-permission-presets` | - | [`packages/client/ui-permission-presets/src/index.ts`](../packages/client/ui-permission-presets/src/index.ts) |
4363
+ | `@deepseek-ai/dsh-client-ui-plan` | - | [`packages/client/ui-plan/src/index.ts`](../packages/client/ui-plan/src/index.ts) |
4364
+ | `@deepseek-ai/dsh-client-ui-reference` | - | [`packages/client/ui-reference/src/index.ts`](../packages/client/ui-reference/src/index.ts) |
4365
+ | `@deepseek-ai/dsh-client-ui-renderer` | - | [`packages/client/ui-renderer/src/index.ts`](../packages/client/ui-renderer/src/index.ts) |
4366
+ | `@deepseek-ai/dsh-client-ui-schedule` | - | [`packages/client/ui-schedule/src/index.ts`](../packages/client/ui-schedule/src/index.ts) |
4367
+ | `@deepseek-ai/dsh-client-ui-session` | - | [`packages/client/ui-session/src/index.ts`](../packages/client/ui-session/src/index.ts) |
4368
+ | `@deepseek-ai/dsh-client-ui-settings` | - | [`packages/client/ui-settings/src/index.ts`](../packages/client/ui-settings/src/index.ts) |
4369
+ | `@deepseek-ai/dsh-client-ui-settings-agent-loop` | - | [`packages/client/ui-settings-agent-loop/src/index.ts`](../packages/client/ui-settings-agent-loop/src/index.ts) |
4370
+ | `@deepseek-ai/dsh-client-ui-settings-general` | - | [`packages/client/ui-settings-general/src/index.ts`](../packages/client/ui-settings-general/src/index.ts) |
4371
+ | `@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) |
4372
+ | `@deepseek-ai/dsh-client-ui-settings-plugins` | - | [`packages/client/ui-settings-plugins/src/index.ts`](../packages/client/ui-settings-plugins/src/index.ts) |
4373
+ | `@deepseek-ai/dsh-client-ui-settings-session-log` | - | [`packages/client/ui-settings-session-log/src/index.ts`](../packages/client/ui-settings-session-log/src/index.ts) |
4374
+ | `@deepseek-ai/dsh-client-ui-settings-shell` | - | [`packages/client/ui-settings-shell/src/index.ts`](../packages/client/ui-settings-shell/src/index.ts) |
4375
+ | `@deepseek-ai/dsh-client-ui-settings-subagent` | - | [`packages/client/ui-settings-subagent/src/index.ts`](../packages/client/ui-settings-subagent/src/index.ts) |
4376
+ | `@deepseek-ai/dsh-client-ui-settings-web-search` | - | [`packages/client/ui-settings-web-search/src/index.ts`](../packages/client/ui-settings-web-search/src/index.ts) |
4377
+ | `@deepseek-ai/dsh-client-ui-shortcuts` | - | [`packages/client/ui-shortcuts/src/index.ts`](../packages/client/ui-shortcuts/src/index.ts) |
4378
+ | `@deepseek-ai/dsh-client-ui-sidebar` | - | [`packages/client/ui-sidebar/src/index.ts`](../packages/client/ui-sidebar/src/index.ts) |
4379
+ | `@deepseek-ai/dsh-client-ui-sidebar-browser` | - | [`packages/client/ui-sidebar-browser/src/index.ts`](../packages/client/ui-sidebar-browser/src/index.ts) |
4380
+ | `@deepseek-ai/dsh-client-ui-sidebar-files` | - | [`packages/client/ui-sidebar-files/src/index.ts`](../packages/client/ui-sidebar-files/src/index.ts) |
4381
+ | `@deepseek-ai/dsh-client-ui-sidebar-right` | - | [`packages/client/ui-sidebar-right/src/index.ts`](../packages/client/ui-sidebar-right/src/index.ts) |
4382
+ | `@deepseek-ai/dsh-client-ui-sidebar-terminal` | - | [`packages/client/ui-sidebar-terminal/src/index.ts`](../packages/client/ui-sidebar-terminal/src/index.ts) |
4383
+ | `@deepseek-ai/dsh-client-ui-skill` | - | [`packages/client/ui-skill/src/index.ts`](../packages/client/ui-skill/src/index.ts) |
4384
+ | `@deepseek-ai/dsh-client-ui-subagent` | - | [`packages/client/ui-subagent/src/index.ts`](../packages/client/ui-subagent/src/index.ts) |
4385
+ | `@deepseek-ai/dsh-client-ui-tool` | - | [`packages/client/ui-tool/src/index.ts`](../packages/client/ui-tool/src/index.ts) |
4386
+ | `@deepseek-ai/dsh-client-ui-trajectory` | - | [`packages/client/ui-trajectory/src/index.ts`](../packages/client/ui-trajectory/src/index.ts) |
4387
+ | `@deepseek-ai/dsh-client-ui-user-questions` | - | [`packages/client/ui-user-questions/src/index.ts`](../packages/client/ui-user-questions/src/index.ts) |
4388
+ | `@deepseek-ai/dsh-client-ui-workflow-run` | - | [`packages/client/ui-workflow-run/src/index.ts`](../packages/client/ui-workflow-run/src/index.ts) |
4389
+ | `@deepseek-ai/dsh-client-ui-workspace` | - | [`packages/client/ui-workspace/src/index.ts`](../packages/client/ui-workspace/src/index.ts) |
4390
+ | `@deepseek-ai/dsh-command-compact` | `commands` · `compaction` | [`packages/compaction/command-compact/src/index.ts`](../packages/compaction/command-compact/src/index.ts) |
4391
+ | `@deepseek-ai/dsh-command-feedback` | `commands` | [`packages/feedback/command-feedback/src/index.ts`](../packages/feedback/command-feedback/src/index.ts) |
4392
+ | `@deepseek-ai/dsh-command-goal` | `commands` · `goals` | [`packages/goal/command-goal/src/index.ts`](../packages/goal/command-goal/src/index.ts) |
4393
+ | `@deepseek-ai/dsh-commands` | - | [`packages/interaction/commands/src/index.ts`](../packages/interaction/commands/src/index.ts) |
4394
+ | `@deepseek-ai/dsh-compaction-image-offload` | `agents` · `sessions` | [`packages/compaction/compaction-image-offload/src/index.ts`](../packages/compaction/compaction-image-offload/src/index.ts) |
4395
+ | `@deepseek-ai/dsh-computer-use` | - | [`packages/computer-use/computer-use/src/index.ts`](../packages/computer-use/computer-use/src/index.ts) |
4396
+ | `@deepseek-ai/dsh-config-editor` | `loader` · `profileContext` | [`packages/boot/config-editor/src/index.ts`](../packages/boot/config-editor/src/index.ts) |
4397
+ | `@deepseek-ai/dsh-cordis-client-runner` | - | [`packages/extensions/cordis-client-runner/src/index.ts`](../packages/extensions/cordis-client-runner/src/index.ts) |
4398
+ | `@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) |
4399
+ | `@deepseek-ai/dsh-experimental-auto-review` | `approval` · `llm` · `permissionPresets` · `sessions` · `tools` | [`packages/experimental/auto-review/src/index.ts`](../packages/experimental/auto-review/src/index.ts) |
4400
+ | `@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) |
4401
+ | `@deepseek-ai/dsh-experimental-client-ui-voice-input` | - | [`packages/experimental/client-ui-voice-input/src/index.ts`](../packages/experimental/client-ui-voice-input/src/index.ts) |
4402
+ | `@deepseek-ai/dsh-experimental-computer-use-cua-driver-native` | `computerUse` · `tools` · `systemPrompt` | [`packages/experimental/computer-use-cua-driver-native/src/index.ts`](../packages/experimental/computer-use-cua-driver-native/src/index.ts) |
4403
+ | `@deepseek-ai/dsh-fs-observation-policy` | - | [`packages/fs/fs-observation-policy/src/index.ts`](../packages/fs/fs-observation-policy/src/index.ts) |
4404
+ | `@deepseek-ai/dsh-fs-ssh` | `ssh` · `sandboxPolicy` | [`packages/ssh/fs-ssh/src/index.ts`](../packages/ssh/fs-ssh/src/index.ts) |
4405
+ | `@deepseek-ai/dsh-goal-round-driver` | `agents` · `goals` · `sessions` | [`packages/goal/goal-round-driver/src/index.ts`](../packages/goal/goal-round-driver/src/index.ts) |
4406
+ | `@deepseek-ai/dsh-host-directory-picker-auto` | `webServer` · `loader` | [`packages/host/directory-picker-auto/src/index.ts`](../packages/host/directory-picker-auto/src/index.ts) |
4407
+ | `@deepseek-ai/dsh-host-directory-picker-native` | - | [`packages/host/directory-picker-native/src/index.ts`](../packages/host/directory-picker-native/src/index.ts) |
4408
+ | `@deepseek-ai/dsh-host-plugin-inventory` | `loader` | [`packages/host/plugin-inventory/src/index.ts`](../packages/host/plugin-inventory/src/index.ts) |
4409
+ | `@deepseek-ai/dsh-llm` | - | [`packages/llm/llm/src/index.ts`](../packages/llm/llm/src/index.ts) |
4410
+ | `@deepseek-ai/dsh-lsp` | - | [`packages/lsp/lsp/src/index.ts`](../packages/lsp/lsp/src/index.ts) |
4411
+ | `@deepseek-ai/dsh-mcp-resources` | `tools` | [`packages/mcp/mcp-resources/src/index.ts`](../packages/mcp/mcp-resources/src/index.ts) |
4412
+ | `@deepseek-ai/dsh-otel` | - | [`packages/telemetry/otel/src/index.ts`](../packages/telemetry/otel/src/index.ts) |
4413
+ | `@deepseek-ai/dsh-sandbox-ssh` | `ssh` | [`packages/ssh/sandbox-ssh/src/index.ts`](../packages/ssh/sandbox-ssh/src/index.ts) |
4414
+ | `@deepseek-ai/dsh-session` | - | [`packages/core/session/src/index.ts`](../packages/core/session/src/index.ts) |
4415
+ | `@deepseek-ai/dsh-session-checkpoint-policy` | `llm` · `sessionPersistence` · `sessions` · `tools` | [`packages/session/session-checkpoint-policy/src/index.ts`](../packages/session/session-checkpoint-policy/src/index.ts) |
4416
+ | `@deepseek-ai/dsh-session-projection` | - | [`packages/session/session-projection/src/index.ts`](../packages/session/session-projection/src/index.ts) |
4417
+ | `@deepseek-ai/dsh-session-stats` | `sessionProjections` | [`packages/session/session-stats/src/index.ts`](../packages/session/session-stats/src/index.ts) |
4418
+ | `@deepseek-ai/dsh-session-turn-outline` | `sessionProjections` | [`packages/session/session-turn-outline/src/index.ts`](../packages/session/session-turn-outline/src/index.ts) |
4419
+ | `@deepseek-ai/dsh-settings` | `configEditor` · `profileContext` | [`packages/settings/settings/src/index.ts`](../packages/settings/settings/src/index.ts) |
4420
+ | `@deepseek-ai/dsh-skill-badge` | `skills` | [`packages/skill/skill-badge/src/index.ts`](../packages/skill/skill-badge/src/index.ts) |
4421
+ | `@deepseek-ai/dsh-storage` | - | [`packages/storage/storage/src/index.ts`](../packages/storage/storage/src/index.ts) |
4422
+ | `@deepseek-ai/dsh-subprocess-local` | - | [`packages/subprocess/subprocess-local/src/index.ts`](../packages/subprocess/subprocess-local/src/index.ts) |
4423
+ | `@deepseek-ai/dsh-subprocess-ssh` | `ssh` | [`packages/ssh/subprocess-ssh/src/index.ts`](../packages/ssh/subprocess-ssh/src/index.ts) |
4424
+ | `@deepseek-ai/dsh-terminal` | - | [`packages/terminal/terminal/src/index.ts`](../packages/terminal/terminal/src/index.ts) |
4425
+ | `@deepseek-ai/dsh-tool-call-timeout-policy` | `tools` | [`packages/guard/timeout-policy/src/index.ts`](../packages/guard/timeout-policy/src/index.ts) |
4426
+ | `@deepseek-ai/dsh-tool-cordis` | `tools` · `cordisInspect` | [`packages/extensions/tool-cordis/src/index.ts`](../packages/extensions/tool-cordis/src/index.ts) |
4427
+ | `@deepseek-ai/dsh-tool-subagent-control` | `tools` · `subagents` | [`packages/subagent/tool-subagent-control/src/index.ts`](../packages/subagent/tool-subagent-control/src/index.ts) |
4428
+ | `@deepseek-ai/dsh-user-questions` | - | [`packages/interaction/user-questions/src/index.ts`](../packages/interaction/user-questions/src/index.ts) |
4429
+ | `@deepseek-ai/dsh-webhook` | `agents` · `agentDefaultModel` · `agentPresets` · `permissionPresets` · `sessionTitle` · `workspaceRegistry` | [`packages/webhook/webhook/src/index.ts`](../packages/webhook/webhook/src/index.ts) |
4430
+ | `@deepseek-ai/dsh-workspace` | `storageDomain` · `sessionPersistence` | [`packages/workspace/workspace/src/index.ts`](../packages/workspace/workspace/src/index.ts) |
4431
+ <!-- END GENERATED config-catalog:no-config -->
4432
+
4433
+ ## Seam packages (not directly loadable)
4434
+
4435
+ Abstract service classes - a deployment loads a concrete implementation package instead ([capability seams](../.agents/notes/implemented/architecture/2026-06-13-capability-seams.md)).
4436
+
4437
+ <!-- BEGIN GENERATED config-catalog:seam -->
4438
+ | `package` | `class` | `inject` | `source` |
4439
+ | --- | --- | --- | --- |
4440
+ | `@deepseek-ai/dsh-attachment` | `AttachmentStore` | - | [`packages/attachment/attachment/src/index.ts`](../packages/attachment/attachment/src/index.ts) |
4441
+ | `@deepseek-ai/dsh-compaction` | `CompactionEngine` | - | [`packages/compaction/compaction/src/index.ts`](../packages/compaction/compaction/src/index.ts) |
4442
+ | `@deepseek-ai/dsh-credentials` | `CredentialProvider` | - | [`packages/credentials/credentials/src/index.ts`](../packages/credentials/credentials/src/index.ts) |
4443
+ | `@deepseek-ai/dsh-deepseek-account` | `DeepSeekAccount` | - | [`packages/credentials/deepseek-account/src/index.ts`](../packages/credentials/deepseek-account/src/index.ts) |
4444
+ | `@deepseek-ai/dsh-file-reference` | `FileReferenceService` | - | [`packages/context/file-reference/src/index.ts`](../packages/context/file-reference/src/index.ts) |
4445
+ | `@deepseek-ai/dsh-fs` | `FileSystem` | - | [`packages/fs/fs/src/index.ts`](../packages/fs/fs/src/index.ts) |
4446
+ | `@deepseek-ai/dsh-host-directory-picker` | `DirectoryPicker` | - | [`packages/host/directory-picker/src/index.ts`](../packages/host/directory-picker/src/index.ts) |
4447
+ | `@deepseek-ai/dsh-jobs` | `JobRegistry` | - | [`packages/jobs/jobs/src/index.ts`](../packages/jobs/jobs/src/index.ts) |
4448
+ | `@deepseek-ai/dsh-ptc-runtime` | `PtcRuntime` | - | [`packages/ptc-runtime/ptc-runtime/src/index.ts`](../packages/ptc-runtime/ptc-runtime/src/index.ts) |
4449
+ | `@deepseek-ai/dsh-sandbox` | `SandboxProvider` | - | [`packages/sandbox/sandbox/src/index.ts`](../packages/sandbox/sandbox/src/index.ts) |
4450
+ | `@deepseek-ai/dsh-session-persistence` | `SessionPersistence` | - | [`packages/session/session-persistence/src/index.ts`](../packages/session/session-persistence/src/index.ts) |
4451
+ | `@deepseek-ai/dsh-session-query` | `SessionQueryEngine` | - | [`packages/session-query/session-query/src/index.ts`](../packages/session-query/session-query/src/index.ts) |
4452
+ | `@deepseek-ai/dsh-shell` | `ShellExecutor` | - | [`packages/shell/shell/src/index.ts`](../packages/shell/shell/src/index.ts) |
4453
+ | `@deepseek-ai/dsh-spill` | `SpillStore` | - | [`packages/spill/spill/src/index.ts`](../packages/spill/spill/src/index.ts) |
4454
+ | `@deepseek-ai/dsh-subprocess` | `SubprocessRuntime` | - | [`packages/subprocess/subprocess/src/index.ts`](../packages/subprocess/subprocess/src/index.ts) |
4455
+ | `@deepseek-ai/dsh-workflow` | `WorkflowEngine` | - | [`packages/workflow/workflow/src/index.ts`](../packages/workflow/workflow/src/index.ts) |
4456
+ <!-- END GENERATED config-catalog:seam -->
4457
+
4458
+ ## Library packages (no plugin entry)
4459
+
4460
+ Imported as libraries by other packages; a `cordis.yml` cannot load them.
4461
+
4462
+ <!-- BEGIN GENERATED config-catalog:library -->
4463
+ | `package` | `inject` | `source` |
4464
+ | --- | --- | --- |
4465
+ | `@deepseek-ai/dsh-agent-loop-testkit` | - | [`packages/test-support/agent-loop-testkit/src/index.ts`](../packages/test-support/agent-loop-testkit/src/index.ts) |
4466
+ | `@deepseek-ai/dsh-anonymous-user-id` | - | [`packages/identity/anonymous-user-id/src/index.ts`](../packages/identity/anonymous-user-id/src/index.ts) |
4467
+ | `@deepseek-ai/dsh-app-boot` | - | [`packages/boot/app-boot/src/index.ts`](../packages/boot/app-boot/src/index.ts) |
4468
+ | `@deepseek-ai/dsh-atomic-write` | - | [`packages/util/atomic-write/src/index.ts`](../packages/util/atomic-write/src/index.ts) |
4469
+ | `@deepseek-ai/dsh-base` | - | [`packages/bundle/base/src/index.ts`](../packages/bundle/base/src/index.ts) |
4470
+ | `@deepseek-ai/dsh-brand` | - | [`packages/util/brand/src/index.ts`](../packages/util/brand/src/index.ts) |
4471
+ | `@deepseek-ai/dsh-chunked-list` | - | [`packages/util/chunked-list/src/index.ts`](../packages/util/chunked-list/src/index.ts) |
4472
+ | `@deepseek-ai/dsh-client-store` | - | [`packages/client/store/src/index.ts`](../packages/client/store/src/index.ts) |
4473
+ | `@deepseek-ai/dsh-client-test-runtime` | - | [`packages/test-support/client-runtime/src/index.ts`](../packages/test-support/client-runtime/src/index.ts) |
4474
+ | `@deepseek-ai/dsh-client-ui-dockkit` | - | [`packages/client/ui-dockkit/src/index.ts`](../packages/client/ui-dockkit/src/index.ts) |
4475
+ | `@deepseek-ai/dsh-client-ui-primitives` | - | [`packages/client/ui-primitives/src/index.ts`](../packages/client/ui-primitives/src/index.ts) |
4476
+ | `@deepseek-ai/dsh-client-ui-slots` | - | [`packages/client/ui-slots/src/index.ts`](../packages/client/ui-slots/src/index.ts) |
4477
+ | `@deepseek-ai/dsh-client-web` | - | [`packages/client/web/src/index.ts`](../packages/client/web/src/index.ts) |
4478
+ | `@deepseek-ai/dsh-cmdline` | - | [`packages/boot/cmdline/src/index.ts`](../packages/boot/cmdline/src/index.ts) |
4479
+ | `@deepseek-ai/dsh-deque` | - | [`packages/util/deque/src/index.ts`](../packages/util/deque/src/index.ts) |
4480
+ | `@deepseek-ai/dsh-experimental-agent-team-profile` | - | [`packages/experimental/agent-team-profile/src/index.ts`](../packages/experimental/agent-team-profile/src/index.ts) |
4481
+ | `@deepseek-ai/dsh-experimental-browser-use-runtime` | - | [`packages/experimental/browser-use-runtime/src/index.ts`](../packages/experimental/browser-use-runtime/src/index.ts) |
4482
+ | `@deepseek-ai/dsh-experimental-schedule-bundle` | - | [`packages/experimental/schedule-bundle/src/index.ts`](../packages/experimental/schedule-bundle/src/index.ts) |
4483
+ | `@deepseek-ai/dsh-experimental-voice-input-bundle` | - | [`packages/experimental/voice-input-bundle/src/index.ts`](../packages/experimental/voice-input-bundle/src/index.ts) |
4484
+ | `@deepseek-ai/dsh-experimental-webworker-packer` | - | [`packages/experimental/webworker-packer/src/index.ts`](../packages/experimental/webworker-packer/src/index.ts) |
4485
+ | `@deepseek-ai/dsh-experimental-webworker-runtime` | - | [`packages/experimental/webworker-runtime/src/index.ts`](../packages/experimental/webworker-runtime/src/index.ts) |
4486
+ | `@deepseek-ai/dsh-home-paths` | - | [`packages/util/home-paths/src/index.ts`](../packages/util/home-paths/src/index.ts) |
4487
+ | `@deepseek-ai/dsh-hook-protocol` | - | [`packages/hooks/hook-protocol/src/index.ts`](../packages/hooks/hook-protocol/src/index.ts) |
4488
+ | `@deepseek-ai/dsh-http-proxy` | - | [`packages/util/http-proxy/src/index.ts`](../packages/util/http-proxy/src/index.ts) |
4489
+ | `@deepseek-ai/dsh-launch-environment` | - | [`packages/util/launch-environment/src/index.ts`](../packages/util/launch-environment/src/index.ts) |
4490
+ | `@deepseek-ai/dsh-lazy-require` | - | [`packages/util/lazy-require/src/index.ts`](../packages/util/lazy-require/src/index.ts) |
4491
+ | `@deepseek-ai/dsh-llm-deepseek` | - | [`packages/llm/llm-deepseek/src/index.ts`](../packages/llm/llm-deepseek/src/index.ts) |
4492
+ | `@deepseek-ai/dsh-llm-mock-server` | - | [`packages/test-support/llm-mock-server/src/index.ts`](../packages/test-support/llm-mock-server/src/index.ts) |
4493
+ | `@deepseek-ai/dsh-loader-smoke` | - | [`packages/test-support/loader-smoke/src/index.ts`](../packages/test-support/loader-smoke/src/index.ts) |
4494
+ | `@deepseek-ai/dsh-native-command` | - | [`packages/util/native-command/src/index.ts`](../packages/util/native-command/src/index.ts) |
4495
+ | `@deepseek-ai/dsh-output-retention` | - | [`packages/util/output-retention/src/index.ts`](../packages/util/output-retention/src/index.ts) |
4496
+ | `@deepseek-ai/dsh-package-manifest` | - | [`packages/util/package-manifest/src/index.ts`](../packages/util/package-manifest/src/index.ts) |
4497
+ | `@deepseek-ai/dsh-remote-mock` | - | [`packages/test-support/remote-mock/src/index.ts`](../packages/test-support/remote-mock/src/index.ts) |
4498
+ | `@deepseek-ai/dsh-sandbox-windows-acl` | - | [`packages/sandbox/sandbox-windows-acl/src/index.ts`](../packages/sandbox/sandbox-windows-acl/src/index.ts) |
4499
+ | `@deepseek-ai/dsh-scope` | - | [`packages/core/scope/src/index.ts`](../packages/core/scope/src/index.ts) |
4500
+ | `@deepseek-ai/dsh-sdk-client` | - | [`packages/sdk/client/src/index.ts`](../packages/sdk/client/src/index.ts) |
4501
+ | `@deepseek-ai/dsh-sdk-minimal` | - | [`packages/bundle/sdk-minimal/src/index.ts`](../packages/bundle/sdk-minimal/src/index.ts) |
4502
+ | `@deepseek-ai/dsh-sdk-protocol` | - | [`packages/sdk/protocol/src/index.ts`](../packages/sdk/protocol/src/index.ts) |
4503
+ | `@deepseek-ai/dsh-session-format` | - | [`packages/session/session-format/src/index.ts`](../packages/session/session-format/src/index.ts) |
4504
+ | `@deepseek-ai/dsh-session-format-catalog` | - | [`packages/session/session-format-catalog/src/index.ts`](../packages/session/session-format-catalog/src/index.ts) |
4505
+ | `@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) |
4506
+ | `@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) |
4507
+ | `@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) |
4508
+ | `@deepseek-ai/dsh-session-format-v3-to-v4` | - | [`packages/session/session-format-v3-to-v4/src/index.ts`](../packages/session/session-format-v3-to-v4/src/index.ts) |
4509
+ | `@deepseek-ai/dsh-session-snapshot` | - | [`packages/test-support/session-snapshot/src/index.ts`](../packages/test-support/session-snapshot/src/index.ts) |
4510
+ | `@deepseek-ai/dsh-session-telemetry` | - | [`packages/session/session-telemetry/src/index.ts`](../packages/session/session-telemetry/src/index.ts) |
4511
+ | `@deepseek-ai/dsh-session-title-llm` | - | [`packages/session/session-title-llm/src/index.ts`](../packages/session/session-title-llm/src/index.ts) |
4512
+ | `@deepseek-ai/dsh-subagent-in-process-driver` | - | [`packages/subagent/subagent-in-process-driver/src/index.ts`](../packages/subagent/subagent-in-process-driver/src/index.ts) |
4513
+ | `@deepseek-ai/dsh-timeout` | - | [`packages/util/timeout/src/index.ts`](../packages/util/timeout/src/index.ts) |
4514
+ | `@deepseek-ai/dsh-typert-generator` | - | [`packages/typert/generator/src/index.ts`](../packages/typert/generator/src/index.ts) |
4515
+ | `@deepseek-ai/dsh-typert-protocol` | - | [`packages/typert/protocol/src/index.ts`](../packages/typert/protocol/src/index.ts) |
4516
+ | `@deepseek-ai/dsh-typert-registry` | - | [`packages/typert/registry/src/index.ts`](../packages/typert/registry/src/index.ts) |
4517
+ | `@deepseek-ai/dsh-util-code-language` | - | [`packages/util/code-language/src/index.ts`](../packages/util/code-language/src/index.ts) |
4518
+ | `@deepseek-ai/dsh-util-crypto` | - | [`packages/util/crypto/src/index.ts`](../packages/util/crypto/src/index.ts) |
4519
+ | `@deepseek-ai/dsh-util-time` | - | [`packages/util/time/src/index.ts`](../packages/util/time/src/index.ts) |
4520
+ | `@deepseek-ai/dsh-util-values` | - | [`packages/util/values/src/index.ts`](../packages/util/values/src/index.ts) |
4521
+ | `@deepseek-ai/dsh-util-workspace-path` | - | [`packages/util/workspace-path/src/index.ts`](../packages/util/workspace-path/src/index.ts) |
4522
+ | `@deepseek-ai/dsh-win32-process` | - | [`packages/subprocess/win32-process/src/index.ts`](../packages/subprocess/win32-process/src/index.ts) |
4523
+ <!-- END GENERATED config-catalog:library -->