@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
@@ -0,0 +1,154 @@
1
+ # Mount points: where a plugin can put things, per surface
2
+
3
+ <!-- Generated by scripts/sync-corpus.mjs from the SlotMap declarations in source. Do not edit. -->
4
+
5
+ ACRYL has three surfaces. A plugin has two halves: a **host** half (Node, `apply(ctx)`, all surfaces) and, for
6
+ Web and Desktop, an optional **browser** half (`client.js`, slots). Pick the mount point first, then read its doc.
7
+
8
+ ## Which surface can show what
9
+
10
+ | I want to add | CLI (terminal) | Web | Desktop |
11
+ | --- | --- | --- | --- |
12
+ | A visible UI element (button, panel, tab, card) | a **TUI command overlay** (`tuiCommands.register`, opened with a slash command) | a **client slot** (table below) | the same client slots as Web, plus the Desktop frame slots |
13
+ | A whole page or full-screen view | a full-screen overlay (`tuiCommands` without an `overlay` hint) | a header button opening a fixed `inset: 0` panel | the `desktop.main` frame slot (replaces the main surface) or the same panel |
14
+ | A model-callable tool | yes (`tools`) | yes | yes |
15
+ | A chat slash command | yes (`commands.register`) | yes | yes |
16
+ | Text in the system prompt, skills | yes | yes | yes |
17
+ | A new model provider | yes (`llm`) | yes | yes |
18
+ | A backend HTTP/RPC route | no web server | yes (`router` and `routerHttp`, or `connection` RPC) | yes |
19
+ | Native OS integration (menus, notifications, windows) | no | no | Desktop main only (`desktopProfiles`, `desktopPnpm`, Electron); not agent-authorable without the main-process API |
20
+
21
+ ## Host mount points (every surface unless noted)
22
+
23
+ | Mount point | Service and call | What you contribute | Doc |
24
+ | --- | --- | --- | --- |
25
+ | Tools | ctx.tools.register(defineTool({...})) | a model-callable tool | extending/tool-plugin.md, example tool-basic |
26
+ | Chat slash commands | ctx.commands.register({ name, description, handler }) | a /command run on the host without the model | extending/chat-command.md, example chat-command-basic |
27
+ | System prompt | ctx.systemPrompt.section({ name, order, text }) | a prompt section (static text, or per-turn via PromptContext) | extending/prompt-contribution.md |
28
+ | Skills | ctx.skills.registerProvider(() => provider) | on-demand skills (name and description in context, body on demand) | extending/skill-provider.md |
29
+ | Model providers | ctx.llm.registerAdapter(['route'], adapter) | a new LLM provider route | extending/llm-adapter.md, example llm-adapter-echo |
30
+ | Events | ctx.on(name, listener) / ctx.emit / waterfall | listen to or intercept harness events (tool policy, session events) | extending/event-hook.md |
31
+ | Settings sections | ctx.settings.installSection(ctx, NS, Config, config, opts) | validated user-editable settings | extending/config-schema.md, example settings-section-basic |
32
+ | Agent presets and personas | a preset directory (agent.cordis.yml + preset.yml) | a different session composition or identity | extending/agent-preset.md |
33
+ | Subagent providers | ctx.subagents.register(...) | a new way to run a delegated agent | reference/subsystems/subagent.md (no example) |
34
+ | Host routes (Web and Desktop) | ctx.router.route('/', app); ctx.routerHttp.mount(prefix) / connection RPC | an HTTP or RPC endpoint for a browser half | extending/host-route.md |
35
+ | Services | class X extends Service { constructor(ctx) { super(ctx, 'name') } } | a named capability others inject | extending/service.md, extending/three-role-capability.md |
36
+ | Page shell: title, favicon, CSS, scripts (Web, Desktop) | ctx.on('webserver/index-inject', table => table.push(row)); ctx.get('webServer')?.tapIndex(html => html) | structured head/body rows (style, html, script, global) and a raw index.html transform | extending/ui-branding.md, example web-page-branding |
37
+ | Theme tokens and fonts (Web, Desktop client) | ctx.theme.overrideTokens(id, { '--token': { light, dark } }); ctx.theme.register({...}) | colors, surfaces, borders, font family, content font size | extending/ui-theme.md, maps/theme-tokens.md, example client-theme-override |
38
+ | Terminal overlays (CLI only) | ctx.get('tuiCommands')?.register({...}) | a slash command that opens a pi-tui overlay | extending/tui-command.md |
39
+ | Profile and install (all surfaces, fuller on Desktop) | ctx.get('desktopProfiles' \| 'desktopPnpm' \| 'livePluginActivation') | profile identity, package operations, live activation | extending/desktop-main.md |
40
+
41
+ ## CLI (terminal) presentation
42
+
43
+ The terminal has ONE plugin presentation seam: `ctx.get('tuiCommands')?.register({ command: '/name', description, packageName, overlay?, open({ tui, close }) })`.
44
+ `open()` returns a real `pi-tui` `Component` shown as an overlay (full screen by default; pass `overlay: { width, anchor, margin }`
45
+ for a compact popup). The command list refreshes live whenever a plugin registers or removes a command, so a newly installed command works without restarting the TUI. The built-in overlays (`/model`, `/plugins`, `/tools`, `/trajectory`, ...) are not replaceable. Everything else the CLI
46
+ shows (chat, tool cards, status) is built in. Example: `example-plugins/packages/tui-command-basic/`; doc: `extending/tui-command.md`.
47
+
48
+ ## Web and Desktop: client slots
49
+
50
+ Declared in source as `interface SlotMap` and listed here from those declarations. **Kind**: `single` (one occupant, replaces),
51
+ `list` (many, ordered by `order`), `keyed` (one per `key`), `chain` (selector-routed). **Scope**: `root` (once for the app),
52
+ `session` (per open conversation), `session-maybe` (also present with no session). Register from `client.js` with
53
+ `ctx.slots.inject(name, () => ctx.slots.register({ name, id, order }, Component))` (see `extending/client-slot.md`). A slot whose
54
+ owner props are non-trivial needs those props: read its entry in `maps/slot-contracts.md` (register options, exact props, taken keys, worked example) before using it. Verified
55
+ working examples: `conversation.session.header.actions` (header-action) and `sidebar.right.pane.tab` (sidebar-tab).
56
+
57
+ 91 slots:
58
+
59
+ | Slot | Kind | Scope | Owner props | Where / what | Declared by | Filled by (built-in) |
60
+ | --- | --- | --- | --- | --- | --- | --- |
61
+ | `conversation.approval.detail` | single | session | ApprovalDetailOwnerProps | Optional detail for the Tool call correlated with an approval request. | dsh-client-ui-approval | dsh-client-ui-approval, dsh-client-ui-chat |
62
+ | `conversation.chat.assistant-actions` | list | session | AssistantActionOwnerProps | Ordered actions for one finalized assistant message. Each entry receives | dsh-client-ui-chat | dsh-client-ui-chat, dsh-client-ui-message-feedback |
63
+ | `conversation.chat.commandview` | keyed | session | CommandRowOwnerProps | Command row keyed by the command name. The component receives the folded | dsh-client-ui-chat | dsh-client-ui-chat |
64
+ | `conversation.chat.node` | keyed | session | ChatNodeOwnerProps keyProps | Final Chat node renderer, keyed by `ChatNodeKind`. The component receives | dsh-client-ui-chat | dsh-client-ui-chat, dsh-client-ui-goal, dsh-client-ui-tool, dsh-client-ui-user-questions, dsh-client-ui-workflow-run |
65
+ | `conversation.chat.turnTail` | list | session | TurnTailOwnerProps | Ordered feature contributions before a completed Turn's action row. Each | dsh-client-ui-chat | dsh-client-ui-chat, dsh-client-ui-deliverables, dsh-client-ui-plan, dsh-client-ui-schedule |
66
+ | `conversation.composer` | chain | session | ComposerChainProps | Selector-routed replacements for the current Session's resident composer. | dsh-client-ui-conversation | dsh-client-ui-approval, dsh-client-ui-conversation, dsh-client-ui-subagent, dsh-client-ui-user-questions |
67
+ | `conversation.composer.bar` | single | session-maybe | ComposerBarOwnerProps | Resident composer body, including the no-Session inert state. | dsh-client-ui-conversation | dsh-client-ui-conversation |
68
+ | `conversation.composer.dock` | list | session | | Ambient entries below the composer card. | dsh-client-ui-conversation | dsh-client-ui-chat, dsh-client-ui-conversation |
69
+ | `conversation.header` | single | session-maybe | | Resident navigation container, including when no Session is selected. | dsh-client-ui-conversation | dsh-client-ui-conversation |
70
+ | `conversation.header.leading` | single | root | ConversationHeaderLeadingOwnerProps | Global navigation before the Session title, available without a Session. | dsh-client-ui-conversation | dsh-client-ui-conversation |
71
+ | `conversation.hero.agentPreset` | single | session-maybe | HeroAgentPresetOwnerProps | Agent-preset control staged for a New Session. | dsh-client-ui-conversation | dsh-client-ui-agent-preset, dsh-client-ui-conversation |
72
+ | `conversation.hero.brand.mark` | single | root | HeroBrandMarkOwnerProps | Brand mark shown before the blank-session headline. | dsh-client-ui-conversation | dsh-client-ui-conversation, @acryldev/brand-client |
73
+ | `conversation.hero.workspace` | single | root | EmptyWorkspaceOwnerProps | Workspace picker shown by the blank-session Hero. | dsh-client-ui-conversation | dsh-client-ui-conversation, dsh-client-ui-workspace, @acryldev/cordis-plugin-market |
74
+ | `conversation.hero.workspace.directoryFlow` | single | root | DirectoryFlowOwnerProps | Directory-flow hole under the conversation empty-state picker (declared by the WorkspacePicker entry). | dsh-client-ui-workspace | dsh-client-ui-directory-picker-browse, dsh-client-ui-directory-picker-native, dsh-client-ui-workspace |
75
+ | `conversation.input.activity` | single | session | InputActivityOwnerProps | Compact action after the model selector; it can expand across the toolbar while retaining the editor and submit action. | dsh-client-ui-conversation | dsh-client-ui-conversation |
76
+ | `conversation.input.attachments` | single | session-maybe | ComposerAttachmentsOwnerProps | Optional draft-attachment rail and drop target. | dsh-client-ui-conversation | dsh-client-ui-attachment, dsh-client-ui-conversation |
77
+ | `conversation.input.dock` | list | session | InputZone | Full-width entries above the composer card. | dsh-client-ui-conversation | dsh-client-ui-conversation, dsh-client-ui-goal |
78
+ | `conversation.input.left` | list | session | | Compact controls at the left of the composer tool row. | dsh-client-ui-conversation | dsh-client-ui-conversation |
79
+ | `conversation.input.model` | single | session | InputControlOwnerProps | Model selector inside the composer tool row. When expanded controls cannot | dsh-client-ui-conversation | dsh-client-ui-conversation, dsh-client-ui-model-selection |
80
+ | `conversation.input.overlay` | list | session | | Floating entries rendered inside the resident composer card. | dsh-client-ui-conversation | dsh-client-ui-commands, dsh-client-ui-conversation, dsh-client-ui-input-trigger, dsh-client-ui-message-feedback |
81
+ | `conversation.input.permission` | single | session | InputControlOwnerProps | Current-session permission control inside the composer tool row. | dsh-client-ui-conversation | dsh-client-ui-conversation, dsh-client-ui-permission-presets |
82
+ | `conversation.input.plan` | single | session | InputControlOwnerProps | Plan control inside the composer tool row. | dsh-client-ui-conversation | dsh-client-ui-conversation, dsh-client-ui-plan |
83
+ | `conversation.input.right` | list | session | | Compact controls before the composer submit action. | dsh-client-ui-conversation | dsh-client-ui-conversation |
84
+ | `conversation.message.images` | single | session | MessageImagesOwnerProps | Renderer for one consecutive group of durable message images. The owner | dsh-client-ui-chat | dsh-client-ui-attachment, dsh-client-ui-chat |
85
+ | `conversation.plan-review.actions` | list | session | | Actions for the exact plan under review; approval remains with the question composer. | dsh-client-ui-user-questions | dsh-client-ui-plan, dsh-client-ui-user-questions |
86
+ | `conversation.session` | single | session | | Strict per-Session Conversation body. | dsh-client-ui-conversation | dsh-client-ui-conversation, dsh-client-ui-subagent |
87
+ | `conversation.session.header` | single | session | | Strict per-Session title, actions, and View navigation. | dsh-client-ui-conversation | dsh-client-ui-conversation |
88
+ | `conversation.session.header.actions` | list | session | ConversationHeaderActionOwnerProps | Title-adjacent Session actions in ascending order. | dsh-client-ui-conversation | @acryldev/ui, dsh-client-ui-agent-preset, dsh-client-ui-conversation, dsh-client-ui-jobs, dsh-client-ui-sidebar-terminal, dsh-client-ui-subagent |
89
+ | `conversation.session.header.corner` | single | session | ConversationHeaderCornerOwnerProps | The header's far-right corner, past the utilities' edge and into the | dsh-client-ui-conversation | dsh-client-ui-conversation, dsh-client-ui-sidebar-right |
90
+ | `conversation.session.header.lineage` | single | session | ConversationHeaderLineageOwnerProps | Optional replacement for one Session breadcrumb title. | dsh-client-ui-conversation | dsh-client-ui-conversation, dsh-client-ui-subagent |
91
+ | `conversation.session.header.utilities` | list | session | ConversationHeaderActionOwnerProps | Right-aligned Session utilities in ascending order. | dsh-client-ui-conversation | dsh-client-ui-conversation, dsh-client-ui-open-in-app, dsh-client-ui-schedule |
92
+ | `conversation.trajectory.images` | single | session | MessageImagesOwnerProps | Renderer for one group of durable record images in the Trajectory | dsh-client-ui-trajectory | dsh-client-ui-attachment, dsh-client-ui-trajectory |
93
+ | `conversation.view` | list | session | ConvViewOwnerProps | Registered Conversation target Views, rendered one at a time. | dsh-client-ui-conversation | dsh-client-ui-chat, dsh-client-ui-conversation, dsh-client-ui-trajectory |
94
+ | `deliverables.file.actions` | list | session | | Open one file through its authorized Session event coordinates. | dsh-client-ui-deliverables | dsh-client-ui-deliverables, dsh-client-ui-open-in-app |
95
+ | `deliverables.review.file.actions` | list | session | SlotMap[ | The same file actions owned by a changed-file review tab. | dsh-client-ui-deliverables | dsh-client-ui-deliverables, dsh-client-ui-open-in-app |
96
+ | `desktop.main` | single | root | DesktopMainOwnerProps | Replaceable main surface inside the desktop advanced frame (shown while no keyed upstream `main` panel is open). | @acryldev/app-shell | @acryldev/app-shell, @acryldev/workspace |
97
+ | `desktop.sidebar` | single | root | DesktopSidebarSurfaceOwnerProps | Replaceable left-pane surface; by default it only renders the upstream `sidebar`. | @acryldev/app-shell | @acryldev/app-shell, @acryldev/workspace |
98
+ | `main` | keyed | root | | Central panel selected by sidebar entry id. The reserved `conversation` | dsh-client-ui-layout | dsh-client-ui-conversation, dsh-client-ui-layout, dsh-client-ui-plugin-manager, dsh-client-ui-schedule, @acryldev/app-shell |
99
+ | `main.conversation` | single | session-maybe | | Conversation shell beneath its root-scoped main-panel entry. | dsh-client-ui-conversation | dsh-client-ui-conversation |
100
+ | `plugins.bundle.activation` | keyed | root | PluginActivationOwnerProps | Optional guidance after the user enables a bundle from the list, keyed by npm package name. | dsh-client-ui-plugin-manager | dsh-client-ui-plugin-manager |
101
+ | `plugins.bundle.config` | keyed | root | PluginConfigViewProps | A bundle's own configuration, keyed by the bundle's package name and | dsh-client-ui-plugin-manager | dsh-client-ui-plugin-manager |
102
+ | `plugins.detail.actions` | list | root | PluginDetailProps | Controls at the head of a detail page, before the page's own switch and | dsh-client-ui-plugin-manager | dsh-client-ui-plugin-manager |
103
+ | `plugins.detail.badge` | list | root | PluginDetailProps | Tags beside a detail page's title, after the version, beta, and problem | dsh-client-ui-plugin-manager | dsh-client-ui-plugin-manager |
104
+ | `plugins.detail.section` | list | root | PluginDetailProps | Sections under a detail page's own content: after the rows on a bundle's | dsh-client-ui-plugin-manager | dsh-client-ui-plugin-manager |
105
+ | `plugins.item` | list | root | PluginConfigViewProps | One official plugin the Plugins page lists in its Official group after | dsh-client-ui-plugin-manager | dsh-client-ui-plugin-manager, dsh-client-ui-settings-agent-loop, dsh-client-ui-settings-shell, dsh-client-ui-settings-subagent, dsh-client-ui-settings-web-search |
106
+ | `plugins.row.config` | keyed | root | PluginConfigViewProps | The configuration of one row a bundle declares, keyed by | dsh-client-ui-plugin-manager | dsh-client-ui-plugin-manager |
107
+ | `rightbar` | single | root | RightbarOwnerProps | The right column: a track the centre makes room for, or nothing. OCCUPIED | dsh-client-ui-layout | dsh-client-ui-layout, dsh-client-ui-sidebar-right, @acryldev/app-shell |
108
+ | `rightbar.session` | single | session | RightbarOwnerProps | Session content selected by the root-scoped right Sidebar controller. | dsh-client-ui-sidebar-right | dsh-client-ui-sidebar-right |
109
+ | `root` | single | root | RootOwnerProps | The built-in render-tree root hole (seeded by SlotCore): the one slot the | dsh-client-ui-renderer | dsh-client-ui-chat, dsh-client-ui-conversation, dsh-client-ui-layout, dsh-client-ui-plugin-manager, dsh-client-ui-renderer, dsh-client-ui-settings-general, dsh-client-ui-settings-models, dsh-client-ui-settings-plugins, dsh-client-ui-sidebar, dsh-client-ui-workspace, @acryldev/app-shell |
110
+ | `settings.action` | list | root | SettingsHeaderOwnerProps | Optional actions rendered in the content-column header before Close. | dsh-client-ui-settings | dsh-client-ui-settings-general, acryl-desktop |
111
+ | `settings.close` | single | root | SettingsHeaderOwnerProps | The close button's visually-hidden label text (the button itself — | dsh-client-ui-settings | dsh-client-ui-settings-general |
112
+ | `settings.general.item` | list | root | SettingsGeneralItemOwnerProps | One preference row inside the General section — the additive seat for a | dsh-client-ui-settings | dsh-client-locale, dsh-client-ui-chat, dsh-client-ui-conversation, dsh-client-ui-permission-presets, dsh-client-ui-settings-general, dsh-client-ui-settings-session-log, dsh-client-ui-shortcuts, dsh-client-ui-theme |
113
+ | `settings.header` | single | root | SettingsHeaderOwnerProps | The panel title text seat. Content renders inside the nav heading row; | dsh-client-ui-settings | dsh-client-ui-settings-general |
114
+ | `settings.launcher` | single | root | SettingsLauncherOwnerProps | Optional sidebar account launcher; opens the shell-owned settings panel. | dsh-client-ui-settings | dsh-client-ui-settings-account, dsh-client-ui-settings-general |
115
+ | `settings.models.footer` | list | root | ModelsFooterOwnerProps | Ordered extension area after the provider rows and the add controls. | dsh-client-ui-settings-models | dsh-client-ui-settings-models, @acryldev/sign-in |
116
+ | `settings.models.provider-card` | keyed | root | ProviderCardExtrasOwnerProps | One provider card's adapter extension area, dispatched with | dsh-client-ui-settings-models | dsh-client-ui-settings-models |
117
+ | `settings.models.sign-in` | single | root | | Optional account login choice before the credential editor. | dsh-client-ui-settings-models | dsh-client-ui-settings-account, dsh-client-ui-settings-models |
118
+ | `settings.onboarding` | list | root | SettingsOnboardingOwnerProps | Root-scoped onboarding steps contributed by settings features. The | dsh-client-ui-settings | dsh-client-ui-settings-general, dsh-client-ui-settings-models |
119
+ | `settings.plugins.tab` | list | root | SettingsPluginsTabOwnerProps | One page inside the Plugins settings section. The section owner renders | dsh-client-ui-settings | dsh-client-ui-settings-plugin-inventory, dsh-client-ui-settings-plugins, @acryldev/plugin-admin, @acryldev/cordis-plugin-market |
120
+ | `settings.section` | list | root | SettingsSectionOwnerProps | One settings page per list entry. Registrant options carry the nav | dsh-client-ui-settings | @acryldev/ui, dsh-client-ui-agent-preset, dsh-client-ui-settings-account, dsh-client-ui-settings-general, dsh-client-ui-settings-models, dsh-client-ui-settings-plugins, @acryldev/agent-control, acryl-desktop, @acryldev/shortcuts, @acryldev/support, @acryldev/workspace, my-ui-plugin |
121
+ | `settings.trigger` | single | root | SettingsTriggerOwnerProps | The sidebar-foot trigger row content: icon + label, supplied as slot | dsh-client-ui-settings | dsh-client-ui-settings-general |
122
+ | `shell.leading` | single | root | | Window-chrome seat at the frame's top-left, over every main panel. | dsh-client-ui-layout | dsh-client-ui-layout, dsh-client-ui-sidebar, @acryldev/app-shell |
123
+ | `shell.overlay` | list | root | | Frame-wide floating layer, above every column and outside their scroll | dsh-client-ui-layout | dsh-client-ui-chat, dsh-client-ui-layout, dsh-client-ui-plugin-manager, dsh-client-ui-schedule, dsh-client-ui-settings-account, dsh-client-ui-settings-session-log, dsh-client-ui-shortcuts, dsh-client-ui-sidebar-terminal, dsh-client-ui-workspace, @acryldev/agent-control, @acryldev/app-shell, @acryldev/cordis-plugin-market |
124
+ | `shell.quota-notice` | chain | root | QuotaNoticeOwnerProps | Frame-wide quota notice chain. The Chat-owned host in `shell.overlay` | dsh-client-ui-chat | dsh-client-ui-chat, dsh-client-ui-settings-account |
125
+ | `sidebar` | single | root | SidebarOwnerProps | The whole left column. OCCUPIED by ui-sidebar's SidebarRoot, which | dsh-client-ui-layout | dsh-client-ui-chat, dsh-client-ui-layout, dsh-client-ui-sidebar, dsh-client-ui-workspace, @acryldev/app-shell |
126
+ | `sidebar.brand.mark` | single | root | SidebarBrandMarkOwnerProps | Brand mark rendered in the expanded brand row and collapsed rail. | dsh-client-ui-sidebar | dsh-client-ui-brand-official, dsh-client-ui-sidebar, @acryldev/brand-client |
127
+ | `sidebar.brand.name` | single | root | SidebarBrandNameOwnerProps | Brand name rendered beside the expanded mark. Declared by this | dsh-client-ui-sidebar | dsh-client-ui-brand-official, dsh-client-ui-sidebar, @acryldev/brand-client |
128
+ | `sidebar.chat.conversation` | single | session | | Session-scoped Conversation occurrence hosted by one Sidebar chat tab. | dsh-client-ui-subagent | dsh-client-ui-subagent |
129
+ | `sidebar.footer.action` | list | root | SidebarFooterActionOwnerProps | Optional actions beside Settings at the sidebar foot. Declared by this | dsh-client-ui-sidebar | @acryldev/ui, dsh-client-ui-sidebar, @acryldev/cordis-plugin-market |
130
+ | `sidebar.panellist` | list | root | SidebarPanelIconOwnerProps | Global panel icons. Each list id addresses the matching main panel; | dsh-client-ui-sidebar | dsh-client-ui-plugin-manager, dsh-client-ui-schedule, dsh-client-ui-sidebar |
131
+ | `sidebar.right.pane.tab` | keyed | session | | One tab's body, dispatched with the `id` of the type in force for | dsh-client-ui-sidebar-right | @acryldev/ui, dsh-client-ui-deliverables, dsh-client-ui-plan, dsh-client-ui-schedule, dsh-client-ui-sidebar-browser, dsh-client-ui-sidebar-documentpreview, dsh-client-ui-sidebar-files, dsh-client-ui-sidebar-right, dsh-client-ui-sidebar-terminal, dsh-client-ui-subagent, @acryldev/workspace |
132
+ | `sidebar.right.pane.tab.title` | keyed | session | | A tab's title as its chip (and a floating panel's header) shows it, | dsh-client-ui-sidebar-right | dsh-client-ui-plan, dsh-client-ui-schedule, dsh-client-ui-sidebar-browser, dsh-client-ui-sidebar-documentpreview, dsh-client-ui-sidebar-files, dsh-client-ui-sidebar-right, dsh-client-ui-sidebar-terminal |
133
+ | `sidebar.right.tab.document` | keyed | session | DocumentBodyOwner hookContext | Document body selected by a registered implementation id. | dsh-client-ui-sidebar-documentpreview | dsh-client-ui-sidebar-documentpreview |
134
+ | `sidebar.right.tab.document.action` | keyed | session | | Renderer-specific controls before the document toolbar's reload button. | dsh-client-ui-sidebar-documentpreview | dsh-client-ui-sidebar-documentpreview |
135
+ | `sidebar.right.tab.document.actions` | list | session | | Header toolbar contributions acting on the previewed file, rendered | dsh-client-ui-sidebar-documentpreview | dsh-client-ui-open-in-app, dsh-client-ui-sidebar-documentpreview |
136
+ | `sidebar.right.tab.document.office.pdf` | keyed | session | DocumentBodyOwner hookContext | PDF presentation supplied with Office-owned converted bytes. | dsh-client-ui-sidebar-documentpreview | dsh-client-ui-sidebar-documentpreview |
137
+ | `sidebar.right.tab.document.unpreviewable` | list | session | | Empty-state contributions for a file this preview cannot render, | dsh-client-ui-sidebar-documentpreview | dsh-client-ui-open-in-app, dsh-client-ui-sidebar-documentpreview |
138
+ | `sidebar.right.tab.files.actions` | list | session | | Workspace directory actions after the file tree's reload control. | dsh-client-ui-sidebar-files | dsh-client-ui-open-in-app, dsh-client-ui-sidebar-files |
139
+ | `sidebar.right.tab.guide` | chain | session | | The guide tab's body. Selectors run in chain order and the first | dsh-client-ui-sidebar-right | dsh-client-ui-sidebar-right |
140
+ | `sidebar.right.tab.guide.entry` | keyed | session | SidebarRightGuideEntryOwnerProps hookContext | One provider's guide card, with the standard card as the owner's fallback. | dsh-client-ui-sidebar-right | dsh-client-ui-sidebar-right, dsh-client-ui-sidebar-terminal |
141
+ | `sidebar.right.tab.menu.item` | list | session | SidebarRightTabMenuOwnerProps | Extra items at the end of one tab's actions menu, in registration order. | dsh-client-ui-sidebar-right | dsh-client-ui-sidebar-right |
142
+ | `sidebar.session.row.hover` | list | root | SessionRowScheduleOwnerProps | Section of the Session row's hover card between its relative time and | dsh-client-ui-workspace | dsh-client-ui-schedule, dsh-client-ui-workspace |
143
+ | `sidebar.session.row.leading` | list | root | SessionRowScheduleOwnerProps | Leading decoration of one Session row, in the 16px cell before the title | dsh-client-ui-workspace | dsh-client-ui-schedule, dsh-client-ui-workspace |
144
+ | `sidebar.settings` | single | root | SidebarSettingsOwnerProps | The settings seat at the sidebar foot. Declared by this package's | dsh-client-ui-sidebar | dsh-client-ui-settings-general, dsh-client-ui-sidebar |
145
+ | `sidebar.toggle.badge` | single | root | Record<never, never> | Non-interactive notification inside the collapsed sidebar expand button. | dsh-client-ui-sidebar | dsh-client-ui-settings-general, dsh-client-ui-sidebar |
146
+ | `sidebar.workspaces` | single | root | SidebarSectionOwnerProps | The workspace/session browsing region: section header, search, the | dsh-client-ui-sidebar | dsh-client-ui-sidebar, dsh-client-ui-workspace |
147
+ | `sidebar.workspaces.directoryFlow` | single | root | DirectoryFlowOwnerProps | Directory-flow hole under the sidebar browsing region (declared by the WorkspaceBrowser entry). | dsh-client-ui-workspace | dsh-client-ui-directory-picker-browse, dsh-client-ui-directory-picker-native, dsh-client-ui-workspace |
148
+ | `sidebar.workspaces.session.menu.item` | list | root | SessionRowOwnerProps hookContext | The rows of one Session's "..." menu, in ascending `order`. ui-workspace | dsh-client-ui-workspace | dsh-client-ui-workspace |
149
+ | `sidebar.workspaces.session.row.action` | list | root | SessionRowOwnerProps | The hover buttons at the end of one Session row, in ascending `order`, | dsh-client-ui-workspace | dsh-client-ui-workspace |
150
+ | `tool.call.images` | single | session | ToolImagesOwnerProps | Durable images of a settled image-bearing Tool call, rendered through | dsh-client-ui-tool | dsh-client-ui-attachment, dsh-client-ui-tool |
151
+ | `tool.call.toolview` | keyed | session | ToolCallOwnerProps hookContext | Keyed Tool call view dispatched by wire Tool name. Any name is allowed, | dsh-client-ui-tool | dsh-client-ui-deliverables, dsh-client-ui-skill, dsh-client-ui-tool |
152
+
153
+ Desktop adds its own frame slots (`desktop.main`, `sidebar`, `conversation`, `details`, `shell.overlay`) in advanced mode; they are
154
+ in the table above from `apps/acryl-desktop/src/client/contracts.ts`. On Web these frame slots do not exist; the upstream slots do.