@abot-ai/runtime 1.2.0 → 1.3.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 (516) hide show
  1. package/README.md +14 -0
  2. package/dist/src/bridge/request-steering.d.ts +2 -1
  3. package/dist/src/bridge/request-steering.js +4 -2
  4. package/dist/src/bridge/runtime-replay.js +2 -19
  5. package/dist/src/bridge/start-agent-bridge.js +1 -1
  6. package/dist/src/capabilities/normal-invocation/validator.js +1 -1
  7. package/dist/src/capabilities/tool-definition-validator/event-presentation.js +3 -0
  8. package/dist/src/capabilities/tool-definition-validator/event-result-metadata.d.ts +2 -0
  9. package/dist/src/capabilities/tool-definition-validator/event-result-metadata.js +74 -0
  10. package/dist/src/capabilities/tool-event-metadata.js +3 -0
  11. package/dist/src/capabilities/tool-result-event-projection.d.ts +3 -0
  12. package/dist/src/capabilities/tool-result-event-projection.js +82 -0
  13. package/dist/src/capabilities/tool-types.d.ts +5 -0
  14. package/dist/src/cli/abot.js +2 -11
  15. package/dist/src/runtime/adapters/in-memory-session-store.js +1 -0
  16. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.js +11 -2
  17. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.d.ts +2 -0
  18. package/dist/src/runtime/adapters/long-term-memory/file-lock/synchronous-release.d.ts +2 -0
  19. package/dist/src/runtime/adapters/long-term-memory/file-lock/synchronous-release.js +40 -0
  20. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.d.ts +3 -0
  21. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.js +9 -0
  22. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/rejection-event.d.ts +13 -0
  23. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/rejection-event.js +25 -0
  24. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.js +18 -2
  25. package/dist/src/runtime/adapters/registered-tool-normal-invocations/executor.js +8 -0
  26. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.js +7 -3
  27. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +17 -2
  28. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/event-metadata.d.ts +9 -0
  29. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/event-metadata.js +8 -0
  30. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.js +16 -1
  31. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.js +2 -2
  32. package/dist/src/runtime/adapters/scheduled-request-outcome.d.ts +11 -0
  33. package/dist/src/runtime/adapters/scheduled-request-outcome.js +41 -0
  34. package/dist/src/runtime/adapters/scheduler-runtime.d.ts +19 -0
  35. package/dist/src/runtime/adapters/scheduler-runtime.js +138 -0
  36. package/dist/src/runtime/capabilities/scheduling/create-operations.d.ts +55 -0
  37. package/dist/src/runtime/capabilities/scheduling/create-operations.js +30 -0
  38. package/dist/src/runtime/capabilities/scheduling/create-time-zone.d.ts +1 -0
  39. package/dist/src/runtime/capabilities/scheduling/create-time-zone.js +11 -0
  40. package/dist/src/runtime/capabilities/scheduling/job-list-page.d.ts +25 -0
  41. package/dist/src/runtime/capabilities/scheduling/job-list-page.js +40 -0
  42. package/dist/src/runtime/capabilities/scheduling/model-validation.d.ts +2 -0
  43. package/dist/src/runtime/capabilities/scheduling/model-validation.js +15 -0
  44. package/dist/src/runtime/capabilities/scheduling/tool-contract.d.ts +2 -0
  45. package/dist/src/runtime/capabilities/scheduling/tool-contract.js +35 -0
  46. package/dist/src/runtime/capabilities/scheduling/tool-input-properties.d.ts +43 -0
  47. package/dist/src/runtime/capabilities/scheduling/tool-input-properties.js +27 -0
  48. package/dist/src/runtime/capabilities/scheduling/tool-module.d.ts +4 -0
  49. package/dist/src/runtime/capabilities/scheduling/tool-module.js +158 -0
  50. package/dist/src/runtime/capabilities/scheduling/update-operations.d.ts +2 -0
  51. package/dist/src/runtime/capabilities/scheduling/update-operations.js +49 -0
  52. package/dist/src/runtime/composition.d.ts +23 -3
  53. package/dist/src/runtime/composition.js +12 -17
  54. package/dist/src/runtime/config/environment-paths.d.ts +10 -0
  55. package/dist/src/runtime/config/environment-paths.js +31 -0
  56. package/dist/src/runtime/config/environment-storage.d.ts +9 -0
  57. package/dist/src/runtime/config/environment-storage.js +65 -0
  58. package/dist/src/runtime/config/fields.js +7 -0
  59. package/dist/src/runtime/config/long-term-memory.js +15 -0
  60. package/dist/src/runtime/config/schema.js +8 -0
  61. package/dist/src/runtime/config.js +9 -5
  62. package/dist/src/runtime/context/scheduled-execution-context.d.ts +10 -0
  63. package/dist/src/runtime/context/scheduled-execution-context.js +52 -0
  64. package/dist/src/runtime/default-adapters.d.ts +3 -32
  65. package/dist/src/runtime/default-adapters.js +3 -270
  66. package/dist/src/runtime/default-environment-adapters.d.ts +19 -0
  67. package/dist/src/runtime/default-environment-adapters.js +144 -0
  68. package/dist/src/runtime/index.d.ts +5 -0
  69. package/dist/src/runtime/index.js +4 -0
  70. package/dist/src/runtime/local-application.d.ts +22 -0
  71. package/dist/src/runtime/local-application.js +81 -0
  72. package/dist/src/runtime/local-host/app-memory-dispatch.d.ts +11 -0
  73. package/dist/src/runtime/local-host/app-memory-dispatch.js +103 -0
  74. package/dist/src/runtime/local-host/app-owner.d.ts +4 -0
  75. package/dist/src/runtime/local-host/app-owner.js +119 -0
  76. package/dist/src/runtime/local-host/app-request-control.d.ts +24 -0
  77. package/dist/src/runtime/local-host/app-request-control.js +135 -0
  78. package/dist/src/runtime/local-host/app-service-dispatch.d.ts +5 -0
  79. package/dist/src/runtime/local-host/app-service-dispatch.js +64 -0
  80. package/dist/src/runtime/local-host/client-identity.d.ts +3 -0
  81. package/dist/src/runtime/local-host/client-identity.js +17 -0
  82. package/dist/src/runtime/local-host/client-memory.d.ts +7 -0
  83. package/dist/src/runtime/local-host/client-memory.js +54 -0
  84. package/dist/src/runtime/local-host/client-requests.d.ts +19 -0
  85. package/dist/src/runtime/local-host/client-requests.js +145 -0
  86. package/dist/src/runtime/local-host/client-services.d.ts +10 -0
  87. package/dist/src/runtime/local-host/client-services.js +14 -0
  88. package/dist/src/runtime/local-host/contracts.d.ts +36 -0
  89. package/dist/src/runtime/local-host/contracts.js +1 -0
  90. package/dist/src/runtime/local-host/endpoint.d.ts +7 -0
  91. package/dist/src/runtime/local-host/endpoint.js +79 -0
  92. package/dist/src/runtime/local-host/owner-activity.d.ts +10 -0
  93. package/dist/src/runtime/local-host/owner-activity.js +30 -0
  94. package/dist/src/runtime/local-host/owner-retirement.d.ts +3 -0
  95. package/dist/src/runtime/local-host/owner-retirement.js +15 -0
  96. package/dist/src/runtime/local-host/owner-server.d.ts +6 -0
  97. package/dist/src/runtime/local-host/owner-server.js +88 -0
  98. package/dist/src/runtime/local-host/private-access.d.ts +2 -0
  99. package/dist/src/runtime/local-host/private-access.js +16 -0
  100. package/dist/src/runtime/local-host/private-directory.d.ts +1 -0
  101. package/dist/src/runtime/local-host/private-directory.js +57 -0
  102. package/dist/src/runtime/local-host/rpc-peer.d.ts +22 -0
  103. package/dist/src/runtime/local-host/rpc-peer.js +168 -0
  104. package/dist/src/runtime/local-host/rpc-protocol.d.ts +21 -0
  105. package/dist/src/runtime/local-host/rpc-protocol.js +46 -0
  106. package/dist/src/runtime/local-host/startup-connection.d.ts +5 -0
  107. package/dist/src/runtime/local-host/startup-connection.js +72 -0
  108. package/dist/src/runtime/local-host/transport.d.ts +3 -0
  109. package/dist/src/runtime/local-host/transport.js +88 -0
  110. package/dist/src/runtime/local-host/windows-private-access.d.ts +1 -0
  111. package/dist/src/runtime/local-host/windows-private-access.js +51 -0
  112. package/dist/src/runtime/long-term-memory/onboarding/configuration.js +6 -0
  113. package/dist/src/runtime/long-term-memory/recall-binding.d.ts +3 -0
  114. package/dist/src/runtime/long-term-memory/recall-binding.js +27 -0
  115. package/dist/src/runtime/long-term-memory/recall-context.d.ts +20 -0
  116. package/dist/src/runtime/long-term-memory/recall-context.js +101 -0
  117. package/dist/src/runtime/long-term-memory/recall-continuation.d.ts +8 -0
  118. package/dist/src/runtime/long-term-memory/recall-continuation.js +36 -0
  119. package/dist/src/runtime/long-term-memory/recall-policy.d.ts +7 -0
  120. package/dist/src/runtime/long-term-memory/recall-policy.js +14 -0
  121. package/dist/src/runtime/long-term-memory/recall-result.d.ts +5 -0
  122. package/dist/src/runtime/long-term-memory/recall-result.js +54 -0
  123. package/dist/src/runtime/long-term-memory/repository-state.d.ts +2 -1
  124. package/dist/src/runtime/long-term-memory/repository-state.js +2 -2
  125. package/dist/src/runtime/model/invoke-raw-step.d.ts +1 -0
  126. package/dist/src/runtime/model/invoke-raw-step.js +1 -0
  127. package/dist/src/runtime/model/invoke-step.js +6 -0
  128. package/dist/src/runtime/model/invoke-structured-step.d.ts +1 -0
  129. package/dist/src/runtime/model/invoke-structured-step.js +1 -0
  130. package/dist/src/runtime/model/model-step-port.d.ts +2 -0
  131. package/dist/src/runtime/model/model-step-steering.d.ts +8 -0
  132. package/dist/src/runtime/model/model-step-steering.js +19 -0
  133. package/dist/src/runtime/orchestration/final-response/authoring-contract.js +1 -1
  134. package/dist/src/runtime/orchestration/final-response/invoke.d.ts +1 -0
  135. package/dist/src/runtime/orchestration/final-response/invoke.js +1 -0
  136. package/dist/src/runtime/orchestration/role-calls/activation-budget.js +1 -0
  137. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +9 -49
  138. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.d.ts +9 -0
  139. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.js +17 -8
  140. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-validation.d.ts +2 -0
  141. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-validation.js +62 -0
  142. package/dist/src/runtime/orchestration/role-calls/command-decoder.js +4 -0
  143. package/dist/src/runtime/orchestration/role-calls/command-dispatch/memory-recall-transitions.d.ts +4 -0
  144. package/dist/src/runtime/orchestration/role-calls/command-dispatch/memory-recall-transitions.js +89 -0
  145. package/dist/src/runtime/orchestration/role-calls/command-dispatch.js +5 -0
  146. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +9 -7
  147. package/dist/src/runtime/orchestration/role-calls/contracts.js +2 -2
  148. package/dist/src/runtime/orchestration/role-calls/diagnostics.js +3 -0
  149. package/dist/src/runtime/orchestration/role-calls/index.d.ts +1 -0
  150. package/dist/src/runtime/orchestration/role-calls/index.js +1 -0
  151. package/dist/src/runtime/orchestration/role-calls/memory-recall-contract.d.ts +51 -0
  152. package/dist/src/runtime/orchestration/role-calls/memory-recall-contract.js +4 -0
  153. package/dist/src/runtime/orchestration/role-calls/memory-recall-decoder.d.ts +6 -0
  154. package/dist/src/runtime/orchestration/role-calls/memory-recall-decoder.js +147 -0
  155. package/dist/src/runtime/orchestration/role-calls/memory-recall-diagnostics.d.ts +5 -0
  156. package/dist/src/runtime/orchestration/role-calls/memory-recall-diagnostics.js +27 -0
  157. package/dist/src/runtime/orchestration/role-calls/memory-recall-state-validation.d.ts +3 -0
  158. package/dist/src/runtime/orchestration/role-calls/memory-recall-state-validation.js +121 -0
  159. package/dist/src/runtime/orchestration/role-calls/memory-recall-transactions.d.ts +3 -0
  160. package/dist/src/runtime/orchestration/role-calls/memory-recall-transactions.js +44 -0
  161. package/dist/src/runtime/orchestration/role-calls/reducer.js +1 -0
  162. package/dist/src/runtime/orchestration/role-calls/transaction-effect.d.ts +5 -0
  163. package/dist/src/runtime/orchestration/role-calls/transaction-effect.js +14 -0
  164. package/dist/src/runtime/orchestration/role-calls/transactions.js +3 -24
  165. package/dist/src/runtime/plugins/manifest-validator.js +4 -1
  166. package/dist/src/runtime/ports.d.ts +4 -0
  167. package/dist/src/runtime/request/bound-runtime-handler.d.ts +2 -0
  168. package/dist/src/runtime/request/bound-runtime-handler.js +25 -0
  169. package/dist/src/runtime/request/contracts.d.ts +6 -0
  170. package/dist/src/runtime/request/execution-agent-root-execution.js +12 -0
  171. package/dist/src/runtime/request/execution-facets.js +6 -0
  172. package/dist/src/runtime/request/execution-scope-surfaces.js +10 -0
  173. package/dist/src/runtime/request/execution-scope.d.ts +1 -1
  174. package/dist/src/runtime/request/handler.js +6 -0
  175. package/dist/src/runtime/request/root-contract.d.ts +7 -1
  176. package/dist/src/runtime/request/root-execution-kernel.js +33 -37
  177. package/dist/src/runtime/request/root-memory-recall.d.ts +11 -0
  178. package/dist/src/runtime/request/root-memory-recall.js +71 -0
  179. package/dist/src/runtime/request/root-observation-handoff.d.ts +17 -0
  180. package/dist/src/runtime/request/root-observation-handoff.js +44 -0
  181. package/dist/src/runtime/request/scheduled-execution.d.ts +9 -0
  182. package/dist/src/runtime/request/scheduled-execution.js +32 -0
  183. package/dist/src/runtime/request/session-admission.d.ts +17 -0
  184. package/dist/src/runtime/request/session-admission.js +88 -0
  185. package/dist/src/runtime/request/supervisor-root-execution-diagnostics.d.ts +1 -1
  186. package/dist/src/runtime/request/supervisor-root-execution.js +8 -0
  187. package/dist/src/runtime/runtime-environment.d.ts +31 -0
  188. package/dist/src/runtime/runtime-environment.js +102 -0
  189. package/dist/src/runtime/runtime-host-environment.d.ts +8 -0
  190. package/dist/src/runtime/runtime-host-environment.js +57 -0
  191. package/dist/src/runtime/runtime-host-lifecycle.d.ts +4 -0
  192. package/dist/src/runtime/runtime-host-lifecycle.js +64 -0
  193. package/dist/src/runtime/runtime-host-scheduler-ownership.d.ts +5 -0
  194. package/dist/src/runtime/runtime-host-scheduler-ownership.js +67 -0
  195. package/dist/src/runtime/runtime-host.d.ts +19 -0
  196. package/dist/src/runtime/runtime-host.js +63 -0
  197. package/dist/src/runtime/scheduler/calendar-time.d.ts +10 -0
  198. package/dist/src/runtime/scheduler/calendar-time.js +58 -0
  199. package/dist/src/runtime/scheduler/contracts.d.ts +143 -0
  200. package/dist/src/runtime/scheduler/contracts.js +1 -0
  201. package/dist/src/runtime/scheduler/file-store.d.ts +2 -0
  202. package/dist/src/runtime/scheduler/file-store.js +76 -0
  203. package/dist/src/runtime/scheduler/instant-validation.d.ts +4 -0
  204. package/dist/src/runtime/scheduler/instant-validation.js +69 -0
  205. package/dist/src/runtime/scheduler/interval-range.d.ts +8 -0
  206. package/dist/src/runtime/scheduler/interval-range.js +24 -0
  207. package/dist/src/runtime/scheduler/job-management.d.ts +8 -0
  208. package/dist/src/runtime/scheduler/job-management.js +212 -0
  209. package/dist/src/runtime/scheduler/journal-checkpoint.d.ts +9 -0
  210. package/dist/src/runtime/scheduler/journal-checkpoint.js +45 -0
  211. package/dist/src/runtime/scheduler/journal-durability.d.ts +8 -0
  212. package/dist/src/runtime/scheduler/journal-durability.js +59 -0
  213. package/dist/src/runtime/scheduler/journal-files.d.ts +14 -0
  214. package/dist/src/runtime/scheduler/journal-files.js +59 -0
  215. package/dist/src/runtime/scheduler/journal-head.d.ts +21 -0
  216. package/dist/src/runtime/scheduler/journal-head.js +81 -0
  217. package/dist/src/runtime/scheduler/journal-index-state.d.ts +31 -0
  218. package/dist/src/runtime/scheduler/journal-index-state.js +137 -0
  219. package/dist/src/runtime/scheduler/journal-index.d.ts +22 -0
  220. package/dist/src/runtime/scheduler/journal-index.js +195 -0
  221. package/dist/src/runtime/scheduler/journal-store.d.ts +21 -0
  222. package/dist/src/runtime/scheduler/journal-store.js +184 -0
  223. package/dist/src/runtime/scheduler/journal-transaction.d.ts +14 -0
  224. package/dist/src/runtime/scheduler/journal-transaction.js +104 -0
  225. package/dist/src/runtime/scheduler/next-occurrence.d.ts +3 -0
  226. package/dist/src/runtime/scheduler/next-occurrence.js +39 -0
  227. package/dist/src/runtime/scheduler/run-completion.d.ts +12 -0
  228. package/dist/src/runtime/scheduler/run-completion.js +77 -0
  229. package/dist/src/runtime/scheduler/run-list-query.d.ts +5 -0
  230. package/dist/src/runtime/scheduler/run-list-query.js +38 -0
  231. package/dist/src/runtime/scheduler/run-records.d.ts +6 -0
  232. package/dist/src/runtime/scheduler/run-records.js +41 -0
  233. package/dist/src/runtime/scheduler/schedule-update.d.ts +3 -0
  234. package/dist/src/runtime/scheduler/schedule-update.js +22 -0
  235. package/dist/src/runtime/scheduler/schedule-validation.d.ts +10 -0
  236. package/dist/src/runtime/scheduler/schedule-validation.js +132 -0
  237. package/dist/src/runtime/scheduler/scheduler-engine.d.ts +2 -0
  238. package/dist/src/runtime/scheduler/scheduler-engine.js +174 -0
  239. package/dist/src/runtime/scheduler/scheduler-service.d.ts +10 -0
  240. package/dist/src/runtime/scheduler/scheduler-service.js +115 -0
  241. package/dist/src/runtime/scheduler/service-context.d.ts +21 -0
  242. package/dist/src/runtime/scheduler/service-context.js +26 -0
  243. package/dist/src/runtime/scheduler/session-deletion-state.d.ts +9 -0
  244. package/dist/src/runtime/scheduler/session-deletion-state.js +30 -0
  245. package/dist/src/runtime/scheduler/snapshot-validation.d.ts +4 -0
  246. package/dist/src/runtime/scheduler/snapshot-validation.js +112 -0
  247. package/dist/src/runtime/scheduler/startup-recovery.d.ts +2 -0
  248. package/dist/src/runtime/scheduler/startup-recovery.js +38 -0
  249. package/dist/src/runtime/scheduler/validation-error.d.ts +4 -0
  250. package/dist/src/runtime/scheduler/validation-error.js +8 -0
  251. package/dist/src/runtime/scheduler/working-store.d.ts +3 -0
  252. package/dist/src/runtime/scheduler/working-store.js +8 -0
  253. package/dist/src/runtime/session/request-session.d.ts +1 -0
  254. package/dist/src/runtime/session/request-session.js +14 -1
  255. package/dist/src/runtime/session/session-attachment-deletion.d.ts +8 -0
  256. package/dist/src/runtime/session/session-attachment-deletion.js +87 -0
  257. package/dist/src/runtime/session/session-deletion-boundary.d.ts +10 -0
  258. package/dist/src/runtime/session/session-deletion-boundary.js +39 -0
  259. package/dist/src/runtime/session/session-deletion-cleanup.d.ts +7 -0
  260. package/dist/src/runtime/session/session-deletion-cleanup.js +62 -0
  261. package/dist/src/runtime/session/session-deletion-finalization.d.ts +7 -0
  262. package/dist/src/runtime/session/session-deletion-finalization.js +34 -0
  263. package/dist/src/runtime/session/session-deletion-receipts.d.ts +7 -0
  264. package/dist/src/runtime/session/session-deletion-receipts.js +18 -0
  265. package/dist/src/runtime/session/session-lifecycle-store.d.ts +21 -0
  266. package/dist/src/runtime/session/session-lifecycle-store.js +72 -0
  267. package/dist/src/runtime/session/session-mutation-queue.d.ts +3 -0
  268. package/dist/src/runtime/session/session-mutation-queue.js +15 -0
  269. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.d.ts +16 -0
  270. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.js +165 -0
  271. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +3 -1
  272. package/dist/src/runtime/steps/execution-agent/decision-parsing.d.ts +2 -0
  273. package/dist/src/runtime/steps/execution-agent/decision-parsing.js +195 -0
  274. package/dist/src/runtime/steps/execution-agent/decision-validation.d.ts +30 -0
  275. package/dist/src/runtime/steps/execution-agent/decision-validation.js +127 -0
  276. package/dist/src/runtime/steps/execution-agent/format.d.ts +1 -0
  277. package/dist/src/runtime/steps/execution-agent/format.js +12 -0
  278. package/dist/src/runtime/steps/execution-agent/input.d.ts +2 -1
  279. package/dist/src/runtime/steps/execution-agent/input.js +17 -2
  280. package/dist/src/runtime/steps/execution-agent/parser.d.ts +1 -2
  281. package/dist/src/runtime/steps/execution-agent/parser.js +1 -472
  282. package/dist/src/runtime/steps/execution-agent/prompt.d.ts +2 -0
  283. package/dist/src/runtime/steps/execution-agent/prompt.js +2 -0
  284. package/dist/src/runtime/steps/execution-agent/reconsideration-context.js +4 -3
  285. package/dist/src/runtime/steps/execution-agent/response-input.js +5 -4
  286. package/dist/src/runtime/steps/execution-agent/response-run.d.ts +3 -0
  287. package/dist/src/runtime/steps/execution-agent/response-run.js +7 -3
  288. package/dist/src/runtime/steps/execution-agent/run.d.ts +2 -0
  289. package/dist/src/runtime/steps/execution-agent/run.js +2 -0
  290. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +2 -1
  291. package/dist/src/runtime/steps/execution-agent/state-context.js +13 -5
  292. package/dist/src/runtime/steps/memory-recall-decision.d.ts +30 -0
  293. package/dist/src/runtime/steps/memory-recall-decision.js +101 -0
  294. package/dist/src/runtime/steps/memory-recall-prompt.d.ts +1 -0
  295. package/dist/src/runtime/steps/memory-recall-prompt.js +15 -0
  296. package/dist/src/runtime/steps/supervisor-decision/contracts.d.ts +4 -2
  297. package/dist/src/runtime/steps/supervisor-decision/diagnostics.d.ts +2 -0
  298. package/dist/src/runtime/steps/supervisor-decision/diagnostics.js +13 -6
  299. package/dist/src/runtime/steps/supervisor-decision/format.d.ts +2 -0
  300. package/dist/src/runtime/steps/supervisor-decision/format.js +41 -2
  301. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +5 -1
  302. package/dist/src/runtime/steps/supervisor-decision/input.js +25 -5
  303. package/dist/src/runtime/steps/supervisor-decision/memory-recall-continuation.d.ts +10 -0
  304. package/dist/src/runtime/steps/supervisor-decision/memory-recall-continuation.js +32 -0
  305. package/dist/src/runtime/steps/supervisor-decision/parser.d.ts +2 -0
  306. package/dist/src/runtime/steps/supervisor-decision/parser.js +36 -1
  307. package/dist/src/runtime/steps/supervisor-decision/prompt.d.ts +3 -0
  308. package/dist/src/runtime/steps/supervisor-decision/prompt.js +16 -8
  309. package/dist/src/runtime/steps/supervisor-decision/response-recommendation.d.ts +13 -0
  310. package/dist/src/runtime/steps/supervisor-decision/response-recommendation.js +32 -0
  311. package/dist/src/runtime/steps/supervisor-decision/resume.d.ts +2 -0
  312. package/dist/src/runtime/steps/supervisor-decision/resume.js +13 -0
  313. package/dist/src/runtime/steps/supervisor-decision/run.d.ts +3 -0
  314. package/dist/src/runtime/steps/supervisor-decision/run.js +19 -0
  315. package/dist/src/runtime/steps/supervisor-decision/working-directory.js +7 -1
  316. package/dist/src/runtime/steps/supervisor-response/diagnostics.d.ts +1 -0
  317. package/dist/src/runtime/steps/supervisor-response/diagnostics.js +1 -0
  318. package/dist/src/runtime/steps/supervisor-response/input.d.ts +2 -1
  319. package/dist/src/runtime/steps/supervisor-response/input.js +17 -4
  320. package/dist/src/runtime/steps/supervisor-response/memory-authoring.d.ts +1 -0
  321. package/dist/src/runtime/steps/supervisor-response/memory-authoring.js +4 -0
  322. package/dist/src/runtime/steps/supervisor-response/prompt.d.ts +1 -0
  323. package/dist/src/runtime/steps/supervisor-response/prompt.js +8 -2
  324. package/dist/src/runtime/steps/supervisor-response/response-recommendation.d.ts +10 -0
  325. package/dist/src/runtime/steps/supervisor-response/response-recommendation.js +25 -0
  326. package/dist/src/runtime/steps/supervisor-response/run.d.ts +6 -1
  327. package/dist/src/runtime/steps/supervisor-response/run.js +26 -7
  328. package/dist/src/sessions/record/projection.js +1 -0
  329. package/dist/src/sessions/schedule-metadata.d.ts +8 -0
  330. package/dist/src/sessions/schedule-metadata.js +1 -0
  331. package/dist/src/sessions/session-service.d.ts +1 -0
  332. package/dist/src/sessions/session-service.js +1 -0
  333. package/dist/src/sessions/types.d.ts +2 -0
  334. package/dist/src/shared/http-server-shutdown.d.ts +4 -0
  335. package/dist/src/shared/http-server-shutdown.js +17 -0
  336. package/dist/src/shared/public-http/aggregate-gate.d.ts +3 -0
  337. package/dist/src/shared/public-http/aggregate-gate.js +87 -0
  338. package/dist/src/shared/public-http/deadline.d.ts +2 -0
  339. package/dist/src/shared/public-http/deadline.js +29 -0
  340. package/dist/src/shared/public-http/errors.d.ts +6 -0
  341. package/dist/src/shared/public-http/errors.js +11 -0
  342. package/dist/src/shared/public-http/limits.d.ts +8 -0
  343. package/dist/src/shared/public-http/limits.js +8 -0
  344. package/dist/src/shared/public-http/network-policy.d.ts +11 -0
  345. package/dist/src/shared/public-http/network-policy.js +178 -0
  346. package/dist/src/shared/public-http/public-http.d.ts +24 -0
  347. package/dist/src/shared/public-http/public-http.js +85 -0
  348. package/dist/src/shared/public-http/request-hop.d.ts +18 -0
  349. package/dist/src/shared/public-http/request-hop.js +140 -0
  350. package/dist/src/web-ui/app/ARCHITECTURE.md +66 -4
  351. package/dist/src/web-ui/app/app-bootstrap.js +53 -0
  352. package/dist/src/web-ui/app/app-dom.js +80 -0
  353. package/dist/src/web-ui/app/app.js +195 -212
  354. package/dist/src/web-ui/app/components/conversation-activity.d.ts +2 -0
  355. package/dist/src/web-ui/app/components/conversation-activity.js +34 -7
  356. package/dist/src/web-ui/app/components/conversation-role-cards.d.ts +1 -0
  357. package/dist/src/web-ui/app/components/conversation-role-cards.js +61 -5
  358. package/dist/src/web-ui/app/components/conversation-schedule.js +71 -0
  359. package/dist/src/web-ui/app/components/conversation-status.js +65 -0
  360. package/dist/src/web-ui/app/components/conversation-tools.d.ts +13 -0
  361. package/dist/src/web-ui/app/components/conversation-tools.js +284 -0
  362. package/dist/src/web-ui/app/components/conversation-view.js +39 -11
  363. package/dist/src/web-ui/app/components/dashboard/activity.js +61 -0
  364. package/dist/src/web-ui/app/components/dashboard/icons.js +23 -0
  365. package/dist/src/web-ui/app/components/dashboard/recent-conversations.js +64 -0
  366. package/dist/src/web-ui/app/components/dashboard/workspace.js +107 -0
  367. package/dist/src/web-ui/app/components/message-link-previews.d.ts +16 -0
  368. package/dist/src/web-ui/app/components/message-link-previews.js +179 -0
  369. package/dist/src/web-ui/app/components/schedules/details.js +101 -0
  370. package/dist/src/web-ui/app/components/schedules/form.d.ts +13 -0
  371. package/dist/src/web-ui/app/components/schedules/form.js +246 -0
  372. package/dist/src/web-ui/app/components/schedules/workspace-state.js +59 -0
  373. package/dist/src/web-ui/app/components/schedules/workspace.js +165 -0
  374. package/dist/src/web-ui/app/components/workspace-shell.js +48 -2
  375. package/dist/src/web-ui/app/configuration-feature.js +72 -0
  376. package/dist/src/web-ui/app/controllers/composer-attachments-controller.d.ts +1 -0
  377. package/dist/src/web-ui/app/controllers/composer-attachments-controller.js +17 -6
  378. package/dist/src/web-ui/app/controllers/composer-submit-controller.d.ts +2 -0
  379. package/dist/src/web-ui/app/controllers/composer-submit-controller.js +15 -1
  380. package/dist/src/web-ui/app/controllers/composer-surface-controller.js +58 -0
  381. package/dist/src/web-ui/app/controllers/composer-workspace-controller.d.ts +53 -0
  382. package/dist/src/web-ui/app/controllers/composer-workspace-controller.js +180 -0
  383. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.d.ts +23 -0
  384. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.js +82 -0
  385. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +8 -0
  386. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +28 -39
  387. package/dist/src/web-ui/app/controllers/dashboard-controller.js +127 -0
  388. package/dist/src/web-ui/app/controllers/home-composer-feature.d.ts +40 -0
  389. package/dist/src/web-ui/app/controllers/home-composer-feature.js +119 -0
  390. package/dist/src/web-ui/app/controllers/home-conversation-activation.js +37 -0
  391. package/dist/src/web-ui/app/controllers/realtime-event-controller.d.ts +1 -0
  392. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +74 -3
  393. package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts +2 -1
  394. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +15 -14
  395. package/dist/src/web-ui/app/controllers/schedule-realtime.js +118 -0
  396. package/dist/src/web-ui/app/controllers/schedules-controller.js +421 -0
  397. package/dist/src/web-ui/app/controllers/session-controller.js +30 -3
  398. package/dist/src/web-ui/app/dashboard-feature.js +44 -0
  399. package/dist/src/web-ui/app/index.html +53 -1
  400. package/dist/src/web-ui/app/lib/composer-submission-scope.d.ts +21 -0
  401. package/dist/src/web-ui/app/lib/composer-submission-scope.js +13 -0
  402. package/dist/src/web-ui/app/lib/context-window-snapshot-order.d.ts +15 -0
  403. package/dist/src/web-ui/app/lib/context-window-snapshot-order.js +31 -0
  404. package/dist/src/web-ui/app/lib/conversation-role-model.d.ts +10 -1
  405. package/dist/src/web-ui/app/lib/conversation-role-model.js +97 -15
  406. package/dist/src/web-ui/app/lib/conversation-status-model.d.ts +12 -0
  407. package/dist/src/web-ui/app/lib/conversation-status-model.js +116 -0
  408. package/dist/src/web-ui/app/lib/dashboard-job-templates.js +41 -0
  409. package/dist/src/web-ui/app/lib/dashboard-presentation.js +126 -0
  410. package/dist/src/web-ui/app/lib/message-markdown.d.ts +5 -0
  411. package/dist/src/web-ui/app/lib/message-markdown.js +99 -0
  412. package/dist/src/web-ui/app/lib/message-url-policy.d.ts +1 -0
  413. package/dist/src/web-ui/app/lib/message-url-policy.js +13 -0
  414. package/dist/src/web-ui/app/lib/schedule-errors.js +29 -0
  415. package/dist/src/web-ui/app/lib/schedule-message.js +30 -0
  416. package/dist/src/web-ui/app/lib/schedule-presentation.js +81 -0
  417. package/dist/src/web-ui/app/lib/session-read-state.d.ts +22 -0
  418. package/dist/src/web-ui/app/lib/session-read-state.js +63 -0
  419. package/dist/src/web-ui/app/lib/text-format.js +2 -143
  420. package/dist/src/web-ui/app/lib/tool-activity-event.d.ts +26 -0
  421. package/dist/src/web-ui/app/lib/tool-activity-event.js +228 -0
  422. package/dist/src/web-ui/app/lib/tool-activity-model.d.ts +41 -0
  423. package/dist/src/web-ui/app/lib/tool-activity-model.js +255 -0
  424. package/dist/src/web-ui/app/lib/tool-timeline.d.ts +3 -0
  425. package/dist/src/web-ui/app/lib/tool-timeline.js +18 -0
  426. package/dist/src/web-ui/app/schedules-feature.js +87 -0
  427. package/dist/src/web-ui/app/services/message-link-preview-client.d.ts +14 -0
  428. package/dist/src/web-ui/app/services/message-link-preview-client.js +96 -0
  429. package/dist/src/web-ui/app/services/runtime-web-client/schedules.js +51 -0
  430. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +37 -0
  431. package/dist/src/web-ui/app/services/runtime-web-client.js +13 -8
  432. package/dist/src/web-ui/app/styles/00-tokens-base.css +11 -11
  433. package/dist/src/web-ui/app/styles/18-dashboard.css +384 -0
  434. package/dist/src/web-ui/app/styles/20-chat-composer.css +1 -130
  435. package/dist/src/web-ui/app/styles/26-message-content.css +295 -0
  436. package/dist/src/web-ui/app/styles/27-conversation-tools.css +266 -0
  437. package/dist/src/web-ui/app/styles/28-conversation-status.css +52 -0
  438. package/dist/src/web-ui/app/styles/38-schedule-workspace.css +263 -0
  439. package/dist/src/web-ui/app/styles/38-schedules.css +352 -0
  440. package/dist/src/web-ui/app/styles/90-responsive.css +14 -0
  441. package/dist/src/web-ui/app/styles/91-schedules-responsive.css +72 -0
  442. package/dist/src/web-ui/app/styles/92-dashboard-responsive.css +88 -0
  443. package/dist/src/web-ui/app/styles.css +8 -0
  444. package/dist/src/web-ui/app/ui-behavior.d.ts +1 -1
  445. package/dist/src/web-ui/app/ui-behavior.js +3 -1
  446. package/dist/src/web-ui/app/vendor/README.md +15 -0
  447. package/dist/src/web-ui/app/vendor/markdown-it.LICENSE +22 -0
  448. package/dist/src/web-ui/app/vendor/markdown-it.js +3003 -0
  449. package/dist/src/web-ui/link-preview/metadata.d.ts +9 -0
  450. package/dist/src/web-ui/link-preview/metadata.js +97 -0
  451. package/dist/src/web-ui/link-preview/preview-cache.d.ts +4 -0
  452. package/dist/src/web-ui/link-preview/preview-cache.js +23 -0
  453. package/dist/src/web-ui/link-preview/raster-response.d.ts +9 -0
  454. package/dist/src/web-ui/link-preview/raster-response.js +49 -0
  455. package/dist/src/web-ui/link-preview/routes.d.ts +3 -0
  456. package/dist/src/web-ui/link-preview/routes.js +97 -0
  457. package/dist/src/web-ui/link-preview/service.d.ts +11 -0
  458. package/dist/src/web-ui/link-preview/service.js +117 -0
  459. package/dist/src/web-ui/local-runtime/api-router.d.ts +4 -1
  460. package/dist/src/web-ui/local-runtime/api-router.js +42 -73
  461. package/dist/src/web-ui/local-runtime/contracts.d.ts +2 -2
  462. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +12 -1
  463. package/dist/src/web-ui/local-runtime/environment-registry.js +38 -3
  464. package/dist/src/web-ui/local-runtime/realtime-controller.js +3 -1
  465. package/dist/src/web-ui/local-runtime/request-execution.d.ts +5 -1
  466. package/dist/src/web-ui/local-runtime/request-execution.js +38 -2
  467. package/dist/src/web-ui/local-runtime/schedule-job-creation.d.ts +7 -0
  468. package/dist/src/web-ui/local-runtime/schedule-job-creation.js +62 -0
  469. package/dist/src/web-ui/local-runtime/schedule-management-routes.d.ts +30 -0
  470. package/dist/src/web-ui/local-runtime/schedule-management-routes.js +134 -0
  471. package/dist/src/web-ui/local-runtime/schedule-run-page.d.ts +5 -0
  472. package/dist/src/web-ui/local-runtime/schedule-run-page.js +23 -0
  473. package/dist/src/web-ui/local-runtime/session-routes.d.ts +17 -0
  474. package/dist/src/web-ui/local-runtime/session-routes.js +74 -0
  475. package/dist/src/web-ui/local-runtime-backend.d.ts +2 -0
  476. package/dist/src/web-ui/local-runtime-backend.js +11 -1
  477. package/dist/src/web-ui/schedule-creation-contract.d.ts +7 -0
  478. package/dist/src/web-ui/schedule-creation-contract.js +1 -0
  479. package/dist/src/web-ui/server-shutdown.d.ts +4 -0
  480. package/dist/src/web-ui/server-shutdown.js +32 -0
  481. package/dist/src/web-ui/server.js +13 -10
  482. package/dist/src/web-ui/session-read-state/availability.d.ts +16 -0
  483. package/dist/src/web-ui/session-read-state/availability.js +20 -0
  484. package/dist/src/web-ui/session-read-state/projection.d.ts +17 -0
  485. package/dist/src/web-ui/session-read-state/projection.js +71 -0
  486. package/dist/src/web-ui/session-read-state/service.d.ts +86 -0
  487. package/dist/src/web-ui/session-read-state/service.js +89 -0
  488. package/dist/src/web-ui/session-read-state/store.d.ts +22 -0
  489. package/dist/src/web-ui/session-read-state/store.js +110 -0
  490. package/docs/configuration.md +41 -1
  491. package/docs/long-term-memory.md +46 -5
  492. package/docs/runtime-invariant-coverage.md +1 -1
  493. package/docs/runtime-library.md +23 -0
  494. package/docs/runtime-public-contracts.md +32 -1
  495. package/package.json +3 -1
  496. package/plugins/code-outline/plugin.json +15 -0
  497. package/plugins/document-reader/plugin.json +17 -0
  498. package/plugins/filesystem/plugin.json +17 -2
  499. package/plugins/json-inspector/plugin.json +12 -0
  500. package/plugins/local-search/plugin.json +12 -0
  501. package/plugins/memory/plugin.json +26 -1
  502. package/plugins/memory/source/index.ts +10 -6
  503. package/plugins/memory/src/index.cjs +11 -7
  504. package/plugins/project-orientation/plugin.json +14 -0
  505. package/plugins/web/source/aggregate-gate.ts +8 -130
  506. package/plugins/web/source/deadline.ts +14 -50
  507. package/plugins/web/source/errors.ts +17 -11
  508. package/plugins/web/source/limits.ts +3 -6
  509. package/plugins/web/source/network-policy.ts +28 -226
  510. package/plugins/web/source/public-http.ts +17 -142
  511. package/plugins/web/source/request-hop.ts +11 -191
  512. package/plugins/web/src/index.cjs +119 -59
  513. package/runtime.config.schema.json +7 -0
  514. package/src/runtime/README.md +105 -1
  515. package/src/runtime/local-host/README.md +86 -0
  516. package/src/runtime/scheduler/README.md +166 -0
@@ -0,0 +1,9 @@
1
+ import type { PublicHttpResponse } from "../../shared/public-http/public-http.js";
2
+ export type LinkPreview = Readonly<{
3
+ url: string;
4
+ title: string;
5
+ description: string;
6
+ imageUrl: string;
7
+ siteName: string;
8
+ }>;
9
+ export declare function readLinkPreviewMetadata(response: PublicHttpResponse): LinkPreview;
@@ -0,0 +1,97 @@
1
+ import { Parser } from "htmlparser2";
2
+ import { parsePublicHttpUrl } from "../../shared/public-http/network-policy.js";
3
+ const METADATA_KEYS = new Set([
4
+ "og:title",
5
+ "og:description",
6
+ "og:image",
7
+ "og:site_name",
8
+ "twitter:title",
9
+ "twitter:description",
10
+ "twitter:image",
11
+ "description",
12
+ ]);
13
+ function boundedText(value, maxChars) {
14
+ return value.replace(/\s+/gu, " ").trim().slice(0, maxChars);
15
+ }
16
+ function firstMetadata(values, keys) {
17
+ for (const key of keys) {
18
+ const value = values.get(key);
19
+ if (value?.trim())
20
+ return value;
21
+ }
22
+ return "";
23
+ }
24
+ function resolvePreviewImage(raw, pageUrl) {
25
+ if (!raw.trim())
26
+ return "";
27
+ if (raw.length > 4_096)
28
+ return "";
29
+ try {
30
+ return parsePublicHttpUrl(new URL(raw, pageUrl).toString()).toString();
31
+ }
32
+ catch {
33
+ return "";
34
+ }
35
+ }
36
+ function decodePage(response) {
37
+ const contentType = response.headers["content-type"] ?? "";
38
+ const charset = /charset\s*=\s*["']?([^\s;"']+)/iu.exec(contentType)?.[1] ?? "utf-8";
39
+ try {
40
+ return new TextDecoder(charset).decode(response.body);
41
+ }
42
+ catch {
43
+ return new TextDecoder().decode(response.body);
44
+ }
45
+ }
46
+ export function readLinkPreviewMetadata(response) {
47
+ const values = new Map();
48
+ let title = "";
49
+ let insideTitle = false;
50
+ let headFinished = false;
51
+ const parser = new Parser({
52
+ onopentag(name, attributes) {
53
+ if (name === "body")
54
+ headFinished = true;
55
+ if (headFinished)
56
+ return;
57
+ if (name === "title")
58
+ insideTitle = true;
59
+ if (name !== "meta")
60
+ return;
61
+ const key = (attributes.property ||
62
+ attributes.name ||
63
+ "").toLowerCase();
64
+ if (!METADATA_KEYS.has(key))
65
+ return;
66
+ if (values.has(key))
67
+ return;
68
+ values.set(key, (attributes.content ?? "").slice(0, 4_096));
69
+ },
70
+ ontext(text) {
71
+ if (!insideTitle)
72
+ return;
73
+ if (headFinished)
74
+ return;
75
+ title = (title + text).slice(0, 1_024);
76
+ },
77
+ onclosetag(name) {
78
+ if (name === "title")
79
+ insideTitle = false;
80
+ if (name === "head")
81
+ headFinished = true;
82
+ },
83
+ }, { decodeEntities: true });
84
+ parser.end(decodePage(response));
85
+ const hostname = new URL(response.finalUrl).hostname;
86
+ return Object.freeze({
87
+ url: response.finalUrl,
88
+ title: boundedText(firstMetadata(values, ["og:title", "twitter:title"]) || title, 200) || hostname,
89
+ description: boundedText(firstMetadata(values, [
90
+ "og:description",
91
+ "twitter:description",
92
+ "description",
93
+ ]), 320),
94
+ imageUrl: resolvePreviewImage(firstMetadata(values, ["og:image", "twitter:image"]), response.finalUrl),
95
+ siteName: boundedText(firstMetadata(values, ["og:site_name"]), 80) || hostname,
96
+ });
97
+ }
@@ -0,0 +1,4 @@
1
+ export declare function createPreviewCache<Value>(maxEntries: number, now?: () => number): Readonly<{
2
+ get(key: string): Value | undefined;
3
+ set(key: string, value: Value, ttlMs: number): void;
4
+ }>;
@@ -0,0 +1,23 @@
1
+ export function createPreviewCache(maxEntries, now = Date.now) {
2
+ const entries = new Map();
3
+ const discardExpired = () => {
4
+ for (const [key, entry] of entries) {
5
+ if (entry.expiresAt <= now())
6
+ entries.delete(key);
7
+ }
8
+ };
9
+ return Object.freeze({
10
+ get(key) {
11
+ discardExpired();
12
+ return entries.get(key)?.value;
13
+ },
14
+ set(key, value, ttlMs) {
15
+ discardExpired();
16
+ entries.delete(key);
17
+ entries.set(key, { value, expiresAt: now() + ttlMs });
18
+ while (entries.size > maxEntries) {
19
+ entries.delete(entries.keys().next().value);
20
+ }
21
+ },
22
+ });
23
+ }
@@ -0,0 +1,9 @@
1
+ import type { PublicHttpResponse } from "../../shared/public-http/public-http.js";
2
+ export type PreviewImage = Readonly<{
3
+ contentType: string;
4
+ body: Uint8Array;
5
+ }>;
6
+ export declare function previewMediaType(response: PublicHttpResponse): string;
7
+ export declare function isSuccessfulPreviewResponse(response: PublicHttpResponse): boolean;
8
+ export declare function isHtmlPreviewResponse(response: PublicHttpResponse): boolean;
9
+ export declare function readPreviewRaster(response: PublicHttpResponse): PreviewImage | null;
@@ -0,0 +1,49 @@
1
+ export function previewMediaType(response) {
2
+ return (response.headers["content-type"] ?? "")
3
+ .split(";", 1)[0]
4
+ .trim()
5
+ .toLowerCase();
6
+ }
7
+ export function isSuccessfulPreviewResponse(response) {
8
+ if (response.status < 200)
9
+ return false;
10
+ if (response.status >= 300)
11
+ return false;
12
+ const encoding = response.headers["content-encoding"];
13
+ if (!encoding)
14
+ return true;
15
+ return encoding.toLowerCase() === "identity";
16
+ }
17
+ export function isHtmlPreviewResponse(response) {
18
+ const type = previewMediaType(response);
19
+ return type === "text/html" || type === "application/xhtml+xml";
20
+ }
21
+ function hasRasterSignature(type, bytes) {
22
+ if (type === "image/png") {
23
+ return bytes
24
+ .subarray(0, 8)
25
+ .equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]));
26
+ }
27
+ if (type === "image/jpeg") {
28
+ return bytes.subarray(0, 3).equals(Buffer.from([255, 216, 255]));
29
+ }
30
+ if (type === "image/gif") {
31
+ return ["GIF87a", "GIF89a"].includes(bytes.subarray(0, 6).toString("ascii"));
32
+ }
33
+ if (type !== "image/webp")
34
+ return false;
35
+ if (bytes.subarray(0, 4).toString("ascii") !== "RIFF")
36
+ return false;
37
+ return bytes.subarray(8, 12).toString("ascii") === "WEBP";
38
+ }
39
+ export function readPreviewRaster(response) {
40
+ if (!isSuccessfulPreviewResponse(response))
41
+ return null;
42
+ if (response.partialContent)
43
+ return null;
44
+ const contentType = previewMediaType(response);
45
+ const body = Buffer.from(response.body);
46
+ if (!hasRasterSignature(contentType, body))
47
+ return null;
48
+ return Object.freeze({ contentType, body });
49
+ }
@@ -0,0 +1,3 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import { type LinkPreviewService } from "./service.js";
3
+ export declare function createLinkPreviewRouteHandler(service?: LinkPreviewService): (request: IncomingMessage, response: ServerResponse) => Promise<boolean>;
@@ -0,0 +1,97 @@
1
+ import { createLinkPreviewService, } from "./service.js";
2
+ function isMatchingPreviewOrigin(rawOrigin, request) {
3
+ const host = request.headers.host;
4
+ if (!host)
5
+ return false;
6
+ try {
7
+ const origin = new URL(rawOrigin);
8
+ const protocol = "encrypted" in request.socket ? "https:" : "http:";
9
+ if (origin.protocol !== protocol)
10
+ return false;
11
+ return origin.host === host;
12
+ }
13
+ catch {
14
+ return false;
15
+ }
16
+ }
17
+ function isSameOriginPreviewRequest(request) {
18
+ const fetchSite = request.headers["sec-fetch-site"];
19
+ if (fetchSite === "same-origin")
20
+ return true;
21
+ if (fetchSite)
22
+ return false;
23
+ const origin = request.headers.origin;
24
+ if (origin)
25
+ return isMatchingPreviewOrigin(origin, request);
26
+ const referer = request.headers.referer;
27
+ if (referer)
28
+ return isMatchingPreviewOrigin(referer, request);
29
+ return false;
30
+ }
31
+ function sendUnavailable(response, status = 200) {
32
+ response.writeHead(status, {
33
+ "content-type": "application/json; charset=utf-8",
34
+ "cache-control": "no-store",
35
+ "x-content-type-options": "nosniff",
36
+ });
37
+ response.end(JSON.stringify({ ok: false, error: "preview_unavailable" }));
38
+ }
39
+ function isExplicitMetadataRequest(request) {
40
+ return request.headers["x-abot-link-preview"] === "1";
41
+ }
42
+ async function servePreviewMetadata(request, response, url, service) {
43
+ if (!isExplicitMetadataRequest(request)) {
44
+ sendUnavailable(response, 403);
45
+ return;
46
+ }
47
+ const preview = await service.getPreview(url.searchParams.get("url") ?? "");
48
+ if (!preview) {
49
+ sendUnavailable(response);
50
+ return;
51
+ }
52
+ response.writeHead(200, {
53
+ "content-type": "application/json; charset=utf-8",
54
+ "cache-control": "no-store",
55
+ "x-content-type-options": "nosniff",
56
+ });
57
+ response.end(JSON.stringify({ ok: true, preview }));
58
+ }
59
+ async function servePreviewImage(response, url, service) {
60
+ const image = await service.getImage(url.searchParams.get("id") ?? "");
61
+ if (!image) {
62
+ sendUnavailable(response, 404);
63
+ return;
64
+ }
65
+ response.writeHead(200, {
66
+ "content-type": image.contentType,
67
+ "content-length": image.body.byteLength,
68
+ "cache-control": "private, max-age=300",
69
+ "x-content-type-options": "nosniff",
70
+ "content-security-policy": "default-src 'none'; sandbox",
71
+ "cross-origin-resource-policy": "same-origin",
72
+ });
73
+ response.end(image.body);
74
+ }
75
+ export function createLinkPreviewRouteHandler(service = createLinkPreviewService()) {
76
+ return async (request, response) => {
77
+ const url = new URL(request.url || "/", "http://localhost");
78
+ const isMetadataRoute = url.pathname === "/web-link-preview";
79
+ const isImageRoute = url.pathname === "/web-link-preview/image";
80
+ if (!isMetadataRoute && !isImageRoute)
81
+ return false;
82
+ if (request.method !== "GET") {
83
+ sendUnavailable(response, 405);
84
+ return true;
85
+ }
86
+ if (!isSameOriginPreviewRequest(request)) {
87
+ sendUnavailable(response, 403);
88
+ return true;
89
+ }
90
+ if (isMetadataRoute) {
91
+ await servePreviewMetadata(request, response, url, service);
92
+ return true;
93
+ }
94
+ await servePreviewImage(response, url, service);
95
+ return true;
96
+ };
97
+ }
@@ -0,0 +1,11 @@
1
+ import { type PublicHttpClient } from "../../shared/public-http/public-http.js";
2
+ import { type LinkPreview } from "./metadata.js";
3
+ import { type PreviewImage } from "./raster-response.js";
4
+ export type LinkPreviewService = Readonly<{
5
+ getPreview(rawUrl: string): Promise<LinkPreview | null>;
6
+ getImage(id: string): Promise<PreviewImage | null>;
7
+ }>;
8
+ export declare function createLinkPreviewService(dependencies?: {
9
+ httpClient?: PublicHttpClient;
10
+ now?: () => number;
11
+ }): LinkPreviewService;
@@ -0,0 +1,117 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { parsePublicHttpUrl } from "../../shared/public-http/network-policy.js";
3
+ import { createPublicHttpClient, } from "../../shared/public-http/public-http.js";
4
+ import { readLinkPreviewMetadata } from "./metadata.js";
5
+ import { createPreviewCache } from "./preview-cache.js";
6
+ import { isHtmlPreviewResponse, isSuccessfulPreviewResponse, readPreviewRaster, } from "./raster-response.js";
7
+ const PREVIEW_TTL_MS = 5 * 60_000;
8
+ const UNAVAILABLE_TTL_MS = 60_000;
9
+ const MAX_PREVIEW_REQUESTS = 8;
10
+ function normalizePreviewUrl(rawUrl) {
11
+ if (/[\s\p{Cc}]/u.test(rawUrl))
12
+ throw new Error("Preview URL contains whitespace or controls");
13
+ if (rawUrl.length > 4_096)
14
+ throw new Error("Preview URL too long");
15
+ const url = parsePublicHttpUrl(rawUrl);
16
+ url.hash = "";
17
+ return url.toString();
18
+ }
19
+ export function createLinkPreviewService(dependencies = {}) {
20
+ const client = dependencies.httpClient ?? createPublicHttpClient();
21
+ const now = dependencies.now ?? Date.now;
22
+ const previews = createPreviewCache(64, now);
23
+ const imageSources = createPreviewCache(64, now);
24
+ const images = createPreviewCache(32, now);
25
+ let activeRequests = 0;
26
+ const fetchPreviewResource = async (url, maxBytes) => {
27
+ if (activeRequests >= MAX_PREVIEW_REQUESTS)
28
+ return null;
29
+ activeRequests += 1;
30
+ try {
31
+ return await client.get({
32
+ url,
33
+ maxBytes,
34
+ maxRedirects: 3,
35
+ timeoutMs: 8_000,
36
+ headers: {
37
+ Accept: "text/html,application/xhtml+xml,image/png,image/jpeg,image/gif,image/webp",
38
+ "Accept-Encoding": "identity",
39
+ "User-Agent": "abot-runtime-link-preview/1.0",
40
+ },
41
+ });
42
+ }
43
+ finally {
44
+ activeRequests -= 1;
45
+ }
46
+ };
47
+ const registerImage = (url, image) => {
48
+ const id = randomUUID();
49
+ imageSources.set(id, url, PREVIEW_TTL_MS);
50
+ if (image)
51
+ images.set(id, Promise.resolve(image), PREVIEW_TTL_MS);
52
+ return `/web-link-preview/image?id=${id}`;
53
+ };
54
+ const loadPreview = async (url) => {
55
+ const response = await fetchPreviewResource(url, 512 * 1024);
56
+ if (!response)
57
+ return null;
58
+ if (!isSuccessfulPreviewResponse(response))
59
+ return null;
60
+ const directImage = readPreviewRaster(response);
61
+ if (directImage) {
62
+ const hostname = new URL(response.finalUrl).hostname;
63
+ return Object.freeze({
64
+ url: response.finalUrl,
65
+ title: hostname,
66
+ description: "",
67
+ siteName: hostname,
68
+ imageUrl: registerImage(response.finalUrl, directImage),
69
+ });
70
+ }
71
+ if (!isHtmlPreviewResponse(response))
72
+ return null;
73
+ const preview = readLinkPreviewMetadata(response);
74
+ return Object.freeze({
75
+ ...preview,
76
+ imageUrl: preview.imageUrl ? registerImage(preview.imageUrl) : "",
77
+ });
78
+ };
79
+ const loadImage = async (url) => {
80
+ const response = await fetchPreviewResource(url, 1024 * 1024);
81
+ if (!response)
82
+ return null;
83
+ return readPreviewRaster(response);
84
+ };
85
+ return Object.freeze({
86
+ async getPreview(rawUrl) {
87
+ let url;
88
+ try {
89
+ url = normalizePreviewUrl(rawUrl);
90
+ }
91
+ catch {
92
+ return null;
93
+ }
94
+ const cached = previews.get(url);
95
+ if (cached)
96
+ return await cached;
97
+ const pending = loadPreview(url).catch(() => null);
98
+ previews.set(url, pending, PREVIEW_TTL_MS);
99
+ const preview = await pending;
100
+ previews.set(url, pending, preview ? PREVIEW_TTL_MS : UNAVAILABLE_TTL_MS);
101
+ return preview;
102
+ },
103
+ async getImage(id) {
104
+ const url = imageSources.get(id);
105
+ if (!url)
106
+ return null;
107
+ const cached = images.get(id);
108
+ if (cached)
109
+ return await cached;
110
+ const pending = loadImage(url).catch(() => null);
111
+ images.set(id, pending, PREVIEW_TTL_MS);
112
+ const image = await pending;
113
+ images.set(id, pending, image ? PREVIEW_TTL_MS : UNAVAILABLE_TTL_MS);
114
+ return image;
115
+ },
116
+ });
117
+ }
@@ -9,7 +9,10 @@ export declare class LocalRuntimeApiRouter {
9
9
  private readonly attachments;
10
10
  private readonly memoryManagement;
11
11
  private readonly memoryOnboarding;
12
+ private readonly schedules;
13
+ private readonly readStates;
14
+ private readonly sessions;
12
15
  constructor(options: ResolvedLocalRuntimeBackendOptions, environments: RuntimeEnvironmentRegistry, requests: LocalRequestExecution);
16
+ initializeSessionReadState(environmentIds: readonly string[]): Promise<void>;
13
17
  handle(req: IncomingMessage, res: ServerResponse): Promise<void>;
14
- private readState;
15
18
  }
@@ -1,11 +1,14 @@
1
+ import { WebSessionRoutes } from "./session-routes.js";
2
+ import { WebSessionReadStates } from "../session-read-state/service.js";
1
3
  import { getRuntimeConfig, getRuntimeConfigSchema, } from "../../runtime/admin/config-control.js";
2
4
  import { getRuntimeStatus, tailRuntimeLog, } from "../../runtime/admin/system-control.js";
3
5
  import { getConfigDashboardSnapshot, saveConfigDashboardFile, } from "../config-dashboard-backend.js";
4
- import { deleteSessionAttachmentsIfSupported, LocalAttachmentRoutes, } from "./attachment-routes.js";
6
+ import { LocalAttachmentRoutes } from "./attachment-routes.js";
5
7
  import { createLocalLongTermMemoryOnboardingService } from "../../runtime/adapters/long-term-memory/onboarding-service.js";
6
8
  import { getString, pathSegments, readBody, readConfigFileKind, readJsonBody, requestEnvironmentId, sendJson, } from "./http.js";
7
9
  import { LongTermMemoryManagementRoutes } from "./memory-management-routes.js";
8
10
  import { LongTermMemoryOnboardingRoutes } from "./memory-onboarding-routes.js";
11
+ import { ScheduleManagementRoutes } from "./schedule-management-routes.js";
9
12
  function sendRuntimeSetupRequired(res, availability) {
10
13
  sendJson(res, 409, {
11
14
  ok: false,
@@ -21,10 +24,16 @@ export class LocalRuntimeApiRouter {
21
24
  attachments = new LocalAttachmentRoutes();
22
25
  memoryManagement;
23
26
  memoryOnboarding;
27
+ schedules;
28
+ readStates;
29
+ sessions;
24
30
  constructor(options, environments, requests) {
25
31
  this.options = options;
26
32
  this.environments = environments;
27
33
  this.requests = requests;
34
+ this.readStates = new WebSessionReadStates((id) => this.environments.get(id));
35
+ this.sessions = new WebSessionRoutes(this.readStates);
36
+ this.schedules = new ScheduleManagementRoutes((id) => this.environments.get(id));
28
37
  this.memoryOnboarding = new LongTermMemoryOnboardingRoutes(createLocalLongTermMemoryOnboardingService({
29
38
  rootDir: options.rootDir ?? process.cwd(),
30
39
  providerAdapters: options.providerAdapters,
@@ -32,6 +41,18 @@ export class LocalRuntimeApiRouter {
32
41
  }));
33
42
  this.memoryManagement = new LongTermMemoryManagementRoutes((environmentId) => this.environments.get(environmentId).services.longTermMemory);
34
43
  }
44
+ async initializeSessionReadState(environmentIds) {
45
+ for (const id of environmentIds) {
46
+ try {
47
+ if (this.environments.setupRequirement(id))
48
+ continue;
49
+ await this.readStates.initialize(id);
50
+ }
51
+ catch (error) {
52
+ console.error(`Web UI read state unavailable for environment ${id}:`, error);
53
+ }
54
+ }
55
+ }
35
56
  async handle(req, res) {
36
57
  const url = new URL(req.url || "/", "http://localhost");
37
58
  const pathname = url.pathname.slice("/web-api".length) || "/";
@@ -63,6 +84,18 @@ export class LocalRuntimeApiRouter {
63
84
  ? null
64
85
  : readJsonBody(await readBody(req));
65
86
  const environmentId = requestEnvironmentId(url, body, this.options.defaultEnvironmentId);
87
+ if (segments[0] === "schedules")
88
+ await this.initializeSessionReadState([environmentId]);
89
+ if (await this.schedules.handle({
90
+ method,
91
+ segments,
92
+ url,
93
+ body,
94
+ environmentId,
95
+ response: res,
96
+ })) {
97
+ return;
98
+ }
66
99
  if (await this.memoryOnboarding.handle({
67
100
  method,
68
101
  route,
@@ -136,71 +169,15 @@ export class LocalRuntimeApiRouter {
136
169
  }
137
170
  }
138
171
  const environment = this.environments.get(environmentId);
139
- if (method === "GET" && route === "chat/sessions") {
140
- const result = await environment.services.sessions.listSessions();
141
- sendJson(res, 200, { ok: true, ...result });
142
- return;
143
- }
144
- if (method === "GET" &&
145
- segments[0] === "chat" &&
146
- segments[1] === "sessions" &&
147
- segments[2] &&
148
- segments[3] === "messages") {
149
- const snapshot = await environment.services.sessions.getSessionSnapshot(segments[2], { includeRequests: true });
150
- if (!snapshot) {
151
- sendJson(res, 404, {
152
- ok: false,
153
- error: "session_not_found",
154
- messages: [],
155
- requests: [],
156
- });
157
- return;
158
- }
159
- sendJson(res, 200, {
160
- ok: true,
161
- sessionId: snapshot.sessionId,
162
- title: snapshot.title,
163
- messages: snapshot.messages,
164
- requests: snapshot.requests,
165
- nextCursor: snapshot.nextCursor,
166
- readState: this.readState(snapshot.sessionId),
167
- });
168
- return;
169
- }
170
- if (method === "DELETE" &&
171
- segments[0] === "chat" &&
172
- segments[1] === "sessions" &&
173
- segments[2] &&
174
- segments[3] === "messages") {
175
- const result = await environment.services.sessions.clearSessionMessages(segments[2]);
176
- if (!result) {
177
- sendJson(res, 404, { ok: false, error: "session_not_found" });
178
- return;
179
- }
180
- await deleteSessionAttachmentsIfSupported(environment, segments[2]);
181
- sendJson(res, 200, { ok: true, ...result });
182
- return;
183
- }
184
- if (method === "DELETE" &&
185
- segments[0] === "chat" &&
186
- segments[1] === "sessions" &&
187
- segments[2] &&
188
- segments.length === 3) {
189
- const result = await environment.services.sessions.deleteSessionWithStats(segments[2]);
190
- if (result.deleted) {
191
- await deleteSessionAttachmentsIfSupported(environment, segments[2]);
192
- }
193
- sendJson(res, 200, { ok: true, ...result });
194
- return;
195
- }
196
- if (method === "POST" &&
197
- segments[0] === "chat" &&
198
- segments[1] === "sessions" &&
199
- segments[2] &&
200
- segments[3] === "read") {
201
- sendJson(res, 200, { ok: true, readState: this.readState(segments[2]) });
172
+ if (await this.sessions.handle({
173
+ method,
174
+ segments,
175
+ body,
176
+ environmentId,
177
+ environment,
178
+ response: res,
179
+ }))
202
180
  return;
203
- }
204
181
  if (method === "POST" && route === "chat/messages") {
205
182
  await this.requests.start(res, body ?? {}, environmentId, environment);
206
183
  return;
@@ -275,12 +252,4 @@ export class LocalRuntimeApiRouter {
275
252
  }
276
253
  sendJson(res, 404, { ok: false, error: "not_found" });
277
254
  }
278
- readState(sessionId) {
279
- return {
280
- sessionId,
281
- unreadCount: 0,
282
- hasUnread: false,
283
- lastReadAt: Date.now(),
284
- };
285
- }
286
255
  }
@@ -1,4 +1,4 @@
1
- import type { RuntimeApplication } from "../../runtime/composition.js";
1
+ import type { LocalRuntimeApplication } from "../../runtime/local-application.js";
2
2
  import type { RequestSteeringInbox } from "../../runtime/request/request-steering.js";
3
3
  import type { ModelProviderAdapterRegistry } from "../../model-gateway/index.js";
4
4
  export type JsonObject = Record<string, unknown>;
@@ -11,7 +11,7 @@ export type LocalRuntimeBackendOptions = {
11
11
  export type ResolvedLocalRuntimeBackendOptions = Omit<LocalRuntimeBackendOptions, "providerAdapters"> & {
12
12
  providerAdapters: ModelProviderAdapterRegistry;
13
13
  };
14
- export type RuntimeEnvironment = RuntimeApplication;
14
+ export type RuntimeEnvironment = LocalRuntimeApplication;
15
15
  export type RuntimeSetupRequirement = {
16
16
  status: "setup_required";
17
17
  code: "runtime_configuration_required";
@@ -1,11 +1,22 @@
1
+ import { type LocalRuntimeApplicationOptions } from "../../runtime/local-application.js";
1
2
  import type { LocalRuntimeBackendOptions, RuntimeEnvironment, RuntimeModelCatalogState, RuntimeSetupRequirement } from "./contracts.js";
2
3
  export declare class RuntimeEnvironmentRegistry {
3
4
  private readonly options;
5
+ private readonly schedulerBindings;
4
6
  private readonly environments;
5
- constructor(options: LocalRuntimeBackendOptions);
7
+ private stopped;
8
+ private stopping;
9
+ constructor(options: LocalRuntimeBackendOptions, schedulerBindings?: {
10
+ requestOptions?: LocalRuntimeApplicationOptions["scheduledRequestOptions"];
11
+ publish?: (event: Record<string, unknown>) => void;
12
+ });
6
13
  modelCatalog(environmentId: string): RuntimeModelCatalogState;
7
14
  setupRequirement(environmentId: string): RuntimeSetupRequirement | null;
8
15
  get(environmentId: string): RuntimeEnvironment;
16
+ start(environmentIds: readonly string[]): Promise<void>;
17
+ private startEnvironment;
18
+ stop(): Promise<void>;
19
+ private requireEnvironmentIntakeOpen;
9
20
  profileEnv(environmentId: string): Record<string, string | undefined>;
10
21
  private loadConfig;
11
22
  private emptyModelCatalog;