@abot-ai/runtime 1.3.1 → 1.4.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 (634) hide show
  1. package/dist/plugins/system/source/application-catalog.d.ts +14 -0
  2. package/dist/plugins/system/source/application-catalog.js +185 -0
  3. package/dist/plugins/system/source/application-launch.d.ts +10 -0
  4. package/dist/plugins/system/source/application-launch.js +80 -0
  5. package/dist/plugins/system/source/application-observation.d.ts +25 -0
  6. package/dist/plugins/system/source/application-observation.js +53 -0
  7. package/dist/plugins/system/source/commands.d.ts +7 -0
  8. package/dist/plugins/system/source/commands.js +71 -0
  9. package/dist/plugins/system/source/companion/autostart.d.ts +16 -0
  10. package/dist/plugins/system/source/companion/autostart.js +146 -0
  11. package/dist/plugins/system/source/companion/broker-location.d.ts +11 -0
  12. package/dist/plugins/system/source/companion/broker-location.js +76 -0
  13. package/dist/plugins/system/source/companion/broker-server.d.ts +4 -0
  14. package/dist/plugins/system/source/companion/broker-server.js +147 -0
  15. package/dist/plugins/system/source/companion/connection.d.ts +25 -0
  16. package/dist/plugins/system/source/companion/connection.js +182 -0
  17. package/dist/plugins/system/source/companion/liveness.d.ts +3 -0
  18. package/dist/plugins/system/source/companion/liveness.js +20 -0
  19. package/dist/plugins/system/source/companion/native-address.d.ts +12 -0
  20. package/dist/plugins/system/source/companion/native-address.js +41 -0
  21. package/dist/plugins/system/source/companion/native-identity.d.ts +2 -0
  22. package/dist/plugins/system/source/companion/native-identity.js +23 -0
  23. package/dist/plugins/system/source/companion/native-messages.d.ts +9 -0
  24. package/dist/plugins/system/source/companion/native-messages.js +77 -0
  25. package/dist/plugins/system/source/companion/native-session.d.ts +19 -0
  26. package/dist/plugins/system/source/companion/native-session.js +205 -0
  27. package/dist/plugins/system/source/companion/native-state.d.ts +22 -0
  28. package/dist/plugins/system/source/companion/native-state.js +126 -0
  29. package/dist/plugins/system/source/companion/native-supervisor.d.ts +10 -0
  30. package/dist/plugins/system/source/companion/native-supervisor.js +93 -0
  31. package/dist/plugins/system/source/companion/pairing-store.d.ts +22 -0
  32. package/dist/plugins/system/source/companion/pairing-store.js +102 -0
  33. package/dist/plugins/system/source/companion/private-store.d.ts +4 -0
  34. package/dist/plugins/system/source/companion/private-store.js +59 -0
  35. package/dist/plugins/system/source/companion/process-owner-identity.d.ts +22 -0
  36. package/dist/plugins/system/source/companion/process-owner-identity.js +144 -0
  37. package/dist/plugins/system/source/companion/protocol.d.ts +57 -0
  38. package/dist/plugins/system/source/companion/protocol.js +66 -0
  39. package/dist/plugins/system/source/contracts.d.ts +38 -0
  40. package/dist/plugins/system/source/contracts.js +7 -0
  41. package/dist/plugins/system/source/elevation.d.ts +8 -0
  42. package/dist/plugins/system/source/elevation.js +57 -0
  43. package/dist/plugins/system/source/handlers.d.ts +3 -0
  44. package/dist/plugins/system/source/handlers.js +90 -0
  45. package/dist/plugins/system/source/host-evidence.d.ts +4 -0
  46. package/dist/plugins/system/source/host-evidence.js +52 -0
  47. package/dist/plugins/system/source/host-observation.d.ts +25 -0
  48. package/dist/plugins/system/source/host-observation.js +59 -0
  49. package/dist/plugins/system/source/process-result.d.ts +4 -0
  50. package/dist/plugins/system/source/process-result.js +86 -0
  51. package/dist/plugins/system/source/process-runner.d.ts +3 -0
  52. package/dist/plugins/system/source/process-runner.js +103 -0
  53. package/dist/plugins/system/source/target-observation.d.ts +18 -0
  54. package/dist/plugins/system/source/target-observation.js +29 -0
  55. package/dist/plugins/system/source/targets.d.ts +8 -0
  56. package/dist/plugins/system/source/targets.js +101 -0
  57. package/dist/scripts/add-runtime-model.js +10 -53
  58. package/dist/scripts/runtime-model-addition.d.ts +13 -0
  59. package/dist/scripts/runtime-model-addition.js +53 -0
  60. package/dist/scripts/runtime-setup-files.d.ts +3 -1
  61. package/dist/scripts/runtime-setup-files.js +18 -1
  62. package/dist/src/capabilities/file-output-presentation.d.ts +43 -0
  63. package/dist/src/capabilities/file-output-presentation.js +133 -0
  64. package/dist/src/capabilities/tool-definition-validator/definition-parser.js +2 -0
  65. package/dist/src/capabilities/tool-definition-validator/event-input-text-options.d.ts +5 -0
  66. package/dist/src/capabilities/tool-definition-validator/event-input-text-options.js +37 -0
  67. package/dist/src/capabilities/tool-definition-validator/event-presentation.js +3 -0
  68. package/dist/src/capabilities/tool-definition-validator/module-registry.js +12 -0
  69. package/dist/src/capabilities/tool-event-input-text.d.ts +9 -0
  70. package/dist/src/capabilities/tool-event-input-text.js +64 -0
  71. package/dist/src/capabilities/tool-event-metadata.js +10 -0
  72. package/dist/src/capabilities/tool-executor.d.ts +1 -0
  73. package/dist/src/capabilities/tool-executor.js +1 -0
  74. package/dist/src/capabilities/tool-permission-mode.d.ts +7 -0
  75. package/dist/src/capabilities/tool-permission-mode.js +27 -0
  76. package/dist/src/capabilities/tool-types.d.ts +18 -2
  77. package/dist/src/cli/abot.js +18 -15
  78. package/dist/src/cli/host-companion-bundle.mjs +5201 -0
  79. package/dist/src/cli/host-companion-entry.d.ts +8 -0
  80. package/dist/src/cli/host-companion-entry.js +70 -0
  81. package/dist/src/cli/host-companion-startup.d.ts +4 -0
  82. package/dist/src/cli/host-companion-startup.js +35 -0
  83. package/dist/src/cli/host-companion.d.ts +5 -0
  84. package/dist/src/cli/host-companion.js +203 -0
  85. package/dist/src/model-gateway/server/configuration.js +4 -1
  86. package/dist/src/model-gateway/server/contracts.d.ts +2 -0
  87. package/dist/src/plugin-contract/entrypoint.d.ts +4 -2
  88. package/dist/src/plugin-contract/manifest.d.ts +1 -0
  89. package/dist/src/runtime/adapters/config-file-transaction.d.ts +46 -0
  90. package/dist/src/runtime/adapters/config-file-transaction.js +158 -0
  91. package/dist/src/runtime/adapters/configured-skill-provider.js +3 -3
  92. package/dist/src/runtime/adapters/in-memory-session-store.js +11 -1
  93. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.js +7 -3
  94. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.d.ts +4 -1
  95. package/dist/src/runtime/adapters/long-term-memory/file-lock/install.d.ts +1 -1
  96. package/dist/src/runtime/adapters/long-term-memory/file-lock/install.js +5 -1
  97. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-identity.d.ts +3 -0
  98. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-identity.js +15 -0
  99. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-record.js +2 -0
  100. package/dist/src/runtime/adapters/long-term-memory/onboarding-config-repository.js +17 -43
  101. package/dist/src/runtime/adapters/registered-tool-normal-invocations/catalog/registrations.js +6 -2
  102. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.js +10 -1
  103. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/execution-binding.d.ts +11 -0
  104. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/execution-binding.js +37 -0
  105. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/file-output-presentation.d.ts +7 -0
  106. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/file-output-presentation.js +105 -0
  107. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.js +29 -3
  108. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/action-fingerprint.d.ts +1 -0
  109. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/action-fingerprint.js +1 -0
  110. package/dist/src/runtime/capabilities/configured-tool-registry.js +9 -1
  111. package/dist/src/runtime/capabilities/file-output-root-identity.d.ts +5 -0
  112. package/dist/src/runtime/capabilities/file-output-root-identity.js +146 -0
  113. package/dist/src/runtime/capabilities/file-output-root-marker-creation.d.ts +5 -0
  114. package/dist/src/runtime/capabilities/file-output-root-marker-creation.js +63 -0
  115. package/dist/src/runtime/capabilities/request-bound-tool-registry.d.ts +1 -0
  116. package/dist/src/runtime/capabilities/request-bound-tool-registry.js +6 -1
  117. package/dist/src/runtime/capabilities/request-module-preparation.d.ts +3 -0
  118. package/dist/src/runtime/capabilities/request-module-preparation.js +102 -0
  119. package/dist/src/runtime/capabilities/request-permission-catalog.d.ts +10 -0
  120. package/dist/src/runtime/capabilities/request-permission-catalog.js +50 -0
  121. package/dist/src/runtime/capabilities/request-permission-tool-registry.d.ts +4 -0
  122. package/dist/src/runtime/capabilities/request-permission-tool-registry.js +61 -0
  123. package/dist/src/runtime/capabilities/request-runtime-tool-registry.d.ts +3 -0
  124. package/dist/src/runtime/capabilities/request-runtime-tool-registry.js +5 -2
  125. package/dist/src/runtime/capabilities/request-working-directory.d.ts +3 -0
  126. package/dist/src/runtime/capabilities/request-working-directory.js +12 -0
  127. package/dist/src/runtime/composition.d.ts +2 -0
  128. package/dist/src/runtime/config/runner/loader.d.ts +4 -0
  129. package/dist/src/runtime/config/runner/loader.js +23 -3
  130. package/dist/src/runtime/context/capability-brief-budget.d.ts +18 -0
  131. package/dist/src/runtime/context/capability-brief-budget.js +38 -0
  132. package/dist/src/runtime/context/capability-brief-readmission.d.ts +21 -0
  133. package/dist/src/runtime/context/capability-brief-readmission.js +47 -0
  134. package/dist/src/runtime/context/capability-brief.d.ts +9 -2
  135. package/dist/src/runtime/context/capability-brief.js +21 -39
  136. package/dist/src/runtime/context/capability-descriptions.d.ts +3 -0
  137. package/dist/src/runtime/context/capability-descriptions.js +23 -0
  138. package/dist/src/runtime/default-environment-adapters.js +3 -4
  139. package/dist/src/runtime/local-application.d.ts +18 -0
  140. package/dist/src/runtime/local-application.js +12 -0
  141. package/dist/src/runtime/local-host/app-service-dispatch.d.ts +1 -0
  142. package/dist/src/runtime/local-host/app-service-dispatch.js +9 -0
  143. package/dist/src/runtime/local-host/client-services.d.ts +16 -0
  144. package/dist/src/runtime/local-host/client-services.js +3 -2
  145. package/dist/src/runtime/local-host/contracts.d.ts +4 -0
  146. package/dist/src/runtime/local-host/startup-connection.js +22 -7
  147. package/dist/src/runtime/local-host/transport.js +14 -2
  148. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +5 -2
  149. package/dist/src/runtime/orchestration/role-calls/command-decoder.js +3 -0
  150. package/dist/src/runtime/orchestration/role-calls/command-dispatch/work-plan-transition.d.ts +3 -0
  151. package/dist/src/runtime/orchestration/role-calls/command-dispatch/work-plan-transition.js +46 -0
  152. package/dist/src/runtime/orchestration/role-calls/command-dispatch.js +3 -0
  153. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +8 -4
  154. package/dist/src/runtime/orchestration/role-calls/transactions.js +2 -0
  155. package/dist/src/runtime/orchestration/role-calls/work-plan-contracts.d.ts +48 -0
  156. package/dist/src/runtime/orchestration/role-calls/work-plan-contracts.js +9 -0
  157. package/dist/src/runtime/orchestration/role-calls/work-plan-source.d.ts +7 -0
  158. package/dist/src/runtime/orchestration/role-calls/work-plan-source.js +85 -0
  159. package/dist/src/runtime/orchestration/role-calls/work-plan-transactions.d.ts +3 -0
  160. package/dist/src/runtime/orchestration/role-calls/work-plan-transactions.js +17 -0
  161. package/dist/src/runtime/orchestration/role-calls/work-plan-validation.d.ts +10 -0
  162. package/dist/src/runtime/orchestration/role-calls/work-plan-validation.js +149 -0
  163. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +1 -1
  164. package/dist/src/runtime/orchestration/worker-capabilities/contracts.js +1 -1
  165. package/dist/src/runtime/plugins/compiled-catalog.d.ts +2 -1
  166. package/dist/src/runtime/plugins/configured-manifests.d.ts +3 -0
  167. package/dist/src/runtime/plugins/configured-manifests.js +37 -0
  168. package/dist/src/runtime/plugins/entrypoint-validation.d.ts +6 -0
  169. package/dist/src/runtime/plugins/entrypoint-validation.js +74 -0
  170. package/dist/src/runtime/plugins/loader.js +11 -123
  171. package/dist/src/runtime/plugins/manifest-discovery.d.ts +4 -1
  172. package/dist/src/runtime/plugins/manifest-discovery.js +8 -1
  173. package/dist/src/runtime/plugins/manifest-projection.js +3 -0
  174. package/dist/src/runtime/plugins/manifest-validator.js +7 -1
  175. package/dist/src/runtime/plugins/runtime-capability-plugins.d.ts +4 -0
  176. package/dist/src/runtime/plugins/runtime-capability-plugins.js +7 -0
  177. package/dist/src/runtime/plugins/selection.d.ts +14 -0
  178. package/dist/src/runtime/plugins/selection.js +38 -0
  179. package/dist/src/runtime/ports.d.ts +8 -2
  180. package/dist/src/runtime/projects/contracts.d.ts +40 -0
  181. package/dist/src/runtime/projects/contracts.js +10 -0
  182. package/dist/src/runtime/projects/folders.d.ts +7 -0
  183. package/dist/src/runtime/projects/folders.js +110 -0
  184. package/dist/src/runtime/projects/repository.d.ts +10 -0
  185. package/dist/src/runtime/projects/repository.js +54 -0
  186. package/dist/src/runtime/projects/service.d.ts +3 -0
  187. package/dist/src/runtime/projects/service.js +34 -0
  188. package/dist/src/runtime/projects/session-paths.d.ts +5 -0
  189. package/dist/src/runtime/projects/session-paths.js +13 -0
  190. package/dist/src/runtime/request/execution-agent-plan-update.d.ts +4 -0
  191. package/dist/src/runtime/request/execution-agent-plan-update.js +13 -0
  192. package/dist/src/runtime/request/execution-agent-root-execution.js +9 -1
  193. package/dist/src/runtime/request/handler.js +9 -2
  194. package/dist/src/runtime/request/input.d.ts +2 -1
  195. package/dist/src/runtime/request/input.js +1 -6
  196. package/dist/src/runtime/request/role-call-planner-events.js +4 -0
  197. package/dist/src/runtime/request/role-executor-composition.js +9 -1
  198. package/dist/src/runtime/request/root-contract.d.ts +6 -1
  199. package/dist/src/runtime/request/root-execution-kernel.js +17 -0
  200. package/dist/src/runtime/request/root-plan-event-projection.d.ts +3 -0
  201. package/dist/src/runtime/request/root-plan-event-projection.js +32 -0
  202. package/dist/src/runtime/request/root-plan-update.d.ts +15 -0
  203. package/dist/src/runtime/request/root-plan-update.js +20 -0
  204. package/dist/src/runtime/request/worker-capability-composition.d.ts +1 -0
  205. package/dist/src/runtime/request/worker-capability-composition.js +2 -0
  206. package/dist/src/runtime/runtime-environment.d.ts +1 -0
  207. package/dist/src/runtime/runtime-environment.js +2 -0
  208. package/dist/src/runtime/steps/auditor-decision/advisory-receipt.d.ts +32 -0
  209. package/dist/src/runtime/steps/auditor-decision/advisory-receipt.js +106 -0
  210. package/dist/src/runtime/steps/auditor-decision/advisory-result-budget.d.ts +5 -0
  211. package/dist/src/runtime/steps/auditor-decision/advisory-result-budget.js +40 -0
  212. package/dist/src/runtime/steps/auditor-decision/audit-input-state.d.ts +12 -0
  213. package/dist/src/runtime/steps/auditor-decision/audit-input-state.js +101 -0
  214. package/dist/src/runtime/steps/auditor-decision/contracts.d.ts +31 -16
  215. package/dist/src/runtime/steps/auditor-decision/contracts.js +3 -3
  216. package/dist/src/runtime/steps/auditor-decision/evidence-binding.d.ts +5 -0
  217. package/dist/src/runtime/steps/auditor-decision/evidence-binding.js +43 -0
  218. package/dist/src/runtime/steps/auditor-decision/evidence-coverage.d.ts +2 -0
  219. package/dist/src/runtime/steps/auditor-decision/evidence-coverage.js +71 -0
  220. package/dist/src/runtime/steps/auditor-decision/evidence-inventory.d.ts +13 -0
  221. package/dist/src/runtime/steps/auditor-decision/evidence-inventory.js +89 -0
  222. package/dist/src/runtime/steps/auditor-decision/evidence-representation.d.ts +10 -0
  223. package/dist/src/runtime/steps/auditor-decision/evidence-representation.js +56 -0
  224. package/dist/src/runtime/steps/auditor-decision/evidence-selection.d.ts +9 -0
  225. package/dist/src/runtime/steps/auditor-decision/evidence-selection.js +71 -0
  226. package/dist/src/runtime/steps/auditor-decision/format.js +44 -2
  227. package/dist/src/runtime/steps/auditor-decision/index.d.ts +3 -0
  228. package/dist/src/runtime/steps/auditor-decision/index.js +3 -0
  229. package/dist/src/runtime/steps/auditor-decision/input.d.ts +2 -2
  230. package/dist/src/runtime/steps/auditor-decision/input.js +64 -20
  231. package/dist/src/runtime/steps/auditor-decision/parser.js +38 -23
  232. package/dist/src/runtime/steps/auditor-decision/projection.js +49 -99
  233. package/dist/src/runtime/steps/auditor-decision/prompt.d.ts +1 -1
  234. package/dist/src/runtime/steps/auditor-decision/prompt.js +9 -4
  235. package/dist/src/runtime/steps/auditor-decision/run.js +79 -47
  236. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +8 -1
  237. package/dist/src/runtime/steps/execution-agent/contracts.js +2 -0
  238. package/dist/src/runtime/steps/execution-agent/decision-parsing.js +4 -0
  239. package/dist/src/runtime/steps/execution-agent/format.js +4 -3
  240. package/dist/src/runtime/steps/execution-agent/input.js +10 -11
  241. package/dist/src/runtime/steps/execution-agent/prompt.d.ts +1 -0
  242. package/dist/src/runtime/steps/execution-agent/prompt.js +11 -4
  243. package/dist/src/runtime/steps/execution-agent/state-context.js +10 -0
  244. package/dist/src/runtime/steps/execution-agent/work-plan-contract.d.ts +18 -0
  245. package/dist/src/runtime/steps/execution-agent/work-plan-contract.js +86 -0
  246. package/dist/src/runtime/steps/execution-agent/work-plan-decision-parsing.d.ts +2 -0
  247. package/dist/src/runtime/steps/execution-agent/work-plan-decision-parsing.js +38 -0
  248. package/dist/src/runtime/steps/execution-agent/work-plan-sources.d.ts +6 -0
  249. package/dist/src/runtime/steps/execution-agent/work-plan-sources.js +54 -0
  250. package/dist/src/runtime/steps/planner-decision/capability-brief.d.ts +40 -0
  251. package/dist/src/runtime/steps/planner-decision/capability-brief.js +47 -0
  252. package/dist/src/runtime/steps/planner-decision/input.d.ts +4 -2
  253. package/dist/src/runtime/steps/planner-decision/input.js +23 -13
  254. package/dist/src/runtime/steps/planner-decision/prompt.js +2 -2
  255. package/dist/src/runtime/steps/planner-decision/run.js +11 -7
  256. package/dist/src/runtime/steps/planner-graph/parser.js +0 -11
  257. package/dist/src/runtime/steps/planner-graph/prompt.js +2 -1
  258. package/dist/src/runtime/steps/supervisor-decision/capability-brief-readmission.d.ts +10 -0
  259. package/dist/src/runtime/steps/supervisor-decision/capability-brief-readmission.js +39 -0
  260. package/dist/src/runtime/steps/supervisor-decision/run.js +2 -1
  261. package/dist/src/runtime/steps/worker-decision/parser/accepted-decision.d.ts +3 -1
  262. package/dist/src/runtime/steps/worker-decision/parser/accepted-decision.js +20 -1
  263. package/dist/src/runtime/steps/worker-decision/parser/capability-batch-validation.d.ts +1 -1
  264. package/dist/src/runtime/steps/worker-decision/parser/capability-batch-validation.js +6 -6
  265. package/dist/src/runtime/steps/worker-decision/parser/capability-invocation-validation.js +2 -1
  266. package/dist/src/sessions/project-binding.d.ts +12 -0
  267. package/dist/src/sessions/project-binding.js +49 -0
  268. package/dist/src/sessions/record/projection.d.ts +6 -1
  269. package/dist/src/sessions/record/projection.js +1 -0
  270. package/dist/src/sessions/session-service.d.ts +2 -1
  271. package/dist/src/sessions/session-service.js +11 -1
  272. package/dist/src/sessions/types.d.ts +7 -0
  273. package/dist/src/web-ui/app/ARCHITECTURE.md +121 -1
  274. package/dist/src/web-ui/app/app-bootstrap.js +3 -0
  275. package/dist/src/web-ui/app/app-dom.js +3 -0
  276. package/dist/src/web-ui/app/app-state.js +38 -0
  277. package/dist/src/web-ui/app/app.js +76 -67
  278. package/dist/src/web-ui/app/components/config-workspace/config-model.js +23 -3
  279. package/dist/src/web-ui/app/components/config-workspace/dashboard-rendering.js +2 -0
  280. package/dist/src/web-ui/app/components/config-workspace/field-rendering.js +2 -0
  281. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +6 -0
  282. package/dist/src/web-ui/app/components/config-workspace/model-setup-entry.js +27 -0
  283. package/dist/src/web-ui/app/components/config-workspace/raw-config-repair.js +28 -0
  284. package/dist/src/web-ui/app/components/config-workspace/workspace-events.js +5 -0
  285. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +23 -3
  286. package/dist/src/web-ui/app/components/config-workspace/workspace-persistence.js +26 -8
  287. package/dist/src/web-ui/app/components/config-workspace/workspace-view.js +56 -0
  288. package/dist/src/web-ui/app/components/config-workspace.js +11 -0
  289. package/dist/src/web-ui/app/components/conversation-activity.d.ts +6 -0
  290. package/dist/src/web-ui/app/components/conversation-activity.js +10 -2
  291. package/dist/src/web-ui/app/components/conversation-file-action.js +33 -0
  292. package/dist/src/web-ui/app/components/conversation-file-focus.d.ts +12 -0
  293. package/dist/src/web-ui/app/components/conversation-file-focus.js +149 -0
  294. package/dist/src/web-ui/app/components/conversation-file-preview.d.ts +23 -0
  295. package/dist/src/web-ui/app/components/conversation-file-preview.js +247 -0
  296. package/dist/src/web-ui/app/components/conversation-role-cards.d.ts +6 -0
  297. package/dist/src/web-ui/app/components/conversation-role-cards.js +10 -2
  298. package/dist/src/web-ui/app/components/conversation-tool-evidence.d.ts +9 -0
  299. package/dist/src/web-ui/app/components/conversation-tool-evidence.js +129 -0
  300. package/dist/src/web-ui/app/components/conversation-tools.d.ts +6 -0
  301. package/dist/src/web-ui/app/components/conversation-tools.js +25 -105
  302. package/dist/src/web-ui/app/components/conversation-view.js +10 -1
  303. package/dist/src/web-ui/app/components/dashboard/workspace.js +19 -7
  304. package/dist/src/web-ui/app/components/model-setup/rendering.js +99 -0
  305. package/dist/src/web-ui/app/components/model-setup/save-flow.js +111 -0
  306. package/dist/src/web-ui/app/components/model-setup/save-outcome.js +16 -0
  307. package/dist/src/web-ui/app/components/model-setup/validation.js +125 -0
  308. package/dist/src/web-ui/app/components/model-setup/wizard.d.ts +44 -0
  309. package/dist/src/web-ui/app/components/model-setup/wizard.js +370 -0
  310. package/dist/src/web-ui/app/components/plugins/manager.js +200 -0
  311. package/dist/src/web-ui/app/components/plugins/rendering.js +124 -0
  312. package/dist/src/web-ui/app/components/plugins/view-state.js +123 -0
  313. package/dist/src/web-ui/app/components/project-creation.js +119 -0
  314. package/dist/src/web-ui/app/components/project-session-groups.js +95 -0
  315. package/dist/src/web-ui/app/components/runtime-config-activation.js +83 -0
  316. package/dist/src/web-ui/app/components/runtime-setup/bridge-guide.d.ts +9 -0
  317. package/dist/src/web-ui/app/components/runtime-setup/bridge-guide.js +198 -0
  318. package/dist/src/web-ui/app/components/runtime-setup/bridge-rendering.js +107 -0
  319. package/dist/src/web-ui/app/components/runtime-setup/commands.js +54 -0
  320. package/dist/src/web-ui/app/components/runtime-setup/configuration-recovery.js +25 -0
  321. package/dist/src/web-ui/app/components/runtime-setup/connection-form.js +154 -0
  322. package/dist/src/web-ui/app/components/runtime-setup/connection-state.js +71 -0
  323. package/dist/src/web-ui/app/components/runtime-setup/context-window.js +18 -0
  324. package/dist/src/web-ui/app/components/runtime-setup/embedding-credential-status.d.ts +15 -0
  325. package/dist/src/web-ui/app/components/runtime-setup/embedding-credential-status.js +87 -0
  326. package/dist/src/web-ui/app/components/runtime-setup/embedding-provider-receipt.js +30 -0
  327. package/dist/src/web-ui/app/components/runtime-setup/embedding-rendering.js +57 -0
  328. package/dist/src/web-ui/app/components/runtime-setup/embedding.js +284 -0
  329. package/dist/src/web-ui/app/components/runtime-setup/optional-steps.js +117 -0
  330. package/dist/src/web-ui/app/components/runtime-setup/plugins.js +173 -0
  331. package/dist/src/web-ui/app/components/runtime-setup/rendering.js +141 -0
  332. package/dist/src/web-ui/app/components/runtime-setup/validation.js +69 -0
  333. package/dist/src/web-ui/app/components/runtime-setup/view-state.js +58 -0
  334. package/dist/src/web-ui/app/components/runtime-setup/wizard-shell.js +27 -0
  335. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +66 -5
  336. package/dist/src/web-ui/app/components/runtime-setup-guide.js +415 -461
  337. package/dist/src/web-ui/app/components/system-host/download.js +38 -0
  338. package/dist/src/web-ui/app/components/system-host/manager.js +249 -0
  339. package/dist/src/web-ui/app/components/system-host/rendering.js +88 -0
  340. package/dist/src/web-ui/app/components/system-host/setup-notice.js +87 -0
  341. package/dist/src/web-ui/app/components/system-host/visibility.js +35 -0
  342. package/dist/src/web-ui/app/components/tool-approval-card.d.ts +4 -0
  343. package/dist/src/web-ui/app/components/tool-approval-card.js +15 -0
  344. package/dist/src/web-ui/app/configuration-environment-refresh.js +118 -0
  345. package/dist/src/web-ui/app/configuration-feature.js +125 -4
  346. package/dist/src/web-ui/app/controllers/app-event-bindings.js +2 -0
  347. package/dist/src/web-ui/app/controllers/composer-workspace-controller.d.ts +1 -0
  348. package/dist/src/web-ui/app/controllers/composer-workspace-controller.js +4 -3
  349. package/dist/src/web-ui/app/controllers/conversation-file-preview-controller.d.ts +24 -0
  350. package/dist/src/web-ui/app/controllers/conversation-file-preview-controller.js +158 -0
  351. package/dist/src/web-ui/app/controllers/conversation-file-preview-feature.d.ts +19 -0
  352. package/dist/src/web-ui/app/controllers/conversation-file-preview-feature.js +63 -0
  353. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +1 -0
  354. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +2 -0
  355. package/dist/src/web-ui/app/controllers/conversation-view-feature.js +28 -0
  356. package/dist/src/web-ui/app/controllers/dashboard-controller.js +17 -0
  357. package/dist/src/web-ui/app/controllers/projects-controller.d.ts +45 -0
  358. package/dist/src/web-ui/app/controllers/projects-controller.js +278 -0
  359. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +3 -0
  360. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.js +13 -6
  361. package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts +7 -1
  362. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +11 -95
  363. package/dist/src/web-ui/app/controllers/session-controller.js +64 -57
  364. package/dist/src/web-ui/app/controllers/tool-permission-mode-controller.d.ts +20 -0
  365. package/dist/src/web-ui/app/controllers/tool-permission-mode-controller.js +116 -0
  366. package/dist/src/web-ui/app/dashboard-feature.js +32 -10
  367. package/dist/src/web-ui/app/index.html +44 -7
  368. package/dist/src/web-ui/app/lib/conversation-file-preview.d.ts +12 -0
  369. package/dist/src/web-ui/app/lib/conversation-file-reference.d.ts +30 -0
  370. package/dist/src/web-ui/app/lib/conversation-file-reference.js +66 -0
  371. package/dist/src/web-ui/app/lib/tool-activity-event.d.ts +2 -0
  372. package/dist/src/web-ui/app/lib/tool-activity-event.js +18 -6
  373. package/dist/src/web-ui/app/lib/tool-activity-model.d.ts +2 -0
  374. package/dist/src/web-ui/app/lib/tool-activity-model.js +4 -2
  375. package/dist/src/web-ui/app/lib/tool-permission-mode.d.ts +16 -0
  376. package/dist/src/web-ui/app/lib/tool-permission-mode.js +60 -0
  377. package/dist/src/web-ui/app/lib/tool-process-activity-fields.js +102 -0
  378. package/dist/src/web-ui/app/projects-feature.js +134 -0
  379. package/dist/src/web-ui/app/runtime-onboarding-feature.d.ts +34 -0
  380. package/dist/src/web-ui/app/runtime-onboarding-feature.js +92 -0
  381. package/dist/src/web-ui/app/runtime-setup-page-lifecycle.d.ts +5 -0
  382. package/dist/src/web-ui/app/runtime-setup-page-lifecycle.js +13 -0
  383. package/dist/src/web-ui/app/services/client-preferences.d.ts +24 -0
  384. package/dist/src/web-ui/app/services/client-preferences.js +32 -19
  385. package/dist/src/web-ui/app/services/runtime-web-client/configuration.js +46 -0
  386. package/dist/src/web-ui/app/services/runtime-web-client/conversation-files.d.ts +28 -0
  387. package/dist/src/web-ui/app/services/runtime-web-client/conversation-files.js +75 -0
  388. package/dist/src/web-ui/app/services/runtime-web-client/projects.d.ts +19 -0
  389. package/dist/src/web-ui/app/services/runtime-web-client/projects.js +34 -0
  390. package/dist/src/web-ui/app/services/runtime-web-client/system-host.js +27 -0
  391. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +52 -0
  392. package/dist/src/web-ui/app/services/runtime-web-client.js +35 -4
  393. package/dist/src/web-ui/app/styles/13-projects.css +272 -0
  394. package/dist/src/web-ui/app/styles/18-dashboard.css +0 -5
  395. package/dist/src/web-ui/app/styles/19-runtime-setup.css +411 -0
  396. package/dist/src/web-ui/app/styles/20-chat-composer.css +0 -384
  397. package/dist/src/web-ui/app/styles/29-conversation-file-preview.css +254 -0
  398. package/dist/src/web-ui/app/styles/37-runtime-activation.css +26 -0
  399. package/dist/src/web-ui/app/styles/38-schedule-workspace.css +1 -10
  400. package/dist/src/web-ui/app/styles/41-plugin-management.css +351 -0
  401. package/dist/src/web-ui/app/styles/42-runtime-setup-plugins.css +179 -0
  402. package/dist/src/web-ui/app/styles/43-model-setup.css +73 -0
  403. package/dist/src/web-ui/app/styles/44-model-provider-cards.css +63 -0
  404. package/dist/src/web-ui/app/styles/45-bridge-setup.css +44 -0
  405. package/dist/src/web-ui/app/styles/46-system-host.css +132 -0
  406. package/dist/src/web-ui/app/styles.css +10 -0
  407. package/dist/src/web-ui/config-dashboard-backend.d.ts +5 -0
  408. package/dist/src/web-ui/config-dashboard-backend.js +94 -114
  409. package/dist/src/web-ui/config-dashboard-model-identity.d.ts +7 -0
  410. package/dist/src/web-ui/config-dashboard-model-identity.js +45 -0
  411. package/dist/src/web-ui/config-dashboard-save-transaction.d.ts +5 -0
  412. package/dist/src/web-ui/config-dashboard-save-transaction.js +21 -0
  413. package/dist/src/web-ui/environment-config.d.ts +17 -0
  414. package/dist/src/web-ui/environment-config.js +60 -0
  415. package/dist/src/web-ui/forwarded-loopback-policy.d.ts +2 -0
  416. package/dist/src/web-ui/forwarded-loopback-policy.js +14 -0
  417. package/dist/src/web-ui/local-runtime/api-router.d.ts +7 -0
  418. package/dist/src/web-ui/local-runtime/api-router.js +136 -12
  419. package/dist/src/web-ui/local-runtime/config-mutation-request.d.ts +8 -0
  420. package/dist/src/web-ui/local-runtime/config-mutation-request.js +55 -0
  421. package/dist/src/web-ui/local-runtime/configuration-activation-environments.d.ts +22 -0
  422. package/dist/src/web-ui/local-runtime/configuration-activation-environments.js +106 -0
  423. package/dist/src/web-ui/local-runtime/configuration-activation-source.d.ts +7 -0
  424. package/dist/src/web-ui/local-runtime/configuration-activation-source.js +36 -0
  425. package/dist/src/web-ui/local-runtime/configuration-activation.d.ts +20 -0
  426. package/dist/src/web-ui/local-runtime/configuration-activation.js +107 -0
  427. package/dist/src/web-ui/local-runtime/contracts.d.ts +8 -0
  428. package/dist/src/web-ui/local-runtime/conversation-file-access.d.ts +30 -0
  429. package/dist/src/web-ui/local-runtime/conversation-file-access.js +131 -0
  430. package/dist/src/web-ui/local-runtime/conversation-file-content.d.ts +21 -0
  431. package/dist/src/web-ui/local-runtime/conversation-file-content.js +75 -0
  432. package/dist/src/web-ui/local-runtime/conversation-file-format.d.ts +12 -0
  433. package/dist/src/web-ui/local-runtime/conversation-file-format.js +87 -0
  434. package/dist/src/web-ui/local-runtime/conversation-file-native-open.d.ts +10 -0
  435. package/dist/src/web-ui/local-runtime/conversation-file-native-open.js +94 -0
  436. package/dist/src/web-ui/local-runtime/conversation-file-native-request.d.ts +4 -0
  437. package/dist/src/web-ui/local-runtime/conversation-file-native-request.js +72 -0
  438. package/dist/src/web-ui/local-runtime/conversation-file-routes.d.ts +11 -0
  439. package/dist/src/web-ui/local-runtime/conversation-file-routes.js +105 -0
  440. package/dist/src/web-ui/local-runtime/conversation-file-target.d.ts +14 -0
  441. package/dist/src/web-ui/local-runtime/conversation-file-target.js +158 -0
  442. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +14 -0
  443. package/dist/src/web-ui/local-runtime/environment-registry.js +121 -6
  444. package/dist/src/web-ui/local-runtime/memory-onboarding-routes.d.ts +2 -1
  445. package/dist/src/web-ui/local-runtime/memory-onboarding-routes.js +15 -10
  446. package/dist/src/web-ui/local-runtime/model-setup-catalog.d.ts +17 -0
  447. package/dist/src/web-ui/local-runtime/model-setup-catalog.js +45 -0
  448. package/dist/src/web-ui/local-runtime/model-setup-identity.d.ts +16 -0
  449. package/dist/src/web-ui/local-runtime/model-setup-identity.js +20 -0
  450. package/dist/src/web-ui/local-runtime/model-setup-input.d.ts +24 -0
  451. package/dist/src/web-ui/local-runtime/model-setup-input.js +107 -0
  452. package/dist/src/web-ui/local-runtime/model-setup-provider.d.ts +17 -0
  453. package/dist/src/web-ui/local-runtime/model-setup-provider.js +68 -0
  454. package/dist/src/web-ui/local-runtime/model-setup-retry.d.ts +14 -0
  455. package/dist/src/web-ui/local-runtime/model-setup-retry.js +47 -0
  456. package/dist/src/web-ui/local-runtime/model-setup-routes.d.ts +12 -0
  457. package/dist/src/web-ui/local-runtime/model-setup-routes.js +50 -0
  458. package/dist/src/web-ui/local-runtime/model-setup-service.d.ts +30 -0
  459. package/dist/src/web-ui/local-runtime/model-setup-service.js +93 -0
  460. package/dist/src/web-ui/local-runtime/model-setup-validation.d.ts +5 -0
  461. package/dist/src/web-ui/local-runtime/model-setup-validation.js +33 -0
  462. package/dist/src/web-ui/local-runtime/plugin-management-routes.d.ts +14 -0
  463. package/dist/src/web-ui/local-runtime/plugin-management-routes.js +50 -0
  464. package/dist/src/web-ui/local-runtime/project-routes.d.ts +17 -0
  465. package/dist/src/web-ui/local-runtime/project-routes.js +93 -0
  466. package/dist/src/web-ui/local-runtime/provider-credential-identity.d.ts +3 -0
  467. package/dist/src/web-ui/local-runtime/provider-credential-identity.js +18 -0
  468. package/dist/src/web-ui/local-runtime/request-execution.d.ts +1 -0
  469. package/dist/src/web-ui/local-runtime/request-execution.js +8 -0
  470. package/dist/src/web-ui/local-runtime/runtime-availability.js +36 -7
  471. package/dist/src/web-ui/local-runtime/runtime-setup-completion.d.ts +13 -0
  472. package/dist/src/web-ui/local-runtime/runtime-setup-completion.js +28 -0
  473. package/dist/src/web-ui/local-runtime/runtime-setup-connection-edit.d.ts +13 -0
  474. package/dist/src/web-ui/local-runtime/runtime-setup-connection-edit.js +110 -0
  475. package/dist/src/web-ui/local-runtime/runtime-setup-credential-completion.d.ts +4 -0
  476. package/dist/src/web-ui/local-runtime/runtime-setup-credential-completion.js +21 -0
  477. package/dist/src/web-ui/local-runtime/runtime-setup-credentials.d.ts +14 -0
  478. package/dist/src/web-ui/local-runtime/runtime-setup-credentials.js +148 -0
  479. package/dist/src/web-ui/local-runtime/runtime-setup-draft-recovery.d.ts +7 -0
  480. package/dist/src/web-ui/local-runtime/runtime-setup-draft-recovery.js +18 -0
  481. package/dist/src/web-ui/local-runtime/runtime-setup-draft.d.ts +21 -0
  482. package/dist/src/web-ui/local-runtime/runtime-setup-draft.js +105 -0
  483. package/dist/src/web-ui/local-runtime/runtime-setup-embedding-invalidation.d.ts +8 -0
  484. package/dist/src/web-ui/local-runtime/runtime-setup-embedding-invalidation.js +40 -0
  485. package/dist/src/web-ui/local-runtime/runtime-setup-environment-assignment.d.ts +1 -0
  486. package/dist/src/web-ui/local-runtime/runtime-setup-environment-assignment.js +27 -0
  487. package/dist/src/web-ui/local-runtime/runtime-setup-input.d.ts +19 -0
  488. package/dist/src/web-ui/local-runtime/runtime-setup-input.js +82 -0
  489. package/dist/src/web-ui/local-runtime/runtime-setup-model-file.d.ts +7 -0
  490. package/dist/src/web-ui/local-runtime/runtime-setup-model-file.js +35 -0
  491. package/dist/src/web-ui/local-runtime/runtime-setup-provider-ownership-recovery.d.ts +4 -0
  492. package/dist/src/web-ui/local-runtime/runtime-setup-provider-ownership-recovery.js +23 -0
  493. package/dist/src/web-ui/local-runtime/runtime-setup-provider-retention.d.ts +11 -0
  494. package/dist/src/web-ui/local-runtime/runtime-setup-provider-retention.js +31 -0
  495. package/dist/src/web-ui/local-runtime/runtime-setup-provider.d.ts +11 -0
  496. package/dist/src/web-ui/local-runtime/runtime-setup-provider.js +60 -0
  497. package/dist/src/web-ui/local-runtime/runtime-setup-receipt-file.d.ts +8 -0
  498. package/dist/src/web-ui/local-runtime/runtime-setup-receipt-file.js +77 -0
  499. package/dist/src/web-ui/local-runtime/runtime-setup-routes.d.ts +35 -0
  500. package/dist/src/web-ui/local-runtime/runtime-setup-routes.js +56 -0
  501. package/dist/src/web-ui/local-runtime/runtime-setup-scaffold.d.ts +17 -0
  502. package/dist/src/web-ui/local-runtime/runtime-setup-scaffold.js +229 -0
  503. package/dist/src/web-ui/local-runtime/runtime-setup-service.d.ts +65 -0
  504. package/dist/src/web-ui/local-runtime/runtime-setup-service.js +195 -0
  505. package/dist/src/web-ui/local-runtime/runtime-setup-validation.d.ts +8 -0
  506. package/dist/src/web-ui/local-runtime/runtime-setup-validation.js +35 -0
  507. package/dist/src/web-ui/local-runtime/saved-model-catalog.d.ts +3 -0
  508. package/dist/src/web-ui/local-runtime/saved-model-catalog.js +20 -0
  509. package/dist/src/web-ui/local-runtime/setup-embedding-input.d.ts +8 -0
  510. package/dist/src/web-ui/local-runtime/setup-embedding-input.js +71 -0
  511. package/dist/src/web-ui/local-runtime/setup-embedding-provider.d.ts +13 -0
  512. package/dist/src/web-ui/local-runtime/setup-embedding-provider.js +114 -0
  513. package/dist/src/web-ui/local-runtime/setup-embedding-routes.d.ts +12 -0
  514. package/dist/src/web-ui/local-runtime/setup-embedding-routes.js +53 -0
  515. package/dist/src/web-ui/local-runtime/setup-embedding-service.d.ts +32 -0
  516. package/dist/src/web-ui/local-runtime/setup-embedding-service.js +59 -0
  517. package/dist/src/web-ui/local-runtime-backend.d.ts +1 -0
  518. package/dist/src/web-ui/local-runtime-backend.js +3 -0
  519. package/dist/src/web-ui/plugin-capability-selection.d.ts +14 -0
  520. package/dist/src/web-ui/plugin-capability-selection.js +48 -0
  521. package/dist/src/web-ui/plugin-management-catalog.d.ts +26 -0
  522. package/dist/src/web-ui/plugin-management-catalog.js +56 -0
  523. package/dist/src/web-ui/plugin-management-selection.d.ts +16 -0
  524. package/dist/src/web-ui/plugin-management-selection.js +71 -0
  525. package/dist/src/web-ui/plugin-management-service.d.ts +29 -0
  526. package/dist/src/web-ui/plugin-management-service.js +150 -0
  527. package/dist/src/web-ui/request-authority.d.ts +8 -0
  528. package/dist/src/web-ui/request-authority.js +129 -0
  529. package/dist/src/web-ui/runtime-setup-gateway-address.d.ts +3 -0
  530. package/dist/src/web-ui/runtime-setup-gateway-address.js +26 -0
  531. package/dist/src/web-ui/runtime-setup-gateway.d.ts +29 -0
  532. package/dist/src/web-ui/runtime-setup-gateway.js +177 -0
  533. package/dist/src/web-ui/runtime-setup-shutdown.d.ts +2 -0
  534. package/dist/src/web-ui/runtime-setup-shutdown.js +20 -0
  535. package/dist/src/web-ui/server.d.ts +7 -14
  536. package/dist/src/web-ui/server.js +53 -63
  537. package/dist/src/web-ui/session-read-state/service.d.ts +12 -2
  538. package/dist/src/web-ui/system-host-service.d.ts +19 -0
  539. package/dist/src/web-ui/system-host-service.js +159 -0
  540. package/dist/src/web-ui/system-host-setup/companion-bundle.d.ts +2 -0
  541. package/dist/src/web-ui/system-host-setup/companion-bundle.js +12 -0
  542. package/dist/src/web-ui/system-host-setup/companion-macos.d.ts +2 -0
  543. package/dist/src/web-ui/system-host-setup/companion-macos.js +74 -0
  544. package/dist/src/web-ui/system-host-setup/companion-windows.d.ts +2 -0
  545. package/dist/src/web-ui/system-host-setup/companion-windows.js +105 -0
  546. package/dist/src/web-ui/system-host-setup/installer-contract.d.ts +18 -0
  547. package/dist/src/web-ui/system-host-setup/installer-contract.js +51 -0
  548. package/dist/src/web-ui/system-host-setup/installers.d.ts +6 -0
  549. package/dist/src/web-ui/system-host-setup/installers.js +30 -0
  550. package/dist/src/web-ui/system-host-setup/native-authorization.d.ts +3 -0
  551. package/dist/src/web-ui/system-host-setup/native-authorization.js +11 -0
  552. package/dist/src/web-ui/system-host-setup/node-distribution.d.ts +19 -0
  553. package/dist/src/web-ui/system-host-setup/node-distribution.js +9 -0
  554. package/dist/src/web-ui/system-host-setup/readiness.d.ts +18 -0
  555. package/dist/src/web-ui/system-host-setup/readiness.js +70 -0
  556. package/dist/src/web-ui/system-host-setup/routes.d.ts +20 -0
  557. package/dist/src/web-ui/system-host-setup/routes.js +121 -0
  558. package/dist/src/web-ui/system-host-setup/windows-script-wrapper.d.ts +2 -0
  559. package/dist/src/web-ui/system-host-setup/windows-script-wrapper.js +17 -0
  560. package/dist/src/web-ui/system-host-setup/wsl-interop-config.d.ts +3 -0
  561. package/dist/src/web-ui/system-host-setup/wsl-interop-config.js +67 -0
  562. package/dist/src/web-ui/system-host-setup/wsl-interop-windows.d.ts +1 -0
  563. package/dist/src/web-ui/system-host-setup/wsl-interop-windows.js +49 -0
  564. package/dist/src/web-ui/system-host-upgrade-authority.d.ts +5 -0
  565. package/dist/src/web-ui/system-host-upgrade-authority.js +13 -0
  566. package/docs/architecture.md +6 -1
  567. package/docs/installation.md +53 -17
  568. package/docs/known-limitations.md +14 -0
  569. package/docs/plugins.md +124 -19
  570. package/docs/projects-and-full-plus.md +218 -0
  571. package/docs/runtime-invariant-coverage.md +6 -3
  572. package/docs/runtime-prompt-policy-contracts.md +37 -5
  573. package/docs/runtime-public-contracts.md +17 -0
  574. package/package.json +5 -2
  575. package/plugins/exec/plugin.json +30 -9
  576. package/plugins/exec/skills/exec_process_skill/SKILL.md +1 -0
  577. package/plugins/exec/skills/exec_skill/SKILL.md +9 -10
  578. package/plugins/exec/source/handlers.ts +4 -38
  579. package/plugins/exec/source/paths.ts +53 -49
  580. package/plugins/exec/source/types.ts +6 -4
  581. package/plugins/exec/source/validation.ts +33 -198
  582. package/plugins/exec/src/index.cjs +62 -204
  583. package/plugins/filesystem/plugin.json +1 -1
  584. package/plugins/filesystem/skills/dev_view_skill/SKILL.md +7 -0
  585. package/plugins/filesystem/source/atomic-write.ts +6 -3
  586. package/plugins/filesystem/source/dev-view.ts +2 -1
  587. package/plugins/filesystem/source/directory-authority-write.ts +4 -0
  588. package/plugins/filesystem/source/edit-file.ts +3 -0
  589. package/plugins/filesystem/source/file-output-presentation.ts +42 -0
  590. package/plugins/filesystem/source/mutation-parent.ts +18 -9
  591. package/plugins/filesystem/source/view-locator.ts +141 -0
  592. package/plugins/filesystem/source/view-window.ts +12 -25
  593. package/plugins/filesystem/source/write-file.ts +8 -0
  594. package/plugins/filesystem/src/index.cjs +162 -35
  595. package/plugins/system/plugin.json +374 -0
  596. package/plugins/system/skills/system_actions/SKILL.md +31 -0
  597. package/plugins/system/source/application-catalog.ts +237 -0
  598. package/plugins/system/source/application-launch.ts +113 -0
  599. package/plugins/system/source/application-observation.ts +78 -0
  600. package/plugins/system/source/commands.ts +106 -0
  601. package/plugins/system/source/companion/autostart.ts +185 -0
  602. package/plugins/system/source/companion/broker-client.ts +183 -0
  603. package/plugins/system/source/companion/broker-location.ts +89 -0
  604. package/plugins/system/source/companion/broker-server.ts +169 -0
  605. package/plugins/system/source/companion/connection.ts +211 -0
  606. package/plugins/system/source/companion/liveness.ts +23 -0
  607. package/plugins/system/source/companion/native-address.ts +55 -0
  608. package/plugins/system/source/companion/native-identity.ts +26 -0
  609. package/plugins/system/source/companion/native-messages.ts +100 -0
  610. package/plugins/system/source/companion/native-session.ts +268 -0
  611. package/plugins/system/source/companion/native-state.ts +135 -0
  612. package/plugins/system/source/companion/native-supervisor.ts +98 -0
  613. package/plugins/system/source/companion/pairing-store.ts +110 -0
  614. package/plugins/system/source/companion/private-store.ts +58 -0
  615. package/plugins/system/source/companion/process-owner-identity.ts +190 -0
  616. package/plugins/system/source/companion/protocol.ts +108 -0
  617. package/plugins/system/source/contracts.ts +44 -0
  618. package/plugins/system/source/elevation.ts +88 -0
  619. package/plugins/system/source/handlers.ts +120 -0
  620. package/plugins/system/source/host-dispatch.ts +106 -0
  621. package/plugins/system/source/host-evidence.ts +72 -0
  622. package/plugins/system/source/host-observation.ts +66 -0
  623. package/plugins/system/source/index.ts +8 -0
  624. package/plugins/system/source/process-result.ts +111 -0
  625. package/plugins/system/source/process-runner.ts +104 -0
  626. package/plugins/system/source/request-system-modules.ts +117 -0
  627. package/plugins/system/source/request-target-snapshot.ts +163 -0
  628. package/plugins/system/source/target-observation.ts +43 -0
  629. package/plugins/system/source/targets.ts +147 -0
  630. package/plugins/system/src/index.cjs +1730 -0
  631. package/src/runtime/README.md +36 -8
  632. package/src/runtime/local-host/README.md +7 -0
  633. package/dist/src/runtime/steps/planner-decision/capability-catalog-context.d.ts +0 -14
  634. package/dist/src/runtime/steps/planner-decision/capability-catalog-context.js +0 -87
@@ -0,0 +1,158 @@
1
+ import { constants, fstatSync, lstatSync, realpathSync, statSync, } from "node:fs";
2
+ import { open, realpath, stat } from "node:fs/promises";
3
+ import { isAbsolute, relative, resolve, sep } from "node:path";
4
+ import { createRuntimeToolPathResolver } from "../../runtime/capabilities/runtime-target-path.js";
5
+ import { readFileOutputRootId } from "../../runtime/capabilities/file-output-root-identity.js";
6
+ import { ConversationFileError } from "./conversation-file-format.js";
7
+ function unavailable() {
8
+ throw new ConversationFileError("conversation_file_unavailable", 404, "This file is no longer available in its original location.");
9
+ }
10
+ function changedRoot() {
11
+ throw new ConversationFileError("conversation_file_root_changed", 409, "The configured location changed. This earlier file cannot be opened here.");
12
+ }
13
+ function changedFile() {
14
+ throw new ConversationFileError("conversation_file_changed", 409, "The file changed while it was being read. Open it again to see the current content.");
15
+ }
16
+ async function assertRecordedRootIdentity(receipt, canonicalRoot) {
17
+ let currentRootId;
18
+ try {
19
+ currentRootId = readFileOutputRootId(receipt.location, canonicalRoot);
20
+ }
21
+ catch {
22
+ return changedRoot();
23
+ }
24
+ if (currentRootId !== receipt.rootId)
25
+ changedRoot();
26
+ }
27
+ async function resolveRecordedFile(receipt, paths) {
28
+ const resolver = createRuntimeToolPathResolver(paths);
29
+ const options = { allowedLocations: [receipt.location], requirePath: true };
30
+ let root;
31
+ try {
32
+ root = resolver.resolve(receipt.location === "workspace" ? "workspace" : ".", options);
33
+ }
34
+ catch {
35
+ return changedRoot();
36
+ }
37
+ await assertRecordedRootIdentity(receipt, root.rootPath);
38
+ let target;
39
+ try {
40
+ target = resolver.resolve(resolve(root.rootPath, receipt.relativePath), options);
41
+ }
42
+ catch {
43
+ return unavailable();
44
+ }
45
+ if (target.location !== receipt.location)
46
+ unavailable();
47
+ if (target.relativePath !== receipt.relativePath)
48
+ unavailable();
49
+ if (target.logicalPath !== receipt.logicalPath)
50
+ unavailable();
51
+ if (target.rootPath !== root.rootPath)
52
+ changedRoot();
53
+ return target;
54
+ }
55
+ function isContainedFile(root, path) {
56
+ const value = relative(root, path);
57
+ if (!value || isAbsolute(value))
58
+ return false;
59
+ if (value === "..")
60
+ return false;
61
+ return !value.startsWith(".." + sep);
62
+ }
63
+ function sameFileIdentity(left, right) {
64
+ if (left.dev !== right.dev)
65
+ return false;
66
+ return left.ino === right.ino;
67
+ }
68
+ function sameFileVersion(left, right) {
69
+ if (!sameFileIdentity(left, right))
70
+ return false;
71
+ if (left.size !== right.size)
72
+ return false;
73
+ if (left.mtimeNs !== right.mtimeNs)
74
+ return false;
75
+ return left.ctimeNs === right.ctimeNs;
76
+ }
77
+ async function assertOpenedFileAuthority(target, opened, receipt) {
78
+ const root = await realpath(target.rootPath);
79
+ await assertRecordedRootIdentity(receipt, root);
80
+ const canonicalPath = await realpath(target.absolutePath);
81
+ if (!isContainedFile(root, canonicalPath))
82
+ unavailable();
83
+ const current = await stat(canonicalPath, { bigint: true });
84
+ if (!current.isFile())
85
+ unavailable();
86
+ if (!sameFileIdentity(opened, current))
87
+ changedFile();
88
+ }
89
+ /** Keeps the recorded file descriptor alive for the complete caller operation. */
90
+ export async function withConversationFileTarget(receipt, paths, action) {
91
+ let handle;
92
+ try {
93
+ const target = await resolveRecordedFile(receipt, paths);
94
+ if (typeof constants.O_NOFOLLOW !== "number")
95
+ throw new ConversationFileError("conversation_file_platform_unsupported", 415, "This platform cannot safely open a file preview.");
96
+ handle = await open(target.absolutePath, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
97
+ const openedHandle = handle;
98
+ const before = await handle.stat({ bigint: true });
99
+ if (!before.isFile())
100
+ unavailable();
101
+ if (before.size > BigInt(Number.MAX_SAFE_INTEGER))
102
+ unavailable();
103
+ await assertOpenedFileAuthority(target, before, receipt);
104
+ return await action({
105
+ target,
106
+ handle,
107
+ stats: before,
108
+ assertCurrent: async () => {
109
+ const after = await openedHandle.stat({ bigint: true });
110
+ if (!sameFileVersion(before, after))
111
+ changedFile();
112
+ const currentTarget = await resolveRecordedFile(receipt, paths);
113
+ if (currentTarget.absolutePath !== target.absolutePath)
114
+ unavailable();
115
+ await assertOpenedFileAuthority(target, after, receipt);
116
+ },
117
+ assertCurrentForNativeOpen: () => {
118
+ assertNativeFileDispatchAuthority(target, openedHandle.fd, before, receipt, paths);
119
+ },
120
+ });
121
+ }
122
+ catch (error) {
123
+ if (error instanceof ConversationFileError)
124
+ throw error;
125
+ return unavailable();
126
+ }
127
+ finally {
128
+ await handle?.close().catch(() => undefined);
129
+ }
130
+ }
131
+ /** No await is allowed between this pathname check and native command dispatch. */
132
+ function assertNativeFileDispatchAuthority(target, fd, before, receipt, paths) {
133
+ const resolver = createRuntimeToolPathResolver(paths);
134
+ const current = resolver.resolve(target.absolutePath, {
135
+ allowedLocations: [receipt.location],
136
+ requirePath: true,
137
+ });
138
+ if (current.rootPath !== target.rootPath)
139
+ changedRoot();
140
+ if (current.relativePath !== receipt.relativePath)
141
+ unavailable();
142
+ const root = realpathSync(current.rootPath);
143
+ if (readFileOutputRootId(receipt.location, root) !== receipt.rootId)
144
+ changedRoot();
145
+ const canonicalPath = realpathSync(current.absolutePath);
146
+ if (!isContainedFile(root, canonicalPath))
147
+ unavailable();
148
+ const opened = fstatSync(fd, { bigint: true });
149
+ if (!sameFileVersion(before, opened))
150
+ changedFile();
151
+ if (!lstatSync(current.absolutePath).isFile())
152
+ unavailable();
153
+ const currentFile = statSync(canonicalPath, { bigint: true });
154
+ if (!currentFile.isFile())
155
+ unavailable();
156
+ if (!sameFileVersion(opened, currentFile))
157
+ changedFile();
158
+ }
@@ -1,3 +1,5 @@
1
+ import type { WebUiEnvironmentConfig } from "../environment-config.js";
2
+ import type { RuntimeSetupActivation } from "./runtime-setup-input.js";
1
3
  import { type LocalRuntimeApplicationOptions } from "../../runtime/local-application.js";
2
4
  import type { LocalRuntimeBackendOptions, RuntimeEnvironment, RuntimeModelCatalogState, RuntimeSetupRequirement } from "./contracts.js";
3
5
  export declare class RuntimeEnvironmentRegistry {
@@ -5,17 +7,29 @@ export declare class RuntimeEnvironmentRegistry {
5
7
  private readonly schedulerBindings;
6
8
  private readonly environments;
7
9
  private stopped;
10
+ private readonly desiredEnvironmentIds;
11
+ private applying;
12
+ private setupActivationPending;
8
13
  private stopping;
14
+ private configuredEnvironments;
9
15
  constructor(options: LocalRuntimeBackendOptions, schedulerBindings?: {
10
16
  requestOptions?: LocalRuntimeApplicationOptions["scheduledRequestOptions"];
11
17
  publish?: (event: Record<string, unknown>) => void;
12
18
  });
19
+ environmentConfig(): WebUiEnvironmentConfig | undefined;
20
+ applyConfiguration(): Promise<RuntimeSetupActivation>;
21
+ private applySavedConfiguration;
22
+ private checkGatewayActivation;
23
+ configure(configPath: string): void;
13
24
  modelCatalog(environmentId: string): RuntimeModelCatalogState;
14
25
  setupRequirement(environmentId: string): RuntimeSetupRequirement | null;
15
26
  get(environmentId: string): RuntimeEnvironment;
27
+ private createEnvironment;
16
28
  start(environmentIds: readonly string[]): Promise<void>;
17
29
  private startEnvironment;
18
30
  stop(): Promise<void>;
31
+ private stopAfterConfigurationApplication;
32
+ private hasStartedEnvironment;
19
33
  private requireEnvironmentIntakeOpen;
20
34
  profileEnv(environmentId: string): Record<string, string | undefined>;
21
35
  private loadConfig;
@@ -1,25 +1,121 @@
1
+ import { requiresConfiguredCredential } from "./runtime-setup-provider.js";
2
+ import { applyRuntimeConfiguration } from "./configuration-activation.js";
3
+ import { withConfigurationActivationSource, } from "./configuration-activation-source.js";
1
4
  import { createLocalRuntimeApplication, } from "../../runtime/local-application.js";
2
5
  import { loadRuntimeConfig } from "../../runtime/config.js";
3
6
  import { inspectRuntimeConfigFileWithMeta } from "../../runtime/config/loader.js";
4
7
  import { loadRuntimeModelCatalog } from "../../runtime/model/model-catalog.js";
5
8
  import { inspectRuntimeSetupRequirement } from "./runtime-availability.js";
9
+ import { readSavedModelCatalog } from "./saved-model-catalog.js";
6
10
  export class RuntimeEnvironmentRegistry {
7
11
  options;
8
12
  schedulerBindings;
9
13
  environments = new Map();
10
14
  stopped = false;
15
+ desiredEnvironmentIds = new Set();
16
+ applying;
17
+ setupActivationPending = false;
11
18
  stopping;
19
+ configuredEnvironments;
12
20
  constructor(options, schedulerBindings = {}) {
13
21
  this.options = options;
14
22
  this.schedulerBindings = schedulerBindings;
23
+ this.configuredEnvironments = options.resolveEnvironmentConfig?.(options.configPath);
24
+ }
25
+ environmentConfig() {
26
+ return this.configuredEnvironments;
27
+ }
28
+ applyConfiguration() {
29
+ if (this.stopped)
30
+ return Promise.reject(new Error("web_runtime_stopped"));
31
+ if (this.applying)
32
+ return this.applying;
33
+ const configPath = inspectRuntimeConfigFileWithMeta(this.options.rootDir ?? process.cwd(), this.options.configPath ?? process.env.LLM_RUNTIME_CONFIG_FILE).path;
34
+ const apply = withConfigurationActivationSource(configPath, (prepare) => this.applySavedConfiguration(configPath, prepare));
35
+ this.applying = apply.finally(() => {
36
+ this.applying = undefined;
37
+ });
38
+ return this.applying;
39
+ }
40
+ applySavedConfiguration(configPath, preparation) {
41
+ const nextEnvironments = this.options.resolveEnvironmentConfig?.(configPath);
42
+ return applyRuntimeConfiguration({
43
+ environments: this.environments,
44
+ defaultEnvironmentId: nextEnvironments?.defaultEnvironmentId ??
45
+ this.options.defaultEnvironmentId,
46
+ environmentIds: nextEnvironments?.environments.map(({ id }) => id) ?? [
47
+ ...this.desiredEnvironmentIds,
48
+ ],
49
+ createEnvironment: (id) => this.createEnvironment(id, this.loadConfig(id, configPath)),
50
+ recreateEnvironment: (id, previous) => this.createEnvironment(id, previous.services.config),
51
+ createGatewayRestorePoint: this.options.createRuntimeSetupRestorePoint,
52
+ onRestorationFailure: () => {
53
+ this.setupActivationPending = true;
54
+ },
55
+ ...preparation,
56
+ checkGateway: () => this.checkGatewayActivation(configPath),
57
+ activateGateway: () => this.options.onRuntimeSetup?.(configPath) ??
58
+ Promise.resolve({ status: "ready" }),
59
+ canContinue: () => !this.stopped,
60
+ }).then((result) => {
61
+ if (result.status !== "ready")
62
+ return result;
63
+ this.setupActivationPending = false;
64
+ if (nextEnvironments) {
65
+ this.configuredEnvironments = nextEnvironments;
66
+ this.options.defaultEnvironmentId =
67
+ nextEnvironments.defaultEnvironmentId;
68
+ this.desiredEnvironmentIds.clear();
69
+ for (const { id } of nextEnvironments.environments)
70
+ this.desiredEnvironmentIds.add(id);
71
+ }
72
+ return result;
73
+ });
74
+ }
75
+ checkGatewayActivation(configPath) {
76
+ if (this.options.checkRuntimeSetupActivation)
77
+ return this.options.checkRuntimeSetupActivation(configPath);
78
+ if (this.options.onRuntimeSetup)
79
+ return Promise.resolve({ status: "ready" });
80
+ return Promise.resolve({
81
+ status: "restart_required",
82
+ message: "Connection saved. Restart the owning model gateway and Runtime to apply this configuration.",
83
+ });
84
+ }
85
+ configure(configPath) {
86
+ this.requireEnvironmentIntakeOpen();
87
+ this.options.configPath = configPath;
88
+ if (!this.hasStartedEnvironment())
89
+ this.setupActivationPending = true;
15
90
  }
16
91
  modelCatalog(environmentId) {
92
+ if (this.setupActivationPending) {
93
+ return this.emptyModelCatalog({
94
+ status: "setup_required",
95
+ code: "runtime_configuration_required",
96
+ message: "Your connection is saved. Apply the setup or restart its owning services before starting a conversation.",
97
+ });
98
+ }
99
+ const active = this.environments.get(environmentId || this.options.defaultEnvironmentId);
100
+ if (active?.getOwnership() !== undefined) {
101
+ return {
102
+ ...loadRuntimeModelCatalog(active.services.config),
103
+ availability: { status: "ready" },
104
+ };
105
+ }
17
106
  const source = inspectRuntimeConfigFileWithMeta(this.options.rootDir ?? process.cwd(), this.options.configPath ?? process.env.LLM_RUNTIME_CONFIG_FILE);
18
107
  const setupRequirement = inspectRuntimeSetupRequirement(source);
19
108
  if (setupRequirement) {
20
109
  return this.emptyModelCatalog(setupRequirement);
21
110
  }
22
- const catalog = loadRuntimeModelCatalog(this.loadConfig(environmentId));
111
+ if (requiresConfiguredCredential(source, this.options.rootDir ?? process.cwd())) {
112
+ return this.emptyModelCatalog({
113
+ status: "setup_required",
114
+ code: "runtime_configuration_required",
115
+ message: "The configured OpenAI model needs an API key. Complete the connection in this Web UI.",
116
+ });
117
+ }
118
+ const catalog = readSavedModelCatalog(source, environmentId || this.options.defaultEnvironmentId);
23
119
  return {
24
120
  ...catalog,
25
121
  availability: { status: "ready" },
@@ -32,21 +128,27 @@ export class RuntimeEnvironmentRegistry {
32
128
  get(environmentId) {
33
129
  this.requireEnvironmentIntakeOpen();
34
130
  const normalized = environmentId || this.options.defaultEnvironmentId;
131
+ this.desiredEnvironmentIds.add(normalized);
35
132
  const existing = this.environments.get(normalized);
36
133
  if (existing)
37
134
  return existing;
38
- const config = this.loadConfig(normalized);
135
+ const environment = this.createEnvironment(normalized);
136
+ this.environments.set(normalized, environment);
137
+ return environment;
138
+ }
139
+ createEnvironment(environmentId, config = this.loadConfig(environmentId)) {
39
140
  const environment = createLocalRuntimeApplication(config, {
40
141
  scheduledRequestOptions: this.schedulerBindings.requestOptions,
41
142
  });
42
143
  if (this.schedulerBindings.publish) {
43
144
  environment.subscribeScheduledEvents(this.schedulerBindings.publish);
44
145
  }
45
- this.environments.set(normalized, environment);
46
146
  return environment;
47
147
  }
48
148
  async start(environmentIds) {
49
149
  this.requireEnvironmentIntakeOpen();
150
+ for (const id of environmentIds)
151
+ this.desiredEnvironmentIds.add(id);
50
152
  await Promise.all(environmentIds.map((id) => this.startEnvironment(id)));
51
153
  }
52
154
  async startEnvironment(id) {
@@ -63,12 +165,25 @@ export class RuntimeEnvironmentRegistry {
63
165
  if (this.stopping)
64
166
  return this.stopping;
65
167
  this.stopped = true;
66
- this.stopping = Promise.all([...this.environments.values()].map(async (environment) => environment.stop())).then(() => undefined);
168
+ this.stopping = this.stopAfterConfigurationApplication();
67
169
  return this.stopping;
68
170
  }
171
+ async stopAfterConfigurationApplication() {
172
+ // Apply checks the stopped fence after every async handoff; teardown owns final closure.
173
+ await this.applying?.catch(() => undefined);
174
+ const stops = await Promise.allSettled([...this.environments.values()].map((environment) => environment.stop()));
175
+ const failed = stops.find((result) => result.status === "rejected");
176
+ if (failed?.status === "rejected")
177
+ throw failed.reason;
178
+ }
179
+ hasStartedEnvironment() {
180
+ return [...this.environments.values()].some((environment) => environment.getOwnership() !== undefined);
181
+ }
69
182
  requireEnvironmentIntakeOpen() {
70
183
  if (this.stopped)
71
184
  throw new Error("web_runtime_stopped");
185
+ if (this.applying)
186
+ throw new Error("Configuration is being applied. Try again shortly.");
72
187
  }
73
188
  profileEnv(environmentId) {
74
189
  return {
@@ -76,10 +191,10 @@ export class RuntimeEnvironmentRegistry {
76
191
  LLM_RUNTIME_PROFILE: environmentId || this.options.defaultEnvironmentId,
77
192
  };
78
193
  }
79
- loadConfig(environmentId) {
194
+ loadConfig(environmentId, configPath = this.options.configPath) {
80
195
  return loadRuntimeConfig({
81
196
  rootDir: this.options.rootDir,
82
- configPath: this.options.configPath,
197
+ configPath,
83
198
  profileId: environmentId || this.options.defaultEnvironmentId,
84
199
  });
85
200
  }
@@ -3,7 +3,8 @@ import type { LongTermMemoryOnboardingService } from "../../runtime/long-term-me
3
3
  type JsonBody = Record<string, unknown> | null;
4
4
  export declare class LongTermMemoryOnboardingRoutes {
5
5
  private readonly service;
6
- constructor(service: LongTermMemoryOnboardingService);
6
+ constructor(service: LongTermMemoryOnboardingService | (() => LongTermMemoryOnboardingService));
7
+ private currentService;
7
8
  handle(params: {
8
9
  method: string;
9
10
  route: string;
@@ -1,3 +1,4 @@
1
+ import { acceptConfigMutationRequest } from "./config-mutation-request.js";
1
2
  import { getString, sendJson } from "./http.js";
2
3
  import { withHttpRequestAbortSignal } from "./request-abort.js";
3
4
  export class LongTermMemoryOnboardingRoutes {
@@ -5,6 +6,9 @@ export class LongTermMemoryOnboardingRoutes {
5
6
  constructor(service) {
6
7
  this.service = service;
7
8
  }
9
+ currentService() {
10
+ return typeof this.service === "function" ? this.service() : this.service;
11
+ }
8
12
  async handle(params) {
9
13
  try {
10
14
  return await this.handleKnownRoute(params);
@@ -22,12 +26,11 @@ export class LongTermMemoryOnboardingRoutes {
22
26
  if (params.method === "GET" && params.route === "runtime/memory") {
23
27
  sendJson(params.response, 200, {
24
28
  ok: true,
25
- status: await this.service.status(),
29
+ status: await this.currentService().status(),
26
30
  });
27
31
  return true;
28
32
  }
29
- if (params.method === "GET" &&
30
- params.route === "runtime/memory/models") {
33
+ if (params.method === "GET" && params.route === "runtime/memory/models") {
31
34
  const providerId = params.url.searchParams.get("provider") ?? "";
32
35
  sendJson(params.response, 200, {
33
36
  ok: true,
@@ -35,18 +38,19 @@ export class LongTermMemoryOnboardingRoutes {
35
38
  request: params.request,
36
39
  response: params.response,
37
40
  reason: "memory_onboarding_discovery_request_aborted",
38
- run: (abortSignal) => this.service.discover({ providerId, abortSignal }),
41
+ run: (abortSignal) => this.currentService().discover({ providerId, abortSignal }),
39
42
  }),
40
43
  });
41
44
  return true;
42
45
  }
43
- if (params.method === "POST" &&
44
- params.route === "runtime/memory/enable") {
46
+ if (params.method === "POST" && params.route === "runtime/memory/enable") {
47
+ if (!acceptConfigMutationRequest(params.request, params.response))
48
+ return true;
45
49
  const result = await withHttpRequestAbortSignal({
46
50
  request: params.request,
47
51
  response: params.response,
48
52
  reason: "memory_onboarding_enable_request_aborted",
49
- run: (abortSignal) => this.service.enable({
53
+ run: (abortSignal) => this.currentService().enable({
50
54
  providerId: getString(params.body?.providerId),
51
55
  model: getString(params.body?.model),
52
56
  ...(getString(params.body?.profileId)
@@ -59,11 +63,12 @@ export class LongTermMemoryOnboardingRoutes {
59
63
  sendJson(params.response, 200, { ok: true, ...result });
60
64
  return true;
61
65
  }
62
- if (params.method === "POST" &&
63
- params.route === "runtime/memory/disable") {
66
+ if (params.method === "POST" && params.route === "runtime/memory/disable") {
67
+ if (!acceptConfigMutationRequest(params.request, params.response))
68
+ return true;
64
69
  sendJson(params.response, 200, {
65
70
  ok: true,
66
- ...(await this.service.disable()),
71
+ ...(await this.currentService().disable()),
67
72
  });
68
73
  return true;
69
74
  }
@@ -0,0 +1,17 @@
1
+ export type ModelSetupOptions = {
2
+ rootDir: string;
3
+ configPath?: string;
4
+ };
5
+ export declare function readModelSetupSource(options: ModelSetupOptions): import("../../runtime/config/loader.js").InspectedRuntimeConfigFile;
6
+ export declare function modelConfigMap(value: unknown): Record<string, unknown>;
7
+ export declare function getModelSetupCatalog(options: ModelSetupOptions): Promise<{
8
+ providers: {
9
+ id: string;
10
+ type: string;
11
+ label: string;
12
+ requiresApiKey: boolean;
13
+ credentialConfigured: boolean;
14
+ }[];
15
+ defaultContextWindowTokens: number;
16
+ profileIds: string[];
17
+ }>;
@@ -0,0 +1,45 @@
1
+ import { readDefaultContextWindowTokens } from "../../../scripts/runtime-setup-files.js";
2
+ import { getConfigDashboardSnapshot } from "../config-dashboard-backend.js";
3
+ import { inspectRuntimeConfigFileWithMeta } from "../../runtime/config/loader.js";
4
+ import { isRecord } from "../../runtime/config/utils.js";
5
+ import { validateRuntimeConfigFile } from "../../runtime/config/validation.js";
6
+ import { hasRuntimeSetupCredential } from "./runtime-setup-credentials.js";
7
+ import { ModelSetupError } from "./model-setup-input.js";
8
+ export function readModelSetupSource(options) {
9
+ const source = inspectRuntimeConfigFileWithMeta(options.rootDir, options.configPath);
10
+ if (!source.exists)
11
+ throw new ModelSetupError("runtime_setup_required", "Complete initial setup before adding another model.", 409);
12
+ validateRuntimeConfigFile(source.config, source.path);
13
+ return source;
14
+ }
15
+ export function modelConfigMap(value) {
16
+ return isRecord(value) ? value : {};
17
+ }
18
+ export async function getModelSetupCatalog(options) {
19
+ const source = readModelSetupSource(options);
20
+ const models = modelConfigMap(source.config.models);
21
+ const providers = await Promise.all(Object.entries(modelConfigMap(models.providers)).map(async ([id, value]) => {
22
+ const provider = modelConfigMap(value);
23
+ const type = String(provider.type);
24
+ const requiresApiKey = type === "openai";
25
+ const apiKeyEnv = typeof provider.apiKeyEnv === "string"
26
+ ? provider.apiKeyEnv
27
+ : "OPENAI_API_KEY";
28
+ return {
29
+ id,
30
+ type,
31
+ label: id,
32
+ requiresApiKey,
33
+ credentialConfigured: requiresApiKey &&
34
+ (await hasRuntimeSetupCredential(options.rootDir, apiKeyEnv)),
35
+ };
36
+ }));
37
+ const dashboard = await getConfigDashboardSnapshot(options);
38
+ return {
39
+ providers,
40
+ defaultContextWindowTokens: await readDefaultContextWindowTokens(),
41
+ profileIds: [
42
+ ...new Set(dashboard.files.models.map((profile) => profile.id)),
43
+ ],
44
+ };
45
+ }
@@ -0,0 +1,16 @@
1
+ import type { ModelSetupInput } from "./model-setup-input.js";
2
+ import type { planModelProvider } from "./model-setup-provider.js";
3
+ type ModelProviderPlan = ReturnType<typeof planModelProvider>;
4
+ export declare function buildModelSetupProfile(provider: ModelProviderPlan, input: ModelSetupInput): Promise<{
5
+ provider: string;
6
+ }>;
7
+ export declare function modelSetupResult(provider: ModelProviderPlan, input: ModelSetupInput): {
8
+ model: {
9
+ profileId: string;
10
+ providerId: string;
11
+ provider: string;
12
+ model: string;
13
+ };
14
+ restartRequired: true;
15
+ };
16
+ export {};
@@ -0,0 +1,20 @@
1
+ import { join } from "node:path";
2
+ import { buildModelConfig, readJsonObject, resolveRuntimePackageRoot, } from "../../../scripts/runtime-setup-files.js";
3
+ export async function buildModelSetupProfile(provider, input) {
4
+ const template = await readJsonObject(join(resolveRuntimePackageRoot(import.meta.dirname), "examples/models/default.config.json"));
5
+ return {
6
+ ...buildModelConfig(template, String(provider.config.type), input.model, input.contextWindowTokens),
7
+ provider: provider.id,
8
+ };
9
+ }
10
+ export function modelSetupResult(provider, input) {
11
+ return {
12
+ model: {
13
+ profileId: input.profileId,
14
+ providerId: provider.id,
15
+ provider: String(provider.config.type),
16
+ model: input.model,
17
+ },
18
+ restartRequired: true,
19
+ };
20
+ }
@@ -0,0 +1,24 @@
1
+ export type NewModelProvider = Readonly<{
2
+ id: string;
3
+ type: "openai" | "ollama";
4
+ baseUrl?: string;
5
+ }>;
6
+ export type ModelSetupInput = Readonly<{
7
+ profileId: string;
8
+ model: string;
9
+ contextWindowTokens?: number;
10
+ apiKey?: string;
11
+ }> & (Readonly<{
12
+ providerId: string;
13
+ newProvider?: never;
14
+ }> | Readonly<{
15
+ newProvider: NewModelProvider;
16
+ providerId?: never;
17
+ }>);
18
+ export declare class ModelSetupError extends Error {
19
+ readonly code: string;
20
+ readonly statusCode: number;
21
+ readonly credentialSaved: boolean;
22
+ constructor(code: string, message: string, statusCode?: number, credentialSaved?: boolean);
23
+ }
24
+ export declare function parseModelSetupInput(body: Record<string, unknown>): ModelSetupInput;