@abot-ai/runtime 1.7.0 → 1.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (532) hide show
  1. package/README.md +216 -222
  2. package/dist/src/capabilities/tool-definition-validator/definition-parser.js +8 -0
  3. package/dist/src/capabilities/tool-request-resources.d.ts +3 -0
  4. package/dist/src/capabilities/tool-types.d.ts +4 -0
  5. package/dist/src/cli/abot.js +2 -0
  6. package/dist/src/cli/host-companion-bundle.mjs +751 -333
  7. package/dist/src/computer-access/collection-consent.d.ts +9 -0
  8. package/dist/src/computer-access/collection-consent.js +47 -0
  9. package/dist/src/computer-access/command-output-capture.d.ts +17 -6
  10. package/dist/src/computer-access/command-output-capture.js +134 -68
  11. package/dist/src/computer-access/command-output-protection.d.ts +17 -0
  12. package/dist/src/computer-access/command-output-protection.js +59 -0
  13. package/dist/src/computer-access/companion/command-output.d.ts +1 -0
  14. package/dist/src/computer-access/companion/command-output.js +23 -6
  15. package/dist/src/computer-access/companion/install-link-macos.js +2 -1
  16. package/dist/src/computer-access/companion/native-notifications.js +3 -2
  17. package/dist/src/computer-access/companion/native-session.js +6 -2
  18. package/dist/src/computer-access/companion/observation-filter.js +2 -26
  19. package/dist/src/computer-access/companion/observation-process.d.ts +2 -0
  20. package/dist/src/computer-access/companion/observation-process.js +51 -25
  21. package/dist/src/computer-access/companion/observation-redaction.d.ts +2 -7
  22. package/dist/src/computer-access/companion/observation-redaction.js +2 -111
  23. package/dist/src/computer-access/companion/secret-protection-protocol.d.ts +6 -0
  24. package/dist/src/computer-access/companion/secret-protection-protocol.js +6 -0
  25. package/dist/src/computer-access/computer/companion-sessions.js +7 -6
  26. package/dist/src/computer-access/computer/unix-native-process.js +23 -11
  27. package/dist/src/computer-access/handlers.d.ts +2 -1
  28. package/dist/src/computer-access/handlers.js +79 -11
  29. package/dist/src/computer-access/host-observation.d.ts +3 -3
  30. package/dist/src/computer-access/native-observation-connection.d.ts +12 -0
  31. package/dist/src/computer-access/native-observation-connection.js +78 -0
  32. package/dist/src/computer-access/native-observation-ownership.d.ts +6 -0
  33. package/dist/src/computer-access/native-observation-ownership.js +55 -0
  34. package/dist/src/computer-access/native-observation-shutdown.d.ts +7 -0
  35. package/dist/src/computer-access/native-observation-shutdown.js +58 -0
  36. package/dist/src/computer-access/observation-source.d.ts +6 -0
  37. package/dist/src/computer-access/observation-source.js +10 -0
  38. package/dist/src/computer-access/security/desktop-result.d.ts +8 -0
  39. package/dist/src/computer-access/security/desktop-result.js +146 -0
  40. package/dist/src/computer-access/security/observed-error.d.ts +2 -0
  41. package/dist/src/computer-access/security/observed-error.js +10 -0
  42. package/dist/src/computer-access/security/secret-text.d.ts +7 -0
  43. package/dist/src/computer-access/security/secret-text.js +111 -0
  44. package/dist/src/computer-access/security/system-results.d.ts +2 -0
  45. package/dist/src/computer-access/security/system-results.js +53 -0
  46. package/dist/src/computer-access/system-result-protection.d.ts +11 -0
  47. package/dist/src/computer-access/system-result-protection.js +1 -0
  48. package/dist/src/model-gateway/observability/provider-response-capture.d.ts +60 -0
  49. package/dist/src/model-gateway/observability/provider-response-capture.js +68 -0
  50. package/dist/src/model-gateway/observability/provider-response-prefix.d.ts +7 -0
  51. package/dist/src/model-gateway/observability/provider-response-prefix.js +14 -0
  52. package/dist/src/model-gateway/observability/provider-response-tail.d.ts +8 -0
  53. package/dist/src/model-gateway/observability/provider-response-tail.js +28 -0
  54. package/dist/src/model-gateway/observability/provider-sse-diagnostics.d.ts +30 -0
  55. package/dist/src/model-gateway/observability/provider-sse-diagnostics.js +119 -0
  56. package/dist/src/model-gateway/observability/provider-trace.js +30 -8
  57. package/dist/src/model-gateway/protocol/message-contract.d.ts +1 -0
  58. package/dist/src/model-gateway/protocol/message-contract.js +1 -1
  59. package/dist/src/model-gateway/providers/ollama/adapter.js +8 -2
  60. package/dist/src/model-gateway/providers/ollama/stream-normalizer.js +70 -50
  61. package/dist/src/model-gateway/providers/ollama/stream-termination.d.ts +6 -0
  62. package/dist/src/model-gateway/providers/ollama/stream-termination.js +20 -0
  63. package/dist/src/model-gateway/providers/openai/adapter.js +9 -7
  64. package/dist/src/model-gateway/providers/openai/diagnostics.d.ts +0 -1
  65. package/dist/src/model-gateway/providers/openai/diagnostics.js +0 -9
  66. package/dist/src/model-gateway/providers/openai/function-output.d.ts +11 -0
  67. package/dist/src/model-gateway/providers/openai/function-output.js +37 -0
  68. package/dist/src/model-gateway/providers/openai/function-result.d.ts +7 -0
  69. package/dist/src/model-gateway/providers/openai/function-result.js +35 -0
  70. package/dist/src/model-gateway/providers/openai/message-output-policy.d.ts +3 -0
  71. package/dist/src/model-gateway/providers/openai/message-output-policy.js +16 -0
  72. package/dist/src/model-gateway/providers/openai/payload.d.ts +0 -2
  73. package/dist/src/model-gateway/providers/openai/payload.js +6 -23
  74. package/dist/src/model-gateway/providers/openai/response-lifetime.d.ts +2 -0
  75. package/dist/src/model-gateway/providers/openai/response-lifetime.js +64 -0
  76. package/dist/src/model-gateway/providers/openai/sse-data.d.ts +9 -0
  77. package/dist/src/model-gateway/providers/openai/sse-data.js +67 -0
  78. package/dist/src/model-gateway/providers/openai/stream-normalizer.d.ts +10 -22
  79. package/dist/src/model-gateway/providers/openai/stream-normalizer.js +78 -79
  80. package/dist/src/model-gateway/providers/openai/stream.js +13 -41
  81. package/dist/src/model-gateway/providers/openai/structured-message-output.d.ts +42 -0
  82. package/dist/src/model-gateway/providers/openai/structured-message-output.js +175 -0
  83. package/dist/src/model-gateway/server/chat-handler.js +5 -7
  84. package/dist/src/model-gateway/server/chat-stream-response.d.ts +7 -0
  85. package/dist/src/model-gateway/server/chat-stream-response.js +25 -0
  86. package/dist/src/model-gateway/server.js +5 -1
  87. package/dist/src/plugin-contract/index.d.ts +1 -0
  88. package/dist/src/plugin-contract/index.js +1 -0
  89. package/dist/src/plugin-contract/manifest.d.ts +2 -0
  90. package/dist/src/plugin-contract/manifest.js +1 -0
  91. package/dist/src/plugin-contract/platform-compatibility.d.ts +16 -0
  92. package/dist/src/plugin-contract/platform-compatibility.js +3 -0
  93. package/dist/src/plugin-sdk/computer-access.d.ts +4 -0
  94. package/dist/src/plugin-sdk/computer-access.js +1 -0
  95. package/dist/src/plugin-sdk/files-windows/process.d.ts +3 -0
  96. package/dist/src/plugin-sdk/files-windows/process.js +93 -0
  97. package/dist/src/plugin-sdk/files-windows/read-script.d.ts +1 -0
  98. package/dist/src/plugin-sdk/files-windows/read-script.js +43 -0
  99. package/dist/src/plugin-sdk/files-windows/read.d.ts +6 -0
  100. package/dist/src/plugin-sdk/files-windows/read.js +56 -0
  101. package/dist/src/plugin-sdk/files-windows/result.d.ts +4 -0
  102. package/dist/src/plugin-sdk/files-windows/result.js +67 -0
  103. package/dist/src/plugin-sdk/files.js +4 -0
  104. package/dist/src/plugin-sdk/index.d.ts +1 -0
  105. package/dist/src/plugin-sdk/index.js +1 -0
  106. package/dist/src/plugin-sdk/mutation-result.d.ts +7 -0
  107. package/dist/src/plugin-sdk/mutation-result.js +11 -0
  108. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.js +20 -3
  109. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-record.js +3 -1
  110. package/dist/src/runtime/adapters/long-term-memory/file-lock/path-observation.d.ts +3 -0
  111. package/dist/src/runtime/adapters/long-term-memory/file-lock/path-observation.js +20 -0
  112. package/dist/src/runtime/adapters/long-term-memory/file-lock/snapshot.js +7 -3
  113. package/dist/src/runtime/adapters/passive-learning-runtime.d.ts +1 -1
  114. package/dist/src/runtime/adapters/passive-learning-runtime.js +3 -3
  115. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.d.ts +2 -2
  116. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.js +2 -2
  117. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/prepared-execution.js +17 -11
  118. package/dist/src/runtime/adapters/runtime-observation-connection.d.ts +5 -0
  119. package/dist/src/runtime/adapters/runtime-observation-connection.js +13 -0
  120. package/dist/src/runtime/capabilities/tool-availability.js +6 -0
  121. package/dist/src/runtime/context/capability-brief.d.ts +2 -2
  122. package/dist/src/runtime/context/capability-brief.js +3 -3
  123. package/dist/src/runtime/context/capability-descriptions.d.ts +3 -2
  124. package/dist/src/runtime/context/capability-descriptions.js +57 -20
  125. package/dist/src/runtime/local-host/windows-private-access.js +2 -0
  126. package/dist/src/runtime/long-term-memory/conversation-authoring/context.d.ts +6 -1
  127. package/dist/src/runtime/long-term-memory/conversation-authoring/context.js +51 -25
  128. package/dist/src/runtime/long-term-memory/initial-context.d.ts +17 -0
  129. package/dist/src/runtime/long-term-memory/initial-context.js +57 -0
  130. package/dist/src/runtime/long-term-memory/projection.js +1 -1
  131. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +2 -1
  132. package/dist/src/runtime/orchestration/role-calls/checkpoint-state.d.ts +1 -1
  133. package/dist/src/runtime/orchestration/role-calls/checkpoint-state.js +5 -2
  134. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +2 -1
  135. package/dist/src/runtime/orchestration/role-calls/ledger.d.ts +2 -1
  136. package/dist/src/runtime/orchestration/role-calls/ledger.js +2 -2
  137. package/dist/src/runtime/orchestration/role-calls/memory-recall-contract.d.ts +7 -0
  138. package/dist/src/runtime/orchestration/role-calls/memory-recall-state-validation.d.ts +2 -0
  139. package/dist/src/runtime/orchestration/role-calls/memory-recall-state-validation.js +88 -0
  140. package/dist/src/runtime/orchestration/role-calls/reducer.d.ts +1 -1
  141. package/dist/src/runtime/orchestration/role-calls/reducer.js +2 -1
  142. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +3 -1
  143. package/dist/src/runtime/orchestration/worker-capabilities/contracts.js +1 -1
  144. package/dist/src/runtime/orchestration/worker-capabilities/execution/approval-group.js +5 -1
  145. package/dist/src/runtime/orchestration/worker-capabilities/execution/execution-freshness.d.ts +5 -0
  146. package/dist/src/runtime/orchestration/worker-capabilities/execution/execution-freshness.js +31 -0
  147. package/dist/src/runtime/passive-learning/application-catalog.js +3 -1
  148. package/dist/src/runtime/passive-learning/collection-source.js +7 -0
  149. package/dist/src/runtime/passive-learning/service.js +2 -3
  150. package/dist/src/runtime/passive-learning/status-projection.d.ts +2 -0
  151. package/dist/src/runtime/passive-learning/status-projection.js +9 -0
  152. package/dist/src/runtime/plugins/installation/package.d.ts +8 -0
  153. package/dist/src/runtime/plugins/installation/package.js +2 -0
  154. package/dist/src/runtime/plugins/installation/service.d.ts +7 -0
  155. package/dist/src/runtime/plugins/loader.js +24 -14
  156. package/dist/src/runtime/plugins/manifest-platform-compatibility.d.ts +2 -0
  157. package/dist/src/runtime/plugins/manifest-platform-compatibility.js +39 -0
  158. package/dist/src/runtime/plugins/manifest-projection.js +3 -0
  159. package/dist/src/runtime/plugins/manifest-validator.js +9 -1
  160. package/dist/src/runtime/plugins/platform-compatibility.d.ts +4 -0
  161. package/dist/src/runtime/plugins/platform-compatibility.js +44 -0
  162. package/dist/src/runtime/request/approval-wait/activation-events.js +19 -7
  163. package/dist/src/runtime/request/approval-wait/execution-compaction-restore.d.ts +20 -0
  164. package/dist/src/runtime/request/approval-wait/execution-compaction-restore.js +118 -0
  165. package/dist/src/runtime/request/approval-wait/super-compaction-restore.js +2 -1
  166. package/dist/src/runtime/request/capability-execution-freshness.js +6 -1
  167. package/dist/src/runtime/request/execution-agent-root-execution.js +11 -1
  168. package/dist/src/runtime/request/prepared-execution.js +3 -0
  169. package/dist/src/runtime/request/root-contract.d.ts +2 -0
  170. package/dist/src/runtime/request/root-execution-kernel.js +1 -0
  171. package/dist/src/runtime/request/runner.js +9 -3
  172. package/dist/src/runtime/request/supervisor-root-execution.js +6 -0
  173. package/dist/src/runtime/steps/execution-agent/capability-result-context.d.ts +6 -0
  174. package/dist/src/runtime/steps/execution-agent/capability-result-context.js +29 -0
  175. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +10 -0
  176. package/dist/src/runtime/steps/execution-agent/decision-parsing.js +13 -1
  177. package/dist/src/runtime/steps/execution-agent/direct-response-configuration.d.ts +3 -0
  178. package/dist/src/runtime/steps/execution-agent/direct-response-configuration.js +64 -0
  179. package/dist/src/runtime/steps/execution-agent/direct-response-contract.d.ts +7 -0
  180. package/dist/src/runtime/steps/execution-agent/direct-response-contract.js +56 -0
  181. package/dist/src/runtime/steps/execution-agent/direct-response-policy.d.ts +9 -0
  182. package/dist/src/runtime/steps/execution-agent/direct-response-policy.js +30 -0
  183. package/dist/src/runtime/steps/execution-agent/direct-response-prompt.d.ts +7 -0
  184. package/dist/src/runtime/steps/execution-agent/direct-response-prompt.js +43 -0
  185. package/dist/src/runtime/steps/execution-agent/format.js +4 -3
  186. package/dist/src/runtime/steps/execution-agent/input.d.ts +2 -0
  187. package/dist/src/runtime/steps/execution-agent/input.js +22 -1
  188. package/dist/src/runtime/steps/execution-agent/plugin-catalog.d.ts +4 -0
  189. package/dist/src/runtime/steps/execution-agent/plugin-catalog.js +8 -0
  190. package/dist/src/runtime/steps/execution-agent/prompt.d.ts +1 -0
  191. package/dist/src/runtime/steps/execution-agent/prompt.js +7 -8
  192. package/dist/src/runtime/steps/execution-agent/response-prompt.js +1 -0
  193. package/dist/src/runtime/steps/execution-agent/response-run.js +5 -11
  194. package/dist/src/runtime/steps/execution-agent/run.js +4 -1
  195. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +3 -5
  196. package/dist/src/runtime/steps/execution-agent/state-context.js +5 -51
  197. package/dist/src/runtime/steps/execution-agent/work-plan-contract.d.ts +1 -3
  198. package/dist/src/runtime/steps/execution-agent/work-plan-contract.js +0 -55
  199. package/dist/src/runtime/steps/execution-agent/work-plan-schema.d.ts +3 -0
  200. package/dist/src/runtime/steps/execution-agent/work-plan-schema.js +61 -0
  201. package/dist/src/runtime/steps/planner-decision/capability-brief.d.ts +2 -0
  202. package/dist/src/runtime/steps/planner-decision/prompt.js +26 -49
  203. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +1 -0
  204. package/dist/src/runtime/steps/supervisor-decision/input.js +5 -0
  205. package/dist/src/runtime/steps/supervisor-decision/prompt.d.ts +1 -0
  206. package/dist/src/runtime/steps/supervisor-decision/prompt.js +6 -2
  207. package/dist/src/runtime/steps/supervisor-decision/run.d.ts +1 -0
  208. package/dist/src/runtime/steps/supervisor-decision/run.js +4 -0
  209. package/dist/src/runtime/steps/supervisor-response/run.d.ts +2 -0
  210. package/dist/src/runtime/steps/supervisor-response/run.js +3 -6
  211. package/dist/src/sessions/durable-session-commit.js +3 -3
  212. package/dist/src/sessions/prepared-session-replacement.d.ts +6 -0
  213. package/dist/src/sessions/prepared-session-replacement.js +46 -0
  214. package/dist/src/sessions/session-store.js +3 -3
  215. package/dist/src/shared/passive-observation-self-exclusion.d.ts +5 -0
  216. package/dist/src/shared/passive-observation-self-exclusion.js +37 -0
  217. package/dist/src/shared/windows-file-io/authority-script.d.ts +1 -0
  218. package/dist/src/shared/windows-file-io/authority-script.js +94 -0
  219. package/dist/src/shared/windows-file-io/native-script.d.ts +2 -0
  220. package/dist/src/shared/windows-file-io/native-script.js +120 -0
  221. package/dist/src/shared/windows-file-io/read-bytes-script.d.ts +1 -0
  222. package/dist/src/shared/windows-file-io/read-bytes-script.js +18 -0
  223. package/dist/src/shared/windows-job-object.d.ts +2 -0
  224. package/dist/src/shared/windows-job-object.js +66 -0
  225. package/dist/src/web-ui/app/ARCHITECTURE.md +1 -1
  226. package/dist/src/web-ui/app/app-bootstrap.js +14 -1
  227. package/dist/src/web-ui/app/app-state.js +0 -7
  228. package/dist/src/web-ui/app/app.js +54 -156
  229. package/dist/src/web-ui/app/components/automations/node-inspector.js +3 -2
  230. package/dist/src/web-ui/app/components/automations/step-editor-dialog.js +3 -0
  231. package/dist/src/web-ui/app/components/automations/timeline.js +3 -2
  232. package/dist/src/web-ui/app/components/composer-submission-notice.js +50 -0
  233. package/dist/src/web-ui/app/components/config-workspace/model-plugin-permissions.js +7 -1
  234. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +22 -2
  235. package/dist/src/web-ui/app/components/dashboard/compact-layout.js +137 -0
  236. package/dist/src/web-ui/app/components/dashboard/icons.js +5 -0
  237. package/dist/src/web-ui/app/components/dashboard/widget-card.js +85 -0
  238. package/dist/src/web-ui/app/components/dashboard/widget-dialog.js +83 -0
  239. package/dist/src/web-ui/app/components/dashboard/widget-summaries.js +155 -0
  240. package/dist/src/web-ui/app/components/dashboard/workspace.js +28 -4
  241. package/dist/src/web-ui/app/components/home-guidance/daily-review.js +2 -2
  242. package/dist/src/web-ui/app/components/home-guidance/home-guidance.js +20 -6
  243. package/dist/src/web-ui/app/components/model-setup/context-window-feedback.js +53 -0
  244. package/dist/src/web-ui/app/components/model-setup/save-flow.js +3 -1
  245. package/dist/src/web-ui/app/components/model-setup/save-outcome.js +1 -0
  246. package/dist/src/web-ui/app/components/model-setup/wizard.js +12 -0
  247. package/dist/src/web-ui/app/components/operations-summary.js +2 -1
  248. package/dist/src/web-ui/app/components/passive-learning/activity-controls.js +4 -0
  249. package/dist/src/web-ui/app/components/passive-learning/collection-access.js +35 -0
  250. package/dist/src/web-ui/app/components/passive-learning/collection-consent-dialog.js +59 -0
  251. package/dist/src/web-ui/app/components/passive-learning/collection-consent-gate.js +94 -0
  252. package/dist/src/web-ui/app/components/passive-learning/computer-update-notice.js +6 -0
  253. package/dist/src/web-ui/app/components/passive-learning/failure-copy.js +1 -0
  254. package/dist/src/web-ui/app/components/passive-learning/home-widget-preview.js +32 -0
  255. package/dist/src/web-ui/app/components/passive-learning/home.js +11 -3
  256. package/dist/src/web-ui/app/components/passive-learning/macos-collection-restart-notice.js +1 -0
  257. package/dist/src/web-ui/app/components/passive-learning/memory.js +2 -4
  258. package/dist/src/web-ui/app/components/passive-learning/workspace-view.js +2 -2
  259. package/dist/src/web-ui/app/components/plugins/compatibility.js +13 -0
  260. package/dist/src/web-ui/app/components/plugins/discovery-rendering.js +9 -1
  261. package/dist/src/web-ui/app/components/plugins/installation-compatibility.js +7 -0
  262. package/dist/src/web-ui/app/components/plugins/installation.js +2 -1
  263. package/dist/src/web-ui/app/components/plugins/rendering.js +3 -0
  264. package/dist/src/web-ui/app/components/reasoning-override-prompt.js +82 -0
  265. package/dist/src/web-ui/app/components/runtime-config-activation.js +22 -8
  266. package/dist/src/web-ui/app/components/runtime-setup/optional-steps.js +7 -4
  267. package/dist/src/web-ui/app/components/runtime-setup/plugins.js +3 -1
  268. package/dist/src/web-ui/app/components/runtime-setup/rendering.js +6 -4
  269. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +1 -0
  270. package/dist/src/web-ui/app/components/schedules/details.js +3 -2
  271. package/dist/src/web-ui/app/components/schedules/form.js +10 -8
  272. package/dist/src/web-ui/app/components/schedules/workspace.js +23 -4
  273. package/dist/src/web-ui/app/components/session-sidebar-sections.js +2 -2
  274. package/dist/src/web-ui/app/components/spark-chat/handoff-actions.js +9 -3
  275. package/dist/src/web-ui/app/components/spark-chat/panel.js +1 -1
  276. package/dist/src/web-ui/app/components/spark-chat/placement.js +4 -7
  277. package/dist/src/web-ui/app/components/spark-chat/settings.js +8 -4
  278. package/dist/src/web-ui/app/components/system-host/home-widget-permission-preview.js +75 -0
  279. package/dist/src/web-ui/app/components/system-host/home-widget-summary.js +93 -0
  280. package/dist/src/web-ui/app/components/system-host/macos-permission-rendering.js +2 -2
  281. package/dist/src/web-ui/app/components/system-host/macos-permissions.js +2 -0
  282. package/dist/src/web-ui/app/components/system-host/native-windows-access.js +50 -0
  283. package/dist/src/web-ui/app/components/system-host/rendering.js +6 -3
  284. package/dist/src/web-ui/app/components/system-host/windows-store-setup.js +2 -2
  285. package/dist/src/web-ui/app/components/workspace-storage-notice.js +37 -0
  286. package/dist/src/web-ui/app/computer-access-feature.js +13 -1
  287. package/dist/src/web-ui/app/configuration-environment-refresh.js +27 -34
  288. package/dist/src/web-ui/app/configuration-feature.js +11 -1
  289. package/dist/src/web-ui/app/controllers/app-event-bindings.js +38 -105
  290. package/dist/src/web-ui/app/controllers/chat-request-controller.d.ts +28 -0
  291. package/dist/src/web-ui/app/controllers/chat-request-controller.js +34 -66
  292. package/dist/src/web-ui/app/controllers/composer-attachments-controller.d.ts +15 -40
  293. package/dist/src/web-ui/app/controllers/composer-attachments-controller.js +26 -69
  294. package/dist/src/web-ui/app/controllers/composer-draft-view.d.ts +27 -0
  295. package/dist/src/web-ui/app/controllers/composer-draft-view.js +48 -0
  296. package/dist/src/web-ui/app/controllers/composer-drafts.d.ts +55 -0
  297. package/dist/src/web-ui/app/controllers/composer-drafts.js +120 -0
  298. package/dist/src/web-ui/app/controllers/composer-feature.d.ts +65 -0
  299. package/dist/src/web-ui/app/controllers/composer-feature.js +124 -0
  300. package/dist/src/web-ui/app/controllers/composer-queue-controller.d.ts +33 -94
  301. package/dist/src/web-ui/app/controllers/composer-queue-controller.js +185 -251
  302. package/dist/src/web-ui/app/controllers/composer-submission-lifecycle.d.ts +48 -0
  303. package/dist/src/web-ui/app/controllers/composer-submission-lifecycle.js +97 -0
  304. package/dist/src/web-ui/app/controllers/composer-submit-controller.d.ts +30 -61
  305. package/dist/src/web-ui/app/controllers/composer-submit-controller.js +56 -138
  306. package/dist/src/web-ui/app/controllers/composer-surface-controller.js +6 -0
  307. package/dist/src/web-ui/app/controllers/composer-workspace-controller.d.ts +22 -40
  308. package/dist/src/web-ui/app/controllers/composer-workspace-controller.js +49 -165
  309. package/dist/src/web-ui/app/controllers/conversation-navigation-intent.js +15 -0
  310. package/dist/src/web-ui/app/controllers/conversation-request-hydration.js +20 -17
  311. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +1 -2
  312. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +49 -22
  313. package/dist/src/web-ui/app/controllers/conversation-workspace-activation.js +27 -0
  314. package/dist/src/web-ui/app/controllers/daily-memory-review.js +15 -16
  315. package/dist/src/web-ui/app/controllers/environment-transition.js +126 -0
  316. package/dist/src/web-ui/app/controllers/environment-workspace-preparation.js +18 -0
  317. package/dist/src/web-ui/app/controllers/home-composer-feature.d.ts +14 -36
  318. package/dist/src/web-ui/app/controllers/home-composer-feature.js +17 -114
  319. package/dist/src/web-ui/app/controllers/home-conversation-activation.js +6 -8
  320. package/dist/src/web-ui/app/controllers/operations-controller.js +2 -1
  321. package/dist/src/web-ui/app/controllers/passive-learning-controller.js +56 -0
  322. package/dist/src/web-ui/app/controllers/projects-controller.d.ts +1 -1
  323. package/dist/src/web-ui/app/controllers/projects-controller.js +6 -1
  324. package/dist/src/web-ui/app/controllers/reasoning-mode-controller.js +174 -0
  325. package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts +7 -0
  326. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +20 -155
  327. package/dist/src/web-ui/app/controllers/session-controller.js +33 -17
  328. package/dist/src/web-ui/app/controllers/session-pin-updates.js +14 -0
  329. package/dist/src/web-ui/app/controllers/session-sidebar-controller.js +12 -14
  330. package/dist/src/web-ui/app/controllers/spark-chat-sync.js +2 -2
  331. package/dist/src/web-ui/app/controllers/steer-controller.js +9 -7
  332. package/dist/src/web-ui/app/controllers/tool-permission-mode-controller.js +1 -1
  333. package/dist/src/web-ui/app/controllers/workspace-conversation-opener.js +34 -0
  334. package/dist/src/web-ui/app/dashboard-feature.js +12 -2
  335. package/dist/src/web-ui/app/lib/reasoning-controls.js +40 -0
  336. package/dist/src/web-ui/app/lib/session-composer-queue-ownership.js +58 -0
  337. package/dist/src/web-ui/app/lib/session-composer-queue.d.ts +12 -0
  338. package/dist/src/web-ui/app/lib/session-composer-queue.js +25 -6
  339. package/dist/src/web-ui/app/passive-learning-feature.js +18 -5
  340. package/dist/src/web-ui/app/schedules-feature.js +5 -3
  341. package/dist/src/web-ui/app/services/client-preferences.d.ts +18 -10
  342. package/dist/src/web-ui/app/services/client-preferences.js +25 -16
  343. package/dist/src/web-ui/app/services/home-guidance-preferences.js +13 -13
  344. package/dist/src/web-ui/app/services/reasoning-override.js +12 -0
  345. package/dist/src/web-ui/app/services/runtime-web-client/automations.js +10 -2
  346. package/dist/src/web-ui/app/services/runtime-web-client/memory.js +7 -2
  347. package/dist/src/web-ui/app/services/runtime-web-client/system-host.js +2 -0
  348. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +2 -0
  349. package/dist/src/web-ui/app/services/runtime-web-client.js +2 -0
  350. package/dist/src/web-ui/app/services/server-composer-queue.js +32 -0
  351. package/dist/src/web-ui/app/services/session-sidebar-preferences.js +5 -5
  352. package/dist/src/web-ui/app/services/workspace-state-storage.js +116 -0
  353. package/dist/src/web-ui/app/services/workspace-state.js +27 -0
  354. package/dist/src/web-ui/app/spark-chat-conversation.js +34 -45
  355. package/dist/src/web-ui/app/spark-chat-feature.js +10 -4
  356. package/dist/src/web-ui/app/styles/21-composer-controls.css +16 -0
  357. package/dist/src/web-ui/app/styles/41-plugin-management.css +8 -0
  358. package/dist/src/web-ui/app/styles/42-model-plugin-permissions.css +1 -0
  359. package/dist/src/web-ui/app/styles/49-collection-consent.css +30 -0
  360. package/dist/src/web-ui/app/styles/64-workspace-storage.css +23 -0
  361. package/dist/src/web-ui/app/styles/95-home-widgets.css +109 -0
  362. package/dist/src/web-ui/app/styles.css +3 -0
  363. package/dist/src/web-ui/client-state/contracts.d.ts +15 -0
  364. package/dist/src/web-ui/client-state/contracts.js +13 -0
  365. package/dist/src/web-ui/client-state/preference-shapes.d.ts +2 -0
  366. package/dist/src/web-ui/client-state/preference-shapes.js +80 -0
  367. package/dist/src/web-ui/client-state/preferences.d.ts +3 -0
  368. package/dist/src/web-ui/client-state/preferences.js +84 -0
  369. package/dist/src/web-ui/client-state/queue.d.ts +3 -0
  370. package/dist/src/web-ui/client-state/queue.js +43 -0
  371. package/dist/src/web-ui/client-state/routes.d.ts +7 -0
  372. package/dist/src/web-ui/client-state/routes.js +58 -0
  373. package/dist/src/web-ui/client-state/store.d.ts +14 -0
  374. package/dist/src/web-ui/client-state/store.js +88 -0
  375. package/dist/src/web-ui/local-runtime/configuration-activation-source.js +2 -0
  376. package/dist/src/web-ui/local-runtime/http.js +11 -2
  377. package/dist/src/web-ui/local-runtime/model-context-capacity-error.d.ts +14 -0
  378. package/dist/src/web-ui/local-runtime/model-context-capacity-error.js +28 -0
  379. package/dist/src/web-ui/local-runtime/model-setup-context-window.d.ts +15 -0
  380. package/dist/src/web-ui/local-runtime/model-setup-context-window.js +25 -0
  381. package/dist/src/web-ui/local-runtime/model-setup-routes.js +2 -0
  382. package/dist/src/web-ui/local-runtime/model-setup-service.js +5 -2
  383. package/dist/src/web-ui/local-runtime/model-setup-validation.d.ts +1 -0
  384. package/dist/src/web-ui/local-runtime/model-setup-validation.js +14 -7
  385. package/dist/src/web-ui/local-runtime/request-body-error.d.ts +11 -0
  386. package/dist/src/web-ui/local-runtime/request-body-error.js +14 -0
  387. package/dist/src/web-ui/local-runtime/request-control-observation.js +2 -2
  388. package/dist/src/web-ui/local-runtime/request-execution.js +18 -18
  389. package/dist/src/web-ui/local-runtime/runtime-setup-connection-edit.d.ts +2 -0
  390. package/dist/src/web-ui/local-runtime/runtime-setup-connection-edit.js +35 -22
  391. package/dist/src/web-ui/local-runtime/runtime-setup-context-window.d.ts +2 -9
  392. package/dist/src/web-ui/local-runtime/runtime-setup-context-window.js +4 -27
  393. package/dist/src/web-ui/local-runtime/runtime-setup-credentials.d.ts +15 -1
  394. package/dist/src/web-ui/local-runtime/runtime-setup-credentials.js +30 -11
  395. package/dist/src/web-ui/local-runtime/runtime-setup-edit-files.d.ts +20 -0
  396. package/dist/src/web-ui/local-runtime/runtime-setup-edit-files.js +104 -0
  397. package/dist/src/web-ui/local-runtime/runtime-setup-edit-journal.d.ts +29 -0
  398. package/dist/src/web-ui/local-runtime/runtime-setup-edit-journal.js +151 -0
  399. package/dist/src/web-ui/local-runtime/runtime-setup-edit-recovery.d.ts +7 -0
  400. package/dist/src/web-ui/local-runtime/runtime-setup-edit-recovery.js +87 -0
  401. package/dist/src/web-ui/local-runtime/runtime-setup-edit-transaction.d.ts +3 -0
  402. package/dist/src/web-ui/local-runtime/runtime-setup-edit-transaction.js +37 -0
  403. package/dist/src/web-ui/local-runtime/runtime-setup-service.js +4 -0
  404. package/dist/src/web-ui/local-runtime-backend.js +14 -0
  405. package/dist/src/web-ui/plugin-management-catalog.d.ts +3 -1
  406. package/dist/src/web-ui/plugin-management-catalog.js +3 -1
  407. package/dist/src/web-ui/plugin-management-service.d.ts +1 -0
  408. package/dist/src/web-ui/plugin-removal-service.d.ts +1 -0
  409. package/dist/src/web-ui/server-readiness.d.ts +3 -0
  410. package/dist/src/web-ui/server-readiness.js +36 -0
  411. package/dist/src/web-ui/server.d.ts +2 -0
  412. package/dist/src/web-ui/server.js +23 -1
  413. package/dist/src/web-ui/system-host-service.js +13 -2
  414. package/dist/src/web-ui/system-host-setup/collection-consent-route.d.ts +3 -0
  415. package/dist/src/web-ui/system-host-setup/collection-consent-route.js +30 -0
  416. package/docs/installation.md +44 -5
  417. package/docs/plugins.md +174 -28
  418. package/docs/tool-execution-result-evidence-contract.md +57 -0
  419. package/docs/windows-companion-store.md +5 -0
  420. package/package.json +4 -2
  421. package/plugins/capability-brief/plugin.json +5 -1
  422. package/plugins/code-outline/README.md +20 -0
  423. package/plugins/code-outline/plugin.json +2 -1
  424. package/plugins/code-outline/source/index.ts +16 -20
  425. package/plugins/code-outline/source/read-failure.ts +40 -0
  426. package/plugins/code-outline/src/index.cjs +614 -29
  427. package/plugins/document-reader/README.md +33 -0
  428. package/plugins/document-reader/plugin.json +2 -1
  429. package/plugins/document-reader/source/pdf-contract.ts +57 -0
  430. package/plugins/document-reader/source/pdf-parser.ts +139 -0
  431. package/plugins/document-reader/source/pdf-process-main.ts +56 -0
  432. package/plugins/document-reader/source/pdf-process.ts +207 -0
  433. package/plugins/document-reader/source/pdf-result.ts +79 -0
  434. package/plugins/document-reader/source/pdf-worker.ts +39 -303
  435. package/plugins/document-reader/source/pdf.ts +4 -1
  436. package/plugins/document-reader/source/read-failure.ts +37 -0
  437. package/plugins/document-reader/source/reader.ts +3 -19
  438. package/plugins/document-reader/src/index.cjs +995 -211
  439. package/plugins/exec/README.md +19 -0
  440. package/plugins/exec/plugin.json +4 -3
  441. package/plugins/exec/skills/exec_skill/SKILL.md +3 -2
  442. package/plugins/exec/source/filesystem-file-observer.ts +98 -0
  443. package/plugins/exec/source/filesystem-observer.ts +8 -79
  444. package/plugins/exec/source/output-files.ts +12 -6
  445. package/plugins/exec/source/paths.ts +3 -1
  446. package/plugins/exec/source/process-manager.ts +8 -24
  447. package/plugins/exec/source/shell-platform.ts +19 -3
  448. package/plugins/exec/source/shell-process.ts +55 -0
  449. package/plugins/exec/source/windows-job-source.ts +1 -0
  450. package/plugins/exec/source/windows-shell-bootstrap.ts +20 -0
  451. package/plugins/exec/src/index.cjs +252 -96
  452. package/plugins/filesystem/README.md +65 -0
  453. package/plugins/filesystem/plugin.json +7 -3
  454. package/plugins/filesystem/source/atomic-write.ts +2 -0
  455. package/plugins/filesystem/source/bounded-io.ts +80 -306
  456. package/plugins/filesystem/source/directory-sample.ts +2 -0
  457. package/plugins/filesystem/source/errors.ts +14 -0
  458. package/plugins/filesystem/source/file-observation.ts +151 -0
  459. package/plugins/filesystem/source/file-version.ts +41 -0
  460. package/plugins/filesystem/source/index.ts +6 -0
  461. package/plugins/filesystem/source/mutation-coordinator.ts +1 -0
  462. package/plugins/filesystem/source/windows/authority-script.ts +1 -0
  463. package/plugins/filesystem/source/windows/native-script.ts +1 -0
  464. package/plugins/filesystem/source/windows/operations.ts +197 -0
  465. package/plugins/filesystem/source/windows/process.ts +214 -0
  466. package/plugins/filesystem/source/windows/publication-script.ts +29 -0
  467. package/plugins/filesystem/source/windows/read-script.ts +63 -0
  468. package/plugins/filesystem/source/windows/request-availability.ts +67 -0
  469. package/plugins/filesystem/source/windows/source.ts +42 -0
  470. package/plugins/filesystem/source/windows/storage-script.ts +11 -0
  471. package/plugins/filesystem/source/windows/streams-script.ts +24 -0
  472. package/plugins/filesystem/source/windows/write-script.ts +86 -0
  473. package/plugins/filesystem/src/index.cjs +1208 -322
  474. package/plugins/json-inspector/README.md +18 -0
  475. package/plugins/json-inspector/plugin.json +2 -1
  476. package/plugins/json-inspector/source/index.ts +16 -19
  477. package/plugins/json-inspector/source/read-failure.ts +42 -0
  478. package/plugins/json-inspector/src/index.cjs +612 -27
  479. package/plugins/local-search/README.md +29 -0
  480. package/plugins/local-search/plugin.json +2 -1
  481. package/plugins/local-search/source/errors.ts +2 -0
  482. package/plugins/local-search/source/paths.ts +3 -0
  483. package/plugins/local-search/source/ripgrep-process.ts +31 -5
  484. package/plugins/local-search/source/ripgrep.ts +3 -3
  485. package/plugins/local-search/source/windows-authority.ts +99 -0
  486. package/plugins/local-search/source/windows-search-lease.ts +49 -0
  487. package/plugins/local-search/source/windows-search-process.ts +91 -0
  488. package/plugins/local-search/source/windows-search-script.ts +52 -0
  489. package/plugins/local-search/src/index.cjs +595 -26
  490. package/plugins/memory/plugin.json +5 -1
  491. package/plugins/memory/source/lock-directory-claim.ts +56 -0
  492. package/plugins/memory/source/lock-owner-file.ts +71 -0
  493. package/plugins/memory/source/lock-path-observation.ts +26 -0
  494. package/plugins/memory/source/prepared-memory-replacement.ts +40 -0
  495. package/plugins/memory/source/store-lock.ts +12 -7
  496. package/plugins/memory/source/store.ts +3 -2
  497. package/plugins/memory/src/index.cjs +174 -25
  498. package/plugins/project-orientation/README.md +23 -0
  499. package/plugins/project-orientation/plugin.json +2 -1
  500. package/plugins/project-orientation/source/index.ts +12 -9
  501. package/plugins/project-orientation/source/inspection-failure.ts +70 -0
  502. package/plugins/project-orientation/source/manifest-summary.ts +9 -2
  503. package/plugins/project-orientation/source/tree.ts +6 -0
  504. package/plugins/project-orientation/src/index.cjs +647 -31
  505. package/plugins/system/README.md +51 -15
  506. package/plugins/system/plugin.json +6 -2
  507. package/plugins/system/skills/system_actions/SKILL.md +1 -1
  508. package/plugins/system/source/command-working-directory.ts +47 -0
  509. package/plugins/system/source/computer/handlers.ts +13 -9
  510. package/plugins/system/source/computer/observation-result.ts +10 -5
  511. package/plugins/system/source/computer/request-computers.ts +10 -3
  512. package/plugins/system/source/computer/request-modules.ts +3 -6
  513. package/plugins/system/source/computer/runtime-platform.ts +18 -0
  514. package/plugins/system/source/host-dispatch.ts +18 -2
  515. package/plugins/system/source/index.ts +5 -3
  516. package/plugins/system/source/local-command-output-retention.ts +16 -0
  517. package/plugins/system/source/local-command-output.ts +16 -8
  518. package/plugins/system/source/request-system-modules.ts +12 -2
  519. package/plugins/system/source/request-target-snapshot.ts +2 -1
  520. package/plugins/system/source/security/desktop-result.ts +177 -0
  521. package/plugins/system/source/security/observed-error.ts +10 -0
  522. package/plugins/system/source/security/secret-text.ts +118 -0
  523. package/plugins/system/source/security/system-results.ts +62 -0
  524. package/plugins/system/source/security/windows-output-directory.ts +82 -0
  525. package/plugins/system/src/index.cjs +837 -151
  526. package/plugins/system-probe/plugin.json +9 -3
  527. package/plugins/system-probe/source/disk-path.ts +8 -0
  528. package/plugins/system-probe/source/index.ts +10 -5
  529. package/plugins/system-probe/source/machine-load.ts +33 -0
  530. package/plugins/system-probe/source/metrics.ts +6 -8
  531. package/plugins/system-probe/src/index.cjs +49 -16
  532. package/plugins/web/plugin.json +5 -1
@@ -0,0 +1,48 @@
1
+ /** Binds a textarea to one draft handle; changing the view never disposes a draft. */
2
+ export function createComposerDraftView({ input, getDraft, isVisible = () => true }) {
3
+ let displayed = null;
4
+ const parkedStyle = { height: "" };
5
+
6
+ function saveDisplayed() {
7
+ if (displayed) displayed.text = input.value;
8
+ }
9
+
10
+ function display() {
11
+ const next = getDraft();
12
+ if (next !== displayed) {
13
+ saveDisplayed();
14
+ displayed = next;
15
+ input.value = next.text;
16
+ }
17
+ return next;
18
+ }
19
+
20
+ function current() {
21
+ const draft = getDraft();
22
+ if (displayed === draft) draft.text = input.value;
23
+ return draft;
24
+ }
25
+
26
+ const surface = {
27
+ get value() { return current().text; },
28
+ set value(value) {
29
+ const draft = getDraft();
30
+ draft.text = value;
31
+ if (displayed === draft) input.value = draft.text;
32
+ },
33
+ get style() { return isVisible() ? input.style : parkedStyle; },
34
+ get scrollHeight() { return isVisible() ? input.scrollHeight : 0; },
35
+ focus() { if (isVisible()) input.focus(); },
36
+ };
37
+
38
+ input.addEventListener?.("input", saveDisplayed);
39
+
40
+ return {
41
+ surface, current, display, saveDisplayed,
42
+ refresh(draft) {
43
+ if (displayed !== draft) return;
44
+ input.value = draft.text;
45
+ },
46
+ detach() { saveDisplayed(); displayed = null; },
47
+ };
48
+ }
@@ -0,0 +1,55 @@
1
+ import type {
2
+ ReleasedSessionComposerQueueItem,
3
+ SessionComposerAttachmentRef,
4
+ SessionComposerQueueScope,
5
+ } from "../lib/session-composer-queue.js";
6
+
7
+ export type ComposerScope = Readonly<SessionComposerQueueScope>;
8
+ export type ComposerAttachment = SessionComposerAttachmentRef & {
9
+ id?: string;
10
+ kind?: string;
11
+ name?: string;
12
+ mimeType?: string;
13
+ sessionId?: string;
14
+ storageRef?: string;
15
+ environment?: string;
16
+ };
17
+
18
+ export interface ComposerDraftSnapshot {
19
+ readonly scope: ComposerScope;
20
+ readonly text: string;
21
+ readonly attachments: readonly ComposerAttachment[];
22
+ readonly release: ReleasedSessionComposerQueueItem | null;
23
+ }
24
+
25
+ /** Mutable editing handle owned by the window-lifetime draft registry. */
26
+ export interface ComposerDraft {
27
+ readonly scope: ComposerScope;
28
+ text: string;
29
+ attachments: ComposerAttachment[];
30
+ readonly revision: number;
31
+ readonly generation: number;
32
+ readonly release: ReleasedSessionComposerQueueItem | null;
33
+ readonly uploading: number;
34
+ isEmpty(): boolean;
35
+ setRelease(release: ReleasedSessionComposerQueueItem | null): void;
36
+ startUpload(): number;
37
+ finishUpload(generation: number): void;
38
+ acceptUpload(generation: number, attachment: ComposerAttachment): boolean;
39
+ snapshot(): ComposerDraftSnapshot;
40
+ take(): ComposerDraftSnapshot;
41
+ restore(snapshot: ComposerDraftSnapshot): void;
42
+ clearAttachments(): ComposerAttachment[];
43
+ contains(attachment: ComposerAttachment): boolean;
44
+ }
45
+
46
+ export interface ComposerDrafts {
47
+ clearAttachments(scope: ComposerScope): ComposerAttachment[];
48
+ open(scope: ComposerScope): ComposerDraft;
49
+ restore(snapshot: ComposerDraftSnapshot): void;
50
+ assignSession(draft: ComposerDraft, sessionId: string): ComposerDraft;
51
+ contains(attachment: ComposerAttachment): boolean;
52
+ subscribe(listener: (draft: ComposerDraft) => void): () => boolean;
53
+ }
54
+
55
+ export declare function createComposerDrafts(): ComposerDrafts;
@@ -0,0 +1,120 @@
1
+ function scopeKey(scope) {
2
+ return JSON.stringify([scope.environmentId, scope.sessionId]);
3
+ }
4
+
5
+ function attachmentKey(attachment) {
6
+ return JSON.stringify([attachment.environment, attachment.sessionId, attachment.storageRef, attachment.id]);
7
+ }
8
+
9
+ function combineAttachments(previous, current) {
10
+ const files = new Map();
11
+ for (const file of [...previous, ...current]) files.set(attachmentKey(file), file);
12
+ return [...files.values()];
13
+ }
14
+
15
+ /** Window-lifetime drafts. DOM, navigation and requests borrow handles, not copies. */
16
+ export function createComposerDrafts() {
17
+ const records = new Map();
18
+ const listeners = new Set();
19
+
20
+ function notify(draft) {
21
+ for (const listener of listeners) listener(draft);
22
+ }
23
+
24
+ function open(scope) {
25
+ const key = scopeKey(scope);
26
+ const existing = records.get(key);
27
+ if (existing) return existing;
28
+ const identity = Object.freeze({ ...scope });
29
+ let text = "";
30
+ let files = [];
31
+ let revision = 0;
32
+ let generation = 0;
33
+ let queueRelease = null;
34
+ const uploads = new Map();
35
+ const changed = () => { revision += 1; notify(draft); };
36
+ const draft = {
37
+ scope: identity,
38
+ get text() { return text; },
39
+ set text(value) {
40
+ const next = String(value);
41
+ if (text === next) return;
42
+ text = next; changed();
43
+ },
44
+ get attachments() { return [...files]; },
45
+ set attachments(value) { files = [...value]; changed(); },
46
+ get revision() { return revision; },
47
+ get generation() { return generation; },
48
+ get release() { return queueRelease; },
49
+ get uploading() { return uploads.get(generation) || 0; },
50
+ isEmpty() { return !text && files.length === 0 && !queueRelease; },
51
+ setRelease(release) { queueRelease = release; changed(); },
52
+ startUpload() {
53
+ const captured = generation;
54
+ uploads.set(captured, (uploads.get(captured) || 0) + 1);
55
+ notify(draft);
56
+ return captured;
57
+ },
58
+ finishUpload(captured) {
59
+ const count = (uploads.get(captured) || 0) - 1;
60
+ if (count <= 0) uploads.delete(captured);
61
+ else uploads.set(captured, count);
62
+ notify(draft);
63
+ },
64
+ acceptUpload(captured, attachment) {
65
+ if (captured !== generation) return false;
66
+ files = combineAttachments(files, [attachment]);
67
+ changed();
68
+ return true;
69
+ },
70
+ snapshot() {
71
+ return Object.freeze({ scope: identity, text, attachments: Object.freeze([...files]), release: queueRelease });
72
+ },
73
+ take() {
74
+ const captured = draft.snapshot();
75
+ text = "";
76
+ files = [];
77
+ queueRelease = null;
78
+ generation += 1;
79
+ changed();
80
+ return captured;
81
+ },
82
+ restore(captured) {
83
+ if (scopeKey(captured.scope) !== key) throw new Error("Cannot restore a draft into a different conversation.");
84
+ if (captured.release && queueRelease && captured.release.releaseToken !== queueRelease.releaseToken)
85
+ throw new Error("Another queued message already owns this draft.");
86
+ text = text ? `${captured.text}\n${text}` : captured.text;
87
+ files = combineAttachments(captured.attachments, files);
88
+ queueRelease = captured.release ?? queueRelease;
89
+ changed();
90
+ },
91
+ clearAttachments() {
92
+ const removed = files;
93
+ files = [];
94
+ generation += 1;
95
+ changed();
96
+ return removed;
97
+ },
98
+ contains(attachment) { return files.some((file) => attachmentKey(file) === attachmentKey(attachment)); },
99
+ };
100
+ records.set(key, draft);
101
+ return draft;
102
+ }
103
+
104
+ return {
105
+ open,
106
+ restore: (captured) => open(captured.scope).restore(captured),
107
+ clearAttachments: (scope) => records.get(scopeKey(scope))?.clearAttachments() ?? [],
108
+ assignSession(draft, sessionId) {
109
+ if (draft.scope.sessionId) return draft;
110
+ if (draft.uploading) throw new Error("Cannot assign a conversation while a file is uploading.");
111
+ const target = open({ ...draft.scope, sessionId });
112
+ const captured = draft.take();
113
+ target.restore({ ...captured, scope: target.scope });
114
+ records.delete(scopeKey(draft.scope));
115
+ return target;
116
+ },
117
+ contains: (attachment) => [...records.values()].some((draft) => draft.contains(attachment)),
118
+ subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener); },
119
+ };
120
+ }
@@ -0,0 +1,65 @@
1
+ import type { SessionComposerQueue, RemoteSessionComposerQueue } from "../lib/session-composer-queue.js";
2
+ import type { ComposerAttachmentsClient, ComposerAttachmentsController, ComposerAttachmentsDom, ComposerAttachmentsShell } from "./composer-attachments-controller.js";
3
+ import type { ChatRequestController, ComposerChatClient, ComposerChatSession } from "./chat-request-controller.js";
4
+ import type { ComposerDraft, ComposerDraftSnapshot, ComposerDrafts, ComposerScope } from "./composer-drafts.js";
5
+ import type { ComposerQueueController } from "./composer-queue-controller.js";
6
+ import type { ComposerSubmissionLifecycle, ComposerSubmissionSettings } from "./composer-submission-lifecycle.js";
7
+ import type { createRealtimeEventController } from "./realtime-event-controller.js";
8
+ import type { ComposerSubmissionBlock, ComposerSubmitActions, ComposerSubmitController, ComposerSubmitDom, ComposerSubmitState } from "./composer-submit-controller.js";
9
+
10
+ export interface ComposerSurfaceDom extends ComposerSubmitDom, ComposerAttachmentsDom {
11
+ composerForm?: HTMLElement;
12
+ }
13
+ export interface ComposerSurfaceOptions {
14
+ surfaceDom: ComposerSurfaceDom;
15
+ currentDraft(): ComposerDraft;
16
+ ensureDraftSession(): string;
17
+ visible(): boolean;
18
+ supportsImages(): boolean;
19
+ available?(): boolean;
20
+ prepareSend?(payload: ComposerDraftSnapshot): boolean | void | Promise<boolean | void>;
21
+ allowsActiveRequest?: boolean;
22
+ }
23
+ export interface ComposerSurface {
24
+ attachments: ComposerAttachmentsController;
25
+ submit: ComposerSubmitController;
26
+ render(): void;
27
+ displays(scope: ComposerScope): boolean;
28
+ }
29
+ export interface ComposerFeatureOptions {
30
+ state: ComposerSubmitState;
31
+ dom: ComposerSurfaceDom;
32
+ shell: ComposerAttachmentsShell;
33
+ client: ComposerChatClient & ComposerAttachmentsClient;
34
+ sessionQueue: SessionComposerQueue | RemoteSessionComposerQueue;
35
+ conversationSession: ComposerChatSession;
36
+ conversationView: { reset(): void };
37
+ getEnvironmentId(): string;
38
+ getDraft(): ComposerDraft;
39
+ ensureSession(): string;
40
+ getSettings(): ComposerSubmissionSettings;
41
+ steer(text: string, options: { scope: ComposerScope & { requestId: string }; pendingAttachmentCount: number }): Promise<void>;
42
+ composerActions: ComposerSubmitActions;
43
+ selectedModelSupportsImageInput(): boolean;
44
+ isComposerAvailable?(): boolean;
45
+ getSubmissionBlock?(): ComposerSubmissionBlock | null;
46
+ onSubmissionBlocked?(block: ComposerSubmissionBlock): void;
47
+ isVisible?(): boolean;
48
+ renderSessions(): void;
49
+ renderMessages(): void;
50
+ applyConversationChrome(): void;
51
+ setMessageStatus(message: string, busy?: boolean): void;
52
+ recordControlEvent: ReturnType<typeof createRealtimeEventController>["recordControlEvent"];
53
+ drafts?: ComposerDrafts;
54
+ onChange?(): void;
55
+ confirmReview?(message: string): boolean;
56
+ }
57
+ export interface ComposerFeature extends ComposerSurface {
58
+ queue: ComposerQueueController;
59
+ requests: ChatRequestController;
60
+ drafts: ComposerDrafts;
61
+ lifecycle: ComposerSubmissionLifecycle;
62
+ createSurface(options: ComposerSurfaceOptions): ComposerSurface;
63
+ changed(): void;
64
+ }
65
+ export declare function createComposerFeature(options: ComposerFeatureOptions): ComposerFeature;
@@ -0,0 +1,124 @@
1
+ import { createComposerDrafts } from "./composer-drafts.js";
2
+ import { createComposerSubmissionLifecycle, ComposerSubmissionRefused } from "./composer-submission-lifecycle.js";
3
+ import { createComposerAttachmentsController } from "./composer-attachments-controller.js";
4
+ import { createComposerQueueController } from "./composer-queue-controller.js";
5
+ import { createComposerSubmitController } from "./composer-submit-controller.js";
6
+ import { createChatRequestController } from "./chat-request-controller.js";
7
+ import { createComposerSubmissionNotice } from "../components/composer-submission-notice.js";
8
+
9
+ /** Production composition reused by Chat/Home and the SPARK popup, and integration tests. */
10
+ export function createComposerFeature({
11
+ state, dom, shell, client, sessionQueue, conversationSession, conversationView,
12
+ getEnvironmentId, getDraft, ensureSession, getSettings, steer,
13
+ composerActions, selectedModelSupportsImageInput, isComposerAvailable,
14
+ getSubmissionBlock, onSubmissionBlocked, isVisible = () => true,
15
+ renderSessions, renderMessages, applyConversationChrome, setMessageStatus, recordControlEvent,
16
+ drafts = createComposerDrafts(), onChange = () => {},
17
+ confirmReview = (message) => globalThis.confirm?.(message) === true,
18
+ }) {
19
+ const surfaces = [];
20
+ let queue;
21
+ const isCurrentScope = (scope) => getEnvironmentId() === scope.environmentId && state.currentSessionId === scope.sessionId;
22
+ function reportStatus(scope, message, tone) {
23
+ const hasVisibleDraft = surfaces.some((surface) => surface.displays(scope));
24
+ if (!isCurrentScope(scope) && !hasVisibleDraft) return;
25
+ setMessageStatus(message);
26
+ recordControlEvent({ type: "control", name: "Composer message paused", tone, summary: message });
27
+ }
28
+ const reportFailure = (scope, message) => reportStatus(scope, message, "failed");
29
+ const reportRecovery = (scope, message) => reportStatus(scope, message, "neutral");
30
+ function changed() {
31
+ for (const surface of surfaces) surface.render();
32
+ onChange();
33
+ }
34
+ const lifecycle = createComposerSubmissionLifecycle({ drafts, onChange: changed });
35
+ Object.defineProperty(state, "composerSending", { configurable: true, get: () => lifecycle.hasPendingScope(getDraft().scope) });
36
+ Object.defineProperty(state, "pendingAttachments", { configurable: true, get: () => getDraft().attachments });
37
+ const requests = createChatRequestController({ client, conversationView, conversationSession,
38
+ isCurrentComposerScope: isCurrentScope, applyConversationChrome, renderSessions });
39
+ queue = createComposerQueueController({ queue: sessionQueue, drafts, lifecycle, getDraft, requests, getSettings,
40
+ isCurrentScope, reportFailure, reportRecovery, onChange: changed, confirmTakeover: confirmReview });
41
+
42
+ function createSurface({ surfaceDom, currentDraft, ensureDraftSession, visible, supportsImages,
43
+ available = isComposerAvailable, prepareSend = () => true, allowsActiveRequest = true }) {
44
+ const attachments = createComposerAttachmentsController({
45
+ getDraft: currentDraft, dom: surfaceDom, shell, client, selectedEnvironmentId: getEnvironmentId,
46
+ selectedModelSupportsImageInput: supportsImages, ensureSession: ensureBoundSession,
47
+ isComposerAvailable: available, isComposerVisible: visible,
48
+ onSendStateChange: () => submit.updateSendState(), onControlEvent: recordControlEvent,
49
+ canDeleteAttachment: (file) => !drafts.contains(file) && !lifecycle.ownsAttachment(file) && !queue.ownsAttachment(file),
50
+ });
51
+ const notice = createComposerSubmissionNotice({ form: surfaceDom.composerForm, review: async (attempt) => {
52
+ if (!confirmReview("Check the conversation first: this message may already have been sent. Restore it for manual review? Sending it again may repeat its actions.")) return;
53
+ try { await lifecycle.restoreForManualReview(attempt.id, queue.authorizeReview); }
54
+ catch (error) { reportFailure(attempt.payload.scope, error.message); }
55
+ }, recover: async (scope) => {
56
+ try { await queue.recoverForManualSend(scope); }
57
+ catch (error) { reportFailure(scope, error.message); }
58
+ changed();
59
+ } });
60
+ function render() {
61
+ if (!visible()) { notice.render([]); return; }
62
+ attachments.render();
63
+ submit.updateSendState();
64
+ const draft = currentDraft();
65
+ const recovery = queue.hasManualRecovery(draft.scope)
66
+ ? { scope: draft.scope, draftEmpty: draft.isEmpty() } : null;
67
+ notice.render(lifecycle.paused(draft.scope), recovery);
68
+ }
69
+ function ensureBoundSession() {
70
+ const draft = currentDraft();
71
+ const sessionId = ensureDraftSession();
72
+ drafts.assignSession(draft, sessionId);
73
+ return sessionId;
74
+ }
75
+ function send(action) {
76
+ let draft = currentDraft();
77
+ draft.text = surfaceDom.composerInput.value.trim();
78
+ const settings = getSettings();
79
+ if (!draft.scope.sessionId) { ensureBoundSession(); draft = currentDraft(); }
80
+ const activeRequestId = allowsActiveRequest ? state.activeRequestId : "";
81
+ return lifecycle.submit({ draft, action, settings,
82
+ prepare: async (attempt) => {
83
+ if (attempt.payload.release && activeRequestId)
84
+ throw new ComposerSubmissionRefused("Wait for the active request to finish before sending this recovered message.");
85
+ if (attempt.payload.release && action !== "send")
86
+ throw new ComposerSubmissionRefused("A recovered queued message must be sent directly after review.");
87
+ if (action !== "send") return;
88
+ if (await prepareSend(attempt.payload) === false)
89
+ throw new ComposerSubmissionRefused("Conversation navigation was cancelled. Your draft was kept.");
90
+ await queue.prepareManualSend(attempt);
91
+ requests.prepareView(attempt);
92
+ },
93
+ execute: (attempt) => {
94
+ if (action === "send_next") return queue.enqueue(attempt, activeRequestId);
95
+ if (action === "steer") return steer(attempt.payload.text, { scope: { ...attempt.payload.scope, requestId: activeRequestId }, pendingAttachmentCount: attempt.payload.attachments.length });
96
+ return queue.send(attempt);
97
+ },
98
+ prepareRestore: queue.prepareRestore,
99
+ accepted: async (attempt, result) => {
100
+ if (action === "send") await queue.bindAccepted(attempt, result);
101
+ },
102
+ }).then((result) => {
103
+ if (result.status === "refused") reportFailure(result.attempt.payload.scope, result.error.message);
104
+ if (result.status === "uncertain") reportFailure(result.attempt.payload.scope, "The message could not be confirmed. It is paused for manual review.");
105
+ return result;
106
+ });
107
+ }
108
+ const submit = createComposerSubmitController({ state, dom: surfaceDom, composerActions,
109
+ getDraft: currentDraft, attachments, queue, lifecycle, submit: send,
110
+ stopRequest: requests.stopRequest, selectedEnvironmentId: getEnvironmentId, setMessageStatus,
111
+ getSubmissionBlock, onSubmissionBlocked, isComposerVisible: visible, allowsActiveRequest });
112
+ const surface = { attachments, submit, render, displays: (scope) => {
113
+ if (!visible()) return false;
114
+ const current = currentDraft().scope;
115
+ return current.environmentId === scope.environmentId && current.sessionId === scope.sessionId;
116
+ } };
117
+ surfaces.push(surface);
118
+ return surface;
119
+ }
120
+ const chat = createSurface({ surfaceDom: dom, currentDraft: getDraft, ensureDraftSession: ensureSession,
121
+ visible: isVisible, supportsImages: selectedModelSupportsImageInput });
122
+ drafts.subscribe(changed);
123
+ return { ...chat, queue, requests, drafts, lifecycle, createSurface, changed };
124
+ }
@@ -1,110 +1,49 @@
1
- import type {
2
- SessionComposerAttachmentRef,
3
- SessionComposerModelPreference,
4
- SessionComposerQueue,
5
- } from "../lib/session-composer-queue.js";
1
+ import type { RemoteSessionComposerQueue, SessionComposerQueue, SessionComposerQueueItem } from "../lib/session-composer-queue.js";
2
+ import type { ComposerAttachment, ComposerDraft, ComposerDraftSnapshot, ComposerDrafts, ComposerScope } from "./composer-drafts.js";
3
+ import type { ChatRequestController, ComposerChatAttempt } from "./chat-request-controller.js";
4
+ import type { ComposerReviewAuthorization, ComposerSubmissionAttempt, ComposerSubmissionLifecycle, ComposerSubmissionSettings } from "./composer-submission-lifecycle.js";
6
5
 
7
- export type ComposerScope = Readonly<{
8
- environmentId: string;
9
- sessionId: string;
10
- }>;
11
-
12
- export type ComposerQueueDrainScope = ComposerScope &
13
- Readonly<{ terminalRequestId: string; cancelled?: boolean }>;
14
-
15
- export interface ComposerQueueRecovery {
16
- scope: ComposerScope;
17
- releaseToken: string;
18
- }
19
-
20
- export interface ComposerQueueMessage {
21
- id?: string;
22
- role?: string;
23
- text?: string;
24
- createdAt?: unknown;
25
- requestId?: string;
26
- streaming?: boolean;
27
- }
28
-
29
- export interface ComposerQueueState {
30
- activeRequestId: string;
31
- agentMode: string;
32
- currentSessionId: string;
33
- pendingAttachments: SessionComposerAttachmentRef[];
34
- composerQueueDrainingScopes: Set<string>;
35
- composerQueueRecoveredReleaseTokens: Set<string>;
36
- activeComposerQueueRecovery: ComposerQueueRecovery | null;
37
- messages: ComposerQueueMessage[];
38
- }
39
-
40
- export interface ComposerQueueDom {
41
- composerInput: {
42
- value: string;
43
- };
44
- }
45
-
46
- export interface ComposerQueueAttachments {
47
- clear(options?: { cleanup?: boolean }): void;
48
- invalidateCompletions(): void;
49
- render(): void;
50
- }
51
-
52
- export interface ComposerQueuePostChatRequest {
53
- text: string;
54
- attachments: SessionComposerAttachmentRef[];
55
- environmentId: string;
56
- sessionId: string;
57
- agentMode: string;
58
- toolPermissionMode: string;
59
- modelPreference: SessionComposerModelPreference | null;
60
- }
61
-
62
- export interface ComposerQueueControlEvent {
63
- type: "control";
64
- name: string;
65
- tone: "failed" | "neutral";
66
- summary: string;
6
+ export type { ComposerScope } from "./composer-drafts.js";
7
+ export type ComposerQueueDrainScope = ComposerScope & Readonly<{ terminalRequestId: string; cancelled?: boolean }>;
8
+ export interface ComposerNavigationCommit {
9
+ (): void;
10
+ canCommit?(): boolean;
67
11
  }
12
+ export type ComposerNavigationPreparation = false | ComposerNavigationCommit;
68
13
 
69
14
  export interface ComposerQueueControllerOptions {
70
- state: ComposerQueueState;
71
- dom: ComposerQueueDom;
72
- queue: SessionComposerQueue;
73
- selectedEnvironmentId: () => string;
74
- getToolPermissionMode: () => string;
75
- getModelPreference: () => SessionComposerModelPreference | null;
76
- rememberModelSelection: () => void;
77
- attachments: ComposerQueueAttachments;
78
- updateSendState: () => void;
79
- postChatMessage: (request: ComposerQueuePostChatRequest) => Promise<string>;
80
- appendLocalUserMessage: (message: {
81
- text: string;
82
- attachments: SessionComposerAttachmentRef[];
83
- requestId: string;
84
- }) => void;
85
- activateRequestForScope: (scope: ComposerScope, requestId: string) => void;
86
- renderMessages: () => void;
87
- setMessageStatus: (message: string, busy?: boolean) => void;
88
- recordControlEvent: (event: ComposerQueueControlEvent) => void;
89
- resizeComposer: () => void;
15
+ queue: SessionComposerQueue | RemoteSessionComposerQueue;
16
+ drafts: ComposerDrafts;
17
+ lifecycle: ComposerSubmissionLifecycle;
18
+ getDraft(): ComposerDraft;
19
+ requests: Pick<ChatRequestController, "send" | "prepareView" | "activate">;
20
+ getSettings(): ComposerSubmissionSettings;
21
+ isCurrentScope(scope: ComposerScope): boolean;
22
+ reportFailure(scope: ComposerScope, summary: string): void;
23
+ reportRecovery?(scope: ComposerScope, summary: string): void;
24
+ onChange?(): void;
25
+ confirmTakeover?(message: string): boolean;
90
26
  }
91
27
 
92
28
  export interface ComposerQueueController {
93
- clearRecovery(scope: ComposerScope): void;
94
29
  currentScope(): ComposerScope;
95
30
  drain(scope: ComposerQueueDrainScope): Promise<void>;
96
- enqueue(text: string): Promise<void>;
31
+ enqueue(attempt: ComposerChatAttempt, waitForRequestId: string): Promise<SessionComposerQueueItem>;
97
32
  isCurrentDraining(): boolean;
98
33
  isCurrentScope(scope: ComposerScope): boolean;
99
- prepareRecoveryForNavigation(): false | (() => void);
34
+ prepareManualSend(attempt: ComposerChatAttempt): Promise<void>;
35
+ send(attempt: ComposerChatAttempt): Promise<string>;
36
+ bindAccepted(attempt: ComposerSubmissionAttempt, requestId: string): Promise<void>;
37
+ prepareRestore(attempt: ComposerSubmissionAttempt): Promise<ComposerDraftSnapshot>;
38
+ prepareRecoveryForNavigation(): ComposerNavigationCommit | Promise<ComposerNavigationPreparation>;
39
+ suspendRecoveryForNavigation(canNavigate?: () => boolean): boolean | Promise<boolean>;
100
40
  queuedCount(): number;
101
- recoverForManualSend(scope: ComposerScope): boolean;
41
+ recoverForManualSend(scope: ComposerScope): Promise<boolean>;
42
+ hasManualRecovery(scope: ComposerScope): boolean;
102
43
  reportFailure(scope: ComposerScope, summary: string): void;
103
- restoreText(text: string, scope: ComposerScope): void;
104
44
  scopeKey(scope: ComposerScope): string;
105
- suspendRecoveryForNavigation(): boolean;
45
+ authorizeReview(attempt: ComposerSubmissionAttempt): Promise<ComposerReviewAuthorization>;
46
+ ownsAttachment(attachment: ComposerAttachment): boolean;
106
47
  }
107
48
 
108
- export declare function createComposerQueueController(
109
- options: ComposerQueueControllerOptions,
110
- ): ComposerQueueController;
49
+ export declare function createComposerQueueController(options: ComposerQueueControllerOptions): ComposerQueueController;