@abot-ai/runtime 1.5.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1260) hide show
  1. package/README.md +2 -0
  2. package/dist/src/bridge/request-steering.js +60 -15
  3. package/dist/src/bridge/start-agent-bridge.js +22 -0
  4. package/dist/src/capabilities/normal-invocation/contracts.d.ts +14 -0
  5. package/dist/src/capabilities/normal-invocation/contracts.js +1 -0
  6. package/dist/src/capabilities/normal-invocation/output-channels.d.ts +10 -0
  7. package/dist/src/capabilities/normal-invocation/output-channels.js +29 -0
  8. package/dist/src/capabilities/normal-invocation/validator.js +42 -4
  9. package/dist/src/capabilities/result-budget.d.ts +17 -0
  10. package/dist/src/capabilities/result-budget.js +21 -0
  11. package/dist/src/capabilities/tool-context-text.d.ts +16 -0
  12. package/dist/src/capabilities/tool-context-text.js +30 -0
  13. package/dist/src/capabilities/tool-definition-validator/definition-parser.js +6 -0
  14. package/dist/src/capabilities/tool-definition-validator/event-input-text-options.js +3 -2
  15. package/dist/src/capabilities/tool-event-input-text.d.ts +1 -0
  16. package/dist/src/capabilities/tool-event-input-text.js +2 -1
  17. package/dist/src/capabilities/tool-executor.d.ts +3 -1
  18. package/dist/src/capabilities/tool-executor.js +29 -50
  19. package/dist/src/capabilities/tool-interruption.d.ts +3 -0
  20. package/dist/src/capabilities/tool-interruption.js +6 -0
  21. package/dist/src/capabilities/tool-result-normalization.d.ts +18 -0
  22. package/dist/src/capabilities/tool-result-normalization.js +68 -0
  23. package/dist/src/capabilities/tool-types.d.ts +25 -2
  24. package/dist/src/cli/host-companion-bundle.mjs +7623 -6572
  25. package/dist/src/cli/host-companion-entry.js +5 -22
  26. package/dist/src/cli/host-companion-input.d.ts +3 -0
  27. package/dist/src/cli/host-companion-input.js +21 -0
  28. package/dist/src/cli/host-companion-lifecycle.d.ts +11 -0
  29. package/dist/src/cli/host-companion-lifecycle.js +32 -0
  30. package/dist/src/cli/host-companion-setup-target.d.ts +4 -0
  31. package/dist/src/cli/host-companion-setup-target.js +17 -0
  32. package/dist/src/cli/host-companion-startup.d.ts +2 -0
  33. package/dist/src/cli/host-companion-startup.js +7 -2
  34. package/dist/src/cli/host-companion.d.ts +6 -0
  35. package/dist/src/cli/host-companion.js +36 -27
  36. package/dist/src/cli/host-permissions.d.ts +7 -0
  37. package/dist/src/cli/host-permissions.js +24 -0
  38. package/dist/src/cli/windows-companion-store-entry.d.ts +9 -0
  39. package/dist/src/cli/windows-companion-store-entry.js +67 -0
  40. package/dist/src/computer-access/command-output-capture.d.ts +37 -0
  41. package/dist/src/computer-access/command-output-capture.js +136 -0
  42. package/dist/src/computer-access/command-output-retention.d.ts +5 -0
  43. package/dist/src/computer-access/command-output-retention.js +90 -0
  44. package/dist/src/computer-access/command-output.d.ts +7 -0
  45. package/dist/src/computer-access/command-output.js +1 -0
  46. package/dist/src/computer-access/commands.d.ts +1 -0
  47. package/dist/src/computer-access/commands.js +1 -1
  48. package/dist/src/computer-access/companion/command-output-protocol.d.ts +12 -0
  49. package/dist/src/computer-access/companion/command-output-protocol.js +28 -0
  50. package/dist/src/computer-access/companion/command-output.d.ts +13 -0
  51. package/dist/src/computer-access/companion/command-output.js +110 -0
  52. package/dist/src/computer-access/companion/install-link-macos.d.ts +7 -0
  53. package/dist/src/computer-access/companion/install-link-macos.js +48 -0
  54. package/dist/src/computer-access/companion/install-link-registration.d.ts +4 -0
  55. package/dist/src/computer-access/companion/install-link-registration.js +184 -0
  56. package/dist/src/computer-access/companion/install-link-windows.d.ts +4 -0
  57. package/dist/src/computer-access/companion/install-link-windows.js +65 -0
  58. package/dist/src/computer-access/companion/install-link.d.ts +9 -0
  59. package/dist/src/computer-access/companion/install-link.js +54 -0
  60. package/dist/src/computer-access/companion/native-messages.js +4 -0
  61. package/dist/src/computer-access/companion/native-permissions.d.ts +14 -0
  62. package/dist/src/computer-access/companion/native-permissions.js +49 -0
  63. package/dist/src/computer-access/companion/native-session.d.ts +1 -0
  64. package/dist/src/computer-access/companion/native-session.js +18 -2
  65. package/dist/src/computer-access/companion/native-supervisor.js +1 -0
  66. package/dist/src/computer-access/companion/notification-installation.js +2 -15
  67. package/dist/src/computer-access/companion/notification-macos-bundle.d.ts +3 -0
  68. package/dist/src/computer-access/companion/notification-macos-bundle.js +84 -0
  69. package/dist/src/computer-access/companion/notification-macos.js +1 -1
  70. package/dist/src/computer-access/companion/notification-protocol.d.ts +1 -1
  71. package/dist/src/computer-access/companion/notification-protocol.js +20 -1
  72. package/dist/src/computer-access/companion/notification-readiness.js +2 -1
  73. package/dist/src/computer-access/companion/notification-windows.d.ts +1 -1
  74. package/dist/src/computer-access/companion/notification-windows.js +8 -3
  75. package/dist/src/computer-access/companion/permission-protocol.d.ts +22 -0
  76. package/dist/src/computer-access/companion/permission-protocol.js +45 -0
  77. package/dist/src/computer-access/companion/protocol.d.ts +2 -1
  78. package/dist/src/computer-access/companion/protocol.js +9 -0
  79. package/dist/src/computer-access/companion/release-version.d.ts +1 -1
  80. package/dist/src/computer-access/companion/release-version.js +1 -1
  81. package/dist/src/computer-access/companion/spark-notification-query.d.ts +2 -0
  82. package/dist/src/computer-access/companion/spark-notification-query.js +62 -0
  83. package/dist/src/computer-access/companion/windows-store/connection-error.d.ts +7 -0
  84. package/dist/src/computer-access/companion/windows-store/connection-error.js +19 -0
  85. package/dist/src/computer-access/companion/windows-store/connection-link.d.ts +13 -0
  86. package/dist/src/computer-access/companion/windows-store/connection-link.js +109 -0
  87. package/dist/src/computer-access/companion/windows-store/identity.d.ts +13 -0
  88. package/dist/src/computer-access/companion/windows-store/identity.js +13 -0
  89. package/dist/src/computer-access/companion/windows-store/lifecycle.d.ts +5 -0
  90. package/dist/src/computer-access/companion/windows-store/lifecycle.js +90 -0
  91. package/dist/src/computer-access/computer/macos-desktop.js +1 -1
  92. package/dist/src/computer-access/computer/macos-input.js +2 -5
  93. package/dist/src/computer-access/computer/macos-permission-helper.d.ts +4 -0
  94. package/dist/src/computer-access/computer/macos-permission-helper.js +38 -0
  95. package/dist/src/computer-access/contracts.d.ts +1 -1
  96. package/dist/src/computer-access/handlers.d.ts +2 -1
  97. package/dist/src/computer-access/handlers.js +5 -1
  98. package/dist/src/computer-access/host-observation.d.ts +3 -3
  99. package/dist/src/computer-access/native-permission-contract.d.ts +23 -0
  100. package/dist/src/computer-access/native-permission-contract.js +38 -0
  101. package/dist/src/computer-access/process-capture.d.ts +6 -0
  102. package/dist/src/computer-access/process-capture.js +1 -0
  103. package/dist/src/computer-access/process-result.d.ts +2 -0
  104. package/dist/src/computer-access/process-result.js +14 -6
  105. package/dist/src/computer-access/process-runner.d.ts +2 -1
  106. package/dist/src/computer-access/process-runner.js +21 -13
  107. package/dist/src/model-gateway/policy/invocation-policy.js +10 -1
  108. package/dist/src/model-gateway/providers/openai/payload.js +8 -0
  109. package/dist/src/model-gateway/server/configuration.d.ts +2 -0
  110. package/dist/src/model-gateway/server/configuration.js +73 -21
  111. package/dist/src/model-gateway/structured-output/ollama-format.js +5 -0
  112. package/dist/src/model-gateway/structured-output/openai-format.js +5 -0
  113. package/dist/src/model-gateway/types.d.ts +3 -0
  114. package/dist/src/plugin-contract/install-source.d.ts +13 -0
  115. package/dist/src/plugin-contract/install-source.js +99 -0
  116. package/dist/src/plugin-contract/manifest.d.ts +3 -1
  117. package/dist/src/plugin-sdk/computer-access.d.ts +8 -0
  118. package/dist/src/plugin-sdk/computer-access.js +5 -0
  119. package/dist/src/plugin-sdk/context-text-result.d.ts +10 -0
  120. package/dist/src/plugin-sdk/context-text-result.js +19 -0
  121. package/dist/src/plugin-sdk/index.d.ts +1 -0
  122. package/dist/src/plugin-sdk/index.js +1 -0
  123. package/dist/src/plugin-sdk/results.d.ts +7 -4
  124. package/dist/src/plugin-sdk/results.js +35 -10
  125. package/dist/src/runtime/adapters/co-worker-resources.d.ts +2 -0
  126. package/dist/src/runtime/adapters/co-worker-resources.js +2 -2
  127. package/dist/src/runtime/adapters/file-session-store.js +6 -0
  128. package/dist/src/runtime/adapters/in-memory-session-store.js +19 -16
  129. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.d.ts +2 -1
  130. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.js +5 -4
  131. package/dist/src/runtime/adapters/passive-learning-runtime.d.ts +2 -1
  132. package/dist/src/runtime/adapters/passive-learning-runtime.js +1 -1
  133. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/prepared-execution.js +77 -26
  134. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/result-budget.d.ts +11 -0
  135. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/result-budget.js +30 -0
  136. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +28 -1
  137. package/dist/src/runtime/adapters/registered-tool-payload-plan.d.ts +3 -3
  138. package/dist/src/runtime/adapters/registered-tool-payload-plan.js +4 -4
  139. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/contracts.d.ts +2 -0
  140. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-authoring-result.js +4 -18
  141. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/prepared-execution.js +3 -3
  142. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-envelope.d.ts +13 -0
  143. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-envelope.js +15 -0
  144. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-evidence.d.ts +3 -7
  145. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-evidence.js +6 -38
  146. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.d.ts +2 -1
  147. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.js +14 -6
  148. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-references.d.ts +9 -0
  149. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-references.js +29 -0
  150. package/dist/src/runtime/adapters/registered-tool-worker-capabilities.js +1 -0
  151. package/dist/src/runtime/adapters/scheduler-executor-dispatch.d.ts +11 -0
  152. package/dist/src/runtime/adapters/scheduler-executor-dispatch.js +10 -0
  153. package/dist/src/runtime/adapters/scheduler-runtime.d.ts +3 -1
  154. package/dist/src/runtime/adapters/scheduler-runtime.js +28 -12
  155. package/dist/src/runtime/admin/config-control.js +2 -1
  156. package/dist/src/runtime/automations/agent-assignment.d.ts +8 -0
  157. package/dist/src/runtime/automations/agent-assignment.js +29 -0
  158. package/dist/src/runtime/automations/agent-request-failure.d.ts +2 -0
  159. package/dist/src/runtime/automations/agent-request-failure.js +74 -0
  160. package/dist/src/runtime/automations/agent-session-lifetime.d.ts +11 -0
  161. package/dist/src/runtime/automations/agent-session-lifetime.js +46 -0
  162. package/dist/src/runtime/automations/agent-step-executor.d.ts +35 -0
  163. package/dist/src/runtime/automations/agent-step-executor.js +278 -0
  164. package/dist/src/runtime/automations/agent-tool-scope.d.ts +4 -0
  165. package/dist/src/runtime/automations/agent-tool-scope.js +73 -0
  166. package/dist/src/runtime/automations/archive-management.d.ts +26 -0
  167. package/dist/src/runtime/automations/archive-management.js +50 -0
  168. package/dist/src/runtime/automations/binding-resolution.d.ts +28 -0
  169. package/dist/src/runtime/automations/binding-resolution.js +115 -0
  170. package/dist/src/runtime/automations/branch-result-projection.d.ts +4 -0
  171. package/dist/src/runtime/automations/branch-result-projection.js +15 -0
  172. package/dist/src/runtime/automations/catalog.d.ts +79 -0
  173. package/dist/src/runtime/automations/catalog.js +68 -0
  174. package/dist/src/runtime/automations/definition-contracts.d.ts +128 -0
  175. package/dist/src/runtime/automations/definition-contracts.js +1 -0
  176. package/dist/src/runtime/automations/definition-input.d.ts +3 -0
  177. package/dist/src/runtime/automations/definition-input.js +283 -0
  178. package/dist/src/runtime/automations/dependency-fingerprint.d.ts +9 -0
  179. package/dist/src/runtime/automations/dependency-fingerprint.js +55 -0
  180. package/dist/src/runtime/automations/draft-batch-aliases.d.ts +12 -0
  181. package/dist/src/runtime/automations/draft-batch-aliases.js +94 -0
  182. package/dist/src/runtime/automations/draft-batch.d.ts +29 -0
  183. package/dist/src/runtime/automations/draft-batch.js +147 -0
  184. package/dist/src/runtime/automations/draft-management.d.ts +53 -0
  185. package/dist/src/runtime/automations/draft-management.js +164 -0
  186. package/dist/src/runtime/automations/draft-mutations.d.ts +29 -0
  187. package/dist/src/runtime/automations/draft-mutations.js +219 -0
  188. package/dist/src/runtime/automations/draft-restoration.d.ts +11 -0
  189. package/dist/src/runtime/automations/draft-restoration.js +44 -0
  190. package/dist/src/runtime/automations/effect-admission-lifetime.d.ts +9 -0
  191. package/dist/src/runtime/automations/effect-admission-lifetime.js +31 -0
  192. package/dist/src/runtime/automations/failure-policy.d.ts +8 -0
  193. package/dist/src/runtime/automations/failure-policy.js +9 -0
  194. package/dist/src/runtime/automations/graph-executor.d.ts +23 -0
  195. package/dist/src/runtime/automations/graph-executor.js +227 -0
  196. package/dist/src/runtime/automations/graph-validation.d.ts +29 -0
  197. package/dist/src/runtime/automations/graph-validation.js +271 -0
  198. package/dist/src/runtime/automations/input-batch-selection.d.ts +7 -0
  199. package/dist/src/runtime/automations/input-batch-selection.js +42 -0
  200. package/dist/src/runtime/automations/input-capacity.d.ts +9 -0
  201. package/dist/src/runtime/automations/input-capacity.js +38 -0
  202. package/dist/src/runtime/automations/input-ledger.d.ts +45 -0
  203. package/dist/src/runtime/automations/input-ledger.js +147 -0
  204. package/dist/src/runtime/automations/late-settlement.d.ts +9 -0
  205. package/dist/src/runtime/automations/late-settlement.js +42 -0
  206. package/dist/src/runtime/automations/limits.d.ts +25 -0
  207. package/dist/src/runtime/automations/limits.js +41 -0
  208. package/dist/src/runtime/automations/model-capacity.d.ts +9 -0
  209. package/dist/src/runtime/automations/model-capacity.js +67 -0
  210. package/dist/src/runtime/automations/model-dependency-projection.d.ts +58 -0
  211. package/dist/src/runtime/automations/model-dependency-projection.js +88 -0
  212. package/dist/src/runtime/automations/node-transactions.d.ts +57 -0
  213. package/dist/src/runtime/automations/node-transactions.js +223 -0
  214. package/dist/src/runtime/automations/occurrence-preparation.d.ts +12 -0
  215. package/dist/src/runtime/automations/occurrence-preparation.js +257 -0
  216. package/dist/src/runtime/automations/permission-grants.d.ts +27 -0
  217. package/dist/src/runtime/automations/permission-grants.js +72 -0
  218. package/dist/src/runtime/automations/persistence.d.ts +9 -0
  219. package/dist/src/runtime/automations/persistence.js +13 -0
  220. package/dist/src/runtime/automations/publication-validation.d.ts +16 -0
  221. package/dist/src/runtime/automations/publication-validation.js +162 -0
  222. package/dist/src/runtime/automations/publication.d.ts +33 -0
  223. package/dist/src/runtime/automations/publication.js +97 -0
  224. package/dist/src/runtime/automations/replay-preparation.d.ts +7 -0
  225. package/dist/src/runtime/automations/replay-preparation.js +59 -0
  226. package/dist/src/runtime/automations/result-capacity.d.ts +5 -0
  227. package/dist/src/runtime/automations/result-capacity.js +9 -0
  228. package/dist/src/runtime/automations/result-publication.d.ts +10 -0
  229. package/dist/src/runtime/automations/result-publication.js +21 -0
  230. package/dist/src/runtime/automations/result-store.d.ts +17 -0
  231. package/dist/src/runtime/automations/result-store.js +109 -0
  232. package/dist/src/runtime/automations/retention.d.ts +12 -0
  233. package/dist/src/runtime/automations/retention.js +134 -0
  234. package/dist/src/runtime/automations/run-file-binding.d.ts +3 -0
  235. package/dist/src/runtime/automations/run-file-binding.js +19 -0
  236. package/dist/src/runtime/automations/run-output-summary.d.ts +25 -0
  237. package/dist/src/runtime/automations/run-output-summary.js +54 -0
  238. package/dist/src/runtime/automations/run-report.d.ts +83 -0
  239. package/dist/src/runtime/automations/run-report.js +121 -0
  240. package/dist/src/runtime/automations/runtime-executor.d.ts +16 -0
  241. package/dist/src/runtime/automations/runtime-executor.js +260 -0
  242. package/dist/src/runtime/automations/saved-agent-management.d.ts +16 -0
  243. package/dist/src/runtime/automations/saved-agent-management.js +94 -0
  244. package/dist/src/runtime/automations/service.d.ts +288 -0
  245. package/dist/src/runtime/automations/service.js +330 -0
  246. package/dist/src/runtime/automations/snapshot-staging.d.ts +13 -0
  247. package/dist/src/runtime/automations/snapshot-staging.js +126 -0
  248. package/dist/src/runtime/automations/source-attachment-access.d.ts +23 -0
  249. package/dist/src/runtime/automations/source-attachment-access.js +70 -0
  250. package/dist/src/runtime/automations/source-discovery.d.ts +25 -0
  251. package/dist/src/runtime/automations/source-discovery.js +179 -0
  252. package/dist/src/runtime/automations/starter-template-builder.d.ts +5 -0
  253. package/dist/src/runtime/automations/starter-template-builder.js +78 -0
  254. package/dist/src/runtime/automations/starter-template-contracts.d.ts +42 -0
  255. package/dist/src/runtime/automations/starter-template-contracts.js +1 -0
  256. package/dist/src/runtime/automations/starter-template-definitions.d.ts +3 -0
  257. package/dist/src/runtime/automations/starter-template-definitions.js +100 -0
  258. package/dist/src/runtime/automations/starter-template-showcases.d.ts +3 -0
  259. package/dist/src/runtime/automations/starter-template-showcases.js +154 -0
  260. package/dist/src/runtime/automations/starter-template-structure.d.ts +4 -0
  261. package/dist/src/runtime/automations/starter-template-structure.js +11 -0
  262. package/dist/src/runtime/automations/starter-templates.d.ts +20 -0
  263. package/dist/src/runtime/automations/starter-templates.js +75 -0
  264. package/dist/src/runtime/automations/step-evidence-effects.d.ts +46 -0
  265. package/dist/src/runtime/automations/step-evidence-effects.js +173 -0
  266. package/dist/src/runtime/automations/step-evidence-inputs.d.ts +22 -0
  267. package/dist/src/runtime/automations/step-evidence-inputs.js +105 -0
  268. package/dist/src/runtime/automations/step-evidence-output.d.ts +17 -0
  269. package/dist/src/runtime/automations/step-evidence-output.js +43 -0
  270. package/dist/src/runtime/automations/step-evidence.d.ts +24 -0
  271. package/dist/src/runtime/automations/step-evidence.js +53 -0
  272. package/dist/src/runtime/automations/step-interruption.d.ts +3 -0
  273. package/dist/src/runtime/automations/step-interruption.js +26 -0
  274. package/dist/src/runtime/automations/step-runner.d.ts +57 -0
  275. package/dist/src/runtime/automations/step-runner.js +278 -0
  276. package/dist/src/runtime/automations/storage-records.d.ts +133 -0
  277. package/dist/src/runtime/automations/storage-records.js +286 -0
  278. package/dist/src/runtime/automations/terminal-admission-receipt.d.ts +12 -0
  279. package/dist/src/runtime/automations/terminal-admission-receipt.js +39 -0
  280. package/dist/src/runtime/automations/tool-lifetimes.d.ts +13 -0
  281. package/dist/src/runtime/automations/tool-lifetimes.js +56 -0
  282. package/dist/src/runtime/automations/tool-step-executor.d.ts +32 -0
  283. package/dist/src/runtime/automations/tool-step-executor.js +136 -0
  284. package/dist/src/runtime/automations/tool-step-outcome.d.ts +24 -0
  285. package/dist/src/runtime/automations/tool-step-outcome.js +32 -0
  286. package/dist/src/runtime/automations/trigger-schedule.d.ts +7 -0
  287. package/dist/src/runtime/automations/trigger-schedule.js +19 -0
  288. package/dist/src/runtime/automations/working-directory.d.ts +3 -0
  289. package/dist/src/runtime/automations/working-directory.js +13 -0
  290. package/dist/src/runtime/capabilities/automation-builder/authoring-reference.d.ts +427 -0
  291. package/dist/src/runtime/capabilities/automation-builder/authoring-reference.js +131 -0
  292. package/dist/src/runtime/capabilities/automation-builder/creation-recipe.d.ts +9 -0
  293. package/dist/src/runtime/capabilities/automation-builder/creation-recipe.js +155 -0
  294. package/dist/src/runtime/capabilities/automation-builder/payload-instructions.d.ts +6 -0
  295. package/dist/src/runtime/capabilities/automation-builder/payload-instructions.js +6 -0
  296. package/dist/src/runtime/capabilities/automation-builder/payload-schema.d.ts +3 -0
  297. package/dist/src/runtime/capabilities/automation-builder/payload-schema.js +105 -0
  298. package/dist/src/runtime/capabilities/automation-builder/tool-contract.d.ts +65 -0
  299. package/dist/src/runtime/capabilities/automation-builder/tool-contract.js +27 -0
  300. package/dist/src/runtime/capabilities/automation-builder/tool-module.d.ts +4 -0
  301. package/dist/src/runtime/capabilities/automation-builder/tool-module.js +108 -0
  302. package/dist/src/runtime/capabilities/automations/authoring-catalog-contract.d.ts +78 -0
  303. package/dist/src/runtime/capabilities/automations/authoring-catalog-contract.js +28 -0
  304. package/dist/src/runtime/capabilities/automations/authoring-catalog.d.ts +320 -0
  305. package/dist/src/runtime/capabilities/automations/authoring-catalog.js +158 -0
  306. package/dist/src/runtime/capabilities/automations/authoring-input-contracts.d.ts +140 -0
  307. package/dist/src/runtime/capabilities/automations/authoring-input-contracts.js +36 -0
  308. package/dist/src/runtime/capabilities/automations/authoring-inputs.d.ts +9 -0
  309. package/dist/src/runtime/capabilities/automations/authoring-inputs.js +86 -0
  310. package/dist/src/runtime/capabilities/automations/authoring-preparation-limits.d.ts +5 -0
  311. package/dist/src/runtime/capabilities/automations/authoring-preparation-limits.js +5 -0
  312. package/dist/src/runtime/capabilities/automations/authoring-preparation.d.ts +489 -0
  313. package/dist/src/runtime/capabilities/automations/authoring-preparation.js +51 -0
  314. package/dist/src/runtime/capabilities/automations/draft-index.d.ts +14 -0
  315. package/dist/src/runtime/capabilities/automations/draft-index.js +26 -0
  316. package/dist/src/runtime/capabilities/automations/draft-operation-refs.d.ts +11 -0
  317. package/dist/src/runtime/capabilities/automations/draft-operation-refs.js +37 -0
  318. package/dist/src/runtime/capabilities/automations/draft-receipt-admission.d.ts +24 -0
  319. package/dist/src/runtime/capabilities/automations/draft-receipt-admission.js +36 -0
  320. package/dist/src/runtime/capabilities/automations/event-presentation.d.ts +3 -0
  321. package/dist/src/runtime/capabilities/automations/event-presentation.js +18 -0
  322. package/dist/src/runtime/capabilities/automations/model-tool-contract.d.ts +3 -0
  323. package/dist/src/runtime/capabilities/automations/model-tool-contract.js +34 -0
  324. package/dist/src/runtime/capabilities/automations/tool-contract.d.ts +3 -0
  325. package/dist/src/runtime/capabilities/automations/tool-contract.js +65 -0
  326. package/dist/src/runtime/capabilities/automations/tool-module.d.ts +4 -0
  327. package/dist/src/runtime/capabilities/automations/tool-module.js +286 -0
  328. package/dist/src/runtime/capabilities/request-permission-catalog.d.ts +3 -1
  329. package/dist/src/runtime/capabilities/request-permission-catalog.js +21 -2
  330. package/dist/src/runtime/capabilities/request-permission-tool-registry.d.ts +2 -1
  331. package/dist/src/runtime/capabilities/request-permission-tool-registry.js +18 -10
  332. package/dist/src/runtime/capabilities/request-runtime-tool-registry.d.ts +2 -0
  333. package/dist/src/runtime/capabilities/request-runtime-tool-registry.js +1 -1
  334. package/dist/src/runtime/capabilities/runtime-path-namespace.d.ts +6 -0
  335. package/dist/src/runtime/capabilities/runtime-path-namespace.js +48 -0
  336. package/dist/src/runtime/capabilities/runtime-target-path.d.ts +1 -0
  337. package/dist/src/runtime/capabilities/runtime-target-path.js +16 -8
  338. package/dist/src/runtime/capabilities/scheduling/create-operations.d.ts +12 -0
  339. package/dist/src/runtime/capabilities/scheduling/job-list-page.d.ts +4 -1
  340. package/dist/src/runtime/composition.d.ts +5 -2
  341. package/dist/src/runtime/config/builders.js +6 -5
  342. package/dist/src/runtime/config/effective-model-config-validation.js +4 -35
  343. package/dist/src/runtime/config/fields.js +15 -0
  344. package/dist/src/runtime/config/model-context-capacity.d.ts +20 -0
  345. package/dist/src/runtime/config/model-context-capacity.js +55 -0
  346. package/dist/src/runtime/config/model-execution-policy.d.ts +5 -1
  347. package/dist/src/runtime/config/model-execution-policy.js +16 -0
  348. package/dist/src/runtime/config/model-plugin-config.d.ts +8 -0
  349. package/dist/src/runtime/config/model-plugin-config.js +40 -0
  350. package/dist/src/runtime/config/schema.js +5 -1
  351. package/dist/src/runtime/config/validation/model-profile-validation.js +2 -0
  352. package/dist/src/runtime/config/validation/runtime-config-validation-contract.d.ts +3 -1
  353. package/dist/src/runtime/config/validation/runtime-config-validation-contract.js +3 -1
  354. package/dist/src/runtime/config/validation/runtime-root-section-validation.js +11 -4
  355. package/dist/src/runtime/config/validation/web-ui-config-validation.js +3 -2
  356. package/dist/src/runtime/config/web-ui.d.ts +5 -0
  357. package/dist/src/runtime/config/web-ui.js +5 -0
  358. package/dist/src/runtime/config.js +2 -0
  359. package/dist/src/runtime/context/canonical-capability-result.d.ts +4 -0
  360. package/dist/src/runtime/context/canonical-capability-result.js +80 -0
  361. package/dist/src/runtime/context/capability-brief-readmission.js +2 -5
  362. package/dist/src/runtime/context/capability-result-compaction-source.d.ts +12 -0
  363. package/dist/src/runtime/context/capability-result-compaction-source.js +61 -0
  364. package/dist/src/runtime/context/compacted-capability-result-receipt.d.ts +7 -0
  365. package/dist/src/runtime/context/compacted-capability-result-receipt.js +29 -0
  366. package/dist/src/runtime/context/compaction-source-invariant.d.ts +6 -0
  367. package/dist/src/runtime/context/compaction-source-invariant.js +12 -0
  368. package/dist/src/runtime/context/execution-compacted-evidence.d.ts +29 -0
  369. package/dist/src/runtime/context/execution-compacted-evidence.js +87 -0
  370. package/dist/src/runtime/context/execution-compaction-objective.d.ts +11 -0
  371. package/dist/src/runtime/context/execution-compaction-objective.js +12 -0
  372. package/dist/src/runtime/context/model-step-compaction.d.ts +9 -0
  373. package/dist/src/runtime/context/model-step-compaction.js +115 -128
  374. package/dist/src/runtime/context/operation-supervision-compacted-evidence.d.ts +37 -0
  375. package/dist/src/runtime/context/operation-supervision-compacted-evidence.js +69 -0
  376. package/dist/src/runtime/context/operation-supervision-evidence-binding.d.ts +29 -0
  377. package/dist/src/runtime/context/operation-supervision-evidence-binding.js +66 -0
  378. package/dist/src/runtime/context/operation-supervision-evidence-projection.d.ts +5 -0
  379. package/dist/src/runtime/context/operation-supervision-evidence-projection.js +133 -0
  380. package/dist/src/runtime/context/operation-supervision-evidence.d.ts +2 -1
  381. package/dist/src/runtime/context/operation-supervision-evidence.js +38 -37
  382. package/dist/src/runtime/context/request-tool-results-checkpoint.d.ts +3 -0
  383. package/dist/src/runtime/context/request-tool-results-checkpoint.js +126 -0
  384. package/dist/src/runtime/context/request-tool-results-message-binding.d.ts +1 -0
  385. package/dist/src/runtime/context/request-tool-results-message-binding.js +10 -0
  386. package/dist/src/runtime/context/request-tool-results-supersession.d.ts +9 -0
  387. package/dist/src/runtime/context/request-tool-results-supersession.js +78 -0
  388. package/dist/src/runtime/context/request-tool-results.d.ts +3 -9
  389. package/dist/src/runtime/context/request-tool-results.js +15 -181
  390. package/dist/src/runtime/context/runtime-filesystem-scope.d.ts +21 -0
  391. package/dist/src/runtime/context/runtime-filesystem-scope.js +51 -0
  392. package/dist/src/runtime/context/semantic-compaction/checkpoint-message.d.ts +3 -0
  393. package/dist/src/runtime/context/semantic-compaction/checkpoint-message.js +22 -0
  394. package/dist/src/runtime/context/semantic-compaction/contracts.d.ts +0 -3
  395. package/dist/src/runtime/context/semantic-compaction/contracts.js +9 -20
  396. package/dist/src/runtime/context/semantic-compaction/dependency-results.js +15 -1
  397. package/dist/src/runtime/context/semantic-compaction/evidence-scope.d.ts +7 -0
  398. package/dist/src/runtime/context/semantic-compaction/evidence-scope.js +7 -0
  399. package/dist/src/runtime/context/semantic-compaction/format.d.ts +2 -1
  400. package/dist/src/runtime/context/semantic-compaction/format.js +27 -19
  401. package/dist/src/runtime/context/semantic-compaction/generation-contracts.d.ts +18 -0
  402. package/dist/src/runtime/context/semantic-compaction/generation-contracts.js +1 -0
  403. package/dist/src/runtime/context/semantic-compaction/generation-input.d.ts +11 -0
  404. package/dist/src/runtime/context/semantic-compaction/generation-input.js +74 -0
  405. package/dist/src/runtime/context/semantic-compaction/generation-source-registration.d.ts +3 -0
  406. package/dist/src/runtime/context/semantic-compaction/generation-source-registration.js +12 -0
  407. package/dist/src/runtime/context/semantic-compaction/output-validation.d.ts +10 -0
  408. package/dist/src/runtime/context/semantic-compaction/output-validation.js +75 -0
  409. package/dist/src/runtime/context/semantic-compaction/parser.d.ts +2 -2
  410. package/dist/src/runtime/context/semantic-compaction/parser.js +13 -26
  411. package/dist/src/runtime/context/semantic-compaction/prompt.js +18 -5
  412. package/dist/src/runtime/context/semantic-compaction/repair-headroom.d.ts +4 -3
  413. package/dist/src/runtime/context/semantic-compaction/repair-headroom.js +10 -4
  414. package/dist/src/runtime/context/semantic-compaction/replacement-budget.d.ts +25 -0
  415. package/dist/src/runtime/context/semantic-compaction/replacement-budget.js +55 -0
  416. package/dist/src/runtime/context/semantic-compaction/run.d.ts +3 -14
  417. package/dist/src/runtime/context/semantic-compaction/run.js +27 -186
  418. package/dist/src/runtime/context/semantic-compaction/scope-quarantine.d.ts +17 -0
  419. package/dist/src/runtime/context/semantic-compaction/scope-quarantine.js +37 -0
  420. package/dist/src/runtime/context/semantic-compaction/snapshot.d.ts +5 -1
  421. package/dist/src/runtime/context/semantic-compaction/snapshot.js +10 -2
  422. package/dist/src/runtime/context/semantic-compaction/source-registration.d.ts +3 -0
  423. package/dist/src/runtime/context/semantic-compaction/source-registration.js +34 -0
  424. package/dist/src/runtime/context/semantic-compaction/source-slots.d.ts +5 -0
  425. package/dist/src/runtime/context/semantic-compaction/source-slots.js +4 -0
  426. package/dist/src/runtime/context/semantic-compaction/store.d.ts +6 -1
  427. package/dist/src/runtime/context/semantic-compaction/store.js +54 -9
  428. package/dist/src/runtime/context/semantic-compaction/super-child-result-source.d.ts +8 -0
  429. package/dist/src/runtime/context/semantic-compaction/super-child-result-source.js +50 -0
  430. package/dist/src/runtime/context/semantic-compaction/super-operation-source.d.ts +8 -0
  431. package/dist/src/runtime/context/semantic-compaction/super-operation-source.js +99 -0
  432. package/dist/src/runtime/context/semantic-compaction/super-reviewer-source.d.ts +16 -0
  433. package/dist/src/runtime/context/semantic-compaction/super-reviewer-source.js +37 -0
  434. package/dist/src/runtime/context/semantic-compaction/super-source-integrity.d.ts +21 -0
  435. package/dist/src/runtime/context/semantic-compaction/super-source-integrity.js +169 -0
  436. package/dist/src/runtime/context/semantic-compaction/super-source-message.d.ts +4 -0
  437. package/dist/src/runtime/context/semantic-compaction/super-source-message.js +23 -0
  438. package/dist/src/runtime/context/session-memory/model-step-controller.js +34 -20
  439. package/dist/src/runtime/context/session-memory/selection.js +0 -2
  440. package/dist/src/runtime/context/spark-conversation-policy.d.ts +4 -0
  441. package/dist/src/runtime/context/spark-conversation-policy.js +16 -0
  442. package/dist/src/runtime/context/super-compaction-failure-owner.d.ts +10 -0
  443. package/dist/src/runtime/context/super-compaction-failure-owner.js +64 -0
  444. package/dist/src/runtime/context/super-context-failure.d.ts +28 -0
  445. package/dist/src/runtime/context/super-context-failure.js +37 -0
  446. package/dist/src/runtime/context/super-context-policy.d.ts +3 -0
  447. package/dist/src/runtime/context/super-context-policy.js +35 -0
  448. package/dist/src/runtime/context/super-request-tool-results-checkpoint.d.ts +6 -0
  449. package/dist/src/runtime/context/super-request-tool-results-checkpoint.js +29 -0
  450. package/dist/src/runtime/context/super-worker-compaction-failure.d.ts +5 -0
  451. package/dist/src/runtime/context/super-worker-compaction-failure.js +19 -0
  452. package/dist/src/runtime/context/super-worker-compaction-projection.d.ts +8 -0
  453. package/dist/src/runtime/context/super-worker-compaction-projection.js +41 -0
  454. package/dist/src/runtime/context/super-worker-compaction-sidecar.d.ts +21 -0
  455. package/dist/src/runtime/context/super-worker-compaction-sidecar.js +67 -0
  456. package/dist/src/runtime/context/verified-compaction-projection.d.ts +7 -0
  457. package/dist/src/runtime/context/verified-compaction-projection.js +16 -0
  458. package/dist/src/runtime/default-environment-adapters.d.ts +4 -0
  459. package/dist/src/runtime/default-environment-adapters.js +7 -1
  460. package/dist/src/runtime/local-application.d.ts +279 -0
  461. package/dist/src/runtime/local-application.js +7 -0
  462. package/dist/src/runtime/local-host/app-learning-dispatch.js +0 -8
  463. package/dist/src/runtime/local-host/app-native-permissions.d.ts +20 -0
  464. package/dist/src/runtime/local-host/app-native-permissions.js +76 -0
  465. package/dist/src/runtime/local-host/app-owner.js +59 -4
  466. package/dist/src/runtime/local-host/app-request-control.d.ts +4 -1
  467. package/dist/src/runtime/local-host/app-request-control.js +96 -11
  468. package/dist/src/runtime/local-host/app-service-dispatch.d.ts +2 -1
  469. package/dist/src/runtime/local-host/app-service-dispatch.js +31 -0
  470. package/dist/src/runtime/local-host/client-learning.d.ts +1 -1
  471. package/dist/src/runtime/local-host/client-learning.js +0 -1
  472. package/dist/src/runtime/local-host/client-native-permissions.d.ts +4 -0
  473. package/dist/src/runtime/local-host/client-native-permissions.js +37 -0
  474. package/dist/src/runtime/local-host/client-requests.js +32 -5
  475. package/dist/src/runtime/local-host/client-services.d.ts +275 -0
  476. package/dist/src/runtime/local-host/client-services.js +3 -2
  477. package/dist/src/runtime/local-host/learning-preferences-input.js +1 -0
  478. package/dist/src/runtime/local-host/local-request-diagnostics.d.ts +9 -0
  479. package/dist/src/runtime/local-host/local-request-diagnostics.js +47 -0
  480. package/dist/src/runtime/local-host/saved-approvals.js +23 -2
  481. package/dist/src/runtime/model/context-compaction-admission.d.ts +21 -0
  482. package/dist/src/runtime/model/context-compaction-admission.js +214 -0
  483. package/dist/src/runtime/model/context-compaction-contracts.d.ts +32 -0
  484. package/dist/src/runtime/model/context-compaction-contracts.js +1 -0
  485. package/dist/src/runtime/model/context-compaction-diagnostics.d.ts +33 -0
  486. package/dist/src/runtime/model/context-compaction-diagnostics.js +97 -0
  487. package/dist/src/runtime/model/context-compaction-stage-plan.d.ts +3 -0
  488. package/dist/src/runtime/model/context-compaction-stage-plan.js +28 -0
  489. package/dist/src/runtime/model/input-token-count.d.ts +1 -0
  490. package/dist/src/runtime/model/input-token-count.js +4 -1
  491. package/dist/src/runtime/model/invoke-step.js +80 -126
  492. package/dist/src/runtime/model/invoke-structured-step.d.ts +1 -1
  493. package/dist/src/runtime/model/invoke-structured-step.js +3 -2
  494. package/dist/src/runtime/model/model-context-assessment.d.ts +17 -0
  495. package/dist/src/runtime/model/model-context-assessment.js +51 -0
  496. package/dist/src/runtime/model/model-context-budget.js +1 -0
  497. package/dist/src/runtime/model/model-selection.js +4 -1
  498. package/dist/src/runtime/model/model-step-acceptance.d.ts +4 -0
  499. package/dist/src/runtime/model/model-step-acceptance.js +28 -0
  500. package/dist/src/runtime/model/model-step-port.d.ts +4 -15
  501. package/dist/src/runtime/model/model-step-steering.d.ts +14 -1
  502. package/dist/src/runtime/model/model-step-steering.js +23 -0
  503. package/dist/src/runtime/observability/request-control-diagnostics.d.ts +6 -0
  504. package/dist/src/runtime/observability/request-control-diagnostics.js +52 -0
  505. package/dist/src/runtime/orchestration/capability-adapters/result.d.ts +4 -1
  506. package/dist/src/runtime/orchestration/capability-adapters/result.js +11 -7
  507. package/dist/src/runtime/orchestration/role-calls/child-return.d.ts +5 -1
  508. package/dist/src/runtime/orchestration/role-calls/child-return.js +2 -2
  509. package/dist/src/runtime/orchestration/worker-capabilities/binding/invocation-preparation.js +1 -8
  510. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +3 -4
  511. package/dist/src/runtime/orchestration/worker-capabilities/contracts.js +1 -1
  512. package/dist/src/runtime/orchestration/worker-capabilities/execution/context-projection.js +2 -1
  513. package/dist/src/runtime/orchestration/worker-capabilities/payload-assignment-validation.js +9 -9
  514. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.js +9 -33
  515. package/dist/src/runtime/orchestration/worker-capabilities/payload-body-normalization.d.ts +12 -0
  516. package/dist/src/runtime/orchestration/worker-capabilities/payload-body-normalization.js +80 -0
  517. package/dist/src/runtime/orchestration/worker-capabilities/payload-compaction-transport.d.ts +3 -0
  518. package/dist/src/runtime/orchestration/worker-capabilities/payload-compaction-transport.js +14 -0
  519. package/dist/src/runtime/orchestration/worker-capabilities/payload-context-snapshot.d.ts +2 -0
  520. package/dist/src/runtime/orchestration/worker-capabilities/payload-context-snapshot.js +12 -0
  521. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.d.ts +5 -1
  522. package/dist/src/runtime/orchestration/worker-capabilities/payload-instructions.js +1 -1
  523. package/dist/src/runtime/passive-learning/background-dependencies.d.ts +0 -1
  524. package/dist/src/runtime/passive-learning/contracts.d.ts +2 -3
  525. package/dist/src/runtime/passive-learning/proactive/agent.d.ts +3 -0
  526. package/dist/src/runtime/passive-learning/proactive/agent.js +36 -14
  527. package/dist/src/runtime/passive-learning/proactive/contracts.d.ts +7 -1
  528. package/dist/src/runtime/passive-learning/proactive/contracts.js +8 -1
  529. package/dist/src/runtime/passive-learning/proactive/conversation-style-prompt.d.ts +1 -0
  530. package/dist/src/runtime/passive-learning/proactive/conversation-style-prompt.js +6 -0
  531. package/dist/src/runtime/passive-learning/proactive/conversation-style-reference.d.ts +30 -0
  532. package/dist/src/runtime/passive-learning/proactive/conversation-style-reference.js +61 -0
  533. package/dist/src/runtime/passive-learning/proactive/handoff-brief.d.ts +1 -0
  534. package/dist/src/runtime/passive-learning/proactive/handoff-brief.js +4 -0
  535. package/dist/src/runtime/passive-learning/proactive/model-output.d.ts +1 -1
  536. package/dist/src/runtime/passive-learning/proactive/model-output.js +5 -4
  537. package/dist/src/runtime/passive-learning/proactive/model.d.ts +7 -1
  538. package/dist/src/runtime/passive-learning/proactive/model.js +58 -32
  539. package/dist/src/runtime/passive-learning/proactive/prompt.d.ts +1 -1
  540. package/dist/src/runtime/passive-learning/proactive/prompt.js +4 -2
  541. package/dist/src/runtime/passive-learning/proactive/staged-authoring.d.ts +14 -0
  542. package/dist/src/runtime/passive-learning/proactive/staged-authoring.js +27 -0
  543. package/dist/src/runtime/passive-learning/proactive/staged-context.d.ts +13 -0
  544. package/dist/src/runtime/passive-learning/proactive/staged-context.js +39 -4
  545. package/dist/src/runtime/passive-learning/proactive/staged-contract.d.ts +3 -0
  546. package/dist/src/runtime/passive-learning/proactive/staged-contract.js +4 -0
  547. package/dist/src/runtime/passive-learning/proactive/staged-format.d.ts +5 -1
  548. package/dist/src/runtime/passive-learning/proactive/staged-format.js +2 -4
  549. package/dist/src/runtime/passive-learning/proactive/staged-output.d.ts +3 -4
  550. package/dist/src/runtime/passive-learning/proactive/staged-output.js +13 -5
  551. package/dist/src/runtime/passive-learning/proactive/staged-progress-store.d.ts +0 -1
  552. package/dist/src/runtime/passive-learning/proactive/staged-progress-store.js +2 -18
  553. package/dist/src/runtime/passive-learning/proactive/staged-prompt.d.ts +3 -1
  554. package/dist/src/runtime/passive-learning/proactive/staged-prompt.js +13 -4
  555. package/dist/src/runtime/passive-learning/proactive/staged-review.d.ts +1 -1
  556. package/dist/src/runtime/passive-learning/proactive/staged-review.js +10 -11
  557. package/dist/src/runtime/passive-learning/proactive/store.d.ts +1 -1
  558. package/dist/src/runtime/passive-learning/proactive/store.js +11 -5
  559. package/dist/src/runtime/passive-learning/review-progress.d.ts +1 -1
  560. package/dist/src/runtime/passive-learning/review-progress.js +2 -2
  561. package/dist/src/runtime/passive-learning/service-status.js +2 -2
  562. package/dist/src/runtime/passive-learning/service.js +0 -6
  563. package/dist/src/runtime/passive-learning/spark-chat-preferences.d.ts +3 -0
  564. package/dist/src/runtime/passive-learning/spark-chat-preferences.js +8 -0
  565. package/dist/src/runtime/passive-learning/staged-review-call.d.ts +3 -0
  566. package/dist/src/runtime/passive-learning/staged-review-call.js +19 -13
  567. package/dist/src/runtime/passive-learning/store.js +4 -0
  568. package/dist/src/runtime/plugins/configuration-context.d.ts +9 -0
  569. package/dist/src/runtime/plugins/configuration-context.js +42 -0
  570. package/dist/src/runtime/plugins/configuration-settings.d.ts +2 -0
  571. package/dist/src/runtime/plugins/configuration-settings.js +26 -0
  572. package/dist/src/runtime/plugins/configuration-store.d.ts +23 -0
  573. package/dist/src/runtime/plugins/configuration-store.js +100 -0
  574. package/dist/src/runtime/plugins/configuration-write.d.ts +5 -0
  575. package/dist/src/runtime/plugins/configuration-write.js +58 -0
  576. package/dist/src/runtime/plugins/installation/archive.d.ts +2 -0
  577. package/dist/src/runtime/plugins/installation/archive.js +107 -0
  578. package/dist/src/runtime/plugins/installation/github-download.d.ts +9 -0
  579. package/dist/src/runtime/plugins/installation/github-download.js +72 -0
  580. package/dist/src/runtime/plugins/installation/installed-package.d.ts +9 -0
  581. package/dist/src/runtime/plugins/installation/installed-package.js +66 -0
  582. package/dist/src/runtime/plugins/installation/package.d.ts +45 -0
  583. package/dist/src/runtime/plugins/installation/package.js +79 -0
  584. package/dist/src/runtime/plugins/installation/portable-path.d.ts +2 -0
  585. package/dist/src/runtime/plugins/installation/portable-path.js +10 -0
  586. package/dist/src/runtime/plugins/installation/publication.d.ts +10 -0
  587. package/dist/src/runtime/plugins/installation/publication.js +17 -0
  588. package/dist/src/runtime/plugins/installation/service.d.ts +41 -0
  589. package/dist/src/runtime/plugins/installation/service.js +80 -0
  590. package/dist/src/runtime/plugins/loader.js +15 -29
  591. package/dist/src/runtime/plugins/manifest-projection.js +5 -0
  592. package/dist/src/runtime/plugins/manifest-validator.js +10 -0
  593. package/dist/src/runtime/plugins/module-cache.d.ts +2 -0
  594. package/dist/src/runtime/plugins/module-cache.js +19 -0
  595. package/dist/src/runtime/plugins/selection.d.ts +2 -0
  596. package/dist/src/runtime/plugins/selection.js +16 -11
  597. package/dist/src/runtime/ports.d.ts +20 -5
  598. package/dist/src/runtime/request/approval-wait/activation-events.d.ts +5 -0
  599. package/dist/src/runtime/request/approval-wait/activation-events.js +4 -3
  600. package/dist/src/runtime/request/approval-wait/snapshot.d.ts +1 -1
  601. package/dist/src/runtime/request/approval-wait/snapshot.js +1 -0
  602. package/dist/src/runtime/request/approval-wait/super-compaction-restore.d.ts +20 -0
  603. package/dist/src/runtime/request/approval-wait/super-compaction-restore.js +61 -0
  604. package/dist/src/runtime/request/automation-output-contract.d.ts +6 -0
  605. package/dist/src/runtime/request/automation-output-contract.js +33 -0
  606. package/dist/src/runtime/request/contracts.d.ts +16 -0
  607. package/dist/src/runtime/request/dependencies.d.ts +2 -1
  608. package/dist/src/runtime/request/execution-agent-root-execution.js +2 -0
  609. package/dist/src/runtime/request/execution-facets.js +7 -0
  610. package/dist/src/runtime/request/execution-payload-compacted-evidence.d.ts +64 -0
  611. package/dist/src/runtime/request/execution-payload-compacted-evidence.js +46 -0
  612. package/dist/src/runtime/request/execution-scope-surfaces.d.ts +2 -0
  613. package/dist/src/runtime/request/execution-scope-surfaces.js +28 -0
  614. package/dist/src/runtime/request/execution-scope.d.ts +8 -2
  615. package/dist/src/runtime/request/execution-scope.js +14 -2
  616. package/dist/src/runtime/request/handler.d.ts +7 -0
  617. package/dist/src/runtime/request/handler.js +204 -35
  618. package/dist/src/runtime/request/locked-request-steering.d.ts +3 -0
  619. package/dist/src/runtime/request/locked-request-steering.js +12 -0
  620. package/dist/src/runtime/request/policy-degraded-finalization.d.ts +10 -0
  621. package/dist/src/runtime/request/policy-degraded-finalization.js +27 -0
  622. package/dist/src/runtime/request/prepared-execution.d.ts +10 -1
  623. package/dist/src/runtime/request/prepared-execution.js +48 -8
  624. package/dist/src/runtime/request/request-steering.d.ts +5 -1
  625. package/dist/src/runtime/request/request-steering.js +37 -12
  626. package/dist/src/runtime/request/result.d.ts +3 -0
  627. package/dist/src/runtime/request/role-executor-composition.js +4 -3
  628. package/dist/src/runtime/request/root-contract.d.ts +2 -0
  629. package/dist/src/runtime/request/root-execution-kernel.js +10 -9
  630. package/dist/src/runtime/request/root-invalid-output.js +16 -1
  631. package/dist/src/runtime/request/session-admission.d.ts +6 -0
  632. package/dist/src/runtime/request/session-admission.js +47 -14
  633. package/dist/src/runtime/request/super-checkpoint-quarantine.d.ts +8 -0
  634. package/dist/src/runtime/request/super-checkpoint-quarantine.js +76 -0
  635. package/dist/src/runtime/request/super-context-failure-executor.d.ts +4 -0
  636. package/dist/src/runtime/request/super-context-failure-executor.js +68 -0
  637. package/dist/src/runtime/request/super-context-failure-integrity.d.ts +16 -0
  638. package/dist/src/runtime/request/super-context-failure-integrity.js +130 -0
  639. package/dist/src/runtime/request/super-context-scope.d.ts +9 -0
  640. package/dist/src/runtime/request/super-context-scope.js +65 -0
  641. package/dist/src/runtime/request/super-failure-explanation.d.ts +22 -0
  642. package/dist/src/runtime/request/super-failure-explanation.js +77 -0
  643. package/dist/src/runtime/request/super-failure-message.d.ts +10 -0
  644. package/dist/src/runtime/request/super-failure-message.js +40 -0
  645. package/dist/src/runtime/request/super-payload-context-failure.d.ts +11 -0
  646. package/dist/src/runtime/request/super-payload-context-failure.js +55 -0
  647. package/dist/src/runtime/request/super-root-failure-finalization.d.ts +23 -0
  648. package/dist/src/runtime/request/super-root-failure-finalization.js +112 -0
  649. package/dist/src/runtime/request/worker-capability-composition.d.ts +4 -0
  650. package/dist/src/runtime/request/worker-capability-composition.js +8 -2
  651. package/dist/src/runtime/request/worker-capability-payload.d.ts +2 -1
  652. package/dist/src/runtime/request/worker-capability-payload.js +74 -48
  653. package/dist/src/runtime/runtime-environment.d.ts +3 -1
  654. package/dist/src/runtime/runtime-environment.js +167 -1
  655. package/dist/src/runtime/scheduler/automation-job-management.d.ts +12 -0
  656. package/dist/src/runtime/scheduler/automation-job-management.js +288 -0
  657. package/dist/src/runtime/scheduler/automation-rerun.d.ts +6 -0
  658. package/dist/src/runtime/scheduler/automation-rerun.js +95 -0
  659. package/dist/src/runtime/scheduler/automation-run-budget.d.ts +4 -0
  660. package/dist/src/runtime/scheduler/automation-run-budget.js +16 -0
  661. package/dist/src/runtime/scheduler/automation-run-change-events.d.ts +11 -0
  662. package/dist/src/runtime/scheduler/automation-run-change-events.js +77 -0
  663. package/dist/src/runtime/scheduler/automation-run-completion.d.ts +11 -0
  664. package/dist/src/runtime/scheduler/automation-run-completion.js +93 -0
  665. package/dist/src/runtime/scheduler/automation-run-control.d.ts +3 -0
  666. package/dist/src/runtime/scheduler/automation-run-control.js +48 -0
  667. package/dist/src/runtime/scheduler/automation-run-records.d.ts +5 -0
  668. package/dist/src/runtime/scheduler/automation-run-records.js +37 -0
  669. package/dist/src/runtime/scheduler/automation-schedule.d.ts +10 -0
  670. package/dist/src/runtime/scheduler/automation-schedule.js +48 -0
  671. package/dist/src/runtime/scheduler/automation-scheduler-engine.d.ts +4 -0
  672. package/dist/src/runtime/scheduler/automation-scheduler-engine.js +188 -0
  673. package/dist/src/runtime/scheduler/automation-snapshot-validation.d.ts +3 -0
  674. package/dist/src/runtime/scheduler/automation-snapshot-validation.js +106 -0
  675. package/dist/src/runtime/scheduler/contracts.d.ts +143 -3
  676. package/dist/src/runtime/scheduler/file-store.js +15 -1
  677. package/dist/src/runtime/scheduler/job-management.js +3 -2
  678. package/dist/src/runtime/scheduler/journal-automation-index.d.ts +23 -0
  679. package/dist/src/runtime/scheduler/journal-automation-index.js +205 -0
  680. package/dist/src/runtime/scheduler/journal-automation-transaction.d.ts +11 -0
  681. package/dist/src/runtime/scheduler/journal-automation-transaction.js +90 -0
  682. package/dist/src/runtime/scheduler/journal-checkpoint.js +5 -2
  683. package/dist/src/runtime/scheduler/journal-head.d.ts +1 -1
  684. package/dist/src/runtime/scheduler/journal-head.js +2 -2
  685. package/dist/src/runtime/scheduler/journal-index-state.d.ts +22 -11
  686. package/dist/src/runtime/scheduler/journal-index-state.js +76 -17
  687. package/dist/src/runtime/scheduler/journal-index.d.ts +9 -3
  688. package/dist/src/runtime/scheduler/journal-index.js +84 -9
  689. package/dist/src/runtime/scheduler/journal-store.d.ts +9 -1
  690. package/dist/src/runtime/scheduler/journal-store.js +110 -7
  691. package/dist/src/runtime/scheduler/journal-transaction.d.ts +7 -4
  692. package/dist/src/runtime/scheduler/journal-transaction.js +13 -2
  693. package/dist/src/runtime/scheduler/next-occurrence.js +2 -0
  694. package/dist/src/runtime/scheduler/run-completion.js +2 -1
  695. package/dist/src/runtime/scheduler/run-records.js +8 -3
  696. package/dist/src/runtime/scheduler/schedule-update.d.ts +2 -2
  697. package/dist/src/runtime/scheduler/schedule-validation.d.ts +2 -2
  698. package/dist/src/runtime/scheduler/schedule-validation.js +2 -0
  699. package/dist/src/runtime/scheduler/scheduler-engine.js +24 -8
  700. package/dist/src/runtime/scheduler/scheduler-service.d.ts +4 -1
  701. package/dist/src/runtime/scheduler/scheduler-service.js +83 -10
  702. package/dist/src/runtime/scheduler/scheduler-target.d.ts +9 -0
  703. package/dist/src/runtime/scheduler/scheduler-target.js +41 -0
  704. package/dist/src/runtime/scheduler/service-context.d.ts +6 -2
  705. package/dist/src/runtime/scheduler/service-context.js +6 -3
  706. package/dist/src/runtime/scheduler/snapshot-validation.d.ts +3 -3
  707. package/dist/src/runtime/scheduler/snapshot-validation.js +21 -1
  708. package/dist/src/runtime/scheduler/startup-recovery.d.ts +1 -1
  709. package/dist/src/runtime/scheduler/startup-recovery.js +15 -2
  710. package/dist/src/runtime/scheduler/working-store.js +8 -0
  711. package/dist/src/runtime/session/request-session.d.ts +1 -0
  712. package/dist/src/runtime/session/request-session.js +1 -0
  713. package/dist/src/runtime/session/session-deletion-boundary.d.ts +1 -1
  714. package/dist/src/runtime/session/session-deletion-boundary.js +6 -2
  715. package/dist/src/runtime/session/session-lifecycle-store.d.ts +4 -1
  716. package/dist/src/runtime/session/session-lifecycle-store.js +32 -4
  717. package/dist/src/runtime/session/spark-session-attachments.d.ts +4 -0
  718. package/dist/src/runtime/session/spark-session-attachments.js +28 -0
  719. package/dist/src/runtime/session/spark-session-cleanup-receipt.d.ts +7 -0
  720. package/dist/src/runtime/session/spark-session-cleanup-receipt.js +61 -0
  721. package/dist/src/runtime/session/spark-session-clear.d.ts +6 -0
  722. package/dist/src/runtime/session/spark-session-clear.js +36 -0
  723. package/dist/src/runtime/session/terminal-response.d.ts +21 -0
  724. package/dist/src/runtime/session/terminal-response.js +38 -0
  725. package/dist/src/runtime/steps/auditor-decision/advisory-receipt.d.ts +1 -0
  726. package/dist/src/runtime/steps/auditor-decision/advisory-receipt.js +12 -0
  727. package/dist/src/runtime/steps/auditor-decision/contracts.d.ts +4 -0
  728. package/dist/src/runtime/steps/auditor-decision/evidence-coverage.js +5 -5
  729. package/dist/src/runtime/steps/auditor-decision/evidence-inventory.d.ts +2 -1
  730. package/dist/src/runtime/steps/auditor-decision/evidence-inventory.js +12 -1
  731. package/dist/src/runtime/steps/auditor-decision/evidence-representation.d.ts +8 -2
  732. package/dist/src/runtime/steps/auditor-decision/evidence-representation.js +14 -1
  733. package/dist/src/runtime/steps/auditor-decision/input.d.ts +2 -0
  734. package/dist/src/runtime/steps/auditor-decision/input.js +12 -3
  735. package/dist/src/runtime/steps/auditor-decision/projection.js +20 -1
  736. package/dist/src/runtime/steps/auditor-decision/prompt.js +6 -6
  737. package/dist/src/runtime/steps/auditor-decision/run.js +2 -3
  738. package/dist/src/runtime/steps/capability-execution-instructions.d.ts +5 -0
  739. package/dist/src/runtime/steps/capability-execution-instructions.js +5 -0
  740. package/dist/src/runtime/steps/degraded-finalization/contract.d.ts +3 -0
  741. package/dist/src/runtime/steps/degraded-finalization/fallback.js +14 -4
  742. package/dist/src/runtime/steps/degraded-finalization/input.js +11 -1
  743. package/dist/src/runtime/steps/degraded-finalization/output-limit-cause.d.ts +4 -0
  744. package/dist/src/runtime/steps/degraded-finalization/output-limit-cause.js +17 -0
  745. package/dist/src/runtime/steps/degraded-finalization/prompt.js +4 -1
  746. package/dist/src/runtime/steps/degraded-finalization/super.d.ts +20 -0
  747. package/dist/src/runtime/steps/degraded-finalization/super.js +128 -0
  748. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.d.ts +1 -0
  749. package/dist/src/runtime/steps/execution-agent/capability-decision-parsing.js +21 -3
  750. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.d.ts +1 -1
  751. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.js +4 -2
  752. package/dist/src/runtime/steps/execution-agent/capability-selection-schema.d.ts +3 -0
  753. package/dist/src/runtime/steps/execution-agent/capability-selection-schema.js +72 -0
  754. package/dist/src/runtime/steps/execution-agent/compaction.d.ts +5 -2
  755. package/dist/src/runtime/steps/execution-agent/compaction.js +10 -4
  756. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +14 -2
  757. package/dist/src/runtime/steps/execution-agent/controls-compacted-evidence.d.ts +16 -0
  758. package/dist/src/runtime/steps/execution-agent/controls-compacted-evidence.js +67 -0
  759. package/dist/src/runtime/steps/execution-agent/controls-evidence-contract.d.ts +21 -0
  760. package/dist/src/runtime/steps/execution-agent/controls-evidence-contract.js +64 -0
  761. package/dist/src/runtime/steps/execution-agent/controls-evidence.d.ts +32 -0
  762. package/dist/src/runtime/steps/execution-agent/controls-evidence.js +119 -0
  763. package/dist/src/runtime/steps/execution-agent/decision-parsing.js +1 -0
  764. package/dist/src/runtime/steps/execution-agent/format.d.ts +2 -0
  765. package/dist/src/runtime/steps/execution-agent/format.js +9 -68
  766. package/dist/src/runtime/steps/execution-agent/input.js +19 -2
  767. package/dist/src/runtime/steps/execution-agent/prompt.d.ts +1 -0
  768. package/dist/src/runtime/steps/execution-agent/prompt.js +15 -2
  769. package/dist/src/runtime/steps/execution-agent/refinement-input.d.ts +32 -0
  770. package/dist/src/runtime/steps/execution-agent/refinement-input.js +146 -0
  771. package/dist/src/runtime/steps/execution-agent/refinement-prompt.d.ts +1 -0
  772. package/dist/src/runtime/steps/execution-agent/refinement-prompt.js +11 -0
  773. package/dist/src/runtime/steps/execution-agent/refinement.d.ts +4 -4
  774. package/dist/src/runtime/steps/execution-agent/refinement.js +18 -108
  775. package/dist/src/runtime/steps/execution-agent/response-input.js +13 -6
  776. package/dist/src/runtime/steps/execution-agent/response-prompt.js +1 -1
  777. package/dist/src/runtime/steps/execution-agent/response-run.js +19 -5
  778. package/dist/src/runtime/steps/execution-agent/run.js +9 -3
  779. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +1 -1
  780. package/dist/src/runtime/steps/execution-agent/state-context.js +20 -5
  781. package/dist/src/runtime/steps/planner-decision/input.js +7 -0
  782. package/dist/src/runtime/steps/planner-decision/resume.d.ts +2 -1
  783. package/dist/src/runtime/steps/planner-decision/resume.js +3 -3
  784. package/dist/src/runtime/steps/planner-decision/run.js +13 -0
  785. package/dist/src/runtime/steps/planner-graph/prompt.js +2 -0
  786. package/dist/src/runtime/steps/planner-graph/run.js +1 -0
  787. package/dist/src/runtime/steps/reviewer-decision/projection.js +5 -0
  788. package/dist/src/runtime/steps/reviewer-decision/run.js +13 -0
  789. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +1 -1
  790. package/dist/src/runtime/steps/supervisor-decision/input.js +2 -0
  791. package/dist/src/runtime/steps/supervisor-decision/run.js +14 -0
  792. package/dist/src/runtime/steps/supervisor-decision/working-directory.d.ts +2 -0
  793. package/dist/src/runtime/steps/supervisor-decision/working-directory.js +6 -0
  794. package/dist/src/runtime/steps/supervisor-response/input.d.ts +1 -1
  795. package/dist/src/runtime/steps/supervisor-response/input.js +14 -7
  796. package/dist/src/runtime/steps/supervisor-response/run.js +39 -9
  797. package/dist/src/runtime/steps/worker-decision/compaction-integrity.d.ts +11 -0
  798. package/dist/src/runtime/steps/worker-decision/compaction-integrity.js +40 -0
  799. package/dist/src/runtime/steps/worker-decision/input/reference-context.js +7 -0
  800. package/dist/src/runtime/steps/worker-decision/input/types.d.ts +4 -1
  801. package/dist/src/runtime/steps/worker-decision/prompt.js +9 -2
  802. package/dist/src/runtime/steps/worker-decision/result-author.js +4 -0
  803. package/dist/src/runtime/steps/worker-decision/run.js +12 -49
  804. package/dist/src/runtime/steps/worker-decision/worker-handoff-compaction.d.ts +4 -0
  805. package/dist/src/runtime/steps/worker-decision/worker-handoff-compaction.js +69 -0
  806. package/dist/src/sessions/assistant-initiative-append.d.ts +14 -0
  807. package/dist/src/sessions/assistant-initiative-append.js +64 -0
  808. package/dist/src/sessions/assistant-initiative-message.d.ts +3 -0
  809. package/dist/src/sessions/assistant-initiative-message.js +12 -0
  810. package/dist/src/sessions/assistant-initiative.d.ts +6 -2
  811. package/dist/src/sessions/assistant-initiative.js +8 -8
  812. package/dist/src/sessions/automation-session-origin.d.ts +34 -0
  813. package/dist/src/sessions/automation-session-origin.js +78 -0
  814. package/dist/src/sessions/automation-session-store.d.ts +12 -0
  815. package/dist/src/sessions/automation-session-store.js +129 -0
  816. package/dist/src/sessions/durable-session-commit.d.ts +2 -1
  817. package/dist/src/sessions/durable-session-commit.js +6 -1
  818. package/dist/src/sessions/index.d.ts +1 -0
  819. package/dist/src/sessions/index.js +3 -0
  820. package/dist/src/sessions/memory/source.d.ts +1 -1
  821. package/dist/src/sessions/memory/source.js +4 -11
  822. package/dist/src/sessions/metadata/projection.d.ts +15 -0
  823. package/dist/src/sessions/metadata/projection.js +55 -0
  824. package/dist/src/sessions/metadata/publication.d.ts +12 -0
  825. package/dist/src/sessions/metadata/publication.js +78 -0
  826. package/dist/src/sessions/metadata/source-receipt.d.ts +5 -0
  827. package/dist/src/sessions/metadata/source-receipt.js +42 -0
  828. package/dist/src/sessions/metadata/store.d.ts +7 -0
  829. package/dist/src/sessions/metadata/store.js +119 -0
  830. package/dist/src/sessions/project-binding.d.ts +1 -0
  831. package/dist/src/sessions/record/projection.d.ts +4 -1
  832. package/dist/src/sessions/record/projection.js +27 -15
  833. package/dist/src/sessions/request-lifecycle/service.js +3 -3
  834. package/dist/src/sessions/session-service.d.ts +11 -4
  835. package/dist/src/sessions/session-service.js +56 -19
  836. package/dist/src/sessions/session-store.d.ts +2 -1
  837. package/dist/src/sessions/session-store.js +9 -3
  838. package/dist/src/sessions/snapshot.d.ts +17 -0
  839. package/dist/src/sessions/snapshot.js +105 -0
  840. package/dist/src/sessions/spark-handoff-brief.d.ts +3 -0
  841. package/dist/src/sessions/spark-handoff-brief.js +9 -0
  842. package/dist/src/sessions/spark-session.d.ts +13 -0
  843. package/dist/src/sessions/spark-session.js +25 -0
  844. package/dist/src/sessions/types.d.ts +7 -0
  845. package/dist/src/shared/tool-selection.d.ts +2 -0
  846. package/dist/src/shared/tool-selection.js +7 -0
  847. package/dist/src/web-ui/app/ARCHITECTURE.md +103 -0
  848. package/dist/src/web-ui/app/app-bootstrap.js +24 -2
  849. package/dist/src/web-ui/app/app-dom.js +5 -0
  850. package/dist/src/web-ui/app/app-realtime-transport.js +27 -2
  851. package/dist/src/web-ui/app/app.js +11 -13
  852. package/dist/src/web-ui/app/automations-feature.js +103 -0
  853. package/dist/src/web-ui/app/components/automations/archive-actions.js +20 -0
  854. package/dist/src/web-ui/app/components/automations/authoring-entry.js +25 -0
  855. package/dist/src/web-ui/app/components/automations/binding-editor.js +101 -0
  856. package/dist/src/web-ui/app/components/automations/binding-fields.js +166 -0
  857. package/dist/src/web-ui/app/components/automations/chat-run-projection.js +280 -0
  858. package/dist/src/web-ui/app/components/automations/draft-recovery-actions.js +28 -0
  859. package/dist/src/web-ui/app/components/automations/editor-action-icons.js +18 -0
  860. package/dist/src/web-ui/app/components/automations/editor-actions.js +57 -0
  861. package/dist/src/web-ui/app/components/automations/editor.js +218 -0
  862. package/dist/src/web-ui/app/components/automations/failure-presentation.js +299 -0
  863. package/dist/src/web-ui/app/components/automations/library-tabs.js +45 -0
  864. package/dist/src/web-ui/app/components/automations/list.js +58 -0
  865. package/dist/src/web-ui/app/components/automations/live-view.js +39 -0
  866. package/dist/src/web-ui/app/components/automations/node-inspector.js +251 -0
  867. package/dist/src/web-ui/app/components/automations/permission-selection.js +37 -0
  868. package/dist/src/web-ui/app/components/automations/rerun-confirmation.js +16 -0
  869. package/dist/src/web-ui/app/components/automations/run-output-view.js +100 -0
  870. package/dist/src/web-ui/app/components/automations/run-report-view.js +224 -0
  871. package/dist/src/web-ui/app/components/automations/run-step-selection.js +7 -0
  872. package/dist/src/web-ui/app/components/automations/run-steps-view.js +33 -0
  873. package/dist/src/web-ui/app/components/automations/run.js +38 -0
  874. package/dist/src/web-ui/app/components/automations/schema-literal-inputs.js +212 -0
  875. package/dist/src/web-ui/app/components/automations/step-editor-dialog.js +243 -0
  876. package/dist/src/web-ui/app/components/automations/step-preview.js +48 -0
  877. package/dist/src/web-ui/app/components/automations/template-gallery.js +74 -0
  878. package/dist/src/web-ui/app/components/automations/timeline-camera.js +219 -0
  879. package/dist/src/web-ui/app/components/automations/timeline.js +141 -0
  880. package/dist/src/web-ui/app/components/automations/tool-identity.js +25 -0
  881. package/dist/src/web-ui/app/components/automations/workspace.js +462 -0
  882. package/dist/src/web-ui/app/components/composer-context-window.js +24 -13
  883. package/dist/src/web-ui/app/components/config-workspace/config-model.js +2 -0
  884. package/dist/src/web-ui/app/components/config-workspace/model-plugin-permissions.js +130 -0
  885. package/dist/src/web-ui/app/components/config-workspace/model-plugin-selection.js +180 -0
  886. package/dist/src/web-ui/app/components/config-workspace/model-plugin-view-state.js +114 -0
  887. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +5 -2
  888. package/dist/src/web-ui/app/components/config-workspace/model-summary.js +39 -0
  889. package/dist/src/web-ui/app/components/config-workspace/summary-rendering.js +30 -0
  890. package/dist/src/web-ui/app/components/config-workspace/workspace-events.js +37 -0
  891. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +2 -0
  892. package/dist/src/web-ui/app/components/config-workspace/workspace-persistence.js +9 -1
  893. package/dist/src/web-ui/app/components/config-workspace/workspace-view.js +23 -67
  894. package/dist/src/web-ui/app/components/config-workspace.js +11 -2
  895. package/dist/src/web-ui/app/components/conversation-activity.d.ts +2 -28
  896. package/dist/src/web-ui/app/components/conversation-activity.js +23 -60
  897. package/dist/src/web-ui/app/components/conversation-status.js +3 -2
  898. package/dist/src/web-ui/app/components/conversation-view.js +71 -18
  899. package/dist/src/web-ui/app/components/dashboard/automations.js +28 -0
  900. package/dist/src/web-ui/app/components/dashboard/recent-conversations.js +2 -1
  901. package/dist/src/web-ui/app/components/dashboard/workspace.js +11 -1
  902. package/dist/src/web-ui/app/components/notifications/dom.js +1 -1
  903. package/dist/src/web-ui/app/components/notifications/feedback.js +34 -0
  904. package/dist/src/web-ui/app/components/notifications/pagination.js +13 -0
  905. package/dist/src/web-ui/app/components/notifications/presentation.js +25 -4
  906. package/dist/src/web-ui/app/components/notifications/tabs.js +49 -0
  907. package/dist/src/web-ui/app/components/notifications/workspace.js +19 -26
  908. package/dist/src/web-ui/app/components/onboarding-workspace-access.js +1 -1
  909. package/dist/src/web-ui/app/components/operations-summary.js +105 -0
  910. package/dist/src/web-ui/app/components/passive-learning/agent-state.js +0 -5
  911. package/dist/src/web-ui/app/components/passive-learning/agent-view.js +1 -1
  912. package/dist/src/web-ui/app/components/passive-learning/home.js +1 -13
  913. package/dist/src/web-ui/app/components/passive-learning/memory.js +0 -3
  914. package/dist/src/web-ui/app/components/passive-learning/settings-view.js +2 -2
  915. package/dist/src/web-ui/app/components/passive-learning/workspace-view.js +3 -3
  916. package/dist/src/web-ui/app/components/plugins/configuration-draft.js +34 -0
  917. package/dist/src/web-ui/app/components/plugins/configuration-editor.js +147 -0
  918. package/dist/src/web-ui/app/components/plugins/configuration-fields.js +103 -0
  919. package/dist/src/web-ui/app/components/plugins/configuration-retained-secrets.js +20 -0
  920. package/dist/src/web-ui/app/components/plugins/configuration-settings.js +108 -0
  921. package/dist/src/web-ui/app/components/plugins/discovery-rendering.js +37 -0
  922. package/dist/src/web-ui/app/components/plugins/installation.js +212 -0
  923. package/dist/src/web-ui/app/components/plugins/manager.js +160 -6
  924. package/dist/src/web-ui/app/components/plugins/removal.js +130 -0
  925. package/dist/src/web-ui/app/components/plugins/rendering.js +14 -2
  926. package/dist/src/web-ui/app/components/plugins/summary.js +54 -0
  927. package/dist/src/web-ui/app/components/plugins/tabs.js +31 -0
  928. package/dist/src/web-ui/app/components/plugins/view-state.js +3 -1
  929. package/dist/src/web-ui/app/components/runtime-setup/connection-form.js +5 -2
  930. package/dist/src/web-ui/app/components/runtime-setup/connection-state.js +9 -1
  931. package/dist/src/web-ui/app/components/runtime-setup/context-window-feedback.js +71 -0
  932. package/dist/src/web-ui/app/components/runtime-setup/optional-steps.js +9 -1
  933. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +5 -1
  934. package/dist/src/web-ui/app/components/runtime-setup-guide.js +20 -5
  935. package/dist/src/web-ui/app/components/schedules/details.js +3 -2
  936. package/dist/src/web-ui/app/components/schedules/form.js +4 -4
  937. package/dist/src/web-ui/app/components/spark-chat/empty-state.js +46 -0
  938. package/dist/src/web-ui/app/components/spark-chat/handoff-actions.js +59 -0
  939. package/dist/src/web-ui/app/components/spark-chat/mascot-activity.js +27 -0
  940. package/dist/src/web-ui/app/components/spark-chat/motion.js +52 -0
  941. package/dist/src/web-ui/app/components/spark-chat/panel.js +110 -0
  942. package/dist/src/web-ui/app/components/spark-chat/placement.js +198 -0
  943. package/dist/src/web-ui/app/components/spark-chat/results.js +44 -0
  944. package/dist/src/web-ui/app/components/spark-chat/settings.js +84 -0
  945. package/dist/src/web-ui/app/components/system-host/connection-card.js +35 -0
  946. package/dist/src/web-ui/app/components/system-host/macos-permission-preparation.js +83 -0
  947. package/dist/src/web-ui/app/components/system-host/macos-permission-rendering.js +85 -0
  948. package/dist/src/web-ui/app/components/system-host/macos-permission-scopes.js +51 -0
  949. package/dist/src/web-ui/app/components/system-host/macos-setup.js +1 -1
  950. package/dist/src/web-ui/app/components/system-host/manager.js +78 -11
  951. package/dist/src/web-ui/app/components/system-host/rendering.js +113 -100
  952. package/dist/src/web-ui/app/components/system-host/windows-store-setup.js +293 -0
  953. package/dist/src/web-ui/app/components/workspace-shell.js +45 -6
  954. package/dist/src/web-ui/app/computer-access-feature.js +27 -5
  955. package/dist/src/web-ui/app/configuration-feature.js +36 -2
  956. package/dist/src/web-ui/app/controllers/app-event-bindings.js +28 -3
  957. package/dist/src/web-ui/app/controllers/automation-draft-actions.js +153 -0
  958. package/dist/src/web-ui/app/controllers/automation-management-actions.js +75 -0
  959. package/dist/src/web-ui/app/controllers/automation-mutation-lifecycle.js +32 -0
  960. package/dist/src/web-ui/app/controllers/automation-read-projection.js +63 -0
  961. package/dist/src/web-ui/app/controllers/automation-run-actions.js +54 -0
  962. package/dist/src/web-ui/app/controllers/automation-view-scope.js +19 -0
  963. package/dist/src/web-ui/app/controllers/automations-controller.js +395 -0
  964. package/dist/src/web-ui/app/controllers/composer-queue-controller.d.ts +1 -0
  965. package/dist/src/web-ui/app/controllers/composer-queue-controller.js +18 -12
  966. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.d.ts +1 -0
  967. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.js +7 -3
  968. package/dist/src/web-ui/app/controllers/conversation-request-hydration.js +88 -0
  969. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +9 -3
  970. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +89 -158
  971. package/dist/src/web-ui/app/controllers/conversation-view-feature.js +1 -14
  972. package/dist/src/web-ui/app/controllers/dashboard-controller.js +42 -1
  973. package/dist/src/web-ui/app/controllers/history-pagination.js +111 -0
  974. package/dist/src/web-ui/app/controllers/notifications-controller.js +1 -1
  975. package/dist/src/web-ui/app/controllers/operations-controller.d.ts +12 -0
  976. package/dist/src/web-ui/app/controllers/operations-controller.js +28 -21
  977. package/dist/src/web-ui/app/controllers/passive-learning-controller.js +33 -85
  978. package/dist/src/web-ui/app/controllers/projects-controller.d.ts +2 -0
  979. package/dist/src/web-ui/app/controllers/projects-controller.js +53 -18
  980. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +42 -160
  981. package/dist/src/web-ui/app/controllers/request-lifecycle-controller.js +2 -0
  982. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.d.ts +5 -1
  983. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.js +25 -3
  984. package/dist/src/web-ui/app/controllers/schedules-controller.js +11 -19
  985. package/dist/src/web-ui/app/controllers/session-controller.js +10 -2
  986. package/dist/src/web-ui/app/controllers/session-list-pagination.js +71 -0
  987. package/dist/src/web-ui/app/controllers/session-sidebar-controller.js +6 -4
  988. package/dist/src/web-ui/app/controllers/spark-chat-notices.js +34 -0
  989. package/dist/src/web-ui/app/controllers/spark-chat-reading.js +146 -0
  990. package/dist/src/web-ui/app/controllers/spark-chat-sync.js +170 -0
  991. package/dist/src/web-ui/app/controllers/spark-handoff-navigation.js +32 -0
  992. package/dist/src/web-ui/app/controllers/workspace-route-controller.js +42 -20
  993. package/dist/src/web-ui/app/dashboard-feature.js +2 -3
  994. package/dist/src/web-ui/app/index.html +18 -12
  995. package/dist/src/web-ui/app/lib/automation-binding-producers.js +47 -0
  996. package/dist/src/web-ui/app/lib/automation-graph-position.js +19 -0
  997. package/dist/src/web-ui/app/lib/automation-parallel-depth.js +19 -0
  998. package/dist/src/web-ui/app/lib/configuration-pages.js +3 -5
  999. package/dist/src/web-ui/app/lib/context-compaction-state.d.ts +41 -0
  1000. package/dist/src/web-ui/app/lib/context-compaction-state.js +172 -0
  1001. package/dist/src/web-ui/app/lib/context-window-measurement.d.ts +33 -0
  1002. package/dist/src/web-ui/app/lib/context-window-measurement.js +99 -0
  1003. package/dist/src/web-ui/app/lib/context-window-replay.d.ts +32 -0
  1004. package/dist/src/web-ui/app/lib/context-window-replay.js +38 -0
  1005. package/dist/src/web-ui/app/lib/context-window-snapshot-order.d.ts +16 -8
  1006. package/dist/src/web-ui/app/lib/context-window-snapshot-order.js +29 -9
  1007. package/dist/src/web-ui/app/lib/context-window-state.d.ts +80 -0
  1008. package/dist/src/web-ui/app/lib/context-window-state.js +341 -0
  1009. package/dist/src/web-ui/app/lib/conversation-status-model.js +15 -3
  1010. package/dist/src/web-ui/app/lib/history-page-messages.js +49 -0
  1011. package/dist/src/web-ui/app/lib/realtime-message.js +9 -0
  1012. package/dist/src/web-ui/app/lib/request-lifecycle-view.js +8 -0
  1013. package/dist/src/web-ui/app/lib/schedule-conversation-presentation.js +19 -0
  1014. package/dist/src/web-ui/app/lib/schedule-presentation.js +2 -2
  1015. package/dist/src/web-ui/app/lib/spark-chat-address.js +22 -0
  1016. package/dist/src/web-ui/app/lib/spark-chat-presentation.js +16 -0
  1017. package/dist/src/web-ui/app/lib/spark-chat-read-state.js +13 -0
  1018. package/dist/src/web-ui/app/lib/spark-proposal-message.js +7 -0
  1019. package/dist/src/web-ui/app/lib/tool-activity-event.d.ts +1 -0
  1020. package/dist/src/web-ui/app/lib/tool-activity-event.js +6 -2
  1021. package/dist/src/web-ui/app/lib/tool-activity-model.js +1 -0
  1022. package/dist/src/web-ui/app/lib/tool-approval-acknowledgement.js +7 -0
  1023. package/dist/src/web-ui/app/lib/tool-automation-activity-fields.js +59 -0
  1024. package/dist/src/web-ui/app/lib/tool-process-activity-fields.js +1 -1
  1025. package/dist/src/web-ui/app/lib/workspace-change.js +2 -2
  1026. package/dist/src/web-ui/app/lib/workspace-route.d.ts +6 -0
  1027. package/dist/src/web-ui/app/lib/workspace-route.js +17 -2
  1028. package/dist/src/web-ui/app/notifications-feature.js +13 -0
  1029. package/dist/src/web-ui/app/passive-learning-feature.js +5 -31
  1030. package/dist/src/web-ui/app/projects-feature.js +16 -5
  1031. package/dist/src/web-ui/app/runtime-onboarding-feature.js +4 -0
  1032. package/dist/src/web-ui/app/schedules-feature.js +1 -1
  1033. package/dist/src/web-ui/app/services/client-preferences.d.ts +0 -2
  1034. package/dist/src/web-ui/app/services/client-preferences.js +0 -2
  1035. package/dist/src/web-ui/app/services/runtime-web-client/automations.d.ts +36 -0
  1036. package/dist/src/web-ui/app/services/runtime-web-client/automations.js +63 -0
  1037. package/dist/src/web-ui/app/services/runtime-web-client/configuration.js +20 -0
  1038. package/dist/src/web-ui/app/services/runtime-web-client/learning.js +0 -9
  1039. package/dist/src/web-ui/app/services/runtime-web-client/plugin-configuration.js +19 -0
  1040. package/dist/src/web-ui/app/services/runtime-web-client/spark-chat.d.ts +22 -0
  1041. package/dist/src/web-ui/app/services/runtime-web-client/spark-chat.js +29 -0
  1042. package/dist/src/web-ui/app/services/runtime-web-client/system-host.js +6 -2
  1043. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +30 -5
  1044. package/dist/src/web-ui/app/services/runtime-web-client.js +17 -4
  1045. package/dist/src/web-ui/app/spark-chat-conversation.js +217 -0
  1046. package/dist/src/web-ui/app/spark-chat-feature.js +244 -0
  1047. package/dist/src/web-ui/app/spark-mascot.svg +12 -0
  1048. package/dist/src/web-ui/app/styles/11-product-links.css +30 -0
  1049. package/dist/src/web-ui/app/styles/11-workspace-header-width.css +48 -14
  1050. package/dist/src/web-ui/app/styles/11-workspace-rail.css +6 -0
  1051. package/dist/src/web-ui/app/styles/19-dashboard-automations.css +32 -0
  1052. package/dist/src/web-ui/app/styles/41-co-worker-agent.css +6 -25
  1053. package/dist/src/web-ui/app/styles/41-plugin-configuration.css +79 -0
  1054. package/dist/src/web-ui/app/styles/41-plugin-discovery.css +132 -0
  1055. package/dist/src/web-ui/app/styles/41-plugin-management.css +6 -0
  1056. package/dist/src/web-ui/app/styles/42-model-plugin-permissions.css +173 -0
  1057. package/dist/src/web-ui/app/styles/46-system-host.css +78 -107
  1058. package/dist/src/web-ui/app/styles/47-config-controls.css +13 -1
  1059. package/dist/src/web-ui/app/styles/48-notifications.css +14 -8
  1060. package/dist/src/web-ui/app/styles/50-automations.css +353 -0
  1061. package/dist/src/web-ui/app/styles/51-automation-editor-actions.css +35 -0
  1062. package/dist/src/web-ui/app/styles/51-automation-templates.css +39 -0
  1063. package/dist/src/web-ui/app/styles/52-automation-reports.css +84 -0
  1064. package/dist/src/web-ui/app/styles/52-automation-step-editor.css +73 -0
  1065. package/dist/src/web-ui/app/styles/53-automation-schema-inputs.css +21 -0
  1066. package/dist/src/web-ui/app/styles/54-spark-chat.css +143 -0
  1067. package/dist/src/web-ui/app/styles/94-automations-responsive.css +35 -0
  1068. package/dist/src/web-ui/app/styles.css +13 -1
  1069. package/dist/src/web-ui/app/ui-behavior.js +1 -0
  1070. package/dist/src/web-ui/local-runtime/api-router.d.ts +2 -0
  1071. package/dist/src/web-ui/local-runtime/api-router.js +29 -6
  1072. package/dist/src/web-ui/local-runtime/approval-request-attachment.js +14 -5
  1073. package/dist/src/web-ui/local-runtime/automation-routes.d.ts +27 -0
  1074. package/dist/src/web-ui/local-runtime/automation-routes.js +227 -0
  1075. package/dist/src/web-ui/local-runtime/configuration-activation-source.d.ts +1 -1
  1076. package/dist/src/web-ui/local-runtime/configuration-activation-source.js +9 -3
  1077. package/dist/src/web-ui/local-runtime/contracts.d.ts +4 -3
  1078. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +9 -1
  1079. package/dist/src/web-ui/local-runtime/environment-registry.js +58 -11
  1080. package/dist/src/web-ui/local-runtime/history-pagination.d.ts +16 -0
  1081. package/dist/src/web-ui/local-runtime/history-pagination.js +20 -0
  1082. package/dist/src/web-ui/local-runtime/learning-notifications.js +1 -1
  1083. package/dist/src/web-ui/local-runtime/learning-routes.js +0 -22
  1084. package/dist/src/web-ui/local-runtime/plugin-configuration-routes.d.ts +16 -0
  1085. package/dist/src/web-ui/local-runtime/plugin-configuration-routes.js +68 -0
  1086. package/dist/src/web-ui/local-runtime/plugin-installation-routes.d.ts +16 -0
  1087. package/dist/src/web-ui/local-runtime/plugin-installation-routes.js +96 -0
  1088. package/dist/src/web-ui/local-runtime/plugin-management-routes.d.ts +8 -1
  1089. package/dist/src/web-ui/local-runtime/plugin-management-routes.js +17 -0
  1090. package/dist/src/web-ui/local-runtime/plugin-mutation-admission.d.ts +7 -0
  1091. package/dist/src/web-ui/local-runtime/plugin-mutation-admission.js +17 -0
  1092. package/dist/src/web-ui/local-runtime/plugin-removal-routes.d.ts +18 -0
  1093. package/dist/src/web-ui/local-runtime/plugin-removal-routes.js +60 -0
  1094. package/dist/src/web-ui/local-runtime/realtime-controller.js +41 -2
  1095. package/dist/src/web-ui/local-runtime/request-cancellation-route.js +28 -1
  1096. package/dist/src/web-ui/local-runtime/request-control-observation.d.ts +19 -0
  1097. package/dist/src/web-ui/local-runtime/request-control-observation.js +80 -0
  1098. package/dist/src/web-ui/local-runtime/request-execution.js +91 -24
  1099. package/dist/src/web-ui/local-runtime/runtime-setup-context-window.d.ts +20 -0
  1100. package/dist/src/web-ui/local-runtime/runtime-setup-context-window.js +44 -0
  1101. package/dist/src/web-ui/local-runtime/runtime-setup-routes.js +2 -0
  1102. package/dist/src/web-ui/local-runtime/runtime-setup-validation.js +9 -2
  1103. package/dist/src/web-ui/local-runtime/session-routes.d.ts +1 -0
  1104. package/dist/src/web-ui/local-runtime/session-routes.js +48 -6
  1105. package/dist/src/web-ui/local-runtime/setup-embedding-config-repository.d.ts +6 -0
  1106. package/dist/src/web-ui/local-runtime/setup-embedding-config-repository.js +25 -0
  1107. package/dist/src/web-ui/local-runtime/setup-embedding-service.js +2 -0
  1108. package/dist/src/web-ui/local-runtime/spark-chat-admission.d.ts +7 -0
  1109. package/dist/src/web-ui/local-runtime/spark-chat-admission.js +37 -0
  1110. package/dist/src/web-ui/local-runtime/spark-chat-configuration.d.ts +8 -0
  1111. package/dist/src/web-ui/local-runtime/spark-chat-configuration.js +16 -0
  1112. package/dist/src/web-ui/local-runtime/spark-chat-handoff.d.ts +4 -0
  1113. package/dist/src/web-ui/local-runtime/spark-chat-handoff.js +84 -0
  1114. package/dist/src/web-ui/local-runtime/spark-chat-routes.d.ts +19 -0
  1115. package/dist/src/web-ui/local-runtime/spark-chat-routes.js +63 -0
  1116. package/dist/src/web-ui/local-runtime-backend.d.ts +4 -0
  1117. package/dist/src/web-ui/local-runtime-backend.js +3 -0
  1118. package/dist/src/web-ui/notifications/automation-event-projection.d.ts +3 -0
  1119. package/dist/src/web-ui/notifications/automation-event-projection.js +57 -0
  1120. package/dist/src/web-ui/notifications/contracts.d.ts +20 -5
  1121. package/dist/src/web-ui/notifications/contracts.js +7 -1
  1122. package/dist/src/web-ui/notifications/conversation-source.d.ts +6 -0
  1123. package/dist/src/web-ui/notifications/conversation-source.js +26 -0
  1124. package/dist/src/web-ui/notifications/event-fields.d.ts +3 -0
  1125. package/dist/src/web-ui/notifications/event-fields.js +12 -0
  1126. package/dist/src/web-ui/notifications/event-projection.d.ts +2 -1
  1127. package/dist/src/web-ui/notifications/event-projection.js +22 -20
  1128. package/dist/src/web-ui/notifications/service.js +33 -2
  1129. package/dist/src/web-ui/notifications/storage-schema.js +118 -21
  1130. package/dist/src/web-ui/plugin-capability-selection.js +4 -1
  1131. package/dist/src/web-ui/plugin-configuration-input.d.ts +12 -0
  1132. package/dist/src/web-ui/plugin-configuration-input.js +68 -0
  1133. package/dist/src/web-ui/plugin-configuration-retained-secrets.d.ts +9 -0
  1134. package/dist/src/web-ui/plugin-configuration-retained-secrets.js +48 -0
  1135. package/dist/src/web-ui/plugin-configuration-service.d.ts +52 -0
  1136. package/dist/src/web-ui/plugin-configuration-service.js +66 -0
  1137. package/dist/src/web-ui/plugin-configuration-view.d.ts +25 -0
  1138. package/dist/src/web-ui/plugin-configuration-view.js +45 -0
  1139. package/dist/src/web-ui/plugin-disabled-selection.d.ts +7 -0
  1140. package/dist/src/web-ui/plugin-disabled-selection.js +17 -0
  1141. package/dist/src/web-ui/plugin-management-catalog.d.ts +3 -1
  1142. package/dist/src/web-ui/plugin-management-catalog.js +11 -1
  1143. package/dist/src/web-ui/plugin-management-selection.js +22 -9
  1144. package/dist/src/web-ui/plugin-management-service.d.ts +5 -1
  1145. package/dist/src/web-ui/plugin-management-service.js +11 -7
  1146. package/dist/src/web-ui/plugin-removal-error.d.ts +7 -0
  1147. package/dist/src/web-ui/plugin-removal-error.js +16 -0
  1148. package/dist/src/web-ui/plugin-removal-service.d.ts +30 -0
  1149. package/dist/src/web-ui/plugin-removal-service.js +109 -0
  1150. package/dist/src/web-ui/runtime-setup-gateway.d.ts +6 -2
  1151. package/dist/src/web-ui/runtime-setup-gateway.js +30 -10
  1152. package/dist/src/web-ui/server.js +7 -3
  1153. package/dist/src/web-ui/session-read-state/overview.d.ts +42 -0
  1154. package/dist/src/web-ui/session-read-state/overview.js +16 -0
  1155. package/dist/src/web-ui/session-read-state/pagination.d.ts +15 -0
  1156. package/dist/src/web-ui/session-read-state/pagination.js +42 -0
  1157. package/dist/src/web-ui/session-read-state/projection.d.ts +4 -3
  1158. package/dist/src/web-ui/session-read-state/service.d.ts +246 -14
  1159. package/dist/src/web-ui/session-read-state/service.js +38 -18
  1160. package/dist/src/web-ui/session-read-state/store.d.ts +2 -0
  1161. package/dist/src/web-ui/session-read-state/store.js +7 -0
  1162. package/dist/src/web-ui/session-read-state/visible-messages.d.ts +30 -0
  1163. package/dist/src/web-ui/session-read-state/visible-messages.js +119 -0
  1164. package/dist/src/web-ui/system-host-service.d.ts +4 -1
  1165. package/dist/src/web-ui/system-host-service.js +14 -3
  1166. package/dist/src/web-ui/system-host-setup/companion-linux.js +1 -1
  1167. package/dist/src/web-ui/system-host-setup/installer-contract.d.ts +1 -1
  1168. package/dist/src/web-ui/system-host-setup/installer-contract.js +2 -2
  1169. package/dist/src/web-ui/system-host-setup/installers.js +0 -7
  1170. package/dist/src/web-ui/system-host-setup/local-connection.d.ts +4 -1
  1171. package/dist/src/web-ui/system-host-setup/local-connection.js +10 -17
  1172. package/dist/src/web-ui/system-host-setup/local-request-authority.d.ts +3 -0
  1173. package/dist/src/web-ui/system-host-setup/local-request-authority.js +15 -0
  1174. package/dist/src/web-ui/system-host-setup/local-setup-availability.js +2 -12
  1175. package/dist/src/web-ui/system-host-setup/native-permission-route.d.ts +26 -0
  1176. package/dist/src/web-ui/system-host-setup/native-permission-route.js +96 -0
  1177. package/dist/src/web-ui/system-host-setup/permission-route.d.ts +13 -0
  1178. package/dist/src/web-ui/system-host-setup/permission-route.js +102 -0
  1179. package/dist/src/web-ui/system-host-setup/routes.d.ts +2 -0
  1180. package/dist/src/web-ui/system-host-setup/routes.js +32 -9
  1181. package/dist/src/web-ui/system-host-setup/setup-mutation.d.ts +9 -0
  1182. package/dist/src/web-ui/system-host-setup/setup-mutation.js +27 -0
  1183. package/dist/src/web-ui/system-host-setup/windows-store-route.d.ts +13 -0
  1184. package/dist/src/web-ui/system-host-setup/windows-store-route.js +68 -0
  1185. package/docs/configuration.md +46 -0
  1186. package/docs/installation.md +87 -34
  1187. package/docs/plugins.md +218 -13
  1188. package/docs/projects-and-full-plus.md +2 -6
  1189. package/docs/runtime-library.md +0 -1
  1190. package/docs/runtime-public-contracts.md +7 -2
  1191. package/docs/tool-execution-result-evidence-contract.md +11 -4
  1192. package/docs/windows-companion-store.md +127 -0
  1193. package/package.json +3 -3
  1194. package/plugins/capability-brief/src/index.cjs +85 -37
  1195. package/plugins/code-outline/source/index.ts +7 -2
  1196. package/plugins/code-outline/src/index.cjs +91 -39
  1197. package/plugins/document-reader/plugin.json +19 -3
  1198. package/plugins/document-reader/skills/document_reader_skill/SKILL.md +6 -6
  1199. package/plugins/document-reader/source/source-resolution.ts +1 -1
  1200. package/plugins/document-reader/src/index.cjs +86 -38
  1201. package/plugins/exec/plugin.json +6 -3
  1202. package/plugins/exec/source/handlers.ts +78 -20
  1203. package/plugins/exec/source/output-contracts.ts +45 -0
  1204. package/plugins/exec/source/output-files.ts +161 -0
  1205. package/plugins/exec/source/output-maintenance.ts +60 -0
  1206. package/plugins/exec/source/output-range-reader.ts +97 -0
  1207. package/plugins/exec/source/output-retention.ts +34 -0
  1208. package/plugins/exec/source/output-snapshot.ts +54 -0
  1209. package/plugins/exec/source/output-store.ts +182 -0
  1210. package/plugins/exec/source/output-utf8-boundary.ts +14 -0
  1211. package/plugins/exec/source/output-writer.ts +131 -0
  1212. package/plugins/exec/source/process-manager.ts +142 -70
  1213. package/plugins/exec/source/process-output-buffer.ts +13 -18
  1214. package/plugins/exec/source/process-output.ts +158 -0
  1215. package/plugins/exec/source/request-resources.ts +28 -12
  1216. package/plugins/exec/source/result-presentation.ts +39 -39
  1217. package/plugins/exec/source/retained-output-failure.ts +51 -0
  1218. package/plugins/exec/source/settings.ts +9 -10
  1219. package/plugins/exec/source/terminal-delivery.ts +49 -0
  1220. package/plugins/exec/source/types.ts +12 -1
  1221. package/plugins/exec/src/index.cjs +1112 -188
  1222. package/plugins/filesystem/plugin.json +7 -5
  1223. package/plugins/filesystem/skills/read_file_skill/SKILL.md +1 -1
  1224. package/plugins/filesystem/src/index.cjs +85 -37
  1225. package/plugins/json-inspector/source/index.ts +7 -2
  1226. package/plugins/json-inspector/src/index.cjs +91 -39
  1227. package/plugins/local-search/plugin.json +1 -0
  1228. package/plugins/local-search/source/index.ts +9 -4
  1229. package/plugins/local-search/src/index.cjs +93 -41
  1230. package/plugins/memory/src/index.cjs +85 -37
  1231. package/plugins/project-orientation/source/index.ts +9 -4
  1232. package/plugins/project-orientation/src/index.cjs +93 -41
  1233. package/plugins/system/README.md +43 -3
  1234. package/plugins/system/plugin.json +7 -2
  1235. package/plugins/system/source/companion-command-output.ts +82 -0
  1236. package/plugins/system/source/computer/observation-output.ts +1 -1
  1237. package/plugins/system/source/host-dispatch.ts +4 -0
  1238. package/plugins/system/source/index.ts +11 -5
  1239. package/plugins/system/source/local-command-output.ts +61 -0
  1240. package/plugins/system/source/request-system-modules.ts +2 -0
  1241. package/plugins/system/src/index.cjs +562 -82
  1242. package/plugins/system-probe/source/index.ts +7 -2
  1243. package/plugins/system-probe/src/index.cjs +91 -39
  1244. package/plugins/web/README.md +11 -2
  1245. package/plugins/web/plugin.json +4 -0
  1246. package/plugins/web/source/plugin.ts +5 -3
  1247. package/plugins/web/source/research.ts +7 -7
  1248. package/plugins/web/src/index.cjs +96 -43
  1249. package/runtime.config.schema.json +25 -1
  1250. package/src/runtime/README.md +112 -13
  1251. package/src/runtime/scheduler/README.md +63 -0
  1252. package/dist/src/web-ui/app/components/passive-learning/proposal-notifications.js +0 -106
  1253. package/dist/src/web-ui/app/components/passive-learning/proposal-read-state.js +0 -23
  1254. package/dist/src/web-ui/app/components/passive-learning/proposal-view.js +0 -23
  1255. package/dist/src/web-ui/app/components/spark-conversation-actions.js +0 -62
  1256. package/dist/src/web-ui/app/services/spark-conversation-preferences.js +0 -27
  1257. package/dist/src/web-ui/app/styles/29-spark-conversation.css +0 -19
  1258. package/dist/src/web-ui/system-host-setup/companion-windows.d.ts +0 -2
  1259. package/dist/src/web-ui/system-host-setup/companion-windows.js +0 -108
  1260. package/docs/publishing.md +0 -167
package/docs/plugins.md CHANGED
@@ -16,6 +16,9 @@ the same physical directory, the catalog is discovered only once.
16
16
  Open **Plugins** to see installed manifests, capability counts,
17
17
  and enabled, partially enabled or disabled selections. Switches save the selected
18
18
  plugin's configuration while preserving capability-specific allow/deny rules.
19
+ Whole-plugin switches use `plugins.disabledPluginIds`, an exact list of plugin
20
+ IDs independent of capability names and qualified selectors. The list does not
21
+ interpret wildcards; legacy `allow` and `deny` rules keep their existing meaning.
19
22
  Choose **Manage tools** on a plugin to manage its declared tools inside the same card.
20
23
  The card keeps its size; the tool list scrolls when needed. Use **Back** or Escape
21
24
  to return to the plugin overview. For example, disabling filesystem.read_file
@@ -26,14 +29,164 @@ tools switched off.
26
29
  Global, parent-plugin and broad tool deny rules remain explicit blockers.
27
30
  A child switch does not silently remove those rules or enable sibling tools.
28
31
 
32
+ Install, configuration saves, enable/disable and Remove require every owning Runtime to be idle.
33
+ While a conversation or Job is running, these actions return a clear message
34
+ without saving the requested change. Open but idle conversations do not block
35
+ changes; browsing and reviewing repositories remain available. If another process
36
+ owns an environment, use the owning Web UI so its activity can be verified.
37
+
29
38
  Choose **Apply changes** to activate saved settings. The Web process replaces
30
39
  only its own idle environments and preserves session and Job files. If any
31
40
  environment is working, or another process owns it, changes remain saved and
32
41
  the UI explains why they cannot yet be applied. Saving a switch alone does not
33
42
  change tools available to an already running agent.
34
43
 
35
- This screen manages packages already installed on disk; it does not install
36
- plugins from a marketplace.
44
+ ## Configure Plugin Values
45
+
46
+ Choose **Configure** on an installed plugin, or use the same form during its
47
+ installation review. Fields come from the existing `settings.defaults` and
48
+ `secrets` declarations. Strings, numbers and booleans use ordinary controls;
49
+ objects, arrays and null defaults use JSON. The host checks declared setting
50
+ names and top-level default types. A null default supplies no type information;
51
+ semantic checks such as URL validity remain the plugin's responsibility.
52
+ The form shows whether each setting uses the plugin default or a local value.
53
+ Saving credentials alone leaves inherited defaults unchanged. Editing a setting
54
+ creates a local override, even when its value equals today's default; **Use plugin
55
+ default** removes that override when saved. Existing saved values stay local until
56
+ explicitly reset, so no upgrade automatically rewrites a user's configuration.
57
+ No manifest schema or SDK changes are required. If an upgraded plugin changes a
58
+ setting's default type, an incompatible retained value blocks loading with an
59
+ explicit configuration error. Configure remains available to correct the value;
60
+ the host does not silently replace it with a default.
61
+
62
+ **Save changes** persists values locally; **Apply changes** loads them into new
63
+ idle Runtime owners. Existing owners retain their loaded values, including when
64
+ activation fails and restores the previous configuration. GET returns settings
65
+ and credential-presence flags, never secret values. Passwords remain in their
66
+ mounted controls until submitted, and are cleared after submission.
67
+
68
+ Values are shared across environments of the same consumer root and are stored
69
+ in `<consumer-root>/.runtime/plugin-configuration.json`, outside plugin packages,
70
+ with owner-only file permissions. On POSIX, an existing file with any group or
71
+ other-user permission is rejected before its contents are read. Restore its
72
+ permissions with `chmod 600 .runtime/plugin-configuration.json` from the installation
73
+ root; the host does not change permissions automatically. They are local plaintext
74
+ configuration, not an
75
+ encrypted vault. This file must not be committed, published, or shared with a
76
+ plugin repository. The existing `.runtime/` exclusion also keeps it out of Git
77
+ and packages. Settings override declared defaults; undeclared settings are not
78
+ passed to plugins. A locally configured secret is bound to its declared name
79
+ and environment-variable name and is delivered through `context.secrets.get`.
80
+ Without a local override, the existing process environment remains the source.
81
+ Saving plugin values does not write `.env` or change `process.env`. Browser revision
82
+ tokens use a private process key rather than an unkeyed digest of secret-bearing
83
+ content. Reload an open form after restarting its Web UI process.
84
+
85
+ Keys removed from the current manifest, or whose environment binding changed,
86
+ appear under **Keys no longer used by this plugin** without exposing their values.
87
+ They remain saved until the user selects **Delete saved key** and saves. Ordinary
88
+ settings edits do not delete them. A changed binding under the same key name
89
+ requires explicitly deleting the old saved key before setting or clearing its
90
+ replacement; both choices can be submitted in one save. Configure remains
91
+ available for these keys even when the plugin has no current settings or secrets.
92
+
93
+ For each secret, keep the current value, replace it, or explicitly clear it.
94
+ Clear suppresses an inherited value for this plugin without deleting a shared
95
+ environment variable. Clearing a required secret prevents the plugin from
96
+ loading on the next Apply until the key is configured again. Remove retains
97
+ local settings and secrets; a later installation review shows the retained
98
+ settings and presence flags. Required secrets are checked before installation
99
+ commits, and failed selection saves roll back the local configuration and package.
100
+
101
+ ## Install Community Plugins
102
+
103
+ The **Installed** tab manages the existing catalog. **Discover** links to the
104
+ [ABot Marketplace](https://abot-ai.com/marketplace/) and installs public GitHub packages independently of that directory.
105
+ The Marketplace is a directory of community-owned repositories; listing approval
106
+ does not grant a repository permission to run on a user's machine.
107
+
108
+ Paste a repository URL in **Discover**, optionally choosing a branch, tag or
109
+ commit and a folder inside the repository. **Review plugin** resolves the source
110
+ to an exact commit, validates the manifest and its declared files without
111
+ executing plugin code, and displays its tools and configuration form.
112
+ Fill in required secrets before confirming installation.
113
+ **Install and enable** downloads the same commit, checks the reviewed content
114
+ digest, and installs it at `<consumer-root>/plugins/<manifest.name>`. Existing
115
+ plugin IDs and capability IDs are rejected; this flow never replaces a plugin.
116
+ Package publication and selection saving share the configuration lock with Apply;
117
+ a failed save removes the uncommitted package before Apply can discover it.
118
+ The normal configuration controls and global restrictions still apply.
119
+ The review offers **Install and enable** at both ends. After installation, the
120
+ UI returns to **Installed** with a status message. Choose **Apply changes** to
121
+ load the plugin into the Runtime.
122
+
123
+ Publishers must commit a complete package: `plugin.json`, its built CommonJS
124
+ `.cjs` entrypoint, referenced skills and all required assets. Bundle dependencies
125
+ that are not supplied by the public plugin SDK. Installation does not execute
126
+ `npm install`, build commands, lifecycle scripts or repository code. Public HTTPS
127
+ repositories on `github.com` are supported; private repositories, updates and
128
+ Studio packages are outside this first installation flow. Repository ZIPs are
129
+ limited to 25 MiB and 2,000 entries, with at most 16 MiB per extracted file and
130
+ 64 MiB total. Symlinks, traversal and non-portable filenames are rejected.
131
+
132
+ ### Install In ABot Links
133
+
134
+ Computer Access setup registers the `abot:` URL scheme on Windows, macOS and
135
+ Linux desktops. Existing installations can use **Update** in Computer Access
136
+ to install Companion release 12 and register links while keeping their pairing.
137
+ A website can render an ordinary link using this contract:
138
+
139
+ ```js
140
+ const link = new URL("abot://install");
141
+ link.searchParams.set("kind", "plugin");
142
+ link.searchParams.set("repo", "https://github.com/owner/plugin");
143
+ link.searchParams.set("ref", "v1.0.0"); // optional; a commit is recommended
144
+ link.searchParams.set("path", "plugins/example"); // optional repository folder
145
+ installAnchor.href = link.toString();
146
+ ```
147
+
148
+ Clicking the link opens **Discover** in the Runtime saved in the local Computer
149
+ Access pairing, with the source ready for review. A link cannot choose another
150
+ Runtime address or bypass local installation confirmation. The browser may ask
151
+ to open ABot. Without Computer Access, users can paste the same repository URL.
152
+ Companion disconnect/uninstall removes its owned protocol registration.
153
+
154
+ The local API uses `POST /runtime/plugins/inspect` with
155
+ `{ repository, ref?, path? }`, returning `{ ok, review }`.
156
+ Installation uses `POST /runtime/plugins/install` with
157
+ `{ source: review.source, digest: review.digest }`. Both require same-origin
158
+ JSON requests and completed Runtime setup. These APIs operate on the configured
159
+ consumer root and configuration file; they do not depend on the Marketplace.
160
+
161
+ ## Remove Community Plugins
162
+
163
+ **Remove** is available in the ongoing Plugins screen for packages installed by
164
+ this GitHub flow. After confirmation, it saves a disable, applies configuration
165
+ through the existing idle-owner checks, and only then deletes the installed
166
+ folder. Built-in plugins and manually copied folders without an installation
167
+ receipt do not offer Remove. Removal adds only the target's exact ID to
168
+ `plugins.disabledPluginIds`, so names shared with other tools or qualified
169
+ selectors cannot change another plugin's selection.
170
+
171
+ If work starts after the disable was saved but before Apply, the files remain.
172
+ Finish the active work, then choose **Remove** again. A failed Apply or any
173
+ concurrent configuration change also prevents deletion. Removal verifies the
174
+ moved directory before deleting it and retires its cached CommonJS modules so
175
+ a later installation loads the new entrypoint and package-local dependencies.
176
+ Selection rules remain in the configuration so removal cannot widen another
177
+ plugin's allow policy. Installing the same plugin again clears its exact disabled
178
+ ID and preserves other disabled IDs and capability-specific deny rules. Existing
179
+ qualified denies are not inferred to be removal-generated; review such legacy
180
+ rules explicitly in Advanced settings if they still disable the tools.
181
+
182
+ `POST /runtime/plugins/remove` accepts `{ pluginId }`, with the same origin,
183
+ JSON and completed-setup requirements as installation. It returns `removed`,
184
+ `activation`, a status message and the refreshed plugin snapshot. This removes
185
+ the installed plugin folder, including data the plugin kept inside it; files
186
+ stored elsewhere are retained. If Apply succeeds but a later removal check fails,
187
+ the error retains its HTTP status and code and includes `activation` with status
188
+ `ready`. The UI refreshes the active environments; `config_changed` still marks
189
+ the newer saved configuration as pending activation.
37
190
 
38
191
  ## Package Shape
39
192
 
@@ -143,6 +296,16 @@ input, effect, and approval. Optional capability metadata such as client event
143
296
  presentation, payload authoring, development roles, and selection grounding
144
297
  belongs here as well—not in runtime orchestration.
145
298
 
299
+ An operation may declare `outputChannels` alongside `summary`, for example
300
+ `{"text":"content","data":"metadata"}`. Both fields are required when declared:
301
+ `content` can carry substantive output (possibly bounded or summarized),
302
+ `metadata` contains only identifiers/status/counts/receipts, and `conditional`
303
+ depends on the operation inputs. Omission means unknown, not metadata. This
304
+ passive declaration describes the saved Studio channels, not every field in a
305
+ chat tool result; it changes no execution or binding behavior. Only selected
306
+ Studio `prepare_draft` operations expose it to models; ordinary tool summaries
307
+ and discovery stay concise. Whole Data bindings do not need field pointers.
308
+
146
309
  A plugin declares sensitive operations with `approval: "always"` in its
147
310
  manifest, as the bundled EXEC and SYSTEM plugins do. Apply that policy to every
148
311
  operation when the whole plugin is sensitive. The generic approval boundary
@@ -307,10 +470,17 @@ explicitly, provide the required string `output` and boolean
307
470
  `producedNewInformation`, and place structured operation facts needed by later
308
471
  steps in `data`. JSON-safe here means primitives, plain objects, and dense
309
472
  arrays with finite numbers: no functions, symbols, accessors, cycles, class
310
- instances, or other non-plain prototypes. The complete normalized result must
311
- fit the Runtime's 256 KiB serialized producer boundary. A plugin must return an
312
- explicit bounded or paginated result, or an explicit failure; neither the
313
- plugin nor the Runtime may silently remove structured facts.
473
+ instances, or other non-plain prototypes. Results use a 256 KiB serialized
474
+ envelope boundary. A context-aware host exposes `context.resultBudget`; pass it
475
+ to `deliverPluginTextResult(result, ["stdout", "stderr"], context.resultBudget)`
476
+ to hand exact large text to the existing context manager. The helper keeps
477
+ ordinary results unchanged. When needed, it declares `contextTextFields` on
478
+ the original result; metadata and references still count toward the byte limit.
479
+ Only `output`, `stdout`, and `stderr` are eligible string fields. The Runtime
480
+ retains their full content and applies token admission and compaction before
481
+ model invocation. This does not manage the plugin's output storage or RAM.
482
+ Hosts without this contract and plugins that do not opt in retain their
483
+ existing result limit. Neither plugin nor Runtime may silently remove facts.
314
484
 
315
485
  `ToolRegistry` adds the selected tool identity and creates the canonical
316
486
  `ToolExecutionResult`. The Runtime validates and persists that complete result,
@@ -322,6 +492,39 @@ they must not include secrets and they never act as instructions, new user
322
492
  intent, or proof that the whole request completed. See
323
493
  [tool-execution-result-evidence-contract.md](tool-execution-result-evidence-contract.md).
324
494
 
495
+ ### EXEC output storage
496
+
497
+ EXEC captures stdout and stderr in private files under its injected `stateDir`.
498
+ Pipe backpressure bounds queued capture data; the plugin does not accumulate a
499
+ process's entire output in RAM while it runs. Disk writes use 64 KiB chunks, an
500
+ I/O buffer size independent of the model context budget. A storage failure stops
501
+ the producer and returns its process ID, status, cursor and committed byte
502
+ counts; it never claims that incomplete output was successfully delivered.
503
+
504
+ Delivery materializes the pending observation into the existing text-result
505
+ contract. This still requires memory proportional to that observation; this
506
+ contract is not streaming ingestion by the Runtime. The core owns token
507
+ admission and compaction. It does not read EXEC file paths or manage its storage.
508
+
509
+ Offsets advance only after the result fits the host's delivery contract. ASK
510
+ state stores plugin-owned, session-bound disk receipts with range hashes, rather
511
+ than copying the full text. Previously saved inline receipts remain readable.
512
+ `outputRetentionMs` defaults to 604,800,000 (seven days) from capture closure,
513
+ including unaccepted output and receipts saved for approval continuation. Reading,
514
+ restoring or accepting a receipt does not extend retention. Active writers and
515
+ readers prevent deletion until they finish. Interrupted and legacy captures
516
+ without a closure timestamp expire using their last captured-file modification.
517
+
518
+ The plugin sweeps existing storage when loaded and periodically while files
519
+ remain (at most one hour between sweeps). A stopped runtime resumes cleanup when
520
+ the plugin loads again. Expired output returns an explicit tool failure with the
521
+ process ID; it never replays a command. Retention bounds age, not total disk usage.
522
+ Preparation does not create storage directories, and cleanup belongs to EXEC.
523
+
524
+ Concurrent terminal observations reserve one delivery before leaving the process
525
+ transition. Rejected presentation releases the reservation without consuming any
526
+ output. The same rule applies to restored terminal receipts.
527
+
325
528
  ## Filesystem Roots
326
529
 
327
530
  `environment.paths.agentWorkDir` is the configured primary work root. Plugins
@@ -406,13 +609,15 @@ searches use procfs; macOS searches inherit the verified current directory of
406
609
  an isolated Node child. File content searches use the held input descriptor on
407
610
  both platforms. A search fails closed when its authority cannot be established.
408
611
 
409
- All output and structured data must be bounded at the producer. The shared SDK
410
- reserves wrapper headroom by rejecting plugin results above 128 KiB before they
411
- reach the Runtime's 256 KiB canonical settlement boundary. Bounds include
412
- filesystem iteration, file/archive input, collection size, individual labels,
413
- and rendered text. A truncated success reports machine-readable truncation
414
- metadata; an operation that cannot produce a truthful bounded result fails
415
- explicitly.
612
+ Plugins own resource bounds such as filesystem iteration, file/archive input,
613
+ collection size, and buffered process output. Passing `context.resultBudget`
614
+ lets the shared SDK use the Runtime's final envelope accounting, including
615
+ canonical metadata and target references. Without it, the SDK measures the
616
+ plugin object and the Runtime checks the canonical envelope separately.
617
+ Declared context text is preserved separately from that byte
618
+ accounting and remains subject to the complete model-input budget. An explicit
619
+ truncated success reports machine-readable truncation metadata; an operation
620
+ that cannot produce a truthful result fails explicitly.
416
621
 
417
622
  The bundled `exec` plugin provides trusted, non-interactive `/bin/bash` execution
418
623
  on Linux and macOS. Execute, wait and cancel each declare `approval="always"`:
@@ -206,12 +206,8 @@ system action. Cancellation or revocation attempts to stop an in-flight command,
206
206
  but effects already performed are not rolled back. If a connection is lost during
207
207
  execution, inspect the actual host state before trying the action again.
208
208
 
209
- ## Validation status
209
+ ## Platform validation
210
210
 
211
- Implementation and validation progress are recorded in the task journal. Native
212
- Mac QA is performed separately with the owner; mocked platform tests are not a
213
- claim that an actual Mac was tested. No release or installation update is implied
214
- by changes in a development worktree.
215
211
  Native Windows/macOS companion installation, login startup and visible-application
216
- QA remain separate checks on the real desktop systems; Linux protocol and package
212
+ behavior require checks on the target systems; Linux protocol and package
217
213
  tests do not establish those results.
@@ -13,7 +13,6 @@ For invariant coverage, see
13
13
  [runtime-invariant-coverage.md](runtime-invariant-coverage.md).
14
14
  For bridge/runtime ownership, see [bridge-compatibility.md](bridge-compatibility.md).
15
15
  For current limitations, see [known-limitations.md](known-limitations.md).
16
- For package and publication gates, see [publishing.md](publishing.md).
17
16
 
18
17
  ## Basic Composition
19
18
 
@@ -248,8 +248,13 @@ the reported result, not overall completion.
248
248
 
249
249
  The complete result is a mandatory canonical evidence object. Before capability
250
250
  settlement, the Runtime validates that it contains only plain JSON-safe data and
251
- fits the 256 KiB serialized producer boundary. Functions, symbols, accessors,
252
- cycles, non-plain prototypes, non-finite numbers, and oversized results fail
251
+ fits the 256 KiB serialized envelope boundary. Registered results may declare
252
+ `contextTextFields` (`output`, `stdout`, or `stderr`) whose exact text bodies are
253
+ budgeted by the existing model-context admission and compaction path. The text
254
+ is retained in the same canonical fields; metadata remains byte-bounded.
255
+ Results without this declaration retain the complete-result byte limit.
256
+ Functions, symbols, accessors, cycles, non-plain prototypes, non-finite numbers,
257
+ and oversized metadata fail
253
258
  explicitly. The Runtime does not silently truncate, partially parse, or discard
254
259
  structured fields.
255
260
 
@@ -77,10 +77,17 @@ The Runtime validates the result before ledger settlement:
77
77
  - no functions, symbols, accessors, cycles, or non-plain prototypes;
78
78
  - the registered result must match the public `ToolExecutionResult` fields;
79
79
  - references remain bounded by the RoleCall reference contract;
80
- - one serialized canonical adapter result is limited to 256 KiB.
81
-
82
- The 256 KiB limit is a hard producer boundary, not a model-context truncation
83
- rule. An over-limit result becomes an explicit technical capability failure.
80
+ - the serialized canonical envelope is limited to 256 KiB. A registered
81
+ result may declare `contextTextFields` from `output`, `stdout`, and `stderr`;
82
+ those exact string bodies use the model-context budget instead. Field names,
83
+ declarations, references, and all other result data still count toward 256 KiB.
84
+
85
+ The 256 KiB limit is a producer metadata boundary, not a model-context truncation
86
+ rule. Without a text declaration it applies to the complete result as before.
87
+ Declared text remains in the canonical result and follows the same provenance,
88
+ consumer projection, token measurement, and semantic compaction as other tool
89
+ evidence. The declaration grants no action or completion authority. Oversized
90
+ metadata still becomes an explicit technical capability failure.
84
91
  The Runtime never sends a syntactically valid but incomplete object and never
85
92
  pretends that omitted structured facts were observed.
86
93
 
@@ -0,0 +1,127 @@
1
+ # Windows Companion Store delivery
2
+
3
+ ## Current status
4
+
5
+ **ABot AI Companion** is available from
6
+ [Microsoft Store](https://apps.microsoft.com/detail/9PK2FDQQLQS9), product ID
7
+ `9PK2FDQQLQS9`. Runtime 1.7.0 provides the guided connection flow described below.
8
+
9
+ The Store app and Runtime have separate releases.
10
+
11
+ ## Connection experience
12
+
13
+ The Web UI links to the Store for one installation. The user returns to ABot,
14
+ requests a connection link and explicitly opens Companion. Companion shows the
15
+ Runtime address and asks for confirmation before pairing. Users who already
16
+ installed Companion go directly to connecting. The Web UI confirms the live
17
+ connection after pairing.
18
+
19
+ Before **Allow connection** is enabled, users must select an initially unchecked
20
+ acknowledgment of the described computer access and data sharing. The dialog
21
+ links to the [software terms](https://abot-ai.com/terms/#software) and
22
+ [privacy policy](https://abot-ai.com/privacy/#software); opening either link does
23
+ not grant consent. Task permissions and optional SPARK controls remain separate.
24
+ Disconnecting does not erase data already sent to the Runtime or other services.
25
+
26
+ For a paired computer that is offline, **Open Companion** uses the fixed
27
+ `abot-companion://open` activation without creating an invitation. It opens the
28
+ saved connection or explains how to re-pair when local credentials are missing.
29
+ **Set up again** requires confirmation, revokes the old server pairing using
30
+ the existing endpoint, then requests a fresh invitation. An upgrade invitation
31
+ never substitutes for a new pairing grant when local credentials are missing.
32
+ After explicit consent, a fresh connection consumes the new grant even when an
33
+ old local credential remains. The previous owned process is stopped before that
34
+ exchange. A failed exchange preserves the saved credential but does not restart
35
+ the previous process;
36
+ an upgrade continues to use the matching saved host identity.
37
+
38
+ Every user installs the same package. The personalized, expiring invitation is
39
+ sent through the `abot-companion:` protocol after installation. It carries the
40
+ existing pairing or upgrade grant, not a second authentication scheme. The Web UI
41
+ keeps it only in the current surface, clears it after connection or expiry, and
42
+ does not save it to browser storage. Do not put connection links in logs, support
43
+ reports or screenshots.
44
+
45
+ The current invitation contract accepts a local HTTP loopback Runtime address.
46
+ Docker must publish its Web UI port on the Windows host's loopback; other setups
47
+ must expose the Runtime through an appropriate local forward. Opening ABot on a
48
+ different computer does not make that remote Runtime address a valid invitation.
49
+
50
+ ## Shared components
51
+
52
+ | Owner | Responsibility |
53
+ | --- | --- |
54
+ | Shared Web UI connection manager | Connection status, readiness polling, unpairing and onboarding lifecycle. |
55
+ | Windows Store UI module and route | Store link, temporary invitation and explicit launch. The route uses the existing pairing store. |
56
+ | Windows desktop shell | Display connection status and consent, activate links and call the bundled Node entry. |
57
+ | Shared Companion and CLI lifecycle | Pairing credentials, command and desktop capabilities, connection protocol, reconnect behavior and permission checks. |
58
+ | Windows Store lifecycle adapter and MSIX package | Windows package activation, startup integration, notification identity and package updates. |
59
+
60
+ The desktop shell does not implement another pairing store or copy the Companion
61
+ protocol. Shared fixes belong in the shared Companion implementation; Windows
62
+ presentation and package integration stay in the Windows adapter. The package
63
+ contains the runtime dependencies needed for connection.
64
+
65
+ The Store integration changes Windows delivery. Native macOS connection, manual
66
+ Mac connection, Linux setup and WSL command routing keep their existing owners
67
+ and behavior. A WSL Runtime can use the Windows desktop Companion without a WSL
68
+ restart.
69
+
70
+ ## Version and update ownership
71
+
72
+ The **MSIX package version** orders Windows package updates. The **Companion
73
+ release version**, owned by `src/computer-access/companion/release-version.ts`,
74
+ describes the Companion behavior expected by the Runtime. These are different
75
+ values: a packaging or shell-only rebuild can require a newer MSIX version
76
+ without changing the Companion release contract.
77
+
78
+ If the Runtime requires a Companion release newer than the installed package,
79
+ the invitation is rejected with a request to update through Microsoft Store.
80
+ The Store supplies the replacement package; the Runtime does not overwrite
81
+ Store-owned executable files. Store updates are intended to preserve the user's
82
+ saved pairing.
83
+
84
+ The Store identity is owned by
85
+ `src/computer-access/companion/windows-store/identity.ts`. Packaging and the
86
+ Companion must use this same identity. Do not create another copy of protocol
87
+ version or package identity policy in the Web UI or desktop shell.
88
+
89
+ ## Build from source
90
+
91
+ Build Companion from this repository.
92
+ The build uses the pinned Windows Node.js distributions, checking the archive
93
+ hash before extracting only `node.exe` and its license. Supply an explicit
94
+ four-part Store version with a zero last component.
95
+
96
+ ```sh
97
+ npx tsx scripts/build-windows-companion-store.ts \
98
+ --output-dir <new-layout-directory> \
99
+ --node-archive <verified-node-windows-zip> \
100
+ --version <major.minor.patch.0> --architecture x64
101
+ ```
102
+
103
+ Then, in Windows PowerShell, use the .NET Framework compiler and an authentic
104
+ Microsoft Windows SDK `MakeAppx.exe`:
105
+
106
+ ```powershell
107
+ ./scripts/build-windows-companion-store.ps1 `
108
+ -LayoutDirectory <layout-directory> `
109
+ -MakeAppxPath <local-windows-sdk-makeappx-path> `
110
+ -OutputPath <new-msix-path>
111
+ ```
112
+
113
+ Keep the SDK tools on a local Windows volume. Package inputs and output can
114
+ remain in the WSL checkout. The output is unsigned and is not installed,
115
+ registered, signed or submitted by these scripts.
116
+
117
+ ## Package contents
118
+
119
+ The public source includes the Windows shell and packaging scripts. The MSIX
120
+ contains the compiled shell, bundled shared Companion, pinned Node executable,
121
+ licenses, icons and Windows manifest. The Store package and Node executable are
122
+ not part of the Runtime npm package.
123
+
124
+ Pairing invitations are generated when the user requests a connection. They are
125
+ never baked into the Store package. Local configurations, API keys, saved pairing
126
+ and logs must stay outside the Store package. Store product and publisher identity
127
+ values are public package metadata, not authentication credentials.
package/package.json CHANGED
@@ -95,11 +95,11 @@
95
95
  "docs/bridge-compatibility.md",
96
96
  "docs/configuration.md",
97
97
  "docs/installation.md",
98
+ "docs/windows-companion-store.md",
98
99
  "docs/known-limitations.md",
99
100
  "docs/long-term-memory.md",
100
101
  "docs/plugins.md",
101
102
  "docs/projects-and-full-plus.md",
102
- "docs/publishing.md",
103
103
  "docs/running-locally.md",
104
104
  "docs/runtime-invariant-coverage.md",
105
105
  "docs/runtime-library.md",
@@ -128,7 +128,7 @@
128
128
  "plugins/system-probe/",
129
129
  "plugins/web/"
130
130
  ],
131
- "homepage": "https://github.com/Dorshitrit/abot-runtime#readme",
131
+ "homepage": "https://abot-ai.com/",
132
132
  "keywords": [
133
133
  "llm",
134
134
  "runtime",
@@ -181,5 +181,5 @@
181
181
  },
182
182
  "type": "module",
183
183
  "types": "./dist/src/runtime/index.d.ts",
184
- "version": "1.5.0"
184
+ "version": "1.7.0"
185
185
  }