@abot-ai/runtime 1.1.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 (731) hide show
  1. package/README.md +20 -3
  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 +6 -1
  14. package/dist/src/cli/abot.js +2 -11
  15. package/dist/src/model-gateway/providers/ollama/generation-options.d.ts +1 -3
  16. package/dist/src/model-gateway/providers/ollama/generation-options.js +1 -5
  17. package/dist/src/model-gateway/providers/ollama/payload.js +0 -8
  18. package/dist/src/model-gateway/server/request-body.js +1 -0
  19. package/dist/src/plugin-sdk/index.d.ts +2 -0
  20. package/dist/src/plugin-sdk/index.js +2 -0
  21. package/dist/src/plugin-sdk/tool-availability-brief.d.ts +9 -0
  22. package/dist/src/plugin-sdk/tool-availability-brief.js +48 -0
  23. package/dist/src/plugin-sdk/tool-availability-overview.d.ts +9 -0
  24. package/dist/src/plugin-sdk/tool-availability-overview.js +62 -0
  25. package/dist/src/runtime/adapters/in-memory-session-store.js +1 -0
  26. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.js +11 -2
  27. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.d.ts +2 -0
  28. package/dist/src/runtime/adapters/long-term-memory/file-lock/synchronous-release.d.ts +2 -0
  29. package/dist/src/runtime/adapters/long-term-memory/file-lock/synchronous-release.js +40 -0
  30. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.d.ts +3 -0
  31. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.js +9 -0
  32. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/rejection-event.d.ts +13 -0
  33. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/rejection-event.js +25 -0
  34. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.js +18 -2
  35. package/dist/src/runtime/adapters/registered-tool-normal-invocations/executor.js +8 -0
  36. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.js +7 -3
  37. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +17 -2
  38. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/event-metadata.d.ts +9 -0
  39. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/event-metadata.js +8 -0
  40. package/dist/src/runtime/adapters/registered-tool-payload-plan.d.ts +0 -9
  41. package/dist/src/runtime/adapters/registered-tool-payload-plan.js +0 -67
  42. package/dist/src/runtime/adapters/registered-tool-payload-related-artifacts.d.ts +13 -0
  43. package/dist/src/runtime/adapters/registered-tool-payload-related-artifacts.js +84 -0
  44. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/catalog.js +4 -0
  45. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.js +19 -1
  46. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.d.ts +1 -0
  47. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.js +11 -1
  48. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.js +2 -2
  49. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.d.ts +1 -0
  50. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.js +9 -1
  51. package/dist/src/runtime/adapters/scheduled-request-outcome.d.ts +11 -0
  52. package/dist/src/runtime/adapters/scheduled-request-outcome.js +41 -0
  53. package/dist/src/runtime/adapters/scheduler-runtime.d.ts +19 -0
  54. package/dist/src/runtime/adapters/scheduler-runtime.js +138 -0
  55. package/dist/src/runtime/capabilities/request-bound-tool-registry.js +1 -24
  56. package/dist/src/runtime/capabilities/scheduling/create-operations.d.ts +55 -0
  57. package/dist/src/runtime/capabilities/scheduling/create-operations.js +30 -0
  58. package/dist/src/runtime/capabilities/scheduling/create-time-zone.d.ts +1 -0
  59. package/dist/src/runtime/capabilities/scheduling/create-time-zone.js +11 -0
  60. package/dist/src/runtime/capabilities/scheduling/job-list-page.d.ts +25 -0
  61. package/dist/src/runtime/capabilities/scheduling/job-list-page.js +40 -0
  62. package/dist/src/runtime/capabilities/scheduling/model-validation.d.ts +2 -0
  63. package/dist/src/runtime/capabilities/scheduling/model-validation.js +15 -0
  64. package/dist/src/runtime/capabilities/scheduling/tool-contract.d.ts +2 -0
  65. package/dist/src/runtime/capabilities/scheduling/tool-contract.js +35 -0
  66. package/dist/src/runtime/capabilities/scheduling/tool-input-properties.d.ts +43 -0
  67. package/dist/src/runtime/capabilities/scheduling/tool-input-properties.js +27 -0
  68. package/dist/src/runtime/capabilities/scheduling/tool-module.d.ts +4 -0
  69. package/dist/src/runtime/capabilities/scheduling/tool-module.js +158 -0
  70. package/dist/src/runtime/capabilities/scheduling/update-operations.d.ts +2 -0
  71. package/dist/src/runtime/capabilities/scheduling/update-operations.js +49 -0
  72. package/dist/src/runtime/capabilities/tool-availability.d.ts +6 -0
  73. package/dist/src/runtime/capabilities/tool-availability.js +28 -0
  74. package/dist/src/runtime/composition.d.ts +23 -3
  75. package/dist/src/runtime/composition.js +12 -17
  76. package/dist/src/runtime/config/environment-paths.d.ts +10 -0
  77. package/dist/src/runtime/config/environment-paths.js +31 -0
  78. package/dist/src/runtime/config/environment-storage.d.ts +9 -0
  79. package/dist/src/runtime/config/environment-storage.js +65 -0
  80. package/dist/src/runtime/config/fields.js +7 -0
  81. package/dist/src/runtime/config/long-term-memory.js +15 -0
  82. package/dist/src/runtime/config/schema.js +8 -0
  83. package/dist/src/runtime/config.js +9 -5
  84. package/dist/src/runtime/context/capability-brief.d.ts +25 -0
  85. package/dist/src/runtime/context/capability-brief.js +106 -0
  86. package/dist/src/runtime/context/request-tool-results-message-binding.d.ts +6 -0
  87. package/dist/src/runtime/context/request-tool-results-message-binding.js +30 -0
  88. package/dist/src/runtime/context/request-tool-results-scope.d.ts +3 -0
  89. package/dist/src/runtime/context/request-tool-results-scope.js +8 -0
  90. package/dist/src/runtime/context/request-tool-results.d.ts +8 -4
  91. package/dist/src/runtime/context/request-tool-results.js +49 -38
  92. package/dist/src/runtime/context/scheduled-execution-context.d.ts +10 -0
  93. package/dist/src/runtime/context/scheduled-execution-context.js +52 -0
  94. package/dist/src/runtime/default-adapters.d.ts +3 -32
  95. package/dist/src/runtime/default-adapters.js +3 -270
  96. package/dist/src/runtime/default-environment-adapters.d.ts +19 -0
  97. package/dist/src/runtime/default-environment-adapters.js +144 -0
  98. package/dist/src/runtime/index.d.ts +5 -0
  99. package/dist/src/runtime/index.js +4 -0
  100. package/dist/src/runtime/local-application.d.ts +22 -0
  101. package/dist/src/runtime/local-application.js +81 -0
  102. package/dist/src/runtime/local-host/app-memory-dispatch.d.ts +11 -0
  103. package/dist/src/runtime/local-host/app-memory-dispatch.js +103 -0
  104. package/dist/src/runtime/local-host/app-owner.d.ts +4 -0
  105. package/dist/src/runtime/local-host/app-owner.js +119 -0
  106. package/dist/src/runtime/local-host/app-request-control.d.ts +24 -0
  107. package/dist/src/runtime/local-host/app-request-control.js +135 -0
  108. package/dist/src/runtime/local-host/app-service-dispatch.d.ts +5 -0
  109. package/dist/src/runtime/local-host/app-service-dispatch.js +64 -0
  110. package/dist/src/runtime/local-host/client-identity.d.ts +3 -0
  111. package/dist/src/runtime/local-host/client-identity.js +17 -0
  112. package/dist/src/runtime/local-host/client-memory.d.ts +7 -0
  113. package/dist/src/runtime/local-host/client-memory.js +54 -0
  114. package/dist/src/runtime/local-host/client-requests.d.ts +19 -0
  115. package/dist/src/runtime/local-host/client-requests.js +145 -0
  116. package/dist/src/runtime/local-host/client-services.d.ts +10 -0
  117. package/dist/src/runtime/local-host/client-services.js +14 -0
  118. package/dist/src/runtime/local-host/contracts.d.ts +36 -0
  119. package/dist/src/runtime/local-host/contracts.js +1 -0
  120. package/dist/src/runtime/local-host/endpoint.d.ts +7 -0
  121. package/dist/src/runtime/local-host/endpoint.js +79 -0
  122. package/dist/src/runtime/local-host/owner-activity.d.ts +10 -0
  123. package/dist/src/runtime/local-host/owner-activity.js +30 -0
  124. package/dist/src/runtime/local-host/owner-retirement.d.ts +3 -0
  125. package/dist/src/runtime/local-host/owner-retirement.js +15 -0
  126. package/dist/src/runtime/local-host/owner-server.d.ts +6 -0
  127. package/dist/src/runtime/local-host/owner-server.js +88 -0
  128. package/dist/src/runtime/local-host/private-access.d.ts +2 -0
  129. package/dist/src/runtime/local-host/private-access.js +16 -0
  130. package/dist/src/runtime/local-host/private-directory.d.ts +1 -0
  131. package/dist/src/runtime/local-host/private-directory.js +57 -0
  132. package/dist/src/runtime/local-host/rpc-peer.d.ts +22 -0
  133. package/dist/src/runtime/local-host/rpc-peer.js +168 -0
  134. package/dist/src/runtime/local-host/rpc-protocol.d.ts +21 -0
  135. package/dist/src/runtime/local-host/rpc-protocol.js +46 -0
  136. package/dist/src/runtime/local-host/startup-connection.d.ts +5 -0
  137. package/dist/src/runtime/local-host/startup-connection.js +72 -0
  138. package/dist/src/runtime/local-host/transport.d.ts +3 -0
  139. package/dist/src/runtime/local-host/transport.js +88 -0
  140. package/dist/src/runtime/local-host/windows-private-access.d.ts +1 -0
  141. package/dist/src/runtime/local-host/windows-private-access.js +51 -0
  142. package/dist/src/runtime/long-term-memory/onboarding/configuration.js +6 -0
  143. package/dist/src/runtime/long-term-memory/recall-binding.d.ts +3 -0
  144. package/dist/src/runtime/long-term-memory/recall-binding.js +27 -0
  145. package/dist/src/runtime/long-term-memory/recall-context.d.ts +20 -0
  146. package/dist/src/runtime/long-term-memory/recall-context.js +101 -0
  147. package/dist/src/runtime/long-term-memory/recall-continuation.d.ts +8 -0
  148. package/dist/src/runtime/long-term-memory/recall-continuation.js +36 -0
  149. package/dist/src/runtime/long-term-memory/recall-policy.d.ts +7 -0
  150. package/dist/src/runtime/long-term-memory/recall-policy.js +14 -0
  151. package/dist/src/runtime/long-term-memory/recall-result.d.ts +5 -0
  152. package/dist/src/runtime/long-term-memory/recall-result.js +54 -0
  153. package/dist/src/runtime/long-term-memory/repository-state.d.ts +2 -1
  154. package/dist/src/runtime/long-term-memory/repository-state.js +2 -2
  155. package/dist/src/runtime/model/invoke-raw-step.d.ts +1 -0
  156. package/dist/src/runtime/model/invoke-raw-step.js +1 -0
  157. package/dist/src/runtime/model/invoke-step.js +6 -0
  158. package/dist/src/runtime/model/invoke-structured-step.d.ts +1 -0
  159. package/dist/src/runtime/model/invoke-structured-step.js +1 -0
  160. package/dist/src/runtime/model/model-step-port.d.ts +2 -0
  161. package/dist/src/runtime/model/model-step-steering.d.ts +8 -0
  162. package/dist/src/runtime/model/model-step-steering.js +19 -0
  163. package/dist/src/runtime/orchestration/final-response/authoring-contract.js +1 -1
  164. package/dist/src/runtime/orchestration/final-response/invoke.d.ts +1 -0
  165. package/dist/src/runtime/orchestration/final-response/invoke.js +1 -0
  166. package/dist/src/runtime/orchestration/role-calls/activation-budget.js +1 -0
  167. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +17 -50
  168. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.d.ts +9 -0
  169. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.js +17 -8
  170. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-validation.d.ts +2 -0
  171. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-validation.js +62 -0
  172. package/dist/src/runtime/orchestration/role-calls/child-return.d.ts +4 -0
  173. package/dist/src/runtime/orchestration/role-calls/child-return.js +25 -5
  174. package/dist/src/runtime/orchestration/role-calls/command-decoder.js +12 -3
  175. package/dist/src/runtime/orchestration/role-calls/command-dispatch/child-transitions.d.ts +1 -1
  176. package/dist/src/runtime/orchestration/role-calls/command-dispatch/child-transitions.js +17 -2
  177. package/dist/src/runtime/orchestration/role-calls/command-dispatch/memory-recall-transitions.d.ts +4 -0
  178. package/dist/src/runtime/orchestration/role-calls/command-dispatch/memory-recall-transitions.js +89 -0
  179. package/dist/src/runtime/orchestration/role-calls/command-dispatch.d.ts +1 -1
  180. package/dist/src/runtime/orchestration/role-calls/command-dispatch.js +7 -2
  181. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +12 -7
  182. package/dist/src/runtime/orchestration/role-calls/contracts.js +4 -4
  183. package/dist/src/runtime/orchestration/role-calls/dependency-results.d.ts +1 -1
  184. package/dist/src/runtime/orchestration/role-calls/dependency-results.js +1 -0
  185. package/dist/src/runtime/orchestration/role-calls/diagnostics.js +3 -0
  186. package/dist/src/runtime/orchestration/role-calls/index.d.ts +6 -1
  187. package/dist/src/runtime/orchestration/role-calls/index.js +6 -1
  188. package/dist/src/runtime/orchestration/role-calls/ledger.d.ts +3 -1
  189. package/dist/src/runtime/orchestration/role-calls/ledger.js +9 -2
  190. package/dist/src/runtime/orchestration/role-calls/memory-recall-contract.d.ts +51 -0
  191. package/dist/src/runtime/orchestration/role-calls/memory-recall-contract.js +4 -0
  192. package/dist/src/runtime/orchestration/role-calls/memory-recall-decoder.d.ts +6 -0
  193. package/dist/src/runtime/orchestration/role-calls/memory-recall-decoder.js +147 -0
  194. package/dist/src/runtime/orchestration/role-calls/memory-recall-diagnostics.d.ts +5 -0
  195. package/dist/src/runtime/orchestration/role-calls/memory-recall-diagnostics.js +27 -0
  196. package/dist/src/runtime/orchestration/role-calls/memory-recall-state-validation.d.ts +3 -0
  197. package/dist/src/runtime/orchestration/role-calls/memory-recall-state-validation.js +121 -0
  198. package/dist/src/runtime/orchestration/role-calls/memory-recall-transactions.d.ts +3 -0
  199. package/dist/src/runtime/orchestration/role-calls/memory-recall-transactions.js +44 -0
  200. package/dist/src/runtime/orchestration/role-calls/reducer.d.ts +1 -1
  201. package/dist/src/runtime/orchestration/role-calls/reducer.js +3 -2
  202. package/dist/src/runtime/orchestration/role-calls/result-receipt.d.ts +49 -0
  203. package/dist/src/runtime/orchestration/role-calls/result-receipt.js +188 -0
  204. package/dist/src/runtime/orchestration/role-calls/return-result-receipt.d.ts +19 -0
  205. package/dist/src/runtime/orchestration/role-calls/return-result-receipt.js +52 -0
  206. package/dist/src/runtime/orchestration/role-calls/transaction-effect.d.ts +5 -0
  207. package/dist/src/runtime/orchestration/role-calls/transaction-effect.js +14 -0
  208. package/dist/src/runtime/orchestration/role-calls/transactions.js +4 -24
  209. package/dist/src/runtime/orchestration/role-calls/work-result-lineage.d.ts +34 -0
  210. package/dist/src/runtime/orchestration/role-calls/work-result-lineage.js +185 -0
  211. package/dist/src/runtime/orchestration/role-calls/work-result-receipt.d.ts +36 -0
  212. package/dist/src/runtime/orchestration/role-calls/work-result-receipt.js +187 -0
  213. package/dist/src/runtime/orchestration/role-executors/activation/result-normalization.js +6 -3
  214. package/dist/src/runtime/orchestration/role-executors/child-invocation/transaction.js +1 -0
  215. package/dist/src/runtime/orchestration/role-executors/contracts.d.ts +2 -1
  216. package/dist/src/runtime/orchestration/worker-capabilities/assignment-provenance.d.ts +36 -0
  217. package/dist/src/runtime/orchestration/worker-capabilities/assignment-provenance.js +171 -0
  218. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +32 -1
  219. package/dist/src/runtime/orchestration/worker-capabilities/execution/invocation-preparation.d.ts +2 -1
  220. package/dist/src/runtime/orchestration/worker-capabilities/execution/invocation-preparation.js +3 -0
  221. package/dist/src/runtime/orchestration/worker-capabilities/execution.js +42 -19
  222. package/dist/src/runtime/orchestration/worker-capabilities/index.d.ts +2 -0
  223. package/dist/src/runtime/orchestration/worker-capabilities/index.js +2 -0
  224. package/dist/src/runtime/orchestration/worker-capabilities/payload-assignment-validation.d.ts +3 -0
  225. package/dist/src/runtime/orchestration/worker-capabilities/payload-assignment-validation.js +30 -0
  226. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.js +8 -19
  227. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.d.ts +5 -1
  228. package/dist/src/runtime/orchestration/worker-capabilities/payload-instructions.js +1 -1
  229. package/dist/src/runtime/orchestration/worker-capabilities/payload-source-provenance.d.ts +14 -0
  230. package/dist/src/runtime/orchestration/worker-capabilities/payload-source-provenance.js +132 -0
  231. package/dist/src/runtime/plugins/manifest-validator.js +4 -1
  232. package/dist/src/runtime/ports.d.ts +4 -0
  233. package/dist/src/runtime/request/bound-runtime-handler.d.ts +2 -0
  234. package/dist/src/runtime/request/bound-runtime-handler.js +25 -0
  235. package/dist/src/runtime/request/capability-brief.d.ts +5 -0
  236. package/dist/src/runtime/request/capability-brief.js +24 -0
  237. package/dist/src/runtime/request/contracts.d.ts +6 -0
  238. package/dist/src/runtime/request/execution-agent-root-execution.js +12 -0
  239. package/dist/src/runtime/request/execution-facets.js +6 -0
  240. package/dist/src/runtime/request/execution-scope-surfaces.js +10 -0
  241. package/dist/src/runtime/request/execution-scope.d.ts +3 -2
  242. package/dist/src/runtime/request/handler.js +6 -0
  243. package/dist/src/runtime/request/role-executor-composition.js +1 -1
  244. package/dist/src/runtime/request/root-contract.d.ts +7 -1
  245. package/dist/src/runtime/request/root-execution-kernel.js +33 -37
  246. package/dist/src/runtime/request/root-memory-recall.d.ts +11 -0
  247. package/dist/src/runtime/request/root-memory-recall.js +71 -0
  248. package/dist/src/runtime/request/root-observation-handoff.d.ts +17 -0
  249. package/dist/src/runtime/request/root-observation-handoff.js +44 -0
  250. package/dist/src/runtime/request/scheduled-execution.d.ts +9 -0
  251. package/dist/src/runtime/request/scheduled-execution.js +32 -0
  252. package/dist/src/runtime/request/session-admission.d.ts +17 -0
  253. package/dist/src/runtime/request/session-admission.js +88 -0
  254. package/dist/src/runtime/request/supervisor-root-execution-diagnostics.d.ts +1 -1
  255. package/dist/src/runtime/request/supervisor-root-execution.js +8 -0
  256. package/dist/src/runtime/request/worker-capability-composition.d.ts +2 -1
  257. package/dist/src/runtime/request/worker-capability-composition.js +6 -1
  258. package/dist/src/runtime/request/worker-capability-payload.js +11 -8
  259. package/dist/src/runtime/runtime-environment.d.ts +31 -0
  260. package/dist/src/runtime/runtime-environment.js +102 -0
  261. package/dist/src/runtime/runtime-host-environment.d.ts +8 -0
  262. package/dist/src/runtime/runtime-host-environment.js +57 -0
  263. package/dist/src/runtime/runtime-host-lifecycle.d.ts +4 -0
  264. package/dist/src/runtime/runtime-host-lifecycle.js +64 -0
  265. package/dist/src/runtime/runtime-host-scheduler-ownership.d.ts +5 -0
  266. package/dist/src/runtime/runtime-host-scheduler-ownership.js +67 -0
  267. package/dist/src/runtime/runtime-host.d.ts +19 -0
  268. package/dist/src/runtime/runtime-host.js +63 -0
  269. package/dist/src/runtime/scheduler/calendar-time.d.ts +10 -0
  270. package/dist/src/runtime/scheduler/calendar-time.js +58 -0
  271. package/dist/src/runtime/scheduler/contracts.d.ts +143 -0
  272. package/dist/src/runtime/scheduler/contracts.js +1 -0
  273. package/dist/src/runtime/scheduler/file-store.d.ts +2 -0
  274. package/dist/src/runtime/scheduler/file-store.js +76 -0
  275. package/dist/src/runtime/scheduler/instant-validation.d.ts +4 -0
  276. package/dist/src/runtime/scheduler/instant-validation.js +69 -0
  277. package/dist/src/runtime/scheduler/interval-range.d.ts +8 -0
  278. package/dist/src/runtime/scheduler/interval-range.js +24 -0
  279. package/dist/src/runtime/scheduler/job-management.d.ts +8 -0
  280. package/dist/src/runtime/scheduler/job-management.js +212 -0
  281. package/dist/src/runtime/scheduler/journal-checkpoint.d.ts +9 -0
  282. package/dist/src/runtime/scheduler/journal-checkpoint.js +45 -0
  283. package/dist/src/runtime/scheduler/journal-durability.d.ts +8 -0
  284. package/dist/src/runtime/scheduler/journal-durability.js +59 -0
  285. package/dist/src/runtime/scheduler/journal-files.d.ts +14 -0
  286. package/dist/src/runtime/scheduler/journal-files.js +59 -0
  287. package/dist/src/runtime/scheduler/journal-head.d.ts +21 -0
  288. package/dist/src/runtime/scheduler/journal-head.js +81 -0
  289. package/dist/src/runtime/scheduler/journal-index-state.d.ts +31 -0
  290. package/dist/src/runtime/scheduler/journal-index-state.js +137 -0
  291. package/dist/src/runtime/scheduler/journal-index.d.ts +22 -0
  292. package/dist/src/runtime/scheduler/journal-index.js +195 -0
  293. package/dist/src/runtime/scheduler/journal-store.d.ts +21 -0
  294. package/dist/src/runtime/scheduler/journal-store.js +184 -0
  295. package/dist/src/runtime/scheduler/journal-transaction.d.ts +14 -0
  296. package/dist/src/runtime/scheduler/journal-transaction.js +104 -0
  297. package/dist/src/runtime/scheduler/next-occurrence.d.ts +3 -0
  298. package/dist/src/runtime/scheduler/next-occurrence.js +39 -0
  299. package/dist/src/runtime/scheduler/run-completion.d.ts +12 -0
  300. package/dist/src/runtime/scheduler/run-completion.js +77 -0
  301. package/dist/src/runtime/scheduler/run-list-query.d.ts +5 -0
  302. package/dist/src/runtime/scheduler/run-list-query.js +38 -0
  303. package/dist/src/runtime/scheduler/run-records.d.ts +6 -0
  304. package/dist/src/runtime/scheduler/run-records.js +41 -0
  305. package/dist/src/runtime/scheduler/schedule-update.d.ts +3 -0
  306. package/dist/src/runtime/scheduler/schedule-update.js +22 -0
  307. package/dist/src/runtime/scheduler/schedule-validation.d.ts +10 -0
  308. package/dist/src/runtime/scheduler/schedule-validation.js +132 -0
  309. package/dist/src/runtime/scheduler/scheduler-engine.d.ts +2 -0
  310. package/dist/src/runtime/scheduler/scheduler-engine.js +174 -0
  311. package/dist/src/runtime/scheduler/scheduler-service.d.ts +10 -0
  312. package/dist/src/runtime/scheduler/scheduler-service.js +115 -0
  313. package/dist/src/runtime/scheduler/service-context.d.ts +21 -0
  314. package/dist/src/runtime/scheduler/service-context.js +26 -0
  315. package/dist/src/runtime/scheduler/session-deletion-state.d.ts +9 -0
  316. package/dist/src/runtime/scheduler/session-deletion-state.js +30 -0
  317. package/dist/src/runtime/scheduler/snapshot-validation.d.ts +4 -0
  318. package/dist/src/runtime/scheduler/snapshot-validation.js +112 -0
  319. package/dist/src/runtime/scheduler/startup-recovery.d.ts +2 -0
  320. package/dist/src/runtime/scheduler/startup-recovery.js +38 -0
  321. package/dist/src/runtime/scheduler/validation-error.d.ts +4 -0
  322. package/dist/src/runtime/scheduler/validation-error.js +8 -0
  323. package/dist/src/runtime/scheduler/working-store.d.ts +3 -0
  324. package/dist/src/runtime/scheduler/working-store.js +8 -0
  325. package/dist/src/runtime/session/request-session.d.ts +1 -0
  326. package/dist/src/runtime/session/request-session.js +14 -1
  327. package/dist/src/runtime/session/session-attachment-deletion.d.ts +8 -0
  328. package/dist/src/runtime/session/session-attachment-deletion.js +87 -0
  329. package/dist/src/runtime/session/session-deletion-boundary.d.ts +10 -0
  330. package/dist/src/runtime/session/session-deletion-boundary.js +39 -0
  331. package/dist/src/runtime/session/session-deletion-cleanup.d.ts +7 -0
  332. package/dist/src/runtime/session/session-deletion-cleanup.js +62 -0
  333. package/dist/src/runtime/session/session-deletion-finalization.d.ts +7 -0
  334. package/dist/src/runtime/session/session-deletion-finalization.js +34 -0
  335. package/dist/src/runtime/session/session-deletion-receipts.d.ts +7 -0
  336. package/dist/src/runtime/session/session-deletion-receipts.js +18 -0
  337. package/dist/src/runtime/session/session-lifecycle-store.d.ts +21 -0
  338. package/dist/src/runtime/session/session-lifecycle-store.js +72 -0
  339. package/dist/src/runtime/session/session-mutation-queue.d.ts +3 -0
  340. package/dist/src/runtime/session/session-mutation-queue.js +15 -0
  341. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.d.ts +16 -0
  342. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.js +165 -0
  343. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +3 -1
  344. package/dist/src/runtime/steps/execution-agent/decision-parsing.d.ts +2 -0
  345. package/dist/src/runtime/steps/execution-agent/decision-parsing.js +195 -0
  346. package/dist/src/runtime/steps/execution-agent/decision-validation.d.ts +30 -0
  347. package/dist/src/runtime/steps/execution-agent/decision-validation.js +127 -0
  348. package/dist/src/runtime/steps/execution-agent/format.d.ts +1 -0
  349. package/dist/src/runtime/steps/execution-agent/format.js +12 -0
  350. package/dist/src/runtime/steps/execution-agent/input.d.ts +2 -1
  351. package/dist/src/runtime/steps/execution-agent/input.js +17 -2
  352. package/dist/src/runtime/steps/execution-agent/parser.d.ts +1 -2
  353. package/dist/src/runtime/steps/execution-agent/parser.js +1 -472
  354. package/dist/src/runtime/steps/execution-agent/prompt.d.ts +2 -0
  355. package/dist/src/runtime/steps/execution-agent/prompt.js +6 -3
  356. package/dist/src/runtime/steps/execution-agent/reconsideration-context.js +4 -3
  357. package/dist/src/runtime/steps/execution-agent/response-input.js +5 -4
  358. package/dist/src/runtime/steps/execution-agent/response-run.d.ts +3 -0
  359. package/dist/src/runtime/steps/execution-agent/response-run.js +7 -3
  360. package/dist/src/runtime/steps/execution-agent/run.d.ts +2 -0
  361. package/dist/src/runtime/steps/execution-agent/run.js +2 -0
  362. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +2 -1
  363. package/dist/src/runtime/steps/execution-agent/state-context.js +13 -5
  364. package/dist/src/runtime/steps/memory-recall-decision.d.ts +30 -0
  365. package/dist/src/runtime/steps/memory-recall-decision.js +101 -0
  366. package/dist/src/runtime/steps/memory-recall-prompt.d.ts +1 -0
  367. package/dist/src/runtime/steps/memory-recall-prompt.js +15 -0
  368. package/dist/src/runtime/steps/planner-decision/capability-catalog-context.d.ts +14 -0
  369. package/dist/src/runtime/steps/planner-decision/capability-catalog-context.js +87 -0
  370. package/dist/src/runtime/steps/planner-decision/contracts.d.ts +3 -5
  371. package/dist/src/runtime/steps/planner-decision/contracts.js +3 -3
  372. package/dist/src/runtime/steps/planner-decision/format.d.ts +3 -2
  373. package/dist/src/runtime/steps/planner-decision/format.js +73 -76
  374. package/dist/src/runtime/steps/planner-decision/input.d.ts +4 -3
  375. package/dist/src/runtime/steps/planner-decision/input.js +10 -7
  376. package/dist/src/runtime/steps/planner-decision/parser.d.ts +3 -2
  377. package/dist/src/runtime/steps/planner-decision/parser.js +10 -19
  378. package/dist/src/runtime/steps/planner-decision/plan-parser.js +18 -12
  379. package/dist/src/runtime/steps/planner-decision/prompt.js +33 -28
  380. package/dist/src/runtime/steps/planner-decision/resume.d.ts +1 -1
  381. package/dist/src/runtime/steps/planner-decision/resume.js +38 -1
  382. package/dist/src/runtime/steps/planner-decision/run.d.ts +3 -2
  383. package/dist/src/runtime/steps/reviewer-decision/audit-coverage.d.ts +10 -0
  384. package/dist/src/runtime/steps/reviewer-decision/audit-coverage.js +186 -0
  385. package/dist/src/runtime/steps/reviewer-decision/contracts.d.ts +3 -8
  386. package/dist/src/runtime/steps/reviewer-decision/contracts.js +12 -6
  387. package/dist/src/runtime/steps/reviewer-decision/delegated-context.d.ts +24 -0
  388. package/dist/src/runtime/steps/reviewer-decision/delegated-context.js +70 -0
  389. package/dist/src/runtime/steps/reviewer-decision/diagnostics.js +1 -1
  390. package/dist/src/runtime/steps/reviewer-decision/format.js +37 -24
  391. package/dist/src/runtime/steps/reviewer-decision/input.js +1 -1
  392. package/dist/src/runtime/steps/reviewer-decision/model-context.d.ts +4 -3
  393. package/dist/src/runtime/steps/reviewer-decision/model-context.js +92 -10
  394. package/dist/src/runtime/steps/reviewer-decision/parser.js +19 -1
  395. package/dist/src/runtime/steps/reviewer-decision/projection.js +42 -68
  396. package/dist/src/runtime/steps/reviewer-decision/prompt.js +10 -5
  397. package/dist/src/runtime/steps/reviewer-decision/run.js +12 -3
  398. package/dist/src/runtime/steps/reviewer-decision/verification-coverage.d.ts +14 -0
  399. package/dist/src/runtime/steps/reviewer-decision/verification-coverage.js +52 -0
  400. package/dist/src/runtime/steps/supervisor-decision/capability-brief.d.ts +14 -0
  401. package/dist/src/runtime/steps/supervisor-decision/capability-brief.js +38 -0
  402. package/dist/src/runtime/steps/supervisor-decision/contracts.d.ts +11 -5
  403. package/dist/src/runtime/steps/supervisor-decision/diagnostics.d.ts +4 -0
  404. package/dist/src/runtime/steps/supervisor-decision/diagnostics.js +21 -8
  405. package/dist/src/runtime/steps/supervisor-decision/format.d.ts +2 -0
  406. package/dist/src/runtime/steps/supervisor-decision/format.js +73 -22
  407. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +9 -2
  408. package/dist/src/runtime/steps/supervisor-decision/input.js +44 -6
  409. package/dist/src/runtime/steps/supervisor-decision/memory-recall-continuation.d.ts +10 -0
  410. package/dist/src/runtime/steps/supervisor-decision/memory-recall-continuation.js +32 -0
  411. package/dist/src/runtime/steps/supervisor-decision/parser.d.ts +2 -0
  412. package/dist/src/runtime/steps/supervisor-decision/parser.js +97 -59
  413. package/dist/src/runtime/steps/supervisor-decision/prompt.d.ts +3 -0
  414. package/dist/src/runtime/steps/supervisor-decision/prompt.js +22 -15
  415. package/dist/src/runtime/steps/supervisor-decision/response-recommendation.d.ts +13 -0
  416. package/dist/src/runtime/steps/supervisor-decision/response-recommendation.js +32 -0
  417. package/dist/src/runtime/steps/supervisor-decision/resume.d.ts +2 -0
  418. package/dist/src/runtime/steps/supervisor-decision/resume.js +60 -1
  419. package/dist/src/runtime/steps/supervisor-decision/run.d.ts +3 -0
  420. package/dist/src/runtime/steps/supervisor-decision/run.js +29 -0
  421. package/dist/src/runtime/steps/supervisor-decision/working-directory.js +8 -1
  422. package/dist/src/runtime/steps/supervisor-response/diagnostics.d.ts +1 -0
  423. package/dist/src/runtime/steps/supervisor-response/diagnostics.js +1 -0
  424. package/dist/src/runtime/steps/supervisor-response/input.d.ts +2 -1
  425. package/dist/src/runtime/steps/supervisor-response/input.js +17 -4
  426. package/dist/src/runtime/steps/supervisor-response/memory-authoring.d.ts +1 -0
  427. package/dist/src/runtime/steps/supervisor-response/memory-authoring.js +4 -0
  428. package/dist/src/runtime/steps/supervisor-response/prompt.d.ts +1 -0
  429. package/dist/src/runtime/steps/supervisor-response/prompt.js +8 -2
  430. package/dist/src/runtime/steps/supervisor-response/response-recommendation.d.ts +10 -0
  431. package/dist/src/runtime/steps/supervisor-response/response-recommendation.js +25 -0
  432. package/dist/src/runtime/steps/supervisor-response/run.d.ts +6 -1
  433. package/dist/src/runtime/steps/supervisor-response/run.js +26 -7
  434. package/dist/src/runtime/steps/worker-decision/contracts.d.ts +2 -1
  435. package/dist/src/runtime/steps/worker-decision/input/canonical-state.js +8 -1
  436. package/dist/src/runtime/steps/worker-decision/input/diagnostic-projection.js +2 -2
  437. package/dist/src/runtime/steps/worker-decision/input/prompt-context.d.ts +1 -0
  438. package/dist/src/runtime/steps/worker-decision/input/prompt-context.js +4 -1
  439. package/dist/src/runtime/steps/worker-decision/input/reference-context.js +34 -14
  440. package/dist/src/runtime/steps/worker-decision/input/types.d.ts +2 -1
  441. package/dist/src/runtime/steps/worker-decision/input.d.ts +1 -0
  442. package/dist/src/runtime/steps/worker-decision/input.js +1 -0
  443. package/dist/src/runtime/steps/worker-decision/payload-dependency-results.d.ts +8 -0
  444. package/dist/src/runtime/steps/worker-decision/payload-dependency-results.js +19 -0
  445. package/dist/src/runtime/steps/worker-decision/prompt.js +8 -8
  446. package/dist/src/runtime/steps/worker-decision/result-author.js +18 -11
  447. package/dist/src/runtime/steps/worker-decision/run.js +2 -2
  448. package/dist/src/sessions/record/projection.js +1 -0
  449. package/dist/src/sessions/schedule-metadata.d.ts +8 -0
  450. package/dist/src/sessions/schedule-metadata.js +1 -0
  451. package/dist/src/sessions/session-service.d.ts +1 -0
  452. package/dist/src/sessions/session-service.js +1 -0
  453. package/dist/src/sessions/types.d.ts +2 -0
  454. package/dist/src/shared/http-server-shutdown.d.ts +4 -0
  455. package/dist/src/shared/http-server-shutdown.js +17 -0
  456. package/dist/src/shared/public-http/aggregate-gate.d.ts +3 -0
  457. package/dist/src/shared/public-http/aggregate-gate.js +87 -0
  458. package/dist/src/shared/public-http/deadline.d.ts +2 -0
  459. package/dist/src/shared/public-http/deadline.js +29 -0
  460. package/dist/src/shared/public-http/errors.d.ts +6 -0
  461. package/dist/src/shared/public-http/errors.js +11 -0
  462. package/dist/src/shared/public-http/limits.d.ts +8 -0
  463. package/dist/src/shared/public-http/limits.js +8 -0
  464. package/dist/src/shared/public-http/network-policy.d.ts +11 -0
  465. package/dist/src/shared/public-http/network-policy.js +178 -0
  466. package/dist/src/shared/public-http/public-http.d.ts +24 -0
  467. package/dist/src/shared/public-http/public-http.js +85 -0
  468. package/dist/src/shared/public-http/request-hop.d.ts +18 -0
  469. package/dist/src/shared/public-http/request-hop.js +140 -0
  470. package/dist/src/web-ui/app/ARCHITECTURE.md +82 -7
  471. package/dist/src/web-ui/app/app-bootstrap.js +53 -0
  472. package/dist/src/web-ui/app/app-dom.js +80 -0
  473. package/dist/src/web-ui/app/app.js +199 -217
  474. package/dist/src/web-ui/app/components/composer-context-window.d.ts +25 -0
  475. package/dist/src/web-ui/app/components/composer-context-window.js +155 -0
  476. package/dist/src/web-ui/app/components/composer-plan.d.ts +9 -0
  477. package/dist/src/web-ui/app/components/composer-plan.js +128 -0
  478. package/dist/src/web-ui/app/components/conversation-activity.d.ts +7 -6
  479. package/dist/src/web-ui/app/components/conversation-activity.js +97 -163
  480. package/dist/src/web-ui/app/components/conversation-role-cards.d.ts +24 -0
  481. package/dist/src/web-ui/app/components/conversation-role-cards.js +237 -0
  482. package/dist/src/web-ui/app/components/conversation-schedule.js +71 -0
  483. package/dist/src/web-ui/app/components/conversation-sidebar-layout.js +12 -0
  484. package/dist/src/web-ui/app/components/conversation-sources.d.ts +7 -0
  485. package/dist/src/web-ui/app/components/conversation-sources.js +182 -0
  486. package/dist/src/web-ui/app/components/conversation-status.js +65 -0
  487. package/dist/src/web-ui/app/components/conversation-tools.d.ts +13 -0
  488. package/dist/src/web-ui/app/components/conversation-tools.js +284 -0
  489. package/dist/src/web-ui/app/components/conversation-view.js +73 -17
  490. package/dist/src/web-ui/app/components/dashboard/activity.js +61 -0
  491. package/dist/src/web-ui/app/components/dashboard/icons.js +23 -0
  492. package/dist/src/web-ui/app/components/dashboard/recent-conversations.js +64 -0
  493. package/dist/src/web-ui/app/components/dashboard/workspace.js +107 -0
  494. package/dist/src/web-ui/app/components/message-link-previews.d.ts +16 -0
  495. package/dist/src/web-ui/app/components/message-link-previews.js +179 -0
  496. package/dist/src/web-ui/app/components/model-selector.js +4 -1
  497. package/dist/src/web-ui/app/components/operations-section.js +46 -0
  498. package/dist/src/web-ui/app/components/schedules/details.js +101 -0
  499. package/dist/src/web-ui/app/components/schedules/form.d.ts +13 -0
  500. package/dist/src/web-ui/app/components/schedules/form.js +246 -0
  501. package/dist/src/web-ui/app/components/schedules/workspace-state.js +59 -0
  502. package/dist/src/web-ui/app/components/schedules/workspace.js +165 -0
  503. package/dist/src/web-ui/app/components/workspace-shell.js +133 -79
  504. package/dist/src/web-ui/app/configuration-feature.js +72 -0
  505. package/dist/src/web-ui/app/controllers/composer-attachments-controller.d.ts +1 -0
  506. package/dist/src/web-ui/app/controllers/composer-attachments-controller.js +17 -6
  507. package/dist/src/web-ui/app/controllers/composer-submit-controller.d.ts +2 -0
  508. package/dist/src/web-ui/app/controllers/composer-submit-controller.js +15 -1
  509. package/dist/src/web-ui/app/controllers/composer-surface-controller.js +58 -0
  510. package/dist/src/web-ui/app/controllers/composer-workspace-controller.d.ts +53 -0
  511. package/dist/src/web-ui/app/controllers/composer-workspace-controller.js +180 -0
  512. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.d.ts +23 -0
  513. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.js +82 -0
  514. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +8 -0
  515. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +28 -39
  516. package/dist/src/web-ui/app/controllers/dashboard-controller.js +127 -0
  517. package/dist/src/web-ui/app/controllers/home-composer-feature.d.ts +40 -0
  518. package/dist/src/web-ui/app/controllers/home-composer-feature.js +119 -0
  519. package/dist/src/web-ui/app/controllers/home-conversation-activation.js +37 -0
  520. package/dist/src/web-ui/app/controllers/realtime-event-controller.d.ts +2 -0
  521. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +126 -90
  522. package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts +2 -1
  523. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +17 -14
  524. package/dist/src/web-ui/app/controllers/schedule-realtime.js +118 -0
  525. package/dist/src/web-ui/app/controllers/schedules-controller.js +421 -0
  526. package/dist/src/web-ui/app/controllers/session-controller.js +47 -15
  527. package/dist/src/web-ui/app/dashboard-feature.js +44 -0
  528. package/dist/src/web-ui/app/index.html +240 -189
  529. package/dist/src/web-ui/app/lib/composer-plan-model.d.ts +32 -0
  530. package/dist/src/web-ui/app/lib/composer-plan-model.js +108 -0
  531. package/dist/src/web-ui/app/lib/composer-submission-scope.d.ts +21 -0
  532. package/dist/src/web-ui/app/lib/composer-submission-scope.js +13 -0
  533. package/dist/src/web-ui/app/lib/context-window-snapshot-order.d.ts +15 -0
  534. package/dist/src/web-ui/app/lib/context-window-snapshot-order.js +31 -0
  535. package/dist/src/web-ui/app/lib/conversation-role-model.d.ts +28 -0
  536. package/dist/src/web-ui/app/lib/conversation-role-model.js +275 -0
  537. package/dist/src/web-ui/app/lib/conversation-status-model.d.ts +12 -0
  538. package/dist/src/web-ui/app/lib/conversation-status-model.js +116 -0
  539. package/dist/src/web-ui/app/lib/dashboard-job-templates.js +41 -0
  540. package/dist/src/web-ui/app/lib/dashboard-presentation.js +126 -0
  541. package/dist/src/web-ui/app/lib/event-presentation.js +30 -9
  542. package/dist/src/web-ui/app/lib/message-markdown.d.ts +5 -0
  543. package/dist/src/web-ui/app/lib/message-markdown.js +99 -0
  544. package/dist/src/web-ui/app/lib/message-url-policy.d.ts +1 -0
  545. package/dist/src/web-ui/app/lib/message-url-policy.js +13 -0
  546. package/dist/src/web-ui/app/lib/schedule-errors.js +29 -0
  547. package/dist/src/web-ui/app/lib/schedule-message.js +30 -0
  548. package/dist/src/web-ui/app/lib/schedule-presentation.js +81 -0
  549. package/dist/src/web-ui/app/lib/session-read-state.d.ts +22 -0
  550. package/dist/src/web-ui/app/lib/session-read-state.js +63 -0
  551. package/dist/src/web-ui/app/lib/source-url-policy.d.ts +2 -0
  552. package/dist/src/web-ui/app/lib/source-url-policy.js +31 -0
  553. package/dist/src/web-ui/app/lib/task-progress.d.ts +53 -0
  554. package/dist/src/web-ui/app/lib/task-progress.js +233 -0
  555. package/dist/src/web-ui/app/lib/text-format.js +2 -143
  556. package/dist/src/web-ui/app/lib/tool-activity-event.d.ts +26 -0
  557. package/dist/src/web-ui/app/lib/tool-activity-event.js +228 -0
  558. package/dist/src/web-ui/app/lib/tool-activity-model.d.ts +41 -0
  559. package/dist/src/web-ui/app/lib/tool-activity-model.js +255 -0
  560. package/dist/src/web-ui/app/lib/tool-invocation-count.d.ts +5 -0
  561. package/dist/src/web-ui/app/lib/tool-invocation-count.js +21 -0
  562. package/dist/src/web-ui/app/lib/tool-timeline.d.ts +3 -0
  563. package/dist/src/web-ui/app/lib/tool-timeline.js +18 -0
  564. package/dist/src/web-ui/app/lib/web-source-event.d.ts +8 -0
  565. package/dist/src/web-ui/app/lib/web-source-event.js +21 -0
  566. package/dist/src/web-ui/app/lib/web-sources.d.ts +36 -0
  567. package/dist/src/web-ui/app/lib/web-sources.js +177 -0
  568. package/dist/src/web-ui/app/schedules-feature.js +87 -0
  569. package/dist/src/web-ui/app/services/message-link-preview-client.d.ts +14 -0
  570. package/dist/src/web-ui/app/services/message-link-preview-client.js +96 -0
  571. package/dist/src/web-ui/app/services/runtime-web-client/schedules.js +51 -0
  572. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +37 -0
  573. package/dist/src/web-ui/app/services/runtime-web-client.js +13 -8
  574. package/dist/src/web-ui/app/styles/00-tokens-base.css +15 -3
  575. package/dist/src/web-ui/app/styles/10-shell-sessions.css +24 -34
  576. package/dist/src/web-ui/app/styles/12-conversation-sidebar.css +93 -0
  577. package/dist/src/web-ui/app/styles/18-dashboard.css +384 -0
  578. package/dist/src/web-ui/app/styles/20-chat-composer.css +54 -600
  579. package/dist/src/web-ui/app/styles/21-composer-controls.css +368 -0
  580. package/dist/src/web-ui/app/styles/22-composer-context-window.css +90 -0
  581. package/dist/src/web-ui/app/styles/23-composer-plan.css +171 -0
  582. package/dist/src/web-ui/app/styles/24-conversation-role-cards.css +205 -0
  583. package/dist/src/web-ui/app/styles/25-conversation-sources.css +141 -0
  584. package/dist/src/web-ui/app/styles/26-message-content.css +295 -0
  585. package/dist/src/web-ui/app/styles/27-conversation-tools.css +266 -0
  586. package/dist/src/web-ui/app/styles/28-conversation-status.css +52 -0
  587. package/dist/src/web-ui/app/styles/30-inspector-config.css +21 -209
  588. package/dist/src/web-ui/app/styles/35-memory-onboarding.css +8 -8
  589. package/dist/src/web-ui/app/styles/36-memory-management.css +13 -13
  590. package/dist/src/web-ui/app/styles/37-config-operations.css +197 -0
  591. package/dist/src/web-ui/app/styles/38-schedule-workspace.css +263 -0
  592. package/dist/src/web-ui/app/styles/38-schedules.css +352 -0
  593. package/dist/src/web-ui/app/styles/40-config-workspace.css +36 -36
  594. package/dist/src/web-ui/app/styles/90-responsive.css +28 -77
  595. package/dist/src/web-ui/app/styles/91-schedules-responsive.css +72 -0
  596. package/dist/src/web-ui/app/styles/92-dashboard-responsive.css +88 -0
  597. package/dist/src/web-ui/app/styles/foundation.css +2 -2
  598. package/dist/src/web-ui/app/styles.css +15 -0
  599. package/dist/src/web-ui/app/ui-behavior.d.ts +1 -1
  600. package/dist/src/web-ui/app/ui-behavior.js +4 -2
  601. package/dist/src/web-ui/app/vendor/README.md +15 -0
  602. package/dist/src/web-ui/app/vendor/markdown-it.LICENSE +22 -0
  603. package/dist/src/web-ui/app/vendor/markdown-it.js +3003 -0
  604. package/dist/src/web-ui/link-preview/metadata.d.ts +9 -0
  605. package/dist/src/web-ui/link-preview/metadata.js +97 -0
  606. package/dist/src/web-ui/link-preview/preview-cache.d.ts +4 -0
  607. package/dist/src/web-ui/link-preview/preview-cache.js +23 -0
  608. package/dist/src/web-ui/link-preview/raster-response.d.ts +9 -0
  609. package/dist/src/web-ui/link-preview/raster-response.js +49 -0
  610. package/dist/src/web-ui/link-preview/routes.d.ts +3 -0
  611. package/dist/src/web-ui/link-preview/routes.js +97 -0
  612. package/dist/src/web-ui/link-preview/service.d.ts +11 -0
  613. package/dist/src/web-ui/link-preview/service.js +117 -0
  614. package/dist/src/web-ui/local-runtime/api-router.d.ts +4 -1
  615. package/dist/src/web-ui/local-runtime/api-router.js +42 -73
  616. package/dist/src/web-ui/local-runtime/contracts.d.ts +2 -2
  617. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +12 -1
  618. package/dist/src/web-ui/local-runtime/environment-registry.js +38 -3
  619. package/dist/src/web-ui/local-runtime/realtime-controller.js +3 -1
  620. package/dist/src/web-ui/local-runtime/request-execution.d.ts +5 -1
  621. package/dist/src/web-ui/local-runtime/request-execution.js +38 -2
  622. package/dist/src/web-ui/local-runtime/schedule-job-creation.d.ts +7 -0
  623. package/dist/src/web-ui/local-runtime/schedule-job-creation.js +62 -0
  624. package/dist/src/web-ui/local-runtime/schedule-management-routes.d.ts +30 -0
  625. package/dist/src/web-ui/local-runtime/schedule-management-routes.js +134 -0
  626. package/dist/src/web-ui/local-runtime/schedule-run-page.d.ts +5 -0
  627. package/dist/src/web-ui/local-runtime/schedule-run-page.js +23 -0
  628. package/dist/src/web-ui/local-runtime/session-routes.d.ts +17 -0
  629. package/dist/src/web-ui/local-runtime/session-routes.js +74 -0
  630. package/dist/src/web-ui/local-runtime-backend.d.ts +2 -0
  631. package/dist/src/web-ui/local-runtime-backend.js +11 -1
  632. package/dist/src/web-ui/schedule-creation-contract.d.ts +7 -0
  633. package/dist/src/web-ui/schedule-creation-contract.js +1 -0
  634. package/dist/src/web-ui/server-shutdown.d.ts +4 -0
  635. package/dist/src/web-ui/server-shutdown.js +32 -0
  636. package/dist/src/web-ui/server.js +13 -10
  637. package/dist/src/web-ui/session-read-state/availability.d.ts +16 -0
  638. package/dist/src/web-ui/session-read-state/availability.js +20 -0
  639. package/dist/src/web-ui/session-read-state/projection.d.ts +17 -0
  640. package/dist/src/web-ui/session-read-state/projection.js +71 -0
  641. package/dist/src/web-ui/session-read-state/service.d.ts +86 -0
  642. package/dist/src/web-ui/session-read-state/service.js +89 -0
  643. package/dist/src/web-ui/session-read-state/store.d.ts +22 -0
  644. package/dist/src/web-ui/session-read-state/store.js +110 -0
  645. package/docs/configuration.md +56 -9
  646. package/docs/installation.md +7 -4
  647. package/docs/known-limitations.md +21 -0
  648. package/docs/long-term-memory.md +46 -5
  649. package/docs/plugins.md +28 -13
  650. package/docs/runtime-invariant-coverage.md +18 -17
  651. package/docs/runtime-library.md +23 -0
  652. package/docs/runtime-prompt-policy-contracts.md +27 -17
  653. package/docs/runtime-public-contracts.md +32 -1
  654. package/package.json +6 -3
  655. package/plugins/capability-brief/source/index.ts +5 -48
  656. package/plugins/capability-brief/src/index.cjs +46 -33
  657. package/plugins/code-outline/plugin.json +15 -0
  658. package/plugins/document-reader/plugin.json +17 -0
  659. package/plugins/filesystem/plugin.json +17 -2
  660. package/plugins/json-inspector/plugin.json +12 -0
  661. package/plugins/local-search/plugin.json +12 -0
  662. package/plugins/memory/plugin.json +26 -1
  663. package/plugins/memory/source/index.ts +10 -6
  664. package/plugins/memory/src/index.cjs +11 -7
  665. package/plugins/project-orientation/plugin.json +14 -0
  666. package/plugins/system-probe/plugin.json +1 -0
  667. package/plugins/web/README.md +125 -0
  668. package/plugins/web/plugin.json +1 -1
  669. package/plugins/web/skills/web_fetch_skill/SKILL.md +2 -2
  670. package/plugins/web/skills/web_search_skill/SKILL.md +8 -4
  671. package/plugins/web/source/aggregate-gate.ts +8 -130
  672. package/plugins/web/source/deadline.ts +14 -50
  673. package/plugins/web/source/errors.ts +22 -12
  674. package/plugins/web/source/fetch-presentation.ts +61 -0
  675. package/plugins/web/source/fetch-service.ts +2 -31
  676. package/plugins/web/source/light/config.ts +196 -0
  677. package/plugins/web/source/light/crawl/origin-gate.ts +134 -0
  678. package/plugins/web/source/light/crawl/robots-cache.ts +71 -0
  679. package/plugins/web/source/light/crawl/robots-parser.ts +132 -0
  680. package/plugins/web/source/light/crawl/robots-policy.ts +154 -0
  681. package/plugins/web/source/light/crawl/session-budget.ts +141 -0
  682. package/plugins/web/source/light/crawl/transport.ts +216 -0
  683. package/plugins/web/source/light/discovery/candidate-values.ts +63 -0
  684. package/plugins/web/source/light/discovery/feed-document.ts +127 -0
  685. package/plugins/web/source/light/discovery/html-links.ts +80 -0
  686. package/plugins/web/source/light/discovery/html-robots-directives.ts +29 -0
  687. package/plugins/web/source/light/discovery/markup-tree.ts +145 -0
  688. package/plugins/web/source/light/discovery/origin-dates.ts +71 -0
  689. package/plugins/web/source/light/discovery/sitemap-document.ts +63 -0
  690. package/plugins/web/source/light/documents/cache-policy.ts +28 -0
  691. package/plugins/web/source/light/documents/document-cache.ts +99 -0
  692. package/plugins/web/source/light/documents/document-charset.ts +89 -0
  693. package/plugins/web/source/light/documents/document-contract.ts +20 -0
  694. package/plugins/web/source/light/documents/document-reader.ts +75 -0
  695. package/plugins/web/source/light/documents/extract-document.ts +124 -0
  696. package/plugins/web/source/light/documents/http-cache-freshness.ts +68 -0
  697. package/plugins/web/source/light/documents/response-decoding.ts +120 -0
  698. package/plugins/web/source/light/ranking/document-ranking.ts +114 -0
  699. package/plugins/web/source/light/ranking/query-normalization.ts +69 -0
  700. package/plugins/web/source/light/search-collection.ts +136 -0
  701. package/plugins/web/source/light/search-frontier.ts +246 -0
  702. package/plugins/web/source/light/search-metadata.ts +84 -0
  703. package/plugins/web/source/light/search-service.ts +154 -0
  704. package/plugins/web/source/light/search-unavailable.ts +33 -0
  705. package/plugins/web/source/light/sources/catalog.ts +312 -0
  706. package/plugins/web/source/light/sources/source-definition.ts +9 -0
  707. package/plugins/web/source/light/sources/source-selection.ts +35 -0
  708. package/plugins/web/source/limits.ts +3 -6
  709. package/plugins/web/source/network-policy.ts +28 -226
  710. package/plugins/web/source/plugin.ts +70 -56
  711. package/plugins/web/source/public-http.ts +17 -133
  712. package/plugins/web/source/request-hop.ts +11 -191
  713. package/plugins/web/source/search-presentation.ts +63 -63
  714. package/plugins/web/source/search-service-selector.ts +31 -0
  715. package/plugins/web/source/search-service.ts +6 -0
  716. package/plugins/web/source/search-source-presentation.ts +76 -0
  717. package/plugins/web/source/search-types.ts +4 -0
  718. package/plugins/web/source/source-output-receipts.ts +267 -0
  719. package/plugins/web/source/source-receipt-budget.ts +51 -0
  720. package/plugins/web/source/source-receipt-contract.ts +18 -0
  721. package/plugins/web/src/index.cjs +3289 -303
  722. package/runtime.config.schema.json +7 -0
  723. package/src/runtime/README.md +134 -9
  724. package/src/runtime/local-host/README.md +86 -0
  725. package/src/runtime/scheduler/README.md +166 -0
  726. package/dist/src/model-gateway/structured-output/budget.d.ts +0 -7
  727. package/dist/src/model-gateway/structured-output/budget.js +0 -20
  728. package/dist/src/model-gateway/structured-output/schema-character-estimator.d.ts +0 -1
  729. package/dist/src/model-gateway/structured-output/schema-character-estimator.js +0 -211
  730. package/dist/src/model-gateway/structured-output-budget.d.ts +0 -1
  731. package/dist/src/model-gateway/structured-output-budget.js +0 -1
@@ -339,6 +339,13 @@
339
339
  "properties": {
340
340
  "enabled": { "type": "boolean", "default": false },
341
341
  "emitClientEvents": { "type": "boolean", "default": false },
342
+ "maxRecallCallsPerRequest": {
343
+ "type": "integer",
344
+ "minimum": 1,
345
+ "maximum": 9007199254740991,
346
+ "default": 5,
347
+ "description": "Maximum explicit memory recall calls offered per request."
348
+ },
342
349
  "embeddingProfileId": {
343
350
  "type": "string",
344
351
  "minLength": 1,
@@ -46,6 +46,12 @@ The production path is:
46
46
  kernel establishes one immutable normalized working directory on the root
47
47
  call from the accepted Execution Agent decision; an explicit `null`
48
48
  selection resolves to `.`.
49
+ When long-term memory is enabled, either root contract may instead select
50
+ `recall_memory`. The kernel invokes the Runtime memory service directly,
51
+ commits a root-bound passive receipt, and resumes the same root under the
52
+ existing activation ceiling. Recall neither creates a child nor consumes a
53
+ capability execution. The bounded projection belongs only to the current
54
+ root steering version and is reused during terminal response authoring.
49
55
  6. Only the canonical root commits the root response. The selected contract
50
56
  may use its own presentation step, but the request finalizer, persistence,
51
57
  terminal observation, and completion path are shared.
@@ -112,10 +118,14 @@ isolation boundaries.
112
118
  directly and consumes their mechanically linked continuation before choosing
113
119
  its next action. It does not create a second root or state machine.
114
120
  - **Delegated Planner contract** coordinates one bounded delegated objective.
115
- It may invoke legal child roles and represents the completed sub-process to
116
- its caller. For a Worker child, it selects only the smallest complete set of
117
- offered catalog groups; the Worker still owns capability and control
118
- selection.
121
+ It declares every currently known execution outcome before its first child
122
+ dispatch. Each Worker invocation binds exactly one independently completable
123
+ production item; after consuming that bound result, a later activation may
124
+ select the next pending production item. Planner invokes only Worker and
125
+ represents the completed sub-process to Supervisor, which separately owns
126
+ Reviewer delegation and audit decisions. For a Worker child, Planner selects
127
+ only the smallest complete set of offered catalog groups; the Worker still
128
+ owns capability and control selection.
119
129
  - **Planner Graph advisory contract** may propose or decline one bounded
120
130
  dependency graph for the Execution Agent. It is a terminal passive child
121
131
  result: it cannot execute graph nodes, write canonical plan state, or commit
@@ -125,8 +135,9 @@ isolation boundaries.
125
135
  observation or effect is required. Its structured decision selects the
126
136
  action; substantive completion text is authored separately as raw text.
127
137
  - **Reviewer** independently assesses bounded supplied work in the delegated
128
- policy and returns a pass or gaps to its exact caller. It does not choose
129
- remediation or finalization.
138
+ policy and returns a human-readable summary plus a bounded, revision-bound
139
+ `reviewer_verdict_v1` receipt to its exact caller. The receipt is passive
140
+ canonical evidence; it does not choose remediation or finalization.
130
141
  - **Auditor** receives typed criteria and whole canonical evidence entries in
131
142
  the direct policy. It returns a passive pass/gaps advisory; omitted evidence
132
143
  makes pass unavailable and the root still owns the next action.
@@ -135,6 +146,14 @@ A Planner Graph or Auditor structured-output validation failure settles as a
135
146
  failed passive child result and returns to the root; it does not write plan
136
147
  state, authorize execution, or commit request failure by itself.
137
148
 
149
+ Under `supervisor-worker-v1`, every terminal Planner or Worker result receives a
150
+ runtime-owned `work_result_v1` receipt. Supervisor and Planner continuations
151
+ receive that compact receipt together with a verified `work_result_lineage_v1`
152
+ projection; an explicitly dependent Worker receives only the compact receipt.
153
+ These structures prove canonical provenance, not semantic correctness, and do
154
+ not grant response, remediation, or capability authority. Model-supplied work
155
+ receipts are rejected. `execution-agent-v1` does not issue them.
156
+
138
157
  Role choice belongs to the active role model. Runtime code validates the strict
139
158
  action envelope, exact caller, role availability, current ledger head, and
140
159
  global bounds; it does not infer work type from prompt text, paths, tool names,
@@ -142,14 +161,19 @@ or model prose.
142
161
 
143
162
  ## Canonical State
144
163
 
145
- `orchestration/role-calls/` is the sole writer of the request-local call tree
164
+ `orchestration/role-calls/` ledger v18 is the sole writer of the request-local call tree
146
165
  and role results. Each call frame records its caller, role, bounded objective,
147
166
  depth, status, result reference, and any canonical capability catalog-group
148
167
  scope. An authorized root, Planner, or Worker may also record one normalized
149
168
  working directory; the role-call reducer is the sole writer of that immutable
150
169
  scope. A Planner's Worker children inherit it mechanically and cannot replace
151
170
  it.
152
- A result returns only to that exact caller.
171
+ A result returns only to that exact caller. The ledger mechanically binds each
172
+ Supervisor-policy Planner or Worker result to its producer, caller, admitted
173
+ revision, and a lineage fingerprint. Full lineage is derived on demand from the
174
+ same ledger and verified against that fingerprint; it is not a second state
175
+ store and the compact receipt does not copy dependency, execution, or plan-item
176
+ lists.
153
177
 
154
178
  The same reducer enforces one mechanical per-call activation ceiling for every
155
179
  root and delegated call. The ceiling is derived from the existing request-wide
@@ -170,7 +194,10 @@ policy authority. The delegated Worker keeps its established assignment
170
194
  capsule; a direct root payload binds the exact request source, ordered steering,
171
195
  and immutable controls. Capability `intent` is bounded client-facing
172
196
  presentation metadata and is never projected as payload authority or execution
173
- evidence. There is no second payload or adapter pipeline for
197
+ evidence. Before Worker payload or result authoring, dependency results are
198
+ narrowed to their existing result fields and optional `semanticCheckpoints`;
199
+ work receipts and derived lineage do not cross either raw authoring boundary.
200
+ There is no second payload or adapter pipeline for
174
201
  `execution-agent-v1`.
175
202
 
176
203
  When direct capability controls refinement exhausts structured-output
@@ -429,6 +456,104 @@ terminal-text behavior.
429
456
 
430
457
  ## Public Package Boundary
431
458
 
459
+ ### Scheduler lifecycle
460
+
461
+ For installed clients, use `createLocalRuntimeApplication(config)` from
462
+ `@abot-ai/runtime/runtime`. It automatically attaches to or creates one local
463
+ environment owner. Web and Bridge use the same managed facade, so requests,
464
+ session deletion and scheduling share admission across processes. Start with
465
+ `await application.start()` and close with `await application.stop()`; closing
466
+ an attached client leaves the owner running. See
467
+ [local ownership and client lifecycle](local-host/README.md).
468
+
469
+ `createRuntimeApplication` composes one local scheduler and its management
470
+ capability. Call `await application.start()` to load persisted Jobs and begin
471
+ the clock, and `await application.stop()` when shutting down. The local Web
472
+ backend starts all configured environments without waiting for a browser visit.
473
+ Scheduling can also start lazily when its built-in capability is first invoked.
474
+ After shutdown, explicit application or compatibility-host startup can restart
475
+ the same scheduler. Lazy management cannot revive a stopped scheduler. New
476
+ subscribers belong to the restarted lifecycle; old run events cannot cross into
477
+ it, and interrupted work is never retried.
478
+
479
+ The compatibility `createDefaultRuntimeDependencies(config).host.start()` and
480
+ standalone default host also start their composed scheduler automatically. The
481
+ synchronous handle exposes optional `ready` for asynchronous startup and `stop`
482
+ for both scheduler and Bridge; host requests and optional steering await
483
+ readiness and reject after shutdown. Host adapter overrides that change execution
484
+ or storage rebuild the scheduling graph. An event-only override rebinds future
485
+ scheduled requests while preserving the existing scheduler, admission, session
486
+ guard and subscriptions; running requests keep their captured sink. Starting the
487
+ default host again restores its sink for future schedules. The default-adapters
488
+ facade delegates these
489
+ responsibilities to `runtime-environment`, `runtime-host-environment` and
490
+ `runtime-host-lifecycle`; caller-supplied stores and registries remain injected.
491
+
492
+ `application.services.scheduler` provides create/list/get/update/pause/resume/
493
+ cancel/runNow and run history. Model calls bind the current conversation and
494
+ model mechanically; the Web page selects an existing conversation and model.
495
+ Each scheduled run enters the ordinary request handler with FULL permissions,
496
+ its saved model, current canonical history, and one persisted trigger message.
497
+ The trigger's immutable `schedule` reference identifies the Job and Run; its
498
+ message content is the exact historical prompt. Provenance comes from an internal
499
+ scheduler option bound to the exact request and session, never from public
500
+ `run_request` fields. Supplied `schedule` fields do not mark ordinary requests as
501
+ scheduled. Scheduled events can be observed
502
+ through `application.subscribeScheduledEvents`. Consumers may supply
503
+ `scheduledRequestOptions` for the existing approval and steering controllers.
504
+ Scheduled terminal events are published once after the handler settles. Success
505
+ requires the correlated assistant reply in canonical session storage; missing or
506
+ failed persistence is published as failure instead of an earlier completion.
507
+
508
+ Session admission defers scheduled work while ordinary requests are active;
509
+ subsequent ordinary requests wait for a running scheduled reservation. Existing
510
+ ordinary-request concurrency is unchanged when no scheduled reservation exists.
511
+ The composed SessionStore facade serializes mutations and marks deletion intent
512
+ synchronously. It uses the injected backing store but intentionally does not
513
+ preserve that object's identity: all callers must use the composed facade for
514
+ deletion and request persistence to share the lifetime guard.
515
+
516
+ Session deletion keeps its tombstone even if backing deletion or cleanup fails.
517
+ A later explicit delete retries only failed listeners from the original deletion;
518
+ successful cleanup is not repeated and newly registered listeners are not
519
+ retroactive. Concurrent deletes share the cleanup attempt until all listeners
520
+ settle. Successful physical deletion retains its original result until cleanup
521
+ succeeds, so an explicit retry can finish consumer attachment cleanup. Both
522
+ delete APIs use the backing store's statistics operation; the boolean API projects
523
+ its `deleted` result. The receipt is delivered once, including across API variants.
524
+ Cleanup never revives the session or reruns scheduled work.
525
+
526
+ See [scheduler ownership and time rules](scheduler/README.md) for persistence,
527
+ offline behavior, cancellation, and local ownership locking. Stopping does not
528
+ drain active model requests or retry interrupted work. This lifecycle does not
529
+ start a separate model loop or alter the Supervisor/Worker/Execution Agent roles.
530
+
531
+ The conversation-scoped `schedules.list` tool returns at most 100 Jobs per page,
532
+ newest first, without their stored prompts. Pass `nextCursor` as `cursor` to
533
+ continue until it is null; `omittedCount` describes the entries after that page.
534
+ A stale cursor fails explicitly and requires listing from the beginning. This
535
+ passive listing never schedules or executes work; `get` resolves an exact Job ID.
536
+ `get` requests the latest 20 runs from storage before loading their payloads and
537
+ returns that bounded history in chronological order, without pruning older runs.
538
+
539
+ Creation is projected as six flat operations (`create_timer`, `create_once`,
540
+ `create_interval`, `create_daily`, `create_weekly`, `create_monthly`). Each fixes
541
+ the adapter's `action=create` and schedule kind mechanically and requires only
542
+ its relevant timing fields. Calendar variants require an explicit IANA time zone.
543
+ Missing required timing is rejected before dispatch; model and conversation
544
+ binding remain owned by the active request. Recurrence changes use six matching
545
+ `update_*` operations with complete required timing and fixed action/kind.
546
+ The plain `update` operation edits metadata while retaining the recurrence;
547
+ omitted time zone, model and mode retain their saved values. The scheduling tool
548
+ has 19 operations under the shared 32-operation contract limit. Other management
549
+ operations and the underlying scheduler service keep their existing contracts.
550
+
551
+ `SchedulerService.listRuns` preserves complete chronological results when no
552
+ query is supplied. Optional cursor/limit queries return bounded newest-first
553
+ records with an exact Job-scoped run cursor. The Web requests one lookahead
554
+ record before owner RPC serialization, returns 50 runs by default (maximum 100),
555
+ and preserves access to older full records.
556
+
432
557
  Stable public subpath exports are:
433
558
 
434
559
  - `@abot-ai/runtime/runtime`
@@ -0,0 +1,86 @@
1
+ # Local environment ownership
2
+
3
+ Installed applications use `createLocalRuntimeApplication(config)` from
4
+ `@abot-ai/runtime/runtime`, followed by `await application.start()` and
5
+ `await application.stop()` during shutdown. Web and Bridge use this managed
6
+ facade automatically. No manual port or Launcher setup is required.
7
+
8
+ `loadRuntimeConfig` gives named environments separate state namespaces when they
9
+ inherit a runtime base or share `LLM_RUNTIME_DIR`. The namespace uses only the
10
+ stable environment ID; owner attachment still checks the complete resolved
11
+ configuration. A changed model configuration therefore cannot create a second
12
+ owner over the same state. Explicit per-profile roots and the no-profile layout
13
+ remain unchanged. Populated legacy bases require an explicit assignment and
14
+ are never moved automatically; see [environment paths](../../../docs/configuration.md#environments).
15
+
16
+ A manually constructed `RuntimeConfig` supplies already-resolved final paths.
17
+ It is used unchanged by both managed and embedded factories. Such hosts must
18
+ provide distinct runtime, session, attachment and trace paths for distinct
19
+ environments, or use `loadRuntimeConfig` to resolve inherited bases consistently.
20
+
21
+ Use `application.requests.steer(requestId, update)` for the owner's canonical
22
+ steering acknowledgement. Request options may supply an initial steering prefix;
23
+ subsequent updates use the asynchronous method. The raw embedded factory keeps
24
+ its adapter injection semantics and must not be started over storage already
25
+ owned by a managed application.
26
+
27
+ The managed local entrypoints share one environment owner. The embedded
28
+ `createRuntimeApplication` remains the in-process core; this boundary transports
29
+ calls to that same core without moving orchestration or scheduling policy into
30
+ the transport.
31
+
32
+ `createLocalRuntimeConnection` accepts a private directory, resolved environment
33
+ identity and an owner factory. The first connection acquires the existing atomic
34
+ PID lock and invokes the factory once. It publishes an authenticated loopback
35
+ WebSocket endpoint on an ephemeral port. Later connections attach to that exact
36
+ owner and reject a different identity. Concurrent startup waits only for initial
37
+ endpoint establishment, with a bounded timeout. If the observed owner disappears
38
+ before the WebSocket handshake completes, startup returns to owner election
39
+ within that same deadline. Authentication, identity and private-access failures
40
+ remain terminal.
41
+
42
+ If initial startup fails before a connection is established, a later explicit
43
+ `start()` or service call can start a fresh connection attempt. Concurrent callers
44
+ share the current attempt. No attempt is repeated automatically, and an established
45
+ connection loss never reconnects or replays a request with an uncertain outcome.
46
+
47
+ The endpoint contains a random token and is private to the local user: Unix
48
+ directories/files use 0700/0600 and ownership checks; Windows directories are
49
+ prepared with a current-user ACL before an atomic installation, and directory
50
+ and endpoint ACLs are checked before reading credentials. Existing nonprivate
51
+ paths and symbolic links are rejected. There is no network listener beyond
52
+ 127.0.0.1 and no dependency on an external bridge.
53
+
54
+ The binary RPC protocol preserves canonical Date, Buffer and undefined values.
55
+ Errors preserve message, name and string code without copying remote stacks.
56
+ The application dispatcher owns its explicit method allowlist. Bidirectional
57
+ peer calls carry request events and approval/steering callbacks; broadcasts are
58
+ projections of owner events and do not create another state store.
59
+
60
+ An owner connection's `close()` stops intake and scheduling and closes its
61
+ transport without waiting for active model requests to drain. Queued ordinary
62
+ requests and requests still awaiting peer acceptance cannot start after this
63
+ boundary. The endpoint is removed immediately, but the owner's PID lease stays
64
+ held until in-flight RPC calls, ordinary requests and scheduled reservations
65
+ actually settle. A replacement managed owner can then start; shutdown never
66
+ replays interrupted work. A real process exit permits abandoned-PID recovery.
67
+ After intake closes, the canonical owner's synchronous activity and admission
68
+ snapshot identifies an already-idle owner. Its `close()` awaits the idle fence
69
+ and physical lease release before returning; active owners retire separately.
70
+ Physical release of this long-lived owner lease is synchronous once the idle
71
+ fence settles. Graceful `process.exit()` cannot interrupt removal between the
72
+ token marker and its empty directories, leaving a spurious incomplete lease.
73
+ Other file locks retain their existing asynchronous release behavior.
74
+ The embedded factory remains outside managed ownership and must not be started
75
+ over a managed environment's storage, including while its owner is retiring.
76
+ A client connection's `close()` only detaches that client.
77
+ Detached passive-memory saves retain their existing background queue and
78
+ independent repository locking; they are not part of request admission.
79
+ Both are idempotent. `onClose` fires on local closure or connection loss and fires
80
+ immediately when registered after loss. Pending calls reject on connection loss;
81
+ the transport never reconnects or replays an uncertain request. A later explicit
82
+ connection can acquire an abandoned PID lock and start a new application.
83
+
84
+ The application boundary must carry ordinary execution, session lifecycle and
85
+ scheduler operations together. A scheduler-only proxy cannot protect admission,
86
+ session deletion or canonical conversation persistence across processes.
@@ -0,0 +1,166 @@
1
+ # Local scheduler
2
+
3
+ This environment-owned service persists Jobs and run records independently of
4
+ Socket and plugins. It invokes an injected executor; that adapter must reserve
5
+ the same session admission boundary used by ordinary Runtime requests and submit
6
+ the saved prompt through the canonical request path.
7
+
8
+ ## Ownership and lifecycle
9
+
10
+ Call `start()` before management. Calls are serialized, so management queued after
11
+ `start()` waits for startup. Startup acquires one local process ownership lock for
12
+ the storage directory. A second owner fails with `scheduler_store_in_use`; it
13
+ must not start another clock or silently select a different store. This reuses
14
+ the existing atomic PID lock primitive. There is no multi-host lease protocol.
15
+
16
+ `stop()` invalidates preparations immediately and waits only for queued
17
+ preparation/storage work, not active requests. A generation guard prevents
18
+ asynchronous startup from reactivating a stopped service or old completions from
19
+ settling into a restarted generation. Startup marks previously running requests
20
+ `interrupted`, drops pending offline occurrences as `missed`, and advances active
21
+ Jobs to their next future occurrence. It never retries an interrupted or failed
22
+ request or backfills missed occurrences.
23
+
24
+ A session deletion reserves its start barrier synchronously, including while
25
+ startup is queued. Passing the running-state check confirms deletion; a rejected
26
+ lifecycle call releases only its own reservation. A storage failure after
27
+ acceptance keeps the deletion barrier; explicit deletion can finish cleanup
28
+ without admitting new runs for the deleted session.
29
+
30
+ Jobs and runs are stored in immutable transaction files selected by
31
+ `scheduler-journal.json`. Serialized commits use fsynced temporary files and
32
+ atomic rename. On POSIX, each rename is followed by a containing-directory fsync:
33
+ transaction and checkpoint entries are durable before the manifest is replaced,
34
+ and the manifest directory is synced before acknowledging a commit or retiring
35
+ old files. New generation/checkpoint directories are synced through their parents.
36
+ Owned acquisition validates the loaded head, then syncs its checkpoint directory,
37
+ generation directory, root path and ancestors before exposing the store or cleaning
38
+ the journal. This also establishes entries written by older versions and directories
39
+ left by interrupted initialization, without scanning historical transactions. POSIX
40
+ directory-open/sync errors propagate; ancestors must permit opening for sync.
41
+ Windows retains file sync and atomic replacement without a directory-fsync guarantee.
42
+
43
+ If the manifest replacement succeeds but its directory sync fails, the outcome
44
+ is uncertain. The owned store rejects further cached reads, writes and cleanup
45
+ until explicitly released and reacquired; it does not retry a mutation or dispatch
46
+ an unconfirmed claim. Both old and new files remain available. Reacquisition validates
47
+ and syncs the visible head and its directory dependencies before cleanup.
48
+ These barriers rely on the filesystem and device honoring fsync; they are not a
49
+ backup or repair mechanism for pre-existing corruption.
50
+
51
+ Normal ticks read Jobs and active runs and persist only changed
52
+ records; completed prompt/result payloads stay on disk. History queries select
53
+ run metadata before loading the requested payloads. History is never pruned.
54
+
55
+ The version 3 manifest records the committed transaction sequence and one
56
+ immutable checkpoint. Startup restores Jobs, active run payloads and compact
57
+ archived run metadata, then reads at most 256 exact transaction paths. It does
58
+ not enumerate the historical transaction directory or reread old prompt/result
59
+ payloads. The compact index still grows with the number of retained runs;
60
+ checkpoint loading and periodic index serialization therefore have metadata-sized
61
+ cost, while full historical payloads remain lazy.
62
+
63
+ A transaction becomes committed only after its durable file and the atomic
64
+ manifest replacement succeed. An unpublished tail is ignored on restart and
65
+ replaced by the next committed transaction at that sequence. Checkpoints are
66
+ published before the next logical mutation once the suffix reaches its bound;
67
+ checkpoint failure cannot turn an already committed mutation into a failure.
68
+ Only superseded or unpublished checkpoint artifacts are cleaned up at this
69
+ boundary. Archived transaction payloads stay available until explicit session
70
+ deletion. Concurrent unowned reads retry when a generation or checkpoint is
71
+ retired, while ordinary appends preserve the captured immutable snapshot.
72
+
73
+ The first owner migrates an existing `scheduler.json` without discarding history.
74
+ Existing version 2 journals replay once before publishing their initial version 3
75
+ checkpoint. A failed upgrade leaves the previous format authoritative; missing or
76
+ corrupt required version 3 files fail rather than falling back to replaying an
77
+ uncommitted tail. Older binaries that only support version 2 cannot open version 3.
78
+ Migration and deletion publish a complete new generation through one atomic
79
+ manifest replacement, then remove the superseded files. A failed cleanup remains
80
+ discoverable on the next owned operation. Concurrent reads cannot return partial
81
+ generations. Corrupt data is rejected, not silently reset. The public store's
82
+ default read/update view remains the complete snapshot; its optional `active`
83
+ view and `readRuns` path support efficient scheduler transactions and history.
84
+
85
+ If writing an executed run's terminal status fails, `run-completion.ts` retains
86
+ that captured outcome and its original completion time in the current service
87
+ generation. Each normal tick attempts those writes once before dispatching more
88
+ work; a failed terminal write does not prevent unrelated sessions from dispatching.
89
+ This only reconciles storage and never repeats the executor or model request.
90
+ Cancellation and pause preserve outcomes of already-started runs. Session deletion
91
+ or stop invalidates retained outcomes, and reconciliation never creates a missing
92
+ run. A process restart retains the existing `interrupted` recovery policy.
93
+
94
+ ## Time and admission
95
+
96
+ The schedule contract accepts typed timer, once, interval, daily, weekly, and
97
+ monthly forms. Calendar forms require an exact `HH:mm` time and an explicit IANA
98
+ time zone. Once timestamps require an explicit UTC offset. Timer and interval
99
+ durations use integer milliseconds of at least one second. The default first
100
+ interval occurrence is creation plus the interval, persisted as an explicit
101
+ anchor.
102
+
103
+ New and changed timers derive their deadline from the acceptance clock plus
104
+ `delayMs`. Timer `at` is stored metadata; caller-supplied `at` cannot replace the
105
+ deadline or bypass duration overflow checks. Reading or restarting a stored timer,
106
+ metadata edits and an exactly unchanged stored schedule preserve its deadline.
107
+
108
+ New intervals and interval reschedules require their first two future occurrences
109
+ to fit the canonical four-digit-year ISO range. Existing intervals remain
110
+ readable and complete when no later occurrence fits that range; one exhausted
111
+ interval cannot block another Job or startup recovery. The Web editor retains
112
+ the exact saved interval anchor when its displayed field is unchanged, including
113
+ seconds, milliseconds and the selected occurrence of a repeated local time.
114
+
115
+ Calendar conversion uses `Intl.DateTimeFormat` from the host's IANA time-zone data.
116
+ Missing wall times/days are skipped; repeated local times select their first
117
+ occurrence once. Intervals preserve elapsed-time cadence across DST.
118
+
119
+ An online late tick advances to the next future occurrence after creating at most
120
+ one pending occurrence per Job. A busy session leaves that occurrence pending.
121
+ If a manual run occupies that slot, the ordinary due time remains unchanged
122
+ until it can be recorded as scheduled work. Run now cannot consume an ordinary
123
+ occurrence, and additional due times still coalesce to one scheduled occurrence.
124
+ Cancellation, pause, update, and session deletion invalidate preparation before
125
+ any awaited work can cross the final synchronous start boundary. Cancellation or
126
+ session deletion never interrupts an already started request. Session deletion
127
+ removes its Jobs and run records; late completion cannot recreate them.
128
+ Pausing again cancels a pending manual run even when the Job is already paused.
129
+ It leaves an already-started run alone; a later explicit Run now is still allowed.
130
+
131
+ Run records keep immutable prompt, title, model profile, agent mode, time zone,
132
+ and Job revision snapshots. A non-timing edit replaces pending work with a fresh
133
+ snapshot while preserving its original due time and trigger. Timing edits
134
+ reschedule it; empty and identical edits preserve its identity. Already-started
135
+ and completed history is unchanged. Resume preserves manual pending work.
136
+ Time-zone edits reschedule only calendar forms. Timer, once, and interval forms
137
+ keep their due time and trigger while replacing pending snapshot metadata.
138
+
139
+ A failed session lookup fails only that occurrence, records its error without
140
+ retry, and allows other pending runs to dispatch. Future recurrences remain
141
+ active. A missing session still removes that session's Jobs and run records.
142
+
143
+ The Runtime adapter owns canonical session deletion checks and persistence guards.
144
+ Preventing late persistence alone is not sufficient: it must also reserve
145
+ admission and reject a deleted session before executing its request.
146
+
147
+ ## Source layout
148
+
149
+ - `contracts.ts`: public domain contracts.
150
+ - `scheduler-service.ts`, `service-context.ts`: lifecycle and serialized service.
151
+ - `job-management.ts`: CRUD and management state transitions.
152
+ - `scheduler-engine.ts`, `run-records.ts`, `startup-recovery.ts`: occurrence and
153
+ run lifecycle.
154
+ - `schedule-validation.ts`, `instant-validation.ts`, `validation-error.ts`:
155
+ typed input validation.
156
+ - `calendar-time.ts`, `next-occurrence.ts`: deterministic recurrence.
157
+ - `file-store.ts`: process ownership and serialized storage access.
158
+ - `journal-store.ts`, `journal-files.ts`: incremental commits and generation replacement.
159
+ - `journal-durability.ts`: ordered file/directory publication and uncertain-sync errors.
160
+ - `journal-index.ts`, `journal-transaction.ts`: indexed history and validated changes.
161
+ - `journal-head.ts`, `journal-checkpoint.ts`, `journal-index-state.ts`: committed
162
+ sequence, bounded startup replay and validated compact index persistence.
163
+ - `working-store.ts`, `snapshot-validation.ts`: active view and snapshot validation.
164
+
165
+ The model and Web layers share this service. Natural-language interpretation,
166
+ model choice, conversation projection, and UI rendering do not belong here.
@@ -1,7 +0,0 @@
1
- import type { ModelGatewayFormat, ModelTokenEstimationConfig } from "../types.js";
2
- /**
3
- * Estimates the generation allowance for the largest bounded JSON shape using
4
- * the selected profile's token estimator. Undefined means at least one output
5
- * shape has no finite schema bound, so the provider must use physical capacity.
6
- */
7
- export declare function estimateStrictStructuredOutputTokenCeiling(format: ModelGatewayFormat | undefined, tokenEstimation?: ModelTokenEstimationConfig): number | undefined;
@@ -1,20 +0,0 @@
1
- import { estimateAsciiCharacterTokens } from "../../runtime/context/token-estimator.js";
2
- import { isModelGatewayJsonSchemaFormat } from "./format-contract.js";
3
- import { estimateStrictSchemaCharacters } from "./schema-character-estimator.js";
4
- const JSON_TERMINATION_TOKEN_RESERVE = 1;
5
- /**
6
- * Estimates the generation allowance for the largest bounded JSON shape using
7
- * the selected profile's token estimator. Undefined means at least one output
8
- * shape has no finite schema bound, so the provider must use physical capacity.
9
- */
10
- export function estimateStrictStructuredOutputTokenCeiling(format, tokenEstimation) {
11
- if (!isModelGatewayJsonSchemaFormat(format) || format.strict !== true) {
12
- return undefined;
13
- }
14
- const maximumCharacters = estimateStrictSchemaCharacters(format.schema);
15
- if (maximumCharacters === undefined) {
16
- return undefined;
17
- }
18
- return Math.max(1, estimateAsciiCharacterTokens(maximumCharacters, tokenEstimation) +
19
- JSON_TERMINATION_TOKEN_RESERVE);
20
- }
@@ -1 +0,0 @@
1
- export declare function estimateStrictSchemaCharacters(schema: Readonly<Record<string, unknown>>): number | undefined;