@abot-ai/runtime 1.5.0 → 1.6.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 (984) hide show
  1. package/dist/src/bridge/start-agent-bridge.js +22 -0
  2. package/dist/src/capabilities/normal-invocation/contracts.d.ts +11 -0
  3. package/dist/src/capabilities/normal-invocation/contracts.js +1 -0
  4. package/dist/src/capabilities/normal-invocation/validator.js +40 -4
  5. package/dist/src/capabilities/result-budget.d.ts +17 -0
  6. package/dist/src/capabilities/result-budget.js +21 -0
  7. package/dist/src/capabilities/tool-context-text.d.ts +16 -0
  8. package/dist/src/capabilities/tool-context-text.js +30 -0
  9. package/dist/src/capabilities/tool-definition-validator/definition-parser.js +6 -0
  10. package/dist/src/capabilities/tool-definition-validator/event-input-text-options.js +3 -2
  11. package/dist/src/capabilities/tool-event-input-text.d.ts +1 -0
  12. package/dist/src/capabilities/tool-event-input-text.js +2 -1
  13. package/dist/src/capabilities/tool-executor.d.ts +3 -1
  14. package/dist/src/capabilities/tool-executor.js +29 -50
  15. package/dist/src/capabilities/tool-interruption.d.ts +3 -0
  16. package/dist/src/capabilities/tool-interruption.js +6 -0
  17. package/dist/src/capabilities/tool-result-normalization.d.ts +18 -0
  18. package/dist/src/capabilities/tool-result-normalization.js +68 -0
  19. package/dist/src/capabilities/tool-types.d.ts +25 -2
  20. package/dist/src/cli/host-companion-bundle.mjs +474 -212
  21. package/dist/src/cli/host-companion.js +6 -0
  22. package/dist/src/cli/host-permissions.d.ts +7 -0
  23. package/dist/src/cli/host-permissions.js +24 -0
  24. package/dist/src/computer-access/companion/native-messages.js +1 -0
  25. package/dist/src/computer-access/companion/native-permissions.d.ts +14 -0
  26. package/dist/src/computer-access/companion/native-permissions.js +49 -0
  27. package/dist/src/computer-access/companion/native-session.js +4 -0
  28. package/dist/src/computer-access/companion/notification-installation.js +2 -15
  29. package/dist/src/computer-access/companion/notification-macos-bundle.d.ts +3 -0
  30. package/dist/src/computer-access/companion/notification-macos-bundle.js +84 -0
  31. package/dist/src/computer-access/companion/notification-macos.js +1 -1
  32. package/dist/src/computer-access/companion/notification-protocol.d.ts +1 -1
  33. package/dist/src/computer-access/companion/notification-protocol.js +20 -1
  34. package/dist/src/computer-access/companion/notification-readiness.js +2 -1
  35. package/dist/src/computer-access/companion/permission-protocol.d.ts +22 -0
  36. package/dist/src/computer-access/companion/permission-protocol.js +45 -0
  37. package/dist/src/computer-access/companion/protocol.d.ts +2 -1
  38. package/dist/src/computer-access/companion/protocol.js +3 -0
  39. package/dist/src/computer-access/companion/release-version.d.ts +1 -1
  40. package/dist/src/computer-access/companion/release-version.js +1 -1
  41. package/dist/src/computer-access/companion/spark-notification-query.d.ts +2 -0
  42. package/dist/src/computer-access/companion/spark-notification-query.js +62 -0
  43. package/dist/src/computer-access/computer/macos-desktop.js +1 -1
  44. package/dist/src/computer-access/computer/macos-input.js +2 -5
  45. package/dist/src/computer-access/computer/macos-permission-helper.d.ts +4 -0
  46. package/dist/src/computer-access/computer/macos-permission-helper.js +38 -0
  47. package/dist/src/computer-access/host-observation.d.ts +3 -3
  48. package/dist/src/computer-access/native-permission-contract.d.ts +23 -0
  49. package/dist/src/computer-access/native-permission-contract.js +38 -0
  50. package/dist/src/model-gateway/policy/invocation-policy.js +10 -1
  51. package/dist/src/model-gateway/providers/openai/payload.js +8 -0
  52. package/dist/src/model-gateway/structured-output/ollama-format.js +5 -0
  53. package/dist/src/model-gateway/structured-output/openai-format.js +5 -0
  54. package/dist/src/model-gateway/types.d.ts +3 -0
  55. package/dist/src/plugin-contract/manifest.d.ts +2 -1
  56. package/dist/src/plugin-sdk/context-text-result.d.ts +10 -0
  57. package/dist/src/plugin-sdk/context-text-result.js +19 -0
  58. package/dist/src/plugin-sdk/index.d.ts +1 -0
  59. package/dist/src/plugin-sdk/index.js +1 -0
  60. package/dist/src/plugin-sdk/results.d.ts +7 -4
  61. package/dist/src/plugin-sdk/results.js +35 -10
  62. package/dist/src/runtime/adapters/co-worker-resources.d.ts +2 -0
  63. package/dist/src/runtime/adapters/co-worker-resources.js +2 -2
  64. package/dist/src/runtime/adapters/file-session-store.js +6 -0
  65. package/dist/src/runtime/adapters/in-memory-session-store.js +14 -1
  66. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.d.ts +2 -1
  67. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.js +5 -4
  68. package/dist/src/runtime/adapters/passive-learning-runtime.d.ts +2 -1
  69. package/dist/src/runtime/adapters/passive-learning-runtime.js +1 -1
  70. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/prepared-execution.js +77 -26
  71. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/result-budget.d.ts +11 -0
  72. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/result-budget.js +30 -0
  73. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +28 -1
  74. package/dist/src/runtime/adapters/registered-tool-payload-plan.d.ts +3 -3
  75. package/dist/src/runtime/adapters/registered-tool-payload-plan.js +4 -4
  76. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/contracts.d.ts +2 -0
  77. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-authoring-result.js +4 -18
  78. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/prepared-execution.js +3 -3
  79. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-envelope.d.ts +13 -0
  80. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-envelope.js +15 -0
  81. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-evidence.d.ts +3 -7
  82. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-evidence.js +6 -38
  83. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.d.ts +2 -1
  84. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.js +14 -6
  85. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-references.d.ts +9 -0
  86. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-references.js +29 -0
  87. package/dist/src/runtime/adapters/registered-tool-worker-capabilities.js +1 -0
  88. package/dist/src/runtime/adapters/scheduler-executor-dispatch.d.ts +11 -0
  89. package/dist/src/runtime/adapters/scheduler-executor-dispatch.js +10 -0
  90. package/dist/src/runtime/adapters/scheduler-runtime.d.ts +3 -1
  91. package/dist/src/runtime/adapters/scheduler-runtime.js +28 -12
  92. package/dist/src/runtime/automations/agent-assignment.d.ts +8 -0
  93. package/dist/src/runtime/automations/agent-assignment.js +29 -0
  94. package/dist/src/runtime/automations/agent-request-failure.d.ts +2 -0
  95. package/dist/src/runtime/automations/agent-request-failure.js +74 -0
  96. package/dist/src/runtime/automations/agent-session-lifetime.d.ts +11 -0
  97. package/dist/src/runtime/automations/agent-session-lifetime.js +46 -0
  98. package/dist/src/runtime/automations/agent-step-executor.d.ts +35 -0
  99. package/dist/src/runtime/automations/agent-step-executor.js +278 -0
  100. package/dist/src/runtime/automations/agent-tool-scope.d.ts +4 -0
  101. package/dist/src/runtime/automations/agent-tool-scope.js +73 -0
  102. package/dist/src/runtime/automations/archive-management.d.ts +26 -0
  103. package/dist/src/runtime/automations/archive-management.js +50 -0
  104. package/dist/src/runtime/automations/binding-resolution.d.ts +28 -0
  105. package/dist/src/runtime/automations/binding-resolution.js +115 -0
  106. package/dist/src/runtime/automations/branch-result-projection.d.ts +4 -0
  107. package/dist/src/runtime/automations/branch-result-projection.js +15 -0
  108. package/dist/src/runtime/automations/catalog.d.ts +76 -0
  109. package/dist/src/runtime/automations/catalog.js +67 -0
  110. package/dist/src/runtime/automations/definition-contracts.d.ts +128 -0
  111. package/dist/src/runtime/automations/definition-contracts.js +1 -0
  112. package/dist/src/runtime/automations/definition-input.d.ts +3 -0
  113. package/dist/src/runtime/automations/definition-input.js +283 -0
  114. package/dist/src/runtime/automations/dependency-fingerprint.d.ts +9 -0
  115. package/dist/src/runtime/automations/dependency-fingerprint.js +55 -0
  116. package/dist/src/runtime/automations/draft-batch-aliases.d.ts +12 -0
  117. package/dist/src/runtime/automations/draft-batch-aliases.js +94 -0
  118. package/dist/src/runtime/automations/draft-batch.d.ts +29 -0
  119. package/dist/src/runtime/automations/draft-batch.js +147 -0
  120. package/dist/src/runtime/automations/draft-management.d.ts +53 -0
  121. package/dist/src/runtime/automations/draft-management.js +164 -0
  122. package/dist/src/runtime/automations/draft-mutations.d.ts +29 -0
  123. package/dist/src/runtime/automations/draft-mutations.js +219 -0
  124. package/dist/src/runtime/automations/draft-restoration.d.ts +11 -0
  125. package/dist/src/runtime/automations/draft-restoration.js +44 -0
  126. package/dist/src/runtime/automations/effect-admission-lifetime.d.ts +9 -0
  127. package/dist/src/runtime/automations/effect-admission-lifetime.js +31 -0
  128. package/dist/src/runtime/automations/failure-policy.d.ts +8 -0
  129. package/dist/src/runtime/automations/failure-policy.js +9 -0
  130. package/dist/src/runtime/automations/graph-executor.d.ts +23 -0
  131. package/dist/src/runtime/automations/graph-executor.js +227 -0
  132. package/dist/src/runtime/automations/graph-validation.d.ts +29 -0
  133. package/dist/src/runtime/automations/graph-validation.js +271 -0
  134. package/dist/src/runtime/automations/input-batch-selection.d.ts +7 -0
  135. package/dist/src/runtime/automations/input-batch-selection.js +42 -0
  136. package/dist/src/runtime/automations/input-capacity.d.ts +9 -0
  137. package/dist/src/runtime/automations/input-capacity.js +38 -0
  138. package/dist/src/runtime/automations/input-ledger.d.ts +45 -0
  139. package/dist/src/runtime/automations/input-ledger.js +147 -0
  140. package/dist/src/runtime/automations/late-settlement.d.ts +9 -0
  141. package/dist/src/runtime/automations/late-settlement.js +42 -0
  142. package/dist/src/runtime/automations/limits.d.ts +25 -0
  143. package/dist/src/runtime/automations/limits.js +41 -0
  144. package/dist/src/runtime/automations/model-capacity.d.ts +9 -0
  145. package/dist/src/runtime/automations/model-capacity.js +67 -0
  146. package/dist/src/runtime/automations/model-dependency-projection.d.ts +56 -0
  147. package/dist/src/runtime/automations/model-dependency-projection.js +88 -0
  148. package/dist/src/runtime/automations/node-transactions.d.ts +57 -0
  149. package/dist/src/runtime/automations/node-transactions.js +223 -0
  150. package/dist/src/runtime/automations/occurrence-preparation.d.ts +12 -0
  151. package/dist/src/runtime/automations/occurrence-preparation.js +257 -0
  152. package/dist/src/runtime/automations/permission-grants.d.ts +27 -0
  153. package/dist/src/runtime/automations/permission-grants.js +72 -0
  154. package/dist/src/runtime/automations/persistence.d.ts +9 -0
  155. package/dist/src/runtime/automations/persistence.js +13 -0
  156. package/dist/src/runtime/automations/publication-validation.d.ts +16 -0
  157. package/dist/src/runtime/automations/publication-validation.js +162 -0
  158. package/dist/src/runtime/automations/publication.d.ts +33 -0
  159. package/dist/src/runtime/automations/publication.js +97 -0
  160. package/dist/src/runtime/automations/replay-preparation.d.ts +7 -0
  161. package/dist/src/runtime/automations/replay-preparation.js +59 -0
  162. package/dist/src/runtime/automations/result-capacity.d.ts +5 -0
  163. package/dist/src/runtime/automations/result-capacity.js +9 -0
  164. package/dist/src/runtime/automations/result-publication.d.ts +10 -0
  165. package/dist/src/runtime/automations/result-publication.js +21 -0
  166. package/dist/src/runtime/automations/result-store.d.ts +17 -0
  167. package/dist/src/runtime/automations/result-store.js +109 -0
  168. package/dist/src/runtime/automations/retention.d.ts +12 -0
  169. package/dist/src/runtime/automations/retention.js +134 -0
  170. package/dist/src/runtime/automations/run-file-binding.d.ts +3 -0
  171. package/dist/src/runtime/automations/run-file-binding.js +19 -0
  172. package/dist/src/runtime/automations/run-output-summary.d.ts +25 -0
  173. package/dist/src/runtime/automations/run-output-summary.js +54 -0
  174. package/dist/src/runtime/automations/run-report.d.ts +83 -0
  175. package/dist/src/runtime/automations/run-report.js +121 -0
  176. package/dist/src/runtime/automations/runtime-executor.d.ts +16 -0
  177. package/dist/src/runtime/automations/runtime-executor.js +260 -0
  178. package/dist/src/runtime/automations/saved-agent-management.d.ts +16 -0
  179. package/dist/src/runtime/automations/saved-agent-management.js +94 -0
  180. package/dist/src/runtime/automations/service.d.ts +286 -0
  181. package/dist/src/runtime/automations/service.js +330 -0
  182. package/dist/src/runtime/automations/snapshot-staging.d.ts +13 -0
  183. package/dist/src/runtime/automations/snapshot-staging.js +126 -0
  184. package/dist/src/runtime/automations/source-attachment-access.d.ts +23 -0
  185. package/dist/src/runtime/automations/source-attachment-access.js +70 -0
  186. package/dist/src/runtime/automations/source-discovery.d.ts +25 -0
  187. package/dist/src/runtime/automations/source-discovery.js +179 -0
  188. package/dist/src/runtime/automations/starter-template-builder.d.ts +5 -0
  189. package/dist/src/runtime/automations/starter-template-builder.js +78 -0
  190. package/dist/src/runtime/automations/starter-template-contracts.d.ts +42 -0
  191. package/dist/src/runtime/automations/starter-template-contracts.js +1 -0
  192. package/dist/src/runtime/automations/starter-template-definitions.d.ts +3 -0
  193. package/dist/src/runtime/automations/starter-template-definitions.js +100 -0
  194. package/dist/src/runtime/automations/starter-template-showcases.d.ts +3 -0
  195. package/dist/src/runtime/automations/starter-template-showcases.js +154 -0
  196. package/dist/src/runtime/automations/starter-template-structure.d.ts +4 -0
  197. package/dist/src/runtime/automations/starter-template-structure.js +11 -0
  198. package/dist/src/runtime/automations/starter-templates.d.ts +20 -0
  199. package/dist/src/runtime/automations/starter-templates.js +75 -0
  200. package/dist/src/runtime/automations/step-evidence-effects.d.ts +46 -0
  201. package/dist/src/runtime/automations/step-evidence-effects.js +173 -0
  202. package/dist/src/runtime/automations/step-evidence-inputs.d.ts +22 -0
  203. package/dist/src/runtime/automations/step-evidence-inputs.js +105 -0
  204. package/dist/src/runtime/automations/step-evidence-output.d.ts +17 -0
  205. package/dist/src/runtime/automations/step-evidence-output.js +43 -0
  206. package/dist/src/runtime/automations/step-evidence.d.ts +24 -0
  207. package/dist/src/runtime/automations/step-evidence.js +53 -0
  208. package/dist/src/runtime/automations/step-interruption.d.ts +3 -0
  209. package/dist/src/runtime/automations/step-interruption.js +26 -0
  210. package/dist/src/runtime/automations/step-runner.d.ts +57 -0
  211. package/dist/src/runtime/automations/step-runner.js +278 -0
  212. package/dist/src/runtime/automations/storage-records.d.ts +133 -0
  213. package/dist/src/runtime/automations/storage-records.js +286 -0
  214. package/dist/src/runtime/automations/terminal-admission-receipt.d.ts +12 -0
  215. package/dist/src/runtime/automations/terminal-admission-receipt.js +39 -0
  216. package/dist/src/runtime/automations/tool-lifetimes.d.ts +13 -0
  217. package/dist/src/runtime/automations/tool-lifetimes.js +56 -0
  218. package/dist/src/runtime/automations/tool-step-executor.d.ts +32 -0
  219. package/dist/src/runtime/automations/tool-step-executor.js +136 -0
  220. package/dist/src/runtime/automations/tool-step-outcome.d.ts +24 -0
  221. package/dist/src/runtime/automations/tool-step-outcome.js +32 -0
  222. package/dist/src/runtime/automations/trigger-schedule.d.ts +7 -0
  223. package/dist/src/runtime/automations/trigger-schedule.js +19 -0
  224. package/dist/src/runtime/automations/working-directory.d.ts +3 -0
  225. package/dist/src/runtime/automations/working-directory.js +13 -0
  226. package/dist/src/runtime/capabilities/automation-builder/authoring-reference.d.ts +422 -0
  227. package/dist/src/runtime/capabilities/automation-builder/authoring-reference.js +130 -0
  228. package/dist/src/runtime/capabilities/automation-builder/creation-recipe.d.ts +9 -0
  229. package/dist/src/runtime/capabilities/automation-builder/creation-recipe.js +155 -0
  230. package/dist/src/runtime/capabilities/automation-builder/payload-instructions.d.ts +6 -0
  231. package/dist/src/runtime/capabilities/automation-builder/payload-instructions.js +6 -0
  232. package/dist/src/runtime/capabilities/automation-builder/payload-schema.d.ts +3 -0
  233. package/dist/src/runtime/capabilities/automation-builder/payload-schema.js +105 -0
  234. package/dist/src/runtime/capabilities/automation-builder/tool-contract.d.ts +65 -0
  235. package/dist/src/runtime/capabilities/automation-builder/tool-contract.js +27 -0
  236. package/dist/src/runtime/capabilities/automation-builder/tool-module.d.ts +4 -0
  237. package/dist/src/runtime/capabilities/automation-builder/tool-module.js +108 -0
  238. package/dist/src/runtime/capabilities/automations/authoring-catalog-contract.d.ts +78 -0
  239. package/dist/src/runtime/capabilities/automations/authoring-catalog-contract.js +28 -0
  240. package/dist/src/runtime/capabilities/automations/authoring-catalog.d.ts +320 -0
  241. package/dist/src/runtime/capabilities/automations/authoring-catalog.js +158 -0
  242. package/dist/src/runtime/capabilities/automations/authoring-input-contracts.d.ts +140 -0
  243. package/dist/src/runtime/capabilities/automations/authoring-input-contracts.js +36 -0
  244. package/dist/src/runtime/capabilities/automations/authoring-inputs.d.ts +9 -0
  245. package/dist/src/runtime/capabilities/automations/authoring-inputs.js +86 -0
  246. package/dist/src/runtime/capabilities/automations/authoring-preparation-limits.d.ts +5 -0
  247. package/dist/src/runtime/capabilities/automations/authoring-preparation-limits.js +5 -0
  248. package/dist/src/runtime/capabilities/automations/authoring-preparation.d.ts +483 -0
  249. package/dist/src/runtime/capabilities/automations/authoring-preparation.js +51 -0
  250. package/dist/src/runtime/capabilities/automations/draft-index.d.ts +14 -0
  251. package/dist/src/runtime/capabilities/automations/draft-index.js +26 -0
  252. package/dist/src/runtime/capabilities/automations/draft-operation-refs.d.ts +11 -0
  253. package/dist/src/runtime/capabilities/automations/draft-operation-refs.js +37 -0
  254. package/dist/src/runtime/capabilities/automations/draft-receipt-admission.d.ts +24 -0
  255. package/dist/src/runtime/capabilities/automations/draft-receipt-admission.js +36 -0
  256. package/dist/src/runtime/capabilities/automations/event-presentation.d.ts +3 -0
  257. package/dist/src/runtime/capabilities/automations/event-presentation.js +18 -0
  258. package/dist/src/runtime/capabilities/automations/model-tool-contract.d.ts +3 -0
  259. package/dist/src/runtime/capabilities/automations/model-tool-contract.js +34 -0
  260. package/dist/src/runtime/capabilities/automations/tool-contract.d.ts +3 -0
  261. package/dist/src/runtime/capabilities/automations/tool-contract.js +65 -0
  262. package/dist/src/runtime/capabilities/automations/tool-module.d.ts +4 -0
  263. package/dist/src/runtime/capabilities/automations/tool-module.js +286 -0
  264. package/dist/src/runtime/capabilities/runtime-path-namespace.d.ts +6 -0
  265. package/dist/src/runtime/capabilities/runtime-path-namespace.js +48 -0
  266. package/dist/src/runtime/capabilities/runtime-target-path.d.ts +1 -0
  267. package/dist/src/runtime/capabilities/runtime-target-path.js +16 -8
  268. package/dist/src/runtime/capabilities/scheduling/create-operations.d.ts +6 -0
  269. package/dist/src/runtime/capabilities/scheduling/job-list-page.d.ts +4 -1
  270. package/dist/src/runtime/composition.d.ts +5 -2
  271. package/dist/src/runtime/context/canonical-capability-result.d.ts +4 -0
  272. package/dist/src/runtime/context/canonical-capability-result.js +80 -0
  273. package/dist/src/runtime/context/capability-brief-readmission.js +2 -5
  274. package/dist/src/runtime/context/capability-result-compaction-source.d.ts +12 -0
  275. package/dist/src/runtime/context/capability-result-compaction-source.js +61 -0
  276. package/dist/src/runtime/context/compacted-capability-result-receipt.d.ts +7 -0
  277. package/dist/src/runtime/context/compacted-capability-result-receipt.js +29 -0
  278. package/dist/src/runtime/context/compaction-source-invariant.d.ts +6 -0
  279. package/dist/src/runtime/context/compaction-source-invariant.js +12 -0
  280. package/dist/src/runtime/context/execution-compacted-evidence.d.ts +29 -0
  281. package/dist/src/runtime/context/execution-compacted-evidence.js +87 -0
  282. package/dist/src/runtime/context/execution-compaction-objective.d.ts +11 -0
  283. package/dist/src/runtime/context/execution-compaction-objective.js +12 -0
  284. package/dist/src/runtime/context/model-step-compaction.d.ts +9 -0
  285. package/dist/src/runtime/context/model-step-compaction.js +115 -128
  286. package/dist/src/runtime/context/operation-supervision-compacted-evidence.d.ts +37 -0
  287. package/dist/src/runtime/context/operation-supervision-compacted-evidence.js +69 -0
  288. package/dist/src/runtime/context/operation-supervision-evidence-binding.d.ts +29 -0
  289. package/dist/src/runtime/context/operation-supervision-evidence-binding.js +66 -0
  290. package/dist/src/runtime/context/operation-supervision-evidence-projection.d.ts +5 -0
  291. package/dist/src/runtime/context/operation-supervision-evidence-projection.js +133 -0
  292. package/dist/src/runtime/context/operation-supervision-evidence.d.ts +2 -1
  293. package/dist/src/runtime/context/operation-supervision-evidence.js +38 -37
  294. package/dist/src/runtime/context/request-tool-results-checkpoint.d.ts +3 -0
  295. package/dist/src/runtime/context/request-tool-results-checkpoint.js +126 -0
  296. package/dist/src/runtime/context/request-tool-results-message-binding.d.ts +1 -0
  297. package/dist/src/runtime/context/request-tool-results-message-binding.js +10 -0
  298. package/dist/src/runtime/context/request-tool-results-supersession.d.ts +9 -0
  299. package/dist/src/runtime/context/request-tool-results-supersession.js +78 -0
  300. package/dist/src/runtime/context/request-tool-results.d.ts +3 -9
  301. package/dist/src/runtime/context/request-tool-results.js +15 -181
  302. package/dist/src/runtime/context/runtime-filesystem-scope.d.ts +21 -0
  303. package/dist/src/runtime/context/runtime-filesystem-scope.js +51 -0
  304. package/dist/src/runtime/context/semantic-compaction/checkpoint-message.d.ts +3 -0
  305. package/dist/src/runtime/context/semantic-compaction/checkpoint-message.js +22 -0
  306. package/dist/src/runtime/context/semantic-compaction/contracts.d.ts +0 -3
  307. package/dist/src/runtime/context/semantic-compaction/contracts.js +9 -20
  308. package/dist/src/runtime/context/semantic-compaction/dependency-results.js +15 -1
  309. package/dist/src/runtime/context/semantic-compaction/evidence-scope.d.ts +7 -0
  310. package/dist/src/runtime/context/semantic-compaction/evidence-scope.js +7 -0
  311. package/dist/src/runtime/context/semantic-compaction/format.d.ts +2 -1
  312. package/dist/src/runtime/context/semantic-compaction/format.js +27 -19
  313. package/dist/src/runtime/context/semantic-compaction/generation-contracts.d.ts +18 -0
  314. package/dist/src/runtime/context/semantic-compaction/generation-contracts.js +1 -0
  315. package/dist/src/runtime/context/semantic-compaction/generation-input.d.ts +11 -0
  316. package/dist/src/runtime/context/semantic-compaction/generation-input.js +74 -0
  317. package/dist/src/runtime/context/semantic-compaction/generation-source-registration.d.ts +3 -0
  318. package/dist/src/runtime/context/semantic-compaction/generation-source-registration.js +12 -0
  319. package/dist/src/runtime/context/semantic-compaction/output-validation.d.ts +10 -0
  320. package/dist/src/runtime/context/semantic-compaction/output-validation.js +75 -0
  321. package/dist/src/runtime/context/semantic-compaction/parser.d.ts +2 -2
  322. package/dist/src/runtime/context/semantic-compaction/parser.js +13 -26
  323. package/dist/src/runtime/context/semantic-compaction/prompt.js +18 -5
  324. package/dist/src/runtime/context/semantic-compaction/repair-headroom.d.ts +4 -3
  325. package/dist/src/runtime/context/semantic-compaction/repair-headroom.js +10 -4
  326. package/dist/src/runtime/context/semantic-compaction/replacement-budget.d.ts +25 -0
  327. package/dist/src/runtime/context/semantic-compaction/replacement-budget.js +55 -0
  328. package/dist/src/runtime/context/semantic-compaction/run.d.ts +3 -14
  329. package/dist/src/runtime/context/semantic-compaction/run.js +27 -186
  330. package/dist/src/runtime/context/semantic-compaction/scope-quarantine.d.ts +17 -0
  331. package/dist/src/runtime/context/semantic-compaction/scope-quarantine.js +37 -0
  332. package/dist/src/runtime/context/semantic-compaction/snapshot.d.ts +5 -1
  333. package/dist/src/runtime/context/semantic-compaction/snapshot.js +10 -2
  334. package/dist/src/runtime/context/semantic-compaction/source-registration.d.ts +3 -0
  335. package/dist/src/runtime/context/semantic-compaction/source-registration.js +34 -0
  336. package/dist/src/runtime/context/semantic-compaction/source-slots.d.ts +5 -0
  337. package/dist/src/runtime/context/semantic-compaction/source-slots.js +4 -0
  338. package/dist/src/runtime/context/semantic-compaction/store.d.ts +6 -1
  339. package/dist/src/runtime/context/semantic-compaction/store.js +54 -9
  340. package/dist/src/runtime/context/semantic-compaction/super-child-result-source.d.ts +8 -0
  341. package/dist/src/runtime/context/semantic-compaction/super-child-result-source.js +50 -0
  342. package/dist/src/runtime/context/semantic-compaction/super-operation-source.d.ts +8 -0
  343. package/dist/src/runtime/context/semantic-compaction/super-operation-source.js +99 -0
  344. package/dist/src/runtime/context/semantic-compaction/super-reviewer-source.d.ts +16 -0
  345. package/dist/src/runtime/context/semantic-compaction/super-reviewer-source.js +37 -0
  346. package/dist/src/runtime/context/semantic-compaction/super-source-integrity.d.ts +21 -0
  347. package/dist/src/runtime/context/semantic-compaction/super-source-integrity.js +169 -0
  348. package/dist/src/runtime/context/semantic-compaction/super-source-message.d.ts +4 -0
  349. package/dist/src/runtime/context/semantic-compaction/super-source-message.js +23 -0
  350. package/dist/src/runtime/context/session-memory/model-step-controller.js +34 -20
  351. package/dist/src/runtime/context/session-memory/selection.js +0 -2
  352. package/dist/src/runtime/context/spark-conversation-policy.d.ts +4 -0
  353. package/dist/src/runtime/context/spark-conversation-policy.js +16 -0
  354. package/dist/src/runtime/context/super-compaction-failure-owner.d.ts +10 -0
  355. package/dist/src/runtime/context/super-compaction-failure-owner.js +64 -0
  356. package/dist/src/runtime/context/super-context-failure.d.ts +28 -0
  357. package/dist/src/runtime/context/super-context-failure.js +37 -0
  358. package/dist/src/runtime/context/super-context-policy.d.ts +3 -0
  359. package/dist/src/runtime/context/super-context-policy.js +35 -0
  360. package/dist/src/runtime/context/super-request-tool-results-checkpoint.d.ts +6 -0
  361. package/dist/src/runtime/context/super-request-tool-results-checkpoint.js +29 -0
  362. package/dist/src/runtime/context/super-worker-compaction-failure.d.ts +5 -0
  363. package/dist/src/runtime/context/super-worker-compaction-failure.js +19 -0
  364. package/dist/src/runtime/context/super-worker-compaction-projection.d.ts +8 -0
  365. package/dist/src/runtime/context/super-worker-compaction-projection.js +41 -0
  366. package/dist/src/runtime/context/super-worker-compaction-sidecar.d.ts +21 -0
  367. package/dist/src/runtime/context/super-worker-compaction-sidecar.js +67 -0
  368. package/dist/src/runtime/context/verified-compaction-projection.d.ts +7 -0
  369. package/dist/src/runtime/context/verified-compaction-projection.js +16 -0
  370. package/dist/src/runtime/default-environment-adapters.d.ts +4 -0
  371. package/dist/src/runtime/default-environment-adapters.js +7 -1
  372. package/dist/src/runtime/local-application.d.ts +277 -0
  373. package/dist/src/runtime/local-application.js +7 -0
  374. package/dist/src/runtime/local-host/app-learning-dispatch.js +0 -8
  375. package/dist/src/runtime/local-host/app-native-permissions.d.ts +20 -0
  376. package/dist/src/runtime/local-host/app-native-permissions.js +76 -0
  377. package/dist/src/runtime/local-host/app-owner.js +12 -1
  378. package/dist/src/runtime/local-host/app-request-control.d.ts +1 -0
  379. package/dist/src/runtime/local-host/app-request-control.js +5 -0
  380. package/dist/src/runtime/local-host/app-service-dispatch.d.ts +2 -1
  381. package/dist/src/runtime/local-host/app-service-dispatch.js +31 -0
  382. package/dist/src/runtime/local-host/client-learning.d.ts +1 -1
  383. package/dist/src/runtime/local-host/client-learning.js +0 -1
  384. package/dist/src/runtime/local-host/client-native-permissions.d.ts +4 -0
  385. package/dist/src/runtime/local-host/client-native-permissions.js +37 -0
  386. package/dist/src/runtime/local-host/client-services.d.ts +273 -0
  387. package/dist/src/runtime/local-host/client-services.js +3 -2
  388. package/dist/src/runtime/local-host/learning-preferences-input.js +1 -0
  389. package/dist/src/runtime/model/context-compaction-admission.d.ts +21 -0
  390. package/dist/src/runtime/model/context-compaction-admission.js +214 -0
  391. package/dist/src/runtime/model/context-compaction-contracts.d.ts +32 -0
  392. package/dist/src/runtime/model/context-compaction-contracts.js +1 -0
  393. package/dist/src/runtime/model/context-compaction-diagnostics.d.ts +33 -0
  394. package/dist/src/runtime/model/context-compaction-diagnostics.js +97 -0
  395. package/dist/src/runtime/model/context-compaction-stage-plan.d.ts +3 -0
  396. package/dist/src/runtime/model/context-compaction-stage-plan.js +28 -0
  397. package/dist/src/runtime/model/input-token-count.d.ts +1 -0
  398. package/dist/src/runtime/model/input-token-count.js +4 -1
  399. package/dist/src/runtime/model/invoke-step.js +80 -126
  400. package/dist/src/runtime/model/invoke-structured-step.d.ts +1 -1
  401. package/dist/src/runtime/model/invoke-structured-step.js +3 -2
  402. package/dist/src/runtime/model/model-context-assessment.d.ts +17 -0
  403. package/dist/src/runtime/model/model-context-assessment.js +51 -0
  404. package/dist/src/runtime/model/model-context-budget.js +1 -0
  405. package/dist/src/runtime/model/model-step-acceptance.d.ts +4 -0
  406. package/dist/src/runtime/model/model-step-acceptance.js +28 -0
  407. package/dist/src/runtime/model/model-step-port.d.ts +4 -15
  408. package/dist/src/runtime/model/model-step-steering.d.ts +14 -1
  409. package/dist/src/runtime/model/model-step-steering.js +23 -0
  410. package/dist/src/runtime/orchestration/capability-adapters/result.d.ts +4 -1
  411. package/dist/src/runtime/orchestration/capability-adapters/result.js +11 -7
  412. package/dist/src/runtime/orchestration/role-calls/child-return.d.ts +5 -1
  413. package/dist/src/runtime/orchestration/role-calls/child-return.js +2 -2
  414. package/dist/src/runtime/orchestration/worker-capabilities/binding/invocation-preparation.js +1 -8
  415. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +3 -4
  416. package/dist/src/runtime/orchestration/worker-capabilities/contracts.js +1 -1
  417. package/dist/src/runtime/orchestration/worker-capabilities/execution/context-projection.js +2 -1
  418. package/dist/src/runtime/orchestration/worker-capabilities/payload-assignment-validation.js +9 -9
  419. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.js +9 -33
  420. package/dist/src/runtime/orchestration/worker-capabilities/payload-body-normalization.d.ts +12 -0
  421. package/dist/src/runtime/orchestration/worker-capabilities/payload-body-normalization.js +80 -0
  422. package/dist/src/runtime/orchestration/worker-capabilities/payload-compaction-transport.d.ts +3 -0
  423. package/dist/src/runtime/orchestration/worker-capabilities/payload-compaction-transport.js +14 -0
  424. package/dist/src/runtime/orchestration/worker-capabilities/payload-context-snapshot.d.ts +2 -0
  425. package/dist/src/runtime/orchestration/worker-capabilities/payload-context-snapshot.js +12 -0
  426. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.d.ts +5 -1
  427. package/dist/src/runtime/orchestration/worker-capabilities/payload-instructions.js +1 -1
  428. package/dist/src/runtime/passive-learning/background-dependencies.d.ts +0 -1
  429. package/dist/src/runtime/passive-learning/contracts.d.ts +2 -3
  430. package/dist/src/runtime/passive-learning/proactive/agent.d.ts +3 -0
  431. package/dist/src/runtime/passive-learning/proactive/agent.js +36 -14
  432. package/dist/src/runtime/passive-learning/proactive/contracts.d.ts +7 -1
  433. package/dist/src/runtime/passive-learning/proactive/contracts.js +8 -1
  434. package/dist/src/runtime/passive-learning/proactive/conversation-style-prompt.d.ts +1 -0
  435. package/dist/src/runtime/passive-learning/proactive/conversation-style-prompt.js +6 -0
  436. package/dist/src/runtime/passive-learning/proactive/conversation-style-reference.d.ts +30 -0
  437. package/dist/src/runtime/passive-learning/proactive/conversation-style-reference.js +61 -0
  438. package/dist/src/runtime/passive-learning/proactive/handoff-brief.d.ts +1 -0
  439. package/dist/src/runtime/passive-learning/proactive/handoff-brief.js +4 -0
  440. package/dist/src/runtime/passive-learning/proactive/model-output.d.ts +1 -1
  441. package/dist/src/runtime/passive-learning/proactive/model-output.js +5 -4
  442. package/dist/src/runtime/passive-learning/proactive/model.d.ts +7 -1
  443. package/dist/src/runtime/passive-learning/proactive/model.js +58 -32
  444. package/dist/src/runtime/passive-learning/proactive/prompt.d.ts +1 -1
  445. package/dist/src/runtime/passive-learning/proactive/prompt.js +4 -2
  446. package/dist/src/runtime/passive-learning/proactive/staged-authoring.d.ts +14 -0
  447. package/dist/src/runtime/passive-learning/proactive/staged-authoring.js +27 -0
  448. package/dist/src/runtime/passive-learning/proactive/staged-context.d.ts +13 -0
  449. package/dist/src/runtime/passive-learning/proactive/staged-context.js +39 -4
  450. package/dist/src/runtime/passive-learning/proactive/staged-contract.d.ts +3 -0
  451. package/dist/src/runtime/passive-learning/proactive/staged-contract.js +4 -0
  452. package/dist/src/runtime/passive-learning/proactive/staged-format.d.ts +5 -1
  453. package/dist/src/runtime/passive-learning/proactive/staged-format.js +2 -4
  454. package/dist/src/runtime/passive-learning/proactive/staged-output.d.ts +3 -4
  455. package/dist/src/runtime/passive-learning/proactive/staged-output.js +13 -5
  456. package/dist/src/runtime/passive-learning/proactive/staged-progress-store.d.ts +0 -1
  457. package/dist/src/runtime/passive-learning/proactive/staged-progress-store.js +2 -18
  458. package/dist/src/runtime/passive-learning/proactive/staged-prompt.d.ts +3 -1
  459. package/dist/src/runtime/passive-learning/proactive/staged-prompt.js +13 -4
  460. package/dist/src/runtime/passive-learning/proactive/staged-review.d.ts +1 -1
  461. package/dist/src/runtime/passive-learning/proactive/staged-review.js +10 -11
  462. package/dist/src/runtime/passive-learning/proactive/store.d.ts +1 -1
  463. package/dist/src/runtime/passive-learning/proactive/store.js +11 -5
  464. package/dist/src/runtime/passive-learning/review-progress.d.ts +1 -1
  465. package/dist/src/runtime/passive-learning/review-progress.js +2 -2
  466. package/dist/src/runtime/passive-learning/service-status.js +2 -2
  467. package/dist/src/runtime/passive-learning/service.js +0 -6
  468. package/dist/src/runtime/passive-learning/spark-chat-preferences.d.ts +3 -0
  469. package/dist/src/runtime/passive-learning/spark-chat-preferences.js +8 -0
  470. package/dist/src/runtime/passive-learning/staged-review-call.d.ts +3 -0
  471. package/dist/src/runtime/passive-learning/staged-review-call.js +19 -13
  472. package/dist/src/runtime/passive-learning/store.js +4 -0
  473. package/dist/src/runtime/plugins/manifest-projection.js +4 -0
  474. package/dist/src/runtime/plugins/manifest-validator.js +7 -0
  475. package/dist/src/runtime/ports.d.ts +14 -1
  476. package/dist/src/runtime/request/approval-wait/activation-events.d.ts +5 -0
  477. package/dist/src/runtime/request/approval-wait/activation-events.js +4 -3
  478. package/dist/src/runtime/request/approval-wait/snapshot.d.ts +1 -1
  479. package/dist/src/runtime/request/approval-wait/snapshot.js +1 -0
  480. package/dist/src/runtime/request/approval-wait/super-compaction-restore.d.ts +20 -0
  481. package/dist/src/runtime/request/approval-wait/super-compaction-restore.js +61 -0
  482. package/dist/src/runtime/request/automation-output-contract.d.ts +6 -0
  483. package/dist/src/runtime/request/automation-output-contract.js +33 -0
  484. package/dist/src/runtime/request/contracts.d.ts +16 -0
  485. package/dist/src/runtime/request/execution-agent-root-execution.js +2 -0
  486. package/dist/src/runtime/request/execution-facets.js +7 -0
  487. package/dist/src/runtime/request/execution-payload-compacted-evidence.d.ts +64 -0
  488. package/dist/src/runtime/request/execution-payload-compacted-evidence.js +46 -0
  489. package/dist/src/runtime/request/execution-scope-surfaces.d.ts +2 -0
  490. package/dist/src/runtime/request/execution-scope-surfaces.js +28 -0
  491. package/dist/src/runtime/request/execution-scope.d.ts +8 -2
  492. package/dist/src/runtime/request/execution-scope.js +14 -2
  493. package/dist/src/runtime/request/handler.d.ts +7 -0
  494. package/dist/src/runtime/request/handler.js +196 -35
  495. package/dist/src/runtime/request/locked-request-steering.d.ts +3 -0
  496. package/dist/src/runtime/request/locked-request-steering.js +12 -0
  497. package/dist/src/runtime/request/policy-degraded-finalization.d.ts +10 -0
  498. package/dist/src/runtime/request/policy-degraded-finalization.js +27 -0
  499. package/dist/src/runtime/request/prepared-execution.d.ts +10 -1
  500. package/dist/src/runtime/request/prepared-execution.js +43 -8
  501. package/dist/src/runtime/request/request-steering.d.ts +1 -1
  502. package/dist/src/runtime/request/result.d.ts +3 -0
  503. package/dist/src/runtime/request/role-executor-composition.js +4 -3
  504. package/dist/src/runtime/request/root-contract.d.ts +2 -0
  505. package/dist/src/runtime/request/root-execution-kernel.js +10 -9
  506. package/dist/src/runtime/request/root-invalid-output.js +16 -1
  507. package/dist/src/runtime/request/session-admission.d.ts +6 -0
  508. package/dist/src/runtime/request/session-admission.js +47 -14
  509. package/dist/src/runtime/request/super-checkpoint-quarantine.d.ts +8 -0
  510. package/dist/src/runtime/request/super-checkpoint-quarantine.js +76 -0
  511. package/dist/src/runtime/request/super-context-failure-executor.d.ts +4 -0
  512. package/dist/src/runtime/request/super-context-failure-executor.js +68 -0
  513. package/dist/src/runtime/request/super-context-failure-integrity.d.ts +16 -0
  514. package/dist/src/runtime/request/super-context-failure-integrity.js +130 -0
  515. package/dist/src/runtime/request/super-context-scope.d.ts +9 -0
  516. package/dist/src/runtime/request/super-context-scope.js +65 -0
  517. package/dist/src/runtime/request/super-failure-explanation.d.ts +22 -0
  518. package/dist/src/runtime/request/super-failure-explanation.js +77 -0
  519. package/dist/src/runtime/request/super-failure-message.d.ts +10 -0
  520. package/dist/src/runtime/request/super-failure-message.js +40 -0
  521. package/dist/src/runtime/request/super-payload-context-failure.d.ts +11 -0
  522. package/dist/src/runtime/request/super-payload-context-failure.js +55 -0
  523. package/dist/src/runtime/request/super-root-failure-finalization.d.ts +23 -0
  524. package/dist/src/runtime/request/super-root-failure-finalization.js +112 -0
  525. package/dist/src/runtime/request/worker-capability-composition.d.ts +2 -0
  526. package/dist/src/runtime/request/worker-capability-composition.js +4 -1
  527. package/dist/src/runtime/request/worker-capability-payload.d.ts +2 -1
  528. package/dist/src/runtime/request/worker-capability-payload.js +74 -48
  529. package/dist/src/runtime/runtime-environment.d.ts +3 -1
  530. package/dist/src/runtime/runtime-environment.js +167 -1
  531. package/dist/src/runtime/scheduler/automation-job-management.d.ts +12 -0
  532. package/dist/src/runtime/scheduler/automation-job-management.js +288 -0
  533. package/dist/src/runtime/scheduler/automation-rerun.d.ts +6 -0
  534. package/dist/src/runtime/scheduler/automation-rerun.js +95 -0
  535. package/dist/src/runtime/scheduler/automation-run-budget.d.ts +4 -0
  536. package/dist/src/runtime/scheduler/automation-run-budget.js +16 -0
  537. package/dist/src/runtime/scheduler/automation-run-change-events.d.ts +11 -0
  538. package/dist/src/runtime/scheduler/automation-run-change-events.js +77 -0
  539. package/dist/src/runtime/scheduler/automation-run-completion.d.ts +11 -0
  540. package/dist/src/runtime/scheduler/automation-run-completion.js +93 -0
  541. package/dist/src/runtime/scheduler/automation-run-control.d.ts +3 -0
  542. package/dist/src/runtime/scheduler/automation-run-control.js +48 -0
  543. package/dist/src/runtime/scheduler/automation-run-records.d.ts +5 -0
  544. package/dist/src/runtime/scheduler/automation-run-records.js +37 -0
  545. package/dist/src/runtime/scheduler/automation-schedule.d.ts +10 -0
  546. package/dist/src/runtime/scheduler/automation-schedule.js +48 -0
  547. package/dist/src/runtime/scheduler/automation-scheduler-engine.d.ts +4 -0
  548. package/dist/src/runtime/scheduler/automation-scheduler-engine.js +188 -0
  549. package/dist/src/runtime/scheduler/automation-snapshot-validation.d.ts +3 -0
  550. package/dist/src/runtime/scheduler/automation-snapshot-validation.js +106 -0
  551. package/dist/src/runtime/scheduler/contracts.d.ts +143 -3
  552. package/dist/src/runtime/scheduler/file-store.js +15 -1
  553. package/dist/src/runtime/scheduler/job-management.js +3 -2
  554. package/dist/src/runtime/scheduler/journal-automation-index.d.ts +23 -0
  555. package/dist/src/runtime/scheduler/journal-automation-index.js +205 -0
  556. package/dist/src/runtime/scheduler/journal-automation-transaction.d.ts +11 -0
  557. package/dist/src/runtime/scheduler/journal-automation-transaction.js +90 -0
  558. package/dist/src/runtime/scheduler/journal-checkpoint.js +5 -2
  559. package/dist/src/runtime/scheduler/journal-head.d.ts +1 -1
  560. package/dist/src/runtime/scheduler/journal-head.js +2 -2
  561. package/dist/src/runtime/scheduler/journal-index-state.d.ts +21 -10
  562. package/dist/src/runtime/scheduler/journal-index-state.js +76 -17
  563. package/dist/src/runtime/scheduler/journal-index.d.ts +9 -3
  564. package/dist/src/runtime/scheduler/journal-index.js +84 -9
  565. package/dist/src/runtime/scheduler/journal-store.d.ts +9 -1
  566. package/dist/src/runtime/scheduler/journal-store.js +110 -7
  567. package/dist/src/runtime/scheduler/journal-transaction.d.ts +7 -4
  568. package/dist/src/runtime/scheduler/journal-transaction.js +13 -2
  569. package/dist/src/runtime/scheduler/next-occurrence.js +2 -0
  570. package/dist/src/runtime/scheduler/run-completion.js +2 -1
  571. package/dist/src/runtime/scheduler/run-records.js +8 -3
  572. package/dist/src/runtime/scheduler/schedule-update.d.ts +2 -2
  573. package/dist/src/runtime/scheduler/schedule-validation.d.ts +2 -2
  574. package/dist/src/runtime/scheduler/schedule-validation.js +2 -0
  575. package/dist/src/runtime/scheduler/scheduler-engine.js +24 -8
  576. package/dist/src/runtime/scheduler/scheduler-service.d.ts +4 -1
  577. package/dist/src/runtime/scheduler/scheduler-service.js +83 -10
  578. package/dist/src/runtime/scheduler/scheduler-target.d.ts +9 -0
  579. package/dist/src/runtime/scheduler/scheduler-target.js +41 -0
  580. package/dist/src/runtime/scheduler/service-context.d.ts +6 -2
  581. package/dist/src/runtime/scheduler/service-context.js +6 -3
  582. package/dist/src/runtime/scheduler/snapshot-validation.d.ts +3 -3
  583. package/dist/src/runtime/scheduler/snapshot-validation.js +21 -1
  584. package/dist/src/runtime/scheduler/startup-recovery.d.ts +1 -1
  585. package/dist/src/runtime/scheduler/startup-recovery.js +15 -2
  586. package/dist/src/runtime/scheduler/working-store.js +8 -0
  587. package/dist/src/runtime/session/request-session.d.ts +1 -0
  588. package/dist/src/runtime/session/request-session.js +1 -0
  589. package/dist/src/runtime/session/session-deletion-boundary.d.ts +1 -1
  590. package/dist/src/runtime/session/session-deletion-boundary.js +6 -2
  591. package/dist/src/runtime/session/session-lifecycle-store.d.ts +4 -1
  592. package/dist/src/runtime/session/session-lifecycle-store.js +32 -4
  593. package/dist/src/runtime/session/spark-session-attachments.d.ts +4 -0
  594. package/dist/src/runtime/session/spark-session-attachments.js +28 -0
  595. package/dist/src/runtime/session/spark-session-cleanup-receipt.d.ts +7 -0
  596. package/dist/src/runtime/session/spark-session-cleanup-receipt.js +61 -0
  597. package/dist/src/runtime/session/spark-session-clear.d.ts +6 -0
  598. package/dist/src/runtime/session/spark-session-clear.js +36 -0
  599. package/dist/src/runtime/session/terminal-response.d.ts +21 -0
  600. package/dist/src/runtime/session/terminal-response.js +38 -0
  601. package/dist/src/runtime/steps/auditor-decision/advisory-receipt.d.ts +1 -0
  602. package/dist/src/runtime/steps/auditor-decision/advisory-receipt.js +12 -0
  603. package/dist/src/runtime/steps/auditor-decision/contracts.d.ts +4 -0
  604. package/dist/src/runtime/steps/auditor-decision/evidence-coverage.js +5 -5
  605. package/dist/src/runtime/steps/auditor-decision/evidence-inventory.d.ts +2 -1
  606. package/dist/src/runtime/steps/auditor-decision/evidence-inventory.js +12 -1
  607. package/dist/src/runtime/steps/auditor-decision/evidence-representation.d.ts +8 -2
  608. package/dist/src/runtime/steps/auditor-decision/evidence-representation.js +14 -1
  609. package/dist/src/runtime/steps/auditor-decision/input.d.ts +2 -0
  610. package/dist/src/runtime/steps/auditor-decision/input.js +12 -3
  611. package/dist/src/runtime/steps/auditor-decision/projection.js +20 -1
  612. package/dist/src/runtime/steps/auditor-decision/prompt.js +6 -6
  613. package/dist/src/runtime/steps/auditor-decision/run.js +2 -3
  614. package/dist/src/runtime/steps/capability-execution-instructions.d.ts +5 -0
  615. package/dist/src/runtime/steps/capability-execution-instructions.js +5 -0
  616. package/dist/src/runtime/steps/degraded-finalization/contract.d.ts +3 -0
  617. package/dist/src/runtime/steps/degraded-finalization/fallback.js +14 -4
  618. package/dist/src/runtime/steps/degraded-finalization/input.js +11 -1
  619. package/dist/src/runtime/steps/degraded-finalization/output-limit-cause.d.ts +4 -0
  620. package/dist/src/runtime/steps/degraded-finalization/output-limit-cause.js +17 -0
  621. package/dist/src/runtime/steps/degraded-finalization/prompt.js +4 -1
  622. package/dist/src/runtime/steps/degraded-finalization/super.d.ts +20 -0
  623. package/dist/src/runtime/steps/degraded-finalization/super.js +128 -0
  624. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.d.ts +1 -0
  625. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.js +21 -3
  626. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.d.ts +1 -1
  627. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.js +4 -2
  628. package/dist/src/runtime/steps/execution-agent/capability-selection-schema.d.ts +3 -0
  629. package/dist/src/runtime/steps/execution-agent/capability-selection-schema.js +72 -0
  630. package/dist/src/runtime/steps/execution-agent/compaction.d.ts +5 -2
  631. package/dist/src/runtime/steps/execution-agent/compaction.js +10 -4
  632. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +14 -2
  633. package/dist/src/runtime/steps/execution-agent/controls-compacted-evidence.d.ts +16 -0
  634. package/dist/src/runtime/steps/execution-agent/controls-compacted-evidence.js +67 -0
  635. package/dist/src/runtime/steps/execution-agent/controls-evidence-contract.d.ts +21 -0
  636. package/dist/src/runtime/steps/execution-agent/controls-evidence-contract.js +64 -0
  637. package/dist/src/runtime/steps/execution-agent/controls-evidence.d.ts +32 -0
  638. package/dist/src/runtime/steps/execution-agent/controls-evidence.js +119 -0
  639. package/dist/src/runtime/steps/execution-agent/decision-parsing.js +1 -0
  640. package/dist/src/runtime/steps/execution-agent/format.d.ts +2 -0
  641. package/dist/src/runtime/steps/execution-agent/format.js +9 -68
  642. package/dist/src/runtime/steps/execution-agent/input.js +19 -2
  643. package/dist/src/runtime/steps/execution-agent/prompt.d.ts +1 -0
  644. package/dist/src/runtime/steps/execution-agent/prompt.js +15 -2
  645. package/dist/src/runtime/steps/execution-agent/refinement-input.d.ts +32 -0
  646. package/dist/src/runtime/steps/execution-agent/refinement-input.js +146 -0
  647. package/dist/src/runtime/steps/execution-agent/refinement-prompt.d.ts +1 -0
  648. package/dist/src/runtime/steps/execution-agent/refinement-prompt.js +11 -0
  649. package/dist/src/runtime/steps/execution-agent/refinement.d.ts +4 -4
  650. package/dist/src/runtime/steps/execution-agent/refinement.js +18 -108
  651. package/dist/src/runtime/steps/execution-agent/response-input.js +13 -6
  652. package/dist/src/runtime/steps/execution-agent/response-prompt.js +1 -1
  653. package/dist/src/runtime/steps/execution-agent/response-run.js +19 -5
  654. package/dist/src/runtime/steps/execution-agent/run.js +9 -3
  655. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +1 -1
  656. package/dist/src/runtime/steps/execution-agent/state-context.js +20 -5
  657. package/dist/src/runtime/steps/planner-decision/input.js +7 -0
  658. package/dist/src/runtime/steps/planner-decision/resume.d.ts +2 -1
  659. package/dist/src/runtime/steps/planner-decision/resume.js +3 -3
  660. package/dist/src/runtime/steps/planner-decision/run.js +13 -0
  661. package/dist/src/runtime/steps/planner-graph/prompt.js +2 -0
  662. package/dist/src/runtime/steps/planner-graph/run.js +1 -0
  663. package/dist/src/runtime/steps/reviewer-decision/projection.js +5 -0
  664. package/dist/src/runtime/steps/reviewer-decision/run.js +13 -0
  665. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +1 -1
  666. package/dist/src/runtime/steps/supervisor-decision/input.js +2 -0
  667. package/dist/src/runtime/steps/supervisor-decision/run.js +14 -0
  668. package/dist/src/runtime/steps/supervisor-decision/working-directory.d.ts +2 -0
  669. package/dist/src/runtime/steps/supervisor-decision/working-directory.js +6 -0
  670. package/dist/src/runtime/steps/supervisor-response/input.d.ts +1 -1
  671. package/dist/src/runtime/steps/supervisor-response/input.js +14 -7
  672. package/dist/src/runtime/steps/supervisor-response/run.js +39 -9
  673. package/dist/src/runtime/steps/worker-decision/compaction-integrity.d.ts +11 -0
  674. package/dist/src/runtime/steps/worker-decision/compaction-integrity.js +40 -0
  675. package/dist/src/runtime/steps/worker-decision/input/reference-context.js +7 -0
  676. package/dist/src/runtime/steps/worker-decision/input/types.d.ts +4 -1
  677. package/dist/src/runtime/steps/worker-decision/prompt.js +9 -2
  678. package/dist/src/runtime/steps/worker-decision/result-author.js +4 -0
  679. package/dist/src/runtime/steps/worker-decision/run.js +12 -49
  680. package/dist/src/runtime/steps/worker-decision/worker-handoff-compaction.d.ts +4 -0
  681. package/dist/src/runtime/steps/worker-decision/worker-handoff-compaction.js +69 -0
  682. package/dist/src/sessions/assistant-initiative-append.d.ts +14 -0
  683. package/dist/src/sessions/assistant-initiative-append.js +64 -0
  684. package/dist/src/sessions/assistant-initiative.d.ts +4 -0
  685. package/dist/src/sessions/assistant-initiative.js +7 -1
  686. package/dist/src/sessions/automation-session-origin.d.ts +34 -0
  687. package/dist/src/sessions/automation-session-origin.js +78 -0
  688. package/dist/src/sessions/automation-session-store.d.ts +12 -0
  689. package/dist/src/sessions/automation-session-store.js +129 -0
  690. package/dist/src/sessions/index.d.ts +1 -0
  691. package/dist/src/sessions/index.js +3 -0
  692. package/dist/src/sessions/memory/source.d.ts +1 -1
  693. package/dist/src/sessions/memory/source.js +4 -11
  694. package/dist/src/sessions/project-binding.d.ts +1 -0
  695. package/dist/src/sessions/record/projection.d.ts +1 -0
  696. package/dist/src/sessions/record/projection.js +4 -0
  697. package/dist/src/sessions/session-service.d.ts +9 -0
  698. package/dist/src/sessions/session-service.js +53 -4
  699. package/dist/src/sessions/spark-handoff-brief.d.ts +3 -0
  700. package/dist/src/sessions/spark-handoff-brief.js +9 -0
  701. package/dist/src/sessions/spark-session.d.ts +13 -0
  702. package/dist/src/sessions/spark-session.js +25 -0
  703. package/dist/src/sessions/types.d.ts +5 -0
  704. package/dist/src/web-ui/app/ARCHITECTURE.md +89 -0
  705. package/dist/src/web-ui/app/app-bootstrap.js +24 -2
  706. package/dist/src/web-ui/app/app-dom.js +5 -0
  707. package/dist/src/web-ui/app/app-realtime-transport.js +27 -2
  708. package/dist/src/web-ui/app/app.js +5 -10
  709. package/dist/src/web-ui/app/automations-feature.js +103 -0
  710. package/dist/src/web-ui/app/components/automations/archive-actions.js +20 -0
  711. package/dist/src/web-ui/app/components/automations/authoring-entry.js +25 -0
  712. package/dist/src/web-ui/app/components/automations/binding-editor.js +101 -0
  713. package/dist/src/web-ui/app/components/automations/binding-fields.js +166 -0
  714. package/dist/src/web-ui/app/components/automations/chat-run-projection.js +280 -0
  715. package/dist/src/web-ui/app/components/automations/draft-recovery-actions.js +28 -0
  716. package/dist/src/web-ui/app/components/automations/editor-action-icons.js +18 -0
  717. package/dist/src/web-ui/app/components/automations/editor-actions.js +57 -0
  718. package/dist/src/web-ui/app/components/automations/editor.js +218 -0
  719. package/dist/src/web-ui/app/components/automations/failure-presentation.js +299 -0
  720. package/dist/src/web-ui/app/components/automations/library-tabs.js +45 -0
  721. package/dist/src/web-ui/app/components/automations/list.js +58 -0
  722. package/dist/src/web-ui/app/components/automations/live-view.js +39 -0
  723. package/dist/src/web-ui/app/components/automations/node-inspector.js +251 -0
  724. package/dist/src/web-ui/app/components/automations/permission-selection.js +37 -0
  725. package/dist/src/web-ui/app/components/automations/rerun-confirmation.js +16 -0
  726. package/dist/src/web-ui/app/components/automations/run-output-view.js +100 -0
  727. package/dist/src/web-ui/app/components/automations/run-report-view.js +224 -0
  728. package/dist/src/web-ui/app/components/automations/run-step-selection.js +7 -0
  729. package/dist/src/web-ui/app/components/automations/run-steps-view.js +33 -0
  730. package/dist/src/web-ui/app/components/automations/run.js +38 -0
  731. package/dist/src/web-ui/app/components/automations/schema-literal-inputs.js +212 -0
  732. package/dist/src/web-ui/app/components/automations/step-editor-dialog.js +243 -0
  733. package/dist/src/web-ui/app/components/automations/step-preview.js +48 -0
  734. package/dist/src/web-ui/app/components/automations/template-gallery.js +74 -0
  735. package/dist/src/web-ui/app/components/automations/timeline-camera.js +219 -0
  736. package/dist/src/web-ui/app/components/automations/timeline.js +141 -0
  737. package/dist/src/web-ui/app/components/automations/tool-identity.js +25 -0
  738. package/dist/src/web-ui/app/components/automations/workspace.js +462 -0
  739. package/dist/src/web-ui/app/components/composer-context-window.js +24 -13
  740. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +2 -2
  741. package/dist/src/web-ui/app/components/conversation-activity.d.ts +2 -28
  742. package/dist/src/web-ui/app/components/conversation-activity.js +23 -60
  743. package/dist/src/web-ui/app/components/conversation-status.js +3 -2
  744. package/dist/src/web-ui/app/components/conversation-view.js +36 -14
  745. package/dist/src/web-ui/app/components/dashboard/automations.js +28 -0
  746. package/dist/src/web-ui/app/components/dashboard/workspace.js +9 -0
  747. package/dist/src/web-ui/app/components/notifications/dom.js +1 -1
  748. package/dist/src/web-ui/app/components/notifications/feedback.js +34 -0
  749. package/dist/src/web-ui/app/components/notifications/pagination.js +13 -0
  750. package/dist/src/web-ui/app/components/notifications/presentation.js +25 -4
  751. package/dist/src/web-ui/app/components/notifications/tabs.js +49 -0
  752. package/dist/src/web-ui/app/components/notifications/workspace.js +19 -26
  753. package/dist/src/web-ui/app/components/onboarding-workspace-access.js +1 -1
  754. package/dist/src/web-ui/app/components/passive-learning/agent-state.js +0 -5
  755. package/dist/src/web-ui/app/components/passive-learning/agent-view.js +1 -1
  756. package/dist/src/web-ui/app/components/passive-learning/home.js +0 -4
  757. package/dist/src/web-ui/app/components/passive-learning/memory.js +0 -3
  758. package/dist/src/web-ui/app/components/passive-learning/settings-view.js +2 -2
  759. package/dist/src/web-ui/app/components/passive-learning/workspace-view.js +3 -3
  760. package/dist/src/web-ui/app/components/runtime-setup/optional-steps.js +7 -1
  761. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +5 -1
  762. package/dist/src/web-ui/app/components/runtime-setup-guide.js +6 -3
  763. package/dist/src/web-ui/app/components/schedules/details.js +3 -2
  764. package/dist/src/web-ui/app/components/schedules/form.js +4 -4
  765. package/dist/src/web-ui/app/components/spark-chat/empty-state.js +45 -0
  766. package/dist/src/web-ui/app/components/spark-chat/handoff-actions.js +59 -0
  767. package/dist/src/web-ui/app/components/spark-chat/mascot-activity.js +27 -0
  768. package/dist/src/web-ui/app/components/spark-chat/motion.js +52 -0
  769. package/dist/src/web-ui/app/components/spark-chat/panel.js +109 -0
  770. package/dist/src/web-ui/app/components/spark-chat/placement.js +198 -0
  771. package/dist/src/web-ui/app/components/spark-chat/results.js +44 -0
  772. package/dist/src/web-ui/app/components/spark-chat/settings.js +84 -0
  773. package/dist/src/web-ui/app/components/system-host/macos-permission-preparation.js +83 -0
  774. package/dist/src/web-ui/app/components/system-host/macos-permission-rendering.js +85 -0
  775. package/dist/src/web-ui/app/components/system-host/macos-permission-scopes.js +51 -0
  776. package/dist/src/web-ui/app/components/system-host/manager.js +34 -0
  777. package/dist/src/web-ui/app/components/system-host/rendering.js +12 -4
  778. package/dist/src/web-ui/app/components/workspace-shell.js +39 -6
  779. package/dist/src/web-ui/app/computer-access-feature.js +5 -0
  780. package/dist/src/web-ui/app/configuration-feature.js +1 -0
  781. package/dist/src/web-ui/app/controllers/app-event-bindings.js +24 -2
  782. package/dist/src/web-ui/app/controllers/automation-draft-actions.js +153 -0
  783. package/dist/src/web-ui/app/controllers/automation-management-actions.js +75 -0
  784. package/dist/src/web-ui/app/controllers/automation-mutation-lifecycle.js +32 -0
  785. package/dist/src/web-ui/app/controllers/automation-read-projection.js +63 -0
  786. package/dist/src/web-ui/app/controllers/automation-run-actions.js +54 -0
  787. package/dist/src/web-ui/app/controllers/automation-view-scope.js +19 -0
  788. package/dist/src/web-ui/app/controllers/automations-controller.js +395 -0
  789. package/dist/src/web-ui/app/controllers/composer-queue-controller.d.ts +1 -0
  790. package/dist/src/web-ui/app/controllers/composer-queue-controller.js +18 -12
  791. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +38 -15
  792. package/dist/src/web-ui/app/controllers/conversation-view-feature.js +1 -14
  793. package/dist/src/web-ui/app/controllers/dashboard-controller.js +42 -1
  794. package/dist/src/web-ui/app/controllers/notifications-controller.js +1 -1
  795. package/dist/src/web-ui/app/controllers/passive-learning-controller.js +33 -85
  796. package/dist/src/web-ui/app/controllers/projects-controller.d.ts +2 -0
  797. package/dist/src/web-ui/app/controllers/projects-controller.js +53 -18
  798. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +42 -160
  799. package/dist/src/web-ui/app/controllers/request-lifecycle-controller.js +2 -0
  800. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.d.ts +4 -1
  801. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.js +14 -3
  802. package/dist/src/web-ui/app/controllers/schedules-controller.js +11 -19
  803. package/dist/src/web-ui/app/controllers/spark-chat-notices.js +34 -0
  804. package/dist/src/web-ui/app/controllers/spark-chat-reading.js +145 -0
  805. package/dist/src/web-ui/app/controllers/spark-chat-sync.js +151 -0
  806. package/dist/src/web-ui/app/controllers/spark-handoff-navigation.js +32 -0
  807. package/dist/src/web-ui/app/controllers/workspace-route-controller.js +21 -1
  808. package/dist/src/web-ui/app/dashboard-feature.js +0 -1
  809. package/dist/src/web-ui/app/index.html +12 -10
  810. package/dist/src/web-ui/app/lib/automation-binding-producers.js +47 -0
  811. package/dist/src/web-ui/app/lib/automation-graph-position.js +19 -0
  812. package/dist/src/web-ui/app/lib/automation-parallel-depth.js +19 -0
  813. package/dist/src/web-ui/app/lib/configuration-pages.js +3 -5
  814. package/dist/src/web-ui/app/lib/context-compaction-state.d.ts +41 -0
  815. package/dist/src/web-ui/app/lib/context-compaction-state.js +172 -0
  816. package/dist/src/web-ui/app/lib/context-window-measurement.d.ts +33 -0
  817. package/dist/src/web-ui/app/lib/context-window-measurement.js +99 -0
  818. package/dist/src/web-ui/app/lib/context-window-replay.d.ts +32 -0
  819. package/dist/src/web-ui/app/lib/context-window-replay.js +38 -0
  820. package/dist/src/web-ui/app/lib/context-window-snapshot-order.d.ts +16 -8
  821. package/dist/src/web-ui/app/lib/context-window-snapshot-order.js +29 -9
  822. package/dist/src/web-ui/app/lib/context-window-state.d.ts +80 -0
  823. package/dist/src/web-ui/app/lib/context-window-state.js +341 -0
  824. package/dist/src/web-ui/app/lib/conversation-status-model.js +15 -3
  825. package/dist/src/web-ui/app/lib/realtime-message.js +9 -0
  826. package/dist/src/web-ui/app/lib/schedule-conversation-presentation.js +19 -0
  827. package/dist/src/web-ui/app/lib/schedule-presentation.js +2 -2
  828. package/dist/src/web-ui/app/lib/spark-chat-address.js +22 -0
  829. package/dist/src/web-ui/app/lib/spark-chat-presentation.js +16 -0
  830. package/dist/src/web-ui/app/lib/spark-chat-read-state.js +13 -0
  831. package/dist/src/web-ui/app/lib/spark-proposal-message.js +7 -0
  832. package/dist/src/web-ui/app/lib/tool-activity-event.d.ts +1 -0
  833. package/dist/src/web-ui/app/lib/tool-activity-event.js +6 -2
  834. package/dist/src/web-ui/app/lib/tool-activity-model.js +1 -0
  835. package/dist/src/web-ui/app/lib/tool-approval-acknowledgement.js +7 -0
  836. package/dist/src/web-ui/app/lib/tool-automation-activity-fields.js +59 -0
  837. package/dist/src/web-ui/app/lib/tool-process-activity-fields.js +1 -1
  838. package/dist/src/web-ui/app/lib/workspace-change.js +2 -2
  839. package/dist/src/web-ui/app/lib/workspace-route.d.ts +3 -0
  840. package/dist/src/web-ui/app/lib/workspace-route.js +13 -2
  841. package/dist/src/web-ui/app/notifications-feature.js +13 -0
  842. package/dist/src/web-ui/app/passive-learning-feature.js +5 -30
  843. package/dist/src/web-ui/app/projects-feature.js +16 -5
  844. package/dist/src/web-ui/app/runtime-onboarding-feature.js +1 -0
  845. package/dist/src/web-ui/app/services/client-preferences.d.ts +0 -2
  846. package/dist/src/web-ui/app/services/client-preferences.js +0 -2
  847. package/dist/src/web-ui/app/services/runtime-web-client/automations.d.ts +36 -0
  848. package/dist/src/web-ui/app/services/runtime-web-client/automations.js +63 -0
  849. package/dist/src/web-ui/app/services/runtime-web-client/learning.js +0 -9
  850. package/dist/src/web-ui/app/services/runtime-web-client/spark-chat.d.ts +22 -0
  851. package/dist/src/web-ui/app/services/runtime-web-client/spark-chat.js +29 -0
  852. package/dist/src/web-ui/app/services/runtime-web-client/system-host.js +4 -2
  853. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +24 -4
  854. package/dist/src/web-ui/app/services/runtime-web-client.js +5 -1
  855. package/dist/src/web-ui/app/spark-chat-conversation.js +217 -0
  856. package/dist/src/web-ui/app/spark-chat-feature.js +187 -0
  857. package/dist/src/web-ui/app/spark-mascot.svg +12 -0
  858. package/dist/src/web-ui/app/styles/11-workspace-header-width.css +48 -14
  859. package/dist/src/web-ui/app/styles/11-workspace-rail.css +6 -0
  860. package/dist/src/web-ui/app/styles/19-dashboard-automations.css +32 -0
  861. package/dist/src/web-ui/app/styles/41-co-worker-agent.css +6 -25
  862. package/dist/src/web-ui/app/styles/46-system-host.css +17 -0
  863. package/dist/src/web-ui/app/styles/48-notifications.css +14 -8
  864. package/dist/src/web-ui/app/styles/50-automations.css +353 -0
  865. package/dist/src/web-ui/app/styles/51-automation-editor-actions.css +35 -0
  866. package/dist/src/web-ui/app/styles/51-automation-templates.css +39 -0
  867. package/dist/src/web-ui/app/styles/52-automation-reports.css +84 -0
  868. package/dist/src/web-ui/app/styles/52-automation-step-editor.css +73 -0
  869. package/dist/src/web-ui/app/styles/53-automation-schema-inputs.css +21 -0
  870. package/dist/src/web-ui/app/styles/54-spark-chat.css +111 -0
  871. package/dist/src/web-ui/app/styles/94-automations-responsive.css +35 -0
  872. package/dist/src/web-ui/app/styles.css +9 -1
  873. package/dist/src/web-ui/app/ui-behavior.js +1 -0
  874. package/dist/src/web-ui/local-runtime/api-router.d.ts +2 -0
  875. package/dist/src/web-ui/local-runtime/api-router.js +18 -0
  876. package/dist/src/web-ui/local-runtime/automation-routes.d.ts +27 -0
  877. package/dist/src/web-ui/local-runtime/automation-routes.js +227 -0
  878. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +4 -0
  879. package/dist/src/web-ui/local-runtime/environment-registry.js +5 -0
  880. package/dist/src/web-ui/local-runtime/learning-notifications.js +1 -1
  881. package/dist/src/web-ui/local-runtime/learning-routes.js +0 -22
  882. package/dist/src/web-ui/local-runtime/request-execution.js +35 -0
  883. package/dist/src/web-ui/local-runtime/session-routes.js +32 -2
  884. package/dist/src/web-ui/local-runtime/setup-embedding-config-repository.d.ts +6 -0
  885. package/dist/src/web-ui/local-runtime/setup-embedding-config-repository.js +25 -0
  886. package/dist/src/web-ui/local-runtime/setup-embedding-service.js +2 -0
  887. package/dist/src/web-ui/local-runtime/spark-chat-admission.d.ts +7 -0
  888. package/dist/src/web-ui/local-runtime/spark-chat-admission.js +37 -0
  889. package/dist/src/web-ui/local-runtime/spark-chat-configuration.d.ts +8 -0
  890. package/dist/src/web-ui/local-runtime/spark-chat-configuration.js +16 -0
  891. package/dist/src/web-ui/local-runtime/spark-chat-handoff.d.ts +4 -0
  892. package/dist/src/web-ui/local-runtime/spark-chat-handoff.js +84 -0
  893. package/dist/src/web-ui/local-runtime/spark-chat-routes.d.ts +19 -0
  894. package/dist/src/web-ui/local-runtime/spark-chat-routes.js +62 -0
  895. package/dist/src/web-ui/local-runtime-backend.d.ts +4 -0
  896. package/dist/src/web-ui/local-runtime-backend.js +3 -0
  897. package/dist/src/web-ui/notifications/automation-event-projection.d.ts +3 -0
  898. package/dist/src/web-ui/notifications/automation-event-projection.js +57 -0
  899. package/dist/src/web-ui/notifications/contracts.d.ts +20 -5
  900. package/dist/src/web-ui/notifications/contracts.js +7 -1
  901. package/dist/src/web-ui/notifications/conversation-source.d.ts +6 -0
  902. package/dist/src/web-ui/notifications/conversation-source.js +26 -0
  903. package/dist/src/web-ui/notifications/event-fields.d.ts +3 -0
  904. package/dist/src/web-ui/notifications/event-fields.js +12 -0
  905. package/dist/src/web-ui/notifications/event-projection.d.ts +2 -1
  906. package/dist/src/web-ui/notifications/event-projection.js +22 -20
  907. package/dist/src/web-ui/notifications/service.js +33 -2
  908. package/dist/src/web-ui/notifications/storage-schema.js +118 -21
  909. package/dist/src/web-ui/server.js +1 -1
  910. package/dist/src/web-ui/session-read-state/service.d.ts +39 -0
  911. package/dist/src/web-ui/session-read-state/service.js +20 -2
  912. package/dist/src/web-ui/session-read-state/store.d.ts +2 -0
  913. package/dist/src/web-ui/session-read-state/store.js +7 -0
  914. package/dist/src/web-ui/session-read-state/visible-messages.d.ts +30 -0
  915. package/dist/src/web-ui/session-read-state/visible-messages.js +119 -0
  916. package/dist/src/web-ui/system-host-service.d.ts +4 -1
  917. package/dist/src/web-ui/system-host-service.js +14 -3
  918. package/dist/src/web-ui/system-host-setup/local-request-authority.d.ts +3 -0
  919. package/dist/src/web-ui/system-host-setup/local-request-authority.js +15 -0
  920. package/dist/src/web-ui/system-host-setup/local-setup-availability.js +2 -12
  921. package/dist/src/web-ui/system-host-setup/native-permission-route.d.ts +26 -0
  922. package/dist/src/web-ui/system-host-setup/native-permission-route.js +96 -0
  923. package/dist/src/web-ui/system-host-setup/permission-route.d.ts +13 -0
  924. package/dist/src/web-ui/system-host-setup/permission-route.js +102 -0
  925. package/docs/installation.md +41 -9
  926. package/docs/plugins.md +53 -11
  927. package/docs/runtime-public-contracts.md +7 -2
  928. package/docs/tool-execution-result-evidence-contract.md +11 -4
  929. package/package.json +1 -1
  930. package/plugins/capability-brief/src/index.cjs +85 -37
  931. package/plugins/code-outline/source/index.ts +7 -2
  932. package/plugins/code-outline/src/index.cjs +91 -39
  933. package/plugins/document-reader/plugin.json +18 -3
  934. package/plugins/document-reader/skills/document_reader_skill/SKILL.md +6 -6
  935. package/plugins/document-reader/source/source-resolution.ts +1 -1
  936. package/plugins/document-reader/src/index.cjs +86 -38
  937. package/plugins/exec/plugin.json +3 -3
  938. package/plugins/exec/source/handlers.ts +78 -20
  939. package/plugins/exec/source/output-contracts.ts +45 -0
  940. package/plugins/exec/source/output-files.ts +161 -0
  941. package/plugins/exec/source/output-maintenance.ts +60 -0
  942. package/plugins/exec/source/output-range-reader.ts +97 -0
  943. package/plugins/exec/source/output-retention.ts +34 -0
  944. package/plugins/exec/source/output-snapshot.ts +54 -0
  945. package/plugins/exec/source/output-store.ts +182 -0
  946. package/plugins/exec/source/output-utf8-boundary.ts +14 -0
  947. package/plugins/exec/source/output-writer.ts +131 -0
  948. package/plugins/exec/source/process-manager.ts +142 -70
  949. package/plugins/exec/source/process-output-buffer.ts +13 -18
  950. package/plugins/exec/source/process-output.ts +158 -0
  951. package/plugins/exec/source/request-resources.ts +28 -12
  952. package/plugins/exec/source/result-presentation.ts +39 -39
  953. package/plugins/exec/source/retained-output-failure.ts +51 -0
  954. package/plugins/exec/source/settings.ts +9 -10
  955. package/plugins/exec/source/terminal-delivery.ts +49 -0
  956. package/plugins/exec/source/types.ts +12 -1
  957. package/plugins/exec/src/index.cjs +1112 -188
  958. package/plugins/filesystem/plugin.json +5 -5
  959. package/plugins/filesystem/skills/read_file_skill/SKILL.md +1 -1
  960. package/plugins/filesystem/src/index.cjs +85 -37
  961. package/plugins/json-inspector/source/index.ts +7 -2
  962. package/plugins/json-inspector/src/index.cjs +91 -39
  963. package/plugins/local-search/source/index.ts +9 -4
  964. package/plugins/local-search/src/index.cjs +93 -41
  965. package/plugins/memory/src/index.cjs +85 -37
  966. package/plugins/project-orientation/source/index.ts +9 -4
  967. package/plugins/project-orientation/src/index.cjs +93 -41
  968. package/plugins/system/plugin.json +2 -2
  969. package/plugins/system/source/computer/observation-output.ts +1 -1
  970. package/plugins/system/src/index.cjs +88 -43
  971. package/plugins/system-probe/source/index.ts +7 -2
  972. package/plugins/system-probe/src/index.cjs +91 -39
  973. package/plugins/web/README.md +9 -0
  974. package/plugins/web/source/plugin.ts +5 -3
  975. package/plugins/web/source/research.ts +7 -7
  976. package/plugins/web/src/index.cjs +96 -43
  977. package/src/runtime/README.md +100 -11
  978. package/src/runtime/scheduler/README.md +63 -0
  979. package/dist/src/web-ui/app/components/passive-learning/proposal-notifications.js +0 -106
  980. package/dist/src/web-ui/app/components/passive-learning/proposal-read-state.js +0 -23
  981. package/dist/src/web-ui/app/components/passive-learning/proposal-view.js +0 -23
  982. package/dist/src/web-ui/app/components/spark-conversation-actions.js +0 -62
  983. package/dist/src/web-ui/app/services/spark-conversation-preferences.js +0 -27
  984. package/dist/src/web-ui/app/styles/29-spark-conversation.css +0 -19
@@ -37,6 +37,7 @@ export async function initializeRequestSession(params) {
37
37
  ? { attachments: params.opened.attachments }
38
38
  : {}),
39
39
  });
40
+ params.onUserMessagePersisted?.();
40
41
  params.events.event("session.messages.updated", {
41
42
  sessionId: params.sessionId,
42
43
  });
@@ -3,7 +3,7 @@ import type { SessionStore } from "../ports.js";
3
3
  import { type SessionDeletionFinalizer } from "./session-deletion-finalization.js";
4
4
  import type { SessionMutationQueue } from "./session-mutation-queue.js";
5
5
  /** Shared transaction for managed stores and compatibility deletion adapters. */
6
- export declare function createSessionDeletionBoundary(base: Pick<SessionStore, "deleteSessionWithStats">, enqueue: SessionMutationQueue, finalize?: SessionDeletionFinalizer): {
6
+ export declare function createSessionDeletionBoundary(base: Pick<SessionStore, "deleteSessionWithStats">, enqueue: SessionMutationQueue, finalize?: SessionDeletionFinalizer, beforeDelete?: (sessionId: string) => Promise<void>): {
7
7
  deleteSessionWithStats: (sessionId: string) => Promise<SessionDeleteResult>;
8
8
  isDeleted: (sessionId: string) => boolean;
9
9
  onDeleted: (listener: import("./session-deletion-cleanup.js").SessionDeletionListener) => () => void;
@@ -3,7 +3,7 @@ import { createSessionDeletionCleanup } from "./session-deletion-cleanup.js";
3
3
  import { createSessionDeletionFinalization, } from "./session-deletion-finalization.js";
4
4
  import { createSessionDeletionReceipts } from "./session-deletion-receipts.js";
5
5
  /** Shared transaction for managed stores and compatibility deletion adapters. */
6
- export function createSessionDeletionBoundary(base, enqueue, finalize) {
6
+ export function createSessionDeletionBoundary(base, enqueue, finalize, beforeDelete) {
7
7
  const cleanup = createSessionDeletionCleanup();
8
8
  const receipts = createSessionDeletionReceipts(base);
9
9
  const finalization = finalize
@@ -11,13 +11,17 @@ export function createSessionDeletionBoundary(base, enqueue, finalize) {
11
11
  : undefined;
12
12
  if (finalization)
13
13
  cleanup.onDeleted(finalization.finalizeDeletedSession);
14
+ async function removePhysicalSession(sessionId) {
15
+ await beforeDelete?.(sessionId);
16
+ return receipts.remove(sessionId);
17
+ }
14
18
  async function deleteSessionWithStats(sessionId) {
15
19
  assertValidSessionId(sessionId);
16
20
  const settlePhysical = finalization?.prepare(sessionId);
17
21
  let notification;
18
22
  // Reserve before invoking listeners: synchronous reentry must queue behind us.
19
23
  const result = enqueue(sessionId, async () => {
20
- const [deletion] = await Promise.allSettled([receipts.remove(sessionId)]);
24
+ const [deletion] = await Promise.allSettled([removePhysicalSession(sessionId)]);
21
25
  settlePhysical?.(deletion);
22
26
  const [notified] = await notification;
23
27
  if (deletion.status === "rejected")
@@ -1,6 +1,7 @@
1
1
  import type { SessionStore } from "../ports.js";
2
2
  import type { SessionDeletionListener } from "./session-deletion-cleanup.js";
3
3
  import type { SessionDeletionFinalizer } from "./session-deletion-finalization.js";
4
+ import type { SessionClearBoundary } from "./spark-session-clear.js";
4
5
  export type { SessionDeletionListener } from "./session-deletion-cleanup.js";
5
6
  export declare class SessionDeletedError extends Error {
6
7
  readonly sessionId: string;
@@ -18,4 +19,6 @@ export type SessionLifecycleStore = Readonly<{
18
19
  * an in-flight write finishes before deletion, while queued and later writes fail.
19
20
  * Tombstones last for this application lifetime; deleted IDs cannot be reused.
20
21
  */
21
- export declare function createSessionLifecycleStore(base: SessionStore, finalizeDeletion?: SessionDeletionFinalizer): SessionLifecycleStore;
22
+ export declare function createSessionLifecycleStore(base: SessionStore, finalizeDeletion?: SessionDeletionFinalizer,
23
+ /** Runs inside the deletion queue after the tombstone, before the transcript is removed. */
24
+ beforeDelete?: (sessionId: string) => Promise<void>, clearBoundary?: SessionClearBoundary): SessionLifecycleStore;
@@ -17,9 +17,11 @@ export function isSessionDeletedError(error) {
17
17
  * an in-flight write finishes before deletion, while queued and later writes fail.
18
18
  * Tombstones last for this application lifetime; deleted IDs cannot be reused.
19
19
  */
20
- export function createSessionLifecycleStore(base, finalizeDeletion) {
20
+ export function createSessionLifecycleStore(base, finalizeDeletion,
21
+ /** Runs inside the deletion queue after the tombstone, before the transcript is removed. */
22
+ beforeDelete, clearBoundary) {
21
23
  const enqueueSessionMutation = createSessionMutationQueue();
22
- const deletion = createSessionDeletionBoundary(base, enqueueSessionMutation, finalizeDeletion);
24
+ const deletion = createSessionDeletionBoundary(base, enqueueSessionMutation, finalizeDeletion, beforeDelete);
23
25
  function assertSessionNotDeleted(sessionId) {
24
26
  if (deletion.isDeleted(sessionId)) {
25
27
  throw new SessionDeletedError(sessionId);
@@ -35,6 +37,21 @@ export function createSessionLifecycleStore(base, finalizeDeletion) {
35
37
  };
36
38
  }
37
39
  const store = {
40
+ ...(base.assertInteractiveSession
41
+ ? { assertInteractiveSession: base.assertInteractiveSession.bind(base) }
42
+ : {}),
43
+ ...(base.createAutomationSession
44
+ ? {
45
+ createAutomationSession: wrapSessionMutation(base.createAutomationSession),
46
+ }
47
+ : {}),
48
+ ...(base.runAsAutomationSession
49
+ ? { runAsAutomationSession: base.runAsAutomationSession.bind(base) }
50
+ : {}),
51
+ ...(base.releaseAutomationSession
52
+ ? { releaseAutomationSession: base.releaseAutomationSession.bind(base) } : {}),
53
+ ...(base.reconcileAutomationSessions
54
+ ? { reconcileAutomationSessions: base.reconcileAutomationSessions.bind(base) } : {}),
38
55
  ...(base.requestLifecycle
39
56
  ? {
40
57
  requestLifecycle: {
@@ -55,6 +72,9 @@ export function createSessionLifecycleStore(base, finalizeDeletion) {
55
72
  }
56
73
  : {}),
57
74
  getAllSessions: base.getAllSessions.bind(base),
75
+ ...(base.appendAssistantInitiative
76
+ ? { appendAssistantInitiative: wrapSessionMutation(base.appendAssistantInitiative) }
77
+ : {}),
58
78
  listSessions: base.listSessions.bind(base),
59
79
  getSessionById: base.getSessionById.bind(base),
60
80
  getSessionSnapshot: base.getSessionSnapshot.bind(base),
@@ -65,8 +85,8 @@ export function createSessionLifecycleStore(base, finalizeDeletion) {
65
85
  startRequestStream: wrapSessionMutation(base.startRequestStream),
66
86
  appendRequestEvent: wrapSessionMutation(base.appendRequestEvent),
67
87
  compareAndSwapSessionMemoryCheckpoint: wrapSessionMutation(base.compareAndSwapSessionMemoryCheckpoint),
68
- resetSession: wrapSessionMutation(base.resetSession),
69
- clearSessionMessages: wrapSessionMutation(base.clearSessionMessages),
88
+ resetSession: wrapSessionClear(base.resetSession),
89
+ clearSessionMessages: wrapSessionClear(base.clearSessionMessages),
70
90
  deleteMessage: wrapSessionMutation(base.deleteMessage),
71
91
  deleteMessageWithStats: wrapSessionMutation(base.deleteMessageWithStats),
72
92
  deleteSession: async (sessionId) => (await deletion.deleteSessionWithStats(sessionId)).deleted,
@@ -88,4 +108,12 @@ export function createSessionLifecycleStore(base, finalizeDeletion) {
88
108
  isDeleted: deletion.isDeleted,
89
109
  onDeleted: deletion.onDeleted,
90
110
  };
111
+ function wrapSessionClear(operation) {
112
+ const mutate = wrapSessionMutation(operation);
113
+ return (sessionId) => {
114
+ if (!clearBoundary)
115
+ return mutate(sessionId);
116
+ return clearBoundary(sessionId, () => mutate(sessionId));
117
+ };
118
+ }
91
119
  }
@@ -0,0 +1,4 @@
1
+ import type { SessionRecord } from "../../sessions/types.js";
2
+ import type { RuntimeAttachmentStore } from "../attachments/store.js";
3
+ /** Capture only transcript-owned files; a simultaneous new upload is a different reference. */
4
+ export declare function prepareSparkAttachmentCleanup(attachments: RuntimeAttachmentStore | undefined, session: SessionRecord | null, runtimeDirectory?: string): Promise<() => Promise<void>>;
@@ -0,0 +1,28 @@
1
+ import { createSparkCleanupReceipt } from "./spark-session-cleanup-receipt.js";
2
+ /** Capture only transcript-owned files; a simultaneous new upload is a different reference. */
3
+ export async function prepareSparkAttachmentCleanup(attachments, session, runtimeDirectory) {
4
+ const receipt = runtimeDirectory ? createSparkCleanupReceipt(runtimeDirectory) : undefined;
5
+ const pending = await receipt?.read() ?? [];
6
+ const captured = (session?.messages ?? []).flatMap((message) => message.attachments ?? []);
7
+ const references = [...new Map([...pending, ...captured]
8
+ .map((attachment) => [attachment.storageRef, attachment])).values()];
9
+ if (references.length === 0)
10
+ return async () => { };
11
+ const deleteAttachment = attachments?.deleteAttachment?.bind(attachments);
12
+ if (!deleteAttachment)
13
+ throw new Error("spark_chat_attachment_cleanup_unavailable");
14
+ if (!receipt)
15
+ throw new Error("spark_chat_cleanup_receipt_unavailable");
16
+ // Persist before transcript removal. A failed deletion never loses its retry reference.
17
+ await receipt.save(references);
18
+ return async () => {
19
+ const outcomes = await Promise.allSettled(references.map((reference) => deleteAttachment(reference, { sessionId: session.id })));
20
+ const failed = outcomes.find(isAttachmentCleanupFailure);
21
+ if (failed)
22
+ throw failed.reason;
23
+ await receipt.complete();
24
+ };
25
+ }
26
+ function isAttachmentCleanupFailure(outcome) {
27
+ return outcome.status === "rejected";
28
+ }
@@ -0,0 +1,7 @@
1
+ import { type RuntimeAttachmentReference } from "../attachments/store.js";
2
+ /** Exact pending deletions, accessed only while the owner holds SPARK admission. */
3
+ export declare function createSparkCleanupReceipt(runtimeDirectory: string): {
4
+ read(): Promise<RuntimeAttachmentReference[]>;
5
+ save(references: RuntimeAttachmentReference[]): Promise<void>;
6
+ complete(): Promise<void>;
7
+ };
@@ -0,0 +1,61 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { mkdir, open, readFile, rename, rm } from "node:fs/promises";
3
+ import { dirname, join } from "node:path";
4
+ import { syncSessionDirectory } from "../../sessions/durable-session-commit.js";
5
+ import { SPARK_SESSION_ID } from "../../sessions/spark-session.js";
6
+ import { parseRuntimeAttachmentReferences } from "../attachments/store.js";
7
+ function isMissingCleanupReceipt(error) {
8
+ return error instanceof Error && "code" in error && error.code === "ENOENT";
9
+ }
10
+ function parseCleanupReceipt(value) {
11
+ if (!value || typeof value !== "object")
12
+ throw new Error("spark_chat_cleanup_receipt_invalid");
13
+ if (!("schemaVersion" in value) || value.schemaVersion !== 1)
14
+ throw new Error("spark_chat_cleanup_receipt_invalid");
15
+ if (!("sessionId" in value) || value.sessionId !== SPARK_SESSION_ID)
16
+ throw new Error("spark_chat_cleanup_receipt_invalid");
17
+ if (!("references" in value) || !Array.isArray(value.references))
18
+ throw new Error("spark_chat_cleanup_receipt_invalid");
19
+ return parseRuntimeAttachmentReferences(value.references);
20
+ }
21
+ /** Exact pending deletions, accessed only while the owner holds SPARK admission. */
22
+ export function createSparkCleanupReceipt(runtimeDirectory) {
23
+ const directory = join(runtimeDirectory, "spark-chat");
24
+ const path = join(directory, "attachment-cleanup.json");
25
+ return {
26
+ async read() {
27
+ try {
28
+ return parseCleanupReceipt(JSON.parse(await readFile(path, "utf8")));
29
+ }
30
+ catch (error) {
31
+ if (isMissingCleanupReceipt(error))
32
+ return [];
33
+ throw error;
34
+ }
35
+ },
36
+ async save(references) {
37
+ await mkdir(directory, { recursive: true, mode: 0o700 });
38
+ await syncSessionDirectory(dirname(directory));
39
+ const temporary = `${path}.${randomUUID()}.tmp`;
40
+ try {
41
+ const handle = await open(temporary, "wx", 0o600);
42
+ try {
43
+ await handle.writeFile(JSON.stringify({ schemaVersion: 1, sessionId: SPARK_SESSION_ID, references }));
44
+ await handle.sync();
45
+ }
46
+ finally {
47
+ await handle.close();
48
+ }
49
+ await rename(temporary, path);
50
+ await syncSessionDirectory(directory);
51
+ }
52
+ finally {
53
+ await rm(temporary, { force: true }).catch(() => undefined);
54
+ }
55
+ },
56
+ async complete() {
57
+ await rm(path, { force: true });
58
+ await syncSessionDirectory(directory);
59
+ },
60
+ };
61
+ }
@@ -0,0 +1,6 @@
1
+ import type { SessionStore } from "../ports.js";
2
+ import type { SessionRequestAdmission } from "../request/session-admission.js";
3
+ import type { RuntimeAttachmentStore } from "../attachments/store.js";
4
+ export type SessionClearBoundary = <T>(sessionId: string, clear: () => Promise<T>) => Promise<T>;
5
+ /** Protect the permanent conversation without changing ordinary session clearing. */
6
+ export declare function createSparkSessionClearBoundary(sessions: Pick<SessionStore, "getSessionById" | "requestLifecycle">, admission: () => SessionRequestAdmission, attachments?: RuntimeAttachmentStore, runtimeDirectory?: string): SessionClearBoundary;
@@ -0,0 +1,36 @@
1
+ import { isSparkSession, SPARK_SESSION_ID } from "../../sessions/spark-session.js";
2
+ import { prepareSparkAttachmentCleanup } from "./spark-session-attachments.js";
3
+ /** Protect the permanent conversation without changing ordinary session clearing. */
4
+ export function createSparkSessionClearBoundary(sessions, admission, attachments, runtimeDirectory) {
5
+ return async (sessionId, clear) => {
6
+ if (!(await isCompanionClear(sessions, sessionId)))
7
+ return clear();
8
+ const release = admission().tryReserve(sessionId);
9
+ if (!release)
10
+ throw new Error("spark_chat_busy");
11
+ try {
12
+ // Recheck after reservation: a parked request is idle but its saved wait remains active.
13
+ if (await hasSavedCompanionApproval(sessions, sessionId))
14
+ throw new Error("spark_chat_busy");
15
+ const cleanup = await prepareSparkAttachmentCleanup(attachments, await sessions.getSessionById(sessionId), runtimeDirectory);
16
+ const result = await clear();
17
+ await cleanup();
18
+ return result;
19
+ }
20
+ finally {
21
+ release();
22
+ }
23
+ };
24
+ }
25
+ async function isCompanionClear(sessions, sessionId) {
26
+ if (sessionId !== SPARK_SESSION_ID)
27
+ return false;
28
+ const session = await sessions.getSessionById(sessionId);
29
+ if (!session)
30
+ return false;
31
+ return isSparkSession(session);
32
+ }
33
+ async function hasSavedCompanionApproval(sessions, sessionId) {
34
+ const waiting = await sessions.requestLifecycle?.listWaiting(sessionId);
35
+ return (waiting?.length ?? 0) > 0;
36
+ }
@@ -0,0 +1,21 @@
1
+ import type { SessionTerminalMessage } from "../../sessions/request-lifecycle/contracts.js";
2
+ import type { AgentMode } from "../../shared/types.js";
3
+ import type { RequestSessionStore } from "../request/session-store.js";
4
+ /** One non-durable terminal append. A rejected write has an uncertain outcome. */
5
+ export declare class TerminalResponseAppend {
6
+ private readonly params;
7
+ private attempted;
8
+ private persisted;
9
+ constructor(params: {
10
+ store: Pick<RequestSessionStore, "appendMessage">;
11
+ sessionId: string;
12
+ requestId: string;
13
+ agentMode: AgentMode;
14
+ });
15
+ snapshot(): Readonly<{
16
+ attempted: boolean;
17
+ persisted: boolean;
18
+ }>;
19
+ failureOutcome(error: unknown): "persisted" | "session_deleted" | "uncertain";
20
+ append(message: SessionTerminalMessage): Promise<void>;
21
+ }
@@ -0,0 +1,38 @@
1
+ import { isSessionDeletedError } from "./session-lifecycle-store.js";
2
+ /** One non-durable terminal append. A rejected write has an uncertain outcome. */
3
+ export class TerminalResponseAppend {
4
+ params;
5
+ attempted = false;
6
+ persisted = false;
7
+ constructor(params) {
8
+ this.params = params;
9
+ }
10
+ snapshot() {
11
+ return Object.freeze({
12
+ attempted: this.attempted,
13
+ persisted: this.persisted,
14
+ });
15
+ }
16
+ failureOutcome(error) {
17
+ if (!this.attempted)
18
+ return "uncertain";
19
+ if (this.persisted)
20
+ return "persisted";
21
+ if (isSessionDeletedError(error) &&
22
+ error.sessionId === this.params.sessionId)
23
+ return "session_deleted";
24
+ return "uncertain";
25
+ }
26
+ async append(message) {
27
+ if (this.attempted)
28
+ throw new Error("terminal_response_append_already_attempted");
29
+ this.attempted = true;
30
+ const { content, ...metadata } = message;
31
+ await this.params.store.appendMessage(this.params.sessionId, "assistant", content, {
32
+ ...metadata,
33
+ lastAgentMode: this.params.agentMode,
34
+ requestId: this.params.requestId,
35
+ });
36
+ this.persisted = true;
37
+ }
38
+ }
@@ -9,6 +9,7 @@ export type AuditorAdvisoryReceipt = Readonly<{
9
9
  kind: typeof EVIDENCE_BINDING_KIND;
10
10
  workFingerprint: string;
11
11
  selectedEvidenceIds: readonly string[];
12
+ compactedEvidenceIds?: readonly string[];
12
13
  bundleFingerprint: string | null;
13
14
  }>;
14
15
  }>;
@@ -66,6 +66,13 @@ export function readAuditorAdvisoryReceipt(summary) {
66
66
  return undefined;
67
67
  if (!isStringArray(source.selectedEvidenceIds))
68
68
  return undefined;
69
+ if (source.compactedEvidenceIds !== undefined) {
70
+ if (!isStringArray(source.compactedEvidenceIds))
71
+ return undefined;
72
+ const selected = new Set(source.selectedEvidenceIds);
73
+ if (source.compactedEvidenceIds.some((id) => !selected.has(id)))
74
+ return undefined;
75
+ }
69
76
  const expectedBundle = source.selectedEvidenceIds.length > 0
70
77
  ? fingerprintAuditorBundle(source.workFingerprint, source.selectedEvidenceIds)
71
78
  : null;
@@ -74,10 +81,15 @@ export function readAuditorAdvisoryReceipt(summary) {
74
81
  return value;
75
82
  }
76
83
  function binding(assignment) {
84
+ const compactedIds = new Set(assignment.compactedSourceEvidence?.sources.map((source) => source.executionId));
85
+ const compactedEvidenceIds = assignment.selectedEvidenceIds.filter((id) => compactedIds.has(id));
77
86
  return Object.freeze({
78
87
  kind: EVIDENCE_BINDING_KIND,
79
88
  workFingerprint: assignment.workFingerprint,
80
89
  selectedEvidenceIds: assignment.selectedEvidenceIds,
90
+ ...(compactedEvidenceIds.length > 0
91
+ ? { compactedEvidenceIds: Object.freeze(compactedEvidenceIds) }
92
+ : {}),
81
93
  bundleFingerprint: assignment.selectedEvidenceIds.length > 0
82
94
  ? fingerprintAuditorBundle(assignment.workFingerprint, assignment.selectedEvidenceIds)
83
95
  : null,
@@ -1,3 +1,4 @@
1
+ import type { ExecutionCompactedSources } from "../../context/execution-compacted-evidence.js";
1
2
  import type { CapabilityAdapterResult } from "../../orchestration/capability-adapters/index.js";
2
3
  export declare const AUDITOR_DECISION_MODEL_STEP: "auditor.decision";
3
4
  export declare const EXECUTION_AGENT_ROOT_AUDIT_CRITERION_ID: "request_completion";
@@ -48,6 +49,8 @@ export type AuditorEvidenceInventoryEntry = Readonly<{
48
49
  referenceCount: number;
49
50
  omittedReferencePreviewCount: number;
50
51
  exactEvidenceChars: number;
52
+ evidencePresentation?: "compacted";
53
+ projectedEvidenceChars?: number;
51
54
  evidenceFingerprint: string;
52
55
  }>;
53
56
  export type AuditorAssignment = Readonly<{
@@ -64,6 +67,7 @@ export type AuditorAssignment = Readonly<{
64
67
  reviewedEvidenceBundles: readonly (readonly string[])[];
65
68
  pendingEvidenceIds: readonly string[] | null;
66
69
  evidence: readonly AuditorEvidence[];
70
+ compactedSourceEvidence?: ExecutionCompactedSources;
67
71
  availableEvidenceCount: number;
68
72
  omittedEvidenceCount: number;
69
73
  }>;
@@ -12,13 +12,13 @@ export function validateAuditorEvidenceCoverage(value, assignment) {
12
12
  if (!isEmptyEvidenceRequest(value.requestedEvidenceIds)) {
13
13
  return issue("auditor_unexpected_evidence_request", "Only needs_evidence may request another bundle.");
14
14
  }
15
- if (!requiresCurrentOriginalEvidence(value.verdict))
15
+ if (!requiresCurrentEvidence(value.verdict))
16
16
  return [];
17
17
  if (!projectAuditorEvidenceProjectionStatus(assignment).complete) {
18
- return issue(`auditor_${value.verdict}_evidence_incomplete`, "Conclusive verdicts require all selected original evidence without omissions.");
18
+ return issue(`auditor_${value.verdict}_evidence_incomplete`, "Conclusive verdicts require all selected evidence representations to be present.");
19
19
  }
20
20
  if (!hasCurrentNeededEvidence(needed, assignment, value.verdict)) {
21
- return issue(`auditor_${value.verdict}_needed_evidence_missing`, "Every needed evidence ID must be present in the current exact bundle; previews and prior reviews are not proof.");
21
+ return issue(`auditor_${value.verdict}_needed_evidence_missing`, "Every needed evidence ID must be present in the current admitted bundle; previews and prior reviews are not proof.");
22
22
  }
23
23
  return [];
24
24
  }
@@ -33,7 +33,7 @@ function hasExactInventoryCoverage(needed, notNeeded, assignment) {
33
33
  const inventoryIds = new Set(assignment.inventory.map((entry) => entry.executionId));
34
34
  return ids.every((id) => typeof id === "string" && inventoryIds.has(id));
35
35
  }
36
- function requiresCurrentOriginalEvidence(verdict) {
36
+ function requiresCurrentEvidence(verdict) {
37
37
  if (verdict === "pass")
38
38
  return true;
39
39
  return verdict === "gaps";
@@ -56,7 +56,7 @@ function validateRequestedBundle(ids, needed, assignment) {
56
56
  if (code)
57
57
  return issue(code, "Request a complete admissible evidence bundle that has not already been reviewed for this work snapshot.");
58
58
  if (!hasRequestedNeededEvidence(needed, ids))
59
- return issue("auditor_requested_needed_evidence_missing", "The requested next bundle must include every needed evidence ID, including originals already read in the current bundle.");
59
+ return issue("auditor_requested_needed_evidence_missing", "The requested next bundle must include every needed evidence ID, including representations already read in the current bundle.");
60
60
  return [];
61
61
  }
62
62
  function hasRequestedNeededEvidence(needed, requested) {
@@ -1,7 +1,8 @@
1
+ import type { ExecutionCompactedSources } from "../../context/execution-compacted-evidence.js";
1
2
  import type { RoleCallLedgerHead } from "../../orchestration/role-calls/index.js";
2
3
  import type { AuditorCapabilityEvidence, AuditorEvidenceInventoryEntry } from "./contracts.js";
3
4
  export declare function projectAuditorWorkEvidence(head: RoleCallLedgerHead, callerCallId: string): readonly AuditorCapabilityEvidence[];
4
- export declare function projectAuditorEvidenceInventory(head: RoleCallLedgerHead, callerCallId: string, evidence: readonly AuditorCapabilityEvidence[]): readonly AuditorEvidenceInventoryEntry[];
5
+ export declare function projectAuditorEvidenceInventory(head: RoleCallLedgerHead, callerCallId: string, evidence: readonly AuditorCapabilityEvidence[], compactedSourceEvidence?: ExecutionCompactedSources): readonly AuditorEvidenceInventoryEntry[];
5
6
  export declare function fingerprintAuditorWork(params: Readonly<{
6
7
  requestId: string;
7
8
  callerCallId: string;
@@ -5,11 +5,16 @@ const INVENTORY_TARGET_PREVIEW_LIMIT = 2;
5
5
  export function projectAuditorWorkEvidence(head, callerCallId) {
6
6
  return Object.freeze(rootSettledExecutions(head, callerCallId).map(projectCapabilityEvidence));
7
7
  }
8
- export function projectAuditorEvidenceInventory(head, callerCallId, evidence) {
8
+ export function projectAuditorEvidenceInventory(head, callerCallId, evidence, compactedSourceEvidence) {
9
9
  const executions = rootSettledExecutions(head, callerCallId);
10
+ const compactedById = new Map(compactedSourceEvidence?.sources.map((source) => [
11
+ source.executionId,
12
+ source,
13
+ ]));
10
14
  return Object.freeze(evidence.map((entry, index) => {
11
15
  const execution = executions[index];
12
16
  const references = entry.references ?? [];
17
+ const compactedSource = compactedById.get(entry.executionId);
13
18
  return Object.freeze({
14
19
  executionId: entry.executionId,
15
20
  callId: execution.callId,
@@ -25,6 +30,12 @@ export function projectAuditorEvidenceInventory(head, callerCallId, evidence) {
25
30
  referenceCount: references.length,
26
31
  omittedReferencePreviewCount: Math.max(0, references.length - INVENTORY_TARGET_PREVIEW_LIMIT),
27
32
  exactEvidenceChars: JSON.stringify(projectAuditorEvidenceRepresentation(entry)).length,
33
+ ...(compactedSource
34
+ ? {
35
+ evidencePresentation: "compacted",
36
+ projectedEvidenceChars: JSON.stringify(projectAuditorEvidenceRepresentation(entry, compactedSource)).length,
37
+ }
38
+ : {}),
28
39
  evidenceFingerprint: fingerprintAuditorEvidence(entry),
29
40
  });
30
41
  }));
@@ -1,10 +1,16 @@
1
1
  import type { AuditorCapabilityEvidence } from "./contracts.js";
2
+ import type { ExecutionCompactedSource } from "../../context/execution-compacted-evidence.js";
2
3
  type SupplementField = "summary" | "referenceData" | "references";
3
4
  type AdapterPath = readonly (string | number)[];
4
5
  type RepresentedFields = Partial<Record<SupplementField, AdapterPath>>;
5
- export type AuditorEvidenceRepresentation = Readonly<Omit<AuditorCapabilityEvidence, SupplementField> & Partial<Pick<AuditorCapabilityEvidence, SupplementField>> & {
6
+ export type AuditorEvidenceRepresentation = Readonly<Omit<AuditorCapabilityEvidence, SupplementField | "adapterResult"> & Partial<Pick<AuditorCapabilityEvidence, SupplementField | "adapterResult">> & {
6
7
  representedFields?: Readonly<RepresentedFields>;
8
+ compactedSourceEvidence?: ExecutionCompactedSource & Readonly<{
9
+ kind: "runtime_compacted_source_evidence_v1";
10
+ authority: "passive_reference_only";
11
+ omissionMeaning: "summarized_detail_not_proven_absent";
12
+ }>;
7
13
  }>;
8
14
  /** Canonical records and their exact adapter envelopes are never rewritten. */
9
- export declare function projectAuditorEvidenceRepresentation(evidence: AuditorCapabilityEvidence): AuditorEvidenceRepresentation;
15
+ export declare function projectAuditorEvidenceRepresentation(evidence: AuditorCapabilityEvidence, compactedSource?: ExecutionCompactedSource): AuditorEvidenceRepresentation;
10
16
  export {};
@@ -1,5 +1,18 @@
1
+ import { projectCompactedCapabilityResultReceipt } from "../../context/compacted-capability-result-receipt.js";
1
2
  /** Canonical records and their exact adapter envelopes are never rewritten. */
2
- export function projectAuditorEvidenceRepresentation(evidence) {
3
+ export function projectAuditorEvidenceRepresentation(evidence, compactedSource) {
4
+ if (compactedSource?.executionId === evidence.executionId) {
5
+ const receipt = projectCompactedCapabilityResultReceipt(evidence);
6
+ return Object.freeze({
7
+ ...receipt,
8
+ compactedSourceEvidence: Object.freeze({
9
+ ...compactedSource,
10
+ kind: "runtime_compacted_source_evidence_v1",
11
+ authority: "passive_reference_only",
12
+ omissionMeaning: "summarized_detail_not_proven_absent",
13
+ }),
14
+ });
15
+ }
3
16
  const represented = {
4
17
  ...evidence,
5
18
  };
@@ -8,4 +8,6 @@ export declare function buildAuditorDecisionInput(request: RequestExecutionSeed,
8
8
  modelStep: typeof AUDITOR_DECISION_MODEL_STEP;
9
9
  assignment: AuditorAssignment;
10
10
  phase: "selection" | "review";
11
+ selectedEvidenceChars: number;
12
+ reusedCompactedSourceCount: number;
11
13
  }>;
@@ -8,6 +8,13 @@ import { createAuditorEvidenceSelectionFormat } from "./evidence-selection.js";
8
8
  import { buildAuditorDecisionInstructions } from "./prompt.js";
9
9
  import { projectAuditorEvidenceRepresentation } from "./evidence-representation.js";
10
10
  export function buildAuditorDecisionInput(request, assignment, phase = "review") {
11
+ const compactedById = new Map(assignment.compactedSourceEvidence?.sources.map((source) => [
12
+ source.executionId,
13
+ source,
14
+ ]));
15
+ const evidence = phase === "review"
16
+ ? assignment.evidence.map((entry) => projectAuditorEvidenceRepresentation(entry, compactedById.get(entry.executionId)))
17
+ : [];
11
18
  const format = phase === "selection"
12
19
  ? createAuditorEvidenceSelectionFormat(assignment)
13
20
  : createAuditorDecisionFormat(assignment);
@@ -58,7 +65,7 @@ export function buildAuditorDecisionInput(request, assignment, phase = "review")
58
65
  authority: "configured_model_context",
59
66
  retention: "exact",
60
67
  contextWindowTokens: budget.contextWindowTokens,
61
- evidenceSizeSemantics: "exactEvidenceChars measures the lossless model-visible representation; canonical fingerprints bind the unchanged original records. Runtime admits the complete review message under the configured context policy.",
68
+ evidenceSizeSemantics: "exactEvidenceChars measures the original representation. For evidencePresentation=compacted, projectedEvidenceChars measures the verified source summary and retained receipt that will be supplied instead. Canonical fingerprints bind the unchanged original records. Runtime admits the complete review message under the configured context policy without further compaction.",
62
69
  },
63
70
  previewSemantics: "Summary and target previews may be truncated; originalChars, truncated and omittedReferencePreviewCount declare that. Every work execution is indexed. Previews are not original proof.",
64
71
  }),
@@ -74,9 +81,9 @@ export function buildAuditorDecisionInput(request, assignment, phase = "review")
74
81
  auditId: assignment.auditId,
75
82
  workFingerprint: assignment.workFingerprint,
76
83
  selectedEvidenceIds: assignment.selectedEvidenceIds,
77
- evidence: assignment.evidence.map(projectAuditorEvidenceRepresentation),
84
+ evidence,
78
85
  evidenceProjection: projectAuditorEvidenceProjectionStatus(assignment),
79
- omissionSemantics: "Only whole explicitly selected canonical proof is admitted. adapterResult is unchanged. representedFields maps identical supplementary field values to exact paths under that same entry's adapterResult; all other supplements remain verbatim. No content is truncated or summarized. Pass requires complete inventory coverage and every needed ID in this current bundle. Previews and prior reviews are not proof.",
86
+ omissionSemantics: "Each selected entry contains its unchanged adapterResult or a verified existing compactedSourceEvidence summary of that same execution. Summaries may omit detail; omission does not establish absence. evidenceProjection.complete means all selected representations are present, not that summaries retain every original fact. representedFields maps identical supplements to exact paths in that entry's adapterResult; other supplements remain verbatim. Pass requires complete inventory classification and every needed ID in this current bundle with facts sufficient for the criteria. Previews and prior reviews are not proof.",
80
87
  }),
81
88
  },
82
89
  ]
@@ -108,5 +115,7 @@ export function buildAuditorDecisionInput(request, assignment, phase = "review")
108
115
  modelStep: AUDITOR_DECISION_MODEL_STEP,
109
116
  assignment,
110
117
  phase,
118
+ selectedEvidenceChars: evidence.reduce((total, entry) => total + JSON.stringify(entry).length, 0),
119
+ reusedCompactedSourceCount: evidence.filter((entry) => entry.compactedSourceEvidence).length,
111
120
  });
112
121
  }
@@ -1,3 +1,5 @@
1
+ import { projectExecutionCompactionObjective } from "../../context/execution-compaction-objective.js";
2
+ import { resolveExecutionCompactedSources } from "../../context/execution-compacted-evidence.js";
1
3
  import { projectRequestSteeringSnapshot } from "../../request/request-steering.js";
2
4
  import { traceDebug } from "../../observability/debug-logger.js";
3
5
  import { projectAuditorInputState } from "./audit-input-state.js";
@@ -12,8 +14,24 @@ export function projectAuditorAssignment(request, head, call) {
12
14
  const objective = parseExecutionAgentAuditObjective(call.objective);
13
15
  const steering = projectRequestSteeringSnapshot(request.requestSteering, objective.requestSteeringVersion);
14
16
  const evidence = projectAuditorWorkEvidence(head, caller.callId);
17
+ const compactedSourceEvidence = resolveExecutionCompactedSources({
18
+ requestId: request.requestId,
19
+ prompt: request.prompt,
20
+ objective: projectExecutionCompactionObjective(request.prompt, steering.updates),
21
+ callId: caller.callId,
22
+ store: request.contextCompactionStore,
23
+ results: head.state.capabilityExecutions
24
+ .filter((execution) => execution.callId === caller.callId && execution.status === "settled")
25
+ .map((execution) => ({
26
+ executionId: execution.executionId,
27
+ callId: execution.callId,
28
+ invocationAttempt: execution.invocationAttempt,
29
+ capabilityId: execution.capabilityId,
30
+ adapterResult: execution.exactResult,
31
+ })),
32
+ });
15
33
  const state = projectAuditorInputState(head, caller.callId, steering.version, objective.criterionIds, evidence);
16
- const inventory = projectAuditorEvidenceInventory(head, caller.callId, evidence);
34
+ const inventory = projectAuditorEvidenceInventory(head, caller.callId, evidence, compactedSourceEvidence);
17
35
  traceDebug("runtime.auditor", "assignment.created", {
18
36
  requestId: request.requestId,
19
37
  callId: call.callId,
@@ -49,6 +67,7 @@ export function projectAuditorAssignment(request, head, call) {
49
67
  reviewedEvidenceBundles: state.reviewedEvidenceBundles,
50
68
  selectedEvidenceIds: Object.freeze([]),
51
69
  evidence: Object.freeze([]),
70
+ ...(compactedSourceEvidence ? { compactedSourceEvidence } : {}),
52
71
  availableEvidenceCount: inventory.length,
53
72
  omittedEvidenceCount: 0,
54
73
  });