@abot-ai/runtime 1.6.0 → 1.7.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 (380) hide show
  1. package/README.md +2 -0
  2. package/dist/src/bridge/request-steering.js +60 -15
  3. package/dist/src/capabilities/normal-invocation/contracts.d.ts +3 -0
  4. package/dist/src/capabilities/normal-invocation/output-channels.d.ts +10 -0
  5. package/dist/src/capabilities/normal-invocation/output-channels.js +29 -0
  6. package/dist/src/capabilities/normal-invocation/validator.js +4 -2
  7. package/dist/src/capabilities/tool-types.d.ts +1 -1
  8. package/dist/src/cli/host-companion-bundle.mjs +7570 -6781
  9. package/dist/src/cli/host-companion-entry.js +5 -22
  10. package/dist/src/cli/host-companion-input.d.ts +3 -0
  11. package/dist/src/cli/host-companion-input.js +21 -0
  12. package/dist/src/cli/host-companion-lifecycle.d.ts +11 -0
  13. package/dist/src/cli/host-companion-lifecycle.js +32 -0
  14. package/dist/src/cli/host-companion-setup-target.d.ts +4 -0
  15. package/dist/src/cli/host-companion-setup-target.js +17 -0
  16. package/dist/src/cli/host-companion-startup.d.ts +2 -0
  17. package/dist/src/cli/host-companion-startup.js +7 -2
  18. package/dist/src/cli/host-companion.d.ts +6 -0
  19. package/dist/src/cli/host-companion.js +30 -27
  20. package/dist/src/cli/windows-companion-store-entry.d.ts +9 -0
  21. package/dist/src/cli/windows-companion-store-entry.js +67 -0
  22. package/dist/src/computer-access/command-output-capture.d.ts +37 -0
  23. package/dist/src/computer-access/command-output-capture.js +136 -0
  24. package/dist/src/computer-access/command-output-retention.d.ts +5 -0
  25. package/dist/src/computer-access/command-output-retention.js +90 -0
  26. package/dist/src/computer-access/command-output.d.ts +7 -0
  27. package/dist/src/computer-access/command-output.js +1 -0
  28. package/dist/src/computer-access/commands.d.ts +1 -0
  29. package/dist/src/computer-access/commands.js +1 -1
  30. package/dist/src/computer-access/companion/command-output-protocol.d.ts +12 -0
  31. package/dist/src/computer-access/companion/command-output-protocol.js +28 -0
  32. package/dist/src/computer-access/companion/command-output.d.ts +13 -0
  33. package/dist/src/computer-access/companion/command-output.js +110 -0
  34. package/dist/src/computer-access/companion/install-link-macos.d.ts +7 -0
  35. package/dist/src/computer-access/companion/install-link-macos.js +48 -0
  36. package/dist/src/computer-access/companion/install-link-registration.d.ts +4 -0
  37. package/dist/src/computer-access/companion/install-link-registration.js +184 -0
  38. package/dist/src/computer-access/companion/install-link-windows.d.ts +4 -0
  39. package/dist/src/computer-access/companion/install-link-windows.js +65 -0
  40. package/dist/src/computer-access/companion/install-link.d.ts +9 -0
  41. package/dist/src/computer-access/companion/install-link.js +54 -0
  42. package/dist/src/computer-access/companion/native-messages.js +3 -0
  43. package/dist/src/computer-access/companion/native-session.d.ts +1 -0
  44. package/dist/src/computer-access/companion/native-session.js +14 -2
  45. package/dist/src/computer-access/companion/native-supervisor.js +1 -0
  46. package/dist/src/computer-access/companion/notification-windows.d.ts +1 -1
  47. package/dist/src/computer-access/companion/notification-windows.js +8 -3
  48. package/dist/src/computer-access/companion/protocol.d.ts +1 -1
  49. package/dist/src/computer-access/companion/protocol.js +6 -0
  50. package/dist/src/computer-access/companion/release-version.d.ts +1 -1
  51. package/dist/src/computer-access/companion/release-version.js +1 -1
  52. package/dist/src/computer-access/companion/windows-store/connection-error.d.ts +7 -0
  53. package/dist/src/computer-access/companion/windows-store/connection-error.js +19 -0
  54. package/dist/src/computer-access/companion/windows-store/connection-link.d.ts +13 -0
  55. package/dist/src/computer-access/companion/windows-store/connection-link.js +109 -0
  56. package/dist/src/computer-access/companion/windows-store/identity.d.ts +13 -0
  57. package/dist/src/computer-access/companion/windows-store/identity.js +13 -0
  58. package/dist/src/computer-access/companion/windows-store/lifecycle.d.ts +5 -0
  59. package/dist/src/computer-access/companion/windows-store/lifecycle.js +90 -0
  60. package/dist/src/computer-access/contracts.d.ts +1 -1
  61. package/dist/src/computer-access/handlers.d.ts +2 -1
  62. package/dist/src/computer-access/handlers.js +5 -1
  63. package/dist/src/computer-access/process-capture.d.ts +6 -0
  64. package/dist/src/computer-access/process-capture.js +1 -0
  65. package/dist/src/computer-access/process-result.d.ts +2 -0
  66. package/dist/src/computer-access/process-result.js +14 -6
  67. package/dist/src/computer-access/process-runner.d.ts +2 -1
  68. package/dist/src/computer-access/process-runner.js +21 -13
  69. package/dist/src/model-gateway/server/configuration.d.ts +2 -0
  70. package/dist/src/model-gateway/server/configuration.js +73 -21
  71. package/dist/src/plugin-contract/install-source.d.ts +13 -0
  72. package/dist/src/plugin-contract/install-source.js +99 -0
  73. package/dist/src/plugin-contract/manifest.d.ts +2 -1
  74. package/dist/src/plugin-sdk/computer-access.d.ts +8 -0
  75. package/dist/src/plugin-sdk/computer-access.js +5 -0
  76. package/dist/src/runtime/adapters/in-memory-session-store.js +6 -16
  77. package/dist/src/runtime/admin/config-control.js +2 -1
  78. package/dist/src/runtime/automations/catalog.d.ts +3 -0
  79. package/dist/src/runtime/automations/catalog.js +1 -0
  80. package/dist/src/runtime/automations/model-dependency-projection.d.ts +2 -0
  81. package/dist/src/runtime/automations/service.d.ts +2 -0
  82. package/dist/src/runtime/capabilities/automation-builder/authoring-reference.d.ts +10 -5
  83. package/dist/src/runtime/capabilities/automation-builder/authoring-reference.js +8 -7
  84. package/dist/src/runtime/capabilities/automation-builder/payload-instructions.d.ts +2 -2
  85. package/dist/src/runtime/capabilities/automation-builder/payload-instructions.js +2 -2
  86. package/dist/src/runtime/capabilities/automation-builder/tool-contract.d.ts +2 -2
  87. package/dist/src/runtime/capabilities/automations/authoring-catalog.js +1 -1
  88. package/dist/src/runtime/capabilities/automations/authoring-preparation.d.ts +11 -5
  89. package/dist/src/runtime/capabilities/automations/tool-module.js +1 -1
  90. package/dist/src/runtime/capabilities/request-permission-catalog.d.ts +3 -1
  91. package/dist/src/runtime/capabilities/request-permission-catalog.js +21 -2
  92. package/dist/src/runtime/capabilities/request-permission-tool-registry.d.ts +2 -1
  93. package/dist/src/runtime/capabilities/request-permission-tool-registry.js +18 -10
  94. package/dist/src/runtime/capabilities/request-runtime-tool-registry.d.ts +2 -0
  95. package/dist/src/runtime/capabilities/request-runtime-tool-registry.js +1 -1
  96. package/dist/src/runtime/capabilities/scheduling/create-operations.d.ts +6 -0
  97. package/dist/src/runtime/config/builders.js +6 -5
  98. package/dist/src/runtime/config/effective-model-config-validation.js +4 -35
  99. package/dist/src/runtime/config/fields.js +15 -0
  100. package/dist/src/runtime/config/model-context-capacity.d.ts +20 -0
  101. package/dist/src/runtime/config/model-context-capacity.js +55 -0
  102. package/dist/src/runtime/config/model-execution-policy.d.ts +5 -1
  103. package/dist/src/runtime/config/model-execution-policy.js +16 -0
  104. package/dist/src/runtime/config/model-plugin-config.d.ts +8 -0
  105. package/dist/src/runtime/config/model-plugin-config.js +40 -0
  106. package/dist/src/runtime/config/schema.js +5 -1
  107. package/dist/src/runtime/config/validation/model-profile-validation.js +2 -0
  108. package/dist/src/runtime/config/validation/runtime-config-validation-contract.d.ts +3 -1
  109. package/dist/src/runtime/config/validation/runtime-config-validation-contract.js +3 -1
  110. package/dist/src/runtime/config/validation/runtime-root-section-validation.js +11 -4
  111. package/dist/src/runtime/config/validation/web-ui-config-validation.js +3 -2
  112. package/dist/src/runtime/config/web-ui.d.ts +5 -0
  113. package/dist/src/runtime/config/web-ui.js +5 -0
  114. package/dist/src/runtime/config.js +2 -0
  115. package/dist/src/runtime/local-application.d.ts +2 -0
  116. package/dist/src/runtime/local-host/app-owner.js +50 -6
  117. package/dist/src/runtime/local-host/app-request-control.d.ts +3 -1
  118. package/dist/src/runtime/local-host/app-request-control.js +91 -11
  119. package/dist/src/runtime/local-host/client-requests.js +32 -5
  120. package/dist/src/runtime/local-host/client-services.d.ts +2 -0
  121. package/dist/src/runtime/local-host/local-request-diagnostics.d.ts +9 -0
  122. package/dist/src/runtime/local-host/local-request-diagnostics.js +47 -0
  123. package/dist/src/runtime/local-host/saved-approvals.js +23 -2
  124. package/dist/src/runtime/model/model-selection.js +4 -1
  125. package/dist/src/runtime/observability/request-control-diagnostics.d.ts +6 -0
  126. package/dist/src/runtime/observability/request-control-diagnostics.js +52 -0
  127. package/dist/src/runtime/plugins/configuration-context.d.ts +9 -0
  128. package/dist/src/runtime/plugins/configuration-context.js +42 -0
  129. package/dist/src/runtime/plugins/configuration-settings.d.ts +2 -0
  130. package/dist/src/runtime/plugins/configuration-settings.js +26 -0
  131. package/dist/src/runtime/plugins/configuration-store.d.ts +23 -0
  132. package/dist/src/runtime/plugins/configuration-store.js +100 -0
  133. package/dist/src/runtime/plugins/configuration-write.d.ts +5 -0
  134. package/dist/src/runtime/plugins/configuration-write.js +58 -0
  135. package/dist/src/runtime/plugins/installation/archive.d.ts +2 -0
  136. package/dist/src/runtime/plugins/installation/archive.js +107 -0
  137. package/dist/src/runtime/plugins/installation/github-download.d.ts +9 -0
  138. package/dist/src/runtime/plugins/installation/github-download.js +72 -0
  139. package/dist/src/runtime/plugins/installation/installed-package.d.ts +9 -0
  140. package/dist/src/runtime/plugins/installation/installed-package.js +66 -0
  141. package/dist/src/runtime/plugins/installation/package.d.ts +45 -0
  142. package/dist/src/runtime/plugins/installation/package.js +79 -0
  143. package/dist/src/runtime/plugins/installation/portable-path.d.ts +2 -0
  144. package/dist/src/runtime/plugins/installation/portable-path.js +10 -0
  145. package/dist/src/runtime/plugins/installation/publication.d.ts +10 -0
  146. package/dist/src/runtime/plugins/installation/publication.js +17 -0
  147. package/dist/src/runtime/plugins/installation/service.d.ts +41 -0
  148. package/dist/src/runtime/plugins/installation/service.js +80 -0
  149. package/dist/src/runtime/plugins/loader.js +15 -29
  150. package/dist/src/runtime/plugins/manifest-projection.js +1 -0
  151. package/dist/src/runtime/plugins/manifest-validator.js +3 -0
  152. package/dist/src/runtime/plugins/module-cache.d.ts +2 -0
  153. package/dist/src/runtime/plugins/module-cache.js +19 -0
  154. package/dist/src/runtime/plugins/selection.d.ts +2 -0
  155. package/dist/src/runtime/plugins/selection.js +16 -11
  156. package/dist/src/runtime/ports.d.ts +6 -4
  157. package/dist/src/runtime/request/dependencies.d.ts +2 -1
  158. package/dist/src/runtime/request/execution-payload-compacted-evidence.d.ts +1 -1
  159. package/dist/src/runtime/request/handler.js +8 -0
  160. package/dist/src/runtime/request/prepared-execution.js +6 -1
  161. package/dist/src/runtime/request/request-steering.d.ts +4 -0
  162. package/dist/src/runtime/request/request-steering.js +37 -12
  163. package/dist/src/runtime/request/worker-capability-composition.d.ts +2 -0
  164. package/dist/src/runtime/request/worker-capability-composition.js +4 -1
  165. package/dist/src/runtime/scheduler/journal-index-state.d.ts +1 -1
  166. package/dist/src/sessions/assistant-initiative-message.d.ts +3 -0
  167. package/dist/src/sessions/assistant-initiative-message.js +12 -0
  168. package/dist/src/sessions/assistant-initiative.d.ts +2 -2
  169. package/dist/src/sessions/assistant-initiative.js +1 -7
  170. package/dist/src/sessions/durable-session-commit.d.ts +2 -1
  171. package/dist/src/sessions/durable-session-commit.js +6 -1
  172. package/dist/src/sessions/metadata/projection.d.ts +15 -0
  173. package/dist/src/sessions/metadata/projection.js +55 -0
  174. package/dist/src/sessions/metadata/publication.d.ts +12 -0
  175. package/dist/src/sessions/metadata/publication.js +78 -0
  176. package/dist/src/sessions/metadata/source-receipt.d.ts +5 -0
  177. package/dist/src/sessions/metadata/source-receipt.js +42 -0
  178. package/dist/src/sessions/metadata/store.d.ts +7 -0
  179. package/dist/src/sessions/metadata/store.js +119 -0
  180. package/dist/src/sessions/record/projection.d.ts +3 -1
  181. package/dist/src/sessions/record/projection.js +26 -18
  182. package/dist/src/sessions/request-lifecycle/service.js +3 -3
  183. package/dist/src/sessions/session-service.d.ts +2 -4
  184. package/dist/src/sessions/session-service.js +4 -16
  185. package/dist/src/sessions/session-store.d.ts +2 -1
  186. package/dist/src/sessions/session-store.js +9 -3
  187. package/dist/src/sessions/snapshot.d.ts +17 -0
  188. package/dist/src/sessions/snapshot.js +105 -0
  189. package/dist/src/sessions/types.d.ts +2 -0
  190. package/dist/src/shared/tool-selection.d.ts +2 -0
  191. package/dist/src/shared/tool-selection.js +7 -0
  192. package/dist/src/web-ui/app/ARCHITECTURE.md +14 -0
  193. package/dist/src/web-ui/app/app.js +6 -3
  194. package/dist/src/web-ui/app/components/config-workspace/config-model.js +2 -0
  195. package/dist/src/web-ui/app/components/config-workspace/model-plugin-permissions.js +130 -0
  196. package/dist/src/web-ui/app/components/config-workspace/model-plugin-selection.js +180 -0
  197. package/dist/src/web-ui/app/components/config-workspace/model-plugin-view-state.js +114 -0
  198. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +3 -0
  199. package/dist/src/web-ui/app/components/config-workspace/model-summary.js +39 -0
  200. package/dist/src/web-ui/app/components/config-workspace/summary-rendering.js +30 -0
  201. package/dist/src/web-ui/app/components/config-workspace/workspace-events.js +37 -0
  202. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +2 -0
  203. package/dist/src/web-ui/app/components/config-workspace/workspace-persistence.js +9 -1
  204. package/dist/src/web-ui/app/components/config-workspace/workspace-view.js +23 -67
  205. package/dist/src/web-ui/app/components/config-workspace.js +11 -2
  206. package/dist/src/web-ui/app/components/conversation-view.js +36 -5
  207. package/dist/src/web-ui/app/components/dashboard/recent-conversations.js +2 -1
  208. package/dist/src/web-ui/app/components/dashboard/workspace.js +2 -1
  209. package/dist/src/web-ui/app/components/operations-summary.js +105 -0
  210. package/dist/src/web-ui/app/components/passive-learning/home.js +1 -9
  211. package/dist/src/web-ui/app/components/plugins/configuration-draft.js +34 -0
  212. package/dist/src/web-ui/app/components/plugins/configuration-editor.js +147 -0
  213. package/dist/src/web-ui/app/components/plugins/configuration-fields.js +103 -0
  214. package/dist/src/web-ui/app/components/plugins/configuration-retained-secrets.js +20 -0
  215. package/dist/src/web-ui/app/components/plugins/configuration-settings.js +108 -0
  216. package/dist/src/web-ui/app/components/plugins/discovery-rendering.js +37 -0
  217. package/dist/src/web-ui/app/components/plugins/installation.js +212 -0
  218. package/dist/src/web-ui/app/components/plugins/manager.js +160 -6
  219. package/dist/src/web-ui/app/components/plugins/removal.js +130 -0
  220. package/dist/src/web-ui/app/components/plugins/rendering.js +14 -2
  221. package/dist/src/web-ui/app/components/plugins/summary.js +54 -0
  222. package/dist/src/web-ui/app/components/plugins/tabs.js +31 -0
  223. package/dist/src/web-ui/app/components/plugins/view-state.js +3 -1
  224. package/dist/src/web-ui/app/components/runtime-setup/connection-form.js +5 -2
  225. package/dist/src/web-ui/app/components/runtime-setup/connection-state.js +9 -1
  226. package/dist/src/web-ui/app/components/runtime-setup/context-window-feedback.js +71 -0
  227. package/dist/src/web-ui/app/components/runtime-setup/optional-steps.js +2 -0
  228. package/dist/src/web-ui/app/components/runtime-setup-guide.js +15 -3
  229. package/dist/src/web-ui/app/components/spark-chat/empty-state.js +1 -0
  230. package/dist/src/web-ui/app/components/spark-chat/panel.js +1 -0
  231. package/dist/src/web-ui/app/components/system-host/connection-card.js +35 -0
  232. package/dist/src/web-ui/app/components/system-host/macos-setup.js +1 -1
  233. package/dist/src/web-ui/app/components/system-host/manager.js +45 -12
  234. package/dist/src/web-ui/app/components/system-host/rendering.js +111 -106
  235. package/dist/src/web-ui/app/components/system-host/windows-store-setup.js +293 -0
  236. package/dist/src/web-ui/app/components/workspace-shell.js +6 -0
  237. package/dist/src/web-ui/app/computer-access-feature.js +22 -5
  238. package/dist/src/web-ui/app/configuration-feature.js +35 -2
  239. package/dist/src/web-ui/app/controllers/app-event-bindings.js +4 -1
  240. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.d.ts +1 -0
  241. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.js +7 -3
  242. package/dist/src/web-ui/app/controllers/conversation-request-hydration.js +88 -0
  243. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +9 -3
  244. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +52 -144
  245. package/dist/src/web-ui/app/controllers/history-pagination.js +111 -0
  246. package/dist/src/web-ui/app/controllers/operations-controller.d.ts +12 -0
  247. package/dist/src/web-ui/app/controllers/operations-controller.js +28 -21
  248. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.d.ts +1 -0
  249. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.js +11 -0
  250. package/dist/src/web-ui/app/controllers/session-controller.js +10 -2
  251. package/dist/src/web-ui/app/controllers/session-list-pagination.js +71 -0
  252. package/dist/src/web-ui/app/controllers/session-sidebar-controller.js +6 -4
  253. package/dist/src/web-ui/app/controllers/spark-chat-reading.js +1 -0
  254. package/dist/src/web-ui/app/controllers/spark-chat-sync.js +24 -5
  255. package/dist/src/web-ui/app/controllers/workspace-route-controller.js +21 -19
  256. package/dist/src/web-ui/app/dashboard-feature.js +2 -2
  257. package/dist/src/web-ui/app/index.html +6 -2
  258. package/dist/src/web-ui/app/lib/history-page-messages.js +49 -0
  259. package/dist/src/web-ui/app/lib/request-lifecycle-view.js +8 -0
  260. package/dist/src/web-ui/app/lib/workspace-route.d.ts +3 -0
  261. package/dist/src/web-ui/app/lib/workspace-route.js +4 -0
  262. package/dist/src/web-ui/app/passive-learning-feature.js +0 -1
  263. package/dist/src/web-ui/app/runtime-onboarding-feature.js +3 -0
  264. package/dist/src/web-ui/app/schedules-feature.js +1 -1
  265. package/dist/src/web-ui/app/services/runtime-web-client/configuration.js +20 -0
  266. package/dist/src/web-ui/app/services/runtime-web-client/plugin-configuration.js +19 -0
  267. package/dist/src/web-ui/app/services/runtime-web-client/spark-chat.js +4 -4
  268. package/dist/src/web-ui/app/services/runtime-web-client/system-host.js +2 -0
  269. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +6 -1
  270. package/dist/src/web-ui/app/services/runtime-web-client.js +12 -3
  271. package/dist/src/web-ui/app/spark-chat-feature.js +76 -19
  272. package/dist/src/web-ui/app/styles/11-product-links.css +30 -0
  273. package/dist/src/web-ui/app/styles/41-plugin-configuration.css +79 -0
  274. package/dist/src/web-ui/app/styles/41-plugin-discovery.css +132 -0
  275. package/dist/src/web-ui/app/styles/41-plugin-management.css +6 -0
  276. package/dist/src/web-ui/app/styles/42-model-plugin-permissions.css +173 -0
  277. package/dist/src/web-ui/app/styles/46-system-host.css +61 -107
  278. package/dist/src/web-ui/app/styles/47-config-controls.css +13 -1
  279. package/dist/src/web-ui/app/styles/54-spark-chat.css +33 -1
  280. package/dist/src/web-ui/app/styles.css +4 -0
  281. package/dist/src/web-ui/local-runtime/api-router.js +11 -6
  282. package/dist/src/web-ui/local-runtime/approval-request-attachment.js +14 -5
  283. package/dist/src/web-ui/local-runtime/configuration-activation-source.d.ts +1 -1
  284. package/dist/src/web-ui/local-runtime/configuration-activation-source.js +9 -3
  285. package/dist/src/web-ui/local-runtime/contracts.d.ts +4 -3
  286. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +5 -1
  287. package/dist/src/web-ui/local-runtime/environment-registry.js +53 -11
  288. package/dist/src/web-ui/local-runtime/history-pagination.d.ts +16 -0
  289. package/dist/src/web-ui/local-runtime/history-pagination.js +20 -0
  290. package/dist/src/web-ui/local-runtime/plugin-configuration-routes.d.ts +16 -0
  291. package/dist/src/web-ui/local-runtime/plugin-configuration-routes.js +68 -0
  292. package/dist/src/web-ui/local-runtime/plugin-installation-routes.d.ts +16 -0
  293. package/dist/src/web-ui/local-runtime/plugin-installation-routes.js +96 -0
  294. package/dist/src/web-ui/local-runtime/plugin-management-routes.d.ts +8 -1
  295. package/dist/src/web-ui/local-runtime/plugin-management-routes.js +17 -0
  296. package/dist/src/web-ui/local-runtime/plugin-mutation-admission.d.ts +7 -0
  297. package/dist/src/web-ui/local-runtime/plugin-mutation-admission.js +17 -0
  298. package/dist/src/web-ui/local-runtime/plugin-removal-routes.d.ts +18 -0
  299. package/dist/src/web-ui/local-runtime/plugin-removal-routes.js +60 -0
  300. package/dist/src/web-ui/local-runtime/realtime-controller.js +41 -2
  301. package/dist/src/web-ui/local-runtime/request-cancellation-route.js +28 -1
  302. package/dist/src/web-ui/local-runtime/request-control-observation.d.ts +19 -0
  303. package/dist/src/web-ui/local-runtime/request-control-observation.js +80 -0
  304. package/dist/src/web-ui/local-runtime/request-execution.js +69 -37
  305. package/dist/src/web-ui/local-runtime/runtime-setup-context-window.d.ts +20 -0
  306. package/dist/src/web-ui/local-runtime/runtime-setup-context-window.js +44 -0
  307. package/dist/src/web-ui/local-runtime/runtime-setup-routes.js +2 -0
  308. package/dist/src/web-ui/local-runtime/runtime-setup-validation.js +9 -2
  309. package/dist/src/web-ui/local-runtime/session-routes.d.ts +1 -0
  310. package/dist/src/web-ui/local-runtime/session-routes.js +16 -4
  311. package/dist/src/web-ui/local-runtime/spark-chat-routes.js +4 -3
  312. package/dist/src/web-ui/plugin-capability-selection.js +4 -1
  313. package/dist/src/web-ui/plugin-configuration-input.d.ts +12 -0
  314. package/dist/src/web-ui/plugin-configuration-input.js +68 -0
  315. package/dist/src/web-ui/plugin-configuration-retained-secrets.d.ts +9 -0
  316. package/dist/src/web-ui/plugin-configuration-retained-secrets.js +48 -0
  317. package/dist/src/web-ui/plugin-configuration-service.d.ts +52 -0
  318. package/dist/src/web-ui/plugin-configuration-service.js +66 -0
  319. package/dist/src/web-ui/plugin-configuration-view.d.ts +25 -0
  320. package/dist/src/web-ui/plugin-configuration-view.js +45 -0
  321. package/dist/src/web-ui/plugin-disabled-selection.d.ts +7 -0
  322. package/dist/src/web-ui/plugin-disabled-selection.js +17 -0
  323. package/dist/src/web-ui/plugin-management-catalog.d.ts +3 -1
  324. package/dist/src/web-ui/plugin-management-catalog.js +11 -1
  325. package/dist/src/web-ui/plugin-management-selection.js +22 -9
  326. package/dist/src/web-ui/plugin-management-service.d.ts +5 -1
  327. package/dist/src/web-ui/plugin-management-service.js +11 -7
  328. package/dist/src/web-ui/plugin-removal-error.d.ts +7 -0
  329. package/dist/src/web-ui/plugin-removal-error.js +16 -0
  330. package/dist/src/web-ui/plugin-removal-service.d.ts +30 -0
  331. package/dist/src/web-ui/plugin-removal-service.js +109 -0
  332. package/dist/src/web-ui/runtime-setup-gateway.d.ts +6 -2
  333. package/dist/src/web-ui/runtime-setup-gateway.js +30 -10
  334. package/dist/src/web-ui/server.js +6 -2
  335. package/dist/src/web-ui/session-read-state/overview.d.ts +42 -0
  336. package/dist/src/web-ui/session-read-state/overview.js +16 -0
  337. package/dist/src/web-ui/session-read-state/pagination.d.ts +15 -0
  338. package/dist/src/web-ui/session-read-state/pagination.js +42 -0
  339. package/dist/src/web-ui/session-read-state/projection.d.ts +4 -3
  340. package/dist/src/web-ui/session-read-state/service.d.ts +213 -20
  341. package/dist/src/web-ui/session-read-state/service.js +25 -23
  342. package/dist/src/web-ui/session-read-state/visible-messages.d.ts +3 -3
  343. package/dist/src/web-ui/system-host-setup/companion-linux.js +1 -1
  344. package/dist/src/web-ui/system-host-setup/installer-contract.d.ts +1 -1
  345. package/dist/src/web-ui/system-host-setup/installer-contract.js +2 -2
  346. package/dist/src/web-ui/system-host-setup/installers.js +0 -7
  347. package/dist/src/web-ui/system-host-setup/local-connection.d.ts +4 -1
  348. package/dist/src/web-ui/system-host-setup/local-connection.js +10 -17
  349. package/dist/src/web-ui/system-host-setup/routes.d.ts +2 -0
  350. package/dist/src/web-ui/system-host-setup/routes.js +32 -9
  351. package/dist/src/web-ui/system-host-setup/setup-mutation.d.ts +9 -0
  352. package/dist/src/web-ui/system-host-setup/setup-mutation.js +27 -0
  353. package/dist/src/web-ui/system-host-setup/windows-store-route.d.ts +13 -0
  354. package/dist/src/web-ui/system-host-setup/windows-store-route.js +68 -0
  355. package/docs/configuration.md +46 -0
  356. package/docs/installation.md +45 -24
  357. package/docs/plugins.md +165 -2
  358. package/docs/projects-and-full-plus.md +2 -6
  359. package/docs/runtime-library.md +0 -1
  360. package/docs/windows-companion-store.md +127 -0
  361. package/package.json +3 -3
  362. package/plugins/document-reader/plugin.json +1 -0
  363. package/plugins/exec/plugin.json +3 -0
  364. package/plugins/filesystem/plugin.json +2 -0
  365. package/plugins/local-search/plugin.json +1 -0
  366. package/plugins/system/README.md +43 -3
  367. package/plugins/system/plugin.json +5 -0
  368. package/plugins/system/source/companion-command-output.ts +82 -0
  369. package/plugins/system/source/host-dispatch.ts +4 -0
  370. package/plugins/system/source/index.ts +11 -5
  371. package/plugins/system/source/local-command-output.ts +61 -0
  372. package/plugins/system/source/request-system-modules.ts +2 -0
  373. package/plugins/system/src/index.cjs +474 -39
  374. package/plugins/web/README.md +2 -2
  375. package/plugins/web/plugin.json +4 -0
  376. package/runtime.config.schema.json +25 -1
  377. package/src/runtime/README.md +12 -2
  378. package/dist/src/web-ui/system-host-setup/companion-windows.d.ts +0 -2
  379. package/dist/src/web-ui/system-host-setup/companion-windows.js +0 -108
  380. package/docs/publishing.md +0 -167
@@ -0,0 +1,42 @@
1
+ import type { SessionMetadata } from "../../sessions/metadata/projection.js";
2
+ import type { WebReadState } from "./store.js";
3
+ /** The home dashboard's count and three recent chats must not become page-local. */
4
+ export declare function sessionListOverview(records: SessionMetadata[], archivedIds: unknown, state?: WebReadState): {
5
+ sessions: ({
6
+ sessionId: string;
7
+ readStateStatus: "available";
8
+ unreadCount: number;
9
+ hasUnread: boolean;
10
+ lastReadMessageId: string | null;
11
+ lastReadAt: number;
12
+ latestMessageId: string | number | null;
13
+ latestAssistantMessageId: string | number | null;
14
+ kind?: import("../../sessions/spark-session.js").SessionKind;
15
+ project?: import("../../sessions/project-binding.js").SessionProject;
16
+ id: string;
17
+ title: string;
18
+ createdAt: number;
19
+ updatedAt: number;
20
+ lastMessagePreview: string;
21
+ lastMessageAt: number | null;
22
+ } | {
23
+ sessionId: string;
24
+ readStateStatus: "unavailable";
25
+ unreadCount: null;
26
+ hasUnread: null;
27
+ lastReadAt: null;
28
+ lastReadMessageId: null;
29
+ kind?: import("../../sessions/spark-session.js").SessionKind;
30
+ project?: import("../../sessions/project-binding.js").SessionProject;
31
+ id: string;
32
+ title: string;
33
+ createdAt: number;
34
+ updatedAt: number;
35
+ lastMessagePreview: string;
36
+ lastMessageAt: number | null;
37
+ latestMessageId: string | number | null;
38
+ latestAssistantMessageId: string | number | null;
39
+ })[];
40
+ unreadCount: number;
41
+ hasUnavailableReadState: boolean;
42
+ };
@@ -0,0 +1,16 @@
1
+ import { projectSessionReadState } from "./projection.js";
2
+ import { unavailableSessionReadState } from "./availability.js";
3
+ /** The home dashboard's count and three recent chats must not become page-local. */
4
+ export function sessionListOverview(records, archivedIds, state) {
5
+ const archived = new Set(Array.isArray(archivedIds) ? archivedIds : []);
6
+ const visible = records.filter(({ summary }) => !archived.has(summary.id));
7
+ let unreadCount = 0;
8
+ const recent = visible.slice(0, 3).map(({ summary, messages }) => ({
9
+ ...summary,
10
+ ...(state ? projectSessionReadState(state, summary.id, messages) : unavailableSessionReadState(summary.id)),
11
+ }));
12
+ if (state)
13
+ for (const { summary, messages } of visible)
14
+ unreadCount += projectSessionReadState(state, summary.id, messages).unreadCount;
15
+ return { sessions: recent, unreadCount, hasUnavailableReadState: !state };
16
+ }
@@ -0,0 +1,15 @@
1
+ import type { SessionMetadata } from "../../sessions/metadata/projection.js";
2
+ export type SessionPageQuery = {
3
+ cursor?: string | null;
4
+ query?: string;
5
+ archived?: boolean;
6
+ pinnedSessionIds?: string[];
7
+ orderedSessionIds?: string[];
8
+ archivedSessionIds?: string[];
9
+ };
10
+ export declare function sessionMetadataPage(records: SessionMetadata[], input: SessionPageQuery, limit: number): {
11
+ records: SessionMetadata[];
12
+ total: number;
13
+ archivedCount: number;
14
+ nextCursor: string | null;
15
+ };
@@ -0,0 +1,42 @@
1
+ function compareKeys(left, right) {
2
+ return left[0] - right[0] || left[1] - right[1] || left[2] - right[2] || left[3].localeCompare(right[3]);
3
+ }
4
+ function readCursor(cursor) {
5
+ try {
6
+ const key = JSON.parse(Buffer.from(cursor, "base64url").toString());
7
+ if (!Array.isArray(key) || key.length !== 4)
8
+ throw new Error();
9
+ if (!key.slice(0, 3).every(Number.isFinite) || typeof key[3] !== "string")
10
+ throw new Error();
11
+ return key;
12
+ }
13
+ catch {
14
+ throw new Error("session_cursor_invalid");
15
+ }
16
+ }
17
+ function readIds(value) {
18
+ if (!Array.isArray(value))
19
+ return [];
20
+ return value.filter((id) => typeof id === "string");
21
+ }
22
+ export function sessionMetadataPage(records, input, limit) {
23
+ const archived = new Set(readIds(input.archivedSessionIds));
24
+ const pinned = new Map(readIds(input.pinnedSessionIds).map((id, index) => [id, index]));
25
+ const ordered = new Map(readIds(input.orderedSessionIds).map((id, index) => [id, index]));
26
+ const query = typeof input.query === "string" ? input.query.trim().toLowerCase() : "";
27
+ const archivedCount = records.filter(({ summary }) => archived.has(summary.id)).length;
28
+ const entries = records.filter(({ summary }) => archived.has(summary.id) === (input.archived === true))
29
+ .filter(({ summary }) => [summary.id, summary.title, summary.lastMessagePreview].some((text) => text.toLowerCase().includes(query)))
30
+ .map((record) => {
31
+ const { id, updatedAt } = record.summary;
32
+ const key = [pinned.has(id) ? 0 : 1, pinned.get(id) ?? ordered.get(id) ?? -1, -updatedAt, id];
33
+ return { record, key };
34
+ }).sort((left, right) => compareKeys(left.key, right.key));
35
+ const anchor = input.cursor ? readCursor(input.cursor) : null;
36
+ const remaining = anchor ? entries.filter(({ key }) => compareKeys(key, anchor) > 0) : entries;
37
+ const page = remaining.slice(0, limit);
38
+ return {
39
+ records: page.map(({ record }) => record), total: entries.length, archivedCount,
40
+ nextCursor: remaining.length > limit ? Buffer.from(JSON.stringify(page.at(-1).key)).toString("base64url") : null,
41
+ };
42
+ }
@@ -1,11 +1,12 @@
1
- import type { SessionSnapshotMessage } from "../../sessions/types.js";
1
+ import type { SessionMessageIdentity } from "../../sessions/snapshot.js";
2
+ import type { SessionMessageMetadata } from "../../sessions/metadata/projection.js";
2
3
  import type { WebReadState } from "./store.js";
3
4
  export type ReadBoundary = {
4
5
  readThroughMessageId?: unknown;
5
6
  readThroughRequestId?: unknown;
6
7
  };
7
- export declare function advanceReadCursor(state: WebReadState, sessionId: string, messages: SessionSnapshotMessage[], boundary: ReadBoundary, now: number): void;
8
- export declare function projectSessionReadState(state: WebReadState, sessionId: string, messages: SessionSnapshotMessage[]): {
8
+ export declare function advanceReadCursor(state: WebReadState, sessionId: string, messages: SessionMessageIdentity[], boundary: ReadBoundary, now: number): void;
9
+ export declare function projectSessionReadState(state: WebReadState, sessionId: string, messages: SessionMessageMetadata[]): {
9
10
  sessionId: string;
10
11
  readStateStatus: "available";
11
12
  unreadCount: number;
@@ -1,3 +1,4 @@
1
+ import { type SessionPageQuery } from "./pagination.js";
1
2
  import type { RuntimeConfig, SessionStore } from "../../runtime/ports.js";
2
3
  import type { SessionSnapshot } from "../../sessions/types.js";
3
4
  import { type ReadBoundary } from "./projection.js";
@@ -30,13 +31,6 @@ export declare class WebSessionReadStates {
30
31
  lastReadMessageId: string | number | null;
31
32
  latestMessageId: string | number | null;
32
33
  latestAssistantMessageId: string | number | null;
33
- } | {
34
- sessionId: string;
35
- readStateStatus: "unavailable";
36
- unreadCount: null;
37
- hasUnread: null;
38
- lastReadAt: null;
39
- lastReadMessageId: null;
40
34
  } | {
41
35
  sessionId: string;
42
36
  readStateStatus: "available";
@@ -46,6 +40,13 @@ export declare class WebSessionReadStates {
46
40
  lastReadAt: number;
47
41
  latestMessageId: string | number | null;
48
42
  latestAssistantMessageId: string | number | null;
43
+ } | {
44
+ sessionId: string;
45
+ readStateStatus: "unavailable";
46
+ unreadCount: null;
47
+ hasUnread: null;
48
+ lastReadAt: null;
49
+ lastReadMessageId: null;
49
50
  }>;
50
51
  mark(environmentId: string, sessionId: string, boundary: ReadBoundary): Promise<{
51
52
  sessionId: string;
@@ -82,7 +83,49 @@ export declare class WebSessionReadStates {
82
83
  latestMessageId: string | number | null;
83
84
  latestAssistantMessageId: string | number | null;
84
85
  } | null>;
85
- list(environmentId: string): Promise<{
86
+ list(environmentId: string, query?: SessionPageQuery): Promise<{
87
+ overview?: {
88
+ sessions: ({
89
+ sessionId: string;
90
+ readStateStatus: "available";
91
+ unreadCount: number;
92
+ hasUnread: boolean;
93
+ lastReadMessageId: string | null;
94
+ lastReadAt: number;
95
+ latestMessageId: string | number | null;
96
+ latestAssistantMessageId: string | number | null;
97
+ kind?: import("../../sessions/spark-session.js").SessionKind;
98
+ project?: import("../../sessions/project-binding.js").SessionProject;
99
+ id: string;
100
+ title: string;
101
+ createdAt: number;
102
+ updatedAt: number;
103
+ lastMessagePreview: string;
104
+ lastMessageAt: number | null;
105
+ } | {
106
+ sessionId: string;
107
+ readStateStatus: "unavailable";
108
+ unreadCount: null;
109
+ hasUnread: null;
110
+ lastReadAt: null;
111
+ lastReadMessageId: null;
112
+ kind?: import("../../sessions/spark-session.js").SessionKind;
113
+ project?: import("../../sessions/project-binding.js").SessionProject;
114
+ id: string;
115
+ title: string;
116
+ createdAt: number;
117
+ updatedAt: number;
118
+ lastMessagePreview: string;
119
+ lastMessageAt: number | null;
120
+ latestMessageId: string | number | null;
121
+ latestAssistantMessageId: string | number | null;
122
+ })[];
123
+ unreadCount: number;
124
+ hasUnavailableReadState: boolean;
125
+ } | undefined;
126
+ total: number;
127
+ archivedCount: number;
128
+ nextCursor: string | null;
86
129
  sessions: {
87
130
  sessionId: string;
88
131
  readStateStatus: "available";
@@ -92,21 +135,117 @@ export declare class WebSessionReadStates {
92
135
  lastReadAt: number;
93
136
  latestMessageId: string | number | null;
94
137
  latestAssistantMessageId: string | number | null;
138
+ kind?: import("../../sessions/spark-session.js").SessionKind;
139
+ project?: import("../../sessions/project-binding.js").SessionProject;
140
+ id: string;
95
141
  title: string;
96
142
  createdAt: number;
97
143
  updatedAt: number;
98
144
  lastMessagePreview: string;
99
145
  lastMessageAt: number | null;
100
- project?: Readonly<{
146
+ }[];
147
+ } | {
148
+ overview?: {
149
+ sessions: ({
150
+ sessionId: string;
151
+ readStateStatus: "available";
152
+ unreadCount: number;
153
+ hasUnread: boolean;
154
+ lastReadMessageId: string | null;
155
+ lastReadAt: number;
156
+ latestMessageId: string | number | null;
157
+ latestAssistantMessageId: string | number | null;
158
+ kind?: import("../../sessions/spark-session.js").SessionKind;
159
+ project?: import("../../sessions/project-binding.js").SessionProject;
101
160
  id: string;
102
- name: string;
103
- directory: string;
104
- }> | undefined;
105
- kind?: "spark" | undefined;
161
+ title: string;
162
+ createdAt: number;
163
+ updatedAt: number;
164
+ lastMessagePreview: string;
165
+ lastMessageAt: number | null;
166
+ } | {
167
+ sessionId: string;
168
+ readStateStatus: "unavailable";
169
+ unreadCount: null;
170
+ hasUnread: null;
171
+ lastReadAt: null;
172
+ lastReadMessageId: null;
173
+ kind?: import("../../sessions/spark-session.js").SessionKind;
174
+ project?: import("../../sessions/project-binding.js").SessionProject;
175
+ id: string;
176
+ title: string;
177
+ createdAt: number;
178
+ updatedAt: number;
179
+ lastMessagePreview: string;
180
+ lastMessageAt: number | null;
181
+ latestMessageId: string | number | null;
182
+ latestAssistantMessageId: string | number | null;
183
+ })[];
184
+ unreadCount: number;
185
+ hasUnavailableReadState: boolean;
186
+ } | undefined;
187
+ nextCursor: null;
188
+ sessions: {
189
+ sessionId: string;
190
+ readStateStatus: "available";
191
+ unreadCount: number;
192
+ hasUnread: boolean;
193
+ lastReadMessageId: string | null;
194
+ lastReadAt: number;
195
+ latestMessageId: string | number | null;
196
+ latestAssistantMessageId: string | number | null;
197
+ kind?: import("../../sessions/spark-session.js").SessionKind;
198
+ project?: import("../../sessions/project-binding.js").SessionProject;
106
199
  id: string;
200
+ title: string;
201
+ createdAt: number;
202
+ updatedAt: number;
203
+ lastMessagePreview: string;
204
+ lastMessageAt: number | null;
107
205
  }[];
108
- nextCursor: null;
109
206
  } | {
207
+ overview?: {
208
+ sessions: ({
209
+ sessionId: string;
210
+ readStateStatus: "available";
211
+ unreadCount: number;
212
+ hasUnread: boolean;
213
+ lastReadMessageId: string | null;
214
+ lastReadAt: number;
215
+ latestMessageId: string | number | null;
216
+ latestAssistantMessageId: string | number | null;
217
+ kind?: import("../../sessions/spark-session.js").SessionKind;
218
+ project?: import("../../sessions/project-binding.js").SessionProject;
219
+ id: string;
220
+ title: string;
221
+ createdAt: number;
222
+ updatedAt: number;
223
+ lastMessagePreview: string;
224
+ lastMessageAt: number | null;
225
+ } | {
226
+ sessionId: string;
227
+ readStateStatus: "unavailable";
228
+ unreadCount: null;
229
+ hasUnread: null;
230
+ lastReadAt: null;
231
+ lastReadMessageId: null;
232
+ kind?: import("../../sessions/spark-session.js").SessionKind;
233
+ project?: import("../../sessions/project-binding.js").SessionProject;
234
+ id: string;
235
+ title: string;
236
+ createdAt: number;
237
+ updatedAt: number;
238
+ lastMessagePreview: string;
239
+ lastMessageAt: number | null;
240
+ latestMessageId: string | number | null;
241
+ latestAssistantMessageId: string | number | null;
242
+ })[];
243
+ unreadCount: number;
244
+ hasUnavailableReadState: boolean;
245
+ } | undefined;
246
+ total: number;
247
+ archivedCount: number;
248
+ nextCursor: string | null;
110
249
  sessions: {
111
250
  sessionId: string;
112
251
  readStateStatus: "unavailable";
@@ -114,6 +253,9 @@ export declare class WebSessionReadStates {
114
253
  hasUnread: null;
115
254
  lastReadAt: null;
116
255
  lastReadMessageId: null;
256
+ kind?: import("../../sessions/spark-session.js").SessionKind;
257
+ project?: import("../../sessions/project-binding.js").SessionProject;
258
+ id: string;
117
259
  title: string;
118
260
  createdAt: number;
119
261
  updatedAt: number;
@@ -121,15 +263,66 @@ export declare class WebSessionReadStates {
121
263
  lastMessageAt: number | null;
122
264
  latestMessageId: string | number | null;
123
265
  latestAssistantMessageId: string | number | null;
124
- project?: Readonly<{
266
+ }[];
267
+ } | {
268
+ overview?: {
269
+ sessions: ({
270
+ sessionId: string;
271
+ readStateStatus: "available";
272
+ unreadCount: number;
273
+ hasUnread: boolean;
274
+ lastReadMessageId: string | null;
275
+ lastReadAt: number;
276
+ latestMessageId: string | number | null;
277
+ latestAssistantMessageId: string | number | null;
278
+ kind?: import("../../sessions/spark-session.js").SessionKind;
279
+ project?: import("../../sessions/project-binding.js").SessionProject;
280
+ id: string;
281
+ title: string;
282
+ createdAt: number;
283
+ updatedAt: number;
284
+ lastMessagePreview: string;
285
+ lastMessageAt: number | null;
286
+ } | {
287
+ sessionId: string;
288
+ readStateStatus: "unavailable";
289
+ unreadCount: null;
290
+ hasUnread: null;
291
+ lastReadAt: null;
292
+ lastReadMessageId: null;
293
+ kind?: import("../../sessions/spark-session.js").SessionKind;
294
+ project?: import("../../sessions/project-binding.js").SessionProject;
125
295
  id: string;
126
- name: string;
127
- directory: string;
128
- }> | undefined;
129
- kind?: "spark" | undefined;
296
+ title: string;
297
+ createdAt: number;
298
+ updatedAt: number;
299
+ lastMessagePreview: string;
300
+ lastMessageAt: number | null;
301
+ latestMessageId: string | number | null;
302
+ latestAssistantMessageId: string | number | null;
303
+ })[];
304
+ unreadCount: number;
305
+ hasUnavailableReadState: boolean;
306
+ } | undefined;
307
+ nextCursor: null;
308
+ sessions: {
309
+ sessionId: string;
310
+ readStateStatus: "unavailable";
311
+ unreadCount: null;
312
+ hasUnread: null;
313
+ lastReadAt: null;
314
+ lastReadMessageId: null;
315
+ kind?: import("../../sessions/spark-session.js").SessionKind;
316
+ project?: import("../../sessions/project-binding.js").SessionProject;
130
317
  id: string;
318
+ title: string;
319
+ createdAt: number;
320
+ updatedAt: number;
321
+ lastMessagePreview: string;
322
+ lastMessageAt: number | null;
323
+ latestMessageId: string | number | null;
324
+ latestAssistantMessageId: string | number | null;
131
325
  }[];
132
- nextCursor: null;
133
326
  }>;
134
327
  }
135
328
  export {};
@@ -1,9 +1,11 @@
1
+ import { sessionListOverview } from "./overview.js";
2
+ import { sessionMetadataPage } from "./pagination.js";
3
+ import { webPageSize } from "../local-runtime/history-pagination.js";
1
4
  import { createHash } from "node:crypto";
2
5
  import { join, resolve } from "node:path";
3
- import { SessionService } from "../../sessions/session-service.js";
6
+ import { listSessionMetadata } from "../../sessions/metadata/store.js";
4
7
  import { isSparkSession } from "../../sessions/spark-session.js";
5
8
  import { markVisibleAssistantMessages, projectVisibleSessionReadState, visibleReadMessageIds, visibleReadObservations } from "./visible-messages.js";
6
- import { clientVisibleMessages, toSessionListItem, toSnapshotMessage, } from "../../sessions/record/projection.js";
7
9
  import { WebReadStateStore } from "./store.js";
8
10
  import { captureReadStateAvailability, unavailableSessionReadState, } from "./availability.js";
9
11
  import { advanceReadCursor, projectSessionReadState, } from "./projection.js";
@@ -42,8 +44,8 @@ export class WebSessionReadStates {
42
44
  }
43
45
  async project(environmentId, snapshot) {
44
46
  const result = await captureReadStateAvailability(() => this.store(environmentId).transaction((state) => isSparkSession(snapshot)
45
- ? projectVisibleSessionReadState(state, snapshot.sessionId, snapshot.messages)
46
- : projectSessionReadState(state, snapshot.sessionId, snapshot.messages)));
47
+ ? projectVisibleSessionReadState(state, snapshot.sessionId, (snapshot.messageIndex ?? snapshot.messages))
48
+ : projectSessionReadState(state, snapshot.sessionId, (snapshot.messageIndex ?? snapshot.messages))));
47
49
  if (result.readStateStatus === "unavailable")
48
50
  return unavailableSessionReadState(snapshot.sessionId);
49
51
  return result.value;
@@ -54,14 +56,14 @@ export class WebSessionReadStates {
54
56
  const sessions = this.getEnvironment(environmentId).services.sessions;
55
57
  return store.transaction(async (state) => {
56
58
  const snapshot = await sessions.getSessionSnapshot(sessionId, {
57
- includeRequests: false,
59
+ includeRequests: false, identitiesOnly: true,
58
60
  });
59
61
  if (!snapshot)
60
62
  return null;
61
63
  if (isSparkSession(snapshot))
62
- return projectVisibleSessionReadState(state, sessionId, snapshot.messages);
63
- advanceReadCursor(state, sessionId, snapshot.messages, boundary, this.now());
64
- return projectSessionReadState(state, sessionId, snapshot.messages);
64
+ return projectVisibleSessionReadState(state, sessionId, (snapshot.messageIndex ?? snapshot.messages));
65
+ advanceReadCursor(state, sessionId, (snapshot.messageIndex ?? snapshot.messages), boundary, this.now());
66
+ return projectSessionReadState(state, sessionId, (snapshot.messageIndex ?? snapshot.messages));
65
67
  });
66
68
  }
67
69
  async markVisible(environmentId, sessionId, input, generation, visibleMessages) {
@@ -69,38 +71,38 @@ export class WebSessionReadStates {
69
71
  const observations = visibleReadObservations(ids, visibleMessages);
70
72
  const sessions = this.getEnvironment(environmentId).services.sessions;
71
73
  return this.store(environmentId).transaction(async (state) => {
72
- const snapshot = await sessions.getSessionSnapshot(sessionId, { includeRequests: false });
74
+ const snapshot = await sessions.getSessionSnapshot(sessionId, { includeRequests: false, identitiesOnly: true });
73
75
  if (!snapshot || !isSparkSession(snapshot))
74
76
  return null;
75
- markVisibleAssistantMessages(state, sessionId, snapshot.messages, observations, generation, this.now());
76
- return projectVisibleSessionReadState(state, sessionId, snapshot.messages);
77
+ markVisibleAssistantMessages(state, sessionId, (snapshot.messageIndex ?? snapshot.messages), observations, generation, this.now());
78
+ return projectVisibleSessionReadState(state, sessionId, (snapshot.messageIndex ?? snapshot.messages));
77
79
  });
78
80
  }
79
- async list(environmentId) {
81
+ async list(environmentId, query) {
80
82
  const { sessionsDir } = this.getEnvironment(environmentId).services.config.paths;
81
- // One canonical disk enumeration avoids mutable offset pages and sending
82
- // every request event across the managed Runtime's bounded RPC transport.
83
- const records = await new SessionService({ sessionsDir }).getAllSessions();
84
- const projectedSessions = records.filter((record) => !isSparkSession(record)).map((record) => ({
85
- summary: toSessionListItem(record),
86
- messages: clientVisibleMessages(record.messages).map((message) => toSnapshotMessage(record.id, message, record.requests ?? [])),
87
- }));
83
+ const records = await listSessionMetadata(sessionsDir);
84
+ const projectedSessions = records.filter((record) => record.interactive)
85
+ .filter((record) => !isSparkSession(record.summary));
86
+ const page = query ? sessionMetadataPage(projectedSessions, query, webPageSize(this.getEnvironment(environmentId).services.config))
87
+ : { records: projectedSessions, nextCursor: null };
88
+ const { records: selected, ...pageInfo } = page;
88
89
  const result = await captureReadStateAvailability(() => this.store(environmentId).transaction((state) => {
89
- const sessions = projectedSessions.map(({ summary, messages }) => {
90
+ const sessions = selected.map(({ summary, messages }) => {
90
91
  return {
91
92
  ...summary,
92
93
  ...projectSessionReadState(state, summary.id, messages),
93
94
  };
94
95
  });
95
- return { sessions, nextCursor: null };
96
+ return { sessions, ...pageInfo, ...(query && !query.cursor ? { overview: sessionListOverview(projectedSessions, query.archivedSessionIds, state) } : {}) };
96
97
  }));
97
98
  if (result.readStateStatus === "unavailable")
98
99
  return {
99
- sessions: projectedSessions.map(({ summary }) => ({
100
+ sessions: selected.map(({ summary }) => ({
100
101
  ...summary,
101
102
  ...unavailableSessionReadState(summary.id),
102
103
  })),
103
- nextCursor: null,
104
+ ...pageInfo,
105
+ ...(query && !query.cursor ? { overview: sessionListOverview(projectedSessions, query.archivedSessionIds) } : {}),
104
106
  };
105
107
  return result.value;
106
108
  }
@@ -1,4 +1,4 @@
1
- import type { SessionSnapshotMessage } from "../../sessions/types.js";
1
+ import type { SessionMessageIdentity } from "../../sessions/snapshot.js";
2
2
  import type { WebReadState } from "./store.js";
3
3
  export type VisibleMessageReceipt = {
4
4
  messageId: string;
@@ -14,8 +14,8 @@ export declare function isVisibleMessageReadState(value: unknown): value is Visi
14
14
  export declare function readVisibleMessageReceipts(value: unknown): WebReadState["visibleMessages"];
15
15
  export declare function visibleReadMessageIds(input: unknown): string[];
16
16
  export declare function visibleReadObservations(ids: readonly string[], input: unknown): VisibleMessageReceipt[];
17
- export declare function markVisibleAssistantMessages(state: WebReadState, sessionId: string, messages: SessionSnapshotMessage[], observations: readonly VisibleMessageReceipt[], generation: unknown, now: number): void;
18
- export declare function projectVisibleSessionReadState(state: WebReadState, sessionId: string, messages: SessionSnapshotMessage[]): {
17
+ export declare function markVisibleAssistantMessages(state: WebReadState, sessionId: string, messages: SessionMessageIdentity[], observations: readonly VisibleMessageReceipt[], generation: unknown, now: number): void;
18
+ export declare function projectVisibleSessionReadState(state: WebReadState, sessionId: string, messages: SessionMessageIdentity[]): {
19
19
  sessionId: string;
20
20
  readStateStatus: "available";
21
21
  unreadMessageIds: (string | number)[];
@@ -15,7 +15,7 @@ export function renderLinuxCompanionScript(input) {
15
15
  set -euo pipefail
16
16
  umask 077
17
17
  if [ "$(uname -s)" != 'Linux' ]; then echo 'Run this setup on the Linux desktop host.' >&2; exit 1; fi
18
- if [ -n "\${WSL_DISTRO_NAME:-}" ]; then echo 'For a Windows desktop, use the Windows companion installer outside WSL.' >&2; exit 1; fi
18
+ if [ -n "\${WSL_DISTRO_NAME:-}" ]; then echo 'For a Windows desktop, install ABot AI Companion from Microsoft Store on Windows.' >&2; exit 1; fi
19
19
  if [ -z "\${DISPLAY:-}" ] && [ -z "\${WAYLAND_DISPLAY:-}" ]; then echo 'Run this setup from your graphical desktop session.' >&2; exit 1; fi
20
20
  NODE=$(command -v node || true)
21
21
  if [ -z "$NODE" ] || [ ! -x "$NODE" ]; then echo 'Node.js 20.19+ or 22.12+ must already be installed on this computer.' >&2; exit 1; fi
@@ -1,7 +1,7 @@
1
1
  export declare class InstallerInputError extends Error {
2
2
  }
3
3
  export type CompanionInstallerInput = Readonly<{
4
- platform: "windows" | "macos" | "linux";
4
+ platform: "macos" | "linux";
5
5
  url: string;
6
6
  code: string;
7
7
  bundleSha256: string;
@@ -10,8 +10,8 @@ function hasLocalInstallerHost(hostname) {
10
10
  return isNativeLoopbackAddress(hostname);
11
11
  }
12
12
  export function validateCompanionInstaller(input) {
13
- if (!["windows", "macos", "linux"].includes(input.platform))
14
- throw new InstallerInputError("Choose Windows, macOS or Linux.");
13
+ if (!["macos", "linux"].includes(input.platform))
14
+ throw new InstallerInputError("Choose macOS or Linux. Windows Companion is installed and updated through Microsoft Store.");
15
15
  if (/[\x00-\x1f\x7f]/u.test(input.url))
16
16
  throw new InstallerInputError("The Runtime origin must not contain control characters.");
17
17
  let url;
@@ -1,6 +1,5 @@
1
1
  import JSZip from "jszip";
2
2
  import { validateCompanionInstaller, validateWslDistribution, } from "./installer-contract.js";
3
- import { renderWindowsCompanionScript } from "./companion-windows.js";
4
3
  import { renderMacCompanionScript } from "./companion-macos.js";
5
4
  import { renderLinuxCompanionScript } from "./companion-linux.js";
6
5
  import { renderWindowsWslInteropScript } from "./wsl-interop-windows.js";
@@ -13,12 +12,6 @@ export async function renderCompanionInstaller(raw) {
13
12
  mimeType: "application/x-sh",
14
13
  contentBase64: Buffer.from(renderLinuxCompanionScript(input), "utf8").toString("base64"),
15
14
  };
16
- if (input.platform === "windows")
17
- return {
18
- filename: "ABot-Connect-Computer.cmd",
19
- mimeType: "application/octet-stream",
20
- contentBase64: Buffer.from(renderWindowsCompanionScript(input), "utf8").toString("base64"),
21
- };
22
15
  const zip = new JSZip();
23
16
  zip.file("ABot-Connect-Computer.command", renderMacCompanionScript(input), {
24
17
  unixPermissions: 0o100755,
@@ -2,20 +2,23 @@ import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import type { HostPairingStore } from "../../computer-access/companion/pairing-store.js";
3
3
  import { installLocalMacCompanion } from "../../computer-access/companion/local-installation.js";
4
4
  import type { HostReadiness } from "./readiness.js";
5
+ import { HostSetupMutation } from "./setup-mutation.js";
5
6
  export declare const LOCAL_HOST_SETUP_PATH = "/web-api/runtime/system-host/connect-local";
6
7
  export declare class LocalHostConnection {
7
8
  private readonly dependencies;
8
- private pending?;
9
+ private readonly mutation;
9
10
  constructor(dependencies: {
10
11
  store: HostPairingStore;
11
12
  readiness(): Promise<HostReadiness>;
12
13
  prepareCompanion(): Promise<void>;
13
14
  bundle(): Promise<Buffer>;
14
15
  install?: typeof installLocalMacCompanion;
16
+ mutation?: HostSetupMutation;
15
17
  });
16
18
  get busy(): boolean;
17
19
  rejectConcurrentMutation(response: ServerResponse): boolean;
18
20
  handle(request: IncomingMessage, response: ServerResponse): Promise<void>;
21
+ private completeConnection;
19
22
  private connect;
20
23
  close(): Promise<void>;
21
24
  }