@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
@@ -17,22 +17,35 @@ Dependencies flow in one direction:
17
17
 
18
18
  Controllers and components communicate through injected callbacks or values. They must not reach back into `app.js`; services must not depend on controllers or presentation code.
19
19
 
20
- `workspace-shell.js` is the single owner of workspace navigation. It owns the active Chat, Operations, or Config workspace, Conversations sheet visibility, Operations tab navigation, focus restoration, Escape handling, backdrop state, and related ARIA attributes. It must not own session data, request state, or Runtime transport.
20
+ `workspace-shell.js` is the single owner of workspace navigation. It owns the active Chat or Config workspace, responsive Conversations visibility, focus restoration, Escape handling, backdrop state, and related ARIA attributes. `conversation-sidebar-layout.js` resolves the sidebar presentation policy; `operations-section.js` owns the internal Runtime, Logs, and Health tabs within Configuration. These components must not own session data, request state, or Runtime transport.
21
21
 
22
22
  `conversation-activity.js` owns only request-scoped activity presentation. `realtime-event-controller.js` preserves sequence authority, associates events and progress with their exact `requestId`, and injects those values into the conversation view. `realtime-transport.js` only parses and transports frames; it does not reduce application state.
23
23
 
24
+ `composer-context-window.js` presents the existing context estimate as one compact composer indicator. It selects the active assistant request, or the newest conversation message only when it is a request-linked assistant message while idle. A pending user turn, an assistant message without a request ID, or missing metrics hides the indicator instead of falling back to an earlier request. Context metric updates refresh it independently of message tokens; session-view resets clear it. Estimated usage, provider-reported usage, and compaction remain distinct, and provider usage stays bound to the matching model invocation.
25
+
26
+ `composer-plan.js` presents the current user turn's Planner plan in a collapsed-by-default drawer above the composer. `composer-plan-model.js` selects request-linked progress from the current turn, including restored failed requests that have only a persisted user message; a new user turn hides earlier plans. Disclosure identity follows the selected request, so steering preserves expansion and list scroll; session resets clear the drawer. `task-progress.js` reduces structured plan events by request: full snapshots replace the baseline, later item changes are retained across overlapping replay, and completion counters never imply request or Reviewer success. Live events and stored replay use this same projection. Historical per-response progress remains available in Activity.
27
+
28
+ Activity counts tool invocations from `tool.started` entries and their recorded multiplicities before timeline display grouping. Completion, payload, and approval events remain visible but do not add tool invocations; terminal-only history does not invent missing starts. Failure-event counts retain their existing meaning.
29
+
30
+ Web sources appear in a separate Activity section alongside role cards and the event timeline. `web-source-event.js` projects only successful `web_search` and `web_fetch` completions; `web-sources.js` validates bounded plugin receipts and groups them by recorded call. `conversation-sources.js` renders links and retrieval/presentation states without interpreting answer text. Source-bearing events retain their own identity before display grouping, and stored session events use the same projection as live events. Session switching clears them with the existing Activity state.
31
+
32
+ The optional `meta.webSources` version 1 receipt describes the final bounded **tool output**, not whether a later model invocation consumed or cited it. Older events can show found/fetched URLs with unknown output visibility; absent or unsupported receipts never imply full content. Favicons are best-effort browser requests to the source origin's `/favicon.ico`, loaded lazily with no referrer and a local fallback. No third-party icon service or server proxy is used. Source URL policy rejects unsafe schemes and credentials, and prevents automatic image loads for local/private IP literals; origin DNS, redirects, cookies, and browser image policy remain browser concerns. Icons carry no evidence and never block tool execution.
33
+
24
34
  `conversation-session-controller.js` is the single owner of the active conversation view lifecycle: normalized message identity, session switching, stored-message hydration, request-event replay, read state, active assistant placeholders, and session/request realtime subscriptions. `chat-request-controller.js` owns starting one chat request, while `composer-submit-controller.js` owns the composer's selected action and busy/error lifecycle. `tool-approval-controller.js` owns approval state and transport; `tool-approval-card.js` owns its DOM presentation.
25
35
 
26
36
  The primary information architecture is chat-first:
27
37
 
28
38
  - the navigation rail is persistent;
29
- - Chat, Operations, and Config are mutually exclusive workspaces;
30
- - Conversations is the only transient sheet and never reduces the chat canvas;
39
+ - Chat and Config are mutually exclusive workspaces;
40
+ - Conversations is docked beside Chat from 1260 CSS pixels upward, with its own column and no modal backdrop;
41
+ - below that width, Conversations is the only transient sheet and overlays the chat canvas;
42
+ - Configuration always hides Conversations and uses the full content canvas;
31
43
  - request tools, progress, and failures remain attached to the corresponding assistant response;
32
- - Operations owns Runtime, Logs, and Health as full-canvas views;
33
- - Config remains a separate full-canvas destination.
44
+ - Configuration contains one Operations section with the existing Runtime, Logs, and Health views;
45
+ - the Operations section is a static sibling of the generated configuration dashboard, so dashboard rerenders cannot detach its controls or status nodes;
46
+ - internal Operations tab changes preserve configuration drafts; leaving Configuration remains guarded by the explicit discard check.
34
47
 
35
- Panel resizing and persisted panel widths are intentionally not part of this architecture. Only conversation discovery is an overlay; operational surfaces receive enough space to remain readable.
48
+ Panel resizing and persisted panel widths are intentionally not part of this architecture. Crossing the sidebar breakpoint closes transient drawer state and restores focus when its previous target becomes hidden.
36
49
 
37
50
  ## Styles
38
51
 
@@ -49,4 +62,4 @@ Keep responsive overrides last and avoid moving declarations between modules wit
49
62
 
50
63
  ## Contract boundary
51
64
 
52
- Visual components may format or group events, but they never accept transport frames or construct Runtime API payloads. Realtime frame parsing belongs to `realtime-transport.js`; request sequence and terminal-state reduction belong to `realtime-event-controller.js`; endpoint construction and HTTP payload serialization belong to `runtime-web-client.js`; and feature controllers own when those operations occur. Config remains explicit-save; presentation changes must never introduce autosave.
65
+ Visual components may format or group events, but they never accept transport frames or construct Runtime API payloads. Realtime frame parsing belongs to `realtime-transport.js`; request sequence and terminal-state reduction belong to `realtime-event-controller.js`; endpoint construction and HTTP payload serialization belong to `runtime-web-client.js` and its feature request modules; and feature controllers own when those operations occur. Config remains explicit-save; presentation changes must never introduce autosave.
@@ -3,6 +3,8 @@ import { createConfigWorkspace } from "./components/config-workspace.js";
3
3
  import { createComposerActions } from "./components/composer-actions.js";
4
4
  import { createModelSelector } from "./components/model-selector.js";
5
5
  import { createRuntimeSetupGuide } from "./components/runtime-setup-guide.js";
6
+ import { createLongTermMemorySetup } from "./components/long-term-memory-setup.js";
7
+ import { createLongTermMemoryManager } from "./components/long-term-memory/manager.js";
6
8
  import { createSessionActionsMenu } from "./components/session-actions-menu.js";
7
9
  import { createToolApprovalCard } from "./components/tool-approval-card.js";
8
10
  import { textOf } from "./lib/text-format.js";
@@ -24,6 +26,7 @@ import { createConversationSessionController } from "./controllers/conversation-
24
26
  import { createChatRequestController } from "./controllers/chat-request-controller.js";
25
27
  import { createToolApprovalController } from "./controllers/tool-approval-controller.js";
26
28
  import { createComposerSubmitController } from "./controllers/composer-submit-controller.js";
29
+ import { createLongTermMemoryController } from "./controllers/long-term-memory/controller.js";
27
30
 
28
31
  const state = {
29
32
  config: null,
@@ -65,16 +68,9 @@ const state = {
65
68
  const dom = {
66
69
  app: document.getElementById("app"),
67
70
  chatWorkspaceButton: document.getElementById("chatWorkspaceButton"),
68
- operationsWorkspaceButton: document.getElementById(
69
- "operationsWorkspaceButton",
70
- ),
71
71
  configWorkspaceButton: document.getElementById("configWorkspaceButton"),
72
72
  chatPanel: document.querySelector(".chat-panel"),
73
73
  sessionsPanel: document.querySelector(".sessions-panel"),
74
- operationsWorkspacePanel: document.getElementById("operationsWorkspacePanel"),
75
- closeOperationsWorkspaceButton: document.getElementById(
76
- "closeOperationsWorkspaceButton",
77
- ),
78
74
  configWorkspacePanel: document.getElementById("configWorkspacePanel"),
79
75
  closeConfigWorkspaceButton: document.getElementById(
80
76
  "closeConfigWorkspaceButton",
@@ -108,6 +104,8 @@ const dom = {
108
104
  attachmentInput: document.getElementById("attachmentInput"),
109
105
  attachmentPreview: document.getElementById("attachmentPreview"),
110
106
  composerInput: document.getElementById("composerInput"),
107
+ composerContextWindow: document.getElementById("composerContextWindow"),
108
+ composerPlan: document.getElementById("composerPlan"),
111
109
  composerSubmitControl: document.getElementById("composerSubmitControl"),
112
110
  sendButton: document.getElementById("sendButton"),
113
111
  sendButtonLabel: document.getElementById("sendButtonLabel"),
@@ -123,10 +121,6 @@ const dom = {
123
121
  refreshConfigButton: document.getElementById("refreshConfigButton"),
124
122
  configStatus: document.getElementById("configStatus"),
125
123
  configDashboard: document.getElementById("configDashboard"),
126
- configRawFileSelect: document.getElementById("configRawFileSelect"),
127
- configApplyRawButton: document.getElementById("configApplyRawButton"),
128
- configSaveRawButton: document.getElementById("configSaveRawButton"),
129
- configRawEditor: document.getElementById("configRawEditor"),
130
124
  panelBackdrop: document.getElementById("panelBackdrop"),
131
125
  toastRegion: document.getElementById("toastRegion"),
132
126
  operationsTabButtons: [
@@ -146,6 +140,7 @@ let composerQueueController;
146
140
  let composerSubmitController;
147
141
  let realtimeEvents;
148
142
  let conversationView;
143
+ let configWorkspace;
149
144
  const operationsController = createOperationsController({
150
145
  dom,
151
146
  client: runtimeClient,
@@ -190,6 +185,11 @@ const steerController = createSteerController({
190
185
 
191
186
  const shell = createWorkspaceShell({
192
187
  dom,
188
+ beforeWorkspaceChange: ({ from, to }) => {
189
+ if (from !== "config" || to === "config") return true;
190
+ if (!configWorkspace) return true;
191
+ return configWorkspace.prepareDiscardChanges("leave configuration");
192
+ },
193
193
  });
194
194
  const runtimeSetupGuide = createRuntimeSetupGuide({
195
195
  container: dom.runtimeSetupGuide,
@@ -263,8 +263,11 @@ conversationView = createConversationView({
263
263
  dom: {
264
264
  messagesList: dom.messagesList,
265
265
  jumpToLatestButton: dom.jumpToLatestButton,
266
+ composerContextWindow: dom.composerContextWindow,
267
+ composerPlan: dom.composerPlan,
266
268
  },
267
269
  getMessages: () => state.messages,
270
+ getActiveRequestId: () => state.activeRequestId,
268
271
  getActivityForMessage: (message) => ({
269
272
  events: state.events,
270
273
  taskProgress:
@@ -370,6 +373,7 @@ realtimeEvents = createRealtimeEventController({
370
373
  activeAssistantForRequest: conversationSession.activeAssistantForRequest,
371
374
  addOrMergeMessage: conversationSession.addOrMergeMessage,
372
375
  normalizeChatMessage: conversationSession.normalizeMessage,
376
+ renderContextWindow: () => conversationView.renderContextWindow(),
373
377
  renderMessages,
374
378
  scheduleMessageRender,
375
379
  scheduleThinkingRender,
@@ -422,6 +426,7 @@ const appEventBindings = createAppEventBindings({
422
426
  saveSessionId: saveSessionIdForEnvironment,
423
427
  selectedEnvironmentId,
424
428
  rememberModelSelection: rememberCurrentModelSelection,
429
+ invalidateSessionLoads: conversationSession.invalidateEnvironmentLoads,
425
430
  clearAttachments: clearPendingAttachments,
426
431
  resetLiveRequestView: conversationSession.resetLiveRequestView,
427
432
  setCurrentSessionTitle,
@@ -429,10 +434,13 @@ const appEventBindings = createAppEventBindings({
429
434
  subscribeSession,
430
435
  renderMessages,
431
436
  renderAgentPicker,
437
+ savedEnvironmentId,
438
+ beforeEnvironmentChange: () =>
439
+ configWorkspace.prepareDiscardChanges("change environment"),
432
440
  saveEnvironmentId,
433
441
  loadModels,
434
442
  loadAgentMode,
435
- loadRuntimeConfig: () => loadRuntimeConfig(),
443
+ loadRuntimeConfig: (options) => loadRuntimeConfig(options),
436
444
  restoreLastSession,
437
445
  configuredEnvironmentOptions,
438
446
  removeUnsupportedImages: removeUnsupportedPendingImages,
@@ -449,15 +457,46 @@ const appEventBindings = createAppEventBindings({
449
457
  },
450
458
  });
451
459
 
452
- const configWorkspace = createConfigWorkspace({
460
+ const longTermMemorySetup = createLongTermMemorySetup({
461
+ getEnvironmentId: selectedEnvironmentId,
462
+ loadStatus: (environmentId) =>
463
+ runtimeClient.loadLongTermMemoryStatus(environmentId),
464
+ discoverModels: (providerId, environmentId) =>
465
+ runtimeClient.discoverLongTermMemoryModels({
466
+ environmentId,
467
+ providerId,
468
+ }),
469
+ enableMemory: (input, environmentId) =>
470
+ runtimeClient.enableLongTermMemory({
471
+ environmentId,
472
+ ...input,
473
+ }),
474
+ disableMemory: (environmentId) =>
475
+ runtimeClient.disableLongTermMemory(environmentId),
476
+ recordControlEvent,
477
+ beginRuntimeMutation: () =>
478
+ configWorkspace?.beginExternalRuntimeMutation() ?? false,
479
+ refreshRuntimeConfig: () =>
480
+ configWorkspace?.refreshAfterExternalRuntimeMutation() ??
481
+ Promise.resolve(false),
482
+ endRuntimeMutation: () => configWorkspace?.endExternalRuntimeMutation(),
483
+ });
484
+
485
+ let longTermMemoryManager;
486
+ const longTermMemoryController = createLongTermMemoryController({
487
+ client: runtimeClient,
488
+ getEnvironmentId: selectedEnvironmentId,
489
+ render: (snapshot) => longTermMemoryManager?.render(snapshot),
490
+ });
491
+ longTermMemoryManager = createLongTermMemoryManager({
492
+ actions: longTermMemoryController,
493
+ });
494
+
495
+ configWorkspace = createConfigWorkspace({
453
496
  dom: {
454
497
  refreshConfigButton: dom.refreshConfigButton,
455
498
  configStatus: dom.configStatus,
456
499
  configDashboard: dom.configDashboard,
457
- configRawFileSelect: dom.configRawFileSelect,
458
- configApplyRawButton: dom.configApplyRawButton,
459
- configSaveRawButton: dom.configSaveRawButton,
460
- configRawEditor: dom.configRawEditor,
461
500
  },
462
501
  loadDashboard: () =>
463
502
  runtimeClient.loadConfigDashboard(selectedEnvironmentId()),
@@ -468,10 +507,15 @@ const configWorkspace = createConfigWorkspace({
468
507
  id,
469
508
  config,
470
509
  }),
510
+ memorySetup: longTermMemorySetup,
511
+ memoryManagement: {
512
+ load: () => longTermMemoryController.load(),
513
+ mount: (root) => longTermMemoryManager.mount(root),
514
+ },
471
515
  recordControlEvent,
472
516
  });
473
517
 
474
- const loadRuntimeConfig = () => configWorkspace.load();
518
+ const loadRuntimeConfig = (options) => configWorkspace.load(options);
475
519
 
476
520
  function setConnectionLabel(text, isError = false) {
477
521
  dom.connectionLabel.textContent = text;
@@ -0,0 +1,25 @@
1
+ import type {
2
+ ConversationActivityInput,
3
+ ConversationContextWindowModel,
4
+ } from "./conversation-activity.js";
5
+
6
+ export type ComposerContextWindowModel = ConversationContextWindowModel & {
7
+ requestId: string;
8
+ };
9
+
10
+ export declare function buildComposerContextWindowModel(options?: {
11
+ messages?: Array<{ role: string; requestId?: unknown }>;
12
+ activeRequestId?: unknown;
13
+ getActivityForMessage?(message: {
14
+ role: string;
15
+ requestId?: unknown;
16
+ }): Pick<ConversationActivityInput, "contextWindow">;
17
+ }): ComposerContextWindowModel | null;
18
+
19
+ export declare function createComposerContextWindow(options: {
20
+ container: HTMLElement;
21
+ documentRoot?: Document;
22
+ }): {
23
+ render(model: ComposerContextWindowModel | null): void;
24
+ reset(): void;
25
+ };
@@ -0,0 +1,155 @@
1
+ import { buildConversationActivityModel } from "./conversation-activity.js";
2
+ import { textOf } from "../lib/text-format.js";
3
+
4
+ export function buildComposerContextWindowModel({
5
+ messages = [],
6
+ activeRequestId = "",
7
+ getActivityForMessage = () => ({}),
8
+ } = {}) {
9
+ const activeId = textOf(activeRequestId);
10
+ const contextRequestCandidates = activeId
11
+ ? [...messages].reverse()
12
+ : messages.slice(-1);
13
+ const selectedMessage = contextRequestCandidates.find((message) => {
14
+ const isAssistantRequest =
15
+ message.role === "assistant" && Boolean(textOf(message.requestId));
16
+ if (!isAssistantRequest) return false;
17
+ if (!activeId) return true;
18
+ return message.requestId === activeId;
19
+ });
20
+ if (!selectedMessage) return null;
21
+ const requestId = textOf(selectedMessage.requestId);
22
+ const model = buildConversationActivityModel({
23
+ requestId,
24
+ contextWindow: getActivityForMessage(selectedMessage)?.contextWindow,
25
+ }).contextWindow;
26
+ if (!model) return null;
27
+ return { ...model, requestId };
28
+ }
29
+
30
+ function compactNumber(value) {
31
+ return new Intl.NumberFormat("en", { notation: "compact" }).format(value);
32
+ }
33
+
34
+ function formatPercent(value) {
35
+ return Number.isInteger(value) ? `${value}%` : `${value.toFixed(1)}%`;
36
+ }
37
+
38
+ export function createComposerContextWindow({
39
+ container,
40
+ documentRoot = document,
41
+ }) {
42
+ const button = documentRoot.createElement("button");
43
+ button.type = "button";
44
+ button.className = "composer-context-window-button";
45
+ button.setAttribute("aria-label", "Context window");
46
+ button.setAttribute("aria-describedby", "composerContextWindowTooltip");
47
+
48
+ const ring = documentRoot.createElement("span");
49
+ ring.className = "composer-context-window-ring";
50
+ ring.setAttribute("aria-hidden", "true");
51
+ button.appendChild(ring);
52
+
53
+ const tooltip = documentRoot.createElement("div");
54
+ tooltip.id = "composerContextWindowTooltip";
55
+ tooltip.className = "composer-context-window-tooltip";
56
+ tooltip.setAttribute("role", "tooltip");
57
+ tooltip.hidden = true;
58
+ const header = documentRoot.createElement("div");
59
+ header.className = "composer-context-window-header";
60
+ const title = documentRoot.createElement("span");
61
+ title.textContent = "Context window";
62
+ const percentage = documentRoot.createElement("span");
63
+ percentage.className = "composer-context-window-percentage";
64
+ header.append(title, percentage);
65
+ const detail = documentRoot.createElement("div");
66
+ const compaction = documentRoot.createElement("div");
67
+ compaction.className = "composer-context-window-compaction";
68
+ const provider = documentRoot.createElement("div");
69
+ tooltip.append(header, detail, compaction, provider);
70
+ container.replaceChildren(button, tooltip);
71
+
72
+ function hideDetails() {
73
+ tooltip.hidden = true;
74
+ container.classList.remove("open");
75
+ }
76
+
77
+ function showDetails() {
78
+ if (container.hidden) return;
79
+ tooltip.hidden = false;
80
+ container.classList.add("open");
81
+ }
82
+
83
+ container.addEventListener("pointerenter", showDetails);
84
+ container.addEventListener("pointerleave", () => {
85
+ if (documentRoot.activeElement === button) return;
86
+ hideDetails();
87
+ });
88
+ button.addEventListener("focus", showDetails);
89
+ button.addEventListener("blur", hideDetails);
90
+ button.addEventListener("click", showDetails);
91
+ documentRoot.addEventListener(
92
+ "keydown",
93
+ (event) => {
94
+ if (tooltip.hidden) return;
95
+ if (event.key !== "Escape") return;
96
+ event.preventDefault();
97
+ event.stopPropagation();
98
+ hideDetails();
99
+ },
100
+ true,
101
+ );
102
+ documentRoot.addEventListener("pointerdown", (event) => {
103
+ if (container.contains(event.target)) return;
104
+ hideDetails();
105
+ });
106
+
107
+ function reset() {
108
+ hideDetails();
109
+ container.hidden = true;
110
+ container.dataset.requestId = "";
111
+ container.classList.remove("rejected");
112
+ ring.style.setProperty("--context-used", "0%");
113
+ button.setAttribute("aria-label", "Context window");
114
+ percentage.textContent = "";
115
+ detail.textContent = "";
116
+ compaction.textContent = "";
117
+ provider.textContent = "";
118
+ }
119
+
120
+ function render(model) {
121
+ if (!model) {
122
+ reset();
123
+ return;
124
+ }
125
+ container.hidden = false;
126
+ container.dataset.requestId = model.requestId;
127
+ container.classList.toggle(
128
+ "rejected",
129
+ model.admissionOutcome === "rejected",
130
+ );
131
+ const usedPercent = formatPercent(model.usedContextPercent);
132
+ button.setAttribute("aria-label", `Context window: ${usedPercent} used`);
133
+ ring.style.setProperty(
134
+ "--context-used",
135
+ `${Math.max(0, Math.min(100, model.usedContextPercent))}%`,
136
+ );
137
+ percentage.textContent = usedPercent;
138
+ detail.textContent = `${compactNumber(model.estimatedInputTokens)} / ${compactNumber(
139
+ model.contextWindowTokens,
140
+ )} estimated input tokens · ${formatPercent(model.remainingContextPercent)} left · ${
141
+ model.modelStep || model.profileId
142
+ }`;
143
+ compaction.hidden = !model.compaction;
144
+ compaction.textContent = model.compaction
145
+ ? `Compaction ${formatPercent(model.compaction.beforePercent)} → ${formatPercent(model.compaction.afterPercent)}`
146
+ : "";
147
+ provider.hidden = !model.providerUsage;
148
+ provider.textContent = model.providerUsage
149
+ ? `Provider reported ${compactNumber(model.providerUsage.inputTokens)} input · ${compactNumber(model.providerUsage.outputTokens)} output tokens`
150
+ : "";
151
+ }
152
+
153
+ reset();
154
+ return { render, reset };
155
+ }
@@ -0,0 +1,9 @@
1
+ import type { ComposerPlanModel } from "../lib/composer-plan-model.js";
2
+
3
+ export declare function createComposerPlan(options?: {
4
+ container?: HTMLElement | null;
5
+ documentRoot?: Document;
6
+ }): {
7
+ render(model: ComposerPlanModel | null): void;
8
+ reset(): void;
9
+ };
@@ -0,0 +1,128 @@
1
+ const STATUS_LABELS = {
2
+ pending: "Pending",
3
+ active: "In progress",
4
+ done: "Completed",
5
+ blocked: "Blocked",
6
+ superseded: "Superseded",
7
+ };
8
+
9
+ const STATUS_SYMBOLS = {
10
+ pending: "○",
11
+ active: "◌",
12
+ done: "✓",
13
+ blocked: "×",
14
+ superseded: "−",
15
+ };
16
+
17
+ export function createComposerPlan({
18
+ container,
19
+ documentRoot = globalThis.document,
20
+ } = {}) {
21
+ if (!container || !documentRoot) return { render() {}, reset() {} };
22
+
23
+ function element(tag, className, value = "") {
24
+ const node = documentRoot.createElement(tag);
25
+ node.className = className;
26
+ node.textContent = value;
27
+ return node;
28
+ }
29
+
30
+ const details = element("details", "composer-plan-details");
31
+ const summary = element("summary", "composer-plan-toggle");
32
+ const label = element("span", "composer-plan-label", "Planning");
33
+ const preview = element("span", "composer-plan-preview");
34
+ preview.setAttribute("dir", "auto");
35
+ const previewIcon = element("span", "composer-plan-status");
36
+ previewIcon.setAttribute("aria-hidden", "true");
37
+ const chevron = element("span", "composer-plan-chevron", "⌄");
38
+ chevron.setAttribute("aria-hidden", "true");
39
+ summary.append(previewIcon, label, preview, chevron);
40
+
41
+ const body = element("div", "composer-plan-body");
42
+ const header = element("div", "composer-plan-header");
43
+ const title = element("p", "composer-plan-title");
44
+ title.setAttribute("dir", "auto");
45
+ const counter = element("span", "composer-plan-counter");
46
+ header.append(title, counter);
47
+ const list = element("ol", "composer-plan-items");
48
+ const placeholder = element(
49
+ "p",
50
+ "composer-plan-placeholder",
51
+ "Preparing tasks...",
52
+ );
53
+ body.append(header, list, placeholder);
54
+ details.append(summary, body);
55
+ container.classList.add("composer-plan");
56
+ container.replaceChildren(details);
57
+ let currentTurnKey = "";
58
+ let renderedItems = "";
59
+
60
+ function reset() {
61
+ container.hidden = true;
62
+ container.dataset.requestId = "";
63
+ details.open = false;
64
+ body.scrollTop = 0;
65
+ currentTurnKey = "";
66
+ renderedItems = "";
67
+ preview.textContent = "";
68
+ title.textContent = "";
69
+ counter.textContent = "";
70
+ list.replaceChildren();
71
+ }
72
+
73
+ function renderItems(items) {
74
+ const signature = JSON.stringify(items);
75
+ if (signature === renderedItems) return;
76
+ const scrollTop = body.scrollTop;
77
+ const rows = items.map((item) => {
78
+ const row = element("li", `composer-plan-item is-${item.status}`);
79
+ row.dataset.itemId = item.id;
80
+ const icon = element(
81
+ "span",
82
+ "composer-plan-status",
83
+ STATUS_SYMBOLS[item.status],
84
+ );
85
+ icon.setAttribute("aria-hidden", "true");
86
+ const itemTitle = element("span", "composer-plan-item-title", item.title);
87
+ itemTitle.setAttribute("dir", "auto");
88
+ const status = element(
89
+ "span",
90
+ "composer-plan-item-status",
91
+ STATUS_LABELS[item.status],
92
+ );
93
+ row.append(icon, itemTitle, status);
94
+ return row;
95
+ });
96
+ list.replaceChildren(...rows);
97
+ body.scrollTop = scrollTop;
98
+ renderedItems = signature;
99
+ }
100
+
101
+ function render(model) {
102
+ if (!model) {
103
+ reset();
104
+ return;
105
+ }
106
+ if (currentTurnKey !== model.turnKey) {
107
+ details.open = false;
108
+ body.scrollTop = 0;
109
+ currentTurnKey = model.turnKey;
110
+ }
111
+ container.hidden = false;
112
+ container.dataset.requestId = model.requestId;
113
+ preview.textContent = model.preview;
114
+ previewIcon.className = `composer-plan-status is-${model.previewStatus}`;
115
+ previewIcon.textContent = STATUS_SYMBOLS[model.previewStatus];
116
+ title.textContent = model.summary;
117
+ title.hidden = !model.summary;
118
+ counter.textContent = `${model.completed}/${model.total} completed`;
119
+ counter.hidden = model.total === 0;
120
+ header.hidden = !model.summary && model.total === 0;
121
+ list.hidden = model.items.length === 0;
122
+ placeholder.hidden = model.items.length > 0;
123
+ renderItems(model.items);
124
+ }
125
+
126
+ reset();
127
+ return { render, reset };
128
+ }