@abot-ai/runtime 1.5.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1260) hide show
  1. package/README.md +2 -0
  2. package/dist/src/bridge/request-steering.js +60 -15
  3. package/dist/src/bridge/start-agent-bridge.js +22 -0
  4. package/dist/src/capabilities/normal-invocation/contracts.d.ts +14 -0
  5. package/dist/src/capabilities/normal-invocation/contracts.js +1 -0
  6. package/dist/src/capabilities/normal-invocation/output-channels.d.ts +10 -0
  7. package/dist/src/capabilities/normal-invocation/output-channels.js +29 -0
  8. package/dist/src/capabilities/normal-invocation/validator.js +42 -4
  9. package/dist/src/capabilities/result-budget.d.ts +17 -0
  10. package/dist/src/capabilities/result-budget.js +21 -0
  11. package/dist/src/capabilities/tool-context-text.d.ts +16 -0
  12. package/dist/src/capabilities/tool-context-text.js +30 -0
  13. package/dist/src/capabilities/tool-definition-validator/definition-parser.js +6 -0
  14. package/dist/src/capabilities/tool-definition-validator/event-input-text-options.js +3 -2
  15. package/dist/src/capabilities/tool-event-input-text.d.ts +1 -0
  16. package/dist/src/capabilities/tool-event-input-text.js +2 -1
  17. package/dist/src/capabilities/tool-executor.d.ts +3 -1
  18. package/dist/src/capabilities/tool-executor.js +29 -50
  19. package/dist/src/capabilities/tool-interruption.d.ts +3 -0
  20. package/dist/src/capabilities/tool-interruption.js +6 -0
  21. package/dist/src/capabilities/tool-result-normalization.d.ts +18 -0
  22. package/dist/src/capabilities/tool-result-normalization.js +68 -0
  23. package/dist/src/capabilities/tool-types.d.ts +25 -2
  24. package/dist/src/cli/host-companion-bundle.mjs +7623 -6572
  25. package/dist/src/cli/host-companion-entry.js +5 -22
  26. package/dist/src/cli/host-companion-input.d.ts +3 -0
  27. package/dist/src/cli/host-companion-input.js +21 -0
  28. package/dist/src/cli/host-companion-lifecycle.d.ts +11 -0
  29. package/dist/src/cli/host-companion-lifecycle.js +32 -0
  30. package/dist/src/cli/host-companion-setup-target.d.ts +4 -0
  31. package/dist/src/cli/host-companion-setup-target.js +17 -0
  32. package/dist/src/cli/host-companion-startup.d.ts +2 -0
  33. package/dist/src/cli/host-companion-startup.js +7 -2
  34. package/dist/src/cli/host-companion.d.ts +6 -0
  35. package/dist/src/cli/host-companion.js +36 -27
  36. package/dist/src/cli/host-permissions.d.ts +7 -0
  37. package/dist/src/cli/host-permissions.js +24 -0
  38. package/dist/src/cli/windows-companion-store-entry.d.ts +9 -0
  39. package/dist/src/cli/windows-companion-store-entry.js +67 -0
  40. package/dist/src/computer-access/command-output-capture.d.ts +37 -0
  41. package/dist/src/computer-access/command-output-capture.js +136 -0
  42. package/dist/src/computer-access/command-output-retention.d.ts +5 -0
  43. package/dist/src/computer-access/command-output-retention.js +90 -0
  44. package/dist/src/computer-access/command-output.d.ts +7 -0
  45. package/dist/src/computer-access/command-output.js +1 -0
  46. package/dist/src/computer-access/commands.d.ts +1 -0
  47. package/dist/src/computer-access/commands.js +1 -1
  48. package/dist/src/computer-access/companion/command-output-protocol.d.ts +12 -0
  49. package/dist/src/computer-access/companion/command-output-protocol.js +28 -0
  50. package/dist/src/computer-access/companion/command-output.d.ts +13 -0
  51. package/dist/src/computer-access/companion/command-output.js +110 -0
  52. package/dist/src/computer-access/companion/install-link-macos.d.ts +7 -0
  53. package/dist/src/computer-access/companion/install-link-macos.js +48 -0
  54. package/dist/src/computer-access/companion/install-link-registration.d.ts +4 -0
  55. package/dist/src/computer-access/companion/install-link-registration.js +184 -0
  56. package/dist/src/computer-access/companion/install-link-windows.d.ts +4 -0
  57. package/dist/src/computer-access/companion/install-link-windows.js +65 -0
  58. package/dist/src/computer-access/companion/install-link.d.ts +9 -0
  59. package/dist/src/computer-access/companion/install-link.js +54 -0
  60. package/dist/src/computer-access/companion/native-messages.js +4 -0
  61. package/dist/src/computer-access/companion/native-permissions.d.ts +14 -0
  62. package/dist/src/computer-access/companion/native-permissions.js +49 -0
  63. package/dist/src/computer-access/companion/native-session.d.ts +1 -0
  64. package/dist/src/computer-access/companion/native-session.js +18 -2
  65. package/dist/src/computer-access/companion/native-supervisor.js +1 -0
  66. package/dist/src/computer-access/companion/notification-installation.js +2 -15
  67. package/dist/src/computer-access/companion/notification-macos-bundle.d.ts +3 -0
  68. package/dist/src/computer-access/companion/notification-macos-bundle.js +84 -0
  69. package/dist/src/computer-access/companion/notification-macos.js +1 -1
  70. package/dist/src/computer-access/companion/notification-protocol.d.ts +1 -1
  71. package/dist/src/computer-access/companion/notification-protocol.js +20 -1
  72. package/dist/src/computer-access/companion/notification-readiness.js +2 -1
  73. package/dist/src/computer-access/companion/notification-windows.d.ts +1 -1
  74. package/dist/src/computer-access/companion/notification-windows.js +8 -3
  75. package/dist/src/computer-access/companion/permission-protocol.d.ts +22 -0
  76. package/dist/src/computer-access/companion/permission-protocol.js +45 -0
  77. package/dist/src/computer-access/companion/protocol.d.ts +2 -1
  78. package/dist/src/computer-access/companion/protocol.js +9 -0
  79. package/dist/src/computer-access/companion/release-version.d.ts +1 -1
  80. package/dist/src/computer-access/companion/release-version.js +1 -1
  81. package/dist/src/computer-access/companion/spark-notification-query.d.ts +2 -0
  82. package/dist/src/computer-access/companion/spark-notification-query.js +62 -0
  83. package/dist/src/computer-access/companion/windows-store/connection-error.d.ts +7 -0
  84. package/dist/src/computer-access/companion/windows-store/connection-error.js +19 -0
  85. package/dist/src/computer-access/companion/windows-store/connection-link.d.ts +13 -0
  86. package/dist/src/computer-access/companion/windows-store/connection-link.js +109 -0
  87. package/dist/src/computer-access/companion/windows-store/identity.d.ts +13 -0
  88. package/dist/src/computer-access/companion/windows-store/identity.js +13 -0
  89. package/dist/src/computer-access/companion/windows-store/lifecycle.d.ts +5 -0
  90. package/dist/src/computer-access/companion/windows-store/lifecycle.js +90 -0
  91. package/dist/src/computer-access/computer/macos-desktop.js +1 -1
  92. package/dist/src/computer-access/computer/macos-input.js +2 -5
  93. package/dist/src/computer-access/computer/macos-permission-helper.d.ts +4 -0
  94. package/dist/src/computer-access/computer/macos-permission-helper.js +38 -0
  95. package/dist/src/computer-access/contracts.d.ts +1 -1
  96. package/dist/src/computer-access/handlers.d.ts +2 -1
  97. package/dist/src/computer-access/handlers.js +5 -1
  98. package/dist/src/computer-access/host-observation.d.ts +3 -3
  99. package/dist/src/computer-access/native-permission-contract.d.ts +23 -0
  100. package/dist/src/computer-access/native-permission-contract.js +38 -0
  101. package/dist/src/computer-access/process-capture.d.ts +6 -0
  102. package/dist/src/computer-access/process-capture.js +1 -0
  103. package/dist/src/computer-access/process-result.d.ts +2 -0
  104. package/dist/src/computer-access/process-result.js +14 -6
  105. package/dist/src/computer-access/process-runner.d.ts +2 -1
  106. package/dist/src/computer-access/process-runner.js +21 -13
  107. package/dist/src/model-gateway/policy/invocation-policy.js +10 -1
  108. package/dist/src/model-gateway/providers/openai/payload.js +8 -0
  109. package/dist/src/model-gateway/server/configuration.d.ts +2 -0
  110. package/dist/src/model-gateway/server/configuration.js +73 -21
  111. package/dist/src/model-gateway/structured-output/ollama-format.js +5 -0
  112. package/dist/src/model-gateway/structured-output/openai-format.js +5 -0
  113. package/dist/src/model-gateway/types.d.ts +3 -0
  114. package/dist/src/plugin-contract/install-source.d.ts +13 -0
  115. package/dist/src/plugin-contract/install-source.js +99 -0
  116. package/dist/src/plugin-contract/manifest.d.ts +3 -1
  117. package/dist/src/plugin-sdk/computer-access.d.ts +8 -0
  118. package/dist/src/plugin-sdk/computer-access.js +5 -0
  119. package/dist/src/plugin-sdk/context-text-result.d.ts +10 -0
  120. package/dist/src/plugin-sdk/context-text-result.js +19 -0
  121. package/dist/src/plugin-sdk/index.d.ts +1 -0
  122. package/dist/src/plugin-sdk/index.js +1 -0
  123. package/dist/src/plugin-sdk/results.d.ts +7 -4
  124. package/dist/src/plugin-sdk/results.js +35 -10
  125. package/dist/src/runtime/adapters/co-worker-resources.d.ts +2 -0
  126. package/dist/src/runtime/adapters/co-worker-resources.js +2 -2
  127. package/dist/src/runtime/adapters/file-session-store.js +6 -0
  128. package/dist/src/runtime/adapters/in-memory-session-store.js +19 -16
  129. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.d.ts +2 -1
  130. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.js +5 -4
  131. package/dist/src/runtime/adapters/passive-learning-runtime.d.ts +2 -1
  132. package/dist/src/runtime/adapters/passive-learning-runtime.js +1 -1
  133. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/prepared-execution.js +77 -26
  134. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/result-budget.d.ts +11 -0
  135. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/result-budget.js +30 -0
  136. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +28 -1
  137. package/dist/src/runtime/adapters/registered-tool-payload-plan.d.ts +3 -3
  138. package/dist/src/runtime/adapters/registered-tool-payload-plan.js +4 -4
  139. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/contracts.d.ts +2 -0
  140. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-authoring-result.js +4 -18
  141. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/prepared-execution.js +3 -3
  142. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-envelope.d.ts +13 -0
  143. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-envelope.js +15 -0
  144. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-evidence.d.ts +3 -7
  145. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-evidence.js +6 -38
  146. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.d.ts +2 -1
  147. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.js +14 -6
  148. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-references.d.ts +9 -0
  149. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-references.js +29 -0
  150. package/dist/src/runtime/adapters/registered-tool-worker-capabilities.js +1 -0
  151. package/dist/src/runtime/adapters/scheduler-executor-dispatch.d.ts +11 -0
  152. package/dist/src/runtime/adapters/scheduler-executor-dispatch.js +10 -0
  153. package/dist/src/runtime/adapters/scheduler-runtime.d.ts +3 -1
  154. package/dist/src/runtime/adapters/scheduler-runtime.js +28 -12
  155. package/dist/src/runtime/admin/config-control.js +2 -1
  156. package/dist/src/runtime/automations/agent-assignment.d.ts +8 -0
  157. package/dist/src/runtime/automations/agent-assignment.js +29 -0
  158. package/dist/src/runtime/automations/agent-request-failure.d.ts +2 -0
  159. package/dist/src/runtime/automations/agent-request-failure.js +74 -0
  160. package/dist/src/runtime/automations/agent-session-lifetime.d.ts +11 -0
  161. package/dist/src/runtime/automations/agent-session-lifetime.js +46 -0
  162. package/dist/src/runtime/automations/agent-step-executor.d.ts +35 -0
  163. package/dist/src/runtime/automations/agent-step-executor.js +278 -0
  164. package/dist/src/runtime/automations/agent-tool-scope.d.ts +4 -0
  165. package/dist/src/runtime/automations/agent-tool-scope.js +73 -0
  166. package/dist/src/runtime/automations/archive-management.d.ts +26 -0
  167. package/dist/src/runtime/automations/archive-management.js +50 -0
  168. package/dist/src/runtime/automations/binding-resolution.d.ts +28 -0
  169. package/dist/src/runtime/automations/binding-resolution.js +115 -0
  170. package/dist/src/runtime/automations/branch-result-projection.d.ts +4 -0
  171. package/dist/src/runtime/automations/branch-result-projection.js +15 -0
  172. package/dist/src/runtime/automations/catalog.d.ts +79 -0
  173. package/dist/src/runtime/automations/catalog.js +68 -0
  174. package/dist/src/runtime/automations/definition-contracts.d.ts +128 -0
  175. package/dist/src/runtime/automations/definition-contracts.js +1 -0
  176. package/dist/src/runtime/automations/definition-input.d.ts +3 -0
  177. package/dist/src/runtime/automations/definition-input.js +283 -0
  178. package/dist/src/runtime/automations/dependency-fingerprint.d.ts +9 -0
  179. package/dist/src/runtime/automations/dependency-fingerprint.js +55 -0
  180. package/dist/src/runtime/automations/draft-batch-aliases.d.ts +12 -0
  181. package/dist/src/runtime/automations/draft-batch-aliases.js +94 -0
  182. package/dist/src/runtime/automations/draft-batch.d.ts +29 -0
  183. package/dist/src/runtime/automations/draft-batch.js +147 -0
  184. package/dist/src/runtime/automations/draft-management.d.ts +53 -0
  185. package/dist/src/runtime/automations/draft-management.js +164 -0
  186. package/dist/src/runtime/automations/draft-mutations.d.ts +29 -0
  187. package/dist/src/runtime/automations/draft-mutations.js +219 -0
  188. package/dist/src/runtime/automations/draft-restoration.d.ts +11 -0
  189. package/dist/src/runtime/automations/draft-restoration.js +44 -0
  190. package/dist/src/runtime/automations/effect-admission-lifetime.d.ts +9 -0
  191. package/dist/src/runtime/automations/effect-admission-lifetime.js +31 -0
  192. package/dist/src/runtime/automations/failure-policy.d.ts +8 -0
  193. package/dist/src/runtime/automations/failure-policy.js +9 -0
  194. package/dist/src/runtime/automations/graph-executor.d.ts +23 -0
  195. package/dist/src/runtime/automations/graph-executor.js +227 -0
  196. package/dist/src/runtime/automations/graph-validation.d.ts +29 -0
  197. package/dist/src/runtime/automations/graph-validation.js +271 -0
  198. package/dist/src/runtime/automations/input-batch-selection.d.ts +7 -0
  199. package/dist/src/runtime/automations/input-batch-selection.js +42 -0
  200. package/dist/src/runtime/automations/input-capacity.d.ts +9 -0
  201. package/dist/src/runtime/automations/input-capacity.js +38 -0
  202. package/dist/src/runtime/automations/input-ledger.d.ts +45 -0
  203. package/dist/src/runtime/automations/input-ledger.js +147 -0
  204. package/dist/src/runtime/automations/late-settlement.d.ts +9 -0
  205. package/dist/src/runtime/automations/late-settlement.js +42 -0
  206. package/dist/src/runtime/automations/limits.d.ts +25 -0
  207. package/dist/src/runtime/automations/limits.js +41 -0
  208. package/dist/src/runtime/automations/model-capacity.d.ts +9 -0
  209. package/dist/src/runtime/automations/model-capacity.js +67 -0
  210. package/dist/src/runtime/automations/model-dependency-projection.d.ts +58 -0
  211. package/dist/src/runtime/automations/model-dependency-projection.js +88 -0
  212. package/dist/src/runtime/automations/node-transactions.d.ts +57 -0
  213. package/dist/src/runtime/automations/node-transactions.js +223 -0
  214. package/dist/src/runtime/automations/occurrence-preparation.d.ts +12 -0
  215. package/dist/src/runtime/automations/occurrence-preparation.js +257 -0
  216. package/dist/src/runtime/automations/permission-grants.d.ts +27 -0
  217. package/dist/src/runtime/automations/permission-grants.js +72 -0
  218. package/dist/src/runtime/automations/persistence.d.ts +9 -0
  219. package/dist/src/runtime/automations/persistence.js +13 -0
  220. package/dist/src/runtime/automations/publication-validation.d.ts +16 -0
  221. package/dist/src/runtime/automations/publication-validation.js +162 -0
  222. package/dist/src/runtime/automations/publication.d.ts +33 -0
  223. package/dist/src/runtime/automations/publication.js +97 -0
  224. package/dist/src/runtime/automations/replay-preparation.d.ts +7 -0
  225. package/dist/src/runtime/automations/replay-preparation.js +59 -0
  226. package/dist/src/runtime/automations/result-capacity.d.ts +5 -0
  227. package/dist/src/runtime/automations/result-capacity.js +9 -0
  228. package/dist/src/runtime/automations/result-publication.d.ts +10 -0
  229. package/dist/src/runtime/automations/result-publication.js +21 -0
  230. package/dist/src/runtime/automations/result-store.d.ts +17 -0
  231. package/dist/src/runtime/automations/result-store.js +109 -0
  232. package/dist/src/runtime/automations/retention.d.ts +12 -0
  233. package/dist/src/runtime/automations/retention.js +134 -0
  234. package/dist/src/runtime/automations/run-file-binding.d.ts +3 -0
  235. package/dist/src/runtime/automations/run-file-binding.js +19 -0
  236. package/dist/src/runtime/automations/run-output-summary.d.ts +25 -0
  237. package/dist/src/runtime/automations/run-output-summary.js +54 -0
  238. package/dist/src/runtime/automations/run-report.d.ts +83 -0
  239. package/dist/src/runtime/automations/run-report.js +121 -0
  240. package/dist/src/runtime/automations/runtime-executor.d.ts +16 -0
  241. package/dist/src/runtime/automations/runtime-executor.js +260 -0
  242. package/dist/src/runtime/automations/saved-agent-management.d.ts +16 -0
  243. package/dist/src/runtime/automations/saved-agent-management.js +94 -0
  244. package/dist/src/runtime/automations/service.d.ts +288 -0
  245. package/dist/src/runtime/automations/service.js +330 -0
  246. package/dist/src/runtime/automations/snapshot-staging.d.ts +13 -0
  247. package/dist/src/runtime/automations/snapshot-staging.js +126 -0
  248. package/dist/src/runtime/automations/source-attachment-access.d.ts +23 -0
  249. package/dist/src/runtime/automations/source-attachment-access.js +70 -0
  250. package/dist/src/runtime/automations/source-discovery.d.ts +25 -0
  251. package/dist/src/runtime/automations/source-discovery.js +179 -0
  252. package/dist/src/runtime/automations/starter-template-builder.d.ts +5 -0
  253. package/dist/src/runtime/automations/starter-template-builder.js +78 -0
  254. package/dist/src/runtime/automations/starter-template-contracts.d.ts +42 -0
  255. package/dist/src/runtime/automations/starter-template-contracts.js +1 -0
  256. package/dist/src/runtime/automations/starter-template-definitions.d.ts +3 -0
  257. package/dist/src/runtime/automations/starter-template-definitions.js +100 -0
  258. package/dist/src/runtime/automations/starter-template-showcases.d.ts +3 -0
  259. package/dist/src/runtime/automations/starter-template-showcases.js +154 -0
  260. package/dist/src/runtime/automations/starter-template-structure.d.ts +4 -0
  261. package/dist/src/runtime/automations/starter-template-structure.js +11 -0
  262. package/dist/src/runtime/automations/starter-templates.d.ts +20 -0
  263. package/dist/src/runtime/automations/starter-templates.js +75 -0
  264. package/dist/src/runtime/automations/step-evidence-effects.d.ts +46 -0
  265. package/dist/src/runtime/automations/step-evidence-effects.js +173 -0
  266. package/dist/src/runtime/automations/step-evidence-inputs.d.ts +22 -0
  267. package/dist/src/runtime/automations/step-evidence-inputs.js +105 -0
  268. package/dist/src/runtime/automations/step-evidence-output.d.ts +17 -0
  269. package/dist/src/runtime/automations/step-evidence-output.js +43 -0
  270. package/dist/src/runtime/automations/step-evidence.d.ts +24 -0
  271. package/dist/src/runtime/automations/step-evidence.js +53 -0
  272. package/dist/src/runtime/automations/step-interruption.d.ts +3 -0
  273. package/dist/src/runtime/automations/step-interruption.js +26 -0
  274. package/dist/src/runtime/automations/step-runner.d.ts +57 -0
  275. package/dist/src/runtime/automations/step-runner.js +278 -0
  276. package/dist/src/runtime/automations/storage-records.d.ts +133 -0
  277. package/dist/src/runtime/automations/storage-records.js +286 -0
  278. package/dist/src/runtime/automations/terminal-admission-receipt.d.ts +12 -0
  279. package/dist/src/runtime/automations/terminal-admission-receipt.js +39 -0
  280. package/dist/src/runtime/automations/tool-lifetimes.d.ts +13 -0
  281. package/dist/src/runtime/automations/tool-lifetimes.js +56 -0
  282. package/dist/src/runtime/automations/tool-step-executor.d.ts +32 -0
  283. package/dist/src/runtime/automations/tool-step-executor.js +136 -0
  284. package/dist/src/runtime/automations/tool-step-outcome.d.ts +24 -0
  285. package/dist/src/runtime/automations/tool-step-outcome.js +32 -0
  286. package/dist/src/runtime/automations/trigger-schedule.d.ts +7 -0
  287. package/dist/src/runtime/automations/trigger-schedule.js +19 -0
  288. package/dist/src/runtime/automations/working-directory.d.ts +3 -0
  289. package/dist/src/runtime/automations/working-directory.js +13 -0
  290. package/dist/src/runtime/capabilities/automation-builder/authoring-reference.d.ts +427 -0
  291. package/dist/src/runtime/capabilities/automation-builder/authoring-reference.js +131 -0
  292. package/dist/src/runtime/capabilities/automation-builder/creation-recipe.d.ts +9 -0
  293. package/dist/src/runtime/capabilities/automation-builder/creation-recipe.js +155 -0
  294. package/dist/src/runtime/capabilities/automation-builder/payload-instructions.d.ts +6 -0
  295. package/dist/src/runtime/capabilities/automation-builder/payload-instructions.js +6 -0
  296. package/dist/src/runtime/capabilities/automation-builder/payload-schema.d.ts +3 -0
  297. package/dist/src/runtime/capabilities/automation-builder/payload-schema.js +105 -0
  298. package/dist/src/runtime/capabilities/automation-builder/tool-contract.d.ts +65 -0
  299. package/dist/src/runtime/capabilities/automation-builder/tool-contract.js +27 -0
  300. package/dist/src/runtime/capabilities/automation-builder/tool-module.d.ts +4 -0
  301. package/dist/src/runtime/capabilities/automation-builder/tool-module.js +108 -0
  302. package/dist/src/runtime/capabilities/automations/authoring-catalog-contract.d.ts +78 -0
  303. package/dist/src/runtime/capabilities/automations/authoring-catalog-contract.js +28 -0
  304. package/dist/src/runtime/capabilities/automations/authoring-catalog.d.ts +320 -0
  305. package/dist/src/runtime/capabilities/automations/authoring-catalog.js +158 -0
  306. package/dist/src/runtime/capabilities/automations/authoring-input-contracts.d.ts +140 -0
  307. package/dist/src/runtime/capabilities/automations/authoring-input-contracts.js +36 -0
  308. package/dist/src/runtime/capabilities/automations/authoring-inputs.d.ts +9 -0
  309. package/dist/src/runtime/capabilities/automations/authoring-inputs.js +86 -0
  310. package/dist/src/runtime/capabilities/automations/authoring-preparation-limits.d.ts +5 -0
  311. package/dist/src/runtime/capabilities/automations/authoring-preparation-limits.js +5 -0
  312. package/dist/src/runtime/capabilities/automations/authoring-preparation.d.ts +489 -0
  313. package/dist/src/runtime/capabilities/automations/authoring-preparation.js +51 -0
  314. package/dist/src/runtime/capabilities/automations/draft-index.d.ts +14 -0
  315. package/dist/src/runtime/capabilities/automations/draft-index.js +26 -0
  316. package/dist/src/runtime/capabilities/automations/draft-operation-refs.d.ts +11 -0
  317. package/dist/src/runtime/capabilities/automations/draft-operation-refs.js +37 -0
  318. package/dist/src/runtime/capabilities/automations/draft-receipt-admission.d.ts +24 -0
  319. package/dist/src/runtime/capabilities/automations/draft-receipt-admission.js +36 -0
  320. package/dist/src/runtime/capabilities/automations/event-presentation.d.ts +3 -0
  321. package/dist/src/runtime/capabilities/automations/event-presentation.js +18 -0
  322. package/dist/src/runtime/capabilities/automations/model-tool-contract.d.ts +3 -0
  323. package/dist/src/runtime/capabilities/automations/model-tool-contract.js +34 -0
  324. package/dist/src/runtime/capabilities/automations/tool-contract.d.ts +3 -0
  325. package/dist/src/runtime/capabilities/automations/tool-contract.js +65 -0
  326. package/dist/src/runtime/capabilities/automations/tool-module.d.ts +4 -0
  327. package/dist/src/runtime/capabilities/automations/tool-module.js +286 -0
  328. package/dist/src/runtime/capabilities/request-permission-catalog.d.ts +3 -1
  329. package/dist/src/runtime/capabilities/request-permission-catalog.js +21 -2
  330. package/dist/src/runtime/capabilities/request-permission-tool-registry.d.ts +2 -1
  331. package/dist/src/runtime/capabilities/request-permission-tool-registry.js +18 -10
  332. package/dist/src/runtime/capabilities/request-runtime-tool-registry.d.ts +2 -0
  333. package/dist/src/runtime/capabilities/request-runtime-tool-registry.js +1 -1
  334. package/dist/src/runtime/capabilities/runtime-path-namespace.d.ts +6 -0
  335. package/dist/src/runtime/capabilities/runtime-path-namespace.js +48 -0
  336. package/dist/src/runtime/capabilities/runtime-target-path.d.ts +1 -0
  337. package/dist/src/runtime/capabilities/runtime-target-path.js +16 -8
  338. package/dist/src/runtime/capabilities/scheduling/create-operations.d.ts +12 -0
  339. package/dist/src/runtime/capabilities/scheduling/job-list-page.d.ts +4 -1
  340. package/dist/src/runtime/composition.d.ts +5 -2
  341. package/dist/src/runtime/config/builders.js +6 -5
  342. package/dist/src/runtime/config/effective-model-config-validation.js +4 -35
  343. package/dist/src/runtime/config/fields.js +15 -0
  344. package/dist/src/runtime/config/model-context-capacity.d.ts +20 -0
  345. package/dist/src/runtime/config/model-context-capacity.js +55 -0
  346. package/dist/src/runtime/config/model-execution-policy.d.ts +5 -1
  347. package/dist/src/runtime/config/model-execution-policy.js +16 -0
  348. package/dist/src/runtime/config/model-plugin-config.d.ts +8 -0
  349. package/dist/src/runtime/config/model-plugin-config.js +40 -0
  350. package/dist/src/runtime/config/schema.js +5 -1
  351. package/dist/src/runtime/config/validation/model-profile-validation.js +2 -0
  352. package/dist/src/runtime/config/validation/runtime-config-validation-contract.d.ts +3 -1
  353. package/dist/src/runtime/config/validation/runtime-config-validation-contract.js +3 -1
  354. package/dist/src/runtime/config/validation/runtime-root-section-validation.js +11 -4
  355. package/dist/src/runtime/config/validation/web-ui-config-validation.js +3 -2
  356. package/dist/src/runtime/config/web-ui.d.ts +5 -0
  357. package/dist/src/runtime/config/web-ui.js +5 -0
  358. package/dist/src/runtime/config.js +2 -0
  359. package/dist/src/runtime/context/canonical-capability-result.d.ts +4 -0
  360. package/dist/src/runtime/context/canonical-capability-result.js +80 -0
  361. package/dist/src/runtime/context/capability-brief-readmission.js +2 -5
  362. package/dist/src/runtime/context/capability-result-compaction-source.d.ts +12 -0
  363. package/dist/src/runtime/context/capability-result-compaction-source.js +61 -0
  364. package/dist/src/runtime/context/compacted-capability-result-receipt.d.ts +7 -0
  365. package/dist/src/runtime/context/compacted-capability-result-receipt.js +29 -0
  366. package/dist/src/runtime/context/compaction-source-invariant.d.ts +6 -0
  367. package/dist/src/runtime/context/compaction-source-invariant.js +12 -0
  368. package/dist/src/runtime/context/execution-compacted-evidence.d.ts +29 -0
  369. package/dist/src/runtime/context/execution-compacted-evidence.js +87 -0
  370. package/dist/src/runtime/context/execution-compaction-objective.d.ts +11 -0
  371. package/dist/src/runtime/context/execution-compaction-objective.js +12 -0
  372. package/dist/src/runtime/context/model-step-compaction.d.ts +9 -0
  373. package/dist/src/runtime/context/model-step-compaction.js +115 -128
  374. package/dist/src/runtime/context/operation-supervision-compacted-evidence.d.ts +37 -0
  375. package/dist/src/runtime/context/operation-supervision-compacted-evidence.js +69 -0
  376. package/dist/src/runtime/context/operation-supervision-evidence-binding.d.ts +29 -0
  377. package/dist/src/runtime/context/operation-supervision-evidence-binding.js +66 -0
  378. package/dist/src/runtime/context/operation-supervision-evidence-projection.d.ts +5 -0
  379. package/dist/src/runtime/context/operation-supervision-evidence-projection.js +133 -0
  380. package/dist/src/runtime/context/operation-supervision-evidence.d.ts +2 -1
  381. package/dist/src/runtime/context/operation-supervision-evidence.js +38 -37
  382. package/dist/src/runtime/context/request-tool-results-checkpoint.d.ts +3 -0
  383. package/dist/src/runtime/context/request-tool-results-checkpoint.js +126 -0
  384. package/dist/src/runtime/context/request-tool-results-message-binding.d.ts +1 -0
  385. package/dist/src/runtime/context/request-tool-results-message-binding.js +10 -0
  386. package/dist/src/runtime/context/request-tool-results-supersession.d.ts +9 -0
  387. package/dist/src/runtime/context/request-tool-results-supersession.js +78 -0
  388. package/dist/src/runtime/context/request-tool-results.d.ts +3 -9
  389. package/dist/src/runtime/context/request-tool-results.js +15 -181
  390. package/dist/src/runtime/context/runtime-filesystem-scope.d.ts +21 -0
  391. package/dist/src/runtime/context/runtime-filesystem-scope.js +51 -0
  392. package/dist/src/runtime/context/semantic-compaction/checkpoint-message.d.ts +3 -0
  393. package/dist/src/runtime/context/semantic-compaction/checkpoint-message.js +22 -0
  394. package/dist/src/runtime/context/semantic-compaction/contracts.d.ts +0 -3
  395. package/dist/src/runtime/context/semantic-compaction/contracts.js +9 -20
  396. package/dist/src/runtime/context/semantic-compaction/dependency-results.js +15 -1
  397. package/dist/src/runtime/context/semantic-compaction/evidence-scope.d.ts +7 -0
  398. package/dist/src/runtime/context/semantic-compaction/evidence-scope.js +7 -0
  399. package/dist/src/runtime/context/semantic-compaction/format.d.ts +2 -1
  400. package/dist/src/runtime/context/semantic-compaction/format.js +27 -19
  401. package/dist/src/runtime/context/semantic-compaction/generation-contracts.d.ts +18 -0
  402. package/dist/src/runtime/context/semantic-compaction/generation-contracts.js +1 -0
  403. package/dist/src/runtime/context/semantic-compaction/generation-input.d.ts +11 -0
  404. package/dist/src/runtime/context/semantic-compaction/generation-input.js +74 -0
  405. package/dist/src/runtime/context/semantic-compaction/generation-source-registration.d.ts +3 -0
  406. package/dist/src/runtime/context/semantic-compaction/generation-source-registration.js +12 -0
  407. package/dist/src/runtime/context/semantic-compaction/output-validation.d.ts +10 -0
  408. package/dist/src/runtime/context/semantic-compaction/output-validation.js +75 -0
  409. package/dist/src/runtime/context/semantic-compaction/parser.d.ts +2 -2
  410. package/dist/src/runtime/context/semantic-compaction/parser.js +13 -26
  411. package/dist/src/runtime/context/semantic-compaction/prompt.js +18 -5
  412. package/dist/src/runtime/context/semantic-compaction/repair-headroom.d.ts +4 -3
  413. package/dist/src/runtime/context/semantic-compaction/repair-headroom.js +10 -4
  414. package/dist/src/runtime/context/semantic-compaction/replacement-budget.d.ts +25 -0
  415. package/dist/src/runtime/context/semantic-compaction/replacement-budget.js +55 -0
  416. package/dist/src/runtime/context/semantic-compaction/run.d.ts +3 -14
  417. package/dist/src/runtime/context/semantic-compaction/run.js +27 -186
  418. package/dist/src/runtime/context/semantic-compaction/scope-quarantine.d.ts +17 -0
  419. package/dist/src/runtime/context/semantic-compaction/scope-quarantine.js +37 -0
  420. package/dist/src/runtime/context/semantic-compaction/snapshot.d.ts +5 -1
  421. package/dist/src/runtime/context/semantic-compaction/snapshot.js +10 -2
  422. package/dist/src/runtime/context/semantic-compaction/source-registration.d.ts +3 -0
  423. package/dist/src/runtime/context/semantic-compaction/source-registration.js +34 -0
  424. package/dist/src/runtime/context/semantic-compaction/source-slots.d.ts +5 -0
  425. package/dist/src/runtime/context/semantic-compaction/source-slots.js +4 -0
  426. package/dist/src/runtime/context/semantic-compaction/store.d.ts +6 -1
  427. package/dist/src/runtime/context/semantic-compaction/store.js +54 -9
  428. package/dist/src/runtime/context/semantic-compaction/super-child-result-source.d.ts +8 -0
  429. package/dist/src/runtime/context/semantic-compaction/super-child-result-source.js +50 -0
  430. package/dist/src/runtime/context/semantic-compaction/super-operation-source.d.ts +8 -0
  431. package/dist/src/runtime/context/semantic-compaction/super-operation-source.js +99 -0
  432. package/dist/src/runtime/context/semantic-compaction/super-reviewer-source.d.ts +16 -0
  433. package/dist/src/runtime/context/semantic-compaction/super-reviewer-source.js +37 -0
  434. package/dist/src/runtime/context/semantic-compaction/super-source-integrity.d.ts +21 -0
  435. package/dist/src/runtime/context/semantic-compaction/super-source-integrity.js +169 -0
  436. package/dist/src/runtime/context/semantic-compaction/super-source-message.d.ts +4 -0
  437. package/dist/src/runtime/context/semantic-compaction/super-source-message.js +23 -0
  438. package/dist/src/runtime/context/session-memory/model-step-controller.js +34 -20
  439. package/dist/src/runtime/context/session-memory/selection.js +0 -2
  440. package/dist/src/runtime/context/spark-conversation-policy.d.ts +4 -0
  441. package/dist/src/runtime/context/spark-conversation-policy.js +16 -0
  442. package/dist/src/runtime/context/super-compaction-failure-owner.d.ts +10 -0
  443. package/dist/src/runtime/context/super-compaction-failure-owner.js +64 -0
  444. package/dist/src/runtime/context/super-context-failure.d.ts +28 -0
  445. package/dist/src/runtime/context/super-context-failure.js +37 -0
  446. package/dist/src/runtime/context/super-context-policy.d.ts +3 -0
  447. package/dist/src/runtime/context/super-context-policy.js +35 -0
  448. package/dist/src/runtime/context/super-request-tool-results-checkpoint.d.ts +6 -0
  449. package/dist/src/runtime/context/super-request-tool-results-checkpoint.js +29 -0
  450. package/dist/src/runtime/context/super-worker-compaction-failure.d.ts +5 -0
  451. package/dist/src/runtime/context/super-worker-compaction-failure.js +19 -0
  452. package/dist/src/runtime/context/super-worker-compaction-projection.d.ts +8 -0
  453. package/dist/src/runtime/context/super-worker-compaction-projection.js +41 -0
  454. package/dist/src/runtime/context/super-worker-compaction-sidecar.d.ts +21 -0
  455. package/dist/src/runtime/context/super-worker-compaction-sidecar.js +67 -0
  456. package/dist/src/runtime/context/verified-compaction-projection.d.ts +7 -0
  457. package/dist/src/runtime/context/verified-compaction-projection.js +16 -0
  458. package/dist/src/runtime/default-environment-adapters.d.ts +4 -0
  459. package/dist/src/runtime/default-environment-adapters.js +7 -1
  460. package/dist/src/runtime/local-application.d.ts +279 -0
  461. package/dist/src/runtime/local-application.js +7 -0
  462. package/dist/src/runtime/local-host/app-learning-dispatch.js +0 -8
  463. package/dist/src/runtime/local-host/app-native-permissions.d.ts +20 -0
  464. package/dist/src/runtime/local-host/app-native-permissions.js +76 -0
  465. package/dist/src/runtime/local-host/app-owner.js +59 -4
  466. package/dist/src/runtime/local-host/app-request-control.d.ts +4 -1
  467. package/dist/src/runtime/local-host/app-request-control.js +96 -11
  468. package/dist/src/runtime/local-host/app-service-dispatch.d.ts +2 -1
  469. package/dist/src/runtime/local-host/app-service-dispatch.js +31 -0
  470. package/dist/src/runtime/local-host/client-learning.d.ts +1 -1
  471. package/dist/src/runtime/local-host/client-learning.js +0 -1
  472. package/dist/src/runtime/local-host/client-native-permissions.d.ts +4 -0
  473. package/dist/src/runtime/local-host/client-native-permissions.js +37 -0
  474. package/dist/src/runtime/local-host/client-requests.js +32 -5
  475. package/dist/src/runtime/local-host/client-services.d.ts +275 -0
  476. package/dist/src/runtime/local-host/client-services.js +3 -2
  477. package/dist/src/runtime/local-host/learning-preferences-input.js +1 -0
  478. package/dist/src/runtime/local-host/local-request-diagnostics.d.ts +9 -0
  479. package/dist/src/runtime/local-host/local-request-diagnostics.js +47 -0
  480. package/dist/src/runtime/local-host/saved-approvals.js +23 -2
  481. package/dist/src/runtime/model/context-compaction-admission.d.ts +21 -0
  482. package/dist/src/runtime/model/context-compaction-admission.js +214 -0
  483. package/dist/src/runtime/model/context-compaction-contracts.d.ts +32 -0
  484. package/dist/src/runtime/model/context-compaction-contracts.js +1 -0
  485. package/dist/src/runtime/model/context-compaction-diagnostics.d.ts +33 -0
  486. package/dist/src/runtime/model/context-compaction-diagnostics.js +97 -0
  487. package/dist/src/runtime/model/context-compaction-stage-plan.d.ts +3 -0
  488. package/dist/src/runtime/model/context-compaction-stage-plan.js +28 -0
  489. package/dist/src/runtime/model/input-token-count.d.ts +1 -0
  490. package/dist/src/runtime/model/input-token-count.js +4 -1
  491. package/dist/src/runtime/model/invoke-step.js +80 -126
  492. package/dist/src/runtime/model/invoke-structured-step.d.ts +1 -1
  493. package/dist/src/runtime/model/invoke-structured-step.js +3 -2
  494. package/dist/src/runtime/model/model-context-assessment.d.ts +17 -0
  495. package/dist/src/runtime/model/model-context-assessment.js +51 -0
  496. package/dist/src/runtime/model/model-context-budget.js +1 -0
  497. package/dist/src/runtime/model/model-selection.js +4 -1
  498. package/dist/src/runtime/model/model-step-acceptance.d.ts +4 -0
  499. package/dist/src/runtime/model/model-step-acceptance.js +28 -0
  500. package/dist/src/runtime/model/model-step-port.d.ts +4 -15
  501. package/dist/src/runtime/model/model-step-steering.d.ts +14 -1
  502. package/dist/src/runtime/model/model-step-steering.js +23 -0
  503. package/dist/src/runtime/observability/request-control-diagnostics.d.ts +6 -0
  504. package/dist/src/runtime/observability/request-control-diagnostics.js +52 -0
  505. package/dist/src/runtime/orchestration/capability-adapters/result.d.ts +4 -1
  506. package/dist/src/runtime/orchestration/capability-adapters/result.js +11 -7
  507. package/dist/src/runtime/orchestration/role-calls/child-return.d.ts +5 -1
  508. package/dist/src/runtime/orchestration/role-calls/child-return.js +2 -2
  509. package/dist/src/runtime/orchestration/worker-capabilities/binding/invocation-preparation.js +1 -8
  510. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +3 -4
  511. package/dist/src/runtime/orchestration/worker-capabilities/contracts.js +1 -1
  512. package/dist/src/runtime/orchestration/worker-capabilities/execution/context-projection.js +2 -1
  513. package/dist/src/runtime/orchestration/worker-capabilities/payload-assignment-validation.js +9 -9
  514. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.js +9 -33
  515. package/dist/src/runtime/orchestration/worker-capabilities/payload-body-normalization.d.ts +12 -0
  516. package/dist/src/runtime/orchestration/worker-capabilities/payload-body-normalization.js +80 -0
  517. package/dist/src/runtime/orchestration/worker-capabilities/payload-compaction-transport.d.ts +3 -0
  518. package/dist/src/runtime/orchestration/worker-capabilities/payload-compaction-transport.js +14 -0
  519. package/dist/src/runtime/orchestration/worker-capabilities/payload-context-snapshot.d.ts +2 -0
  520. package/dist/src/runtime/orchestration/worker-capabilities/payload-context-snapshot.js +12 -0
  521. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.d.ts +5 -1
  522. package/dist/src/runtime/orchestration/worker-capabilities/payload-instructions.js +1 -1
  523. package/dist/src/runtime/passive-learning/background-dependencies.d.ts +0 -1
  524. package/dist/src/runtime/passive-learning/contracts.d.ts +2 -3
  525. package/dist/src/runtime/passive-learning/proactive/agent.d.ts +3 -0
  526. package/dist/src/runtime/passive-learning/proactive/agent.js +36 -14
  527. package/dist/src/runtime/passive-learning/proactive/contracts.d.ts +7 -1
  528. package/dist/src/runtime/passive-learning/proactive/contracts.js +8 -1
  529. package/dist/src/runtime/passive-learning/proactive/conversation-style-prompt.d.ts +1 -0
  530. package/dist/src/runtime/passive-learning/proactive/conversation-style-prompt.js +6 -0
  531. package/dist/src/runtime/passive-learning/proactive/conversation-style-reference.d.ts +30 -0
  532. package/dist/src/runtime/passive-learning/proactive/conversation-style-reference.js +61 -0
  533. package/dist/src/runtime/passive-learning/proactive/handoff-brief.d.ts +1 -0
  534. package/dist/src/runtime/passive-learning/proactive/handoff-brief.js +4 -0
  535. package/dist/src/runtime/passive-learning/proactive/model-output.d.ts +1 -1
  536. package/dist/src/runtime/passive-learning/proactive/model-output.js +5 -4
  537. package/dist/src/runtime/passive-learning/proactive/model.d.ts +7 -1
  538. package/dist/src/runtime/passive-learning/proactive/model.js +58 -32
  539. package/dist/src/runtime/passive-learning/proactive/prompt.d.ts +1 -1
  540. package/dist/src/runtime/passive-learning/proactive/prompt.js +4 -2
  541. package/dist/src/runtime/passive-learning/proactive/staged-authoring.d.ts +14 -0
  542. package/dist/src/runtime/passive-learning/proactive/staged-authoring.js +27 -0
  543. package/dist/src/runtime/passive-learning/proactive/staged-context.d.ts +13 -0
  544. package/dist/src/runtime/passive-learning/proactive/staged-context.js +39 -4
  545. package/dist/src/runtime/passive-learning/proactive/staged-contract.d.ts +3 -0
  546. package/dist/src/runtime/passive-learning/proactive/staged-contract.js +4 -0
  547. package/dist/src/runtime/passive-learning/proactive/staged-format.d.ts +5 -1
  548. package/dist/src/runtime/passive-learning/proactive/staged-format.js +2 -4
  549. package/dist/src/runtime/passive-learning/proactive/staged-output.d.ts +3 -4
  550. package/dist/src/runtime/passive-learning/proactive/staged-output.js +13 -5
  551. package/dist/src/runtime/passive-learning/proactive/staged-progress-store.d.ts +0 -1
  552. package/dist/src/runtime/passive-learning/proactive/staged-progress-store.js +2 -18
  553. package/dist/src/runtime/passive-learning/proactive/staged-prompt.d.ts +3 -1
  554. package/dist/src/runtime/passive-learning/proactive/staged-prompt.js +13 -4
  555. package/dist/src/runtime/passive-learning/proactive/staged-review.d.ts +1 -1
  556. package/dist/src/runtime/passive-learning/proactive/staged-review.js +10 -11
  557. package/dist/src/runtime/passive-learning/proactive/store.d.ts +1 -1
  558. package/dist/src/runtime/passive-learning/proactive/store.js +11 -5
  559. package/dist/src/runtime/passive-learning/review-progress.d.ts +1 -1
  560. package/dist/src/runtime/passive-learning/review-progress.js +2 -2
  561. package/dist/src/runtime/passive-learning/service-status.js +2 -2
  562. package/dist/src/runtime/passive-learning/service.js +0 -6
  563. package/dist/src/runtime/passive-learning/spark-chat-preferences.d.ts +3 -0
  564. package/dist/src/runtime/passive-learning/spark-chat-preferences.js +8 -0
  565. package/dist/src/runtime/passive-learning/staged-review-call.d.ts +3 -0
  566. package/dist/src/runtime/passive-learning/staged-review-call.js +19 -13
  567. package/dist/src/runtime/passive-learning/store.js +4 -0
  568. package/dist/src/runtime/plugins/configuration-context.d.ts +9 -0
  569. package/dist/src/runtime/plugins/configuration-context.js +42 -0
  570. package/dist/src/runtime/plugins/configuration-settings.d.ts +2 -0
  571. package/dist/src/runtime/plugins/configuration-settings.js +26 -0
  572. package/dist/src/runtime/plugins/configuration-store.d.ts +23 -0
  573. package/dist/src/runtime/plugins/configuration-store.js +100 -0
  574. package/dist/src/runtime/plugins/configuration-write.d.ts +5 -0
  575. package/dist/src/runtime/plugins/configuration-write.js +58 -0
  576. package/dist/src/runtime/plugins/installation/archive.d.ts +2 -0
  577. package/dist/src/runtime/plugins/installation/archive.js +107 -0
  578. package/dist/src/runtime/plugins/installation/github-download.d.ts +9 -0
  579. package/dist/src/runtime/plugins/installation/github-download.js +72 -0
  580. package/dist/src/runtime/plugins/installation/installed-package.d.ts +9 -0
  581. package/dist/src/runtime/plugins/installation/installed-package.js +66 -0
  582. package/dist/src/runtime/plugins/installation/package.d.ts +45 -0
  583. package/dist/src/runtime/plugins/installation/package.js +79 -0
  584. package/dist/src/runtime/plugins/installation/portable-path.d.ts +2 -0
  585. package/dist/src/runtime/plugins/installation/portable-path.js +10 -0
  586. package/dist/src/runtime/plugins/installation/publication.d.ts +10 -0
  587. package/dist/src/runtime/plugins/installation/publication.js +17 -0
  588. package/dist/src/runtime/plugins/installation/service.d.ts +41 -0
  589. package/dist/src/runtime/plugins/installation/service.js +80 -0
  590. package/dist/src/runtime/plugins/loader.js +15 -29
  591. package/dist/src/runtime/plugins/manifest-projection.js +5 -0
  592. package/dist/src/runtime/plugins/manifest-validator.js +10 -0
  593. package/dist/src/runtime/plugins/module-cache.d.ts +2 -0
  594. package/dist/src/runtime/plugins/module-cache.js +19 -0
  595. package/dist/src/runtime/plugins/selection.d.ts +2 -0
  596. package/dist/src/runtime/plugins/selection.js +16 -11
  597. package/dist/src/runtime/ports.d.ts +20 -5
  598. package/dist/src/runtime/request/approval-wait/activation-events.d.ts +5 -0
  599. package/dist/src/runtime/request/approval-wait/activation-events.js +4 -3
  600. package/dist/src/runtime/request/approval-wait/snapshot.d.ts +1 -1
  601. package/dist/src/runtime/request/approval-wait/snapshot.js +1 -0
  602. package/dist/src/runtime/request/approval-wait/super-compaction-restore.d.ts +20 -0
  603. package/dist/src/runtime/request/approval-wait/super-compaction-restore.js +61 -0
  604. package/dist/src/runtime/request/automation-output-contract.d.ts +6 -0
  605. package/dist/src/runtime/request/automation-output-contract.js +33 -0
  606. package/dist/src/runtime/request/contracts.d.ts +16 -0
  607. package/dist/src/runtime/request/dependencies.d.ts +2 -1
  608. package/dist/src/runtime/request/execution-agent-root-execution.js +2 -0
  609. package/dist/src/runtime/request/execution-facets.js +7 -0
  610. package/dist/src/runtime/request/execution-payload-compacted-evidence.d.ts +64 -0
  611. package/dist/src/runtime/request/execution-payload-compacted-evidence.js +46 -0
  612. package/dist/src/runtime/request/execution-scope-surfaces.d.ts +2 -0
  613. package/dist/src/runtime/request/execution-scope-surfaces.js +28 -0
  614. package/dist/src/runtime/request/execution-scope.d.ts +8 -2
  615. package/dist/src/runtime/request/execution-scope.js +14 -2
  616. package/dist/src/runtime/request/handler.d.ts +7 -0
  617. package/dist/src/runtime/request/handler.js +204 -35
  618. package/dist/src/runtime/request/locked-request-steering.d.ts +3 -0
  619. package/dist/src/runtime/request/locked-request-steering.js +12 -0
  620. package/dist/src/runtime/request/policy-degraded-finalization.d.ts +10 -0
  621. package/dist/src/runtime/request/policy-degraded-finalization.js +27 -0
  622. package/dist/src/runtime/request/prepared-execution.d.ts +10 -1
  623. package/dist/src/runtime/request/prepared-execution.js +48 -8
  624. package/dist/src/runtime/request/request-steering.d.ts +5 -1
  625. package/dist/src/runtime/request/request-steering.js +37 -12
  626. package/dist/src/runtime/request/result.d.ts +3 -0
  627. package/dist/src/runtime/request/role-executor-composition.js +4 -3
  628. package/dist/src/runtime/request/root-contract.d.ts +2 -0
  629. package/dist/src/runtime/request/root-execution-kernel.js +10 -9
  630. package/dist/src/runtime/request/root-invalid-output.js +16 -1
  631. package/dist/src/runtime/request/session-admission.d.ts +6 -0
  632. package/dist/src/runtime/request/session-admission.js +47 -14
  633. package/dist/src/runtime/request/super-checkpoint-quarantine.d.ts +8 -0
  634. package/dist/src/runtime/request/super-checkpoint-quarantine.js +76 -0
  635. package/dist/src/runtime/request/super-context-failure-executor.d.ts +4 -0
  636. package/dist/src/runtime/request/super-context-failure-executor.js +68 -0
  637. package/dist/src/runtime/request/super-context-failure-integrity.d.ts +16 -0
  638. package/dist/src/runtime/request/super-context-failure-integrity.js +130 -0
  639. package/dist/src/runtime/request/super-context-scope.d.ts +9 -0
  640. package/dist/src/runtime/request/super-context-scope.js +65 -0
  641. package/dist/src/runtime/request/super-failure-explanation.d.ts +22 -0
  642. package/dist/src/runtime/request/super-failure-explanation.js +77 -0
  643. package/dist/src/runtime/request/super-failure-message.d.ts +10 -0
  644. package/dist/src/runtime/request/super-failure-message.js +40 -0
  645. package/dist/src/runtime/request/super-payload-context-failure.d.ts +11 -0
  646. package/dist/src/runtime/request/super-payload-context-failure.js +55 -0
  647. package/dist/src/runtime/request/super-root-failure-finalization.d.ts +23 -0
  648. package/dist/src/runtime/request/super-root-failure-finalization.js +112 -0
  649. package/dist/src/runtime/request/worker-capability-composition.d.ts +4 -0
  650. package/dist/src/runtime/request/worker-capability-composition.js +8 -2
  651. package/dist/src/runtime/request/worker-capability-payload.d.ts +2 -1
  652. package/dist/src/runtime/request/worker-capability-payload.js +74 -48
  653. package/dist/src/runtime/runtime-environment.d.ts +3 -1
  654. package/dist/src/runtime/runtime-environment.js +167 -1
  655. package/dist/src/runtime/scheduler/automation-job-management.d.ts +12 -0
  656. package/dist/src/runtime/scheduler/automation-job-management.js +288 -0
  657. package/dist/src/runtime/scheduler/automation-rerun.d.ts +6 -0
  658. package/dist/src/runtime/scheduler/automation-rerun.js +95 -0
  659. package/dist/src/runtime/scheduler/automation-run-budget.d.ts +4 -0
  660. package/dist/src/runtime/scheduler/automation-run-budget.js +16 -0
  661. package/dist/src/runtime/scheduler/automation-run-change-events.d.ts +11 -0
  662. package/dist/src/runtime/scheduler/automation-run-change-events.js +77 -0
  663. package/dist/src/runtime/scheduler/automation-run-completion.d.ts +11 -0
  664. package/dist/src/runtime/scheduler/automation-run-completion.js +93 -0
  665. package/dist/src/runtime/scheduler/automation-run-control.d.ts +3 -0
  666. package/dist/src/runtime/scheduler/automation-run-control.js +48 -0
  667. package/dist/src/runtime/scheduler/automation-run-records.d.ts +5 -0
  668. package/dist/src/runtime/scheduler/automation-run-records.js +37 -0
  669. package/dist/src/runtime/scheduler/automation-schedule.d.ts +10 -0
  670. package/dist/src/runtime/scheduler/automation-schedule.js +48 -0
  671. package/dist/src/runtime/scheduler/automation-scheduler-engine.d.ts +4 -0
  672. package/dist/src/runtime/scheduler/automation-scheduler-engine.js +188 -0
  673. package/dist/src/runtime/scheduler/automation-snapshot-validation.d.ts +3 -0
  674. package/dist/src/runtime/scheduler/automation-snapshot-validation.js +106 -0
  675. package/dist/src/runtime/scheduler/contracts.d.ts +143 -3
  676. package/dist/src/runtime/scheduler/file-store.js +15 -1
  677. package/dist/src/runtime/scheduler/job-management.js +3 -2
  678. package/dist/src/runtime/scheduler/journal-automation-index.d.ts +23 -0
  679. package/dist/src/runtime/scheduler/journal-automation-index.js +205 -0
  680. package/dist/src/runtime/scheduler/journal-automation-transaction.d.ts +11 -0
  681. package/dist/src/runtime/scheduler/journal-automation-transaction.js +90 -0
  682. package/dist/src/runtime/scheduler/journal-checkpoint.js +5 -2
  683. package/dist/src/runtime/scheduler/journal-head.d.ts +1 -1
  684. package/dist/src/runtime/scheduler/journal-head.js +2 -2
  685. package/dist/src/runtime/scheduler/journal-index-state.d.ts +22 -11
  686. package/dist/src/runtime/scheduler/journal-index-state.js +76 -17
  687. package/dist/src/runtime/scheduler/journal-index.d.ts +9 -3
  688. package/dist/src/runtime/scheduler/journal-index.js +84 -9
  689. package/dist/src/runtime/scheduler/journal-store.d.ts +9 -1
  690. package/dist/src/runtime/scheduler/journal-store.js +110 -7
  691. package/dist/src/runtime/scheduler/journal-transaction.d.ts +7 -4
  692. package/dist/src/runtime/scheduler/journal-transaction.js +13 -2
  693. package/dist/src/runtime/scheduler/next-occurrence.js +2 -0
  694. package/dist/src/runtime/scheduler/run-completion.js +2 -1
  695. package/dist/src/runtime/scheduler/run-records.js +8 -3
  696. package/dist/src/runtime/scheduler/schedule-update.d.ts +2 -2
  697. package/dist/src/runtime/scheduler/schedule-validation.d.ts +2 -2
  698. package/dist/src/runtime/scheduler/schedule-validation.js +2 -0
  699. package/dist/src/runtime/scheduler/scheduler-engine.js +24 -8
  700. package/dist/src/runtime/scheduler/scheduler-service.d.ts +4 -1
  701. package/dist/src/runtime/scheduler/scheduler-service.js +83 -10
  702. package/dist/src/runtime/scheduler/scheduler-target.d.ts +9 -0
  703. package/dist/src/runtime/scheduler/scheduler-target.js +41 -0
  704. package/dist/src/runtime/scheduler/service-context.d.ts +6 -2
  705. package/dist/src/runtime/scheduler/service-context.js +6 -3
  706. package/dist/src/runtime/scheduler/snapshot-validation.d.ts +3 -3
  707. package/dist/src/runtime/scheduler/snapshot-validation.js +21 -1
  708. package/dist/src/runtime/scheduler/startup-recovery.d.ts +1 -1
  709. package/dist/src/runtime/scheduler/startup-recovery.js +15 -2
  710. package/dist/src/runtime/scheduler/working-store.js +8 -0
  711. package/dist/src/runtime/session/request-session.d.ts +1 -0
  712. package/dist/src/runtime/session/request-session.js +1 -0
  713. package/dist/src/runtime/session/session-deletion-boundary.d.ts +1 -1
  714. package/dist/src/runtime/session/session-deletion-boundary.js +6 -2
  715. package/dist/src/runtime/session/session-lifecycle-store.d.ts +4 -1
  716. package/dist/src/runtime/session/session-lifecycle-store.js +32 -4
  717. package/dist/src/runtime/session/spark-session-attachments.d.ts +4 -0
  718. package/dist/src/runtime/session/spark-session-attachments.js +28 -0
  719. package/dist/src/runtime/session/spark-session-cleanup-receipt.d.ts +7 -0
  720. package/dist/src/runtime/session/spark-session-cleanup-receipt.js +61 -0
  721. package/dist/src/runtime/session/spark-session-clear.d.ts +6 -0
  722. package/dist/src/runtime/session/spark-session-clear.js +36 -0
  723. package/dist/src/runtime/session/terminal-response.d.ts +21 -0
  724. package/dist/src/runtime/session/terminal-response.js +38 -0
  725. package/dist/src/runtime/steps/auditor-decision/advisory-receipt.d.ts +1 -0
  726. package/dist/src/runtime/steps/auditor-decision/advisory-receipt.js +12 -0
  727. package/dist/src/runtime/steps/auditor-decision/contracts.d.ts +4 -0
  728. package/dist/src/runtime/steps/auditor-decision/evidence-coverage.js +5 -5
  729. package/dist/src/runtime/steps/auditor-decision/evidence-inventory.d.ts +2 -1
  730. package/dist/src/runtime/steps/auditor-decision/evidence-inventory.js +12 -1
  731. package/dist/src/runtime/steps/auditor-decision/evidence-representation.d.ts +8 -2
  732. package/dist/src/runtime/steps/auditor-decision/evidence-representation.js +14 -1
  733. package/dist/src/runtime/steps/auditor-decision/input.d.ts +2 -0
  734. package/dist/src/runtime/steps/auditor-decision/input.js +12 -3
  735. package/dist/src/runtime/steps/auditor-decision/projection.js +20 -1
  736. package/dist/src/runtime/steps/auditor-decision/prompt.js +6 -6
  737. package/dist/src/runtime/steps/auditor-decision/run.js +2 -3
  738. package/dist/src/runtime/steps/capability-execution-instructions.d.ts +5 -0
  739. package/dist/src/runtime/steps/capability-execution-instructions.js +5 -0
  740. package/dist/src/runtime/steps/degraded-finalization/contract.d.ts +3 -0
  741. package/dist/src/runtime/steps/degraded-finalization/fallback.js +14 -4
  742. package/dist/src/runtime/steps/degraded-finalization/input.js +11 -1
  743. package/dist/src/runtime/steps/degraded-finalization/output-limit-cause.d.ts +4 -0
  744. package/dist/src/runtime/steps/degraded-finalization/output-limit-cause.js +17 -0
  745. package/dist/src/runtime/steps/degraded-finalization/prompt.js +4 -1
  746. package/dist/src/runtime/steps/degraded-finalization/super.d.ts +20 -0
  747. package/dist/src/runtime/steps/degraded-finalization/super.js +128 -0
  748. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.d.ts +1 -0
  749. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.js +21 -3
  750. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.d.ts +1 -1
  751. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.js +4 -2
  752. package/dist/src/runtime/steps/execution-agent/capability-selection-schema.d.ts +3 -0
  753. package/dist/src/runtime/steps/execution-agent/capability-selection-schema.js +72 -0
  754. package/dist/src/runtime/steps/execution-agent/compaction.d.ts +5 -2
  755. package/dist/src/runtime/steps/execution-agent/compaction.js +10 -4
  756. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +14 -2
  757. package/dist/src/runtime/steps/execution-agent/controls-compacted-evidence.d.ts +16 -0
  758. package/dist/src/runtime/steps/execution-agent/controls-compacted-evidence.js +67 -0
  759. package/dist/src/runtime/steps/execution-agent/controls-evidence-contract.d.ts +21 -0
  760. package/dist/src/runtime/steps/execution-agent/controls-evidence-contract.js +64 -0
  761. package/dist/src/runtime/steps/execution-agent/controls-evidence.d.ts +32 -0
  762. package/dist/src/runtime/steps/execution-agent/controls-evidence.js +119 -0
  763. package/dist/src/runtime/steps/execution-agent/decision-parsing.js +1 -0
  764. package/dist/src/runtime/steps/execution-agent/format.d.ts +2 -0
  765. package/dist/src/runtime/steps/execution-agent/format.js +9 -68
  766. package/dist/src/runtime/steps/execution-agent/input.js +19 -2
  767. package/dist/src/runtime/steps/execution-agent/prompt.d.ts +1 -0
  768. package/dist/src/runtime/steps/execution-agent/prompt.js +15 -2
  769. package/dist/src/runtime/steps/execution-agent/refinement-input.d.ts +32 -0
  770. package/dist/src/runtime/steps/execution-agent/refinement-input.js +146 -0
  771. package/dist/src/runtime/steps/execution-agent/refinement-prompt.d.ts +1 -0
  772. package/dist/src/runtime/steps/execution-agent/refinement-prompt.js +11 -0
  773. package/dist/src/runtime/steps/execution-agent/refinement.d.ts +4 -4
  774. package/dist/src/runtime/steps/execution-agent/refinement.js +18 -108
  775. package/dist/src/runtime/steps/execution-agent/response-input.js +13 -6
  776. package/dist/src/runtime/steps/execution-agent/response-prompt.js +1 -1
  777. package/dist/src/runtime/steps/execution-agent/response-run.js +19 -5
  778. package/dist/src/runtime/steps/execution-agent/run.js +9 -3
  779. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +1 -1
  780. package/dist/src/runtime/steps/execution-agent/state-context.js +20 -5
  781. package/dist/src/runtime/steps/planner-decision/input.js +7 -0
  782. package/dist/src/runtime/steps/planner-decision/resume.d.ts +2 -1
  783. package/dist/src/runtime/steps/planner-decision/resume.js +3 -3
  784. package/dist/src/runtime/steps/planner-decision/run.js +13 -0
  785. package/dist/src/runtime/steps/planner-graph/prompt.js +2 -0
  786. package/dist/src/runtime/steps/planner-graph/run.js +1 -0
  787. package/dist/src/runtime/steps/reviewer-decision/projection.js +5 -0
  788. package/dist/src/runtime/steps/reviewer-decision/run.js +13 -0
  789. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +1 -1
  790. package/dist/src/runtime/steps/supervisor-decision/input.js +2 -0
  791. package/dist/src/runtime/steps/supervisor-decision/run.js +14 -0
  792. package/dist/src/runtime/steps/supervisor-decision/working-directory.d.ts +2 -0
  793. package/dist/src/runtime/steps/supervisor-decision/working-directory.js +6 -0
  794. package/dist/src/runtime/steps/supervisor-response/input.d.ts +1 -1
  795. package/dist/src/runtime/steps/supervisor-response/input.js +14 -7
  796. package/dist/src/runtime/steps/supervisor-response/run.js +39 -9
  797. package/dist/src/runtime/steps/worker-decision/compaction-integrity.d.ts +11 -0
  798. package/dist/src/runtime/steps/worker-decision/compaction-integrity.js +40 -0
  799. package/dist/src/runtime/steps/worker-decision/input/reference-context.js +7 -0
  800. package/dist/src/runtime/steps/worker-decision/input/types.d.ts +4 -1
  801. package/dist/src/runtime/steps/worker-decision/prompt.js +9 -2
  802. package/dist/src/runtime/steps/worker-decision/result-author.js +4 -0
  803. package/dist/src/runtime/steps/worker-decision/run.js +12 -49
  804. package/dist/src/runtime/steps/worker-decision/worker-handoff-compaction.d.ts +4 -0
  805. package/dist/src/runtime/steps/worker-decision/worker-handoff-compaction.js +69 -0
  806. package/dist/src/sessions/assistant-initiative-append.d.ts +14 -0
  807. package/dist/src/sessions/assistant-initiative-append.js +64 -0
  808. package/dist/src/sessions/assistant-initiative-message.d.ts +3 -0
  809. package/dist/src/sessions/assistant-initiative-message.js +12 -0
  810. package/dist/src/sessions/assistant-initiative.d.ts +6 -2
  811. package/dist/src/sessions/assistant-initiative.js +8 -8
  812. package/dist/src/sessions/automation-session-origin.d.ts +34 -0
  813. package/dist/src/sessions/automation-session-origin.js +78 -0
  814. package/dist/src/sessions/automation-session-store.d.ts +12 -0
  815. package/dist/src/sessions/automation-session-store.js +129 -0
  816. package/dist/src/sessions/durable-session-commit.d.ts +2 -1
  817. package/dist/src/sessions/durable-session-commit.js +6 -1
  818. package/dist/src/sessions/index.d.ts +1 -0
  819. package/dist/src/sessions/index.js +3 -0
  820. package/dist/src/sessions/memory/source.d.ts +1 -1
  821. package/dist/src/sessions/memory/source.js +4 -11
  822. package/dist/src/sessions/metadata/projection.d.ts +15 -0
  823. package/dist/src/sessions/metadata/projection.js +55 -0
  824. package/dist/src/sessions/metadata/publication.d.ts +12 -0
  825. package/dist/src/sessions/metadata/publication.js +78 -0
  826. package/dist/src/sessions/metadata/source-receipt.d.ts +5 -0
  827. package/dist/src/sessions/metadata/source-receipt.js +42 -0
  828. package/dist/src/sessions/metadata/store.d.ts +7 -0
  829. package/dist/src/sessions/metadata/store.js +119 -0
  830. package/dist/src/sessions/project-binding.d.ts +1 -0
  831. package/dist/src/sessions/record/projection.d.ts +4 -1
  832. package/dist/src/sessions/record/projection.js +27 -15
  833. package/dist/src/sessions/request-lifecycle/service.js +3 -3
  834. package/dist/src/sessions/session-service.d.ts +11 -4
  835. package/dist/src/sessions/session-service.js +56 -19
  836. package/dist/src/sessions/session-store.d.ts +2 -1
  837. package/dist/src/sessions/session-store.js +9 -3
  838. package/dist/src/sessions/snapshot.d.ts +17 -0
  839. package/dist/src/sessions/snapshot.js +105 -0
  840. package/dist/src/sessions/spark-handoff-brief.d.ts +3 -0
  841. package/dist/src/sessions/spark-handoff-brief.js +9 -0
  842. package/dist/src/sessions/spark-session.d.ts +13 -0
  843. package/dist/src/sessions/spark-session.js +25 -0
  844. package/dist/src/sessions/types.d.ts +7 -0
  845. package/dist/src/shared/tool-selection.d.ts +2 -0
  846. package/dist/src/shared/tool-selection.js +7 -0
  847. package/dist/src/web-ui/app/ARCHITECTURE.md +103 -0
  848. package/dist/src/web-ui/app/app-bootstrap.js +24 -2
  849. package/dist/src/web-ui/app/app-dom.js +5 -0
  850. package/dist/src/web-ui/app/app-realtime-transport.js +27 -2
  851. package/dist/src/web-ui/app/app.js +11 -13
  852. package/dist/src/web-ui/app/automations-feature.js +103 -0
  853. package/dist/src/web-ui/app/components/automations/archive-actions.js +20 -0
  854. package/dist/src/web-ui/app/components/automations/authoring-entry.js +25 -0
  855. package/dist/src/web-ui/app/components/automations/binding-editor.js +101 -0
  856. package/dist/src/web-ui/app/components/automations/binding-fields.js +166 -0
  857. package/dist/src/web-ui/app/components/automations/chat-run-projection.js +280 -0
  858. package/dist/src/web-ui/app/components/automations/draft-recovery-actions.js +28 -0
  859. package/dist/src/web-ui/app/components/automations/editor-action-icons.js +18 -0
  860. package/dist/src/web-ui/app/components/automations/editor-actions.js +57 -0
  861. package/dist/src/web-ui/app/components/automations/editor.js +218 -0
  862. package/dist/src/web-ui/app/components/automations/failure-presentation.js +299 -0
  863. package/dist/src/web-ui/app/components/automations/library-tabs.js +45 -0
  864. package/dist/src/web-ui/app/components/automations/list.js +58 -0
  865. package/dist/src/web-ui/app/components/automations/live-view.js +39 -0
  866. package/dist/src/web-ui/app/components/automations/node-inspector.js +251 -0
  867. package/dist/src/web-ui/app/components/automations/permission-selection.js +37 -0
  868. package/dist/src/web-ui/app/components/automations/rerun-confirmation.js +16 -0
  869. package/dist/src/web-ui/app/components/automations/run-output-view.js +100 -0
  870. package/dist/src/web-ui/app/components/automations/run-report-view.js +224 -0
  871. package/dist/src/web-ui/app/components/automations/run-step-selection.js +7 -0
  872. package/dist/src/web-ui/app/components/automations/run-steps-view.js +33 -0
  873. package/dist/src/web-ui/app/components/automations/run.js +38 -0
  874. package/dist/src/web-ui/app/components/automations/schema-literal-inputs.js +212 -0
  875. package/dist/src/web-ui/app/components/automations/step-editor-dialog.js +243 -0
  876. package/dist/src/web-ui/app/components/automations/step-preview.js +48 -0
  877. package/dist/src/web-ui/app/components/automations/template-gallery.js +74 -0
  878. package/dist/src/web-ui/app/components/automations/timeline-camera.js +219 -0
  879. package/dist/src/web-ui/app/components/automations/timeline.js +141 -0
  880. package/dist/src/web-ui/app/components/automations/tool-identity.js +25 -0
  881. package/dist/src/web-ui/app/components/automations/workspace.js +462 -0
  882. package/dist/src/web-ui/app/components/composer-context-window.js +24 -13
  883. package/dist/src/web-ui/app/components/config-workspace/config-model.js +2 -0
  884. package/dist/src/web-ui/app/components/config-workspace/model-plugin-permissions.js +130 -0
  885. package/dist/src/web-ui/app/components/config-workspace/model-plugin-selection.js +180 -0
  886. package/dist/src/web-ui/app/components/config-workspace/model-plugin-view-state.js +114 -0
  887. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +5 -2
  888. package/dist/src/web-ui/app/components/config-workspace/model-summary.js +39 -0
  889. package/dist/src/web-ui/app/components/config-workspace/summary-rendering.js +30 -0
  890. package/dist/src/web-ui/app/components/config-workspace/workspace-events.js +37 -0
  891. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +2 -0
  892. package/dist/src/web-ui/app/components/config-workspace/workspace-persistence.js +9 -1
  893. package/dist/src/web-ui/app/components/config-workspace/workspace-view.js +23 -67
  894. package/dist/src/web-ui/app/components/config-workspace.js +11 -2
  895. package/dist/src/web-ui/app/components/conversation-activity.d.ts +2 -28
  896. package/dist/src/web-ui/app/components/conversation-activity.js +23 -60
  897. package/dist/src/web-ui/app/components/conversation-status.js +3 -2
  898. package/dist/src/web-ui/app/components/conversation-view.js +71 -18
  899. package/dist/src/web-ui/app/components/dashboard/automations.js +28 -0
  900. package/dist/src/web-ui/app/components/dashboard/recent-conversations.js +2 -1
  901. package/dist/src/web-ui/app/components/dashboard/workspace.js +11 -1
  902. package/dist/src/web-ui/app/components/notifications/dom.js +1 -1
  903. package/dist/src/web-ui/app/components/notifications/feedback.js +34 -0
  904. package/dist/src/web-ui/app/components/notifications/pagination.js +13 -0
  905. package/dist/src/web-ui/app/components/notifications/presentation.js +25 -4
  906. package/dist/src/web-ui/app/components/notifications/tabs.js +49 -0
  907. package/dist/src/web-ui/app/components/notifications/workspace.js +19 -26
  908. package/dist/src/web-ui/app/components/onboarding-workspace-access.js +1 -1
  909. package/dist/src/web-ui/app/components/operations-summary.js +105 -0
  910. package/dist/src/web-ui/app/components/passive-learning/agent-state.js +0 -5
  911. package/dist/src/web-ui/app/components/passive-learning/agent-view.js +1 -1
  912. package/dist/src/web-ui/app/components/passive-learning/home.js +1 -13
  913. package/dist/src/web-ui/app/components/passive-learning/memory.js +0 -3
  914. package/dist/src/web-ui/app/components/passive-learning/settings-view.js +2 -2
  915. package/dist/src/web-ui/app/components/passive-learning/workspace-view.js +3 -3
  916. package/dist/src/web-ui/app/components/plugins/configuration-draft.js +34 -0
  917. package/dist/src/web-ui/app/components/plugins/configuration-editor.js +147 -0
  918. package/dist/src/web-ui/app/components/plugins/configuration-fields.js +103 -0
  919. package/dist/src/web-ui/app/components/plugins/configuration-retained-secrets.js +20 -0
  920. package/dist/src/web-ui/app/components/plugins/configuration-settings.js +108 -0
  921. package/dist/src/web-ui/app/components/plugins/discovery-rendering.js +37 -0
  922. package/dist/src/web-ui/app/components/plugins/installation.js +212 -0
  923. package/dist/src/web-ui/app/components/plugins/manager.js +160 -6
  924. package/dist/src/web-ui/app/components/plugins/removal.js +130 -0
  925. package/dist/src/web-ui/app/components/plugins/rendering.js +14 -2
  926. package/dist/src/web-ui/app/components/plugins/summary.js +54 -0
  927. package/dist/src/web-ui/app/components/plugins/tabs.js +31 -0
  928. package/dist/src/web-ui/app/components/plugins/view-state.js +3 -1
  929. package/dist/src/web-ui/app/components/runtime-setup/connection-form.js +5 -2
  930. package/dist/src/web-ui/app/components/runtime-setup/connection-state.js +9 -1
  931. package/dist/src/web-ui/app/components/runtime-setup/context-window-feedback.js +71 -0
  932. package/dist/src/web-ui/app/components/runtime-setup/optional-steps.js +9 -1
  933. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +5 -1
  934. package/dist/src/web-ui/app/components/runtime-setup-guide.js +20 -5
  935. package/dist/src/web-ui/app/components/schedules/details.js +3 -2
  936. package/dist/src/web-ui/app/components/schedules/form.js +4 -4
  937. package/dist/src/web-ui/app/components/spark-chat/empty-state.js +46 -0
  938. package/dist/src/web-ui/app/components/spark-chat/handoff-actions.js +59 -0
  939. package/dist/src/web-ui/app/components/spark-chat/mascot-activity.js +27 -0
  940. package/dist/src/web-ui/app/components/spark-chat/motion.js +52 -0
  941. package/dist/src/web-ui/app/components/spark-chat/panel.js +110 -0
  942. package/dist/src/web-ui/app/components/spark-chat/placement.js +198 -0
  943. package/dist/src/web-ui/app/components/spark-chat/results.js +44 -0
  944. package/dist/src/web-ui/app/components/spark-chat/settings.js +84 -0
  945. package/dist/src/web-ui/app/components/system-host/connection-card.js +35 -0
  946. package/dist/src/web-ui/app/components/system-host/macos-permission-preparation.js +83 -0
  947. package/dist/src/web-ui/app/components/system-host/macos-permission-rendering.js +85 -0
  948. package/dist/src/web-ui/app/components/system-host/macos-permission-scopes.js +51 -0
  949. package/dist/src/web-ui/app/components/system-host/macos-setup.js +1 -1
  950. package/dist/src/web-ui/app/components/system-host/manager.js +78 -11
  951. package/dist/src/web-ui/app/components/system-host/rendering.js +113 -100
  952. package/dist/src/web-ui/app/components/system-host/windows-store-setup.js +293 -0
  953. package/dist/src/web-ui/app/components/workspace-shell.js +45 -6
  954. package/dist/src/web-ui/app/computer-access-feature.js +27 -5
  955. package/dist/src/web-ui/app/configuration-feature.js +36 -2
  956. package/dist/src/web-ui/app/controllers/app-event-bindings.js +28 -3
  957. package/dist/src/web-ui/app/controllers/automation-draft-actions.js +153 -0
  958. package/dist/src/web-ui/app/controllers/automation-management-actions.js +75 -0
  959. package/dist/src/web-ui/app/controllers/automation-mutation-lifecycle.js +32 -0
  960. package/dist/src/web-ui/app/controllers/automation-read-projection.js +63 -0
  961. package/dist/src/web-ui/app/controllers/automation-run-actions.js +54 -0
  962. package/dist/src/web-ui/app/controllers/automation-view-scope.js +19 -0
  963. package/dist/src/web-ui/app/controllers/automations-controller.js +395 -0
  964. package/dist/src/web-ui/app/controllers/composer-queue-controller.d.ts +1 -0
  965. package/dist/src/web-ui/app/controllers/composer-queue-controller.js +18 -12
  966. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.d.ts +1 -0
  967. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.js +7 -3
  968. package/dist/src/web-ui/app/controllers/conversation-request-hydration.js +88 -0
  969. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +9 -3
  970. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +89 -158
  971. package/dist/src/web-ui/app/controllers/conversation-view-feature.js +1 -14
  972. package/dist/src/web-ui/app/controllers/dashboard-controller.js +42 -1
  973. package/dist/src/web-ui/app/controllers/history-pagination.js +111 -0
  974. package/dist/src/web-ui/app/controllers/notifications-controller.js +1 -1
  975. package/dist/src/web-ui/app/controllers/operations-controller.d.ts +12 -0
  976. package/dist/src/web-ui/app/controllers/operations-controller.js +28 -21
  977. package/dist/src/web-ui/app/controllers/passive-learning-controller.js +33 -85
  978. package/dist/src/web-ui/app/controllers/projects-controller.d.ts +2 -0
  979. package/dist/src/web-ui/app/controllers/projects-controller.js +53 -18
  980. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +42 -160
  981. package/dist/src/web-ui/app/controllers/request-lifecycle-controller.js +2 -0
  982. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.d.ts +5 -1
  983. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.js +25 -3
  984. package/dist/src/web-ui/app/controllers/schedules-controller.js +11 -19
  985. package/dist/src/web-ui/app/controllers/session-controller.js +10 -2
  986. package/dist/src/web-ui/app/controllers/session-list-pagination.js +71 -0
  987. package/dist/src/web-ui/app/controllers/session-sidebar-controller.js +6 -4
  988. package/dist/src/web-ui/app/controllers/spark-chat-notices.js +34 -0
  989. package/dist/src/web-ui/app/controllers/spark-chat-reading.js +146 -0
  990. package/dist/src/web-ui/app/controllers/spark-chat-sync.js +170 -0
  991. package/dist/src/web-ui/app/controllers/spark-handoff-navigation.js +32 -0
  992. package/dist/src/web-ui/app/controllers/workspace-route-controller.js +42 -20
  993. package/dist/src/web-ui/app/dashboard-feature.js +2 -3
  994. package/dist/src/web-ui/app/index.html +18 -12
  995. package/dist/src/web-ui/app/lib/automation-binding-producers.js +47 -0
  996. package/dist/src/web-ui/app/lib/automation-graph-position.js +19 -0
  997. package/dist/src/web-ui/app/lib/automation-parallel-depth.js +19 -0
  998. package/dist/src/web-ui/app/lib/configuration-pages.js +3 -5
  999. package/dist/src/web-ui/app/lib/context-compaction-state.d.ts +41 -0
  1000. package/dist/src/web-ui/app/lib/context-compaction-state.js +172 -0
  1001. package/dist/src/web-ui/app/lib/context-window-measurement.d.ts +33 -0
  1002. package/dist/src/web-ui/app/lib/context-window-measurement.js +99 -0
  1003. package/dist/src/web-ui/app/lib/context-window-replay.d.ts +32 -0
  1004. package/dist/src/web-ui/app/lib/context-window-replay.js +38 -0
  1005. package/dist/src/web-ui/app/lib/context-window-snapshot-order.d.ts +16 -8
  1006. package/dist/src/web-ui/app/lib/context-window-snapshot-order.js +29 -9
  1007. package/dist/src/web-ui/app/lib/context-window-state.d.ts +80 -0
  1008. package/dist/src/web-ui/app/lib/context-window-state.js +341 -0
  1009. package/dist/src/web-ui/app/lib/conversation-status-model.js +15 -3
  1010. package/dist/src/web-ui/app/lib/history-page-messages.js +49 -0
  1011. package/dist/src/web-ui/app/lib/realtime-message.js +9 -0
  1012. package/dist/src/web-ui/app/lib/request-lifecycle-view.js +8 -0
  1013. package/dist/src/web-ui/app/lib/schedule-conversation-presentation.js +19 -0
  1014. package/dist/src/web-ui/app/lib/schedule-presentation.js +2 -2
  1015. package/dist/src/web-ui/app/lib/spark-chat-address.js +22 -0
  1016. package/dist/src/web-ui/app/lib/spark-chat-presentation.js +16 -0
  1017. package/dist/src/web-ui/app/lib/spark-chat-read-state.js +13 -0
  1018. package/dist/src/web-ui/app/lib/spark-proposal-message.js +7 -0
  1019. package/dist/src/web-ui/app/lib/tool-activity-event.d.ts +1 -0
  1020. package/dist/src/web-ui/app/lib/tool-activity-event.js +6 -2
  1021. package/dist/src/web-ui/app/lib/tool-activity-model.js +1 -0
  1022. package/dist/src/web-ui/app/lib/tool-approval-acknowledgement.js +7 -0
  1023. package/dist/src/web-ui/app/lib/tool-automation-activity-fields.js +59 -0
  1024. package/dist/src/web-ui/app/lib/tool-process-activity-fields.js +1 -1
  1025. package/dist/src/web-ui/app/lib/workspace-change.js +2 -2
  1026. package/dist/src/web-ui/app/lib/workspace-route.d.ts +6 -0
  1027. package/dist/src/web-ui/app/lib/workspace-route.js +17 -2
  1028. package/dist/src/web-ui/app/notifications-feature.js +13 -0
  1029. package/dist/src/web-ui/app/passive-learning-feature.js +5 -31
  1030. package/dist/src/web-ui/app/projects-feature.js +16 -5
  1031. package/dist/src/web-ui/app/runtime-onboarding-feature.js +4 -0
  1032. package/dist/src/web-ui/app/schedules-feature.js +1 -1
  1033. package/dist/src/web-ui/app/services/client-preferences.d.ts +0 -2
  1034. package/dist/src/web-ui/app/services/client-preferences.js +0 -2
  1035. package/dist/src/web-ui/app/services/runtime-web-client/automations.d.ts +36 -0
  1036. package/dist/src/web-ui/app/services/runtime-web-client/automations.js +63 -0
  1037. package/dist/src/web-ui/app/services/runtime-web-client/configuration.js +20 -0
  1038. package/dist/src/web-ui/app/services/runtime-web-client/learning.js +0 -9
  1039. package/dist/src/web-ui/app/services/runtime-web-client/plugin-configuration.js +19 -0
  1040. package/dist/src/web-ui/app/services/runtime-web-client/spark-chat.d.ts +22 -0
  1041. package/dist/src/web-ui/app/services/runtime-web-client/spark-chat.js +29 -0
  1042. package/dist/src/web-ui/app/services/runtime-web-client/system-host.js +6 -2
  1043. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +30 -5
  1044. package/dist/src/web-ui/app/services/runtime-web-client.js +17 -4
  1045. package/dist/src/web-ui/app/spark-chat-conversation.js +217 -0
  1046. package/dist/src/web-ui/app/spark-chat-feature.js +244 -0
  1047. package/dist/src/web-ui/app/spark-mascot.svg +12 -0
  1048. package/dist/src/web-ui/app/styles/11-product-links.css +30 -0
  1049. package/dist/src/web-ui/app/styles/11-workspace-header-width.css +48 -14
  1050. package/dist/src/web-ui/app/styles/11-workspace-rail.css +6 -0
  1051. package/dist/src/web-ui/app/styles/19-dashboard-automations.css +32 -0
  1052. package/dist/src/web-ui/app/styles/41-co-worker-agent.css +6 -25
  1053. package/dist/src/web-ui/app/styles/41-plugin-configuration.css +79 -0
  1054. package/dist/src/web-ui/app/styles/41-plugin-discovery.css +132 -0
  1055. package/dist/src/web-ui/app/styles/41-plugin-management.css +6 -0
  1056. package/dist/src/web-ui/app/styles/42-model-plugin-permissions.css +173 -0
  1057. package/dist/src/web-ui/app/styles/46-system-host.css +78 -107
  1058. package/dist/src/web-ui/app/styles/47-config-controls.css +13 -1
  1059. package/dist/src/web-ui/app/styles/48-notifications.css +14 -8
  1060. package/dist/src/web-ui/app/styles/50-automations.css +353 -0
  1061. package/dist/src/web-ui/app/styles/51-automation-editor-actions.css +35 -0
  1062. package/dist/src/web-ui/app/styles/51-automation-templates.css +39 -0
  1063. package/dist/src/web-ui/app/styles/52-automation-reports.css +84 -0
  1064. package/dist/src/web-ui/app/styles/52-automation-step-editor.css +73 -0
  1065. package/dist/src/web-ui/app/styles/53-automation-schema-inputs.css +21 -0
  1066. package/dist/src/web-ui/app/styles/54-spark-chat.css +143 -0
  1067. package/dist/src/web-ui/app/styles/94-automations-responsive.css +35 -0
  1068. package/dist/src/web-ui/app/styles.css +13 -1
  1069. package/dist/src/web-ui/app/ui-behavior.js +1 -0
  1070. package/dist/src/web-ui/local-runtime/api-router.d.ts +2 -0
  1071. package/dist/src/web-ui/local-runtime/api-router.js +29 -6
  1072. package/dist/src/web-ui/local-runtime/approval-request-attachment.js +14 -5
  1073. package/dist/src/web-ui/local-runtime/automation-routes.d.ts +27 -0
  1074. package/dist/src/web-ui/local-runtime/automation-routes.js +227 -0
  1075. package/dist/src/web-ui/local-runtime/configuration-activation-source.d.ts +1 -1
  1076. package/dist/src/web-ui/local-runtime/configuration-activation-source.js +9 -3
  1077. package/dist/src/web-ui/local-runtime/contracts.d.ts +4 -3
  1078. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +9 -1
  1079. package/dist/src/web-ui/local-runtime/environment-registry.js +58 -11
  1080. package/dist/src/web-ui/local-runtime/history-pagination.d.ts +16 -0
  1081. package/dist/src/web-ui/local-runtime/history-pagination.js +20 -0
  1082. package/dist/src/web-ui/local-runtime/learning-notifications.js +1 -1
  1083. package/dist/src/web-ui/local-runtime/learning-routes.js +0 -22
  1084. package/dist/src/web-ui/local-runtime/plugin-configuration-routes.d.ts +16 -0
  1085. package/dist/src/web-ui/local-runtime/plugin-configuration-routes.js +68 -0
  1086. package/dist/src/web-ui/local-runtime/plugin-installation-routes.d.ts +16 -0
  1087. package/dist/src/web-ui/local-runtime/plugin-installation-routes.js +96 -0
  1088. package/dist/src/web-ui/local-runtime/plugin-management-routes.d.ts +8 -1
  1089. package/dist/src/web-ui/local-runtime/plugin-management-routes.js +17 -0
  1090. package/dist/src/web-ui/local-runtime/plugin-mutation-admission.d.ts +7 -0
  1091. package/dist/src/web-ui/local-runtime/plugin-mutation-admission.js +17 -0
  1092. package/dist/src/web-ui/local-runtime/plugin-removal-routes.d.ts +18 -0
  1093. package/dist/src/web-ui/local-runtime/plugin-removal-routes.js +60 -0
  1094. package/dist/src/web-ui/local-runtime/realtime-controller.js +41 -2
  1095. package/dist/src/web-ui/local-runtime/request-cancellation-route.js +28 -1
  1096. package/dist/src/web-ui/local-runtime/request-control-observation.d.ts +19 -0
  1097. package/dist/src/web-ui/local-runtime/request-control-observation.js +80 -0
  1098. package/dist/src/web-ui/local-runtime/request-execution.js +91 -24
  1099. package/dist/src/web-ui/local-runtime/runtime-setup-context-window.d.ts +20 -0
  1100. package/dist/src/web-ui/local-runtime/runtime-setup-context-window.js +44 -0
  1101. package/dist/src/web-ui/local-runtime/runtime-setup-routes.js +2 -0
  1102. package/dist/src/web-ui/local-runtime/runtime-setup-validation.js +9 -2
  1103. package/dist/src/web-ui/local-runtime/session-routes.d.ts +1 -0
  1104. package/dist/src/web-ui/local-runtime/session-routes.js +48 -6
  1105. package/dist/src/web-ui/local-runtime/setup-embedding-config-repository.d.ts +6 -0
  1106. package/dist/src/web-ui/local-runtime/setup-embedding-config-repository.js +25 -0
  1107. package/dist/src/web-ui/local-runtime/setup-embedding-service.js +2 -0
  1108. package/dist/src/web-ui/local-runtime/spark-chat-admission.d.ts +7 -0
  1109. package/dist/src/web-ui/local-runtime/spark-chat-admission.js +37 -0
  1110. package/dist/src/web-ui/local-runtime/spark-chat-configuration.d.ts +8 -0
  1111. package/dist/src/web-ui/local-runtime/spark-chat-configuration.js +16 -0
  1112. package/dist/src/web-ui/local-runtime/spark-chat-handoff.d.ts +4 -0
  1113. package/dist/src/web-ui/local-runtime/spark-chat-handoff.js +84 -0
  1114. package/dist/src/web-ui/local-runtime/spark-chat-routes.d.ts +19 -0
  1115. package/dist/src/web-ui/local-runtime/spark-chat-routes.js +63 -0
  1116. package/dist/src/web-ui/local-runtime-backend.d.ts +4 -0
  1117. package/dist/src/web-ui/local-runtime-backend.js +3 -0
  1118. package/dist/src/web-ui/notifications/automation-event-projection.d.ts +3 -0
  1119. package/dist/src/web-ui/notifications/automation-event-projection.js +57 -0
  1120. package/dist/src/web-ui/notifications/contracts.d.ts +20 -5
  1121. package/dist/src/web-ui/notifications/contracts.js +7 -1
  1122. package/dist/src/web-ui/notifications/conversation-source.d.ts +6 -0
  1123. package/dist/src/web-ui/notifications/conversation-source.js +26 -0
  1124. package/dist/src/web-ui/notifications/event-fields.d.ts +3 -0
  1125. package/dist/src/web-ui/notifications/event-fields.js +12 -0
  1126. package/dist/src/web-ui/notifications/event-projection.d.ts +2 -1
  1127. package/dist/src/web-ui/notifications/event-projection.js +22 -20
  1128. package/dist/src/web-ui/notifications/service.js +33 -2
  1129. package/dist/src/web-ui/notifications/storage-schema.js +118 -21
  1130. package/dist/src/web-ui/plugin-capability-selection.js +4 -1
  1131. package/dist/src/web-ui/plugin-configuration-input.d.ts +12 -0
  1132. package/dist/src/web-ui/plugin-configuration-input.js +68 -0
  1133. package/dist/src/web-ui/plugin-configuration-retained-secrets.d.ts +9 -0
  1134. package/dist/src/web-ui/plugin-configuration-retained-secrets.js +48 -0
  1135. package/dist/src/web-ui/plugin-configuration-service.d.ts +52 -0
  1136. package/dist/src/web-ui/plugin-configuration-service.js +66 -0
  1137. package/dist/src/web-ui/plugin-configuration-view.d.ts +25 -0
  1138. package/dist/src/web-ui/plugin-configuration-view.js +45 -0
  1139. package/dist/src/web-ui/plugin-disabled-selection.d.ts +7 -0
  1140. package/dist/src/web-ui/plugin-disabled-selection.js +17 -0
  1141. package/dist/src/web-ui/plugin-management-catalog.d.ts +3 -1
  1142. package/dist/src/web-ui/plugin-management-catalog.js +11 -1
  1143. package/dist/src/web-ui/plugin-management-selection.js +22 -9
  1144. package/dist/src/web-ui/plugin-management-service.d.ts +5 -1
  1145. package/dist/src/web-ui/plugin-management-service.js +11 -7
  1146. package/dist/src/web-ui/plugin-removal-error.d.ts +7 -0
  1147. package/dist/src/web-ui/plugin-removal-error.js +16 -0
  1148. package/dist/src/web-ui/plugin-removal-service.d.ts +30 -0
  1149. package/dist/src/web-ui/plugin-removal-service.js +109 -0
  1150. package/dist/src/web-ui/runtime-setup-gateway.d.ts +6 -2
  1151. package/dist/src/web-ui/runtime-setup-gateway.js +30 -10
  1152. package/dist/src/web-ui/server.js +7 -3
  1153. package/dist/src/web-ui/session-read-state/overview.d.ts +42 -0
  1154. package/dist/src/web-ui/session-read-state/overview.js +16 -0
  1155. package/dist/src/web-ui/session-read-state/pagination.d.ts +15 -0
  1156. package/dist/src/web-ui/session-read-state/pagination.js +42 -0
  1157. package/dist/src/web-ui/session-read-state/projection.d.ts +4 -3
  1158. package/dist/src/web-ui/session-read-state/service.d.ts +246 -14
  1159. package/dist/src/web-ui/session-read-state/service.js +38 -18
  1160. package/dist/src/web-ui/session-read-state/store.d.ts +2 -0
  1161. package/dist/src/web-ui/session-read-state/store.js +7 -0
  1162. package/dist/src/web-ui/session-read-state/visible-messages.d.ts +30 -0
  1163. package/dist/src/web-ui/session-read-state/visible-messages.js +119 -0
  1164. package/dist/src/web-ui/system-host-service.d.ts +4 -1
  1165. package/dist/src/web-ui/system-host-service.js +14 -3
  1166. package/dist/src/web-ui/system-host-setup/companion-linux.js +1 -1
  1167. package/dist/src/web-ui/system-host-setup/installer-contract.d.ts +1 -1
  1168. package/dist/src/web-ui/system-host-setup/installer-contract.js +2 -2
  1169. package/dist/src/web-ui/system-host-setup/installers.js +0 -7
  1170. package/dist/src/web-ui/system-host-setup/local-connection.d.ts +4 -1
  1171. package/dist/src/web-ui/system-host-setup/local-connection.js +10 -17
  1172. package/dist/src/web-ui/system-host-setup/local-request-authority.d.ts +3 -0
  1173. package/dist/src/web-ui/system-host-setup/local-request-authority.js +15 -0
  1174. package/dist/src/web-ui/system-host-setup/local-setup-availability.js +2 -12
  1175. package/dist/src/web-ui/system-host-setup/native-permission-route.d.ts +26 -0
  1176. package/dist/src/web-ui/system-host-setup/native-permission-route.js +96 -0
  1177. package/dist/src/web-ui/system-host-setup/permission-route.d.ts +13 -0
  1178. package/dist/src/web-ui/system-host-setup/permission-route.js +102 -0
  1179. package/dist/src/web-ui/system-host-setup/routes.d.ts +2 -0
  1180. package/dist/src/web-ui/system-host-setup/routes.js +32 -9
  1181. package/dist/src/web-ui/system-host-setup/setup-mutation.d.ts +9 -0
  1182. package/dist/src/web-ui/system-host-setup/setup-mutation.js +27 -0
  1183. package/dist/src/web-ui/system-host-setup/windows-store-route.d.ts +13 -0
  1184. package/dist/src/web-ui/system-host-setup/windows-store-route.js +68 -0
  1185. package/docs/configuration.md +46 -0
  1186. package/docs/installation.md +87 -34
  1187. package/docs/plugins.md +218 -13
  1188. package/docs/projects-and-full-plus.md +2 -6
  1189. package/docs/runtime-library.md +0 -1
  1190. package/docs/runtime-public-contracts.md +7 -2
  1191. package/docs/tool-execution-result-evidence-contract.md +11 -4
  1192. package/docs/windows-companion-store.md +127 -0
  1193. package/package.json +3 -3
  1194. package/plugins/capability-brief/src/index.cjs +85 -37
  1195. package/plugins/code-outline/source/index.ts +7 -2
  1196. package/plugins/code-outline/src/index.cjs +91 -39
  1197. package/plugins/document-reader/plugin.json +19 -3
  1198. package/plugins/document-reader/skills/document_reader_skill/SKILL.md +6 -6
  1199. package/plugins/document-reader/source/source-resolution.ts +1 -1
  1200. package/plugins/document-reader/src/index.cjs +86 -38
  1201. package/plugins/exec/plugin.json +6 -3
  1202. package/plugins/exec/source/handlers.ts +78 -20
  1203. package/plugins/exec/source/output-contracts.ts +45 -0
  1204. package/plugins/exec/source/output-files.ts +161 -0
  1205. package/plugins/exec/source/output-maintenance.ts +60 -0
  1206. package/plugins/exec/source/output-range-reader.ts +97 -0
  1207. package/plugins/exec/source/output-retention.ts +34 -0
  1208. package/plugins/exec/source/output-snapshot.ts +54 -0
  1209. package/plugins/exec/source/output-store.ts +182 -0
  1210. package/plugins/exec/source/output-utf8-boundary.ts +14 -0
  1211. package/plugins/exec/source/output-writer.ts +131 -0
  1212. package/plugins/exec/source/process-manager.ts +142 -70
  1213. package/plugins/exec/source/process-output-buffer.ts +13 -18
  1214. package/plugins/exec/source/process-output.ts +158 -0
  1215. package/plugins/exec/source/request-resources.ts +28 -12
  1216. package/plugins/exec/source/result-presentation.ts +39 -39
  1217. package/plugins/exec/source/retained-output-failure.ts +51 -0
  1218. package/plugins/exec/source/settings.ts +9 -10
  1219. package/plugins/exec/source/terminal-delivery.ts +49 -0
  1220. package/plugins/exec/source/types.ts +12 -1
  1221. package/plugins/exec/src/index.cjs +1112 -188
  1222. package/plugins/filesystem/plugin.json +7 -5
  1223. package/plugins/filesystem/skills/read_file_skill/SKILL.md +1 -1
  1224. package/plugins/filesystem/src/index.cjs +85 -37
  1225. package/plugins/json-inspector/source/index.ts +7 -2
  1226. package/plugins/json-inspector/src/index.cjs +91 -39
  1227. package/plugins/local-search/plugin.json +1 -0
  1228. package/plugins/local-search/source/index.ts +9 -4
  1229. package/plugins/local-search/src/index.cjs +93 -41
  1230. package/plugins/memory/src/index.cjs +85 -37
  1231. package/plugins/project-orientation/source/index.ts +9 -4
  1232. package/plugins/project-orientation/src/index.cjs +93 -41
  1233. package/plugins/system/README.md +43 -3
  1234. package/plugins/system/plugin.json +7 -2
  1235. package/plugins/system/source/companion-command-output.ts +82 -0
  1236. package/plugins/system/source/computer/observation-output.ts +1 -1
  1237. package/plugins/system/source/host-dispatch.ts +4 -0
  1238. package/plugins/system/source/index.ts +11 -5
  1239. package/plugins/system/source/local-command-output.ts +61 -0
  1240. package/plugins/system/source/request-system-modules.ts +2 -0
  1241. package/plugins/system/src/index.cjs +562 -82
  1242. package/plugins/system-probe/source/index.ts +7 -2
  1243. package/plugins/system-probe/src/index.cjs +91 -39
  1244. package/plugins/web/README.md +11 -2
  1245. package/plugins/web/plugin.json +4 -0
  1246. package/plugins/web/source/plugin.ts +5 -3
  1247. package/plugins/web/source/research.ts +7 -7
  1248. package/plugins/web/src/index.cjs +96 -43
  1249. package/runtime.config.schema.json +25 -1
  1250. package/src/runtime/README.md +112 -13
  1251. package/src/runtime/scheduler/README.md +63 -0
  1252. package/dist/src/web-ui/app/components/passive-learning/proposal-notifications.js +0 -106
  1253. package/dist/src/web-ui/app/components/passive-learning/proposal-read-state.js +0 -23
  1254. package/dist/src/web-ui/app/components/passive-learning/proposal-view.js +0 -23
  1255. package/dist/src/web-ui/app/components/spark-conversation-actions.js +0 -62
  1256. package/dist/src/web-ui/app/services/spark-conversation-preferences.js +0 -27
  1257. package/dist/src/web-ui/app/styles/29-spark-conversation.css +0 -19
  1258. package/dist/src/web-ui/system-host-setup/companion-windows.d.ts +0 -2
  1259. package/dist/src/web-ui/system-host-setup/companion-windows.js +0 -108
  1260. package/docs/publishing.md +0 -167
@@ -0,0 +1,83 @@
1
+ import type { SchedulerAutomationRun } from "../scheduler/contracts.js";
2
+ import type { AutomationRevision } from "./definition-contracts.js";
3
+ import type { AutomationPersistence } from "./persistence.js";
4
+ import type { AutomationResultStore } from "./result-store.js";
5
+ import type { AutomationAttemptRecord, AutomationExecutionRecord, AutomationResultRecord } from "./storage-records.js";
6
+ import { type AutomationRunEffectSummary } from "./step-evidence-effects.js";
7
+ export type AutomationRunReport = Readonly<{
8
+ runId: string;
9
+ automationId: string;
10
+ definitionRevision: number;
11
+ outcome: "succeeded" | "completed_with_skips" | "failed" | "cancelled" | "interrupted" | "missed";
12
+ startedAt: string | null;
13
+ finishedAt: string;
14
+ inputIds: readonly string[];
15
+ inputVersions: readonly Readonly<{
16
+ inputId: string;
17
+ sourceId: string;
18
+ canonicalPath: string;
19
+ contentVersion: string;
20
+ }>[];
21
+ nodeResults: readonly Readonly<{
22
+ nodeId: string;
23
+ title?: string;
24
+ status: string;
25
+ errorCode?: string;
26
+ resultRef?: string;
27
+ }>[];
28
+ uncertainEffects: readonly Readonly<{
29
+ nodeId: string;
30
+ attemptId: string;
31
+ }>[];
32
+ /** Supplemental evidence does not change the terminal run outcome. */
33
+ lateEvidence: readonly Readonly<{
34
+ nodeId: string;
35
+ attemptId: string;
36
+ revision: number;
37
+ observedAt: string;
38
+ status: "succeeded" | "failed" | "rejected";
39
+ errorCode?: string;
40
+ }>[];
41
+ artifacts: readonly Readonly<{
42
+ id: string;
43
+ nodeId?: string;
44
+ kind: string;
45
+ }>[];
46
+ effectSummary?: AutomationRunEffectSummary;
47
+ modelCalls: number | null;
48
+ toolCalls: number | null;
49
+ /** Admitted attempts consume the tool limit even when execution is rejected. */
50
+ toolAttempts?: number;
51
+ }>;
52
+ export declare function verifiedToolCallCount(summary: AutomationRunEffectSummary | undefined, admittedAttempts: number): number | null;
53
+ export declare function createAutomationReportService(options: {
54
+ persistence: AutomationPersistence;
55
+ results: AutomationResultStore;
56
+ now?: () => number;
57
+ }): {
58
+ create: (input: {
59
+ run: SchedulerAutomationRun;
60
+ definition: AutomationRevision;
61
+ outcome: AutomationRunReport["outcome"];
62
+ }) => Promise<{
63
+ report: AutomationRunReport;
64
+ record: AutomationResultRecord;
65
+ }>;
66
+ };
67
+ export declare function buildAutomationRunReport(input: {
68
+ run: SchedulerAutomationRun;
69
+ definition: AutomationRevision;
70
+ execution: AutomationExecutionRecord;
71
+ inputs: readonly {
72
+ id: string;
73
+ sourceId: string;
74
+ canonicalPath: string;
75
+ contentVersion: string;
76
+ }[];
77
+ attempts: readonly Pick<AutomationAttemptRecord, "id" | "nodeId" | "state" | "lateSettlement">[];
78
+ results: readonly AutomationResultRecord[];
79
+ outcome: AutomationRunReport["outcome"];
80
+ finishedAt: string;
81
+ effectSummary?: AutomationRunEffectSummary;
82
+ }): AutomationRunReport;
83
+ export declare function projectAutomationLateEvidence(attempts: readonly Pick<AutomationAttemptRecord, "id" | "nodeId" | "lateSettlement">[]): AutomationRunReport["lateEvidence"];
@@ -0,0 +1,121 @@
1
+ import { remainingAutomationResultBytes, requireAutomationResultCapacity } from "./result-capacity.js";
2
+ import { publishAutomationResult } from "./result-publication.js";
3
+ import { findAutomationStep, readAutomationRunEffectSummary, } from "./step-evidence-effects.js";
4
+ export function verifiedToolCallCount(summary, admittedAttempts) {
5
+ if (!summary)
6
+ return admittedAttempts === 0 ? 0 : null;
7
+ if (summary.unresolvedAttempts > 0)
8
+ return null;
9
+ return summary.verifiedExecutions;
10
+ }
11
+ export function createAutomationReportService(options) {
12
+ const now = options.now ?? Date.now;
13
+ async function create(input) {
14
+ const state = await options.persistence.read();
15
+ const execution = state.executions.find((item) => item.id === input.run.id);
16
+ if (!execution)
17
+ throw new Error("automation_run_not_found");
18
+ const effectSummary = await readAutomationRunEffectSummary({
19
+ state, results: options.results, runId: input.run.id, definition: input.definition,
20
+ });
21
+ const report = buildAutomationRunReport({
22
+ run: input.run,
23
+ definition: input.definition,
24
+ execution,
25
+ inputs: state.inputs.filter((item) => execution.inputIds.includes(item.id)),
26
+ attempts: state.attempts.filter((item) => item.runId === input.run.id),
27
+ results: state.results.filter((item) => item.runId === input.run.id),
28
+ outcome: input.outcome,
29
+ finishedAt: new Date(now()).toISOString(),
30
+ effectSummary,
31
+ });
32
+ const usedBytes = state.results
33
+ .filter((item) => item.runId === input.run.id)
34
+ .reduce((sum, item) => sum + item.sizeBytes, 0);
35
+ const remaining = input.definition.limits.maxStoredArtifactBytes - usedBytes;
36
+ const record = await options.results.save({
37
+ runId: input.run.id,
38
+ kind: "report",
39
+ value: report,
40
+ maxBytes: Math.min(remaining, remainingAutomationResultBytes(state)),
41
+ at: report.finishedAt,
42
+ });
43
+ await publishAutomationResult({ ...options, record,
44
+ publish: () => options.persistence.update((current) => {
45
+ if (!current.executions.some((item) => item.id === input.run.id))
46
+ throw new Error("automation_run_not_found");
47
+ if (current.results.some((item) => item.id === record.id))
48
+ throw new Error("automation_result_duplicate");
49
+ const used = current.results.filter((item) => item.runId === input.run.id)
50
+ .reduce((sum, item) => sum + item.sizeBytes, record.sizeBytes);
51
+ if (used > input.definition.limits.maxStoredArtifactBytes)
52
+ throw new Error("automation_artifact_budget_exhausted");
53
+ requireAutomationResultCapacity(current, record.sizeBytes);
54
+ current.results.push(record);
55
+ }),
56
+ });
57
+ return { report, record };
58
+ }
59
+ return { create };
60
+ }
61
+ export function buildAutomationRunReport(input) {
62
+ const hasAgent = input.execution.nodes.some((node) => containsAgent(input.definition.body, node.nodeId));
63
+ return {
64
+ runId: input.run.id,
65
+ automationId: input.execution.automationId,
66
+ definitionRevision: input.execution.definitionRevision,
67
+ outcome: input.outcome,
68
+ startedAt: input.run.startedAt ?? null,
69
+ finishedAt: input.finishedAt,
70
+ inputIds: input.execution.inputIds,
71
+ inputVersions: input.inputs.map((item) => ({
72
+ inputId: item.id,
73
+ sourceId: item.sourceId,
74
+ canonicalPath: item.canonicalPath,
75
+ contentVersion: item.contentVersion,
76
+ })),
77
+ nodeResults: input.execution.nodes.map((node) => {
78
+ const step = findAutomationStep(input.definition.body, node.nodeId);
79
+ return {
80
+ nodeId: node.nodeId,
81
+ ...(step ? { title: step.title } : {}),
82
+ status: node.status,
83
+ ...(node.errorCode ? { errorCode: node.errorCode } : {}),
84
+ ...(node.resultRef ? { resultRef: node.resultRef } : {}),
85
+ };
86
+ }),
87
+ uncertainEffects: input.attempts
88
+ .filter((attempt) => attempt.state === "uncertain" || attempt.state === "started")
89
+ .map((attempt) => ({ nodeId: attempt.nodeId, attemptId: attempt.id })),
90
+ lateEvidence: projectAutomationLateEvidence(input.attempts),
91
+ artifacts: input.results
92
+ .filter((result) => result.kind === "artifact")
93
+ .map((result) => ({
94
+ id: result.id,
95
+ ...(result.nodeId ? { nodeId: result.nodeId } : {}),
96
+ kind: result.kind,
97
+ })),
98
+ ...(input.effectSummary ? { effectSummary: input.effectSummary } : {}),
99
+ modelCalls: input.execution.modelCalls ?? (hasAgent ? null : 0),
100
+ // A durable pre-dispatch attempt is not proof that the invocation ran.
101
+ toolCalls: verifiedToolCallCount(input.effectSummary, input.attempts.length),
102
+ toolAttempts: input.attempts.length,
103
+ };
104
+ }
105
+ export function projectAutomationLateEvidence(attempts) {
106
+ return attempts.flatMap((attempt) => attempt.lateSettlement ? [{
107
+ nodeId: attempt.nodeId,
108
+ attemptId: attempt.id,
109
+ ...attempt.lateSettlement,
110
+ }] : []);
111
+ }
112
+ function containsAgent(node, nodeId) {
113
+ const stack = [node];
114
+ while (stack.length > 0) {
115
+ const current = stack.pop();
116
+ if (current.id === nodeId)
117
+ return current.kind === "agent";
118
+ stack.push(...(current.children ?? []), ...(current.branches ?? []));
119
+ }
120
+ return false;
121
+ }
@@ -0,0 +1,16 @@
1
+ import type { RuntimeAttachmentStore } from "../attachments/store.js";
2
+ import type { RuntimeConfig, SessionStore } from "../ports.js";
3
+ import type { SchedulerAutomationExecutor, SchedulerAutomationJob, SchedulerAutomationRun, SchedulerAutomationRunOutcome } from "../scheduler/contracts.js";
4
+ import type { AutomationPersistence } from "./persistence.js";
5
+ import type { AutomationResultStore } from "./result-store.js";
6
+ import type { AutomationToolLifetimes } from "./tool-lifetimes.js";
7
+ export declare function createAutomationRuntimeExecutor(options: {
8
+ config: RuntimeConfig;
9
+ sessions?: SessionStore;
10
+ persistence: AutomationPersistence;
11
+ attachments: RuntimeAttachmentStore;
12
+ results: AutomationResultStore;
13
+ toolLifetimes: AutomationToolLifetimes;
14
+ execute(job: SchedulerAutomationJob, run: SchedulerAutomationRun, signal: AbortSignal): Promise<SchedulerAutomationRunOutcome>;
15
+ now?: () => number;
16
+ }): Omit<SchedulerAutomationExecutor, "tryReserve">;
@@ -0,0 +1,260 @@
1
+ import { deleteSessionAttachmentsIfSupported } from "../session/session-attachment-deletion.js";
2
+ import { traceDebug } from "../observability/debug-logger.js";
3
+ import { isAutomationSchedulerRun } from "../scheduler/scheduler-target.js";
4
+ import { createAutomationOccurrencePreparer } from "./occurrence-preparation.js";
5
+ import { createAutomationReplayPreparer } from "./replay-preparation.js";
6
+ import { holdInterruptedInputs, releaseNeverDispatchedInputs } from "./input-ledger.js";
7
+ import { DEFAULT_AUTOMATION_LIMITS } from "./limits.js";
8
+ import { recordAutomationLateSettlements } from "./late-settlement.js";
9
+ import { maintainAutomationRetention } from "./retention.js";
10
+ import { createAutomationSnapshotStaging } from "./snapshot-staging.js";
11
+ const DERIVED_REPORT = (runId) => `derived:${runId}`;
12
+ function requireExecution(state, runId) {
13
+ const execution = state.executions.find((item) => item.id === runId);
14
+ if (!execution)
15
+ throw new Error("automation_execution_checkpoint_missing");
16
+ return execution;
17
+ }
18
+ function replaceExecution(state, execution, update) {
19
+ const index = state.executions.findIndex((item) => item.id === execution.id);
20
+ if (index < 0)
21
+ throw new Error("automation_execution_checkpoint_missing");
22
+ state.executions[index] = { ...execution, ...update, revision: execution.revision + 1 };
23
+ }
24
+ function stoppedNodes(nodes, uncertain) {
25
+ return nodes.map((node) => {
26
+ if (node.status === "running")
27
+ return {
28
+ ...node,
29
+ status: "interrupted",
30
+ errorCode: uncertain ? "automation_effect_uncertain" : "automation_run_stopped",
31
+ };
32
+ if (node.status === "pending" || node.status === "ready")
33
+ return {
34
+ ...node,
35
+ status: "cancelled",
36
+ errorCode: "automation_run_stopped",
37
+ };
38
+ return node;
39
+ });
40
+ }
41
+ function markUnsettledAttempts(state, runId) {
42
+ let uncertain = false;
43
+ state.attempts = state.attempts.map((attempt) => {
44
+ if (attempt.runId !== runId)
45
+ return attempt;
46
+ if (attempt.state === "uncertain") {
47
+ uncertain = true;
48
+ return attempt;
49
+ }
50
+ if (attempt.state !== "started")
51
+ return attempt;
52
+ uncertain = true;
53
+ return { ...attempt, state: "uncertain" };
54
+ });
55
+ return uncertain;
56
+ }
57
+ function markInputOutcome(state, runId, reportRef, hold) {
58
+ state.inputs = state.inputs.map((record) => record.claimRunId !== runId
59
+ ? record
60
+ : {
61
+ ...record,
62
+ ...(hold ? { eligibility: "held" } : {}),
63
+ outcomeRef: reportRef,
64
+ });
65
+ }
66
+ export function createAutomationRuntimeExecutor(options) {
67
+ const active = new Map();
68
+ const stopsBeforeStart = new Set();
69
+ const snapshots = createAutomationSnapshotStaging({
70
+ runtimeDir: options.config.paths.runtimeDir,
71
+ persistence: options.persistence, attachments: options.attachments,
72
+ });
73
+ const prepare = createAutomationOccurrencePreparer({ ...options, snapshots });
74
+ const prepareReplay = createAutomationReplayPreparer(options);
75
+ let lastMaintenanceAt = Number.NEGATIVE_INFINITY;
76
+ async function reconcileSessions() {
77
+ const reportFailure = (sessionId, error) => traceDebug("runtime.automations", "agent_session.recovery_failed", {
78
+ sessionId, error: error instanceof Error ? error.message : String(error),
79
+ });
80
+ try {
81
+ await options.sessions?.reconcileAutomationSessions?.((id) => deleteSessionAttachmentsIfSupported(options.attachments, id), reportFailure);
82
+ }
83
+ catch (error) {
84
+ reportFailure("", error);
85
+ }
86
+ }
87
+ async function maintainRetention(now) {
88
+ if (now - lastMaintenanceAt < 5 * 60_000)
89
+ return;
90
+ lastMaintenanceAt = now;
91
+ await reconcileSessions();
92
+ await snapshots.reconcile();
93
+ await maintainAutomationRetention({
94
+ persistence: options.persistence,
95
+ results: options.results,
96
+ attachments: options.attachments,
97
+ now,
98
+ });
99
+ }
100
+ function signalStop(runId) {
101
+ const execution = active.get(runId);
102
+ if (!execution) {
103
+ stopsBeforeStart.add(runId);
104
+ return;
105
+ }
106
+ if (execution.stopRequested)
107
+ return;
108
+ execution.stopRequested = true;
109
+ execution.controller.abort(new Error("automation_run_stopped"));
110
+ if (execution.deadlineMs !== undefined)
111
+ scheduleDeadline(runId, execution);
112
+ }
113
+ function scheduleDeadline(runId, execution) {
114
+ if (execution.deadlineTimer)
115
+ return;
116
+ execution.deadlineTimer = setTimeout(() => execution.publishDeadline({
117
+ status: "cancelled",
118
+ error: "automation_stop_deadline_elapsed",
119
+ reportRef: DERIVED_REPORT(runId),
120
+ }), execution.deadlineMs ?? DEFAULT_AUTOMATION_LIMITS.stopReportDeadlineMs);
121
+ execution.deadlineTimer.unref();
122
+ }
123
+ function scheduleBudgetDeadline(runId, execution, durationMs) {
124
+ execution.budgetTimer = setTimeout(() => {
125
+ execution.controller.abort(new Error("automation_run_duration_exceeded"));
126
+ execution.publishDeadline({
127
+ status: execution.stopRequested ? "cancelled" : "failed",
128
+ error: "automation_run_deadline_elapsed",
129
+ reportRef: DERIVED_REPORT(runId),
130
+ });
131
+ }, durationMs);
132
+ execution.budgetTimer.unref();
133
+ }
134
+ function start(job, run) {
135
+ let publishDeadline;
136
+ const deadline = new Promise((resolve) => {
137
+ publishDeadline = resolve;
138
+ });
139
+ const execution = {
140
+ controller: new AbortController(),
141
+ stopRequested: false,
142
+ publishDeadline,
143
+ };
144
+ active.set(run.id, execution);
145
+ if (stopsBeforeStart.delete(run.id))
146
+ signalStop(run.id);
147
+ const actual = (async () => {
148
+ const state = await options.persistence.read();
149
+ const definition = state.definitions.find((item) => item.automationId === run.target.automationId &&
150
+ item.revision === run.target.definitionRevision)?.definition;
151
+ if (!definition)
152
+ throw new Error("automation_definition_not_found");
153
+ execution.deadlineMs = definition.limits.stopReportDeadlineMs;
154
+ if (execution.stopRequested)
155
+ scheduleDeadline(run.id, execution);
156
+ if (execution.controller.signal.aborted)
157
+ return {
158
+ status: "cancelled",
159
+ reportRef: DERIVED_REPORT(run.id),
160
+ };
161
+ scheduleBudgetDeadline(run.id, execution, definition.limits.maxRunDurationMs + definition.limits.stopReportDeadlineMs);
162
+ return options.execute(job, run, execution.controller.signal);
163
+ })().catch((error) => ({
164
+ status: "failed",
165
+ error: error instanceof Error ? error.message : String(error),
166
+ reportRef: DERIVED_REPORT(run.id),
167
+ }));
168
+ const outcome = Promise.race([actual, deadline]);
169
+ // Terminal deadlines detach stalled graph/model work. Tool dispatch is fenced
170
+ // by the aborted signal, and every admitted Tool promise still drains below.
171
+ const resourcesSettled = outcome.then(() => undefined).finally(async () => {
172
+ try {
173
+ const observed = await options.toolLifetimes.whenSettled(run.id);
174
+ await recordAutomationLateSettlements({
175
+ persistence: options.persistence,
176
+ runId: run.id,
177
+ observed,
178
+ now: options.now,
179
+ });
180
+ }
181
+ finally {
182
+ cleanup(run.id, execution);
183
+ }
184
+ });
185
+ return { outcome, resourcesSettled };
186
+ }
187
+ function cleanup(runId, execution) {
188
+ if (execution.deadlineTimer)
189
+ clearTimeout(execution.deadlineTimer);
190
+ if (execution.budgetTimer)
191
+ clearTimeout(execution.budgetTimer);
192
+ if (active.get(runId) === execution)
193
+ active.delete(runId);
194
+ }
195
+ function recover(scheduler, automations, recoveredRunIds) {
196
+ for (const runId of recoveredRunIds) {
197
+ const run = scheduler.runs.find((item) => item.id === runId);
198
+ if (!run || !isAutomationSchedulerRun(run))
199
+ throw new Error("automation_run_not_found");
200
+ let execution = automations.executions.find((item) => item.id === runId);
201
+ if (!execution) {
202
+ execution = {
203
+ id: runId,
204
+ automationId: run.target.automationId,
205
+ definitionRevision: run.target.definitionRevision,
206
+ revision: 1,
207
+ inputIds: [],
208
+ nodes: [],
209
+ };
210
+ automations.executions.push(execution);
211
+ }
212
+ const missed = run.status === "missed";
213
+ if (missed)
214
+ releaseNeverDispatchedInputs(automations, runId);
215
+ else
216
+ holdInterruptedInputs(automations, runId);
217
+ const uncertain = missed ? false : markUnsettledAttempts(automations, runId);
218
+ replaceExecution(automations, execution, {
219
+ nodes: stoppedNodes(execution.nodes, uncertain),
220
+ reportRef: DERIVED_REPORT(runId),
221
+ terminalAt: new Date(options.now?.() ?? Date.now()).toISOString(),
222
+ });
223
+ run.reportRef = DERIVED_REPORT(runId);
224
+ }
225
+ }
226
+ function settle(run, state, outcome) {
227
+ const execution = requireExecution(state, run.id);
228
+ if (!outcome.reportRef)
229
+ throw new Error("automation_report_missing");
230
+ const derived = outcome.reportRef === DERIVED_REPORT(run.id);
231
+ const successful = outcome.status === "succeeded" ||
232
+ outcome.status === "completed_with_skips";
233
+ if (derived && successful && (execution.nodes.some((node) => node.status === "pending" || node.status === "ready" || node.status === "running") ||
234
+ state.attempts.some((item) => item.runId === run.id && item.state !== "settled")))
235
+ throw new Error("automation_run_not_settled");
236
+ if (!derived && !state.results.some((item) => item.id === outcome.reportRef &&
237
+ item.runId === run.id && item.kind === "report"))
238
+ throw new Error("automation_report_missing");
239
+ const uncertain = derived ? markUnsettledAttempts(state, run.id) :
240
+ state.attempts.some((item) => item.runId === run.id &&
241
+ (item.state === "started" || item.state === "uncertain"));
242
+ replaceExecution(state, execution, {
243
+ ...(derived ? { nodes: stoppedNodes(execution.nodes, uncertain) } : {}),
244
+ reportRef: outcome.reportRef,
245
+ terminalAt: new Date(options.now?.() ?? Date.now()).toISOString(),
246
+ });
247
+ markInputOutcome(state, run.id, outcome.reportRef, uncertain || (derived && !successful));
248
+ }
249
+ function cancelPending(run, state) {
250
+ const execution = requireExecution(state, run.id);
251
+ releaseNeverDispatchedInputs(state, run.id);
252
+ replaceExecution(state, execution, {
253
+ nodes: stoppedNodes(execution.nodes, false),
254
+ reportRef: DERIVED_REPORT(run.id),
255
+ terminalAt: new Date(options.now?.() ?? Date.now()).toISOString(),
256
+ });
257
+ }
258
+ return { prepare, prepareReplay, start, stop: signalStop, recover, settle,
259
+ cancelPending, maintainRetention, reconcileSessions };
260
+ }
@@ -0,0 +1,16 @@
1
+ import type { AutomationPersistence } from "./persistence.js";
2
+ import type { AutomationSavedAgentRecord } from "./storage-records.js";
3
+ export declare function createAutomationSavedAgentManager(options: {
4
+ persistence: AutomationPersistence;
5
+ now?: () => number;
6
+ }): {
7
+ get: (agentId: string, revision?: number) => Promise<AutomationSavedAgentRecord | null>;
8
+ list: () => Promise<AutomationSavedAgentRecord[]>;
9
+ saveFromDraft: (input: {
10
+ automationId: string;
11
+ nodeId: string;
12
+ expectedDraftRevision: number;
13
+ agentId?: string;
14
+ expectedAgentRevision?: number;
15
+ }) => Promise<AutomationSavedAgentRecord>;
16
+ };
@@ -0,0 +1,94 @@
1
+ import { randomUUID } from "node:crypto";
2
+ function findAgent(node, nodeId) {
3
+ if (node.id === nodeId)
4
+ return node.kind === "agent" ? node : undefined;
5
+ if (node.kind === "sequence") {
6
+ for (const child of node.children) {
7
+ const found = findAgent(child, nodeId);
8
+ if (found)
9
+ return found;
10
+ }
11
+ }
12
+ if (node.kind === "parallel") {
13
+ for (const branch of node.branches) {
14
+ const found = findAgent(branch, nodeId);
15
+ if (found)
16
+ return found;
17
+ }
18
+ }
19
+ return undefined;
20
+ }
21
+ /** A reusable step template. Runtime inputs, prior grants and execution state never enter it. */
22
+ function snapshotAgent(agent, id) {
23
+ return structuredClone({
24
+ kind: "agent",
25
+ id,
26
+ title: agent.title,
27
+ onFailure: agent.onFailure,
28
+ modelProfileId: agent.modelProfileId,
29
+ agentMode: agent.agentMode,
30
+ roleInstructions: agent.roleInstructions,
31
+ prompt: agent.prompt,
32
+ inputs: {},
33
+ tools: agent.tools,
34
+ result: agent.result,
35
+ ...(agent.acceptance ? { acceptance: agent.acceptance } : {}),
36
+ });
37
+ }
38
+ export function createAutomationSavedAgentManager(options) {
39
+ const now = options.now ?? Date.now;
40
+ async function get(agentId, revision) {
41
+ const state = await options.persistence.read();
42
+ return state.savedAgents
43
+ .filter((record) => record.agentId === agentId &&
44
+ (revision === undefined || record.revision === revision))
45
+ .sort((left, right) => right.revision - left.revision)[0] ?? null;
46
+ }
47
+ async function list() {
48
+ const state = await options.persistence.read();
49
+ const latest = new Map();
50
+ for (const record of state.savedAgents) {
51
+ const previous = latest.get(record.agentId);
52
+ if (!previous || record.revision > previous.revision)
53
+ latest.set(record.agentId, record);
54
+ }
55
+ return [...latest.values()].sort((left, right) => left.agent.title.localeCompare(right.agent.title));
56
+ }
57
+ async function saveFromDraft(input) {
58
+ if (!Number.isSafeInteger(input.expectedDraftRevision) || input.expectedDraftRevision < 1)
59
+ throw new Error("automation_revision_conflict");
60
+ if (input.agentId && (!Number.isSafeInteger(input.expectedAgentRevision) ||
61
+ Number(input.expectedAgentRevision) < 1))
62
+ throw new Error("automation_revision_conflict");
63
+ if (!input.agentId && input.expectedAgentRevision !== undefined)
64
+ throw new Error("automation_revision_conflict");
65
+ return options.persistence.update((state) => {
66
+ const draft = state.drafts.find((record) => record.automationId === input.automationId);
67
+ if (!draft)
68
+ throw new Error("automation_not_found");
69
+ if (draft.revision !== input.expectedDraftRevision)
70
+ throw new Error("automation_revision_conflict");
71
+ const agent = findAgent(draft.definition.body, input.nodeId);
72
+ if (!agent)
73
+ throw new Error("automation_dependency_missing");
74
+ const prior = input.agentId
75
+ ? state.savedAgents.filter((record) => record.agentId === input.agentId)
76
+ .sort((left, right) => right.revision - left.revision)[0]
77
+ : undefined;
78
+ if (input.agentId && (!prior || prior.revision !== input.expectedAgentRevision))
79
+ throw new Error("automation_revision_conflict");
80
+ const agentId = input.agentId ?? randomUUID();
81
+ const revision = (prior?.revision ?? 0) + 1;
82
+ const saved = {
83
+ id: `agent:${agentId}:${revision}`,
84
+ agentId,
85
+ revision,
86
+ agent: snapshotAgent(agent, `n_${randomUUID().replaceAll("-", "")}`),
87
+ updatedAt: new Date(now()).toISOString(),
88
+ };
89
+ state.savedAgents.push(saved);
90
+ return saved;
91
+ });
92
+ }
93
+ return { get, list, saveFromDraft };
94
+ }