@abot-ai/runtime 1.2.0 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (550) hide show
  1. package/README.md +14 -0
  2. package/dist/scripts/init-runtime.js +4 -13
  3. package/dist/scripts/runtime-setup-directories.d.ts +2 -0
  4. package/dist/scripts/runtime-setup-directories.js +38 -0
  5. package/dist/src/bridge/request-steering.d.ts +2 -1
  6. package/dist/src/bridge/request-steering.js +4 -2
  7. package/dist/src/bridge/runtime-replay.js +2 -19
  8. package/dist/src/bridge/start-agent-bridge.js +1 -1
  9. package/dist/src/capabilities/normal-invocation/validator.js +1 -1
  10. package/dist/src/capabilities/tool-definition-validator/event-presentation.js +3 -0
  11. package/dist/src/capabilities/tool-definition-validator/event-result-metadata.d.ts +2 -0
  12. package/dist/src/capabilities/tool-definition-validator/event-result-metadata.js +74 -0
  13. package/dist/src/capabilities/tool-event-metadata.js +3 -0
  14. package/dist/src/capabilities/tool-result-event-projection.d.ts +3 -0
  15. package/dist/src/capabilities/tool-result-event-projection.js +82 -0
  16. package/dist/src/capabilities/tool-types.d.ts +5 -0
  17. package/dist/src/cli/abot.js +2 -11
  18. package/dist/src/runtime/adapters/in-memory-session-store.js +1 -0
  19. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.js +11 -2
  20. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.d.ts +2 -0
  21. package/dist/src/runtime/adapters/long-term-memory/file-lock/synchronous-release.d.ts +2 -0
  22. package/dist/src/runtime/adapters/long-term-memory/file-lock/synchronous-release.js +40 -0
  23. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.d.ts +3 -0
  24. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.js +9 -0
  25. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/rejection-event.d.ts +13 -0
  26. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/rejection-event.js +25 -0
  27. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.js +18 -2
  28. package/dist/src/runtime/adapters/registered-tool-normal-invocations/executor.js +8 -0
  29. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.js +7 -3
  30. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +17 -2
  31. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/event-metadata.d.ts +9 -0
  32. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/event-metadata.js +8 -0
  33. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.js +16 -1
  34. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.js +2 -2
  35. package/dist/src/runtime/adapters/scheduled-request-outcome.d.ts +11 -0
  36. package/dist/src/runtime/adapters/scheduled-request-outcome.js +41 -0
  37. package/dist/src/runtime/adapters/scheduler-runtime.d.ts +19 -0
  38. package/dist/src/runtime/adapters/scheduler-runtime.js +138 -0
  39. package/dist/src/runtime/capabilities/scheduling/create-operations.d.ts +55 -0
  40. package/dist/src/runtime/capabilities/scheduling/create-operations.js +30 -0
  41. package/dist/src/runtime/capabilities/scheduling/create-time-zone.d.ts +1 -0
  42. package/dist/src/runtime/capabilities/scheduling/create-time-zone.js +11 -0
  43. package/dist/src/runtime/capabilities/scheduling/job-list-page.d.ts +25 -0
  44. package/dist/src/runtime/capabilities/scheduling/job-list-page.js +40 -0
  45. package/dist/src/runtime/capabilities/scheduling/model-validation.d.ts +2 -0
  46. package/dist/src/runtime/capabilities/scheduling/model-validation.js +15 -0
  47. package/dist/src/runtime/capabilities/scheduling/tool-contract.d.ts +2 -0
  48. package/dist/src/runtime/capabilities/scheduling/tool-contract.js +35 -0
  49. package/dist/src/runtime/capabilities/scheduling/tool-input-properties.d.ts +43 -0
  50. package/dist/src/runtime/capabilities/scheduling/tool-input-properties.js +27 -0
  51. package/dist/src/runtime/capabilities/scheduling/tool-module.d.ts +4 -0
  52. package/dist/src/runtime/capabilities/scheduling/tool-module.js +158 -0
  53. package/dist/src/runtime/capabilities/scheduling/update-operations.d.ts +2 -0
  54. package/dist/src/runtime/capabilities/scheduling/update-operations.js +49 -0
  55. package/dist/src/runtime/composition.d.ts +23 -3
  56. package/dist/src/runtime/composition.js +12 -17
  57. package/dist/src/runtime/config/environment-paths.d.ts +10 -0
  58. package/dist/src/runtime/config/environment-paths.js +31 -0
  59. package/dist/src/runtime/config/environment-storage.d.ts +9 -0
  60. package/dist/src/runtime/config/environment-storage.js +65 -0
  61. package/dist/src/runtime/config/fields.js +7 -0
  62. package/dist/src/runtime/config/long-term-memory.js +15 -0
  63. package/dist/src/runtime/config/schema.js +8 -0
  64. package/dist/src/runtime/config.js +9 -5
  65. package/dist/src/runtime/context/scheduled-execution-context.d.ts +10 -0
  66. package/dist/src/runtime/context/scheduled-execution-context.js +52 -0
  67. package/dist/src/runtime/default-adapters.d.ts +3 -32
  68. package/dist/src/runtime/default-adapters.js +3 -270
  69. package/dist/src/runtime/default-environment-adapters.d.ts +19 -0
  70. package/dist/src/runtime/default-environment-adapters.js +144 -0
  71. package/dist/src/runtime/index.d.ts +5 -0
  72. package/dist/src/runtime/index.js +4 -0
  73. package/dist/src/runtime/local-application.d.ts +22 -0
  74. package/dist/src/runtime/local-application.js +81 -0
  75. package/dist/src/runtime/local-host/app-memory-dispatch.d.ts +11 -0
  76. package/dist/src/runtime/local-host/app-memory-dispatch.js +103 -0
  77. package/dist/src/runtime/local-host/app-owner.d.ts +4 -0
  78. package/dist/src/runtime/local-host/app-owner.js +119 -0
  79. package/dist/src/runtime/local-host/app-request-control.d.ts +24 -0
  80. package/dist/src/runtime/local-host/app-request-control.js +135 -0
  81. package/dist/src/runtime/local-host/app-service-dispatch.d.ts +5 -0
  82. package/dist/src/runtime/local-host/app-service-dispatch.js +64 -0
  83. package/dist/src/runtime/local-host/client-identity.d.ts +3 -0
  84. package/dist/src/runtime/local-host/client-identity.js +17 -0
  85. package/dist/src/runtime/local-host/client-memory.d.ts +7 -0
  86. package/dist/src/runtime/local-host/client-memory.js +54 -0
  87. package/dist/src/runtime/local-host/client-requests.d.ts +19 -0
  88. package/dist/src/runtime/local-host/client-requests.js +145 -0
  89. package/dist/src/runtime/local-host/client-services.d.ts +10 -0
  90. package/dist/src/runtime/local-host/client-services.js +14 -0
  91. package/dist/src/runtime/local-host/contracts.d.ts +36 -0
  92. package/dist/src/runtime/local-host/contracts.js +1 -0
  93. package/dist/src/runtime/local-host/endpoint.d.ts +7 -0
  94. package/dist/src/runtime/local-host/endpoint.js +79 -0
  95. package/dist/src/runtime/local-host/owner-activity.d.ts +10 -0
  96. package/dist/src/runtime/local-host/owner-activity.js +30 -0
  97. package/dist/src/runtime/local-host/owner-retirement.d.ts +3 -0
  98. package/dist/src/runtime/local-host/owner-retirement.js +15 -0
  99. package/dist/src/runtime/local-host/owner-server.d.ts +6 -0
  100. package/dist/src/runtime/local-host/owner-server.js +88 -0
  101. package/dist/src/runtime/local-host/private-access.d.ts +2 -0
  102. package/dist/src/runtime/local-host/private-access.js +16 -0
  103. package/dist/src/runtime/local-host/private-directory.d.ts +1 -0
  104. package/dist/src/runtime/local-host/private-directory.js +57 -0
  105. package/dist/src/runtime/local-host/rpc-peer.d.ts +22 -0
  106. package/dist/src/runtime/local-host/rpc-peer.js +168 -0
  107. package/dist/src/runtime/local-host/rpc-protocol.d.ts +21 -0
  108. package/dist/src/runtime/local-host/rpc-protocol.js +46 -0
  109. package/dist/src/runtime/local-host/startup-connection.d.ts +5 -0
  110. package/dist/src/runtime/local-host/startup-connection.js +72 -0
  111. package/dist/src/runtime/local-host/transport.d.ts +3 -0
  112. package/dist/src/runtime/local-host/transport.js +88 -0
  113. package/dist/src/runtime/local-host/windows-private-access.d.ts +1 -0
  114. package/dist/src/runtime/local-host/windows-private-access.js +51 -0
  115. package/dist/src/runtime/long-term-memory/onboarding/configuration.js +6 -0
  116. package/dist/src/runtime/long-term-memory/recall-binding.d.ts +3 -0
  117. package/dist/src/runtime/long-term-memory/recall-binding.js +27 -0
  118. package/dist/src/runtime/long-term-memory/recall-context.d.ts +20 -0
  119. package/dist/src/runtime/long-term-memory/recall-context.js +101 -0
  120. package/dist/src/runtime/long-term-memory/recall-continuation.d.ts +8 -0
  121. package/dist/src/runtime/long-term-memory/recall-continuation.js +36 -0
  122. package/dist/src/runtime/long-term-memory/recall-policy.d.ts +7 -0
  123. package/dist/src/runtime/long-term-memory/recall-policy.js +14 -0
  124. package/dist/src/runtime/long-term-memory/recall-result.d.ts +5 -0
  125. package/dist/src/runtime/long-term-memory/recall-result.js +54 -0
  126. package/dist/src/runtime/long-term-memory/repository-state.d.ts +2 -1
  127. package/dist/src/runtime/long-term-memory/repository-state.js +2 -2
  128. package/dist/src/runtime/model/invoke-raw-step.d.ts +1 -0
  129. package/dist/src/runtime/model/invoke-raw-step.js +1 -0
  130. package/dist/src/runtime/model/invoke-step.js +6 -0
  131. package/dist/src/runtime/model/invoke-structured-step.d.ts +1 -0
  132. package/dist/src/runtime/model/invoke-structured-step.js +1 -0
  133. package/dist/src/runtime/model/model-step-port.d.ts +2 -0
  134. package/dist/src/runtime/model/model-step-steering.d.ts +8 -0
  135. package/dist/src/runtime/model/model-step-steering.js +19 -0
  136. package/dist/src/runtime/orchestration/final-response/authoring-contract.js +1 -1
  137. package/dist/src/runtime/orchestration/final-response/invoke.d.ts +1 -0
  138. package/dist/src/runtime/orchestration/final-response/invoke.js +1 -0
  139. package/dist/src/runtime/orchestration/role-calls/activation-budget.js +1 -0
  140. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +9 -49
  141. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.d.ts +9 -0
  142. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.js +17 -8
  143. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-validation.d.ts +2 -0
  144. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-validation.js +62 -0
  145. package/dist/src/runtime/orchestration/role-calls/command-decoder.js +4 -0
  146. package/dist/src/runtime/orchestration/role-calls/command-dispatch/memory-recall-transitions.d.ts +4 -0
  147. package/dist/src/runtime/orchestration/role-calls/command-dispatch/memory-recall-transitions.js +89 -0
  148. package/dist/src/runtime/orchestration/role-calls/command-dispatch.js +5 -0
  149. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +9 -7
  150. package/dist/src/runtime/orchestration/role-calls/contracts.js +2 -2
  151. package/dist/src/runtime/orchestration/role-calls/diagnostics.js +3 -0
  152. package/dist/src/runtime/orchestration/role-calls/index.d.ts +1 -0
  153. package/dist/src/runtime/orchestration/role-calls/index.js +1 -0
  154. package/dist/src/runtime/orchestration/role-calls/memory-recall-contract.d.ts +51 -0
  155. package/dist/src/runtime/orchestration/role-calls/memory-recall-contract.js +4 -0
  156. package/dist/src/runtime/orchestration/role-calls/memory-recall-decoder.d.ts +6 -0
  157. package/dist/src/runtime/orchestration/role-calls/memory-recall-decoder.js +147 -0
  158. package/dist/src/runtime/orchestration/role-calls/memory-recall-diagnostics.d.ts +5 -0
  159. package/dist/src/runtime/orchestration/role-calls/memory-recall-diagnostics.js +27 -0
  160. package/dist/src/runtime/orchestration/role-calls/memory-recall-state-validation.d.ts +3 -0
  161. package/dist/src/runtime/orchestration/role-calls/memory-recall-state-validation.js +121 -0
  162. package/dist/src/runtime/orchestration/role-calls/memory-recall-transactions.d.ts +3 -0
  163. package/dist/src/runtime/orchestration/role-calls/memory-recall-transactions.js +44 -0
  164. package/dist/src/runtime/orchestration/role-calls/reducer.js +1 -0
  165. package/dist/src/runtime/orchestration/role-calls/transaction-effect.d.ts +5 -0
  166. package/dist/src/runtime/orchestration/role-calls/transaction-effect.js +14 -0
  167. package/dist/src/runtime/orchestration/role-calls/transactions.js +3 -24
  168. package/dist/src/runtime/plugins/manifest-validator.js +4 -1
  169. package/dist/src/runtime/ports.d.ts +4 -0
  170. package/dist/src/runtime/request/bound-runtime-handler.d.ts +2 -0
  171. package/dist/src/runtime/request/bound-runtime-handler.js +25 -0
  172. package/dist/src/runtime/request/contracts.d.ts +6 -0
  173. package/dist/src/runtime/request/execution-agent-root-execution.js +12 -0
  174. package/dist/src/runtime/request/execution-facets.js +6 -0
  175. package/dist/src/runtime/request/execution-scope-surfaces.js +10 -0
  176. package/dist/src/runtime/request/execution-scope.d.ts +1 -1
  177. package/dist/src/runtime/request/handler.js +6 -0
  178. package/dist/src/runtime/request/root-contract.d.ts +7 -1
  179. package/dist/src/runtime/request/root-execution-kernel.js +33 -37
  180. package/dist/src/runtime/request/root-memory-recall.d.ts +11 -0
  181. package/dist/src/runtime/request/root-memory-recall.js +71 -0
  182. package/dist/src/runtime/request/root-observation-handoff.d.ts +17 -0
  183. package/dist/src/runtime/request/root-observation-handoff.js +44 -0
  184. package/dist/src/runtime/request/scheduled-execution.d.ts +9 -0
  185. package/dist/src/runtime/request/scheduled-execution.js +32 -0
  186. package/dist/src/runtime/request/session-admission.d.ts +17 -0
  187. package/dist/src/runtime/request/session-admission.js +88 -0
  188. package/dist/src/runtime/request/supervisor-root-execution-diagnostics.d.ts +1 -1
  189. package/dist/src/runtime/request/supervisor-root-execution.js +8 -0
  190. package/dist/src/runtime/runtime-environment.d.ts +31 -0
  191. package/dist/src/runtime/runtime-environment.js +102 -0
  192. package/dist/src/runtime/runtime-host-environment.d.ts +8 -0
  193. package/dist/src/runtime/runtime-host-environment.js +57 -0
  194. package/dist/src/runtime/runtime-host-lifecycle.d.ts +4 -0
  195. package/dist/src/runtime/runtime-host-lifecycle.js +64 -0
  196. package/dist/src/runtime/runtime-host-scheduler-ownership.d.ts +5 -0
  197. package/dist/src/runtime/runtime-host-scheduler-ownership.js +67 -0
  198. package/dist/src/runtime/runtime-host.d.ts +19 -0
  199. package/dist/src/runtime/runtime-host.js +63 -0
  200. package/dist/src/runtime/scheduler/calendar-time.d.ts +10 -0
  201. package/dist/src/runtime/scheduler/calendar-time.js +58 -0
  202. package/dist/src/runtime/scheduler/contracts.d.ts +143 -0
  203. package/dist/src/runtime/scheduler/contracts.js +1 -0
  204. package/dist/src/runtime/scheduler/file-store.d.ts +2 -0
  205. package/dist/src/runtime/scheduler/file-store.js +76 -0
  206. package/dist/src/runtime/scheduler/instant-validation.d.ts +4 -0
  207. package/dist/src/runtime/scheduler/instant-validation.js +69 -0
  208. package/dist/src/runtime/scheduler/interval-range.d.ts +8 -0
  209. package/dist/src/runtime/scheduler/interval-range.js +24 -0
  210. package/dist/src/runtime/scheduler/job-management.d.ts +8 -0
  211. package/dist/src/runtime/scheduler/job-management.js +212 -0
  212. package/dist/src/runtime/scheduler/journal-checkpoint.d.ts +9 -0
  213. package/dist/src/runtime/scheduler/journal-checkpoint.js +45 -0
  214. package/dist/src/runtime/scheduler/journal-durability.d.ts +8 -0
  215. package/dist/src/runtime/scheduler/journal-durability.js +59 -0
  216. package/dist/src/runtime/scheduler/journal-files.d.ts +14 -0
  217. package/dist/src/runtime/scheduler/journal-files.js +59 -0
  218. package/dist/src/runtime/scheduler/journal-head.d.ts +21 -0
  219. package/dist/src/runtime/scheduler/journal-head.js +81 -0
  220. package/dist/src/runtime/scheduler/journal-index-state.d.ts +31 -0
  221. package/dist/src/runtime/scheduler/journal-index-state.js +137 -0
  222. package/dist/src/runtime/scheduler/journal-index.d.ts +22 -0
  223. package/dist/src/runtime/scheduler/journal-index.js +195 -0
  224. package/dist/src/runtime/scheduler/journal-store.d.ts +21 -0
  225. package/dist/src/runtime/scheduler/journal-store.js +184 -0
  226. package/dist/src/runtime/scheduler/journal-transaction.d.ts +14 -0
  227. package/dist/src/runtime/scheduler/journal-transaction.js +104 -0
  228. package/dist/src/runtime/scheduler/next-occurrence.d.ts +3 -0
  229. package/dist/src/runtime/scheduler/next-occurrence.js +39 -0
  230. package/dist/src/runtime/scheduler/run-completion.d.ts +12 -0
  231. package/dist/src/runtime/scheduler/run-completion.js +77 -0
  232. package/dist/src/runtime/scheduler/run-list-query.d.ts +5 -0
  233. package/dist/src/runtime/scheduler/run-list-query.js +38 -0
  234. package/dist/src/runtime/scheduler/run-records.d.ts +6 -0
  235. package/dist/src/runtime/scheduler/run-records.js +41 -0
  236. package/dist/src/runtime/scheduler/schedule-update.d.ts +3 -0
  237. package/dist/src/runtime/scheduler/schedule-update.js +22 -0
  238. package/dist/src/runtime/scheduler/schedule-validation.d.ts +10 -0
  239. package/dist/src/runtime/scheduler/schedule-validation.js +132 -0
  240. package/dist/src/runtime/scheduler/scheduler-engine.d.ts +2 -0
  241. package/dist/src/runtime/scheduler/scheduler-engine.js +174 -0
  242. package/dist/src/runtime/scheduler/scheduler-service.d.ts +10 -0
  243. package/dist/src/runtime/scheduler/scheduler-service.js +115 -0
  244. package/dist/src/runtime/scheduler/service-context.d.ts +21 -0
  245. package/dist/src/runtime/scheduler/service-context.js +26 -0
  246. package/dist/src/runtime/scheduler/session-deletion-state.d.ts +9 -0
  247. package/dist/src/runtime/scheduler/session-deletion-state.js +30 -0
  248. package/dist/src/runtime/scheduler/snapshot-validation.d.ts +4 -0
  249. package/dist/src/runtime/scheduler/snapshot-validation.js +112 -0
  250. package/dist/src/runtime/scheduler/startup-recovery.d.ts +2 -0
  251. package/dist/src/runtime/scheduler/startup-recovery.js +38 -0
  252. package/dist/src/runtime/scheduler/validation-error.d.ts +4 -0
  253. package/dist/src/runtime/scheduler/validation-error.js +8 -0
  254. package/dist/src/runtime/scheduler/working-store.d.ts +3 -0
  255. package/dist/src/runtime/scheduler/working-store.js +8 -0
  256. package/dist/src/runtime/session/request-session.d.ts +1 -0
  257. package/dist/src/runtime/session/request-session.js +14 -1
  258. package/dist/src/runtime/session/session-attachment-deletion.d.ts +8 -0
  259. package/dist/src/runtime/session/session-attachment-deletion.js +87 -0
  260. package/dist/src/runtime/session/session-deletion-boundary.d.ts +10 -0
  261. package/dist/src/runtime/session/session-deletion-boundary.js +39 -0
  262. package/dist/src/runtime/session/session-deletion-cleanup.d.ts +7 -0
  263. package/dist/src/runtime/session/session-deletion-cleanup.js +62 -0
  264. package/dist/src/runtime/session/session-deletion-finalization.d.ts +7 -0
  265. package/dist/src/runtime/session/session-deletion-finalization.js +34 -0
  266. package/dist/src/runtime/session/session-deletion-receipts.d.ts +7 -0
  267. package/dist/src/runtime/session/session-deletion-receipts.js +18 -0
  268. package/dist/src/runtime/session/session-lifecycle-store.d.ts +21 -0
  269. package/dist/src/runtime/session/session-lifecycle-store.js +72 -0
  270. package/dist/src/runtime/session/session-mutation-queue.d.ts +3 -0
  271. package/dist/src/runtime/session/session-mutation-queue.js +15 -0
  272. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.d.ts +16 -0
  273. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.js +165 -0
  274. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +3 -1
  275. package/dist/src/runtime/steps/execution-agent/decision-parsing.d.ts +2 -0
  276. package/dist/src/runtime/steps/execution-agent/decision-parsing.js +195 -0
  277. package/dist/src/runtime/steps/execution-agent/decision-validation.d.ts +30 -0
  278. package/dist/src/runtime/steps/execution-agent/decision-validation.js +127 -0
  279. package/dist/src/runtime/steps/execution-agent/format.d.ts +1 -0
  280. package/dist/src/runtime/steps/execution-agent/format.js +12 -0
  281. package/dist/src/runtime/steps/execution-agent/input.d.ts +2 -1
  282. package/dist/src/runtime/steps/execution-agent/input.js +17 -2
  283. package/dist/src/runtime/steps/execution-agent/parser.d.ts +1 -2
  284. package/dist/src/runtime/steps/execution-agent/parser.js +1 -472
  285. package/dist/src/runtime/steps/execution-agent/prompt.d.ts +2 -0
  286. package/dist/src/runtime/steps/execution-agent/prompt.js +2 -0
  287. package/dist/src/runtime/steps/execution-agent/reconsideration-context.js +4 -3
  288. package/dist/src/runtime/steps/execution-agent/response-input.js +5 -4
  289. package/dist/src/runtime/steps/execution-agent/response-run.d.ts +3 -0
  290. package/dist/src/runtime/steps/execution-agent/response-run.js +7 -3
  291. package/dist/src/runtime/steps/execution-agent/run.d.ts +2 -0
  292. package/dist/src/runtime/steps/execution-agent/run.js +2 -0
  293. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +2 -1
  294. package/dist/src/runtime/steps/execution-agent/state-context.js +13 -5
  295. package/dist/src/runtime/steps/memory-recall-decision.d.ts +30 -0
  296. package/dist/src/runtime/steps/memory-recall-decision.js +101 -0
  297. package/dist/src/runtime/steps/memory-recall-prompt.d.ts +1 -0
  298. package/dist/src/runtime/steps/memory-recall-prompt.js +15 -0
  299. package/dist/src/runtime/steps/supervisor-decision/contracts.d.ts +4 -2
  300. package/dist/src/runtime/steps/supervisor-decision/diagnostics.d.ts +2 -0
  301. package/dist/src/runtime/steps/supervisor-decision/diagnostics.js +13 -6
  302. package/dist/src/runtime/steps/supervisor-decision/format.d.ts +2 -0
  303. package/dist/src/runtime/steps/supervisor-decision/format.js +41 -2
  304. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +5 -1
  305. package/dist/src/runtime/steps/supervisor-decision/input.js +25 -5
  306. package/dist/src/runtime/steps/supervisor-decision/memory-recall-continuation.d.ts +10 -0
  307. package/dist/src/runtime/steps/supervisor-decision/memory-recall-continuation.js +32 -0
  308. package/dist/src/runtime/steps/supervisor-decision/parser.d.ts +2 -0
  309. package/dist/src/runtime/steps/supervisor-decision/parser.js +36 -1
  310. package/dist/src/runtime/steps/supervisor-decision/prompt.d.ts +3 -0
  311. package/dist/src/runtime/steps/supervisor-decision/prompt.js +16 -8
  312. package/dist/src/runtime/steps/supervisor-decision/response-recommendation.d.ts +13 -0
  313. package/dist/src/runtime/steps/supervisor-decision/response-recommendation.js +32 -0
  314. package/dist/src/runtime/steps/supervisor-decision/resume.d.ts +2 -0
  315. package/dist/src/runtime/steps/supervisor-decision/resume.js +13 -0
  316. package/dist/src/runtime/steps/supervisor-decision/run.d.ts +3 -0
  317. package/dist/src/runtime/steps/supervisor-decision/run.js +19 -0
  318. package/dist/src/runtime/steps/supervisor-decision/working-directory.js +7 -1
  319. package/dist/src/runtime/steps/supervisor-response/diagnostics.d.ts +1 -0
  320. package/dist/src/runtime/steps/supervisor-response/diagnostics.js +1 -0
  321. package/dist/src/runtime/steps/supervisor-response/input.d.ts +2 -1
  322. package/dist/src/runtime/steps/supervisor-response/input.js +17 -4
  323. package/dist/src/runtime/steps/supervisor-response/memory-authoring.d.ts +1 -0
  324. package/dist/src/runtime/steps/supervisor-response/memory-authoring.js +4 -0
  325. package/dist/src/runtime/steps/supervisor-response/prompt.d.ts +1 -0
  326. package/dist/src/runtime/steps/supervisor-response/prompt.js +8 -2
  327. package/dist/src/runtime/steps/supervisor-response/response-recommendation.d.ts +10 -0
  328. package/dist/src/runtime/steps/supervisor-response/response-recommendation.js +25 -0
  329. package/dist/src/runtime/steps/supervisor-response/run.d.ts +6 -1
  330. package/dist/src/runtime/steps/supervisor-response/run.js +26 -7
  331. package/dist/src/sessions/record/projection.js +1 -0
  332. package/dist/src/sessions/schedule-metadata.d.ts +8 -0
  333. package/dist/src/sessions/schedule-metadata.js +1 -0
  334. package/dist/src/sessions/session-service.d.ts +1 -0
  335. package/dist/src/sessions/session-service.js +1 -0
  336. package/dist/src/sessions/types.d.ts +2 -0
  337. package/dist/src/shared/directory-authority/bootstrap.d.ts +1 -0
  338. package/dist/src/shared/directory-authority/bootstrap.js +118 -0
  339. package/dist/src/shared/directory-authority/command.d.ts +8 -0
  340. package/dist/src/shared/directory-authority/command.js +27 -0
  341. package/dist/src/shared/directory-authority/errors.d.ts +5 -0
  342. package/dist/src/shared/directory-authority/errors.js +10 -0
  343. package/dist/src/shared/directory-authority/index.d.ts +3 -0
  344. package/dist/src/shared/directory-authority/index.js +3 -0
  345. package/dist/src/shared/directory-authority/protocol.d.ts +11 -0
  346. package/dist/src/shared/directory-authority/protocol.js +62 -0
  347. package/dist/src/shared/directory-authority/task.d.ts +7 -0
  348. package/dist/src/shared/directory-authority/task.js +97 -0
  349. package/dist/src/shared/http-server-shutdown.d.ts +4 -0
  350. package/dist/src/shared/http-server-shutdown.js +17 -0
  351. package/dist/src/shared/public-http/aggregate-gate.d.ts +3 -0
  352. package/dist/src/shared/public-http/aggregate-gate.js +87 -0
  353. package/dist/src/shared/public-http/deadline.d.ts +2 -0
  354. package/dist/src/shared/public-http/deadline.js +29 -0
  355. package/dist/src/shared/public-http/errors.d.ts +6 -0
  356. package/dist/src/shared/public-http/errors.js +11 -0
  357. package/dist/src/shared/public-http/limits.d.ts +8 -0
  358. package/dist/src/shared/public-http/limits.js +8 -0
  359. package/dist/src/shared/public-http/network-policy.d.ts +11 -0
  360. package/dist/src/shared/public-http/network-policy.js +178 -0
  361. package/dist/src/shared/public-http/public-http.d.ts +24 -0
  362. package/dist/src/shared/public-http/public-http.js +85 -0
  363. package/dist/src/shared/public-http/request-hop.d.ts +18 -0
  364. package/dist/src/shared/public-http/request-hop.js +140 -0
  365. package/dist/src/web-ui/app/ARCHITECTURE.md +66 -4
  366. package/dist/src/web-ui/app/app-bootstrap.js +53 -0
  367. package/dist/src/web-ui/app/app-dom.js +80 -0
  368. package/dist/src/web-ui/app/app.js +195 -212
  369. package/dist/src/web-ui/app/components/conversation-activity.d.ts +2 -0
  370. package/dist/src/web-ui/app/components/conversation-activity.js +34 -7
  371. package/dist/src/web-ui/app/components/conversation-role-cards.d.ts +1 -0
  372. package/dist/src/web-ui/app/components/conversation-role-cards.js +61 -5
  373. package/dist/src/web-ui/app/components/conversation-schedule.js +71 -0
  374. package/dist/src/web-ui/app/components/conversation-status.js +65 -0
  375. package/dist/src/web-ui/app/components/conversation-tools.d.ts +13 -0
  376. package/dist/src/web-ui/app/components/conversation-tools.js +284 -0
  377. package/dist/src/web-ui/app/components/conversation-view.js +39 -11
  378. package/dist/src/web-ui/app/components/dashboard/activity.js +61 -0
  379. package/dist/src/web-ui/app/components/dashboard/icons.js +23 -0
  380. package/dist/src/web-ui/app/components/dashboard/recent-conversations.js +64 -0
  381. package/dist/src/web-ui/app/components/dashboard/workspace.js +107 -0
  382. package/dist/src/web-ui/app/components/message-link-previews.d.ts +16 -0
  383. package/dist/src/web-ui/app/components/message-link-previews.js +179 -0
  384. package/dist/src/web-ui/app/components/schedules/details.js +101 -0
  385. package/dist/src/web-ui/app/components/schedules/form.d.ts +13 -0
  386. package/dist/src/web-ui/app/components/schedules/form.js +246 -0
  387. package/dist/src/web-ui/app/components/schedules/workspace-state.js +59 -0
  388. package/dist/src/web-ui/app/components/schedules/workspace.js +165 -0
  389. package/dist/src/web-ui/app/components/workspace-shell.js +48 -2
  390. package/dist/src/web-ui/app/configuration-feature.js +72 -0
  391. package/dist/src/web-ui/app/controllers/composer-attachments-controller.d.ts +1 -0
  392. package/dist/src/web-ui/app/controllers/composer-attachments-controller.js +17 -6
  393. package/dist/src/web-ui/app/controllers/composer-submit-controller.d.ts +2 -0
  394. package/dist/src/web-ui/app/controllers/composer-submit-controller.js +15 -1
  395. package/dist/src/web-ui/app/controllers/composer-surface-controller.js +58 -0
  396. package/dist/src/web-ui/app/controllers/composer-workspace-controller.d.ts +53 -0
  397. package/dist/src/web-ui/app/controllers/composer-workspace-controller.js +180 -0
  398. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.d.ts +23 -0
  399. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.js +82 -0
  400. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +8 -0
  401. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +28 -39
  402. package/dist/src/web-ui/app/controllers/dashboard-controller.js +127 -0
  403. package/dist/src/web-ui/app/controllers/home-composer-feature.d.ts +40 -0
  404. package/dist/src/web-ui/app/controllers/home-composer-feature.js +119 -0
  405. package/dist/src/web-ui/app/controllers/home-conversation-activation.js +37 -0
  406. package/dist/src/web-ui/app/controllers/realtime-event-controller.d.ts +1 -0
  407. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +74 -3
  408. package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts +2 -1
  409. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +15 -14
  410. package/dist/src/web-ui/app/controllers/schedule-realtime.js +118 -0
  411. package/dist/src/web-ui/app/controllers/schedules-controller.js +421 -0
  412. package/dist/src/web-ui/app/controllers/session-controller.js +30 -3
  413. package/dist/src/web-ui/app/dashboard-feature.js +44 -0
  414. package/dist/src/web-ui/app/index.html +53 -1
  415. package/dist/src/web-ui/app/lib/composer-submission-scope.d.ts +21 -0
  416. package/dist/src/web-ui/app/lib/composer-submission-scope.js +13 -0
  417. package/dist/src/web-ui/app/lib/context-window-snapshot-order.d.ts +15 -0
  418. package/dist/src/web-ui/app/lib/context-window-snapshot-order.js +31 -0
  419. package/dist/src/web-ui/app/lib/conversation-role-model.d.ts +10 -1
  420. package/dist/src/web-ui/app/lib/conversation-role-model.js +97 -15
  421. package/dist/src/web-ui/app/lib/conversation-status-model.d.ts +12 -0
  422. package/dist/src/web-ui/app/lib/conversation-status-model.js +116 -0
  423. package/dist/src/web-ui/app/lib/dashboard-job-templates.js +41 -0
  424. package/dist/src/web-ui/app/lib/dashboard-presentation.js +126 -0
  425. package/dist/src/web-ui/app/lib/message-markdown.d.ts +5 -0
  426. package/dist/src/web-ui/app/lib/message-markdown.js +99 -0
  427. package/dist/src/web-ui/app/lib/message-url-policy.d.ts +1 -0
  428. package/dist/src/web-ui/app/lib/message-url-policy.js +13 -0
  429. package/dist/src/web-ui/app/lib/schedule-errors.js +29 -0
  430. package/dist/src/web-ui/app/lib/schedule-message.js +30 -0
  431. package/dist/src/web-ui/app/lib/schedule-presentation.js +81 -0
  432. package/dist/src/web-ui/app/lib/session-read-state.d.ts +22 -0
  433. package/dist/src/web-ui/app/lib/session-read-state.js +63 -0
  434. package/dist/src/web-ui/app/lib/text-format.js +2 -143
  435. package/dist/src/web-ui/app/lib/tool-activity-event.d.ts +26 -0
  436. package/dist/src/web-ui/app/lib/tool-activity-event.js +228 -0
  437. package/dist/src/web-ui/app/lib/tool-activity-model.d.ts +41 -0
  438. package/dist/src/web-ui/app/lib/tool-activity-model.js +255 -0
  439. package/dist/src/web-ui/app/lib/tool-timeline.d.ts +3 -0
  440. package/dist/src/web-ui/app/lib/tool-timeline.js +18 -0
  441. package/dist/src/web-ui/app/schedules-feature.js +87 -0
  442. package/dist/src/web-ui/app/services/message-link-preview-client.d.ts +14 -0
  443. package/dist/src/web-ui/app/services/message-link-preview-client.js +96 -0
  444. package/dist/src/web-ui/app/services/runtime-web-client/schedules.js +51 -0
  445. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +37 -0
  446. package/dist/src/web-ui/app/services/runtime-web-client.js +13 -8
  447. package/dist/src/web-ui/app/styles/00-tokens-base.css +11 -11
  448. package/dist/src/web-ui/app/styles/18-dashboard.css +384 -0
  449. package/dist/src/web-ui/app/styles/20-chat-composer.css +1 -130
  450. package/dist/src/web-ui/app/styles/26-message-content.css +295 -0
  451. package/dist/src/web-ui/app/styles/27-conversation-tools.css +266 -0
  452. package/dist/src/web-ui/app/styles/28-conversation-status.css +52 -0
  453. package/dist/src/web-ui/app/styles/38-schedule-workspace.css +263 -0
  454. package/dist/src/web-ui/app/styles/38-schedules.css +352 -0
  455. package/dist/src/web-ui/app/styles/90-responsive.css +14 -0
  456. package/dist/src/web-ui/app/styles/91-schedules-responsive.css +72 -0
  457. package/dist/src/web-ui/app/styles/92-dashboard-responsive.css +88 -0
  458. package/dist/src/web-ui/app/styles.css +8 -0
  459. package/dist/src/web-ui/app/ui-behavior.d.ts +1 -1
  460. package/dist/src/web-ui/app/ui-behavior.js +3 -1
  461. package/dist/src/web-ui/app/vendor/README.md +15 -0
  462. package/dist/src/web-ui/app/vendor/markdown-it.LICENSE +22 -0
  463. package/dist/src/web-ui/app/vendor/markdown-it.js +3003 -0
  464. package/dist/src/web-ui/link-preview/metadata.d.ts +9 -0
  465. package/dist/src/web-ui/link-preview/metadata.js +97 -0
  466. package/dist/src/web-ui/link-preview/preview-cache.d.ts +4 -0
  467. package/dist/src/web-ui/link-preview/preview-cache.js +23 -0
  468. package/dist/src/web-ui/link-preview/raster-response.d.ts +9 -0
  469. package/dist/src/web-ui/link-preview/raster-response.js +49 -0
  470. package/dist/src/web-ui/link-preview/routes.d.ts +3 -0
  471. package/dist/src/web-ui/link-preview/routes.js +97 -0
  472. package/dist/src/web-ui/link-preview/service.d.ts +11 -0
  473. package/dist/src/web-ui/link-preview/service.js +117 -0
  474. package/dist/src/web-ui/local-runtime/api-router.d.ts +4 -1
  475. package/dist/src/web-ui/local-runtime/api-router.js +42 -73
  476. package/dist/src/web-ui/local-runtime/contracts.d.ts +2 -2
  477. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +12 -1
  478. package/dist/src/web-ui/local-runtime/environment-registry.js +38 -3
  479. package/dist/src/web-ui/local-runtime/realtime-controller.js +3 -1
  480. package/dist/src/web-ui/local-runtime/request-execution.d.ts +5 -1
  481. package/dist/src/web-ui/local-runtime/request-execution.js +38 -2
  482. package/dist/src/web-ui/local-runtime/schedule-job-creation.d.ts +7 -0
  483. package/dist/src/web-ui/local-runtime/schedule-job-creation.js +62 -0
  484. package/dist/src/web-ui/local-runtime/schedule-management-routes.d.ts +30 -0
  485. package/dist/src/web-ui/local-runtime/schedule-management-routes.js +134 -0
  486. package/dist/src/web-ui/local-runtime/schedule-run-page.d.ts +5 -0
  487. package/dist/src/web-ui/local-runtime/schedule-run-page.js +23 -0
  488. package/dist/src/web-ui/local-runtime/session-routes.d.ts +17 -0
  489. package/dist/src/web-ui/local-runtime/session-routes.js +74 -0
  490. package/dist/src/web-ui/local-runtime-backend.d.ts +2 -0
  491. package/dist/src/web-ui/local-runtime-backend.js +11 -1
  492. package/dist/src/web-ui/schedule-creation-contract.d.ts +7 -0
  493. package/dist/src/web-ui/schedule-creation-contract.js +1 -0
  494. package/dist/src/web-ui/server-shutdown.d.ts +4 -0
  495. package/dist/src/web-ui/server-shutdown.js +32 -0
  496. package/dist/src/web-ui/server.js +13 -10
  497. package/dist/src/web-ui/session-read-state/availability.d.ts +16 -0
  498. package/dist/src/web-ui/session-read-state/availability.js +20 -0
  499. package/dist/src/web-ui/session-read-state/projection.d.ts +17 -0
  500. package/dist/src/web-ui/session-read-state/projection.js +71 -0
  501. package/dist/src/web-ui/session-read-state/service.d.ts +86 -0
  502. package/dist/src/web-ui/session-read-state/service.js +89 -0
  503. package/dist/src/web-ui/session-read-state/store.d.ts +22 -0
  504. package/dist/src/web-ui/session-read-state/store.js +110 -0
  505. package/docs/configuration.md +41 -1
  506. package/docs/long-term-memory.md +46 -5
  507. package/docs/plugins.md +15 -9
  508. package/docs/runtime-invariant-coverage.md +1 -1
  509. package/docs/runtime-library.md +23 -0
  510. package/docs/runtime-public-contracts.md +32 -1
  511. package/package.json +3 -1
  512. package/plugins/code-outline/plugin.json +15 -0
  513. package/plugins/document-reader/plugin.json +17 -0
  514. package/plugins/exec/plugin.json +3 -3
  515. package/plugins/exec/skills/exec_skill/SKILL.md +1 -1
  516. package/plugins/exec/source/process-manager.ts +1 -20
  517. package/plugins/exec/source/shell-platform.ts +29 -0
  518. package/plugins/exec/src/index.cjs +25 -18
  519. package/plugins/filesystem/plugin.json +17 -2
  520. package/plugins/filesystem/source/atomic-write.ts +9 -0
  521. package/plugins/filesystem/source/bounded-io.ts +5 -99
  522. package/plugins/filesystem/source/directory-authority-write.ts +64 -0
  523. package/plugins/filesystem/source/directory-sample-task.ts +23 -0
  524. package/plugins/filesystem/source/directory-sample.ts +132 -0
  525. package/plugins/filesystem/source/directory-write-task.ts +160 -0
  526. package/plugins/filesystem/source/mutation-parent.ts +11 -0
  527. package/plugins/filesystem/src/index.cjs +693 -118
  528. package/plugins/json-inspector/plugin.json +12 -0
  529. package/plugins/local-search/plugin.json +12 -0
  530. package/plugins/local-search/source/index.ts +2 -0
  531. package/plugins/local-search/source/paths.ts +30 -7
  532. package/plugins/local-search/source/ripgrep-process.ts +69 -0
  533. package/plugins/local-search/source/ripgrep.ts +19 -23
  534. package/plugins/local-search/src/index.cjs +295 -32
  535. package/plugins/memory/plugin.json +26 -1
  536. package/plugins/memory/source/index.ts +10 -6
  537. package/plugins/memory/src/index.cjs +11 -7
  538. package/plugins/project-orientation/plugin.json +14 -0
  539. package/plugins/web/source/aggregate-gate.ts +8 -130
  540. package/plugins/web/source/deadline.ts +14 -50
  541. package/plugins/web/source/errors.ts +17 -11
  542. package/plugins/web/source/limits.ts +3 -6
  543. package/plugins/web/source/network-policy.ts +28 -226
  544. package/plugins/web/source/public-http.ts +17 -142
  545. package/plugins/web/source/request-hop.ts +11 -191
  546. package/plugins/web/src/index.cjs +119 -59
  547. package/runtime.config.schema.json +7 -0
  548. package/src/runtime/README.md +105 -1
  549. package/src/runtime/local-host/README.md +86 -0
  550. package/src/runtime/scheduler/README.md +166 -0
@@ -1,13 +1,17 @@
1
- import { createRuntimeApplication } from "../../runtime/composition.js";
1
+ import { createLocalRuntimeApplication, } from "../../runtime/local-application.js";
2
2
  import { loadRuntimeConfig } from "../../runtime/config.js";
3
3
  import { inspectRuntimeConfigFileWithMeta } from "../../runtime/config/loader.js";
4
4
  import { loadRuntimeModelCatalog } from "../../runtime/model/model-catalog.js";
5
5
  import { inspectRuntimeSetupRequirement } from "./runtime-availability.js";
6
6
  export class RuntimeEnvironmentRegistry {
7
7
  options;
8
+ schedulerBindings;
8
9
  environments = new Map();
9
- constructor(options) {
10
+ stopped = false;
11
+ stopping;
12
+ constructor(options, schedulerBindings = {}) {
10
13
  this.options = options;
14
+ this.schedulerBindings = schedulerBindings;
11
15
  }
12
16
  modelCatalog(environmentId) {
13
17
  const source = inspectRuntimeConfigFileWithMeta(this.options.rootDir ?? process.cwd(), this.options.configPath ?? process.env.LLM_RUNTIME_CONFIG_FILE);
@@ -26,15 +30,46 @@ export class RuntimeEnvironmentRegistry {
26
30
  return availability.status === "setup_required" ? availability : null;
27
31
  }
28
32
  get(environmentId) {
33
+ this.requireEnvironmentIntakeOpen();
29
34
  const normalized = environmentId || this.options.defaultEnvironmentId;
30
35
  const existing = this.environments.get(normalized);
31
36
  if (existing)
32
37
  return existing;
33
38
  const config = this.loadConfig(normalized);
34
- const environment = createRuntimeApplication(config);
39
+ const environment = createLocalRuntimeApplication(config, {
40
+ scheduledRequestOptions: this.schedulerBindings.requestOptions,
41
+ });
42
+ if (this.schedulerBindings.publish) {
43
+ environment.subscribeScheduledEvents(this.schedulerBindings.publish);
44
+ }
35
45
  this.environments.set(normalized, environment);
36
46
  return environment;
37
47
  }
48
+ async start(environmentIds) {
49
+ this.requireEnvironmentIntakeOpen();
50
+ await Promise.all(environmentIds.map((id) => this.startEnvironment(id)));
51
+ }
52
+ async startEnvironment(id) {
53
+ try {
54
+ if (this.setupRequirement(id))
55
+ return;
56
+ await this.get(id).start();
57
+ }
58
+ catch (error) {
59
+ console.error(`Scheduler unavailable for environment ${id}:`, error);
60
+ }
61
+ }
62
+ stop() {
63
+ if (this.stopping)
64
+ return this.stopping;
65
+ this.stopped = true;
66
+ this.stopping = Promise.all([...this.environments.values()].map(async (environment) => environment.stop())).then(() => undefined);
67
+ return this.stopping;
68
+ }
69
+ requireEnvironmentIntakeOpen() {
70
+ if (this.stopped)
71
+ throw new Error("web_runtime_stopped");
72
+ }
38
73
  profileEnv(environmentId) {
39
74
  return {
40
75
  ...process.env,
@@ -32,7 +32,7 @@ export class LocalRealtimeController {
32
32
  return;
33
33
  }
34
34
  if (message.type === "steer_request") {
35
- this.clients.send(client, this.requests.handleSteer(message));
35
+ this.clients.send(client, await this.requests.handleSteer(message, (id) => this.environments.get(id)));
36
36
  return;
37
37
  }
38
38
  if (message.type !== "resume_request")
@@ -53,6 +53,7 @@ export class LocalRealtimeController {
53
53
  this.clients.send(client, {
54
54
  type: "completed",
55
55
  requestId,
56
+ sessionId: replay.sessionId,
56
57
  environment: environmentId,
57
58
  output: replay.finalState.output,
58
59
  });
@@ -61,6 +62,7 @@ export class LocalRealtimeController {
61
62
  this.clients.send(client, {
62
63
  type: "failed",
63
64
  requestId,
65
+ sessionId: replay.sessionId,
64
66
  environment: environmentId,
65
67
  error: replay.finalState.error,
66
68
  });
@@ -1,4 +1,6 @@
1
1
  import type { ServerResponse } from "node:http";
2
+ import type { SchedulerRun } from "../../runtime/scheduler/contracts.js";
3
+ import type { RuntimeRequestOptions } from "../../runtime/composition.js";
2
4
  import type { JsonObject, RuntimeEnvironment } from "./contracts.js";
3
5
  import { RealtimeClientHub } from "./realtime-hub.js";
4
6
  export declare class LocalRequestExecution {
@@ -6,10 +8,12 @@ export declare class LocalRequestExecution {
6
8
  private readonly activeRequests;
7
9
  private readonly pendingToolApprovals;
8
10
  constructor(realtime: RealtimeClientHub);
11
+ scheduledRequestOptions(run: SchedulerRun): RuntimeRequestOptions;
12
+ publishScheduled(payload: JsonObject): void;
9
13
  start(res: ServerResponse, body: JsonObject, environmentId: string, environment: RuntimeEnvironment): Promise<void>;
10
14
  activeReplay(requestId: string, afterSeq: number): JsonObject | undefined;
11
15
  healthDetails(): JsonObject[];
12
- handleSteer(message: JsonObject): JsonObject;
16
+ handleSteer(message: JsonObject, resolveEnvironment: (id: string) => RuntimeEnvironment): Promise<JsonObject>;
13
17
  resolveToolApproval(message: JsonObject): void;
14
18
  private run;
15
19
  private createToolApprovalController;
@@ -11,6 +11,37 @@ export class LocalRequestExecution {
11
11
  constructor(realtime) {
12
12
  this.realtime = realtime;
13
13
  }
14
+ scheduledRequestOptions(run) {
15
+ const requestSteering = createRequestSteeringInbox({
16
+ requestId: run.requestId,
17
+ });
18
+ this.activeRequests.set(run.requestId, {
19
+ requestId: run.requestId,
20
+ sessionId: run.sessionId,
21
+ environmentId: run.environmentId,
22
+ startedAt: Date.now(),
23
+ lastEventAt: Date.now(),
24
+ lastEventName: "request.started",
25
+ events: [],
26
+ finalState: null,
27
+ requestSteering,
28
+ });
29
+ return {
30
+ toolApprovalController: this.createToolApprovalController(),
31
+ requestSteering,
32
+ };
33
+ }
34
+ publishScheduled(payload) {
35
+ const isTerminal = payload.type === "completed" || payload.type === "failed";
36
+ const outbound = isTerminal
37
+ ? { ...payload, requestOrigin: "schedule" }
38
+ : payload;
39
+ if (payload.sessionDeleted !== true)
40
+ this.publish(outbound);
41
+ if (isTerminal) {
42
+ this.activeRequests.delete(getString(payload.requestId));
43
+ }
44
+ }
14
45
  async start(res, body, environmentId, environment) {
15
46
  const text = getString(body.text).trim();
16
47
  const sessionId = getString(body.sessionId).trim();
@@ -79,12 +110,17 @@ export class LocalRequestExecution {
79
110
  idleMs: Date.now() - request.lastEventAt,
80
111
  }));
81
112
  }
82
- handleSteer(message) {
113
+ async handleSteer(message, resolveEnvironment) {
83
114
  const requestId = getString(message.requestId).trim();
84
115
  const steerId = getString(message.steerId).trim();
85
116
  const text = getString(message.text).trim();
86
117
  const active = requestId ? this.activeRequests.get(requestId) : undefined;
87
- const result = active?.requestSteering.append({ steerId, text }) ??
118
+ const steer = active
119
+ ? resolveEnvironment(active.environmentId).requests.steer
120
+ : undefined;
121
+ const result = (steer
122
+ ? await steer(requestId, { steerId, text })
123
+ : active?.requestSteering.append({ steerId, text })) ??
88
124
  { ok: false, reason: "request_not_active" };
89
125
  return result.ok
90
126
  ? {
@@ -0,0 +1,7 @@
1
+ import type { SessionStore } from "../../runtime/ports.js";
2
+ import type { SchedulerService } from "../../runtime/scheduler/contracts.js";
3
+ import type { JsonObject } from "./contracts.js";
4
+ export type ScheduleConversationStore = Pick<SessionStore, "getOrCreateSession" | "getSessionById" | "updateSessionTitle" | "deleteSession">;
5
+ type ScheduleCreationService = Pick<SchedulerService, "create" | "list">;
6
+ export declare function createWebScheduleJob(service: ScheduleCreationService, sessions: ScheduleConversationStore | undefined, body: JsonObject | null): Promise<import("../../runtime/scheduler/contracts.js").SchedulerJob>;
7
+ export {};
@@ -0,0 +1,62 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { validateSchedulerJobInput } from "../../runtime/scheduler/schedule-validation.js";
3
+ function requestsDedicatedConversation(body) {
4
+ if (body?.newConversation === undefined)
5
+ return false;
6
+ if (body.newConversation === false)
7
+ return false;
8
+ if (body.newConversation !== true)
9
+ throw new Error("scheduler_invalid_job: newConversation must be a boolean.");
10
+ if (body.sessionId !== undefined)
11
+ throw new Error("scheduler_invalid_job: Choose a new or existing conversation.");
12
+ return true;
13
+ }
14
+ function isEmptyScheduleConversation(session) {
15
+ if (session.messageCount !== 0)
16
+ return false;
17
+ if (session.messages.length > 0)
18
+ return false;
19
+ if (session.requests?.length)
20
+ return false;
21
+ return true;
22
+ }
23
+ async function removeUnlinkedScheduleConversation(service, sessions, sessionId) {
24
+ try {
25
+ const jobs = await service.list({ sessionId });
26
+ if (jobs.length > 0)
27
+ return false;
28
+ const session = await sessions.getSessionById(sessionId);
29
+ if (!session)
30
+ return true;
31
+ if (!isEmptyScheduleConversation(session))
32
+ return false;
33
+ return await sessions.deleteSession(sessionId);
34
+ }
35
+ catch {
36
+ // A failed lookup cannot prove that the save failed or the session is unused.
37
+ return false;
38
+ }
39
+ }
40
+ export async function createWebScheduleJob(service, sessions, body) {
41
+ if (!requestsDedicatedConversation(body))
42
+ return service.create(body);
43
+ if (!sessions)
44
+ throw new Error("scheduler_unavailable: Conversation storage is unavailable.");
45
+ const { newConversation: _newConversation, sessionId: _sessionId, ...fields } = body;
46
+ const sessionId = `job-${randomUUID()}`;
47
+ const input = { ...fields, sessionId };
48
+ validateSchedulerJobInput(input);
49
+ try {
50
+ await sessions.getOrCreateSession(sessionId);
51
+ const session = await sessions.updateSessionTitle(sessionId, input.title);
52
+ if (!session)
53
+ throw new Error("scheduler_session_not_found");
54
+ return await service.create(input);
55
+ }
56
+ catch (error) {
57
+ if (await removeUnlinkedScheduleConversation(service, sessions, sessionId))
58
+ throw error;
59
+ const detail = error instanceof Error ? error.message : String(error);
60
+ throw new Error(`Could not confirm the Job save: ${detail}. The conversation was kept; check Jobs before saving again.`, { cause: error });
61
+ }
62
+ }
@@ -0,0 +1,30 @@
1
+ import type { ServerResponse } from "node:http";
2
+ import type { RuntimeConfig } from "../../runtime/ports.js";
3
+ import type { SchedulerService } from "../../runtime/scheduler/contracts.js";
4
+ import type { JsonObject } from "./contracts.js";
5
+ import { type ScheduleConversationStore } from "./schedule-job-creation.js";
6
+ type ScheduleRouteRequest = {
7
+ method: string;
8
+ segments: readonly string[];
9
+ url: URL;
10
+ body: JsonObject | null;
11
+ environmentId: string;
12
+ response: ServerResponse;
13
+ };
14
+ type ScheduleEnvironment = {
15
+ start(): Promise<void>;
16
+ services: {
17
+ config: RuntimeConfig;
18
+ scheduler?: Omit<SchedulerService, "start" | "stop">;
19
+ sessions?: ScheduleConversationStore;
20
+ };
21
+ };
22
+ export declare class ScheduleManagementRoutes {
23
+ private readonly resolveEnvironment;
24
+ constructor(resolveEnvironment: (id: string) => ScheduleEnvironment);
25
+ handle(request: ScheduleRouteRequest): Promise<boolean>;
26
+ private handleScheduleRoute;
27
+ private handleRunCollection;
28
+ private handleCollection;
29
+ }
30
+ export {};
@@ -0,0 +1,134 @@
1
+ import { requireAvailableScheduleModel } from "../../runtime/capabilities/scheduling/model-validation.js";
2
+ import { sendJson } from "./http.js";
3
+ import { readScheduleRunPage } from "./schedule-run-page.js";
4
+ import { createWebScheduleJob, } from "./schedule-job-creation.js";
5
+ function isScheduleRunCollection(segments) {
6
+ if (segments.length !== 2)
7
+ return false;
8
+ return segments[1] === "runs";
9
+ }
10
+ function sendScheduleError(response, error) {
11
+ const message = error instanceof Error ? error.message : String(error);
12
+ const code = error instanceof Error && "code" in error ? String(error.code) : message;
13
+ const isMissingRecord = code.includes("not_found");
14
+ const isUnavailable = code === "scheduler_store_in_use" || code === "scheduler_stopped";
15
+ if (isMissingRecord) {
16
+ sendJson(response, 404, { ok: false, error: code, message });
17
+ return;
18
+ }
19
+ if (isUnavailable) {
20
+ sendJson(response, 409, { ok: false, error: code, message });
21
+ return;
22
+ }
23
+ sendJson(response, 400, { ok: false, error: code, message });
24
+ }
25
+ export class ScheduleManagementRoutes {
26
+ resolveEnvironment;
27
+ constructor(resolveEnvironment) {
28
+ this.resolveEnvironment = resolveEnvironment;
29
+ }
30
+ async handle(request) {
31
+ if (request.segments[0] !== "schedules")
32
+ return false;
33
+ try {
34
+ const environment = this.resolveEnvironment(request.environmentId);
35
+ await environment.start();
36
+ const service = environment.services.scheduler;
37
+ if (!service)
38
+ throw new Error("scheduler_unavailable");
39
+ await this.handleScheduleRoute(request, environment, service);
40
+ }
41
+ catch (error) {
42
+ sendScheduleError(request.response, error);
43
+ }
44
+ return true;
45
+ }
46
+ async handleScheduleRoute(request, environment, service) {
47
+ const [, id, action] = request.segments;
48
+ const { response, method, body } = request;
49
+ if (!id) {
50
+ await this.handleCollection(request, environment, service);
51
+ return;
52
+ }
53
+ if (request.segments.length > 3) {
54
+ sendJson(response, 404, { ok: false, error: "not_found" });
55
+ return;
56
+ }
57
+ if (isScheduleRunCollection(request.segments)) {
58
+ await this.handleRunCollection(request, service);
59
+ return;
60
+ }
61
+ const job = await service.get(id);
62
+ if (!job)
63
+ throw new Error("scheduler_job_not_found");
64
+ if (method === "GET" && !action) {
65
+ sendJson(response, 200, { ok: true, job });
66
+ return;
67
+ }
68
+ if (method === "GET" && action === "runs") {
69
+ const page = await readScheduleRunPage(service, id, request.url.searchParams);
70
+ sendJson(response, 200, { ok: true, ...page });
71
+ return;
72
+ }
73
+ if (method === "PATCH" && !action) {
74
+ if (body?.modelProfileId !== undefined)
75
+ requireAvailableScheduleModel(environment.services.config, body.modelProfileId);
76
+ sendJson(response, 200, {
77
+ ok: true,
78
+ job: await service.update(id, (body ?? {})),
79
+ });
80
+ return;
81
+ }
82
+ if (method === "POST" && action === "run-now") {
83
+ sendJson(response, 200, { ok: true, run: await service.runNow(id) });
84
+ return;
85
+ }
86
+ if (method === "POST" && action === "pause") {
87
+ sendJson(response, 200, { ok: true, job: await service.pause(id) });
88
+ return;
89
+ }
90
+ if (method === "POST" && action === "resume") {
91
+ sendJson(response, 200, { ok: true, job: await service.resume(id) });
92
+ return;
93
+ }
94
+ if (method === "POST" && action === "cancel") {
95
+ sendJson(response, 200, { ok: true, job: await service.cancel(id) });
96
+ return;
97
+ }
98
+ response.setHeader("allow", action ? "GET, POST" : "GET, PATCH");
99
+ sendJson(response, 405, { ok: false, error: "method_not_allowed" });
100
+ }
101
+ async handleRunCollection(request, service) {
102
+ if (request.method !== "GET") {
103
+ request.response.setHeader("allow", "GET");
104
+ sendJson(request.response, 405, {
105
+ ok: false,
106
+ error: "method_not_allowed",
107
+ });
108
+ return;
109
+ }
110
+ const page = await readScheduleRunPage(service, undefined, request.url.searchParams);
111
+ sendJson(request.response, 200, { ok: true, ...page });
112
+ }
113
+ async handleCollection(request, environment, service) {
114
+ if (request.method === "GET") {
115
+ const sessionId = request.url.searchParams.get("sessionId") || undefined;
116
+ const search = request.url.searchParams.get("search") || undefined;
117
+ const state = request.url.searchParams.get("state");
118
+ const jobs = await service.list({ sessionId, search });
119
+ sendJson(request.response, 200, {
120
+ ok: true,
121
+ jobs: state ? jobs.filter((job) => job.state === state) : jobs,
122
+ });
123
+ return;
124
+ }
125
+ if (request.method === "POST") {
126
+ requireAvailableScheduleModel(environment.services.config, request.body?.modelProfileId);
127
+ const job = await createWebScheduleJob(service, environment.services.sessions, request.body);
128
+ sendJson(request.response, 201, { ok: true, job });
129
+ return;
130
+ }
131
+ request.response.setHeader("allow", "GET, POST");
132
+ sendJson(request.response, 405, { ok: false, error: "method_not_allowed" });
133
+ }
134
+ }
@@ -0,0 +1,5 @@
1
+ import type { SchedulerService } from "../../runtime/scheduler/contracts.js";
2
+ export declare function readScheduleRunPage(service: Pick<SchedulerService, "listRuns">, jobId: string | undefined, params: URLSearchParams): Promise<{
3
+ runs: import("../../runtime/scheduler/contracts.js").SchedulerRun[];
4
+ nextCursor: string | null;
5
+ }>;
@@ -0,0 +1,23 @@
1
+ export async function readScheduleRunPage(service, jobId, params) {
2
+ const limit = requireWebRunPageLimit(params.get("limit"));
3
+ const cursor = params.get("cursor") ?? undefined;
4
+ // Bound the owner response before it crosses the shared Runtime transport.
5
+ const page = await service.listRuns(jobId, { cursor, limit: limit + 1 });
6
+ const runs = page.slice(0, limit);
7
+ return {
8
+ runs,
9
+ nextCursor: page.length > limit ? runs.at(-1).id : null,
10
+ };
11
+ }
12
+ function requireWebRunPageLimit(value) {
13
+ if (value === null)
14
+ return 50;
15
+ const limit = Number(value);
16
+ if (!Number.isSafeInteger(limit))
17
+ throw new Error("scheduler_run_page_limit_invalid");
18
+ if (limit < 1)
19
+ throw new Error("scheduler_run_page_limit_invalid");
20
+ if (limit > 100)
21
+ throw new Error("scheduler_run_page_limit_invalid");
22
+ return limit;
23
+ }
@@ -0,0 +1,17 @@
1
+ import type { ServerResponse } from "node:http";
2
+ import type { RuntimeEnvironment, JsonObject } from "./contracts.js";
3
+ import { WebSessionReadStates } from "../session-read-state/service.js";
4
+ type SessionRouteRequest = {
5
+ method: string;
6
+ segments: string[];
7
+ body: JsonObject | null;
8
+ environmentId: string;
9
+ environment: RuntimeEnvironment;
10
+ response: ServerResponse;
11
+ };
12
+ export declare class WebSessionRoutes {
13
+ private readonly readStates;
14
+ constructor(readStates: WebSessionReadStates);
15
+ handle(request: SessionRouteRequest): Promise<boolean>;
16
+ }
17
+ export {};
@@ -0,0 +1,74 @@
1
+ import { deleteSessionWithAttachments } from "../../runtime/session/session-attachment-deletion.js";
2
+ import { deleteSessionAttachmentsIfSupported } from "./attachment-routes.js";
3
+ import { sendJson } from "./http.js";
4
+ export class WebSessionRoutes {
5
+ readStates;
6
+ constructor(readStates) {
7
+ this.readStates = readStates;
8
+ }
9
+ async handle(request) {
10
+ const { method, segments, body, environmentId, environment, response } = request;
11
+ if (segments[0] !== "chat" || segments[1] !== "sessions")
12
+ return false;
13
+ const [, , sessionId, action] = segments;
14
+ if (segments.length > 4)
15
+ return false;
16
+ if (method === "GET" && segments.length === 2) {
17
+ sendJson(response, 200, {
18
+ ok: true,
19
+ ...(await this.readStates.list(environmentId)),
20
+ });
21
+ return true;
22
+ }
23
+ if (!sessionId)
24
+ return false;
25
+ const sessions = environment.services.sessions;
26
+ if (method === "GET" && action === "messages") {
27
+ const snapshot = await sessions.getSessionSnapshot(sessionId, {
28
+ includeRequests: true,
29
+ });
30
+ if (!snapshot) {
31
+ sendJson(response, 404, {
32
+ ok: false,
33
+ error: "session_not_found",
34
+ messages: [],
35
+ requests: [],
36
+ });
37
+ return true;
38
+ }
39
+ sendJson(response, 200, {
40
+ ok: true,
41
+ ...snapshot,
42
+ readState: await this.readStates.project(environmentId, snapshot),
43
+ });
44
+ return true;
45
+ }
46
+ if (method === "POST" && action === "read") {
47
+ const readState = await this.readStates.mark(environmentId, sessionId, body ?? {});
48
+ if (!readState) {
49
+ sendJson(response, 404, { ok: false, error: "session_not_found" });
50
+ return true;
51
+ }
52
+ sendJson(response, 200, { ok: true, readState });
53
+ return true;
54
+ }
55
+ if (method === "DELETE" && action === "messages") {
56
+ const result = await sessions.clearSessionMessages(sessionId);
57
+ if (!result) {
58
+ sendJson(response, 404, { ok: false, error: "session_not_found" });
59
+ return true;
60
+ }
61
+ await this.readStates.reset(environmentId, sessionId);
62
+ await deleteSessionAttachmentsIfSupported(environment, sessionId);
63
+ sendJson(response, 200, { ok: true, ...result });
64
+ return true;
65
+ }
66
+ if (method === "DELETE" && !action) {
67
+ const result = await deleteSessionWithAttachments(sessions, environment.services.attachments, sessionId);
68
+ await this.readStates.forget(environmentId, sessionId);
69
+ sendJson(response, 200, { ok: true, ...result });
70
+ return true;
71
+ }
72
+ return false;
73
+ }
74
+ }
@@ -11,4 +11,6 @@ export declare class LocalRuntimeWebBackend {
11
11
  constructor(options: LocalRuntimeBackendOptions);
12
12
  handleHttp(req: IncomingMessage, res: ServerResponse, pathname: string): Promise<boolean>;
13
13
  handleRealtimeConnection(client: WebSocket): void;
14
+ start(environmentIds: readonly string[]): Promise<void>;
15
+ stop(): Promise<void>;
14
16
  }
@@ -19,9 +19,12 @@ export class LocalRuntimeWebBackend {
19
19
  providerAdapters: options.providerAdapters,
20
20
  }),
21
21
  };
22
- this.environments = new RuntimeEnvironmentRegistry(resolvedOptions);
23
22
  const clients = new RealtimeClientHub();
24
23
  const requests = new LocalRequestExecution(clients);
24
+ this.environments = new RuntimeEnvironmentRegistry(resolvedOptions, {
25
+ requestOptions: (run) => requests.scheduledRequestOptions(run),
26
+ publish: (event) => requests.publishScheduled(event),
27
+ });
25
28
  this.api = new LocalRuntimeApiRouter(resolvedOptions, this.environments, requests);
26
29
  this.realtime = new LocalRealtimeController(resolvedOptions, this.environments, requests, clients);
27
30
  this.controls = new LocalRuntimeControlRoutes(requests);
@@ -64,4 +67,11 @@ export class LocalRuntimeWebBackend {
64
67
  handleRealtimeConnection(client) {
65
68
  this.realtime.connect(client);
66
69
  }
70
+ async start(environmentIds) {
71
+ await this.api.initializeSessionReadState(environmentIds);
72
+ await this.environments.start(environmentIds);
73
+ }
74
+ stop() {
75
+ return this.environments.stop();
76
+ }
67
77
  }
@@ -0,0 +1,7 @@
1
+ import type { CreateSchedulerJobInput } from "../runtime/scheduler/contracts.js";
2
+ export type CreateWebScheduleJobInput = (CreateSchedulerJobInput & {
3
+ newConversation?: false;
4
+ }) | (Omit<CreateSchedulerJobInput, "sessionId"> & {
5
+ newConversation: true;
6
+ sessionId?: never;
7
+ });
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,4 @@
1
+ import type { Server } from "node:http";
2
+ import type { WebSocketServer } from "ws";
3
+ /** Fence transport and environment intake before waiting for startup or stop. */
4
+ export declare function createWebUiShutdown(server: Server, webSockets: WebSocketServer, startup: Promise<void> | undefined, stopBackend: () => Promise<void> | undefined, listenAbort: AbortController): () => Promise<void>;
@@ -0,0 +1,32 @@
1
+ import { closeHttpServerImmediately } from "../shared/http-server-shutdown.js";
2
+ /** Fence transport and environment intake before waiting for startup or stop. */
3
+ export function createWebUiShutdown(server, webSockets, startup, stopBackend, listenAbort) {
4
+ let closing;
5
+ return () => {
6
+ if (closing)
7
+ return closing;
8
+ const wasListening = server.listening;
9
+ const transport = closeHttpServerImmediately(server, webSockets).catch((error) => {
10
+ if (isPendingListenAlreadyClosed(error, wasListening))
11
+ return;
12
+ throw error;
13
+ });
14
+ listenAbort.abort();
15
+ const backend = (async () => {
16
+ await stopBackend();
17
+ })();
18
+ closing = Promise.allSettled([transport, startup, backend]).then((results) => {
19
+ // Preserve transport-close error precedence, then original startup error.
20
+ for (const result of results) {
21
+ if (result.status === "rejected")
22
+ throw result.reason;
23
+ }
24
+ });
25
+ return closing;
26
+ };
27
+ }
28
+ function isPendingListenAlreadyClosed(error, wasListening) {
29
+ if (wasListening)
30
+ return false;
31
+ return error.code === "ERR_SERVER_NOT_RUNNING";
32
+ }