@abot-ai/runtime 1.0.0 → 1.2.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 (751) hide show
  1. package/README.md +23 -6
  2. package/dist/scripts/add-runtime-model.js +4 -0
  3. package/dist/scripts/configure-long-term-memory.d.ts +6 -0
  4. package/dist/scripts/configure-long-term-memory.js +139 -0
  5. package/dist/scripts/init-runtime.js +11 -1
  6. package/dist/scripts/runtime-setup-files.d.ts +1 -0
  7. package/dist/scripts/runtime-setup-files.js +4 -0
  8. package/dist/src/capabilities/normal-invocation/contracts.d.ts +1 -0
  9. package/dist/src/capabilities/normal-invocation/validator.d.ts +5 -0
  10. package/dist/src/capabilities/normal-invocation/validator.js +35 -2
  11. package/dist/src/capabilities/tool-definition-validator/definition-fields.d.ts +7 -0
  12. package/dist/src/capabilities/tool-definition-validator/definition-fields.js +156 -0
  13. package/dist/src/capabilities/tool-definition-validator/definition-parser.d.ts +2 -0
  14. package/dist/src/capabilities/tool-definition-validator/definition-parser.js +76 -0
  15. package/dist/src/capabilities/tool-definition-validator/definition-shape.d.ts +7 -0
  16. package/dist/src/capabilities/tool-definition-validator/definition-shape.js +34 -0
  17. package/dist/src/capabilities/tool-definition-validator/event-presentation.d.ts +2 -0
  18. package/dist/src/capabilities/tool-definition-validator/event-presentation.js +97 -0
  19. package/dist/src/capabilities/tool-definition-validator/module-registry.d.ts +3 -0
  20. package/dist/src/capabilities/tool-definition-validator/module-registry.js +99 -0
  21. package/dist/src/capabilities/tool-definition-validator/payload-channel-spec.d.ts +2 -0
  22. package/dist/src/capabilities/tool-definition-validator/payload-channel-spec.js +190 -0
  23. package/dist/src/capabilities/tool-definition-validator/payload-channel-stage.d.ts +11 -0
  24. package/dist/src/capabilities/tool-definition-validator/payload-channel-stage.js +155 -0
  25. package/dist/src/capabilities/tool-definition-validator/payload-stage-conditions.d.ts +24 -0
  26. package/dist/src/capabilities/tool-definition-validator/payload-stage-conditions.js +193 -0
  27. package/dist/src/capabilities/tool-definition-validator.d.ts +2 -4
  28. package/dist/src/capabilities/tool-definition-validator.js +2 -776
  29. package/dist/src/capabilities/tool-types.d.ts +1 -1
  30. package/dist/src/cli/abot.js +11 -2
  31. package/dist/src/model-gateway/client/embeddings.d.ts +3 -0
  32. package/dist/src/model-gateway/client/embeddings.js +48 -0
  33. package/dist/src/model-gateway/client.d.ts +3 -1
  34. package/dist/src/model-gateway/client.js +5 -0
  35. package/dist/src/model-gateway/embeddings/constants.d.ts +1 -0
  36. package/dist/src/model-gateway/embeddings/constants.js +1 -0
  37. package/dist/src/model-gateway/embeddings/discovery.d.ts +10 -0
  38. package/dist/src/model-gateway/embeddings/discovery.js +39 -0
  39. package/dist/src/model-gateway/embeddings/execution.d.ts +16 -0
  40. package/dist/src/model-gateway/embeddings/execution.js +64 -0
  41. package/dist/src/model-gateway/embeddings/fingerprint.d.ts +3 -0
  42. package/dist/src/model-gateway/embeddings/fingerprint.js +36 -0
  43. package/dist/src/model-gateway/embeddings/profile.d.ts +11 -0
  44. package/dist/src/model-gateway/embeddings/profile.js +37 -0
  45. package/dist/src/model-gateway/embeddings/server-handler.d.ts +3 -0
  46. package/dist/src/model-gateway/embeddings/server-handler.js +89 -0
  47. package/dist/src/model-gateway/embeddings/validation.d.ts +7 -0
  48. package/dist/src/model-gateway/embeddings/validation.js +69 -0
  49. package/dist/src/model-gateway/index.d.ts +5 -3
  50. package/dist/src/model-gateway/index.js +3 -1
  51. package/dist/src/model-gateway/providers/contracts.d.ts +27 -1
  52. package/dist/src/model-gateway/providers/ollama/adapter.js +4 -0
  53. package/dist/src/model-gateway/providers/ollama/base-url.d.ts +1 -0
  54. package/dist/src/model-gateway/providers/ollama/base-url.js +4 -0
  55. package/dist/src/model-gateway/providers/ollama/embedding-models.d.ts +2 -0
  56. package/dist/src/model-gateway/providers/ollama/embedding-models.js +31 -0
  57. package/dist/src/model-gateway/providers/ollama/embeddings.d.ts +2 -0
  58. package/dist/src/model-gateway/providers/ollama/embeddings.js +43 -0
  59. package/dist/src/model-gateway/providers/ollama/generation-options.d.ts +1 -3
  60. package/dist/src/model-gateway/providers/ollama/generation-options.js +1 -5
  61. package/dist/src/model-gateway/providers/ollama/payload.js +0 -8
  62. package/dist/src/model-gateway/providers/ollama/request-diagnostics.js +2 -1
  63. package/dist/src/model-gateway/providers/openai/adapter.js +2 -0
  64. package/dist/src/model-gateway/providers/openai/embeddings.d.ts +2 -0
  65. package/dist/src/model-gateway/providers/openai/embeddings.js +87 -0
  66. package/dist/src/model-gateway/providers/openai/payload.js +5 -8
  67. package/dist/src/model-gateway/server/contracts.d.ts +5 -3
  68. package/dist/src/model-gateway/server/create-server.js +9 -0
  69. package/dist/src/model-gateway/server/errors.js +34 -0
  70. package/dist/src/model-gateway/server/index.d.ts +2 -0
  71. package/dist/src/model-gateway/server/index.js +2 -0
  72. package/dist/src/model-gateway/server/provider-fetch.d.ts +5 -3
  73. package/dist/src/model-gateway/server/provider-fetch.js +3 -1
  74. package/dist/src/model-gateway/server/request-body.d.ts +1 -1
  75. package/dist/src/model-gateway/server/request-body.js +1 -0
  76. package/dist/src/model-gateway/types.d.ts +39 -0
  77. package/dist/src/plugin-contract/manifest.d.ts +1 -0
  78. package/dist/src/plugin-sdk/index.d.ts +2 -0
  79. package/dist/src/plugin-sdk/index.js +2 -0
  80. package/dist/src/plugin-sdk/tool-availability-brief.d.ts +9 -0
  81. package/dist/src/plugin-sdk/tool-availability-brief.js +48 -0
  82. package/dist/src/plugin-sdk/tool-availability-overview.d.ts +9 -0
  83. package/dist/src/plugin-sdk/tool-availability-overview.js +62 -0
  84. package/dist/src/runtime/adapters/index.d.ts +4 -0
  85. package/dist/src/runtime/adapters/index.js +4 -0
  86. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.d.ts +2 -0
  87. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.js +77 -0
  88. package/dist/src/runtime/adapters/long-term-memory/file-lock/cleanup.d.ts +4 -0
  89. package/dist/src/runtime/adapters/long-term-memory/file-lock/cleanup.js +52 -0
  90. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.d.ts +31 -0
  91. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.js +17 -0
  92. package/dist/src/runtime/adapters/long-term-memory/file-lock/install.d.ts +1 -0
  93. package/dist/src/runtime/adapters/long-term-memory/file-lock/install.js +36 -0
  94. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-record.d.ts +2 -0
  95. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-record.js +114 -0
  96. package/dist/src/runtime/adapters/long-term-memory/file-lock/snapshot.d.ts +2 -0
  97. package/dist/src/runtime/adapters/long-term-memory/file-lock/snapshot.js +103 -0
  98. package/dist/src/runtime/adapters/long-term-memory/file-lock.d.ts +2 -0
  99. package/dist/src/runtime/adapters/long-term-memory/file-lock.js +10 -0
  100. package/dist/src/runtime/adapters/long-term-memory/file-repository.d.ts +2 -0
  101. package/dist/src/runtime/adapters/long-term-memory/file-repository.js +57 -0
  102. package/dist/src/runtime/adapters/long-term-memory/in-memory-repository.d.ts +2 -0
  103. package/dist/src/runtime/adapters/long-term-memory/in-memory-repository.js +21 -0
  104. package/dist/src/runtime/adapters/long-term-memory/onboarding-config-repository.d.ts +5 -0
  105. package/dist/src/runtime/adapters/long-term-memory/onboarding-config-repository.js +60 -0
  106. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.d.ts +8 -0
  107. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.js +34 -0
  108. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.d.ts +7 -1
  109. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.js +54 -25
  110. package/dist/src/runtime/adapters/registered-tool-normal-invocations/executor.js +18 -4
  111. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.d.ts +6 -1
  112. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.js +25 -12
  113. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/action-fingerprint.d.ts +22 -0
  114. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/action-fingerprint.js +65 -0
  115. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +44 -0
  116. package/dist/src/runtime/adapters/registered-tool-normal-invocations.d.ts +1 -1
  117. package/dist/src/runtime/adapters/registered-tool-payload-plan.d.ts +0 -9
  118. package/dist/src/runtime/adapters/registered-tool-payload-plan.js +0 -67
  119. package/dist/src/runtime/adapters/registered-tool-payload-related-artifacts.d.ts +13 -0
  120. package/dist/src/runtime/adapters/registered-tool-payload-related-artifacts.js +84 -0
  121. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/catalog.js +18 -4
  122. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.js +221 -87
  123. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/failure-outcome-fingerprint.d.ts +7 -0
  124. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/failure-outcome-fingerprint.js +84 -0
  125. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.d.ts +6 -4
  126. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.js +18 -2
  127. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.d.ts +35 -0
  128. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.js +32 -0
  129. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.d.ts +3 -3
  130. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.js +13 -8
  131. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.d.ts +6 -4
  132. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.js +13 -3
  133. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.js +12 -4
  134. package/dist/src/runtime/capabilities/request-bound-tool-registry.js +1 -24
  135. package/dist/src/runtime/capabilities/tool-availability.d.ts +6 -0
  136. package/dist/src/runtime/capabilities/tool-availability.js +28 -0
  137. package/dist/src/runtime/composition.d.ts +3 -0
  138. package/dist/src/runtime/composition.js +5 -2
  139. package/dist/src/runtime/config/builders.js +34 -1
  140. package/dist/src/runtime/config/effective-model-config-validation.js +9 -0
  141. package/dist/src/runtime/config/embedding-profiles.d.ts +5 -0
  142. package/dist/src/runtime/config/embedding-profiles.js +66 -0
  143. package/dist/src/runtime/config/fields.js +22 -0
  144. package/dist/src/runtime/config/long-term-memory.d.ts +9 -0
  145. package/dist/src/runtime/config/long-term-memory.js +71 -0
  146. package/dist/src/runtime/config/runner/config-normalization.d.ts +16 -0
  147. package/dist/src/runtime/config/runner/config-normalization.js +109 -0
  148. package/dist/src/runtime/config/runner/loader.d.ts +1 -1
  149. package/dist/src/runtime/config/runner/loader.js +2 -69
  150. package/dist/src/runtime/config/runner/model-policy.js +3 -0
  151. package/dist/src/runtime/config/runner/schema-version.d.ts +14 -0
  152. package/dist/src/runtime/config/runner/schema-version.js +35 -0
  153. package/dist/src/runtime/config/runner/versioned-config.d.ts +2 -0
  154. package/dist/src/runtime/config/runner/versioned-config.js +51 -0
  155. package/dist/src/runtime/config/schema.js +36 -0
  156. package/dist/src/runtime/config/types.d.ts +1 -0
  157. package/dist/src/runtime/config/validation/environment-config-validation.d.ts +1 -0
  158. package/dist/src/runtime/config/validation/environment-config-validation.js +41 -0
  159. package/dist/src/runtime/config/validation/model-invocation-config-validation.d.ts +2 -0
  160. package/dist/src/runtime/config/validation/model-invocation-config-validation.js +64 -0
  161. package/dist/src/runtime/config/validation/model-invocation-override-validation.d.ts +2 -0
  162. package/dist/src/runtime/config/validation/model-invocation-override-validation.js +72 -0
  163. package/dist/src/runtime/config/validation/model-profile-validation.d.ts +4 -0
  164. package/dist/src/runtime/config/validation/model-profile-validation.js +87 -0
  165. package/dist/src/runtime/config/validation/model-registry-validation.d.ts +2 -0
  166. package/dist/src/runtime/config/validation/model-registry-validation.js +118 -0
  167. package/dist/src/runtime/config/validation/path-config-validation.d.ts +1 -0
  168. package/dist/src/runtime/config/validation/path-config-validation.js +7 -0
  169. package/dist/src/runtime/config/validation/runtime-config-field-validation.d.ts +12 -0
  170. package/dist/src/runtime/config/validation/runtime-config-field-validation.js +158 -0
  171. package/dist/src/runtime/config/validation/runtime-config-validation-contract.d.ts +9 -0
  172. package/dist/src/runtime/config/validation/runtime-config-validation-contract.js +13 -0
  173. package/dist/src/runtime/config/validation/runtime-root-section-validation.d.ts +6 -0
  174. package/dist/src/runtime/config/validation/runtime-root-section-validation.js +82 -0
  175. package/dist/src/runtime/config/validation/web-ui-config-validation.d.ts +3 -0
  176. package/dist/src/runtime/config/validation/web-ui-config-validation.js +26 -0
  177. package/dist/src/runtime/config/validation.d.ts +4 -15
  178. package/dist/src/runtime/config/validation.js +27 -499
  179. package/dist/src/runtime/config.js +3 -0
  180. package/dist/src/runtime/context/accepted-capability-action.d.ts +11 -0
  181. package/dist/src/runtime/context/accepted-capability-action.js +29 -0
  182. package/dist/src/runtime/context/capability-brief.d.ts +25 -0
  183. package/dist/src/runtime/context/capability-brief.js +106 -0
  184. package/dist/src/runtime/context/model-step-compaction.js +6 -0
  185. package/dist/src/runtime/context/operation-supervision-evidence.d.ts +37 -0
  186. package/dist/src/runtime/context/operation-supervision-evidence.js +90 -0
  187. package/dist/src/runtime/context/request-tool-results-message-binding.d.ts +6 -0
  188. package/dist/src/runtime/context/request-tool-results-message-binding.js +30 -0
  189. package/dist/src/runtime/context/request-tool-results-scope.d.ts +3 -0
  190. package/dist/src/runtime/context/request-tool-results-scope.js +8 -0
  191. package/dist/src/runtime/context/request-tool-results.d.ts +11 -4
  192. package/dist/src/runtime/context/request-tool-results.js +60 -40
  193. package/dist/src/runtime/default-adapters.d.ts +3 -0
  194. package/dist/src/runtime/default-adapters.js +64 -3
  195. package/dist/src/runtime/index.d.ts +1 -0
  196. package/dist/src/runtime/index.js +1 -0
  197. package/dist/src/runtime/lifecycle/request-finalizer.d.ts +3 -0
  198. package/dist/src/runtime/lifecycle/request-finalizer.js +8 -0
  199. package/dist/src/runtime/long-term-memory/background-save-queue.d.ts +17 -0
  200. package/dist/src/runtime/long-term-memory/background-save-queue.js +66 -0
  201. package/dist/src/runtime/long-term-memory/candidate-persistence.d.ts +16 -0
  202. package/dist/src/runtime/long-term-memory/candidate-persistence.js +109 -0
  203. package/dist/src/runtime/long-term-memory/candidate-preparation.d.ts +8 -0
  204. package/dist/src/runtime/long-term-memory/candidate-preparation.js +36 -0
  205. package/dist/src/runtime/long-term-memory/candidate-processing.d.ts +9 -0
  206. package/dist/src/runtime/long-term-memory/candidate-processing.js +79 -0
  207. package/dist/src/runtime/long-term-memory/contracts.d.ts +108 -0
  208. package/dist/src/runtime/long-term-memory/contracts.js +1 -0
  209. package/dist/src/runtime/long-term-memory/diagnostics.d.ts +9 -0
  210. package/dist/src/runtime/long-term-memory/diagnostics.js +42 -0
  211. package/dist/src/runtime/long-term-memory/embedding-batches.d.ts +13 -0
  212. package/dist/src/runtime/long-term-memory/embedding-batches.js +87 -0
  213. package/dist/src/runtime/long-term-memory/events.d.ts +13 -0
  214. package/dist/src/runtime/long-term-memory/events.js +15 -0
  215. package/dist/src/runtime/long-term-memory/finalization.d.ts +8 -0
  216. package/dist/src/runtime/long-term-memory/finalization.js +24 -0
  217. package/dist/src/runtime/long-term-memory/index.d.ts +6 -0
  218. package/dist/src/runtime/long-term-memory/index.js +6 -0
  219. package/dist/src/runtime/long-term-memory/management/contracts.d.ts +54 -0
  220. package/dist/src/runtime/long-term-memory/management/contracts.js +1 -0
  221. package/dist/src/runtime/long-term-memory/management/errors.d.ts +10 -0
  222. package/dist/src/runtime/long-term-memory/management/errors.js +13 -0
  223. package/dist/src/runtime/long-term-memory/management/mutations.d.ts +17 -0
  224. package/dist/src/runtime/long-term-memory/management/mutations.js +178 -0
  225. package/dist/src/runtime/long-term-memory/management/queries.d.ts +8 -0
  226. package/dist/src/runtime/long-term-memory/management/queries.js +46 -0
  227. package/dist/src/runtime/long-term-memory/management/search.d.ts +7 -0
  228. package/dist/src/runtime/long-term-memory/management/search.js +18 -0
  229. package/dist/src/runtime/long-term-memory/management/service.d.ts +13 -0
  230. package/dist/src/runtime/long-term-memory/management/service.js +61 -0
  231. package/dist/src/runtime/long-term-memory/management/validation.d.ts +24 -0
  232. package/dist/src/runtime/long-term-memory/management/validation.js +77 -0
  233. package/dist/src/runtime/long-term-memory/onboarding/configuration.d.ts +14 -0
  234. package/dist/src/runtime/long-term-memory/onboarding/configuration.js +92 -0
  235. package/dist/src/runtime/long-term-memory/onboarding/contracts.d.ts +52 -0
  236. package/dist/src/runtime/long-term-memory/onboarding/contracts.js +1 -0
  237. package/dist/src/runtime/long-term-memory/onboarding/service.d.ts +21 -0
  238. package/dist/src/runtime/long-term-memory/onboarding/service.js +88 -0
  239. package/dist/src/runtime/long-term-memory/policies/normalization.d.ts +10 -0
  240. package/dist/src/runtime/long-term-memory/policies/normalization.js +45 -0
  241. package/dist/src/runtime/long-term-memory/policies/reconciliation.d.ts +20 -0
  242. package/dist/src/runtime/long-term-memory/policies/reconciliation.js +21 -0
  243. package/dist/src/runtime/long-term-memory/policies/scoring.d.ts +13 -0
  244. package/dist/src/runtime/long-term-memory/policies/scoring.js +55 -0
  245. package/dist/src/runtime/long-term-memory/policies/sensitive-data.d.ts +5 -0
  246. package/dist/src/runtime/long-term-memory/policies/sensitive-data.js +12 -0
  247. package/dist/src/runtime/long-term-memory/projection.d.ts +4 -0
  248. package/dist/src/runtime/long-term-memory/projection.js +39 -0
  249. package/dist/src/runtime/long-term-memory/ranked-search.d.ts +11 -0
  250. package/dist/src/runtime/long-term-memory/ranked-search.js +111 -0
  251. package/dist/src/runtime/long-term-memory/repository-state.d.ts +4 -0
  252. package/dist/src/runtime/long-term-memory/repository-state.js +131 -0
  253. package/dist/src/runtime/long-term-memory/response-context.d.ts +5 -0
  254. package/dist/src/runtime/long-term-memory/response-context.js +21 -0
  255. package/dist/src/runtime/long-term-memory/retrieval.d.ts +8 -0
  256. package/dist/src/runtime/long-term-memory/retrieval.js +73 -0
  257. package/dist/src/runtime/long-term-memory/service.d.ts +10 -0
  258. package/dist/src/runtime/long-term-memory/service.js +83 -0
  259. package/dist/src/runtime/orchestration/capability-adapters/index.d.ts +2 -0
  260. package/dist/src/runtime/orchestration/capability-adapters/index.js +2 -0
  261. package/dist/src/runtime/orchestration/final-response/authoring-contract.d.ts +10 -0
  262. package/dist/src/runtime/orchestration/final-response/authoring-contract.js +94 -0
  263. package/dist/src/runtime/orchestration/final-response/finalization.d.ts +1 -0
  264. package/dist/src/runtime/orchestration/final-response/finalization.js +1 -0
  265. package/dist/src/runtime/orchestration/final-response/format.d.ts +2 -0
  266. package/dist/src/runtime/orchestration/final-response/format.js +49 -0
  267. package/dist/src/runtime/orchestration/final-response/invoke.d.ts +16 -0
  268. package/dist/src/runtime/orchestration/final-response/invoke.js +24 -0
  269. package/dist/src/runtime/orchestration/role-calls/activation-budget.d.ts +14 -0
  270. package/dist/src/runtime/orchestration/role-calls/activation-budget.js +52 -0
  271. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +162 -1
  272. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.js +1 -8
  273. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-issuance.d.ts +17 -0
  274. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-issuance.js +155 -0
  275. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision.d.ts +78 -0
  276. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision.js +339 -0
  277. package/dist/src/runtime/orchestration/role-calls/child-return.d.ts +4 -0
  278. package/dist/src/runtime/orchestration/role-calls/child-return.js +25 -5
  279. package/dist/src/runtime/orchestration/role-calls/command-decoder.js +43 -13
  280. package/dist/src/runtime/orchestration/role-calls/command-dispatch/active-capability-caller.d.ts +6 -0
  281. package/dist/src/runtime/orchestration/role-calls/command-dispatch/active-capability-caller.js +15 -0
  282. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-frame-state.d.ts +3 -0
  283. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-frame-state.js +6 -0
  284. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-scope-transitions.d.ts +3 -0
  285. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-scope-transitions.js +86 -0
  286. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-batch-transitions.d.ts +3 -0
  287. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-batch-transitions.js +172 -0
  288. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-state.d.ts +9 -0
  289. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-state.js +28 -0
  290. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-transitions.d.ts +3 -0
  291. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-transitions.js +117 -0
  292. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-invocation.d.ts +4 -0
  293. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-invocation.js +16 -0
  294. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-selection-transition.d.ts +2 -0
  295. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-selection-transition.js +114 -0
  296. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-settlement.d.ts +6 -0
  297. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-settlement.js +54 -0
  298. package/dist/src/runtime/orchestration/role-calls/command-dispatch/child-transitions.d.ts +3 -0
  299. package/dist/src/runtime/orchestration/role-calls/command-dispatch/child-transitions.js +221 -0
  300. package/dist/src/runtime/orchestration/role-calls/command-dispatch/operation-supervision-intervention.d.ts +13 -0
  301. package/dist/src/runtime/orchestration/role-calls/command-dispatch/operation-supervision-intervention.js +25 -0
  302. package/dist/src/runtime/orchestration/role-calls/command-dispatch/root-transitions.d.ts +3 -0
  303. package/dist/src/runtime/orchestration/role-calls/command-dispatch/root-transitions.js +70 -0
  304. package/dist/src/runtime/orchestration/role-calls/command-dispatch.d.ts +2 -2
  305. package/dist/src/runtime/orchestration/role-calls/command-dispatch.js +8 -582
  306. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +48 -5
  307. package/dist/src/runtime/orchestration/role-calls/contracts.js +4 -4
  308. package/dist/src/runtime/orchestration/role-calls/dependency-results.d.ts +1 -1
  309. package/dist/src/runtime/orchestration/role-calls/dependency-results.js +1 -0
  310. package/dist/src/runtime/orchestration/role-calls/diagnostics.d.ts +4 -0
  311. package/dist/src/runtime/orchestration/role-calls/diagnostics.js +152 -1
  312. package/dist/src/runtime/orchestration/role-calls/index.d.ts +11 -1
  313. package/dist/src/runtime/orchestration/role-calls/index.js +11 -1
  314. package/dist/src/runtime/orchestration/role-calls/ledger.d.ts +3 -1
  315. package/dist/src/runtime/orchestration/role-calls/ledger.js +139 -8
  316. package/dist/src/runtime/orchestration/role-calls/operation-supervision-issuance.d.ts +11 -0
  317. package/dist/src/runtime/orchestration/role-calls/operation-supervision-issuance.js +66 -0
  318. package/dist/src/runtime/orchestration/role-calls/operation-supervision-projection.d.ts +16 -0
  319. package/dist/src/runtime/orchestration/role-calls/operation-supervision-projection.js +52 -0
  320. package/dist/src/runtime/orchestration/role-calls/operation-supervision-state-validation.d.ts +3 -0
  321. package/dist/src/runtime/orchestration/role-calls/operation-supervision-state-validation.js +151 -0
  322. package/dist/src/runtime/orchestration/role-calls/operation-supervision.d.ts +112 -0
  323. package/dist/src/runtime/orchestration/role-calls/operation-supervision.js +197 -0
  324. package/dist/src/runtime/orchestration/role-calls/reconsideration-cause.d.ts +26 -0
  325. package/dist/src/runtime/orchestration/role-calls/reconsideration-cause.js +127 -0
  326. package/dist/src/runtime/orchestration/role-calls/reducer-primitives.d.ts +1 -2
  327. package/dist/src/runtime/orchestration/role-calls/reducer-primitives.js +2 -12
  328. package/dist/src/runtime/orchestration/role-calls/reducer.d.ts +1 -1
  329. package/dist/src/runtime/orchestration/role-calls/reducer.js +20 -3
  330. package/dist/src/runtime/orchestration/role-calls/result-receipt.d.ts +49 -0
  331. package/dist/src/runtime/orchestration/role-calls/result-receipt.js +188 -0
  332. package/dist/src/runtime/orchestration/role-calls/return-result-receipt.d.ts +19 -0
  333. package/dist/src/runtime/orchestration/role-calls/return-result-receipt.js +52 -0
  334. package/dist/src/runtime/orchestration/role-calls/transactions.js +63 -5
  335. package/dist/src/runtime/orchestration/role-calls/work-result-lineage.d.ts +34 -0
  336. package/dist/src/runtime/orchestration/role-calls/work-result-lineage.js +185 -0
  337. package/dist/src/runtime/orchestration/role-calls/work-result-receipt.d.ts +36 -0
  338. package/dist/src/runtime/orchestration/role-calls/work-result-receipt.js +187 -0
  339. package/dist/src/runtime/orchestration/role-executors/activation/capability-continuation.d.ts +15 -0
  340. package/dist/src/runtime/orchestration/role-executors/activation/capability-continuation.js +73 -0
  341. package/dist/src/runtime/orchestration/role-executors/activation/loop.d.ts +0 -1
  342. package/dist/src/runtime/orchestration/role-executors/activation/loop.js +16 -54
  343. package/dist/src/runtime/orchestration/role-executors/activation/result-normalization.js +20 -3
  344. package/dist/src/runtime/orchestration/role-executors/activation/state-validation.d.ts +13 -1
  345. package/dist/src/runtime/orchestration/role-executors/activation/state-validation.js +137 -1
  346. package/dist/src/runtime/orchestration/role-executors/child-invocation/transaction.js +1 -0
  347. package/dist/src/runtime/orchestration/role-executors/contracts.d.ts +8 -3
  348. package/dist/src/runtime/orchestration/role-executors/diagnostics.d.ts +2 -0
  349. package/dist/src/runtime/orchestration/role-executors/diagnostics.js +1 -6
  350. package/dist/src/runtime/orchestration/worker-capabilities/assignment-provenance.d.ts +36 -0
  351. package/dist/src/runtime/orchestration/worker-capabilities/assignment-provenance.js +171 -0
  352. package/dist/src/runtime/orchestration/worker-capabilities/batch-selection.d.ts +10 -0
  353. package/dist/src/runtime/orchestration/worker-capabilities/batch-selection.js +8 -0
  354. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-catalog.d.ts +14 -0
  355. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-catalog.js +76 -0
  356. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-normalization.d.ts +10 -0
  357. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-normalization.js +160 -0
  358. package/dist/src/runtime/orchestration/worker-capabilities/binding/binding-rejection.d.ts +2 -0
  359. package/dist/src/runtime/orchestration/worker-capabilities/binding/binding-rejection.js +8 -0
  360. package/dist/src/runtime/orchestration/worker-capabilities/binding/bound-capability-session.d.ts +24 -0
  361. package/dist/src/runtime/orchestration/worker-capabilities/binding/bound-capability-session.js +100 -0
  362. package/dist/src/runtime/orchestration/worker-capabilities/binding/call-authority.d.ts +29 -0
  363. package/dist/src/runtime/orchestration/worker-capabilities/binding/call-authority.js +193 -0
  364. package/dist/src/runtime/orchestration/worker-capabilities/binding/create-binding.d.ts +11 -0
  365. package/dist/src/runtime/orchestration/worker-capabilities/binding/create-binding.js +109 -0
  366. package/dist/src/runtime/orchestration/worker-capabilities/binding/dependency-results.d.ts +2 -0
  367. package/dist/src/runtime/orchestration/worker-capabilities/binding/dependency-results.js +34 -0
  368. package/dist/src/runtime/orchestration/worker-capabilities/binding/invocation-preparation.d.ts +21 -0
  369. package/dist/src/runtime/orchestration/worker-capabilities/binding/invocation-preparation.js +167 -0
  370. package/dist/src/runtime/orchestration/worker-capabilities/binding.d.ts +1 -13
  371. package/dist/src/runtime/orchestration/worker-capabilities/binding.js +1 -625
  372. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +89 -15
  373. package/dist/src/runtime/orchestration/worker-capabilities/contracts.js +3 -1
  374. package/dist/src/runtime/orchestration/worker-capabilities/controls.d.ts +7 -0
  375. package/dist/src/runtime/orchestration/worker-capabilities/controls.js +50 -0
  376. package/dist/src/runtime/orchestration/worker-capabilities/error-fingerprint.d.ts +5 -0
  377. package/dist/src/runtime/orchestration/worker-capabilities/error-fingerprint.js +119 -0
  378. package/dist/src/runtime/orchestration/worker-capabilities/errors.d.ts +6 -0
  379. package/dist/src/runtime/orchestration/worker-capabilities/errors.js +11 -0
  380. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-exact-result.d.ts +7 -0
  381. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-exact-result.js +35 -0
  382. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-execution.d.ts +9 -0
  383. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-execution.js +28 -0
  384. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-normalization.d.ts +18 -0
  385. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-normalization.js +197 -0
  386. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-references.d.ts +2 -0
  387. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-references.js +44 -0
  388. package/dist/src/runtime/orchestration/worker-capabilities/execution/context-projection.d.ts +12 -0
  389. package/dist/src/runtime/orchestration/worker-capabilities/execution/context-projection.js +51 -0
  390. package/dist/src/runtime/orchestration/worker-capabilities/execution/invocation-preparation.d.ts +26 -0
  391. package/dist/src/runtime/orchestration/worker-capabilities/execution/invocation-preparation.js +114 -0
  392. package/dist/src/runtime/orchestration/worker-capabilities/execution/ledger-transaction.d.ts +20 -0
  393. package/dist/src/runtime/orchestration/worker-capabilities/execution/ledger-transaction.js +142 -0
  394. package/dist/src/runtime/orchestration/worker-capabilities/execution.d.ts +10 -14
  395. package/dist/src/runtime/orchestration/worker-capabilities/execution.js +107 -357
  396. package/dist/src/runtime/orchestration/worker-capabilities/index.d.ts +5 -0
  397. package/dist/src/runtime/orchestration/worker-capabilities/index.js +5 -0
  398. package/dist/src/runtime/orchestration/worker-capabilities/outcome-fingerprint.d.ts +8 -0
  399. package/dist/src/runtime/orchestration/worker-capabilities/outcome-fingerprint.js +21 -0
  400. package/dist/src/runtime/orchestration/worker-capabilities/payload-assignment-validation.d.ts +3 -0
  401. package/dist/src/runtime/orchestration/worker-capabilities/payload-assignment-validation.js +30 -0
  402. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.js +23 -12
  403. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.d.ts +20 -7
  404. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.js +2 -0
  405. package/dist/src/runtime/orchestration/worker-capabilities/payload-instructions.js +4 -4
  406. package/dist/src/runtime/orchestration/worker-capabilities/payload-source-provenance.d.ts +14 -0
  407. package/dist/src/runtime/orchestration/worker-capabilities/payload-source-provenance.js +132 -0
  408. package/dist/src/runtime/orchestration/worker-capabilities/preparation-fingerprint.d.ts +23 -0
  409. package/dist/src/runtime/orchestration/worker-capabilities/preparation-fingerprint.js +109 -0
  410. package/dist/src/runtime/plugins/manifest-projection.js +3 -0
  411. package/dist/src/runtime/plugins/manifest-validator.js +20 -0
  412. package/dist/src/runtime/ports.d.ts +10 -1
  413. package/dist/src/runtime/request/capability-brief.d.ts +5 -0
  414. package/dist/src/runtime/request/capability-brief.js +24 -0
  415. package/dist/src/runtime/request/contracts.d.ts +7 -0
  416. package/dist/src/runtime/request/dependencies.d.ts +1 -0
  417. package/dist/src/runtime/request/dependencies.js +10 -1
  418. package/dist/src/runtime/request/execution-agent-root-execution.js +5 -4
  419. package/dist/src/runtime/request/execution-facets.d.ts +2 -1
  420. package/dist/src/runtime/request/execution-facets.js +6 -0
  421. package/dist/src/runtime/request/execution-scope-surfaces.js +6 -0
  422. package/dist/src/runtime/request/execution-scope.d.ts +5 -3
  423. package/dist/src/runtime/request/handler.js +4 -1
  424. package/dist/src/runtime/request/result.d.ts +2 -0
  425. package/dist/src/runtime/request/role-executor-composition.js +1 -1
  426. package/dist/src/runtime/request/root-contract.d.ts +4 -2
  427. package/dist/src/runtime/request/root-execution-kernel.js +100 -31
  428. package/dist/src/runtime/request/supervisor-root-execution.js +4 -2
  429. package/dist/src/runtime/request/worker-capability-composition.d.ts +2 -1
  430. package/dist/src/runtime/request/worker-capability-composition.js +6 -1
  431. package/dist/src/runtime/request/worker-capability-payload-prompts.js +1 -1
  432. package/dist/src/runtime/request/worker-capability-payload.js +11 -8
  433. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.d.ts +24 -0
  434. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.js +52 -0
  435. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +5 -2
  436. package/dist/src/runtime/steps/execution-agent/format.js +19 -6
  437. package/dist/src/runtime/steps/execution-agent/input.js +8 -12
  438. package/dist/src/runtime/steps/execution-agent/parser.js +25 -19
  439. package/dist/src/runtime/steps/execution-agent/prompt.js +6 -4
  440. package/dist/src/runtime/steps/execution-agent/reconsideration-context.d.ts +3 -0
  441. package/dist/src/runtime/steps/execution-agent/reconsideration-context.js +76 -0
  442. package/dist/src/runtime/steps/execution-agent/refinement-prompt.js +4 -4
  443. package/dist/src/runtime/steps/execution-agent/refinement-reconsideration.d.ts +3 -0
  444. package/dist/src/runtime/steps/execution-agent/refinement-reconsideration.js +25 -0
  445. package/dist/src/runtime/steps/execution-agent/refinement.d.ts +4 -7
  446. package/dist/src/runtime/steps/execution-agent/refinement.js +24 -35
  447. package/dist/src/runtime/steps/execution-agent/response-input.d.ts +2 -0
  448. package/dist/src/runtime/steps/execution-agent/response-input.js +22 -6
  449. package/dist/src/runtime/steps/execution-agent/response-prompt.d.ts +1 -1
  450. package/dist/src/runtime/steps/execution-agent/response-prompt.js +8 -3
  451. package/dist/src/runtime/steps/execution-agent/response-run.d.ts +6 -0
  452. package/dist/src/runtime/steps/execution-agent/response-run.js +40 -10
  453. package/dist/src/runtime/steps/execution-agent/run.js +6 -6
  454. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +4 -1
  455. package/dist/src/runtime/steps/execution-agent/state-context.js +40 -23
  456. package/dist/src/runtime/steps/planner-decision/capability-catalog-context.d.ts +14 -0
  457. package/dist/src/runtime/steps/planner-decision/capability-catalog-context.js +87 -0
  458. package/dist/src/runtime/steps/planner-decision/contracts.d.ts +3 -5
  459. package/dist/src/runtime/steps/planner-decision/contracts.js +3 -3
  460. package/dist/src/runtime/steps/planner-decision/format.d.ts +3 -2
  461. package/dist/src/runtime/steps/planner-decision/format.js +73 -76
  462. package/dist/src/runtime/steps/planner-decision/input.d.ts +4 -3
  463. package/dist/src/runtime/steps/planner-decision/input.js +10 -7
  464. package/dist/src/runtime/steps/planner-decision/parser.d.ts +3 -2
  465. package/dist/src/runtime/steps/planner-decision/parser.js +10 -19
  466. package/dist/src/runtime/steps/planner-decision/plan-parser.js +18 -12
  467. package/dist/src/runtime/steps/planner-decision/prompt.js +33 -28
  468. package/dist/src/runtime/steps/planner-decision/resume.d.ts +1 -1
  469. package/dist/src/runtime/steps/planner-decision/resume.js +38 -1
  470. package/dist/src/runtime/steps/planner-decision/run.d.ts +3 -2
  471. package/dist/src/runtime/steps/reviewer-decision/audit-coverage.d.ts +10 -0
  472. package/dist/src/runtime/steps/reviewer-decision/audit-coverage.js +186 -0
  473. package/dist/src/runtime/steps/reviewer-decision/contracts.d.ts +3 -8
  474. package/dist/src/runtime/steps/reviewer-decision/contracts.js +12 -6
  475. package/dist/src/runtime/steps/reviewer-decision/delegated-context.d.ts +24 -0
  476. package/dist/src/runtime/steps/reviewer-decision/delegated-context.js +70 -0
  477. package/dist/src/runtime/steps/reviewer-decision/diagnostics.js +1 -1
  478. package/dist/src/runtime/steps/reviewer-decision/format.js +37 -24
  479. package/dist/src/runtime/steps/reviewer-decision/input.js +1 -1
  480. package/dist/src/runtime/steps/reviewer-decision/model-context.d.ts +4 -3
  481. package/dist/src/runtime/steps/reviewer-decision/model-context.js +92 -10
  482. package/dist/src/runtime/steps/reviewer-decision/parser.js +19 -1
  483. package/dist/src/runtime/steps/reviewer-decision/projection.js +42 -68
  484. package/dist/src/runtime/steps/reviewer-decision/prompt.js +10 -5
  485. package/dist/src/runtime/steps/reviewer-decision/run.js +12 -3
  486. package/dist/src/runtime/steps/reviewer-decision/verification-coverage.d.ts +14 -0
  487. package/dist/src/runtime/steps/reviewer-decision/verification-coverage.js +52 -0
  488. package/dist/src/runtime/steps/supervisor-decision/capability-brief.d.ts +14 -0
  489. package/dist/src/runtime/steps/supervisor-decision/capability-brief.js +38 -0
  490. package/dist/src/runtime/steps/supervisor-decision/contracts.d.ts +7 -3
  491. package/dist/src/runtime/steps/supervisor-decision/diagnostics.d.ts +2 -0
  492. package/dist/src/runtime/steps/supervisor-decision/diagnostics.js +8 -2
  493. package/dist/src/runtime/steps/supervisor-decision/format.js +32 -20
  494. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +4 -1
  495. package/dist/src/runtime/steps/supervisor-decision/input.js +19 -1
  496. package/dist/src/runtime/steps/supervisor-decision/parser.js +62 -59
  497. package/dist/src/runtime/steps/supervisor-decision/prompt.js +6 -7
  498. package/dist/src/runtime/steps/supervisor-decision/resume.js +47 -1
  499. package/dist/src/runtime/steps/supervisor-decision/run.js +10 -0
  500. package/dist/src/runtime/steps/supervisor-decision/working-directory.js +2 -1
  501. package/dist/src/runtime/steps/supervisor-response/index.d.ts +1 -1
  502. package/dist/src/runtime/steps/supervisor-response/index.js +1 -1
  503. package/dist/src/runtime/steps/supervisor-response/input.d.ts +13 -5
  504. package/dist/src/runtime/steps/supervisor-response/input.js +27 -8
  505. package/dist/src/runtime/steps/supervisor-response/memory-authoring.d.ts +10 -0
  506. package/dist/src/runtime/steps/supervisor-response/memory-authoring.js +125 -0
  507. package/dist/src/runtime/steps/supervisor-response/prompt.d.ts +4 -0
  508. package/dist/src/runtime/steps/supervisor-response/prompt.js +19 -0
  509. package/dist/src/runtime/steps/supervisor-response/run.d.ts +8 -0
  510. package/dist/src/runtime/steps/supervisor-response/run.js +46 -17
  511. package/dist/src/runtime/steps/worker-decision/contracts.d.ts +10 -2
  512. package/dist/src/runtime/steps/worker-decision/contracts.js +3 -0
  513. package/dist/src/runtime/steps/worker-decision/format.d.ts +4 -0
  514. package/dist/src/runtime/steps/worker-decision/format.js +97 -22
  515. package/dist/src/runtime/steps/worker-decision/input/action-policy.d.ts +9 -0
  516. package/dist/src/runtime/steps/worker-decision/input/action-policy.js +15 -0
  517. package/dist/src/runtime/steps/worker-decision/input/canonical-state.d.ts +2 -2
  518. package/dist/src/runtime/steps/worker-decision/input/canonical-state.js +27 -8
  519. package/dist/src/runtime/steps/worker-decision/input/capability-selection.js +44 -3
  520. package/dist/src/runtime/steps/worker-decision/input/contract.d.ts +1 -0
  521. package/dist/src/runtime/steps/worker-decision/input/contract.js +12 -6
  522. package/dist/src/runtime/steps/worker-decision/input/diagnostic-projection.js +16 -7
  523. package/dist/src/runtime/steps/worker-decision/input/prompt-context.d.ts +1 -0
  524. package/dist/src/runtime/steps/worker-decision/input/prompt-context.js +13 -7
  525. package/dist/src/runtime/steps/worker-decision/input/reference-context.js +53 -15
  526. package/dist/src/runtime/steps/worker-decision/input/session.js +2 -1
  527. package/dist/src/runtime/steps/worker-decision/input/types.d.ts +8 -2
  528. package/dist/src/runtime/steps/worker-decision/input.d.ts +3 -2
  529. package/dist/src/runtime/steps/worker-decision/input.js +2 -2
  530. package/dist/src/runtime/steps/worker-decision/parser/accepted-decision.d.ts +3 -0
  531. package/dist/src/runtime/steps/worker-decision/parser/accepted-decision.js +70 -0
  532. package/dist/src/runtime/steps/worker-decision/parser/action-validation.d.ts +4 -0
  533. package/dist/src/runtime/steps/worker-decision/parser/action-validation.js +55 -0
  534. package/dist/src/runtime/steps/worker-decision/parser/capability-batch-validation.d.ts +3 -0
  535. package/dist/src/runtime/steps/worker-decision/parser/capability-batch-validation.js +135 -0
  536. package/dist/src/runtime/steps/worker-decision/parser/capability-controls-validation.d.ts +6 -0
  537. package/dist/src/runtime/steps/worker-decision/parser/capability-controls-validation.js +132 -0
  538. package/dist/src/runtime/steps/worker-decision/parser/capability-invocation-validation.d.ts +4 -0
  539. package/dist/src/runtime/steps/worker-decision/parser/capability-invocation-validation.js +104 -0
  540. package/dist/src/runtime/steps/worker-decision/parser/decision-shape-validation.d.ts +4 -0
  541. package/dist/src/runtime/steps/worker-decision/parser/decision-shape-validation.js +28 -0
  542. package/dist/src/runtime/steps/worker-decision/parser/pending-capability-selection-validation.d.ts +4 -0
  543. package/dist/src/runtime/steps/worker-decision/parser/pending-capability-selection-validation.js +105 -0
  544. package/dist/src/runtime/steps/worker-decision/parser/validation-contract.d.ts +50 -0
  545. package/dist/src/runtime/steps/worker-decision/parser/validation-contract.js +19 -0
  546. package/dist/src/runtime/steps/worker-decision/parser.d.ts +5 -1
  547. package/dist/src/runtime/steps/worker-decision/parser.js +32 -426
  548. package/dist/src/runtime/steps/worker-decision/payload-dependency-results.d.ts +8 -0
  549. package/dist/src/runtime/steps/worker-decision/payload-dependency-results.js +19 -0
  550. package/dist/src/runtime/steps/worker-decision/prompt.d.ts +3 -0
  551. package/dist/src/runtime/steps/worker-decision/prompt.js +63 -26
  552. package/dist/src/runtime/steps/worker-decision/result-author.js +28 -11
  553. package/dist/src/runtime/steps/worker-decision/run.js +99 -21
  554. package/dist/src/runtime/validation/strict-record.d.ts +2 -0
  555. package/dist/src/runtime/validation/strict-record.js +12 -0
  556. package/dist/src/shared/model-step-registry-data.json +9 -0
  557. package/dist/src/shared/model-step-registry.d.ts +9 -0
  558. package/dist/src/shared/model-step-registry.generated.d.ts +9 -0
  559. package/dist/src/shared/model-step-registry.generated.js +9 -0
  560. package/dist/src/web-ui/app/ARCHITECTURE.md +20 -7
  561. package/dist/src/web-ui/app/app.js +62 -18
  562. package/dist/src/web-ui/app/components/composer-context-window.d.ts +25 -0
  563. package/dist/src/web-ui/app/components/composer-context-window.js +155 -0
  564. package/dist/src/web-ui/app/components/composer-plan.d.ts +9 -0
  565. package/dist/src/web-ui/app/components/composer-plan.js +128 -0
  566. package/dist/src/web-ui/app/components/config-workspace/config-model.js +320 -0
  567. package/dist/src/web-ui/app/components/config-workspace/dashboard-rendering.js +155 -0
  568. package/dist/src/web-ui/app/components/config-workspace/field-rendering.js +278 -0
  569. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +251 -0
  570. package/dist/src/web-ui/app/components/config-workspace/step-rendering.js +145 -0
  571. package/dist/src/web-ui/app/components/config-workspace/workspace-events.js +271 -0
  572. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +195 -0
  573. package/dist/src/web-ui/app/components/config-workspace/workspace-persistence.js +247 -0
  574. package/dist/src/web-ui/app/components/config-workspace/workspace-view.js +299 -0
  575. package/dist/src/web-ui/app/components/config-workspace.js +179 -866
  576. package/dist/src/web-ui/app/components/conversation-activity.d.ts +12 -7
  577. package/dist/src/web-ui/app/components/conversation-activity.js +64 -157
  578. package/dist/src/web-ui/app/components/conversation-role-cards.d.ts +23 -0
  579. package/dist/src/web-ui/app/components/conversation-role-cards.js +181 -0
  580. package/dist/src/web-ui/app/components/conversation-sidebar-layout.js +12 -0
  581. package/dist/src/web-ui/app/components/conversation-sources.d.ts +7 -0
  582. package/dist/src/web-ui/app/components/conversation-sources.js +182 -0
  583. package/dist/src/web-ui/app/components/conversation-view.js +34 -6
  584. package/dist/src/web-ui/app/components/long-term-memory/icons.js +16 -0
  585. package/dist/src/web-ui/app/components/long-term-memory/manager.js +192 -0
  586. package/dist/src/web-ui/app/components/long-term-memory/record-editor.d.ts +9 -0
  587. package/dist/src/web-ui/app/components/long-term-memory/record-editor.js +62 -0
  588. package/dist/src/web-ui/app/components/long-term-memory/record-list.d.ts +5 -0
  589. package/dist/src/web-ui/app/components/long-term-memory/record-list.js +97 -0
  590. package/dist/src/web-ui/app/components/long-term-memory/view-model.d.ts +29 -0
  591. package/dist/src/web-ui/app/components/long-term-memory/view-model.js +69 -0
  592. package/dist/src/web-ui/app/components/long-term-memory-setup.js +334 -0
  593. package/dist/src/web-ui/app/components/model-selector.js +4 -1
  594. package/dist/src/web-ui/app/components/operations-section.js +46 -0
  595. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +39 -0
  596. package/dist/src/web-ui/app/components/tool-approval-card.d.ts +18 -0
  597. package/dist/src/web-ui/app/components/workspace-shell.js +134 -85
  598. package/dist/src/web-ui/app/controllers/app-event-bindings.js +43 -6
  599. package/dist/src/web-ui/app/controllers/composer-attachments-controller.d.ts +92 -0
  600. package/dist/src/web-ui/app/controllers/composer-queue-controller.d.ts +109 -0
  601. package/dist/src/web-ui/app/controllers/composer-submit-controller.d.ts +77 -0
  602. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +149 -0
  603. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +43 -3
  604. package/dist/src/web-ui/app/controllers/long-term-memory/controller.d.ts +87 -0
  605. package/dist/src/web-ui/app/controllers/long-term-memory/controller.js +302 -0
  606. package/dist/src/web-ui/app/controllers/long-term-memory/policy.d.ts +14 -0
  607. package/dist/src/web-ui/app/controllers/long-term-memory/policy.js +61 -0
  608. package/dist/src/web-ui/app/controllers/long-term-memory/state.js +85 -0
  609. package/dist/src/web-ui/app/controllers/operations-controller.d.ts +25 -0
  610. package/dist/src/web-ui/app/controllers/realtime-event-controller.d.ts +58 -0
  611. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +55 -90
  612. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.d.ts +32 -0
  613. package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts +177 -0
  614. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +80 -11
  615. package/dist/src/web-ui/app/controllers/session-controller.js +17 -12
  616. package/dist/src/web-ui/app/controllers/tool-approval-controller.d.ts +28 -0
  617. package/dist/src/web-ui/app/index.html +221 -224
  618. package/dist/src/web-ui/app/lib/composer-plan-model.d.ts +32 -0
  619. package/dist/src/web-ui/app/lib/composer-plan-model.js +108 -0
  620. package/dist/src/web-ui/app/lib/conversation-role-model.d.ts +19 -0
  621. package/dist/src/web-ui/app/lib/conversation-role-model.js +193 -0
  622. package/dist/src/web-ui/app/lib/event-presentation.js +30 -9
  623. package/dist/src/web-ui/app/lib/source-url-policy.d.ts +2 -0
  624. package/dist/src/web-ui/app/lib/source-url-policy.js +31 -0
  625. package/dist/src/web-ui/app/lib/task-progress.d.ts +53 -0
  626. package/dist/src/web-ui/app/lib/task-progress.js +233 -0
  627. package/dist/src/web-ui/app/lib/tool-invocation-count.d.ts +5 -0
  628. package/dist/src/web-ui/app/lib/tool-invocation-count.js +21 -0
  629. package/dist/src/web-ui/app/lib/web-source-event.d.ts +8 -0
  630. package/dist/src/web-ui/app/lib/web-source-event.js +21 -0
  631. package/dist/src/web-ui/app/lib/web-sources.d.ts +36 -0
  632. package/dist/src/web-ui/app/lib/web-sources.js +177 -0
  633. package/dist/src/web-ui/app/services/runtime-web-client/memory.js +127 -0
  634. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +84 -0
  635. package/dist/src/web-ui/app/services/runtime-web-client.js +27 -1
  636. package/dist/src/web-ui/app/styles/00-tokens-base.css +15 -3
  637. package/dist/src/web-ui/app/styles/10-shell-sessions.css +24 -34
  638. package/dist/src/web-ui/app/styles/12-conversation-sidebar.css +93 -0
  639. package/dist/src/web-ui/app/styles/20-chat-composer.css +55 -472
  640. package/dist/src/web-ui/app/styles/21-composer-controls.css +368 -0
  641. package/dist/src/web-ui/app/styles/22-composer-context-window.css +90 -0
  642. package/dist/src/web-ui/app/styles/23-composer-plan.css +171 -0
  643. package/dist/src/web-ui/app/styles/24-conversation-role-cards.css +205 -0
  644. package/dist/src/web-ui/app/styles/25-conversation-sources.css +141 -0
  645. package/dist/src/web-ui/app/styles/30-inspector-config.css +142 -1602
  646. package/dist/src/web-ui/app/styles/35-memory-onboarding.css +153 -0
  647. package/dist/src/web-ui/app/styles/36-memory-management.css +419 -0
  648. package/dist/src/web-ui/app/styles/37-config-operations.css +197 -0
  649. package/dist/src/web-ui/app/styles/40-config-workspace.css +992 -0
  650. package/dist/src/web-ui/app/styles/90-responsive.css +199 -101
  651. package/dist/src/web-ui/app/styles/foundation.css +2 -2
  652. package/dist/src/web-ui/app/styles.css +10 -0
  653. package/dist/src/web-ui/app/ui-behavior.d.ts +1 -1
  654. package/dist/src/web-ui/app/ui-behavior.js +1 -1
  655. package/dist/src/web-ui/config-dashboard-backend.js +9 -1
  656. package/dist/src/web-ui/local-runtime/api-router.d.ts +4 -2
  657. package/dist/src/web-ui/local-runtime/api-router.js +33 -0
  658. package/dist/src/web-ui/local-runtime/contracts.d.ts +5 -0
  659. package/dist/src/web-ui/local-runtime/memory-management-input.d.ts +12 -0
  660. package/dist/src/web-ui/local-runtime/memory-management-input.js +68 -0
  661. package/dist/src/web-ui/local-runtime/memory-management-response.d.ts +17 -0
  662. package/dist/src/web-ui/local-runtime/memory-management-response.js +47 -0
  663. package/dist/src/web-ui/local-runtime/memory-management-routes.d.ts +24 -0
  664. package/dist/src/web-ui/local-runtime/memory-management-routes.js +128 -0
  665. package/dist/src/web-ui/local-runtime/memory-onboarding-routes.d.ts +17 -0
  666. package/dist/src/web-ui/local-runtime/memory-onboarding-routes.js +81 -0
  667. package/dist/src/web-ui/local-runtime/request-abort.d.ts +7 -0
  668. package/dist/src/web-ui/local-runtime/request-abort.js +19 -0
  669. package/dist/src/web-ui/local-runtime-backend.js +10 -3
  670. package/dist/src/web-ui/server.d.ts +2 -0
  671. package/dist/src/web-ui/server.js +3 -0
  672. package/docs/configuration.md +144 -54
  673. package/docs/installation.md +28 -4
  674. package/docs/known-limitations.md +32 -0
  675. package/docs/long-term-memory.md +181 -0
  676. package/docs/plugins.md +28 -13
  677. package/docs/publishing.md +52 -25
  678. package/docs/runtime-invariant-coverage.md +18 -17
  679. package/docs/runtime-library.md +16 -1
  680. package/docs/runtime-prompt-policy-contracts.md +39 -19
  681. package/docs/troubleshooting.md +21 -0
  682. package/examples/models/default.config.json +1 -0
  683. package/examples/request-runner.config.example.json +16 -22
  684. package/examples/runtime.config.example.json +4 -0
  685. package/methodologies/memory-informed-response.md +15 -0
  686. package/methodologies/response-ux.md +17 -0
  687. package/package.json +11 -4
  688. package/plugins/capability-brief/source/index.ts +5 -48
  689. package/plugins/capability-brief/src/index.cjs +46 -33
  690. package/plugins/exec/source/handlers.ts +65 -5
  691. package/plugins/exec/src/index.cjs +39 -3
  692. package/plugins/filesystem/plugin.json +1 -0
  693. package/plugins/system-probe/plugin.json +1 -0
  694. package/plugins/web/README.md +125 -0
  695. package/plugins/web/plugin.json +1 -1
  696. package/plugins/web/skills/web_fetch_skill/SKILL.md +2 -2
  697. package/plugins/web/skills/web_search_skill/SKILL.md +8 -4
  698. package/plugins/web/source/errors.ts +5 -1
  699. package/plugins/web/source/fetch-presentation.ts +61 -0
  700. package/plugins/web/source/fetch-service.ts +2 -31
  701. package/plugins/web/source/light/config.ts +196 -0
  702. package/plugins/web/source/light/crawl/origin-gate.ts +134 -0
  703. package/plugins/web/source/light/crawl/robots-cache.ts +71 -0
  704. package/plugins/web/source/light/crawl/robots-parser.ts +132 -0
  705. package/plugins/web/source/light/crawl/robots-policy.ts +154 -0
  706. package/plugins/web/source/light/crawl/session-budget.ts +141 -0
  707. package/plugins/web/source/light/crawl/transport.ts +216 -0
  708. package/plugins/web/source/light/discovery/candidate-values.ts +63 -0
  709. package/plugins/web/source/light/discovery/feed-document.ts +127 -0
  710. package/plugins/web/source/light/discovery/html-links.ts +80 -0
  711. package/plugins/web/source/light/discovery/html-robots-directives.ts +29 -0
  712. package/plugins/web/source/light/discovery/markup-tree.ts +145 -0
  713. package/plugins/web/source/light/discovery/origin-dates.ts +71 -0
  714. package/plugins/web/source/light/discovery/sitemap-document.ts +63 -0
  715. package/plugins/web/source/light/documents/cache-policy.ts +28 -0
  716. package/plugins/web/source/light/documents/document-cache.ts +99 -0
  717. package/plugins/web/source/light/documents/document-charset.ts +89 -0
  718. package/plugins/web/source/light/documents/document-contract.ts +20 -0
  719. package/plugins/web/source/light/documents/document-reader.ts +75 -0
  720. package/plugins/web/source/light/documents/extract-document.ts +124 -0
  721. package/plugins/web/source/light/documents/http-cache-freshness.ts +68 -0
  722. package/plugins/web/source/light/documents/response-decoding.ts +120 -0
  723. package/plugins/web/source/light/ranking/document-ranking.ts +114 -0
  724. package/plugins/web/source/light/ranking/query-normalization.ts +69 -0
  725. package/plugins/web/source/light/search-collection.ts +136 -0
  726. package/plugins/web/source/light/search-frontier.ts +246 -0
  727. package/plugins/web/source/light/search-metadata.ts +84 -0
  728. package/plugins/web/source/light/search-service.ts +154 -0
  729. package/plugins/web/source/light/search-unavailable.ts +33 -0
  730. package/plugins/web/source/light/sources/catalog.ts +312 -0
  731. package/plugins/web/source/light/sources/source-definition.ts +9 -0
  732. package/plugins/web/source/light/sources/source-selection.ts +35 -0
  733. package/plugins/web/source/plugin.ts +70 -56
  734. package/plugins/web/source/public-http.ts +10 -1
  735. package/plugins/web/source/search-presentation.ts +63 -63
  736. package/plugins/web/source/search-service-selector.ts +31 -0
  737. package/plugins/web/source/search-service.ts +6 -0
  738. package/plugins/web/source/search-source-presentation.ts +76 -0
  739. package/plugins/web/source/search-types.ts +4 -0
  740. package/plugins/web/source/source-output-receipts.ts +267 -0
  741. package/plugins/web/source/source-receipt-budget.ts +51 -0
  742. package/plugins/web/source/source-receipt-contract.ts +18 -0
  743. package/plugins/web/src/index.cjs +3214 -288
  744. package/runtime.config.schema.json +30 -0
  745. package/src/runtime/README.md +107 -47
  746. package/dist/src/model-gateway/structured-output/budget.d.ts +0 -7
  747. package/dist/src/model-gateway/structured-output/budget.js +0 -20
  748. package/dist/src/model-gateway/structured-output/schema-character-estimator.d.ts +0 -1
  749. package/dist/src/model-gateway/structured-output/schema-character-estimator.js +0 -211
  750. package/dist/src/model-gateway/structured-output-budget.d.ts +0 -1
  751. package/dist/src/model-gateway/structured-output-budget.js +0 -1
@@ -0,0 +1,61 @@
1
+ export function lastPageOffset(total, pageSize) {
2
+ return Math.max(
3
+ 0,
4
+ Math.floor((Math.max(1, total) - 1) / pageSize) * pageSize,
5
+ );
6
+ }
7
+
8
+ export function previousPageOffsetAfterDelete(state) {
9
+ const remaining = Math.max(0, state.total - 1);
10
+ return state.offset >= remaining && state.offset > 0
11
+ ? Math.max(0, state.offset - state.limit)
12
+ : state.offset;
13
+ }
14
+
15
+ export function canUseMemoryEmbeddings(state) {
16
+ return state.enabled === true && state.available === true;
17
+ }
18
+
19
+ export function unavailableMemoryActionMessage(action) {
20
+ return `Enable an available embedding model to ${action} memories.`;
21
+ }
22
+
23
+ export function isMemoryConflictError(error) {
24
+ return (
25
+ error?.code === "long_term_memory_management_conflict" ||
26
+ error?.status === 409
27
+ );
28
+ }
29
+
30
+ export function isMemoryMissingError(error) {
31
+ return (
32
+ error?.code === "long_term_memory_management_not_found" ||
33
+ error?.status === 404
34
+ );
35
+ }
36
+
37
+ export function isAbortError(error) {
38
+ return error?.name === "AbortError";
39
+ }
40
+
41
+ export function managementErrorMessage(error) {
42
+ const messages = {
43
+ long_term_memory_disabled:
44
+ "Long-term memory is disabled. Existing memories remain available to view or delete.",
45
+ long_term_memory_unavailable:
46
+ "The embedding provider is unavailable. Existing memories remain available to view or delete.",
47
+ long_term_memory_management_conflict:
48
+ "This memory changed elsewhere. The latest stored version has been reloaded.",
49
+ long_term_memory_management_duplicate:
50
+ "An identical memory already exists.",
51
+ long_term_memory_management_input_invalid:
52
+ "Enter valid memory content and tags.",
53
+ long_term_memory_management_not_found: "This memory no longer exists.",
54
+ long_term_memory_management_sensitive_data:
55
+ "This memory may contain a password, key, token, or other sensitive data and was not saved.",
56
+ };
57
+ return (
58
+ messages[error?.code] ||
59
+ (error instanceof Error ? error.message : String(error))
60
+ );
61
+ }
@@ -0,0 +1,85 @@
1
+ import { lastPageOffset, previousPageOffsetAfterDelete } from "./policy.js";
2
+
3
+ export function createLongTermMemoryState(pageSize) {
4
+ return {
5
+ enabled: null,
6
+ available: null,
7
+ items: [],
8
+ total: 0,
9
+ offset: 0,
10
+ limit: pageSize,
11
+ query: "",
12
+ loading: false,
13
+ mutation: "",
14
+ message: "",
15
+ error: "",
16
+ editor: null,
17
+ };
18
+ }
19
+
20
+ export function snapshotLongTermMemoryState(state) {
21
+ const editorDraft = state.editor?.draft
22
+ ? Object.freeze({
23
+ ...state.editor.draft,
24
+ tags: Object.freeze([...state.editor.draft.tags]),
25
+ })
26
+ : null;
27
+ return Object.freeze({
28
+ ...state,
29
+ items: Object.freeze([...state.items]),
30
+ editor: state.editor
31
+ ? Object.freeze({
32
+ ...state.editor,
33
+ ...(editorDraft ? { draft: editorDraft } : {}),
34
+ })
35
+ : null,
36
+ });
37
+ }
38
+
39
+ export function applyMemoryRecords(state, payload) {
40
+ state.items = Array.isArray(payload?.items) ? payload.items : [];
41
+ state.total = Number.isSafeInteger(payload?.total) ? payload.total : 0;
42
+ if (!payload?.status) return;
43
+ state.enabled = payload.status.enabled === true;
44
+ state.available = payload.status.available === true;
45
+ }
46
+
47
+ export function applyMemoryAvailabilityFailure(state, error) {
48
+ if (error?.code === "long_term_memory_disabled") {
49
+ state.enabled = false;
50
+ return;
51
+ }
52
+ if (error?.code === "long_term_memory_unavailable") {
53
+ state.available = false;
54
+ }
55
+ }
56
+
57
+ export function applyCreatedMemory(state, record) {
58
+ const wasBrowsingList = state.query === "";
59
+ const previousOffset = state.offset;
60
+ state.query = "";
61
+ state.total += 1;
62
+ state.offset = lastPageOffset(state.total, state.limit);
63
+ const staysOnCurrentPage = wasBrowsingList && previousOffset === state.offset;
64
+ if (!record) state.items = [];
65
+ else if (staysOnCurrentPage) state.items = [...state.items, record];
66
+ else state.items = [record];
67
+ }
68
+
69
+ export function applyUpdatedMemory(state, record) {
70
+ if (!record) return;
71
+ state.items = state.items.map((item) =>
72
+ item.id === record.id ? record : item,
73
+ );
74
+ }
75
+
76
+ export function applyDeletedMemory(state, recordId) {
77
+ state.offset = previousPageOffsetAfterDelete(state);
78
+ state.total = Math.max(0, state.total - 1);
79
+ state.items = state.items.filter((record) => record.id !== recordId);
80
+ }
81
+
82
+ export function clearMemoryFeedback(state) {
83
+ state.message = "";
84
+ state.error = "";
85
+ }
@@ -0,0 +1,25 @@
1
+ export declare function formatDurationMs(value: unknown): string;
2
+ export declare function latestHealthEvent(
3
+ details: readonly Record<string, unknown>[],
4
+ ): Record<string, unknown> | undefined;
5
+
6
+ export interface OperationsControllerDependencies {
7
+ readonly dom: Readonly<{
8
+ runtimeStatus: Pick<HTMLElement, "innerHTML" | "textContent">;
9
+ runtimeLogs: Pick<HTMLElement, "textContent">;
10
+ healthStatus: Pick<HTMLElement, "innerHTML" | "textContent">;
11
+ }>;
12
+ readonly client: Readonly<{
13
+ getRuntimeStatus(): Promise<Record<string, unknown>>;
14
+ getRuntimeLogs(lines: number): Promise<Record<string, unknown>>;
15
+ getSystemHealth(): Promise<Record<string, unknown>>;
16
+ }>;
17
+ }
18
+
19
+ export declare function createOperationsController(
20
+ options: OperationsControllerDependencies,
21
+ ): {
22
+ loadRuntimeStatus(): Promise<void>;
23
+ loadRuntimeLogs(): Promise<void>;
24
+ loadSystemHealth(): Promise<void>;
25
+ };
@@ -0,0 +1,58 @@
1
+ import type { ConversationSessionMessage } from "./conversation-session-controller.js";
2
+
3
+ export type RealtimeEventRecord = Record<string, unknown>;
4
+
5
+ export interface RealtimeEventControllerState {
6
+ activeRequestId: string;
7
+ currentSessionId: string;
8
+ contextWindowByRequest: Map<string, Record<string, unknown>>;
9
+ taskProgressByRequest: Map<string, Record<string, unknown>>;
10
+ lastSeqByRequest: Map<string, number>;
11
+ events: RealtimeEventRecord[];
12
+ }
13
+
14
+ export interface RealtimeEventControllerOptions {
15
+ state: RealtimeEventControllerState;
16
+ shell: {
17
+ showToast(message: string, tone?: string): void;
18
+ };
19
+ selectedEnvironmentId(): string;
20
+ handleSteerAcknowledgement(message: RealtimeEventRecord): boolean;
21
+ shouldAcceptMessage(message: RealtimeEventRecord): boolean;
22
+ applySessionReadState(sessionId: unknown, readState: unknown): void;
23
+ activeAssistantForRequest(requestId: string): ConversationSessionMessage;
24
+ addOrMergeMessage(message: ConversationSessionMessage): void;
25
+ normalizeChatMessage(
26
+ message: RealtimeEventRecord,
27
+ ): ConversationSessionMessage;
28
+ renderMessages(): void;
29
+ renderContextWindow?(): void;
30
+ scheduleMessageRender(): void;
31
+ scheduleThinkingRender(): void;
32
+ cancelScheduledMessageRender(): void;
33
+ cancelScheduledThinkingRender(): void;
34
+ forgetThinkingDisclosure(messageId: string): void;
35
+ markCurrentSessionReadSoon(): void;
36
+ applySessionTitleUpdate(sessionId: unknown, title: unknown): void;
37
+ setMessageActivityStatus(message: string): void;
38
+ updateComposerSendState(): void;
39
+ drainQueuedComposerMessage(input: {
40
+ environmentId: string;
41
+ sessionId: string;
42
+ terminalRequestId: string;
43
+ }): void | Promise<void>;
44
+ loadSessions(): void | Promise<unknown>;
45
+ }
46
+
47
+ export declare function normalizeRealtimeMessage(
48
+ rawMessage: unknown,
49
+ ): RealtimeEventRecord;
50
+ export declare function taskStatusClass(status: unknown): string;
51
+ export declare function createRealtimeEventController(
52
+ options: RealtimeEventControllerOptions,
53
+ ): {
54
+ handle(rawMessage: unknown): void;
55
+ recordControlEvent(event: RealtimeEventRecord): void;
56
+ recordEvent(message: RealtimeEventRecord): void;
57
+ trackSeq(message: RealtimeEventRecord): void;
58
+ };
@@ -4,25 +4,33 @@ import {
4
4
  eventTone,
5
5
  formatEventDetail,
6
6
  formatEventLabel,
7
- getPlanItemPayload,
8
- getPlanPayload,
9
- getRecord,
10
7
  isLowValueActivityEvent,
11
8
  } from "../lib/event-presentation.js";
12
9
  import { textOf } from "../lib/text-format.js";
13
10
  import { normalizeRealtimeMessage } from "../lib/realtime-message.js";
11
+ import { reduceTaskProgress } from "../lib/task-progress.js";
12
+ import { projectWebSourceEvent } from "../lib/web-source-event.js";
14
13
 
15
14
  export { normalizeRealtimeMessage } from "../lib/realtime-message.js";
15
+ export { taskStatusClass } from "../lib/task-progress.js";
16
16
 
17
- export function taskStatusClass(status) {
18
- const normalized = textOf(status).trim().toLowerCase();
19
- if (normalized === "done" || normalized === "completed") return "done";
20
- if (normalized === "in_progress" || normalized === "active") {
21
- return "active";
22
- }
23
- if (normalized === "blocked" || normalized === "failed") return "failed";
24
- if (normalized === "superseded") return "muted";
25
- return "pending";
17
+ function hasOriginalEventSequence(value) {
18
+ return Number.isSafeInteger(value) && value > 0;
19
+ }
20
+
21
+ function hasRecordedOriginalEvent(events, requestId, eventSequence) {
22
+ if (eventSequence === undefined) return false;
23
+ return events.some(
24
+ (event) =>
25
+ event.requestId === requestId && event.eventSequence === eventSequence,
26
+ );
27
+ }
28
+
29
+ function canMergeUnsequencedActivity(previous, key, eventSequence, webSources) {
30
+ if (eventSequence !== undefined) return false;
31
+ if (webSources || previous?.webSources) return false;
32
+ if (!previous?.key || previous.key !== key) return false;
33
+ return !hasOriginalEventSequence(previous.eventSequence);
26
34
  }
27
35
 
28
36
  export function createRealtimeEventController({
@@ -36,6 +44,7 @@ export function createRealtimeEventController({
36
44
  addOrMergeMessage,
37
45
  normalizeChatMessage,
38
46
  renderMessages,
47
+ renderContextWindow = () => {},
39
48
  scheduleMessageRender,
40
49
  scheduleThinkingRender,
41
50
  cancelScheduledMessageRender,
@@ -54,76 +63,12 @@ export function createRealtimeEventController({
54
63
  }
55
64
  }
56
65
 
57
- function mergeTaskProgressItem(items, nextItem) {
58
- const normalizedTitle = nextItem.title.trim().toLowerCase();
59
- const normalizedId = nextItem.id.trim();
60
- const existingIndex = items.findIndex((item) => {
61
- if (normalizedId && item.id === normalizedId) return true;
62
- return item.title.trim().toLowerCase() === normalizedTitle;
63
- });
64
- if (existingIndex < 0) {
65
- items.push(nextItem);
66
- return;
67
- }
68
- items[existingIndex] = {
69
- ...items[existingIndex],
70
- ...nextItem,
71
- id: nextItem.id || items[existingIndex].id,
72
- title: nextItem.title || items[existingIndex].title,
73
- status: nextItem.status || items[existingIndex].status,
74
- };
75
- }
76
-
77
66
  function updateTaskProgress(message) {
78
- const plan = getPlanPayload(message);
79
- const item = getPlanItemPayload(message);
80
- const snapshot = getRecord(message.progressSnapshot);
81
- const planningSignal =
82
- Boolean(plan || item || snapshot) ||
83
- textOf(message.name).startsWith("Planner ") ||
84
- textOf(message.name).startsWith("Development progress:");
85
- if (!planningSignal) return;
86
- const requestId = textOf(message.requestId) || state.activeRequestId;
87
- if (!requestId) return;
88
- const current = state.taskProgressByRequest.get(requestId) || {
89
- requestId,
90
- summary: "",
91
- total: 0,
92
- completed: 0,
93
- requestSatisfaction: "",
94
- items: [],
95
- hasSignal: false,
96
- };
97
- const next = {
98
- ...current,
99
- requestId,
100
- summary:
101
- plan?.summary || textOf(snapshot?.summary) || current.summary || "",
102
- total: plan?.total ?? current.total,
103
- completed: plan?.completed ?? current.completed,
104
- requestSatisfaction:
105
- textOf(snapshot?.requestSatisfaction) || current.requestSatisfaction,
106
- items: [...current.items],
107
- hasSignal: true,
108
- };
109
- for (const planItem of plan?.items || [])
110
- mergeTaskProgressItem(next.items, planItem);
111
- if (item) mergeTaskProgressItem(next.items, item);
112
- if (!next.summary && Array.isArray(snapshot?.requestedWork)) {
113
- next.summary =
114
- snapshot.requestedWork.map(textOf).filter(Boolean)[0] || "";
115
- }
116
- if (!next.total && next.items.length > 0) next.total = next.items.length;
117
- if (next.items.length > 0) {
118
- next.completed = Math.max(
119
- next.completed,
120
- next.items.filter((entry) => entry.status === "done").length,
121
- );
122
- }
123
- next.activeItem =
124
- next.items.find((entry) => taskStatusClass(entry.status) === "active")
125
- ?.title || "";
126
- state.taskProgressByRequest.set(requestId, next);
67
+ const requestId = textOf(message.requestId);
68
+ const current = state.taskProgressByRequest.get(requestId);
69
+ const next = reduceTaskProgress(current, message);
70
+ if (next && next !== current)
71
+ state.taskProgressByRequest.set(requestId, next);
127
72
  }
128
73
 
129
74
  function updateContextWindow(message) {
@@ -195,7 +140,7 @@ export function createRealtimeEventController({
195
140
  lastCompaction,
196
141
  pendingCompaction: lastCompaction ? null : current.pendingCompaction,
197
142
  });
198
- return;
143
+ return true;
199
144
  }
200
145
  if (eventName === "context.window.provider_usage") {
201
146
  state.contextWindowByRequest.set(requestId, {
@@ -211,19 +156,21 @@ export function createRealtimeEventController({
211
156
  totalTokens: Number(message.totalTokens),
212
157
  },
213
158
  });
214
- return;
159
+ return true;
215
160
  }
216
161
  if (eventName === "context.compaction.started") {
217
162
  state.contextWindowByRequest.set(requestId, {
218
163
  ...current,
219
164
  requestId,
220
165
  pendingCompaction: {
221
- beforePercent: Number.isFinite(Number(message.beforeUsedContextPercent))
166
+ beforePercent: Number.isFinite(
167
+ Number(message.beforeUsedContextPercent),
168
+ )
222
169
  ? Number(message.beforeUsedContextPercent)
223
170
  : current.snapshot?.usedContextPercent,
224
171
  },
225
172
  });
226
- return;
173
+ return true;
227
174
  }
228
175
  if (eventName === "context.compaction.completed") {
229
176
  const beforePercent = Number(message.beforeUsedContextPercent);
@@ -237,7 +184,7 @@ export function createRealtimeEventController({
237
184
  ? { beforePercent, afterPercent }
238
185
  : current.lastCompaction,
239
186
  });
240
- return;
187
+ return true;
241
188
  }
242
189
  if (eventName === "context.compaction.failed") {
243
190
  state.contextWindowByRequest.set(requestId, {
@@ -245,12 +192,22 @@ export function createRealtimeEventController({
245
192
  requestId,
246
193
  pendingCompaction: null,
247
194
  });
195
+ return true;
248
196
  }
249
197
  }
250
198
 
251
199
  function recordEvent(message) {
200
+ const requestId = textOf(message.requestId) || state.activeRequestId;
201
+ const eventSequence = hasOriginalEventSequence(message.eventSequence)
202
+ ? message.eventSequence
203
+ : undefined;
204
+ if (hasRecordedOriginalEvent(state.events, requestId, eventSequence)) {
205
+ trackSeq(message);
206
+ return;
207
+ }
252
208
  updateTaskProgress(message);
253
- updateContextWindow(message);
209
+ const contextWindowUpdated = updateContextWindow(message);
210
+ if (contextWindowUpdated) renderContextWindow();
254
211
  const eventName = textOf(message.name || message.rawType || message.type);
255
212
  if (isLowValueActivityEvent(message)) {
256
213
  trackSeq(message);
@@ -259,10 +216,14 @@ export function createRealtimeEventController({
259
216
  const name = formatEventLabel(message);
260
217
  const summary = formatEventDetail(message);
261
218
  const tone = eventTone(message);
262
- const key = eventKeyFor(message, name, tone);
263
- const requestId = textOf(message.requestId) || state.activeRequestId;
219
+ const stage = textOf(message.stage);
220
+ const phase = textOf(message.phase);
221
+ const key = eventKeyFor({ ...message, requestId }, name, tone);
222
+ const webSources = projectWebSourceEvent(message);
264
223
  const lastEvent = state.events[state.events.length - 1];
265
- if (lastEvent?.key && lastEvent.key === key) {
224
+ if (
225
+ canMergeUnsequencedActivity(lastEvent, key, eventSequence, webSources)
226
+ ) {
266
227
  lastEvent.count = (lastEvent.count || 1) + 1;
267
228
  lastEvent.summary = summary;
268
229
  lastEvent.updatedAt = Date.now();
@@ -278,15 +239,19 @@ export function createRealtimeEventController({
278
239
  count: 1,
279
240
  lastSeqNo:
280
241
  typeof message.seqNo === "number" ? message.seqNo : undefined,
242
+ eventSequence,
281
243
  updatedAt: Date.now(),
282
244
  type: message.type,
283
245
  rawType: message.rawType,
284
246
  eventName,
247
+ stage,
248
+ phase,
285
249
  name,
286
250
  summary,
287
251
  tone,
288
252
  tool: textOf(message.tool),
289
253
  approvalId: textOf(message.approvalId),
254
+ ...(webSources ? { webSources } : {}),
290
255
  payload: {
291
256
  plan: message.plan,
292
257
  item: message.item,
@@ -0,0 +1,32 @@
1
+ export type RuntimeAvailability = Record<string, unknown> & {
2
+ status: string;
3
+ message?: string;
4
+ showGuide?: boolean;
5
+ };
6
+
7
+ export interface RuntimeOnboardingControllerDependencies {
8
+ readonly state: {
9
+ runtimeAvailability: RuntimeAvailability;
10
+ };
11
+ readonly guide: Readonly<{
12
+ bind(options?: { onCheckAgain?: () => void | Promise<void> }): void;
13
+ focusAction(): void;
14
+ render(setup: RuntimeAvailability): void;
15
+ }>;
16
+ readonly reloadModels: () => void | Promise<void>;
17
+ readonly setMessageStatus: (message: string) => void;
18
+ readonly onStateChange?: () => void;
19
+ }
20
+
21
+ export declare function createRuntimeOnboardingController(
22
+ options: RuntimeOnboardingControllerDependencies,
23
+ ): {
24
+ applyCatalog(payload: Record<string, unknown>): void;
25
+ beginCatalogLoad(): void;
26
+ bind(): void;
27
+ catalogUnavailable(error: unknown): void;
28
+ isReady(): boolean;
29
+ presentSubmissionBlock(block: { message?: string } | null): void;
30
+ render(): void;
31
+ submissionBlock(): { code: string; message: string } | null;
32
+ };
@@ -0,0 +1,177 @@
1
+ export type AgentMode = "auto" | "fast" | "reasoning" | "deep";
2
+ export type ToolPermissionMode = "ask" | "full_access";
3
+
4
+ export declare function normalizeAgentMode(mode: unknown): AgentMode;
5
+ export declare function normalizeToolPermissionMode(
6
+ value: unknown,
7
+ ): ToolPermissionMode;
8
+
9
+ export interface RuntimeSelectionOptionSurface {
10
+ readonly value: string;
11
+ readonly textContent: string | null;
12
+ }
13
+
14
+ export interface RuntimeSelectionOptionCollection extends Iterable<RuntimeSelectionOptionSurface> {
15
+ readonly length: number;
16
+ readonly [index: number]: RuntimeSelectionOptionSurface | undefined;
17
+ }
18
+
19
+ export interface RuntimeSelectionEnvironmentSelectSurface {
20
+ value: string;
21
+ innerHTML: string;
22
+ readonly options: RuntimeSelectionOptionCollection;
23
+ append(option: unknown): unknown;
24
+ }
25
+
26
+ export interface RuntimeSelectionModelSelectSurface {
27
+ value: string;
28
+ innerHTML: string;
29
+ disabled: boolean;
30
+ readonly options: RuntimeSelectionOptionCollection;
31
+ appendChild(option: unknown): unknown;
32
+ }
33
+
34
+ export interface RuntimeSelectionClassListSurface {
35
+ toggle(token: string, force?: boolean): unknown;
36
+ }
37
+
38
+ export interface RuntimeSelectionPickerButtonSurface {
39
+ hidden: boolean;
40
+ innerHTML: string;
41
+ title: string;
42
+ readonly classList: RuntimeSelectionClassListSurface;
43
+ setAttribute(name: string, value: string): void;
44
+ }
45
+
46
+ export interface RuntimeSelectionControlButtonSurface {
47
+ innerHTML: string;
48
+ title: string;
49
+ disabled: boolean;
50
+ readonly classList: RuntimeSelectionClassListSurface;
51
+ setAttribute(name: string, value: string): void;
52
+ focus(): void;
53
+ }
54
+
55
+ export interface RuntimeSelectionAgentModeButtonSurface {
56
+ innerHTML: string;
57
+ disabled: boolean;
58
+ readonly classList: RuntimeSelectionClassListSurface;
59
+ setAttribute(name: string, value: string): void;
60
+ focus(): void;
61
+ }
62
+
63
+ export interface RuntimeSelectionPickerMenuSurface {
64
+ hidden: boolean;
65
+ innerHTML: string;
66
+ readonly classList: RuntimeSelectionClassListSurface;
67
+ }
68
+
69
+ export interface RuntimeSelectionControlMenuSurface extends RuntimeSelectionPickerMenuSurface {
70
+ setAttribute(name: string, value: string): void;
71
+ querySelectorAll(selector: string): Iterable<Element>;
72
+ }
73
+
74
+ export interface RuntimeSelectionControllerDependencies {
75
+ readonly state: {
76
+ config: Readonly<{
77
+ environments?: readonly Readonly<{
78
+ id?: unknown;
79
+ label?: unknown;
80
+ }>[];
81
+ defaultEnvironmentId?: unknown;
82
+ }> | null;
83
+ pinnedSessionIds: readonly string[];
84
+ sessionModes: Record<string, Record<string, unknown>>;
85
+ sessionModels: Record<string, unknown>;
86
+ lastModelByEnvironment: Record<string, unknown>;
87
+ agentMode: AgentMode;
88
+ supportedAgentModes: AgentMode[];
89
+ agentModeMenuOpen: boolean;
90
+ permissionModeMenuOpen: boolean;
91
+ agentPickerOpen: boolean;
92
+ modelProfiles: Array<
93
+ Record<string, unknown> & {
94
+ id: string;
95
+ label?: string;
96
+ provider?: string;
97
+ supportsImageInput?: boolean;
98
+ capabilities?: Readonly<{
99
+ inputModalities?: readonly unknown[];
100
+ }>;
101
+ }
102
+ >;
103
+ defaultModelProfileId: string;
104
+ currentSessionId: string;
105
+ };
106
+ readonly dom: Readonly<{
107
+ environmentSelect: RuntimeSelectionEnvironmentSelectSurface;
108
+ modelSelect: RuntimeSelectionModelSelectSurface;
109
+ agentPickerButton: RuntimeSelectionPickerButtonSurface;
110
+ agentPickerMenu: RuntimeSelectionPickerMenuSurface;
111
+ permissionModeButton: RuntimeSelectionControlButtonSurface;
112
+ permissionModeMenu: RuntimeSelectionControlMenuSurface;
113
+ agentModeButton: RuntimeSelectionAgentModeButtonSurface;
114
+ agentModeMenu: RuntimeSelectionControlMenuSurface;
115
+ }>;
116
+ readonly preferences: Readonly<{
117
+ loadPinnedSessions(): string[];
118
+ loadSessionModes(
119
+ normalize: (value: unknown) => ToolPermissionMode,
120
+ ): Record<string, Record<string, unknown>>;
121
+ saveSessionModes(modes: Record<string, Record<string, unknown>>): void;
122
+ loadModelPreferences(): {
123
+ sessionModels: Record<string, unknown>;
124
+ lastModelByEnvironment: Record<string, unknown>;
125
+ };
126
+ saveModelPreferences(
127
+ sessionModels: Record<string, unknown>,
128
+ lastModelByEnvironment: Record<string, unknown>,
129
+ ): void;
130
+ }>;
131
+ readonly modelSelector: Readonly<{
132
+ sync(): void;
133
+ }>;
134
+ readonly client: Readonly<{
135
+ getAgentMode(environmentId: string): Promise<Record<string, unknown>>;
136
+ setAgentMode(
137
+ mode: AgentMode,
138
+ environmentId: string,
139
+ ): Promise<Record<string, unknown>>;
140
+ listModels(environmentId: string): Promise<Record<string, unknown>>;
141
+ }>;
142
+ readonly recordControlEvent: (event: {
143
+ type: "control";
144
+ name: string;
145
+ tone: "failed";
146
+ summary: string;
147
+ }) => void;
148
+ readonly onAttachmentPolicyChange: () => void;
149
+ readonly onModelCatalogLoading?: () => void;
150
+ readonly onModelCatalogLoaded?: (payload: Record<string, unknown>) => void;
151
+ readonly onModelCatalogUnavailable?: (error: unknown) => void;
152
+ }
153
+
154
+ export declare function createRuntimeSelectionController(
155
+ options: RuntimeSelectionControllerDependencies,
156
+ ): {
157
+ applyModelSelection(): void;
158
+ clearSessionMode(sessionId: string): void;
159
+ configuredEnvironmentOptions(): Array<{ value: string; label: string }>;
160
+ currentToolPermissionMode(): ToolPermissionMode;
161
+ environmentOptions(): Array<{ value: string; label: string }>;
162
+ loadAgentMode(): Promise<boolean>;
163
+ loadModels(): Promise<boolean>;
164
+ loadPreferences(): void;
165
+ rememberModelSelection(): void;
166
+ renderAgentMode(): void;
167
+ renderAgentPicker(): void;
168
+ renderEnvironmentOptions(): void;
169
+ renderModels(): void;
170
+ renderPermissionMode(): void;
171
+ saveModelPreferences(): void;
172
+ selectedEnvironmentId(): string;
173
+ selectedModelPreference(): Record<string, unknown> | null;
174
+ selectedModelSupportsImageInput(): boolean;
175
+ setAgentMode(mode: AgentMode): Promise<boolean>;
176
+ setToolPermissionMode(mode: ToolPermissionMode): void;
177
+ };