@acryldev/plugin-context 0.0.0-stage → 0.1.0

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/docs/README.md +160 -0
  3. package/docs/delivery/local-live.md +113 -0
  4. package/docs/delivery/marketplace.md +16 -0
  5. package/docs/docs.json +2836 -0
  6. package/docs/extending/agent-preset.md +37 -0
  7. package/docs/extending/chat-command.md +28 -0
  8. package/docs/extending/client-slot.md +135 -0
  9. package/docs/extending/config-schema.md +7 -0
  10. package/docs/extending/cordis-core.md +63 -0
  11. package/docs/extending/desktop-app.md +53 -0
  12. package/docs/extending/desktop-main.md +25 -0
  13. package/docs/extending/event-hook.md +14 -0
  14. package/docs/extending/host-route.md +33 -0
  15. package/docs/extending/llm-adapter.md +38 -0
  16. package/docs/extending/packaging.md +53 -0
  17. package/docs/extending/prompt-contribution.md +9 -0
  18. package/docs/extending/service.md +13 -0
  19. package/docs/extending/skill-provider.md +9 -0
  20. package/docs/extending/state-and-persistence.md +71 -0
  21. package/docs/extending/three-role-capability.md +33 -0
  22. package/docs/extending/tool-plugin.md +24 -0
  23. package/docs/extending/tui-command.md +8 -0
  24. package/docs/extending/tui-components.md +61 -0
  25. package/docs/extending/ui-branding.md +43 -0
  26. package/docs/extending/ui-components.md +56 -0
  27. package/docs/extending/ui-customization.md +41 -0
  28. package/docs/extending/ui-library.md +66 -0
  29. package/docs/extending/ui-theme.md +55 -0
  30. package/docs/extending/workspace-tab.md +50 -0
  31. package/docs/maps/events.md +108 -0
  32. package/docs/maps/mount-points.md +154 -0
  33. package/docs/maps/slot-contracts.md +3376 -0
  34. package/docs/maps/taxonomy.md +306 -0
  35. package/docs/maps/theme-tokens.md +115 -0
  36. package/docs/maps/ui-components.md +26 -0
  37. package/docs/reference/cookbook/adding-a-package.md +174 -0
  38. package/docs/reference/cookbook/adding-a-remote-api.md +199 -0
  39. package/docs/reference/cookbook/adding-a-settings-card.md +74 -0
  40. package/docs/reference/cookbook/adding-a-tool.md +103 -0
  41. package/docs/reference/cookbook/adding-an-llm-adapter.md +45 -0
  42. package/docs/reference/cookbook/extension-cookbook.md +134 -0
  43. package/docs/reference/cordis-api/context.md +366 -0
  44. package/docs/reference/cordis-api/events.md +209 -0
  45. package/docs/reference/cordis-api/fiber.md +377 -0
  46. package/docs/reference/cordis-api/inherited.md +40 -0
  47. package/docs/reference/cordis-api/registry.md +154 -0
  48. package/docs/reference/cordis-api/service.md +104 -0
  49. package/docs/reference/cordis-guides/cordis-usage-cheatsheet.md +167 -0
  50. package/docs/reference/cordis-guides/cordis_system_guide_for_coding_agents.md +4666 -0
  51. package/docs/reference/cordis-guides/development-canvas-plugin.md +109 -0
  52. package/docs/reference/cordis-guides/hello-world-plugin-guide.md +517 -0
  53. package/docs/reference/harness/agent-lifecycle.md +93 -0
  54. package/docs/reference/harness/architecture.md +168 -0
  55. package/docs/reference/harness/capability-seams.md +675 -0
  56. package/docs/reference/harness/config-catalog.md +4523 -0
  57. package/docs/reference/harness/cordis-primer.md +47 -0
  58. package/docs/reference/harness/defensive-patterns.md +35 -0
  59. package/docs/reference/harness/event-producer-consumer.md +111 -0
  60. package/docs/reference/harness/glossary.md +47 -0
  61. package/docs/reference/harness/tool-catalog.md +2721 -0
  62. package/docs/reference/harness/tool-execution-pipeline.md +67 -0
  63. package/docs/reference/subsystems/README.md +75 -0
  64. package/docs/reference/subsystems/agent-team.md +233 -0
  65. package/docs/reference/subsystems/approval.md +172 -0
  66. package/docs/reference/subsystems/attachment.md +363 -0
  67. package/docs/reference/subsystems/boot.md +324 -0
  68. package/docs/reference/subsystems/browser-use.md +69 -0
  69. package/docs/reference/subsystems/client-modules.md +186 -0
  70. package/docs/reference/subsystems/client-resources.md +94 -0
  71. package/docs/reference/subsystems/commands.md +225 -0
  72. package/docs/reference/subsystems/compaction.md +286 -0
  73. package/docs/reference/subsystems/computer-use.md +58 -0
  74. package/docs/reference/subsystems/conversation.md +287 -0
  75. package/docs/reference/subsystems/core.md +1107 -0
  76. package/docs/reference/subsystems/credentials.md +497 -0
  77. package/docs/reference/subsystems/deliverables.md +180 -0
  78. package/docs/reference/subsystems/extensions.md +386 -0
  79. package/docs/reference/subsystems/feedback.md +402 -0
  80. package/docs/reference/subsystems/filesystem.md +532 -0
  81. package/docs/reference/subsystems/goal.md +315 -0
  82. package/docs/reference/subsystems/invariants.md +90 -0
  83. package/docs/reference/subsystems/jobs.md +501 -0
  84. package/docs/reference/subsystems/llm-streaming.md +1131 -0
  85. package/docs/reference/subsystems/lsp.md +204 -0
  86. package/docs/reference/subsystems/mcp.md +141 -0
  87. package/docs/reference/subsystems/office-to-pdf.md +89 -0
  88. package/docs/reference/subsystems/otel.md +46 -0
  89. package/docs/reference/subsystems/permission-presets.md +169 -0
  90. package/docs/reference/subsystems/persistence.md +418 -0
  91. package/docs/reference/subsystems/plan.md +89 -0
  92. package/docs/reference/subsystems/product-telemetry.md +81 -0
  93. package/docs/reference/subsystems/ptc-runtime.md +234 -0
  94. package/docs/reference/subsystems/sandbox.md +223 -0
  95. package/docs/reference/subsystems/schedule.md +545 -0
  96. package/docs/reference/subsystems/scope.md +61 -0
  97. package/docs/reference/subsystems/session-projection.md +358 -0
  98. package/docs/reference/subsystems/session-query.md +511 -0
  99. package/docs/reference/subsystems/session-reference.md +226 -0
  100. package/docs/reference/subsystems/session-telemetry.md +214 -0
  101. package/docs/reference/subsystems/session-title.md +206 -0
  102. package/docs/reference/subsystems/session.md +1300 -0
  103. package/docs/reference/subsystems/settings.md +157 -0
  104. package/docs/reference/subsystems/shell.md +316 -0
  105. package/docs/reference/subsystems/sidebar-right.md +160 -0
  106. package/docs/reference/subsystems/skills.md +354 -0
  107. package/docs/reference/subsystems/slots.md +201 -0
  108. package/docs/reference/subsystems/spill.md +126 -0
  109. package/docs/reference/subsystems/ssh.md +137 -0
  110. package/docs/reference/subsystems/storage.md +262 -0
  111. package/docs/reference/subsystems/subagent.md +762 -0
  112. package/docs/reference/subsystems/subprocess.md +323 -0
  113. package/docs/reference/subsystems/system-prompt.md +226 -0
  114. package/docs/reference/subsystems/terminal.md +186 -0
  115. package/docs/reference/subsystems/todo.md +34 -0
  116. package/docs/reference/subsystems/token-meter.md +108 -0
  117. package/docs/reference/subsystems/tools.md +749 -0
  118. package/docs/reference/subsystems/typert.md +489 -0
  119. package/docs/reference/subsystems/user-questions.md +309 -0
  120. package/docs/reference/subsystems/voice-input.md +166 -0
  121. package/docs/reference/subsystems/web-client.md +102 -0
  122. package/docs/reference/subsystems/web-server.md +228 -0
  123. package/docs/reference/subsystems/web.md +208 -0
  124. package/docs/reference/subsystems/webhook.md +72 -0
  125. package/docs/reference/subsystems/workflow.md +280 -0
  126. package/docs/reference/subsystems/workspace.md +661 -0
  127. package/docs/start-here/blueprints.md +33 -0
  128. package/docs/start-here/this-runtime.md +84 -0
  129. package/docs/start-here/troubleshooting.md +29 -0
  130. package/docs/start-here/trust-and-safety.md +39 -0
  131. package/docs/start-here/verify-before-done.md +46 -0
  132. package/example-plugins/README.md +45 -0
  133. package/example-plugins/packages/agent-preset-reviewer/agent.cordis.yml +18 -0
  134. package/example-plugins/packages/agent-preset-reviewer/preset.yml +3 -0
  135. package/example-plugins/packages/capability-swap-consumer/cordis.patch.yml +3 -0
  136. package/example-plugins/packages/capability-swap-consumer/index.js +14 -0
  137. package/example-plugins/packages/capability-swap-consumer/package.json +25 -0
  138. package/example-plugins/packages/capability-swap-provider-loud/cordis.patch.yml +3 -0
  139. package/example-plugins/packages/capability-swap-provider-loud/index.js +20 -0
  140. package/example-plugins/packages/capability-swap-provider-loud/package.json +25 -0
  141. package/example-plugins/packages/capability-swap-provider-quiet/cordis.patch.yml +3 -0
  142. package/example-plugins/packages/capability-swap-provider-quiet/index.js +20 -0
  143. package/example-plugins/packages/capability-swap-provider-quiet/package.json +25 -0
  144. package/example-plugins/packages/chat-command-basic/cordis.patch.yml +3 -0
  145. package/example-plugins/packages/chat-command-basic/index.js +26 -0
  146. package/example-plugins/packages/chat-command-basic/package.json +25 -0
  147. package/example-plugins/packages/client-chat-message-action/client.js +46 -0
  148. package/example-plugins/packages/client-chat-message-action/cordis.patch.yml +3 -0
  149. package/example-plugins/packages/client-chat-message-action/index.js +9 -0
  150. package/example-plugins/packages/client-chat-message-action/package.json +31 -0
  151. package/example-plugins/packages/client-slot-header-action/client.js +57 -0
  152. package/example-plugins/packages/client-slot-header-action/cordis.patch.yml +3 -0
  153. package/example-plugins/packages/client-slot-header-action/index.js +13 -0
  154. package/example-plugins/packages/client-slot-header-action/package.json +31 -0
  155. package/example-plugins/packages/client-slot-sidebar-tab/client.js +57 -0
  156. package/example-plugins/packages/client-slot-sidebar-tab/cordis.patch.yml +3 -0
  157. package/example-plugins/packages/client-slot-sidebar-tab/index.js +9 -0
  158. package/example-plugins/packages/client-slot-sidebar-tab/package.json +32 -0
  159. package/example-plugins/packages/client-theme-override/client.js +52 -0
  160. package/example-plugins/packages/client-theme-override/cordis.patch.yml +3 -0
  161. package/example-plugins/packages/client-theme-override/index.js +9 -0
  162. package/example-plugins/packages/client-theme-override/package.json +30 -0
  163. package/example-plugins/packages/client-tool-view/client.js +47 -0
  164. package/example-plugins/packages/client-tool-view/cordis.patch.yml +3 -0
  165. package/example-plugins/packages/client-tool-view/index.js +24 -0
  166. package/example-plugins/packages/client-tool-view/package.json +34 -0
  167. package/example-plugins/packages/client-ui-components/client.js +77 -0
  168. package/example-plugins/packages/client-ui-components/cordis.patch.yml +3 -0
  169. package/example-plugins/packages/client-ui-components/index.js +9 -0
  170. package/example-plugins/packages/client-ui-components/package.json +31 -0
  171. package/example-plugins/packages/client-ui-library/client.js +715 -0
  172. package/example-plugins/packages/client-ui-library/cordis.patch.yml +3 -0
  173. package/example-plugins/packages/client-ui-library/index.js +9 -0
  174. package/example-plugins/packages/client-ui-library/package.json +37 -0
  175. package/example-plugins/packages/client-workspace-tab/client.js +72 -0
  176. package/example-plugins/packages/client-workspace-tab/cordis.patch.yml +3 -0
  177. package/example-plugins/packages/client-workspace-tab/index.js +9 -0
  178. package/example-plugins/packages/client-workspace-tab/package.json +30 -0
  179. package/example-plugins/packages/config-schema-basic/cordis.patch.yml +3 -0
  180. package/example-plugins/packages/config-schema-basic/index.js +19 -0
  181. package/example-plugins/packages/config-schema-basic/package.json +25 -0
  182. package/example-plugins/packages/desktop-main-profile-info/cordis.patch.yml +3 -0
  183. package/example-plugins/packages/desktop-main-profile-info/index.js +22 -0
  184. package/example-plugins/packages/desktop-main-profile-info/package.json +25 -0
  185. package/example-plugins/packages/event-hook-basic/cordis.patch.yml +3 -0
  186. package/example-plugins/packages/event-hook-basic/index.js +17 -0
  187. package/example-plugins/packages/event-hook-basic/package.json +22 -0
  188. package/example-plugins/packages/generated-capability-template/cordis.patch.yml +3 -0
  189. package/example-plugins/packages/generated-capability-template/index.js +16 -0
  190. package/example-plugins/packages/generated-capability-template/package.json +42 -0
  191. package/example-plugins/packages/host-route-basic/cordis.patch.yml +3 -0
  192. package/example-plugins/packages/host-route-basic/index.js +20 -0
  193. package/example-plugins/packages/host-route-basic/package.json +29 -0
  194. package/example-plugins/packages/lifecycle-function-basic/cordis.patch.yml +3 -0
  195. package/example-plugins/packages/lifecycle-function-basic/index.js +12 -0
  196. package/example-plugins/packages/lifecycle-function-basic/package.json +15 -0
  197. package/example-plugins/packages/lifecycle-function-hot-shim/cordis.patch.yml +3 -0
  198. package/example-plugins/packages/lifecycle-function-hot-shim/impl.js +5 -0
  199. package/example-plugins/packages/lifecycle-function-hot-shim/index.js +18 -0
  200. package/example-plugins/packages/lifecycle-function-hot-shim/package.json +23 -0
  201. package/example-plugins/packages/lifecycle-hooks-observer/cordis.patch.yml +3 -0
  202. package/example-plugins/packages/lifecycle-hooks-observer/index.js +23 -0
  203. package/example-plugins/packages/lifecycle-hooks-observer/package.json +22 -0
  204. package/example-plugins/packages/llm-adapter-echo/cordis.patch.yml +3 -0
  205. package/example-plugins/packages/llm-adapter-echo/index.js +42 -0
  206. package/example-plugins/packages/llm-adapter-echo/package.json +25 -0
  207. package/example-plugins/packages/prompt-assemble-hook/cordis.patch.yml +3 -0
  208. package/example-plugins/packages/prompt-assemble-hook/index.js +22 -0
  209. package/example-plugins/packages/prompt-assemble-hook/package.json +22 -0
  210. package/example-plugins/packages/prompt-contribution-basic/cordis.patch.yml +3 -0
  211. package/example-plugins/packages/prompt-contribution-basic/index.js +18 -0
  212. package/example-plugins/packages/prompt-contribution-basic/package.json +22 -0
  213. package/example-plugins/packages/service-consumer-greeter/cordis.patch.yml +3 -0
  214. package/example-plugins/packages/service-consumer-greeter/index.js +14 -0
  215. package/example-plugins/packages/service-consumer-greeter/package.json +22 -0
  216. package/example-plugins/packages/service-provider-greeter/cordis.patch.yml +3 -0
  217. package/example-plugins/packages/service-provider-greeter/index.js +22 -0
  218. package/example-plugins/packages/service-provider-greeter/package.json +25 -0
  219. package/example-plugins/packages/settings-section-basic/cordis.patch.yml +3 -0
  220. package/example-plugins/packages/settings-section-basic/index.js +34 -0
  221. package/example-plugins/packages/settings-section-basic/package.json +26 -0
  222. package/example-plugins/packages/skill-provider-basic/cordis.patch.yml +3 -0
  223. package/example-plugins/packages/skill-provider-basic/index.js +31 -0
  224. package/example-plugins/packages/skill-provider-basic/package.json +22 -0
  225. package/example-plugins/packages/state-host-store/client.js +57 -0
  226. package/example-plugins/packages/state-host-store/cordis.patch.yml +3 -0
  227. package/example-plugins/packages/state-host-store/index.js +90 -0
  228. package/example-plugins/packages/state-host-store/package.json +31 -0
  229. package/example-plugins/packages/state-workspace-file/cordis.patch.yml +3 -0
  230. package/example-plugins/packages/state-workspace-file/index.js +52 -0
  231. package/example-plugins/packages/state-workspace-file/package.json +25 -0
  232. package/example-plugins/packages/tool-basic/cordis.patch.yml +3 -0
  233. package/example-plugins/packages/tool-basic/index.js +25 -0
  234. package/example-plugins/packages/tool-basic/package.json +25 -0
  235. package/example-plugins/packages/tool-policy-hook/cordis.patch.yml +3 -0
  236. package/example-plugins/packages/tool-policy-hook/index.js +28 -0
  237. package/example-plugins/packages/tool-policy-hook/package.json +25 -0
  238. package/example-plugins/packages/tui-command-basic/cordis.patch.yml +3 -0
  239. package/example-plugins/packages/tui-command-basic/index.js +24 -0
  240. package/example-plugins/packages/tui-command-basic/package.json +22 -0
  241. package/example-plugins/packages/tui-overlay-themed/cordis.patch.yml +3 -0
  242. package/example-plugins/packages/tui-overlay-themed/index.js +65 -0
  243. package/example-plugins/packages/tui-overlay-themed/package.json +25 -0
  244. package/example-plugins/packages/tui-ui-library/cordis.patch.yml +3 -0
  245. package/example-plugins/packages/tui-ui-library/index.js +73 -0
  246. package/example-plugins/packages/tui-ui-library/package.json +29 -0
  247. package/example-plugins/packages/web-page-branding/cordis.patch.yml +3 -0
  248. package/example-plugins/packages/web-page-branding/index.js +31 -0
  249. package/example-plugins/packages/web-page-branding/package.json +22 -0
  250. package/example-plugins/scenarios.json +11 -0
  251. package/index.js +384 -0
  252. package/lib/blend-apply.js +107 -0
  253. package/lib/blend-capture.js +249 -0
  254. package/lib/blend-ledger.js +76 -0
  255. package/lib/contract.js +5 -0
  256. package/lib/install.js +516 -0
  257. package/lib/lookup.js +67 -0
  258. package/lib/manifest.js +56 -0
  259. package/lib/pack-root.js +22 -0
  260. package/lib/provenance.js +110 -0
  261. package/lib/publish.js +64 -0
  262. package/lib/reconcile.js +83 -0
  263. package/lib/router.js +55 -0
  264. package/lib/scopes.js +82 -0
  265. package/lib/skills.js +54 -0
  266. package/lib/stage.js +157 -0
  267. package/lib/verify.js +77 -0
  268. package/package.json +56 -3
  269. package/scripts/lib/indexes.mjs +45 -0
  270. package/scripts/lib/manifest.mjs +127 -0
  271. package/scripts/lib/maps.mjs +482 -0
  272. package/skills/acryl-add-provider-or-capability/SKILL.md +12 -0
  273. package/skills/acryl-add-ui/SKILL.md +18 -0
  274. package/skills/acryl-build-plugin/SKILL.md +21 -0
  275. package/skills/acryl-change-plugin/SKILL.md +16 -0
  276. package/skills/acryl-desktop-shell/SKILL.md +12 -0
  277. package/skills/acryl-diagnose-plugin/SKILL.md +10 -0
  278. package/skills/acryl-fix-plugin/SKILL.md +12 -0
  279. package/skills/acryl-improve-ui/SKILL.md +10 -0
  280. package/skills/acryl-remove-plugin/SKILL.md +11 -0
  281. package/skills/acryl-restyle-ui/SKILL.md +14 -0
  282. package/skills/acryl-share-plugin/SKILL.md +23 -0
  283. package/skills/acryl-tui-ui/SKILL.md +12 -0
  284. package/README.md +0 -3
package/docs/docs.json ADDED
@@ -0,0 +1,2836 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "packVersion": "0.11.0",
4
+ "navigation": [
5
+ {
6
+ "title": "Start here",
7
+ "items": [
8
+ {
9
+ "id": "start.this-runtime",
10
+ "title": "This runtime: how ACRYL plugins are built, loaded and delivered",
11
+ "path": "start-here/this-runtime.md",
12
+ "when": "Always first: the layers, the plugin and package contracts, and the two delivery paths.",
13
+ "surfaces": [
14
+ "tui",
15
+ "web",
16
+ "desktop"
17
+ ],
18
+ "applies": "all",
19
+ "examples": [
20
+ "lifecycle-function.basic"
21
+ ],
22
+ "topic": "how plugins are built and delivered"
23
+ },
24
+ {
25
+ "id": "start.blueprints",
26
+ "title": "Blueprints, Blends and the blank canvas",
27
+ "path": "start-here/blueprints.md",
28
+ "when": "When the instance may be the blank canvas, when the user wants the product branded as their own, or when capturing what was grown as a Blend.",
29
+ "surfaces": [
30
+ "tui",
31
+ "web",
32
+ "desktop"
33
+ ],
34
+ "applies": "all",
35
+ "seeAlso": [
36
+ "start.this-runtime",
37
+ "extending.ui-branding"
38
+ ],
39
+ "topic": "the blank canvas and branding"
40
+ },
41
+ {
42
+ "id": "start.verify-before-done",
43
+ "title": "Verify before you say it works",
44
+ "path": "start-here/verify-before-done.md",
45
+ "when": "Before claiming a plugin works, stating a live fiber state, or delivering a package.",
46
+ "surfaces": [
47
+ "tui",
48
+ "web",
49
+ "desktop"
50
+ ],
51
+ "applies": "all",
52
+ "seeAlso": [
53
+ "start.this-runtime"
54
+ ],
55
+ "topic": "verifying before claiming done"
56
+ },
57
+ {
58
+ "id": "start.troubleshooting",
59
+ "title": "Troubleshooting",
60
+ "path": "start-here/troubleshooting.md",
61
+ "when": "A plugin is PENDING, FAILED, invisible or running stale code: symptom table and where to look.",
62
+ "surfaces": [
63
+ "tui",
64
+ "web",
65
+ "desktop"
66
+ ],
67
+ "applies": "all",
68
+ "seeAlso": [
69
+ "start.verify-before-done",
70
+ "delivery.local-live"
71
+ ],
72
+ "topic": "a plugin that is PENDING, FAILED, invisible or stale"
73
+ },
74
+ {
75
+ "id": "start.trust-and-safety",
76
+ "title": "Trust and safety: plugins run with the user's permissions",
77
+ "path": "start-here/trust-and-safety.md",
78
+ "when": "Before writing or installing any plugin: what it can do, the rules for the agent, and what ACRYL does and does not protect.",
79
+ "surfaces": [
80
+ "tui",
81
+ "web",
82
+ "desktop"
83
+ ],
84
+ "applies": "all",
85
+ "seeAlso": [
86
+ "start.this-runtime",
87
+ "delivery.local-live"
88
+ ]
89
+ }
90
+ ]
91
+ },
92
+ {
93
+ "title": "Extending ACRYL (by plugin type)",
94
+ "items": [
95
+ {
96
+ "id": "extending.ui-customization",
97
+ "title": "Changing how ACRYL looks: what, where, how live (all surfaces)",
98
+ "path": "extending/ui-customization.md",
99
+ "when": "ANY request about colors, fonts, branding, logo, layout, look and feel or restyling: what each surface allows and what needs a rebuild.",
100
+ "surfaces": [
101
+ "tui",
102
+ "web",
103
+ "desktop"
104
+ ],
105
+ "applies": "all",
106
+ "seeAlso": [
107
+ "extending.ui-theme",
108
+ "extending.ui-branding",
109
+ "extending.desktop-app",
110
+ "extending.tui-components",
111
+ "maps.mount-points"
112
+ ],
113
+ "topic": "colors, fonts, branding, look and feel, any UI change"
114
+ },
115
+ {
116
+ "id": "extending.ui-components",
117
+ "title": "Ready-made UI components: build with the app's own library",
118
+ "path": "extending/ui-components.md",
119
+ "when": "Before building ANY UI: the themed component library you can require today (Button, Modal, Input, Switch, Tag, ...) and the terminal equivalents.",
120
+ "surfaces": [
121
+ "tui",
122
+ "web",
123
+ "desktop"
124
+ ],
125
+ "applies": "all",
126
+ "seeAlso": [
127
+ "extending.client-slot",
128
+ "extending.ui-theme",
129
+ "maps.ui-components"
130
+ ],
131
+ "examples": [
132
+ "ui-components.shared-primitives"
133
+ ],
134
+ "topic": "building UI from the shared components"
135
+ },
136
+ {
137
+ "id": "extending.ui-library",
138
+ "title": "ACRYL UI library: build screens from ready components",
139
+ "path": "extending/ui-library.md",
140
+ "when": "Any Web or Desktop UI that has forms, settings, lists, dialogs or tabs: use @acryldev/ui instead of hand-styling; semantic color roles for your own colors.",
141
+ "surfaces": [
142
+ "web",
143
+ "desktop",
144
+ "tui"
145
+ ],
146
+ "applies": "all",
147
+ "seeAlso": [
148
+ "extending.ui-components",
149
+ "extending.client-slot",
150
+ "extending.ui-theme"
151
+ ],
152
+ "examples": [
153
+ "ui-library.gallery",
154
+ "ui-library.tui-gallery"
155
+ ],
156
+ "topic": "screens, forms, settings, dialogs, tabs"
157
+ },
158
+ {
159
+ "id": "extending.cordis-core",
160
+ "title": "Cordis building blocks and where each is documented",
161
+ "path": "extending/cordis-core.md",
162
+ "when": "You are unsure which Cordis or harness mechanism to use: the model in ten lines and a table from what you are building to its doc and reference.",
163
+ "surfaces": [
164
+ "tui",
165
+ "web",
166
+ "desktop"
167
+ ],
168
+ "applies": "all",
169
+ "seeAlso": [
170
+ "start.this-runtime"
171
+ ],
172
+ "topic": "which Cordis mechanism to use"
173
+ },
174
+ {
175
+ "id": "extending.client-slot",
176
+ "title": "Client slots: add UI to the Web and Desktop app (panel, button, tab, dashboard)",
177
+ "path": "extending/client-slot.md",
178
+ "when": "The plugin needs any UI in the app: a top-bar button, a panel, a sidebar tab, a board, a dashboard; also keyboard shortcuts and a custom card for a tool call.",
179
+ "surfaces": [
180
+ "web",
181
+ "desktop"
182
+ ],
183
+ "applies": "all",
184
+ "seeAlso": [
185
+ "start.this-runtime",
186
+ "delivery.local-live",
187
+ "extending.host-route",
188
+ "extending.ui-components",
189
+ "extending.state-and-persistence"
190
+ ],
191
+ "examples": [
192
+ "client-slot.header-action",
193
+ "client-slot.sidebar-tab",
194
+ "client-tool-view.custom-card",
195
+ "client-chat-message-action.bookmark"
196
+ ],
197
+ "topic": "a button, panel, tab or card (Web/Desktop)"
198
+ },
199
+ {
200
+ "id": "extending.workspace-tab",
201
+ "title": "Workspace tab types: add a new kind of tab (whiteboard, board, viewer)",
202
+ "path": "extending/workspace-tab.md",
203
+ "when": "The user wants a new kind of tab in the workspace (a whiteboard, a board of their own, a viewer): a plugin registers a tab type that appears in the + menu, the command palette and Settings > Tabs.",
204
+ "surfaces": [
205
+ "web",
206
+ "desktop"
207
+ ],
208
+ "applies": "all",
209
+ "seeAlso": [
210
+ "extending.client-slot",
211
+ "extending.state-and-persistence"
212
+ ],
213
+ "examples": [
214
+ "client-workspace-tab.whiteboard"
215
+ ],
216
+ "topic": "a new kind of workspace tab (Web/Desktop)"
217
+ },
218
+ {
219
+ "id": "extending.tool",
220
+ "title": "Tool plugins: give the agent a new capability",
221
+ "path": "extending/tool-plugin.md",
222
+ "when": "The feature is something the agent should be able to DO (call an API, read a source, run an action).",
223
+ "surfaces": [
224
+ "tui",
225
+ "web",
226
+ "desktop"
227
+ ],
228
+ "applies": "all",
229
+ "seeAlso": [
230
+ "start.this-runtime"
231
+ ],
232
+ "examples": [
233
+ "tool.basic"
234
+ ],
235
+ "topic": "a model-callable tool"
236
+ },
237
+ {
238
+ "id": "extending.service",
239
+ "title": "Services: provide a capability, consume it, optional dependencies",
240
+ "path": "extending/service.md",
241
+ "when": "Plugins must share a capability, or a plugin is PENDING on a missing service.",
242
+ "surfaces": [
243
+ "tui",
244
+ "web",
245
+ "desktop"
246
+ ],
247
+ "applies": "all",
248
+ "seeAlso": [
249
+ "start.this-runtime"
250
+ ],
251
+ "examples": [
252
+ "service.provider",
253
+ "service.consumer"
254
+ ],
255
+ "topic": "services and dependencies"
256
+ },
257
+ {
258
+ "id": "extending.event-hook",
259
+ "title": "Events: listen, emit, intercept (waterfall)",
260
+ "path": "extending/event-hook.md",
261
+ "when": "The feature reacts to, or intercepts, things that happen in the runtime.",
262
+ "surfaces": [
263
+ "tui",
264
+ "web",
265
+ "desktop"
266
+ ],
267
+ "applies": "all",
268
+ "examples": [
269
+ "event-hook.basic",
270
+ "prompt-assemble-hook.basic",
271
+ "lifecycle-hooks.observer",
272
+ "tool-policy-hook.deny"
273
+ ],
274
+ "topic": "events and interception",
275
+ "seeAlso": [
276
+ "maps.events"
277
+ ]
278
+ },
279
+ {
280
+ "id": "extending.config-schema",
281
+ "title": "Plugin configuration (Schemastery)",
282
+ "path": "extending/config-schema.md",
283
+ "when": "The plugin needs validated settings.",
284
+ "surfaces": [
285
+ "tui",
286
+ "web",
287
+ "desktop"
288
+ ],
289
+ "applies": "all",
290
+ "examples": [
291
+ "config-schema.basic",
292
+ "settings-section.basic"
293
+ ],
294
+ "topic": "configuration and settings"
295
+ },
296
+ {
297
+ "id": "extending.prompt-contribution",
298
+ "title": "Prompt contributions: add to the agent system prompt",
299
+ "path": "extending/prompt-contribution.md",
300
+ "when": "The feature changes what the agent is told or how it behaves.",
301
+ "surfaces": [
302
+ "tui",
303
+ "web",
304
+ "desktop"
305
+ ],
306
+ "applies": "all",
307
+ "examples": [
308
+ "prompt-contribution.basic"
309
+ ],
310
+ "topic": "system prompt sections"
311
+ },
312
+ {
313
+ "id": "extending.skill-provider",
314
+ "title": "Skills: on-demand instructions for the agent",
315
+ "path": "extending/skill-provider.md",
316
+ "when": "The feature is reusable instructions the agent loads only when needed.",
317
+ "surfaces": [
318
+ "tui",
319
+ "web",
320
+ "desktop"
321
+ ],
322
+ "applies": "all",
323
+ "examples": [
324
+ "skill-provider.basic"
325
+ ],
326
+ "topic": "skills"
327
+ },
328
+ {
329
+ "id": "extending.host-route",
330
+ "title": "Host routes: an HTTP API for a web or desktop plugin",
331
+ "path": "extending/host-route.md",
332
+ "when": "A client UI needs a backend endpoint, or state must be shared across devices.",
333
+ "surfaces": [
334
+ "web",
335
+ "desktop"
336
+ ],
337
+ "applies": "all",
338
+ "seeAlso": [
339
+ "extending.client-slot",
340
+ "extending.state-and-persistence"
341
+ ],
342
+ "examples": [
343
+ "host-route.basic"
344
+ ],
345
+ "topic": "an HTTP or RPC route"
346
+ },
347
+ {
348
+ "id": "extending.state-and-persistence",
349
+ "title": "State and persistence: where a plugin keeps its data",
350
+ "path": "extending/state-and-persistence.md",
351
+ "when": "A plugin must remember something: notes, todos, preferences, a cache, anything that should survive a reload or be shared between Web and Desktop.",
352
+ "surfaces": [
353
+ "tui",
354
+ "web",
355
+ "desktop"
356
+ ],
357
+ "applies": "all",
358
+ "seeAlso": [
359
+ "extending.host-route",
360
+ "extending.client-slot",
361
+ "extending.config-schema",
362
+ "reference.subsystems.storage"
363
+ ],
364
+ "examples": [
365
+ "state.host-store",
366
+ "state.workspace-file",
367
+ "settings-section.basic",
368
+ "client-slot.header-action"
369
+ ],
370
+ "topic": "saving data, notes, settings or state"
371
+ },
372
+ {
373
+ "id": "extending.tui-command",
374
+ "title": "Terminal commands: slash commands with an overlay",
375
+ "path": "extending/tui-command.md",
376
+ "when": "The feature is a terminal (tui) command or overlay.",
377
+ "surfaces": [
378
+ "tui"
379
+ ],
380
+ "applies": "all",
381
+ "examples": [
382
+ "tui-command.basic"
383
+ ],
384
+ "topic": "terminal (CLI) overlays"
385
+ },
386
+ {
387
+ "id": "extending.llm-adapter",
388
+ "title": "LLM adapters: connect a new model provider",
389
+ "path": "extending/llm-adapter.md",
390
+ "when": "Connect a new model provider route: the stream protocol and a working network-free adapter.",
391
+ "surfaces": [
392
+ "tui",
393
+ "web",
394
+ "desktop"
395
+ ],
396
+ "applies": "all",
397
+ "examples": [
398
+ "llm-adapter.echo"
399
+ ],
400
+ "topic": "a new model provider"
401
+ },
402
+ {
403
+ "id": "extending.packaging",
404
+ "title": "Packaging a plugin, and generated capabilities",
405
+ "path": "extending/packaging.md",
406
+ "when": "Writing package.json and the patch, sharing the plugin, or recording a generated capability's permissions and provenance.",
407
+ "surfaces": [
408
+ "tui",
409
+ "web",
410
+ "desktop"
411
+ ],
412
+ "applies": "all",
413
+ "seeAlso": [
414
+ "delivery.local-live"
415
+ ],
416
+ "examples": [
417
+ "generated-capability.template"
418
+ ],
419
+ "topic": "package layout and publishing"
420
+ },
421
+ {
422
+ "id": "extending.three-role-capability",
423
+ "title": "Three-role capability: definition, providers, consumers",
424
+ "path": "extending/three-role-capability.md",
425
+ "when": "Several interchangeable implementations of one capability that consumers must not care about; swapping providers.",
426
+ "surfaces": [
427
+ "tui",
428
+ "web",
429
+ "desktop"
430
+ ],
431
+ "applies": "all",
432
+ "seeAlso": [
433
+ "extending.service"
434
+ ],
435
+ "examples": [
436
+ "capability.swap-provider-loud",
437
+ "capability.swap-provider-quiet",
438
+ "capability.swap-consumer"
439
+ ],
440
+ "topic": "swappable providers of one capability"
441
+ },
442
+ {
443
+ "id": "extending.desktop-main",
444
+ "title": "Profile and install services (desktopProfiles, desktopPnpm, livePluginActivation)",
445
+ "path": "extending/desktop-main.md",
446
+ "when": "A plugin needs the active profile, package operations or live activation of another plugin.",
447
+ "surfaces": [
448
+ "tui",
449
+ "web",
450
+ "desktop"
451
+ ],
452
+ "applies": "all",
453
+ "seeAlso": [
454
+ "delivery.local-live"
455
+ ],
456
+ "examples": [
457
+ "desktop-main.profile-info"
458
+ ],
459
+ "topic": "profile, pnpm and live activation services"
460
+ },
461
+ {
462
+ "id": "extending.agent-preset",
463
+ "title": "Agent presets and personas",
464
+ "path": "extending/agent-preset.md",
465
+ "when": "A different session composition (tools, prompt, skills) or identity, such as a reviewer or a minimal agent.",
466
+ "surfaces": [
467
+ "tui",
468
+ "web",
469
+ "desktop"
470
+ ],
471
+ "applies": "all",
472
+ "examples": [
473
+ "agent-preset.reviewer"
474
+ ],
475
+ "topic": "agent presets and personas"
476
+ },
477
+ {
478
+ "id": "extending.chat-command",
479
+ "title": "Chat slash commands",
480
+ "path": "extending/chat-command.md",
481
+ "when": "A /command the user types in the chat that runs on the host without the model (reload, export, toggle).",
482
+ "surfaces": [
483
+ "tui",
484
+ "web",
485
+ "desktop"
486
+ ],
487
+ "applies": "all",
488
+ "examples": [
489
+ "chat-command.basic"
490
+ ],
491
+ "seeAlso": [
492
+ "extending.tui-command"
493
+ ],
494
+ "topic": "a chat slash command"
495
+ },
496
+ {
497
+ "id": "extending.ui-theme",
498
+ "title": "Theme, colors and fonts (Web and Desktop client theme service)",
499
+ "path": "extending/ui-theme.md",
500
+ "when": "Change colors, surfaces, accent, fonts or text size of the Web or Desktop app: overrideTokens, register, setFontSize.",
501
+ "surfaces": [
502
+ "web",
503
+ "desktop"
504
+ ],
505
+ "applies": "all",
506
+ "seeAlso": [
507
+ "maps.theme-tokens"
508
+ ],
509
+ "examples": [
510
+ "ui-theme.override"
511
+ ],
512
+ "topic": "theme tokens and fonts (Web/Desktop)"
513
+ },
514
+ {
515
+ "id": "extending.ui-branding",
516
+ "title": "Branding: logo, name, tab title, favicon, page shell",
517
+ "path": "extending/ui-branding.md",
518
+ "when": "Rebrand the app: brand slots, the tab or window title, favicon, page background, and what is native or compiled-in.",
519
+ "surfaces": [
520
+ "tui",
521
+ "web",
522
+ "desktop"
523
+ ],
524
+ "applies": "all",
525
+ "seeAlso": [
526
+ "extending.ui-theme",
527
+ "extending.desktop-app"
528
+ ],
529
+ "examples": [
530
+ "web-page-branding.basic",
531
+ "ui-theme.override"
532
+ ],
533
+ "topic": "logo, name, tab title, favicon"
534
+ },
535
+ {
536
+ "id": "extending.desktop-app",
537
+ "title": "The Desktop (Electron) app: structure and what a plugin can or cannot change",
538
+ "path": "extending/desktop-app.md",
539
+ "when": "Any Desktop request: main process versus renderer, modes, files for window chrome, icon, menu, tray, and what needs a rebuild.",
540
+ "surfaces": [
541
+ "desktop"
542
+ ],
543
+ "applies": "all",
544
+ "seeAlso": [
545
+ "extending.desktop-main",
546
+ "extending.ui-customization"
547
+ ],
548
+ "topic": "the Electron app and its native chrome"
549
+ },
550
+ {
551
+ "id": "extending.tui-components",
552
+ "title": "The terminal UI: pi-tui components, theming, branding",
553
+ "path": "extending/tui-components.md",
554
+ "when": "Build or restyle terminal UI: the Component contract, built-in components, palette, width safety, and what is compiled into the CLI.",
555
+ "surfaces": [
556
+ "tui"
557
+ ],
558
+ "applies": "all",
559
+ "seeAlso": [
560
+ "extending.tui-command"
561
+ ],
562
+ "examples": [
563
+ "tui-overlay.themed"
564
+ ],
565
+ "topic": "pi-tui components and terminal theming"
566
+ }
567
+ ]
568
+ },
569
+ {
570
+ "title": "Delivery",
571
+ "items": [
572
+ {
573
+ "id": "delivery.local-live",
574
+ "title": "Deliver a plugin live: local install, no restart",
575
+ "path": "delivery/local-live.md",
576
+ "when": "The plugin is written and must become live now; a plugin must be CHANGED, FIXED, IMPROVED or REMOVED; acryl_install_plugin returned an error; or the plugin is PENDING, FAILED or not visible.",
577
+ "surfaces": [
578
+ "tui",
579
+ "web",
580
+ "desktop"
581
+ ],
582
+ "applies": "all",
583
+ "seeAlso": [
584
+ "start.verify-before-done",
585
+ "extending.packaging"
586
+ ],
587
+ "examples": [
588
+ "lifecycle-function.hot-shim"
589
+ ],
590
+ "topic": "installing live, updating, removing"
591
+ },
592
+ {
593
+ "id": "delivery.marketplace",
594
+ "title": "Delivering through the marketplace",
595
+ "path": "delivery/marketplace.md",
596
+ "when": "The user wants to share or publish a plugin: readiness checks and the human publish step.",
597
+ "surfaces": [
598
+ "tui",
599
+ "web",
600
+ "desktop"
601
+ ],
602
+ "applies": "all",
603
+ "seeAlso": [
604
+ "delivery.local-live",
605
+ "extending.packaging"
606
+ ],
607
+ "topic": "preparing to share on the marketplace"
608
+ }
609
+ ]
610
+ },
611
+ {
612
+ "title": "Maps (generated)",
613
+ "items": [
614
+ {
615
+ "id": "maps.mount-points",
616
+ "title": "Mount points per surface: where UI and host extensions attach (CLI, Web, Desktop)",
617
+ "path": "maps/mount-points.md",
618
+ "when": "You must decide WHERE something mounts: which slot, terminal overlay, host service or Desktop frame, and which surface supports it.",
619
+ "surfaces": [
620
+ "tui",
621
+ "web",
622
+ "desktop"
623
+ ],
624
+ "applies": "all",
625
+ "seeAlso": [
626
+ "extending.client-slot",
627
+ "extending.tui-command"
628
+ ]
629
+ },
630
+ {
631
+ "id": "maps.theme-tokens",
632
+ "title": "Theme tokens: every design token you can override (Web and Desktop)",
633
+ "path": "maps/theme-tokens.md",
634
+ "when": "You want to change colors, surfaces, borders, buttons or fonts of the Web or Desktop app: the exact token names with light and dark values.",
635
+ "surfaces": [
636
+ "web",
637
+ "desktop"
638
+ ],
639
+ "applies": "all",
640
+ "seeAlso": [
641
+ "extending.ui-theme"
642
+ ]
643
+ },
644
+ {
645
+ "id": "maps.ui-components",
646
+ "title": "UI component libraries available today (web primitives, pi-tui) and the gap",
647
+ "path": "maps/ui-components.md",
648
+ "when": "You are about to build UI: which ready-made components exist on each surface so you do not hand-style.",
649
+ "surfaces": [
650
+ "tui",
651
+ "web",
652
+ "desktop"
653
+ ],
654
+ "applies": "all",
655
+ "seeAlso": [
656
+ "extending.ui-components"
657
+ ]
658
+ },
659
+ {
660
+ "id": "maps.events",
661
+ "title": "Lifecycle events: where a plugin can hook the agent (prompt, request, stream, session)",
662
+ "path": "maps/events.md",
663
+ "when": "You want to intercept or observe the agent lifecycle: prompt construction, the provider request, streaming, tool policy, session events.",
664
+ "surfaces": [
665
+ "tui",
666
+ "web",
667
+ "desktop"
668
+ ],
669
+ "applies": "all",
670
+ "seeAlso": [
671
+ "extending.event-hook"
672
+ ]
673
+ },
674
+ {
675
+ "id": "maps.slot-contracts",
676
+ "title": "Slot contracts: register options, props, taken keys and an example for every client slot",
677
+ "path": "maps/slot-contracts.md",
678
+ "when": "You fill a client slot that needs more than name, id and order: its exact register options, the props your component gets, and a worked example.",
679
+ "surfaces": [
680
+ "web",
681
+ "desktop"
682
+ ],
683
+ "applies": "all",
684
+ "seeAlso": [
685
+ "maps.mount-points",
686
+ "extending.client-slot"
687
+ ]
688
+ },
689
+ {
690
+ "id": "maps.taxonomy",
691
+ "title": "Plugin taxonomy: every plugin type and every shipped plugin, per surface",
692
+ "path": "maps/taxonomy.md",
693
+ "when": "You want the full list of plugin types, which surfaces have them, whether an agent can author one, and real shipped plugins to study.",
694
+ "surfaces": [
695
+ "tui",
696
+ "web",
697
+ "desktop"
698
+ ],
699
+ "applies": "all",
700
+ "seeAlso": [
701
+ "extending.cordis-core"
702
+ ]
703
+ }
704
+ ]
705
+ },
706
+ {
707
+ "title": "Reference (synced)",
708
+ "items": [
709
+ {
710
+ "id": "reference.subsystems.readme",
711
+ "title": "Harness subsystems: Subsystems",
712
+ "path": "reference/subsystems/README.md",
713
+ "when": "English | [中文](README.zh.md)",
714
+ "surfaces": [
715
+ "tui",
716
+ "web",
717
+ "desktop"
718
+ ],
719
+ "applies": "partial",
720
+ "source": {
721
+ "sourceRepo": "deepseek-harness",
722
+ "sourcePath": "docs/subsystems/README.md",
723
+ "sourceCommit": "639ed01539"
724
+ }
725
+ },
726
+ {
727
+ "id": "reference.subsystems.agent-team",
728
+ "title": "Harness subsystems: Agent Teams",
729
+ "path": "reference/subsystems/agent-team.md",
730
+ "when": "English | [中文](agent-team.zh.md)",
731
+ "surfaces": [
732
+ "tui",
733
+ "web",
734
+ "desktop"
735
+ ],
736
+ "applies": "partial",
737
+ "source": {
738
+ "sourceRepo": "deepseek-harness",
739
+ "sourcePath": "docs/subsystems/agent-team.md",
740
+ "sourceCommit": "639ed01539"
741
+ }
742
+ },
743
+ {
744
+ "id": "reference.subsystems.approval",
745
+ "title": "Harness subsystems: User Approval",
746
+ "path": "reference/subsystems/approval.md",
747
+ "when": "English | [中文](approval.zh.md)",
748
+ "surfaces": [
749
+ "tui",
750
+ "web",
751
+ "desktop"
752
+ ],
753
+ "applies": "partial",
754
+ "source": {
755
+ "sourceRepo": "deepseek-harness",
756
+ "sourcePath": "docs/subsystems/approval.md",
757
+ "sourceCommit": "639ed01539"
758
+ }
759
+ },
760
+ {
761
+ "id": "reference.subsystems.attachment",
762
+ "title": "Harness subsystems: Durable Attachments",
763
+ "path": "reference/subsystems/attachment.md",
764
+ "when": "English | [中文](attachment.zh.md)",
765
+ "surfaces": [
766
+ "tui",
767
+ "web",
768
+ "desktop"
769
+ ],
770
+ "applies": "partial",
771
+ "source": {
772
+ "sourceRepo": "deepseek-harness",
773
+ "sourcePath": "docs/subsystems/attachment.md",
774
+ "sourceCommit": "639ed01539"
775
+ }
776
+ },
777
+ {
778
+ "id": "reference.subsystems.boot",
779
+ "title": "Harness subsystems: Profile management",
780
+ "path": "reference/subsystems/boot.md",
781
+ "when": "English | [中文](boot.zh.md)",
782
+ "surfaces": [
783
+ "tui",
784
+ "web",
785
+ "desktop"
786
+ ],
787
+ "applies": "partial",
788
+ "source": {
789
+ "sourceRepo": "deepseek-harness",
790
+ "sourcePath": "docs/subsystems/boot.md",
791
+ "sourceCommit": "639ed01539"
792
+ }
793
+ },
794
+ {
795
+ "id": "reference.subsystems.browser-use",
796
+ "title": "Harness subsystems: Browser use",
797
+ "path": "reference/subsystems/browser-use.md",
798
+ "when": "English | [中文](browser-use.zh.md)",
799
+ "surfaces": [
800
+ "tui",
801
+ "web",
802
+ "desktop"
803
+ ],
804
+ "applies": "partial",
805
+ "source": {
806
+ "sourceRepo": "deepseek-harness",
807
+ "sourcePath": "docs/subsystems/browser-use.md",
808
+ "sourceCommit": "639ed01539"
809
+ }
810
+ },
811
+ {
812
+ "id": "reference.subsystems.client-modules",
813
+ "title": "Harness subsystems: Client Modules",
814
+ "path": "reference/subsystems/client-modules.md",
815
+ "when": "English | [中文](client-modules.zh.md)",
816
+ "surfaces": [
817
+ "tui",
818
+ "web",
819
+ "desktop"
820
+ ],
821
+ "applies": "partial",
822
+ "source": {
823
+ "sourceRepo": "deepseek-harness",
824
+ "sourcePath": "docs/subsystems/client-modules.md",
825
+ "sourceCommit": "639ed01539"
826
+ }
827
+ },
828
+ {
829
+ "id": "reference.subsystems.client-resources",
830
+ "title": "Harness subsystems: Client Resources",
831
+ "path": "reference/subsystems/client-resources.md",
832
+ "when": "English | [中文](client-resources.zh.md)",
833
+ "surfaces": [
834
+ "tui",
835
+ "web",
836
+ "desktop"
837
+ ],
838
+ "applies": "partial",
839
+ "source": {
840
+ "sourceRepo": "deepseek-harness",
841
+ "sourcePath": "docs/subsystems/client-resources.md",
842
+ "sourceCommit": "639ed01539"
843
+ }
844
+ },
845
+ {
846
+ "id": "reference.subsystems.commands",
847
+ "title": "Harness subsystems: Human Commands",
848
+ "path": "reference/subsystems/commands.md",
849
+ "when": "English | [中文](commands.zh.md)",
850
+ "surfaces": [
851
+ "tui",
852
+ "web",
853
+ "desktop"
854
+ ],
855
+ "applies": "partial",
856
+ "source": {
857
+ "sourceRepo": "deepseek-harness",
858
+ "sourcePath": "docs/subsystems/commands.md",
859
+ "sourceCommit": "639ed01539"
860
+ }
861
+ },
862
+ {
863
+ "id": "reference.subsystems.compaction",
864
+ "title": "Harness subsystems: Compaction",
865
+ "path": "reference/subsystems/compaction.md",
866
+ "when": "English | [中文](compaction.zh.md)",
867
+ "surfaces": [
868
+ "tui",
869
+ "web",
870
+ "desktop"
871
+ ],
872
+ "applies": "partial",
873
+ "source": {
874
+ "sourceRepo": "deepseek-harness",
875
+ "sourcePath": "docs/subsystems/compaction.md",
876
+ "sourceCommit": "639ed01539"
877
+ }
878
+ },
879
+ {
880
+ "id": "reference.subsystems.computer-use",
881
+ "title": "Harness subsystems: Computer use",
882
+ "path": "reference/subsystems/computer-use.md",
883
+ "when": "English | [中文](computer-use.zh.md)",
884
+ "surfaces": [
885
+ "tui",
886
+ "web",
887
+ "desktop"
888
+ ],
889
+ "applies": "partial",
890
+ "source": {
891
+ "sourceRepo": "deepseek-harness",
892
+ "sourcePath": "docs/subsystems/computer-use.md",
893
+ "sourceCommit": "639ed01539"
894
+ }
895
+ },
896
+ {
897
+ "id": "reference.subsystems.conversation",
898
+ "title": "Harness subsystems: Conversation assembly",
899
+ "path": "reference/subsystems/conversation.md",
900
+ "when": "English | [中文](conversation.zh.md)",
901
+ "surfaces": [
902
+ "tui",
903
+ "web",
904
+ "desktop"
905
+ ],
906
+ "applies": "partial",
907
+ "source": {
908
+ "sourceRepo": "deepseek-harness",
909
+ "sourcePath": "docs/subsystems/conversation.md",
910
+ "sourceCommit": "639ed01539"
911
+ }
912
+ },
913
+ {
914
+ "id": "reference.subsystems.core",
915
+ "title": "Harness subsystems: Core",
916
+ "path": "reference/subsystems/core.md",
917
+ "when": "English | [中文](core.zh.md)",
918
+ "surfaces": [
919
+ "tui",
920
+ "web",
921
+ "desktop"
922
+ ],
923
+ "applies": "partial",
924
+ "source": {
925
+ "sourceRepo": "deepseek-harness",
926
+ "sourcePath": "docs/subsystems/core.md",
927
+ "sourceCommit": "639ed01539"
928
+ }
929
+ },
930
+ {
931
+ "id": "reference.subsystems.credentials",
932
+ "title": "Harness subsystems: User Credentials",
933
+ "path": "reference/subsystems/credentials.md",
934
+ "when": "English | [中文](credentials.zh.md)",
935
+ "surfaces": [
936
+ "tui",
937
+ "web",
938
+ "desktop"
939
+ ],
940
+ "applies": "partial",
941
+ "source": {
942
+ "sourceRepo": "deepseek-harness",
943
+ "sourcePath": "docs/subsystems/credentials.md",
944
+ "sourceCommit": "639ed01539"
945
+ }
946
+ },
947
+ {
948
+ "id": "reference.subsystems.deliverables",
949
+ "title": "Harness subsystems: Deliverables",
950
+ "path": "reference/subsystems/deliverables.md",
951
+ "when": "English | [中文](deliverables.zh.md)",
952
+ "surfaces": [
953
+ "tui",
954
+ "web",
955
+ "desktop"
956
+ ],
957
+ "applies": "partial",
958
+ "source": {
959
+ "sourceRepo": "deepseek-harness",
960
+ "sourcePath": "docs/subsystems/deliverables.md",
961
+ "sourceCommit": "639ed01539"
962
+ }
963
+ },
964
+ {
965
+ "id": "reference.subsystems.extensions",
966
+ "title": "Harness subsystems: Extensions",
967
+ "path": "reference/subsystems/extensions.md",
968
+ "when": "English | [中文](extensions.zh.md)",
969
+ "surfaces": [
970
+ "tui",
971
+ "web",
972
+ "desktop"
973
+ ],
974
+ "applies": "partial",
975
+ "source": {
976
+ "sourceRepo": "deepseek-harness",
977
+ "sourcePath": "docs/subsystems/extensions.md",
978
+ "sourceCommit": "639ed01539"
979
+ }
980
+ },
981
+ {
982
+ "id": "reference.subsystems.feedback",
983
+ "title": "Harness subsystems: Message Feedback",
984
+ "path": "reference/subsystems/feedback.md",
985
+ "when": "English | [中文](feedback.zh.md)",
986
+ "surfaces": [
987
+ "tui",
988
+ "web",
989
+ "desktop"
990
+ ],
991
+ "applies": "partial",
992
+ "source": {
993
+ "sourceRepo": "deepseek-harness",
994
+ "sourcePath": "docs/subsystems/feedback.md",
995
+ "sourceCommit": "639ed01539"
996
+ }
997
+ },
998
+ {
999
+ "id": "reference.subsystems.filesystem",
1000
+ "title": "Harness subsystems: Filesystem",
1001
+ "path": "reference/subsystems/filesystem.md",
1002
+ "when": "English | [中文](filesystem.zh.md)",
1003
+ "surfaces": [
1004
+ "tui",
1005
+ "web",
1006
+ "desktop"
1007
+ ],
1008
+ "applies": "partial",
1009
+ "source": {
1010
+ "sourceRepo": "deepseek-harness",
1011
+ "sourcePath": "docs/subsystems/filesystem.md",
1012
+ "sourceCommit": "639ed01539"
1013
+ }
1014
+ },
1015
+ {
1016
+ "id": "reference.subsystems.goal",
1017
+ "title": "Harness subsystems: Same-session goals",
1018
+ "path": "reference/subsystems/goal.md",
1019
+ "when": "English | [中文](goal.zh.md)",
1020
+ "surfaces": [
1021
+ "tui",
1022
+ "web",
1023
+ "desktop"
1024
+ ],
1025
+ "applies": "partial",
1026
+ "source": {
1027
+ "sourceRepo": "deepseek-harness",
1028
+ "sourcePath": "docs/subsystems/goal.md",
1029
+ "sourceCommit": "639ed01539"
1030
+ }
1031
+ },
1032
+ {
1033
+ "id": "reference.subsystems.invariants",
1034
+ "title": "Harness subsystems: Runtime Invariants",
1035
+ "path": "reference/subsystems/invariants.md",
1036
+ "when": "English | [中文](invariants.zh.md)",
1037
+ "surfaces": [
1038
+ "tui",
1039
+ "web",
1040
+ "desktop"
1041
+ ],
1042
+ "applies": "partial",
1043
+ "source": {
1044
+ "sourceRepo": "deepseek-harness",
1045
+ "sourcePath": "docs/subsystems/invariants.md",
1046
+ "sourceCommit": "639ed01539"
1047
+ }
1048
+ },
1049
+ {
1050
+ "id": "reference.subsystems.jobs",
1051
+ "title": "Harness subsystems: Background Job Runtime",
1052
+ "path": "reference/subsystems/jobs.md",
1053
+ "when": "English | [中文](jobs.zh.md)",
1054
+ "surfaces": [
1055
+ "tui",
1056
+ "web",
1057
+ "desktop"
1058
+ ],
1059
+ "applies": "partial",
1060
+ "source": {
1061
+ "sourceRepo": "deepseek-harness",
1062
+ "sourcePath": "docs/subsystems/jobs.md",
1063
+ "sourceCommit": "639ed01539"
1064
+ }
1065
+ },
1066
+ {
1067
+ "id": "reference.subsystems.llm-streaming",
1068
+ "title": "Harness subsystems: LLM Streaming",
1069
+ "path": "reference/subsystems/llm-streaming.md",
1070
+ "when": "English | [中文](llm-streaming.zh.md)",
1071
+ "surfaces": [
1072
+ "tui",
1073
+ "web",
1074
+ "desktop"
1075
+ ],
1076
+ "applies": "partial",
1077
+ "source": {
1078
+ "sourceRepo": "deepseek-harness",
1079
+ "sourcePath": "docs/subsystems/llm-streaming.md",
1080
+ "sourceCommit": "639ed01539"
1081
+ }
1082
+ },
1083
+ {
1084
+ "id": "reference.subsystems.lsp",
1085
+ "title": "Harness subsystems: LSP navigation",
1086
+ "path": "reference/subsystems/lsp.md",
1087
+ "when": "English | [中文](lsp.zh.md)",
1088
+ "surfaces": [
1089
+ "tui",
1090
+ "web",
1091
+ "desktop"
1092
+ ],
1093
+ "applies": "partial",
1094
+ "source": {
1095
+ "sourceRepo": "deepseek-harness",
1096
+ "sourcePath": "docs/subsystems/lsp.md",
1097
+ "sourceCommit": "639ed01539"
1098
+ }
1099
+ },
1100
+ {
1101
+ "id": "reference.subsystems.mcp",
1102
+ "title": "Harness subsystems: MCP",
1103
+ "path": "reference/subsystems/mcp.md",
1104
+ "when": "English | [中文](mcp.zh.md)",
1105
+ "surfaces": [
1106
+ "tui",
1107
+ "web",
1108
+ "desktop"
1109
+ ],
1110
+ "applies": "partial",
1111
+ "source": {
1112
+ "sourceRepo": "deepseek-harness",
1113
+ "sourcePath": "docs/subsystems/mcp.md",
1114
+ "sourceCommit": "639ed01539"
1115
+ }
1116
+ },
1117
+ {
1118
+ "id": "reference.subsystems.office-to-pdf",
1119
+ "title": "Harness subsystems: Office to PDF",
1120
+ "path": "reference/subsystems/office-to-pdf.md",
1121
+ "when": "English | [中文](office-to-pdf.zh.md)",
1122
+ "surfaces": [
1123
+ "tui",
1124
+ "web",
1125
+ "desktop"
1126
+ ],
1127
+ "applies": "partial",
1128
+ "source": {
1129
+ "sourceRepo": "deepseek-harness",
1130
+ "sourcePath": "docs/subsystems/office-to-pdf.md",
1131
+ "sourceCommit": "639ed01539"
1132
+ }
1133
+ },
1134
+ {
1135
+ "id": "reference.subsystems.otel",
1136
+ "title": "Harness subsystems: OTel reporting",
1137
+ "path": "reference/subsystems/otel.md",
1138
+ "when": "English | [中文](otel.zh.md)",
1139
+ "surfaces": [
1140
+ "tui",
1141
+ "web",
1142
+ "desktop"
1143
+ ],
1144
+ "applies": "partial",
1145
+ "source": {
1146
+ "sourceRepo": "deepseek-harness",
1147
+ "sourcePath": "docs/subsystems/otel.md",
1148
+ "sourceCommit": "639ed01539"
1149
+ }
1150
+ },
1151
+ {
1152
+ "id": "reference.subsystems.permission-presets",
1153
+ "title": "Harness subsystems: Permission Presets",
1154
+ "path": "reference/subsystems/permission-presets.md",
1155
+ "when": "English | [中文](permission-presets.zh.md)",
1156
+ "surfaces": [
1157
+ "tui",
1158
+ "web",
1159
+ "desktop"
1160
+ ],
1161
+ "applies": "partial",
1162
+ "source": {
1163
+ "sourceRepo": "deepseek-harness",
1164
+ "sourcePath": "docs/subsystems/permission-presets.md",
1165
+ "sourceCommit": "639ed01539"
1166
+ }
1167
+ },
1168
+ {
1169
+ "id": "reference.subsystems.persistence",
1170
+ "title": "Harness subsystems: Session Persistence",
1171
+ "path": "reference/subsystems/persistence.md",
1172
+ "when": "English | [中文](persistence.zh.md)",
1173
+ "surfaces": [
1174
+ "tui",
1175
+ "web",
1176
+ "desktop"
1177
+ ],
1178
+ "applies": "partial",
1179
+ "source": {
1180
+ "sourceRepo": "deepseek-harness",
1181
+ "sourcePath": "docs/subsystems/persistence.md",
1182
+ "sourceCommit": "639ed01539"
1183
+ }
1184
+ },
1185
+ {
1186
+ "id": "reference.subsystems.plan",
1187
+ "title": "Harness subsystems: Plan Mode",
1188
+ "path": "reference/subsystems/plan.md",
1189
+ "when": "English | [中文](plan.zh.md)",
1190
+ "surfaces": [
1191
+ "tui",
1192
+ "web",
1193
+ "desktop"
1194
+ ],
1195
+ "applies": "partial",
1196
+ "source": {
1197
+ "sourceRepo": "deepseek-harness",
1198
+ "sourcePath": "docs/subsystems/plan.md",
1199
+ "sourceCommit": "639ed01539"
1200
+ }
1201
+ },
1202
+ {
1203
+ "id": "reference.subsystems.product-telemetry",
1204
+ "title": "Harness subsystems: Product telemetry",
1205
+ "path": "reference/subsystems/product-telemetry.md",
1206
+ "when": "English | [中文](product-telemetry.zh.md)",
1207
+ "surfaces": [
1208
+ "tui",
1209
+ "web",
1210
+ "desktop"
1211
+ ],
1212
+ "applies": "partial",
1213
+ "source": {
1214
+ "sourceRepo": "deepseek-harness",
1215
+ "sourcePath": "docs/subsystems/product-telemetry.md",
1216
+ "sourceCommit": "639ed01539"
1217
+ }
1218
+ },
1219
+ {
1220
+ "id": "reference.subsystems.ptc-runtime",
1221
+ "title": "Harness subsystems: PTC runtime",
1222
+ "path": "reference/subsystems/ptc-runtime.md",
1223
+ "when": "English | [中文](ptc-runtime.zh.md)",
1224
+ "surfaces": [
1225
+ "tui",
1226
+ "web",
1227
+ "desktop"
1228
+ ],
1229
+ "applies": "partial",
1230
+ "source": {
1231
+ "sourceRepo": "deepseek-harness",
1232
+ "sourcePath": "docs/subsystems/ptc-runtime.md",
1233
+ "sourceCommit": "639ed01539"
1234
+ }
1235
+ },
1236
+ {
1237
+ "id": "reference.subsystems.sandbox",
1238
+ "title": "Harness subsystems: Process Sandbox",
1239
+ "path": "reference/subsystems/sandbox.md",
1240
+ "when": "English | [中文](sandbox.zh.md)",
1241
+ "surfaces": [
1242
+ "tui",
1243
+ "web",
1244
+ "desktop"
1245
+ ],
1246
+ "applies": "partial",
1247
+ "source": {
1248
+ "sourceRepo": "deepseek-harness",
1249
+ "sourcePath": "docs/subsystems/sandbox.md",
1250
+ "sourceCommit": "639ed01539"
1251
+ }
1252
+ },
1253
+ {
1254
+ "id": "reference.subsystems.schedule",
1255
+ "title": "Harness subsystems: Host-wide Schedule",
1256
+ "path": "reference/subsystems/schedule.md",
1257
+ "when": "English | [中文](schedule.zh.md)",
1258
+ "surfaces": [
1259
+ "tui",
1260
+ "web",
1261
+ "desktop"
1262
+ ],
1263
+ "applies": "partial",
1264
+ "source": {
1265
+ "sourceRepo": "deepseek-harness",
1266
+ "sourcePath": "docs/subsystems/schedule.md",
1267
+ "sourceCommit": "639ed01539"
1268
+ }
1269
+ },
1270
+ {
1271
+ "id": "reference.subsystems.scope",
1272
+ "title": "Harness subsystems: Scoped Registration",
1273
+ "path": "reference/subsystems/scope.md",
1274
+ "when": "English | [中文](scope.zh.md)",
1275
+ "surfaces": [
1276
+ "tui",
1277
+ "web",
1278
+ "desktop"
1279
+ ],
1280
+ "applies": "partial",
1281
+ "source": {
1282
+ "sourceRepo": "deepseek-harness",
1283
+ "sourcePath": "docs/subsystems/scope.md",
1284
+ "sourceCommit": "639ed01539"
1285
+ }
1286
+ },
1287
+ {
1288
+ "id": "reference.subsystems.session-projection",
1289
+ "title": "Harness subsystems: Session Projections",
1290
+ "path": "reference/subsystems/session-projection.md",
1291
+ "when": "English | [中文](session-projection.zh.md)",
1292
+ "surfaces": [
1293
+ "tui",
1294
+ "web",
1295
+ "desktop"
1296
+ ],
1297
+ "applies": "partial",
1298
+ "source": {
1299
+ "sourceRepo": "deepseek-harness",
1300
+ "sourcePath": "docs/subsystems/session-projection.md",
1301
+ "sourceCommit": "639ed01539"
1302
+ }
1303
+ },
1304
+ {
1305
+ "id": "reference.subsystems.session-query",
1306
+ "title": "Harness subsystems: Session Query",
1307
+ "path": "reference/subsystems/session-query.md",
1308
+ "when": "English | [中文](session-query.zh.md)",
1309
+ "surfaces": [
1310
+ "tui",
1311
+ "web",
1312
+ "desktop"
1313
+ ],
1314
+ "applies": "partial",
1315
+ "source": {
1316
+ "sourceRepo": "deepseek-harness",
1317
+ "sourcePath": "docs/subsystems/session-query.md",
1318
+ "sourceCommit": "639ed01539"
1319
+ }
1320
+ },
1321
+ {
1322
+ "id": "reference.subsystems.session-reference",
1323
+ "title": "Harness subsystems: Session References",
1324
+ "path": "reference/subsystems/session-reference.md",
1325
+ "when": "English | [中文](session-reference.zh.md)",
1326
+ "surfaces": [
1327
+ "tui",
1328
+ "web",
1329
+ "desktop"
1330
+ ],
1331
+ "applies": "partial",
1332
+ "source": {
1333
+ "sourceRepo": "deepseek-harness",
1334
+ "sourcePath": "docs/subsystems/session-reference.md",
1335
+ "sourceCommit": "639ed01539"
1336
+ }
1337
+ },
1338
+ {
1339
+ "id": "reference.subsystems.session-telemetry",
1340
+ "title": "Harness subsystems: SessionTelemetryBackend",
1341
+ "path": "reference/subsystems/session-telemetry.md",
1342
+ "when": "English | [中文](session-telemetry.zh.md)",
1343
+ "surfaces": [
1344
+ "tui",
1345
+ "web",
1346
+ "desktop"
1347
+ ],
1348
+ "applies": "partial",
1349
+ "source": {
1350
+ "sourceRepo": "deepseek-harness",
1351
+ "sourcePath": "docs/subsystems/session-telemetry.md",
1352
+ "sourceCommit": "639ed01539"
1353
+ }
1354
+ },
1355
+ {
1356
+ "id": "reference.subsystems.session-title",
1357
+ "title": "Harness subsystems: Session Titles",
1358
+ "path": "reference/subsystems/session-title.md",
1359
+ "when": "English | [中文](session-title.zh.md)",
1360
+ "surfaces": [
1361
+ "tui",
1362
+ "web",
1363
+ "desktop"
1364
+ ],
1365
+ "applies": "partial",
1366
+ "source": {
1367
+ "sourceRepo": "deepseek-harness",
1368
+ "sourcePath": "docs/subsystems/session-title.md",
1369
+ "sourceCommit": "639ed01539"
1370
+ }
1371
+ },
1372
+ {
1373
+ "id": "reference.subsystems.session",
1374
+ "title": "Harness subsystems: Sessions",
1375
+ "path": "reference/subsystems/session.md",
1376
+ "when": "English | [中文](session.zh.md)",
1377
+ "surfaces": [
1378
+ "tui",
1379
+ "web",
1380
+ "desktop"
1381
+ ],
1382
+ "applies": "partial",
1383
+ "source": {
1384
+ "sourceRepo": "deepseek-harness",
1385
+ "sourcePath": "docs/subsystems/session.md",
1386
+ "sourceCommit": "639ed01539"
1387
+ }
1388
+ },
1389
+ {
1390
+ "id": "reference.subsystems.settings",
1391
+ "title": "Harness subsystems: Plugin Configuration Forms",
1392
+ "path": "reference/subsystems/settings.md",
1393
+ "when": "English | [中文](settings.zh.md)",
1394
+ "surfaces": [
1395
+ "tui",
1396
+ "web",
1397
+ "desktop"
1398
+ ],
1399
+ "applies": "partial",
1400
+ "source": {
1401
+ "sourceRepo": "deepseek-harness",
1402
+ "sourcePath": "docs/subsystems/settings.md",
1403
+ "sourceCommit": "639ed01539"
1404
+ }
1405
+ },
1406
+ {
1407
+ "id": "reference.subsystems.shell",
1408
+ "title": "Harness subsystems: Shell Executor",
1409
+ "path": "reference/subsystems/shell.md",
1410
+ "when": "English | [中文](shell.zh.md)",
1411
+ "surfaces": [
1412
+ "tui",
1413
+ "web",
1414
+ "desktop"
1415
+ ],
1416
+ "applies": "partial",
1417
+ "source": {
1418
+ "sourceRepo": "deepseek-harness",
1419
+ "sourcePath": "docs/subsystems/shell.md",
1420
+ "sourceCommit": "639ed01539"
1421
+ }
1422
+ },
1423
+ {
1424
+ "id": "reference.subsystems.sidebar-right",
1425
+ "title": "Harness subsystems: Right Sidebar",
1426
+ "path": "reference/subsystems/sidebar-right.md",
1427
+ "when": "English | [中文](sidebar-right.zh.md)",
1428
+ "surfaces": [
1429
+ "tui",
1430
+ "web",
1431
+ "desktop"
1432
+ ],
1433
+ "applies": "partial",
1434
+ "source": {
1435
+ "sourceRepo": "deepseek-harness",
1436
+ "sourcePath": "docs/subsystems/sidebar-right.md",
1437
+ "sourceCommit": "639ed01539"
1438
+ }
1439
+ },
1440
+ {
1441
+ "id": "reference.subsystems.skills",
1442
+ "title": "Harness subsystems: Skills",
1443
+ "path": "reference/subsystems/skills.md",
1444
+ "when": "English | [中文](skills.zh.md)",
1445
+ "surfaces": [
1446
+ "tui",
1447
+ "web",
1448
+ "desktop"
1449
+ ],
1450
+ "applies": "partial",
1451
+ "source": {
1452
+ "sourceRepo": "deepseek-harness",
1453
+ "sourcePath": "docs/subsystems/skills.md",
1454
+ "sourceCommit": "639ed01539"
1455
+ }
1456
+ },
1457
+ {
1458
+ "id": "reference.subsystems.slots",
1459
+ "title": "Harness subsystems: Web Client Slots",
1460
+ "path": "reference/subsystems/slots.md",
1461
+ "when": "English | [中文](slots.zh.md)",
1462
+ "surfaces": [
1463
+ "tui",
1464
+ "web",
1465
+ "desktop"
1466
+ ],
1467
+ "applies": "partial",
1468
+ "source": {
1469
+ "sourceRepo": "deepseek-harness",
1470
+ "sourcePath": "docs/subsystems/slots.md",
1471
+ "sourceCommit": "639ed01539"
1472
+ }
1473
+ },
1474
+ {
1475
+ "id": "reference.subsystems.spill",
1476
+ "title": "Harness subsystems: Spill Storage",
1477
+ "path": "reference/subsystems/spill.md",
1478
+ "when": "English | [中文](spill.zh.md)",
1479
+ "surfaces": [
1480
+ "tui",
1481
+ "web",
1482
+ "desktop"
1483
+ ],
1484
+ "applies": "partial",
1485
+ "source": {
1486
+ "sourceRepo": "deepseek-harness",
1487
+ "sourcePath": "docs/subsystems/spill.md",
1488
+ "sourceCommit": "639ed01539"
1489
+ }
1490
+ },
1491
+ {
1492
+ "id": "reference.subsystems.ssh",
1493
+ "title": "Harness subsystems: SSH",
1494
+ "path": "reference/subsystems/ssh.md",
1495
+ "when": "English | [中文](ssh.zh.md)",
1496
+ "surfaces": [
1497
+ "tui",
1498
+ "web",
1499
+ "desktop"
1500
+ ],
1501
+ "applies": "partial",
1502
+ "source": {
1503
+ "sourceRepo": "deepseek-harness",
1504
+ "sourcePath": "docs/subsystems/ssh.md",
1505
+ "sourceCommit": "639ed01539"
1506
+ }
1507
+ },
1508
+ {
1509
+ "id": "reference.subsystems.storage",
1510
+ "title": "Harness subsystems: Storage",
1511
+ "path": "reference/subsystems/storage.md",
1512
+ "when": "English | [中文](storage.zh.md)",
1513
+ "surfaces": [
1514
+ "tui",
1515
+ "web",
1516
+ "desktop"
1517
+ ],
1518
+ "applies": "partial",
1519
+ "source": {
1520
+ "sourceRepo": "deepseek-harness",
1521
+ "sourcePath": "docs/subsystems/storage.md",
1522
+ "sourceCommit": "639ed01539"
1523
+ }
1524
+ },
1525
+ {
1526
+ "id": "reference.subsystems.subagent",
1527
+ "title": "Harness subsystems: Subagent",
1528
+ "path": "reference/subsystems/subagent.md",
1529
+ "when": "English | [中文](subagent.zh.md)",
1530
+ "surfaces": [
1531
+ "tui",
1532
+ "web",
1533
+ "desktop"
1534
+ ],
1535
+ "applies": "partial",
1536
+ "source": {
1537
+ "sourceRepo": "deepseek-harness",
1538
+ "sourcePath": "docs/subsystems/subagent.md",
1539
+ "sourceCommit": "639ed01539"
1540
+ }
1541
+ },
1542
+ {
1543
+ "id": "reference.subsystems.subprocess",
1544
+ "title": "Harness subsystems: Subprocess",
1545
+ "path": "reference/subsystems/subprocess.md",
1546
+ "when": "English | [中文](subprocess.zh.md)",
1547
+ "surfaces": [
1548
+ "tui",
1549
+ "web",
1550
+ "desktop"
1551
+ ],
1552
+ "applies": "partial",
1553
+ "source": {
1554
+ "sourceRepo": "deepseek-harness",
1555
+ "sourcePath": "docs/subsystems/subprocess.md",
1556
+ "sourceCommit": "639ed01539"
1557
+ }
1558
+ },
1559
+ {
1560
+ "id": "reference.subsystems.system-prompt",
1561
+ "title": "Harness subsystems: System Prompt Assembly",
1562
+ "path": "reference/subsystems/system-prompt.md",
1563
+ "when": "English | [中文](system-prompt.zh.md)",
1564
+ "surfaces": [
1565
+ "tui",
1566
+ "web",
1567
+ "desktop"
1568
+ ],
1569
+ "applies": "partial",
1570
+ "source": {
1571
+ "sourceRepo": "deepseek-harness",
1572
+ "sourcePath": "docs/subsystems/system-prompt.md",
1573
+ "sourceCommit": "639ed01539"
1574
+ }
1575
+ },
1576
+ {
1577
+ "id": "reference.subsystems.terminal",
1578
+ "title": "Harness subsystems: Persistent PTY Sessions",
1579
+ "path": "reference/subsystems/terminal.md",
1580
+ "when": "English | [中文](terminal.zh.md)",
1581
+ "surfaces": [
1582
+ "tui",
1583
+ "web",
1584
+ "desktop"
1585
+ ],
1586
+ "applies": "partial",
1587
+ "source": {
1588
+ "sourceRepo": "deepseek-harness",
1589
+ "sourcePath": "docs/subsystems/terminal.md",
1590
+ "sourceCommit": "639ed01539"
1591
+ }
1592
+ },
1593
+ {
1594
+ "id": "reference.subsystems.todo",
1595
+ "title": "Harness subsystems: Todo",
1596
+ "path": "reference/subsystems/todo.md",
1597
+ "when": "English | [中文](todo.zh.md)",
1598
+ "surfaces": [
1599
+ "tui",
1600
+ "web",
1601
+ "desktop"
1602
+ ],
1603
+ "applies": "partial",
1604
+ "source": {
1605
+ "sourceRepo": "deepseek-harness",
1606
+ "sourcePath": "docs/subsystems/todo.md",
1607
+ "sourceCommit": "639ed01539"
1608
+ }
1609
+ },
1610
+ {
1611
+ "id": "reference.subsystems.token-meter",
1612
+ "title": "Harness subsystems: Token Meter",
1613
+ "path": "reference/subsystems/token-meter.md",
1614
+ "when": "English | [中文](token-meter.zh.md)",
1615
+ "surfaces": [
1616
+ "tui",
1617
+ "web",
1618
+ "desktop"
1619
+ ],
1620
+ "applies": "partial",
1621
+ "source": {
1622
+ "sourceRepo": "deepseek-harness",
1623
+ "sourcePath": "docs/subsystems/token-meter.md",
1624
+ "sourceCommit": "639ed01539"
1625
+ }
1626
+ },
1627
+ {
1628
+ "id": "reference.subsystems.tools",
1629
+ "title": "Harness subsystems: Tools",
1630
+ "path": "reference/subsystems/tools.md",
1631
+ "when": "English | [中文](tools.zh.md)",
1632
+ "surfaces": [
1633
+ "tui",
1634
+ "web",
1635
+ "desktop"
1636
+ ],
1637
+ "applies": "partial",
1638
+ "source": {
1639
+ "sourceRepo": "deepseek-harness",
1640
+ "sourcePath": "docs/subsystems/tools.md",
1641
+ "sourceCommit": "639ed01539"
1642
+ }
1643
+ },
1644
+ {
1645
+ "id": "reference.subsystems.typert",
1646
+ "title": "Harness subsystems: Typert remote calls",
1647
+ "path": "reference/subsystems/typert.md",
1648
+ "when": "English | [中文](typert.zh.md)",
1649
+ "surfaces": [
1650
+ "tui",
1651
+ "web",
1652
+ "desktop"
1653
+ ],
1654
+ "applies": "partial",
1655
+ "source": {
1656
+ "sourceRepo": "deepseek-harness",
1657
+ "sourcePath": "docs/subsystems/typert.md",
1658
+ "sourceCommit": "639ed01539"
1659
+ }
1660
+ },
1661
+ {
1662
+ "id": "reference.subsystems.user-questions",
1663
+ "title": "Harness subsystems: User Interaction",
1664
+ "path": "reference/subsystems/user-questions.md",
1665
+ "when": "English | [中文](user-questions.zh.md)",
1666
+ "surfaces": [
1667
+ "tui",
1668
+ "web",
1669
+ "desktop"
1670
+ ],
1671
+ "applies": "partial",
1672
+ "source": {
1673
+ "sourceRepo": "deepseek-harness",
1674
+ "sourcePath": "docs/subsystems/user-questions.md",
1675
+ "sourceCommit": "639ed01539"
1676
+ }
1677
+ },
1678
+ {
1679
+ "id": "reference.subsystems.voice-input",
1680
+ "title": "Harness subsystems: Voice input",
1681
+ "path": "reference/subsystems/voice-input.md",
1682
+ "when": "English | [中文](voice-input.zh.md)",
1683
+ "surfaces": [
1684
+ "tui",
1685
+ "web",
1686
+ "desktop"
1687
+ ],
1688
+ "applies": "partial",
1689
+ "source": {
1690
+ "sourceRepo": "deepseek-harness",
1691
+ "sourcePath": "docs/subsystems/voice-input.md",
1692
+ "sourceCommit": "639ed01539"
1693
+ }
1694
+ },
1695
+ {
1696
+ "id": "reference.subsystems.web-client",
1697
+ "title": "Harness subsystems: Web Client architecture",
1698
+ "path": "reference/subsystems/web-client.md",
1699
+ "when": "English | [中文](web-client.zh.md)",
1700
+ "surfaces": [
1701
+ "tui",
1702
+ "web",
1703
+ "desktop"
1704
+ ],
1705
+ "applies": "partial",
1706
+ "source": {
1707
+ "sourceRepo": "deepseek-harness",
1708
+ "sourcePath": "docs/subsystems/web-client.md",
1709
+ "sourceCommit": "639ed01539"
1710
+ }
1711
+ },
1712
+ {
1713
+ "id": "reference.subsystems.web-server",
1714
+ "title": "Harness subsystems: HTTP Server",
1715
+ "path": "reference/subsystems/web-server.md",
1716
+ "when": "English | [中文](web-server.zh.md)",
1717
+ "surfaces": [
1718
+ "tui",
1719
+ "web",
1720
+ "desktop"
1721
+ ],
1722
+ "applies": "partial",
1723
+ "source": {
1724
+ "sourceRepo": "deepseek-harness",
1725
+ "sourcePath": "docs/subsystems/web-server.md",
1726
+ "sourceCommit": "639ed01539"
1727
+ }
1728
+ },
1729
+ {
1730
+ "id": "reference.subsystems.web",
1731
+ "title": "Harness subsystems: Web Access",
1732
+ "path": "reference/subsystems/web.md",
1733
+ "when": "English | [中文](web.zh.md)",
1734
+ "surfaces": [
1735
+ "tui",
1736
+ "web",
1737
+ "desktop"
1738
+ ],
1739
+ "applies": "partial",
1740
+ "source": {
1741
+ "sourceRepo": "deepseek-harness",
1742
+ "sourcePath": "docs/subsystems/web.md",
1743
+ "sourceCommit": "639ed01539"
1744
+ }
1745
+ },
1746
+ {
1747
+ "id": "reference.subsystems.webhook",
1748
+ "title": "Harness subsystems: Webhook runtime",
1749
+ "path": "reference/subsystems/webhook.md",
1750
+ "when": "English | [中文](webhook.zh.md)",
1751
+ "surfaces": [
1752
+ "tui",
1753
+ "web",
1754
+ "desktop"
1755
+ ],
1756
+ "applies": "partial",
1757
+ "source": {
1758
+ "sourceRepo": "deepseek-harness",
1759
+ "sourcePath": "docs/subsystems/webhook.md",
1760
+ "sourceCommit": "639ed01539"
1761
+ }
1762
+ },
1763
+ {
1764
+ "id": "reference.subsystems.workflow",
1765
+ "title": "Harness subsystems: Workflow",
1766
+ "path": "reference/subsystems/workflow.md",
1767
+ "when": "English | [中文](workflow.zh.md)",
1768
+ "surfaces": [
1769
+ "tui",
1770
+ "web",
1771
+ "desktop"
1772
+ ],
1773
+ "applies": "partial",
1774
+ "source": {
1775
+ "sourceRepo": "deepseek-harness",
1776
+ "sourcePath": "docs/subsystems/workflow.md",
1777
+ "sourceCommit": "639ed01539"
1778
+ }
1779
+ },
1780
+ {
1781
+ "id": "reference.subsystems.workspace",
1782
+ "title": "Harness subsystems: Workspaces",
1783
+ "path": "reference/subsystems/workspace.md",
1784
+ "when": "English | [中文](workspace.zh.md)",
1785
+ "surfaces": [
1786
+ "tui",
1787
+ "web",
1788
+ "desktop"
1789
+ ],
1790
+ "applies": "partial",
1791
+ "source": {
1792
+ "sourceRepo": "deepseek-harness",
1793
+ "sourcePath": "docs/subsystems/workspace.md",
1794
+ "sourceCommit": "639ed01539"
1795
+ }
1796
+ },
1797
+ {
1798
+ "id": "reference.cordis-api.context",
1799
+ "title": "Cordis API: Context",
1800
+ "path": "reference/cordis-api/context.md",
1801
+ "when": "Run `pnpm run gen-cordis-catalog` to regenerate. -->",
1802
+ "surfaces": [
1803
+ "tui",
1804
+ "web",
1805
+ "desktop"
1806
+ ],
1807
+ "applies": "partial",
1808
+ "source": {
1809
+ "sourceRepo": "deepseek-harness",
1810
+ "sourcePath": "docs/cordis-api/context.md",
1811
+ "sourceCommit": "639ed01539"
1812
+ }
1813
+ },
1814
+ {
1815
+ "id": "reference.cordis-api.events",
1816
+ "title": "Cordis API: Events",
1817
+ "path": "reference/cordis-api/events.md",
1818
+ "when": "Run `pnpm run gen-cordis-catalog` to regenerate. -->",
1819
+ "surfaces": [
1820
+ "tui",
1821
+ "web",
1822
+ "desktop"
1823
+ ],
1824
+ "applies": "partial",
1825
+ "source": {
1826
+ "sourceRepo": "deepseek-harness",
1827
+ "sourcePath": "docs/cordis-api/events.md",
1828
+ "sourceCommit": "639ed01539"
1829
+ }
1830
+ },
1831
+ {
1832
+ "id": "reference.cordis-api.fiber",
1833
+ "title": "Cordis API: Fiber",
1834
+ "path": "reference/cordis-api/fiber.md",
1835
+ "when": "Run `pnpm run gen-cordis-catalog` to regenerate. -->",
1836
+ "surfaces": [
1837
+ "tui",
1838
+ "web",
1839
+ "desktop"
1840
+ ],
1841
+ "applies": "partial",
1842
+ "source": {
1843
+ "sourceRepo": "deepseek-harness",
1844
+ "sourcePath": "docs/cordis-api/fiber.md",
1845
+ "sourceCommit": "639ed01539"
1846
+ }
1847
+ },
1848
+ {
1849
+ "id": "reference.cordis-api.inherited",
1850
+ "title": "Cordis API: Inherited Cordis API",
1851
+ "path": "reference/cordis-api/inherited.md",
1852
+ "when": "Run `pnpm run gen-cordis-catalog` to regenerate. -->",
1853
+ "surfaces": [
1854
+ "tui",
1855
+ "web",
1856
+ "desktop"
1857
+ ],
1858
+ "applies": "partial",
1859
+ "source": {
1860
+ "sourceRepo": "deepseek-harness",
1861
+ "sourcePath": "docs/cordis-api/inherited.md",
1862
+ "sourceCommit": "639ed01539"
1863
+ }
1864
+ },
1865
+ {
1866
+ "id": "reference.cordis-api.registry",
1867
+ "title": "Cordis API: Registry",
1868
+ "path": "reference/cordis-api/registry.md",
1869
+ "when": "Run `pnpm run gen-cordis-catalog` to regenerate. -->",
1870
+ "surfaces": [
1871
+ "tui",
1872
+ "web",
1873
+ "desktop"
1874
+ ],
1875
+ "applies": "partial",
1876
+ "source": {
1877
+ "sourceRepo": "deepseek-harness",
1878
+ "sourcePath": "docs/cordis-api/registry.md",
1879
+ "sourceCommit": "639ed01539"
1880
+ }
1881
+ },
1882
+ {
1883
+ "id": "reference.cordis-api.service",
1884
+ "title": "Cordis API: Service",
1885
+ "path": "reference/cordis-api/service.md",
1886
+ "when": "Run `pnpm run gen-cordis-catalog` to regenerate. -->",
1887
+ "surfaces": [
1888
+ "tui",
1889
+ "web",
1890
+ "desktop"
1891
+ ],
1892
+ "applies": "partial",
1893
+ "source": {
1894
+ "sourceRepo": "deepseek-harness",
1895
+ "sourcePath": "docs/cordis-api/service.md",
1896
+ "sourceCommit": "639ed01539"
1897
+ }
1898
+ },
1899
+ {
1900
+ "id": "reference.cookbook.adding-a-package",
1901
+ "title": "Harness cookbook: Cookbook: adding a workspace package",
1902
+ "path": "reference/cookbook/adding-a-package.md",
1903
+ "when": "English | [中文](adding-a-package.zh.md)",
1904
+ "surfaces": [
1905
+ "tui",
1906
+ "web",
1907
+ "desktop"
1908
+ ],
1909
+ "applies": "partial",
1910
+ "source": {
1911
+ "sourceRepo": "deepseek-harness",
1912
+ "sourcePath": "docs/cookbook/adding-a-package.md",
1913
+ "sourceCommit": "639ed01539"
1914
+ }
1915
+ },
1916
+ {
1917
+ "id": "reference.cookbook.adding-a-remote-api",
1918
+ "title": "Harness cookbook: Cookbook: adding a Remote API",
1919
+ "path": "reference/cookbook/adding-a-remote-api.md",
1920
+ "when": "English | [中文](adding-a-remote-api.zh.md)",
1921
+ "surfaces": [
1922
+ "tui",
1923
+ "web",
1924
+ "desktop"
1925
+ ],
1926
+ "applies": "partial",
1927
+ "source": {
1928
+ "sourceRepo": "deepseek-harness",
1929
+ "sourcePath": "docs/cookbook/adding-a-remote-api.md",
1930
+ "sourceCommit": "639ed01539"
1931
+ }
1932
+ },
1933
+ {
1934
+ "id": "reference.cookbook.adding-a-settings-card",
1935
+ "title": "Harness cookbook: Cookbook: live configuration forms",
1936
+ "path": "reference/cookbook/adding-a-settings-card.md",
1937
+ "when": "English | [中文](adding-a-settings-card.zh.md)",
1938
+ "surfaces": [
1939
+ "tui",
1940
+ "web",
1941
+ "desktop"
1942
+ ],
1943
+ "applies": "partial",
1944
+ "source": {
1945
+ "sourceRepo": "deepseek-harness",
1946
+ "sourcePath": "docs/cookbook/adding-a-settings-card.md",
1947
+ "sourceCommit": "639ed01539"
1948
+ }
1949
+ },
1950
+ {
1951
+ "id": "reference.cookbook.adding-a-tool",
1952
+ "title": "Harness cookbook: Tool authoring reference",
1953
+ "path": "reference/cookbook/adding-a-tool.md",
1954
+ "when": "English | [中文](adding-a-tool.zh.md)",
1955
+ "surfaces": [
1956
+ "tui",
1957
+ "web",
1958
+ "desktop"
1959
+ ],
1960
+ "applies": "partial",
1961
+ "source": {
1962
+ "sourceRepo": "deepseek-harness",
1963
+ "sourcePath": "docs/cookbook/adding-a-tool.md",
1964
+ "sourceCommit": "639ed01539"
1965
+ }
1966
+ },
1967
+ {
1968
+ "id": "reference.cookbook.adding-an-llm-adapter",
1969
+ "title": "Harness cookbook: Cookbook: adding an LLM adapter",
1970
+ "path": "reference/cookbook/adding-an-llm-adapter.md",
1971
+ "when": "English | [中文](adding-an-llm-adapter.zh.md)",
1972
+ "surfaces": [
1973
+ "tui",
1974
+ "web",
1975
+ "desktop"
1976
+ ],
1977
+ "applies": "partial",
1978
+ "source": {
1979
+ "sourceRepo": "deepseek-harness",
1980
+ "sourcePath": "docs/cookbook/adding-an-llm-adapter.md",
1981
+ "sourceCommit": "639ed01539"
1982
+ }
1983
+ },
1984
+ {
1985
+ "id": "reference.cookbook.extension-cookbook",
1986
+ "title": "Harness cookbook: Cookbook: extension plugin shapes",
1987
+ "path": "reference/cookbook/extension-cookbook.md",
1988
+ "when": "English | [中文](extension-cookbook.zh.md)",
1989
+ "surfaces": [
1990
+ "tui",
1991
+ "web",
1992
+ "desktop"
1993
+ ],
1994
+ "applies": "partial",
1995
+ "source": {
1996
+ "sourceRepo": "deepseek-harness",
1997
+ "sourcePath": "docs/cookbook/extension-cookbook.md",
1998
+ "sourceCommit": "639ed01539"
1999
+ }
2000
+ },
2001
+ {
2002
+ "id": "reference.harness.cordis-primer",
2003
+ "title": "Harness architecture: Cordis Primer",
2004
+ "path": "reference/harness/cordis-primer.md",
2005
+ "when": "English | [中文](cordis-primer.zh.md)",
2006
+ "surfaces": [
2007
+ "tui",
2008
+ "web",
2009
+ "desktop"
2010
+ ],
2011
+ "applies": "partial",
2012
+ "source": {
2013
+ "sourceRepo": "deepseek-harness",
2014
+ "sourcePath": "docs/cordis-primer.md",
2015
+ "sourceCommit": "639ed01539"
2016
+ }
2017
+ },
2018
+ {
2019
+ "id": "reference.harness.capability-seams",
2020
+ "title": "Harness architecture: Capability Seams And Core Services",
2021
+ "path": "reference/harness/capability-seams.md",
2022
+ "when": "Run `pnpm run gen-doc-graphs` to regenerate. -->",
2023
+ "surfaces": [
2024
+ "tui",
2025
+ "web",
2026
+ "desktop"
2027
+ ],
2028
+ "applies": "partial",
2029
+ "source": {
2030
+ "sourceRepo": "deepseek-harness",
2031
+ "sourcePath": "docs/capability-seams.md",
2032
+ "sourceCommit": "639ed01539"
2033
+ }
2034
+ },
2035
+ {
2036
+ "id": "reference.harness.glossary",
2037
+ "title": "Harness architecture: Glossary",
2038
+ "path": "reference/harness/glossary.md",
2039
+ "when": "English | [中文](glossary.zh.md)",
2040
+ "surfaces": [
2041
+ "tui",
2042
+ "web",
2043
+ "desktop"
2044
+ ],
2045
+ "applies": "partial",
2046
+ "source": {
2047
+ "sourceRepo": "deepseek-harness",
2048
+ "sourcePath": "docs/glossary.md",
2049
+ "sourceCommit": "639ed01539"
2050
+ }
2051
+ },
2052
+ {
2053
+ "id": "reference.harness.defensive-patterns",
2054
+ "title": "Harness architecture: Defensive patterns",
2055
+ "path": "reference/harness/defensive-patterns.md",
2056
+ "when": "English | [中文](defensive-patterns.zh.md)",
2057
+ "surfaces": [
2058
+ "tui",
2059
+ "web",
2060
+ "desktop"
2061
+ ],
2062
+ "applies": "partial",
2063
+ "source": {
2064
+ "sourceRepo": "deepseek-harness",
2065
+ "sourcePath": "docs/defensive-patterns.md",
2066
+ "sourceCommit": "639ed01539"
2067
+ }
2068
+ },
2069
+ {
2070
+ "id": "reference.harness.event-producer-consumer",
2071
+ "title": "Harness architecture: Event Producer And Consumer Matrix",
2072
+ "path": "reference/harness/event-producer-consumer.md",
2073
+ "when": "Run `pnpm run gen-doc-graphs` to regenerate. -->",
2074
+ "surfaces": [
2075
+ "tui",
2076
+ "web",
2077
+ "desktop"
2078
+ ],
2079
+ "applies": "partial",
2080
+ "source": {
2081
+ "sourceRepo": "deepseek-harness",
2082
+ "sourcePath": "docs/event-producer-consumer.md",
2083
+ "sourceCommit": "639ed01539"
2084
+ }
2085
+ },
2086
+ {
2087
+ "id": "reference.harness.tool-execution-pipeline",
2088
+ "title": "Harness architecture: Tool Execution Pipeline",
2089
+ "path": "reference/harness/tool-execution-pipeline.md",
2090
+ "when": "Run `pnpm run gen-doc-graphs` to regenerate. -->",
2091
+ "surfaces": [
2092
+ "tui",
2093
+ "web",
2094
+ "desktop"
2095
+ ],
2096
+ "applies": "partial",
2097
+ "source": {
2098
+ "sourceRepo": "deepseek-harness",
2099
+ "sourcePath": "docs/tool-execution-pipeline.md",
2100
+ "sourceCommit": "639ed01539"
2101
+ }
2102
+ },
2103
+ {
2104
+ "id": "reference.harness.agent-lifecycle",
2105
+ "title": "Harness architecture: Agent Turn And Step Lifecycle",
2106
+ "path": "reference/harness/agent-lifecycle.md",
2107
+ "when": "Run `pnpm run gen-doc-graphs` to regenerate. -->",
2108
+ "surfaces": [
2109
+ "tui",
2110
+ "web",
2111
+ "desktop"
2112
+ ],
2113
+ "applies": "partial",
2114
+ "source": {
2115
+ "sourceRepo": "deepseek-harness",
2116
+ "sourcePath": "docs/agent-lifecycle.md",
2117
+ "sourceCommit": "639ed01539"
2118
+ }
2119
+ },
2120
+ {
2121
+ "id": "reference.harness.architecture",
2122
+ "title": "Harness architecture: DeepSeek Harness Architecture",
2123
+ "path": "reference/harness/architecture.md",
2124
+ "when": "English | [中文](architecture.zh.md)",
2125
+ "surfaces": [
2126
+ "tui",
2127
+ "web",
2128
+ "desktop"
2129
+ ],
2130
+ "applies": "partial",
2131
+ "source": {
2132
+ "sourceRepo": "deepseek-harness",
2133
+ "sourcePath": "docs/architecture.md",
2134
+ "sourceCommit": "639ed01539"
2135
+ }
2136
+ },
2137
+ {
2138
+ "id": "reference.harness.config-catalog",
2139
+ "title": "Harness architecture: Plugin Config Catalog",
2140
+ "path": "reference/harness/config-catalog.md",
2141
+ "when": "Run `pnpm run gen-config-catalog` to regenerate. -->",
2142
+ "surfaces": [
2143
+ "tui",
2144
+ "web",
2145
+ "desktop"
2146
+ ],
2147
+ "applies": "partial",
2148
+ "source": {
2149
+ "sourceRepo": "deepseek-harness",
2150
+ "sourcePath": "docs/config-catalog.md",
2151
+ "sourceCommit": "639ed01539"
2152
+ }
2153
+ },
2154
+ {
2155
+ "id": "reference.harness.tool-catalog",
2156
+ "title": "Harness architecture: Tool Schema Catalog",
2157
+ "path": "reference/harness/tool-catalog.md",
2158
+ "when": "Run `pnpm run gen-tool-catalog` to regenerate. -->",
2159
+ "surfaces": [
2160
+ "tui",
2161
+ "web",
2162
+ "desktop"
2163
+ ],
2164
+ "applies": "partial",
2165
+ "source": {
2166
+ "sourceRepo": "deepseek-harness",
2167
+ "sourcePath": "docs/tool-catalog.md",
2168
+ "sourceCommit": "639ed01539"
2169
+ }
2170
+ },
2171
+ {
2172
+ "id": "reference.cordis-guides.cordis-usage-cheatsheet",
2173
+ "title": "Cordis guides: Cordis usage cheatsheet (source-validated)",
2174
+ "path": "reference/cordis-guides/cordis-usage-cheatsheet.md",
2175
+ "when": "Cordis is a **meta-framework**: it knows nothing about LLMs, agents, tools, sessions, or shell.",
2176
+ "surfaces": [
2177
+ "tui",
2178
+ "web",
2179
+ "desktop"
2180
+ ],
2181
+ "applies": "partial",
2182
+ "source": {
2183
+ "sourceRepo": "acryl",
2184
+ "sourcePath": "docs/cordis/cordis-usage-cheatsheet.md",
2185
+ "sourceCommit": "79fc28c108"
2186
+ }
2187
+ },
2188
+ {
2189
+ "id": "reference.cordis-guides.cordis-system-guide-for-coding-agents",
2190
+ "title": "Cordis guides: Cordis System Guide for Coding Agents",
2191
+ "path": "reference/cordis-guides/cordis_system_guide_for_coding_agents.md",
2192
+ "when": "**Path convention:** Unless an ACRYL/root path is written explicitly, paths such",
2193
+ "surfaces": [
2194
+ "tui",
2195
+ "web",
2196
+ "desktop"
2197
+ ],
2198
+ "applies": "partial",
2199
+ "source": {
2200
+ "sourceRepo": "acryl",
2201
+ "sourcePath": "docs/cordis/cordis_system_guide_for_coding_agents.md",
2202
+ "sourceCommit": "592736f2a2"
2203
+ }
2204
+ },
2205
+ {
2206
+ "id": "reference.cordis-guides.hello-world-plugin-guide",
2207
+ "title": "Cordis guides: Hello World: a Cordis plugin for this DSH Desktop repository",
2208
+ "path": "reference/cordis-guides/hello-world-plugin-guide.md",
2209
+ "when": "This guide is the smallest practical path from one JavaScript module to a",
2210
+ "surfaces": [
2211
+ "tui",
2212
+ "web",
2213
+ "desktop"
2214
+ ],
2215
+ "applies": "partial",
2216
+ "source": {
2217
+ "sourceRepo": "acryl",
2218
+ "sourcePath": "docs/cordisplugins/hello-world-plugin-guide.md",
2219
+ "sourceCommit": "043fa47bf8"
2220
+ }
2221
+ },
2222
+ {
2223
+ "id": "reference.cordis-guides.development-canvas-plugin",
2224
+ "title": "Cordis guides: Development Canvas as a standalone Cordis plugin",
2225
+ "path": "reference/cordis-guides/development-canvas-plugin.md",
2226
+ "when": "Development Canvas follows the same law as the rest of ACRYL: **everything is a",
2227
+ "surfaces": [
2228
+ "tui",
2229
+ "web",
2230
+ "desktop"
2231
+ ],
2232
+ "applies": "partial",
2233
+ "source": {
2234
+ "sourceRepo": "acryl",
2235
+ "sourcePath": "docs/cordisplugins/development-canvas-plugin.md",
2236
+ "sourceCommit": "7968b4ff5d"
2237
+ }
2238
+ }
2239
+ ]
2240
+ }
2241
+ ],
2242
+ "examples": [
2243
+ {
2244
+ "id": "lifecycle-function.basic",
2245
+ "type": "lifecycle-function",
2246
+ "path": "lifecycle-function-basic",
2247
+ "surfaces": [
2248
+ "tui",
2249
+ "web",
2250
+ "desktop"
2251
+ ],
2252
+ "teaches": "The smallest plugin: named exports name and apply, no dependencies.",
2253
+ "docs": [
2254
+ "start.this-runtime"
2255
+ ],
2256
+ "scenario": "lifecycle-function-basic"
2257
+ },
2258
+ {
2259
+ "id": "service.provider",
2260
+ "type": "service-provider",
2261
+ "path": "service-provider-greeter",
2262
+ "surfaces": [
2263
+ "tui",
2264
+ "web",
2265
+ "desktop"
2266
+ ],
2267
+ "teaches": "A Service subclass provides a named service; export the class as apply.",
2268
+ "docs": [
2269
+ "extending.service"
2270
+ ]
2271
+ },
2272
+ {
2273
+ "id": "service.consumer",
2274
+ "type": "service-consumer",
2275
+ "path": "service-consumer-greeter",
2276
+ "surfaces": [
2277
+ "tui",
2278
+ "web",
2279
+ "desktop"
2280
+ ],
2281
+ "teaches": "inject is a hard dependency (PENDING then ACTIVE); ctx.get is optional.",
2282
+ "docs": [
2283
+ "extending.service"
2284
+ ]
2285
+ },
2286
+ {
2287
+ "id": "tool.basic",
2288
+ "type": "tool",
2289
+ "path": "tool-basic",
2290
+ "surfaces": [
2291
+ "tui",
2292
+ "web",
2293
+ "desktop"
2294
+ ],
2295
+ "teaches": "Register a model-callable tool with defineTool.",
2296
+ "docs": [
2297
+ "extending.tool"
2298
+ ]
2299
+ },
2300
+ {
2301
+ "id": "event-hook.basic",
2302
+ "type": "event-hook",
2303
+ "path": "event-hook-basic",
2304
+ "surfaces": [
2305
+ "tui",
2306
+ "web",
2307
+ "desktop"
2308
+ ],
2309
+ "teaches": "Listen to and emit an event; waterfall must call next().",
2310
+ "docs": [
2311
+ "extending.event-hook"
2312
+ ]
2313
+ },
2314
+ {
2315
+ "id": "config-schema.basic",
2316
+ "type": "config-schema",
2317
+ "path": "config-schema-basic",
2318
+ "surfaces": [
2319
+ "tui",
2320
+ "web",
2321
+ "desktop"
2322
+ ],
2323
+ "teaches": "A Schemastery Config validated before apply.",
2324
+ "docs": [
2325
+ "extending.config-schema"
2326
+ ]
2327
+ },
2328
+ {
2329
+ "id": "prompt-contribution.basic",
2330
+ "type": "prompt-contribution",
2331
+ "path": "prompt-contribution-basic",
2332
+ "surfaces": [
2333
+ "tui",
2334
+ "web",
2335
+ "desktop"
2336
+ ],
2337
+ "teaches": "Add a static section to the system prompt.",
2338
+ "docs": [
2339
+ "extending.prompt-contribution"
2340
+ ]
2341
+ },
2342
+ {
2343
+ "id": "skill-provider.basic",
2344
+ "type": "skill-provider",
2345
+ "path": "skill-provider-basic",
2346
+ "surfaces": [
2347
+ "tui",
2348
+ "web",
2349
+ "desktop"
2350
+ ],
2351
+ "teaches": "Provide a bundled skill (name and description in context, body on demand).",
2352
+ "docs": [
2353
+ "extending.skill-provider"
2354
+ ]
2355
+ },
2356
+ {
2357
+ "id": "host-route.basic",
2358
+ "type": "host-route",
2359
+ "path": "host-route-basic",
2360
+ "surfaces": [
2361
+ "web",
2362
+ "desktop"
2363
+ ],
2364
+ "teaches": "Serve an HTTP route from a web or desktop host plugin.",
2365
+ "docs": [
2366
+ "extending.host-route"
2367
+ ]
2368
+ },
2369
+ {
2370
+ "id": "client-slot.header-action",
2371
+ "type": "client-slot",
2372
+ "path": "client-slot-header-action",
2373
+ "surfaces": [
2374
+ "web",
2375
+ "desktop"
2376
+ ],
2377
+ "teaches": "A UI plugin with no build step: top-bar button and panel, hand-written client bundle.",
2378
+ "docs": [
2379
+ "extending.client-slot"
2380
+ ]
2381
+ },
2382
+ {
2383
+ "id": "tui-command.basic",
2384
+ "type": "tui-contribution",
2385
+ "path": "tui-command-basic",
2386
+ "surfaces": [
2387
+ "tui"
2388
+ ],
2389
+ "teaches": "A slash command with an overlay in the terminal UI.",
2390
+ "docs": [
2391
+ "extending.tui-command"
2392
+ ]
2393
+ },
2394
+ {
2395
+ "id": "generated-capability.template",
2396
+ "type": "generated-capability",
2397
+ "path": "generated-capability-template",
2398
+ "surfaces": [
2399
+ "tui",
2400
+ "web",
2401
+ "desktop"
2402
+ ],
2403
+ "teaches": "The shape of a publishable, reviewable generated capability.",
2404
+ "docs": [
2405
+ "extending.packaging"
2406
+ ]
2407
+ },
2408
+ {
2409
+ "id": "lifecycle-function.hot-shim",
2410
+ "type": "lifecycle-function",
2411
+ "path": "lifecycle-function-hot-shim",
2412
+ "surfaces": [
2413
+ "tui",
2414
+ "web",
2415
+ "desktop"
2416
+ ],
2417
+ "teaches": "LEGACY: a hand-written hot shim. The installer now reloads host code automatically; this pattern is only needed if you bypass acryl_install_plugin.",
2418
+ "docs": [
2419
+ "delivery.local-live"
2420
+ ]
2421
+ },
2422
+ {
2423
+ "id": "llm-adapter.echo",
2424
+ "type": "llm-adapter",
2425
+ "path": "llm-adapter-echo",
2426
+ "surfaces": [
2427
+ "tui",
2428
+ "web",
2429
+ "desktop"
2430
+ ],
2431
+ "teaches": "the LlmAdapter stream protocol and registerAdapter, with no network.",
2432
+ "docs": [
2433
+ "extending.llm-adapter"
2434
+ ]
2435
+ },
2436
+ {
2437
+ "id": "capability.swap-provider-loud",
2438
+ "type": "three-role-capability",
2439
+ "path": "capability-swap-provider-loud",
2440
+ "surfaces": [
2441
+ "tui",
2442
+ "web",
2443
+ "desktop"
2444
+ ],
2445
+ "teaches": "provider A of a named capability (Service subclass); definition is the name plus method shape.",
2446
+ "docs": [
2447
+ "extending.three-role-capability"
2448
+ ]
2449
+ },
2450
+ {
2451
+ "id": "capability.swap-provider-quiet",
2452
+ "type": "three-role-capability",
2453
+ "path": "capability-swap-provider-quiet",
2454
+ "surfaces": [
2455
+ "tui",
2456
+ "web",
2457
+ "desktop"
2458
+ ],
2459
+ "teaches": "provider B: swap it for A and the consumer keeps working.",
2460
+ "docs": [
2461
+ "extending.three-role-capability"
2462
+ ]
2463
+ },
2464
+ {
2465
+ "id": "capability.swap-consumer",
2466
+ "type": "three-role-capability",
2467
+ "path": "capability-swap-consumer",
2468
+ "surfaces": [
2469
+ "tui",
2470
+ "web",
2471
+ "desktop"
2472
+ ],
2473
+ "teaches": "a consumer that depends on the service name only; PENDING until a provider exists, remounts on swap.",
2474
+ "docs": [
2475
+ "extending.three-role-capability"
2476
+ ]
2477
+ },
2478
+ {
2479
+ "id": "desktop-main.profile-info",
2480
+ "type": "desktop-main",
2481
+ "path": "desktop-main-profile-info",
2482
+ "surfaces": [
2483
+ "tui",
2484
+ "web",
2485
+ "desktop"
2486
+ ],
2487
+ "teaches": "reading desktopProfiles portably: current everywhere, list only on Desktop.",
2488
+ "docs": [
2489
+ "extending.desktop-main"
2490
+ ]
2491
+ },
2492
+ {
2493
+ "id": "agent-preset.reviewer",
2494
+ "type": "agent-preset",
2495
+ "path": "agent-preset-reviewer",
2496
+ "surfaces": [
2497
+ "tui",
2498
+ "web",
2499
+ "desktop"
2500
+ ],
2501
+ "teaches": "an agent preset directory: agent.cordis.yml plus preset.yml, a persona-only reviewer.",
2502
+ "docs": [
2503
+ "extending.agent-preset"
2504
+ ]
2505
+ },
2506
+ {
2507
+ "id": "client-slot.sidebar-tab",
2508
+ "type": "client-slot",
2509
+ "path": "client-slot-sidebar-tab",
2510
+ "surfaces": [
2511
+ "web",
2512
+ "desktop"
2513
+ ],
2514
+ "teaches": "a right-sidebar tab in two stages (tab type, then body) with no build step.",
2515
+ "docs": [
2516
+ "extending.client-slot"
2517
+ ]
2518
+ },
2519
+ {
2520
+ "id": "client-workspace-tab.whiteboard",
2521
+ "type": "client-slot",
2522
+ "path": "client-workspace-tab",
2523
+ "surfaces": [
2524
+ "web",
2525
+ "desktop"
2526
+ ],
2527
+ "teaches": "a tab type of your own registered in ctx.workspaceTabs: kind, label, glyph and a component whose state the workspace saves.",
2528
+ "docs": [
2529
+ "extending.workspace-tab"
2530
+ ]
2531
+ },
2532
+ {
2533
+ "id": "chat-command.basic",
2534
+ "type": "chat-command",
2535
+ "path": "chat-command-basic",
2536
+ "surfaces": [
2537
+ "tui",
2538
+ "web",
2539
+ "desktop"
2540
+ ],
2541
+ "teaches": "a /command handled on the host without the model, via ctx.commands.register.",
2542
+ "docs": [
2543
+ "extending.chat-command"
2544
+ ]
2545
+ },
2546
+ {
2547
+ "id": "settings-section.basic",
2548
+ "type": "settings-section",
2549
+ "path": "settings-section-basic",
2550
+ "surfaces": [
2551
+ "tui",
2552
+ "web",
2553
+ "desktop"
2554
+ ],
2555
+ "teaches": "a validated settings section with installSection, setSource and onChange.",
2556
+ "docs": [
2557
+ "extending.config-schema"
2558
+ ]
2559
+ },
2560
+ {
2561
+ "id": "ui-theme.override",
2562
+ "type": "ui-theme",
2563
+ "path": "client-theme-override",
2564
+ "surfaces": [
2565
+ "web",
2566
+ "desktop"
2567
+ ],
2568
+ "teaches": "restyle colors and font with ctx.theme.overrideTokens (both modes) and keep a custom tab title with an observer.",
2569
+ "docs": [
2570
+ "extending.ui-theme",
2571
+ "extending.ui-branding"
2572
+ ]
2573
+ },
2574
+ {
2575
+ "id": "web-page-branding.basic",
2576
+ "type": "ui-branding",
2577
+ "path": "web-page-branding",
2578
+ "surfaces": [
2579
+ "web",
2580
+ "desktop"
2581
+ ],
2582
+ "teaches": "brand the served page from the host: favicon and CSS via webserver/index-inject rows, title via tapIndex (pre-boot only).",
2583
+ "docs": [
2584
+ "extending.ui-branding"
2585
+ ]
2586
+ },
2587
+ {
2588
+ "id": "tui-overlay.themed",
2589
+ "type": "tui-ui",
2590
+ "path": "tui-overlay-themed",
2591
+ "surfaces": [
2592
+ "tui"
2593
+ ],
2594
+ "teaches": "a themed pi-tui overlay: Container, Text, SelectList, a semantic palette, and width-safe rendering.",
2595
+ "docs": [
2596
+ "extending.tui-components"
2597
+ ]
2598
+ },
2599
+ {
2600
+ "id": "ui-components.shared-primitives",
2601
+ "type": "ui-components",
2602
+ "path": "client-ui-components",
2603
+ "surfaces": [
2604
+ "web",
2605
+ "desktop"
2606
+ ],
2607
+ "teaches": "build UI from the shared primitives (Button, Modal, Input, Switch, Tag) via require, in the root-scoped sidebar.footer.action slot.",
2608
+ "docs": [
2609
+ "extending.ui-components",
2610
+ "extending.client-slot"
2611
+ ]
2612
+ },
2613
+ {
2614
+ "id": "prompt-assemble-hook.basic",
2615
+ "type": "event-hook",
2616
+ "path": "prompt-assemble-hook",
2617
+ "surfaces": [
2618
+ "tui",
2619
+ "web",
2620
+ "desktop"
2621
+ ],
2622
+ "teaches": "hook prompt construction on the system-prompt/assemble waterfall: await next(), change the assembly, return it.",
2623
+ "docs": [
2624
+ "extending.event-hook"
2625
+ ]
2626
+ },
2627
+ {
2628
+ "id": "lifecycle-hooks.observer",
2629
+ "type": "event-hook",
2630
+ "path": "lifecycle-hooks-observer",
2631
+ "surfaces": [
2632
+ "tui",
2633
+ "web",
2634
+ "desktop"
2635
+ ],
2636
+ "teaches": "observe the agent lifecycle on the pre-step, request and llm/stream waterfalls: always call next() and return its result.",
2637
+ "docs": [
2638
+ "extending.event-hook"
2639
+ ]
2640
+ },
2641
+ {
2642
+ "id": "client-tool-view.custom-card",
2643
+ "type": "client-slot",
2644
+ "path": "client-tool-view",
2645
+ "surfaces": [
2646
+ "web",
2647
+ "desktop"
2648
+ ],
2649
+ "teaches": "a tool plus its own conversation card via the keyed tool.call.toolview slot (renders running and settled calls).",
2650
+ "docs": [
2651
+ "extending.client-slot"
2652
+ ]
2653
+ },
2654
+ {
2655
+ "id": "tool-policy-hook.deny",
2656
+ "type": "event-hook",
2657
+ "path": "tool-policy-hook",
2658
+ "surfaces": [
2659
+ "tui",
2660
+ "web",
2661
+ "desktop"
2662
+ ],
2663
+ "teaches": "a tool policy on the tools/pre-execute waterfall: allow, deny with a reason, or ask; return next() for everything else.",
2664
+ "docs": [
2665
+ "extending.event-hook"
2666
+ ]
2667
+ },
2668
+ {
2669
+ "id": "client-chat-message-action.bookmark",
2670
+ "type": "client-slot",
2671
+ "path": "client-chat-message-action",
2672
+ "surfaces": [
2673
+ "web",
2674
+ "desktop"
2675
+ ],
2676
+ "teaches": "the additive chat-message seams: an action under each finished assistant message (assistant-actions list slot), plus notes on turnTail and chat-node takeovers.",
2677
+ "docs": [
2678
+ "extending.client-slot"
2679
+ ]
2680
+ },
2681
+ {
2682
+ "id": "state.host-store",
2683
+ "type": "host-route",
2684
+ "path": "state-host-store",
2685
+ "surfaces": [
2686
+ "web",
2687
+ "desktop"
2688
+ ],
2689
+ "teaches": "Keep state on the host (a JSON file under the DSH home) behind an authenticated RPC channel, so Web and Desktop share it and it survives clearing the browser.",
2690
+ "docs": [
2691
+ "extending.state-and-persistence",
2692
+ "extending.host-route"
2693
+ ]
2694
+ },
2695
+ {
2696
+ "id": "state.workspace-file",
2697
+ "type": "tool",
2698
+ "path": "state-workspace-file",
2699
+ "surfaces": [
2700
+ "tui",
2701
+ "web",
2702
+ "desktop"
2703
+ ],
2704
+ "teaches": "Keep project notes in the workspace as .acryl/notes.md via tools, so the agent and the user can read them and git can track them.",
2705
+ "docs": [
2706
+ "extending.state-and-persistence",
2707
+ "extending.tool"
2708
+ ]
2709
+ },
2710
+ {
2711
+ "id": "ui-library.gallery",
2712
+ "type": "client-slot",
2713
+ "path": "client-ui-library",
2714
+ "surfaces": [
2715
+ "web",
2716
+ "desktop"
2717
+ ],
2718
+ "teaches": "Build a screen from the ACRYL UI library (@acryldev/ui): cards, fields, settings rows, dropdown, segmented tiles, tabs, dialog, color roles and slot helpers.",
2719
+ "docs": [
2720
+ "extending.ui-library"
2721
+ ]
2722
+ },
2723
+ {
2724
+ "id": "ui-library.tui-gallery",
2725
+ "type": "tui-contribution",
2726
+ "path": "tui-ui-library",
2727
+ "surfaces": [
2728
+ "tui"
2729
+ ],
2730
+ "teaches": "Build a terminal screen from the ACRYL UI library (@acryldev/ui-tui): cards, fields, settings rows, select, segmented, tabs, dialog, colors from the shared roles and the tuiTheme service.",
2731
+ "docs": [
2732
+ "extending.ui-library",
2733
+ "extending.tui-components"
2734
+ ]
2735
+ }
2736
+ ],
2737
+ "routes": [
2738
+ {
2739
+ "when": "colors, fonts, branding, logo, any UI look and feel",
2740
+ "docs": [
2741
+ "extending.ui-customization",
2742
+ "extending.ui-theme",
2743
+ "extending.ui-branding"
2744
+ ]
2745
+ },
2746
+ {
2747
+ "when": "a button, panel, tab, card, shortcut or tool-call card in Web/Desktop",
2748
+ "docs": [
2749
+ "extending.ui-library",
2750
+ "extending.client-slot"
2751
+ ]
2752
+ },
2753
+ {
2754
+ "when": "terminal (CLI) UI and overlays",
2755
+ "docs": [
2756
+ "extending.tui-components",
2757
+ "extending.tui-command"
2758
+ ]
2759
+ },
2760
+ {
2761
+ "when": "a model-callable tool",
2762
+ "docs": [
2763
+ "extending.tool"
2764
+ ]
2765
+ },
2766
+ {
2767
+ "when": "a chat slash command",
2768
+ "docs": [
2769
+ "extending.chat-command"
2770
+ ]
2771
+ },
2772
+ {
2773
+ "when": "events, prompt sections, hooks",
2774
+ "docs": [
2775
+ "extending.event-hook",
2776
+ "extending.prompt-contribution"
2777
+ ]
2778
+ },
2779
+ {
2780
+ "when": "services, dependencies, swappable providers, which Cordis mechanism",
2781
+ "docs": [
2782
+ "extending.service",
2783
+ "extending.three-role-capability"
2784
+ ]
2785
+ },
2786
+ {
2787
+ "when": "configuration and settings",
2788
+ "docs": [
2789
+ "extending.config-schema"
2790
+ ]
2791
+ },
2792
+ {
2793
+ "when": "skills, agent presets, personas",
2794
+ "docs": [
2795
+ "extending.skill-provider",
2796
+ "extending.agent-preset"
2797
+ ]
2798
+ },
2799
+ {
2800
+ "when": "a model provider, an HTTP/RPC route",
2801
+ "docs": [
2802
+ "extending.llm-adapter",
2803
+ "extending.host-route"
2804
+ ]
2805
+ },
2806
+ {
2807
+ "when": "profile, pnpm, live-activation services, the Desktop app",
2808
+ "docs": [
2809
+ "extending.desktop-main",
2810
+ "extending.desktop-app"
2811
+ ]
2812
+ },
2813
+ {
2814
+ "when": "packaging, installing live, updating, removing, sharing",
2815
+ "docs": [
2816
+ "extending.packaging",
2817
+ "delivery.local-live",
2818
+ "delivery.marketplace"
2819
+ ]
2820
+ },
2821
+ {
2822
+ "when": "verifying, safety, a plugin that is PENDING, FAILED, invisible or stale",
2823
+ "docs": [
2824
+ "start.verify-before-done",
2825
+ "start.troubleshooting",
2826
+ "start.trust-and-safety"
2827
+ ]
2828
+ },
2829
+ {
2830
+ "when": "saving data, notes, settings, state; sharing it between Web and Desktop",
2831
+ "docs": [
2832
+ "extending.state-and-persistence"
2833
+ ]
2834
+ }
2835
+ ]
2836
+ }