@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
@@ -1,8 +1,11 @@
1
- import { WORKER_CAPABILITY_INTENT_MAX_LENGTH, WORKER_DECISION_ACTIONS, WORKER_RESULT_MAX_LENGTH, } from "./contracts.js";
1
+ import { WORKER_DECISION_ACTIONS, } from "./contracts.js";
2
2
  import { traceWorkerDecisionAccepted, traceWorkerDecisionRejected, traceWorkerEnvelopeAccepted, traceWorkerEnvelopeRejected, } from "./diagnostics.js";
3
- import { mergeWorkerCapabilityControls, partitionWorkerCapabilityControlsSchema, validateWorkerCapabilityRemainingControls, validateWorkerCapabilitySelectionControls, } from "../../orchestration/worker-capabilities/index.js";
4
3
  import { readStructuredDecisionEnvelope } from "../../model/structured-decision-envelope.js";
5
- import { workerCapabilityBatchExecutionSlotId } from "./format.js";
4
+ import { buildAcceptedWorkerDecision } from "./parser/accepted-decision.js";
5
+ import { readWorkerDecisionAction, validateWorkerDecisionAction, } from "./parser/action-validation.js";
6
+ import { readWorkerDecisionRecord } from "./parser/decision-shape-validation.js";
7
+ import { validatePendingSelectionOptions } from "./parser/pending-capability-selection-validation.js";
8
+ import { createWorkerDecisionIssue } from "./parser/validation-contract.js";
6
9
  export function parseWorkerDecisionOutput(text, diagnostic, options = {}) {
7
10
  const decisionPhase = options.decisionPhase ?? "capability_selection";
8
11
  const pendingCapabilitySelection = options.pendingCapabilitySelection;
@@ -19,26 +22,22 @@ export function parseWorkerDecisionOutput(text, diagnostic, options = {}) {
19
22
  decoded = JSON.parse(text.trim());
20
23
  }
21
24
  catch {
22
- return rejectEnvelope(text.length, [issue("worker_output_not_json", "decision")], diagnostic);
25
+ return rejectWorkerDecisionEnvelope(text.length, [createWorkerDecisionIssue("worker_output_not_json", "decision")], diagnostic);
23
26
  }
24
- if (!asRecord(decoded)) {
25
- return rejectEnvelope(text.length, [issue("worker_output_not_object", "decision")], diagnostic);
27
+ const decodedRecord = readWorkerDecisionRecord(decoded);
28
+ if (!decodedRecord) {
29
+ return rejectWorkerDecisionEnvelope(text.length, [createWorkerDecisionIssue("worker_output_not_object", "decision")], diagnostic);
26
30
  }
27
- const record = readStructuredDecisionEnvelope(decoded);
31
+ const record = readStructuredDecisionEnvelope(decodedRecord);
28
32
  if (!record) {
29
- return rejectEnvelope(text.length, [issue("worker_output_envelope_invalid", "decision")], diagnostic);
30
- }
31
- if (diagnostic) {
32
- traceWorkerEnvelopeAccepted({
33
- diagnostic,
34
- outputLength: text.length,
35
- keyCount: Object.keys(record).length,
36
- });
33
+ return rejectWorkerDecisionEnvelope(text.length, [createWorkerDecisionIssue("worker_output_envelope_invalid", "decision")], diagnostic);
37
34
  }
35
+ traceAcceptedWorkerDecisionEnvelope(record, text.length, diagnostic);
38
36
  const issues = [];
39
37
  const selectedAction = readWorkerDecisionAction(record.action);
40
38
  const context = {
41
39
  decisionPhase,
40
+ allowedActions: options.allowedActions ?? WORKER_DECISION_ACTIONS,
42
41
  pendingCapabilitySelection,
43
42
  pendingCapabilityBatchSelection,
44
43
  availableCapabilities: Array.isArray(options.availableCapabilities)
@@ -46,380 +45,41 @@ export function parseWorkerDecisionOutput(text, diagnostic, options = {}) {
46
45
  : [],
47
46
  maxBatchCapabilityExecutions: options.maxBatchCapabilityExecutions ?? 0,
48
47
  };
49
- let validation = {};
50
- if (!selectedAction) {
51
- issues.push(issue("worker_action_invalid", "decision.action"));
52
- }
53
- else {
54
- validation = validateSelectedAction(selectedAction, record, context, issues);
55
- }
48
+ const validation = validateWorkerDecisionAction(selectedAction, record, context, issues);
56
49
  if (issues.length > 0 || !selectedAction) {
57
- if (diagnostic) {
58
- traceWorkerDecisionRejected({
59
- diagnostic,
60
- issues,
61
- ...(selectedAction ? { selectedAction } : {}),
62
- });
63
- }
50
+ traceRejectedWorkerDecision(selectedAction, issues, diagnostic);
64
51
  return {
65
52
  ok: false,
66
53
  stage: "domain_parser",
67
54
  issues: Object.freeze(issues),
68
55
  };
69
56
  }
70
- const decision = buildAcceptedDecision(selectedAction, record, context, validation);
57
+ const decision = buildAcceptedWorkerDecision(selectedAction, record, context, validation);
71
58
  const accepted = deepFreeze(structuredClone(decision));
72
59
  if (diagnostic) {
73
60
  traceWorkerDecisionAccepted({ diagnostic, decision: accepted });
74
61
  }
75
62
  return { ok: true, decision: accepted };
76
63
  }
77
- function readWorkerDecisionAction(value) {
78
- return value === "return_result" ||
79
- value === "return_failure" ||
80
- value === "invoke_capability" ||
81
- value === "invoke_capabilities"
82
- ? value
83
- : undefined;
84
- }
85
- function validateSelectedAction(action, record, context, issues) {
86
- switch (action) {
87
- case "return_result":
88
- validateReturnResultDecision(record, issues);
89
- return {};
90
- case "return_failure":
91
- validateReturnFailureDecision(record, issues);
92
- return {};
93
- case "invoke_capability":
94
- return validateSingleCapabilityDecision(record, context, issues);
95
- case "invoke_capabilities":
96
- return validateCapabilityBatchDecision(record, context, issues);
97
- }
98
- }
99
- function validateReturnResultDecision(record, issues) {
100
- exactKeys(record, ["action"], issues);
101
- }
102
- function validateReturnFailureDecision(record, issues) {
103
- exactKeys(record, ["action", "reason"], issues);
104
- validateBoundedText(record.reason, WORKER_RESULT_MAX_LENGTH, "worker_result_invalid", "decision.reason", issues);
105
- }
106
- function validateSingleCapabilityDecision(record, context, issues) {
107
- if (context.decisionPhase === "capability_execution" &&
108
- !context.pendingCapabilitySelection) {
109
- issues.push(issue("worker_capability_refinement_invalid", "decision.action"));
110
- }
111
- const invocation = parseCapabilityInvocation({
112
- record,
113
- path: "decision",
114
- includesActionKey: true,
115
- observationOnly: false,
116
- executionRequiresPendingInvocation: true,
117
- decisionPhase: context.decisionPhase,
118
- availableCapabilities: context.availableCapabilities,
119
- pendingInvocation: context.pendingCapabilitySelection,
120
- pendingSlotId: undefined,
121
- }, issues);
122
- return {
123
- acceptedControls: invocation.controls,
124
- acceptedSelectionControls: invocation.selectionControls,
125
- };
126
- }
127
- function validateCapabilityBatchDecision(record, context, issues) {
128
- exactKeys(record, ["action", "invocations"], issues);
129
- const invocations = context.decisionPhase === "capability_execution"
130
- ? readPendingCapabilityBatchExecutionSlots(record.invocations, context.pendingCapabilityBatchSelection?.length)
131
- : Array.isArray(record.invocations)
132
- ? record.invocations
133
- : undefined;
134
- if (!validCapabilityBatchSize(invocations, context)) {
135
- issues.push(issue("worker_capability_batch_size_invalid", "decision.invocations"));
136
- return {};
137
- }
138
- const acceptedBatchInvocations = [];
139
- invocations.forEach((input, index) => {
140
- const pendingSlotId = context.decisionPhase === "capability_execution"
141
- ? workerCapabilityBatchExecutionSlotId(index)
142
- : undefined;
143
- const path = pendingSlotId
144
- ? `decision.invocations.${pendingSlotId}`
145
- : `decision.invocations[${index}]`;
146
- const invocationRecord = asRecord(input);
147
- if (!invocationRecord) {
148
- issues.push(issue("worker_capability_batch_item_invalid", path));
149
- return;
150
- }
151
- const pendingInvocation = context.decisionPhase === "capability_execution"
152
- ? context.pendingCapabilityBatchSelection[index]
153
- : undefined;
154
- const invocation = parseCapabilityInvocation({
155
- record: invocationRecord,
156
- path,
157
- includesActionKey: false,
158
- observationOnly: true,
159
- executionRequiresPendingInvocation: false,
160
- decisionPhase: context.decisionPhase,
161
- availableCapabilities: context.availableCapabilities,
162
- pendingInvocation,
163
- pendingSlotId,
164
- }, issues);
165
- if (invocation.selectedCapability?.effect === "observation" &&
166
- (pendingInvocation !== undefined ||
167
- validGeneratedCapabilityIdentity(invocationRecord)) &&
168
- (context.decisionPhase === "capability_execution"
169
- ? invocation.controls
170
- : invocation.controlsPartition?.selectionControlIds.length
171
- ? invocation.selectionControls
172
- : true)) {
173
- acceptedBatchInvocations.push(Object.freeze({
174
- capabilityId: pendingInvocation?.capabilityId ??
175
- invocationRecord.capabilityId,
176
- intent: pendingInvocation?.intent ??
177
- invocationRecord.intent.trim(),
178
- ...(context.decisionPhase === "capability_execution"
179
- ? { controls: invocation.controls }
180
- : invocation.selectionControls
181
- ? { selectionControls: invocation.selectionControls }
182
- : {}),
183
- }));
184
- }
64
+ function traceAcceptedWorkerDecisionEnvelope(record, outputLength, diagnostic) {
65
+ if (!diagnostic)
66
+ return;
67
+ traceWorkerEnvelopeAccepted({
68
+ diagnostic,
69
+ outputLength,
70
+ keyCount: Object.keys(record).length,
185
71
  });
186
- return { acceptedBatchInvocations };
187
- }
188
- function validCapabilityBatchSize(invocations, context) {
189
- if (!invocations)
190
- return false;
191
- if (context.decisionPhase === "capability_execution") {
192
- return (context.pendingCapabilityBatchSelection !== undefined &&
193
- invocations.length === context.pendingCapabilityBatchSelection.length);
194
- }
195
- return (invocations.length >= 2 &&
196
- Number.isInteger(context.maxBatchCapabilityExecutions) &&
197
- context.maxBatchCapabilityExecutions >= 2 &&
198
- invocations.length <= context.maxBatchCapabilityExecutions);
199
- }
200
- function validGeneratedCapabilityIdentity(invocation) {
201
- return (typeof invocation.capabilityId === "string" &&
202
- typeof invocation.intent === "string" &&
203
- invocation.intent.trim().length > 0 &&
204
- invocation.intent.length <= WORKER_CAPABILITY_INTENT_MAX_LENGTH);
205
- }
206
- function parseCapabilityInvocation(params, issues) {
207
- let selectedCapability;
208
- if (params.pendingInvocation) {
209
- selectedCapability = params.availableCapabilities.find((capability) => capability.capabilityId === params.pendingInvocation.capabilityId);
210
- }
211
- else if (params.decisionPhase === "capability_execution" &&
212
- params.executionRequiresPendingInvocation) {
213
- selectedCapability = undefined;
214
- }
215
- else if (typeof params.record.capabilityId !== "string") {
216
- issues.push(issue("worker_capability_id_invalid", `${params.path}.capabilityId`));
217
- }
218
- else if (!(selectedCapability = params.availableCapabilities.find((capability) => capability.capabilityId === params.record.capabilityId))) {
219
- issues.push(issue("worker_capability_unavailable", `${params.path}.capabilityId`));
220
- }
221
- else if (params.observationOnly &&
222
- selectedCapability.effect !== "observation") {
223
- issues.push(issue("worker_capability_batch_effect_invalid", `${params.path}.capabilityId`));
224
- }
225
- if (params.decisionPhase === "capability_selection") {
226
- validateBoundedText(params.record.intent, WORKER_CAPABILITY_INTENT_MAX_LENGTH, "worker_capability_intent_invalid", `${params.path}.intent`, issues);
227
- }
228
- const controlsPartition = partitionCapabilityControls(selectedCapability, `${params.path}.capabilityId`, issues);
229
- exactKeys(params.record, expectedCapabilityInvocationKeys(params, controlsPartition), issues, params.path);
230
- const selectionControls = validateSelectionControls(params, selectedCapability, controlsPartition, issues);
231
- const controls = validateExecutionControls(params, selectedCapability, controlsPartition, issues);
232
- return {
233
- selectedCapability,
234
- controlsPartition,
235
- selectionControls,
236
- controls,
237
- };
238
- }
239
- function partitionCapabilityControls(selectedCapability, capabilityPath, issues) {
240
- if (!selectedCapability)
241
- return undefined;
242
- const partition = partitionWorkerCapabilityControlsSchema(selectedCapability.controls, selectedCapability.selectionControlIds);
243
- if (!partition.ok) {
244
- issues.push(issue("worker_capability_controls_schema_invalid", capabilityPath));
245
- return undefined;
246
- }
247
- return partition.value;
248
- }
249
- function expectedCapabilityInvocationKeys(params, controlsPartition) {
250
- const actionKey = params.includesActionKey ? ["action"] : [];
251
- if (params.decisionPhase === "capability_execution") {
252
- return [...actionKey, "controls"];
253
- }
254
- return [
255
- ...actionKey,
256
- "capabilityId",
257
- "intent",
258
- ...(controlsPartition?.selectionControlIds.length
259
- ? ["selectionControls"]
260
- : []),
261
- ];
262
- }
263
- function validateSelectionControls(params, selectedCapability, controlsPartition, issues) {
264
- if (!selectedCapability ||
265
- (params.observationOnly && selectedCapability.effect !== "observation") ||
266
- !controlsPartition ||
267
- params.decisionPhase !== "capability_selection" ||
268
- controlsPartition.selectionControlIds.length === 0) {
269
- return undefined;
270
- }
271
- const selectionControls = validateWorkerCapabilitySelectionControls(controlsPartition, normalizeGeneratedCapabilityControls(params.record.selectionControls, controlsPartition.selectionSchema));
272
- if (!selectionControls.ok) {
273
- issues.push(workerCapabilityControlsIssue({
274
- issueCode: selectionControls.issueCode,
275
- controlId: selectionControls.controlId,
276
- path: selectionControls.controlId
277
- ? `${params.path}.selectionControls.${selectionControls.controlId}`
278
- : `${params.path}.selectionControls`,
279
- capability: selectedCapability,
280
- schema: controlsPartition.selectionSchema,
281
- pendingSlotId: params.pendingSlotId,
282
- }));
283
- return undefined;
284
- }
285
- return selectionControls.value;
286
72
  }
287
- function validateExecutionControls(params, selectedCapability, controlsPartition, issues) {
288
- if (selectedCapability &&
289
- (!params.observationOnly || selectedCapability.effect === "observation") &&
290
- controlsPartition &&
291
- params.decisionPhase === "capability_execution") {
292
- const remainingControls = validateWorkerCapabilityRemainingControls(controlsPartition, normalizeGeneratedCapabilityControls(params.record.controls, controlsPartition.remainingSchema));
293
- const mergedControls = remainingControls.ok
294
- ? mergeWorkerCapabilityControls(controlsPartition, {
295
- selectionControls: params.pendingInvocation?.selectionControls ?? {},
296
- remainingControls: remainingControls.value,
297
- })
298
- : remainingControls;
299
- if (!mergedControls.ok) {
300
- issues.push(workerCapabilityControlsIssue({
301
- issueCode: mergedControls.issueCode,
302
- controlId: mergedControls.controlId,
303
- path: mergedControls.controlId
304
- ? `${params.path}.controls.${mergedControls.controlId}`
305
- : `${params.path}.controls`,
306
- capability: selectedCapability,
307
- schema: controlsPartition.remainingSchema,
308
- pendingSlotId: params.pendingSlotId,
309
- }));
310
- return undefined;
311
- }
312
- return mergedControls.value;
313
- }
314
- if (params.decisionPhase === "capability_execution" &&
315
- !asRecord(params.record.controls)) {
316
- issues.push(issue("worker_capability_controls_not_object", `${params.path}.controls`));
317
- }
318
- return undefined;
319
- }
320
- function buildAcceptedDecision(action, record, context, validation) {
321
- if (action === "return_result") {
322
- return { action: "return_result" };
323
- }
324
- if (action === "return_failure") {
325
- return {
326
- action: "return_failure",
327
- reason: record.reason.trim(),
328
- };
329
- }
330
- if (action === "invoke_capability") {
331
- return {
332
- action: "invoke_capability",
333
- capabilityId: context.pendingCapabilitySelection?.capabilityId ??
334
- record.capabilityId,
335
- intent: context.pendingCapabilitySelection?.intent ??
336
- record.intent.trim(),
337
- ...(context.decisionPhase === "capability_execution"
338
- ? { controls: validation.acceptedControls }
339
- : validation.acceptedSelectionControls
340
- ? { selectionControls: validation.acceptedSelectionControls }
341
- : {}),
342
- };
343
- }
344
- return {
345
- action: "invoke_capabilities",
346
- invocations: Object.freeze(validation.acceptedBatchInvocations.map((invocation) => context.decisionPhase === "capability_execution"
347
- ? Object.freeze({
348
- capabilityId: invocation.capabilityId,
349
- intent: invocation.intent,
350
- controls: invocation.controls,
351
- })
352
- : Object.freeze({
353
- capabilityId: invocation.capabilityId,
354
- intent: invocation.intent,
355
- ...(invocation.selectionControls
356
- ? { selectionControls: invocation.selectionControls }
357
- : {}),
358
- }))),
359
- };
360
- }
361
- function readPendingCapabilityBatchExecutionSlots(value, expectedCount) {
362
- const record = asRecord(value);
363
- if (!record || expectedCount === undefined)
364
- return undefined;
365
- const slotIds = Array.from({ length: expectedCount }, (_, index) => workerCapabilityBatchExecutionSlotId(index));
366
- const actualSlotIds = Object.keys(record);
367
- if (actualSlotIds.length !== slotIds.length ||
368
- actualSlotIds.some((slotId) => !slotIds.includes(slotId))) {
369
- return undefined;
370
- }
371
- return slotIds.map((slotId) => record[slotId]);
372
- }
373
- function validatePendingSelectionOptions(options) {
374
- const hasSingle = options.pendingCapabilitySelection !== undefined;
375
- const hasBatch = options.pendingCapabilityBatchSelection !== undefined;
376
- if (options.decisionPhase === "capability_selection") {
377
- if (hasSingle || hasBatch) {
378
- throw new Error("worker_pending_capability_selection_unexpected");
379
- }
380
- return;
381
- }
382
- if (hasSingle === hasBatch) {
383
- throw new Error("worker_pending_capability_selection_invalid");
384
- }
385
- if (options.pendingCapabilitySelection) {
386
- const pending = options.pendingCapabilitySelection;
387
- const descriptor = options.availableCapabilities.find(({ capabilityId }) => capabilityId === pending.capabilityId);
388
- if (pending.intent.trim() !== pending.intent ||
389
- pending.intent.length === 0 ||
390
- pending.intent.length > WORKER_CAPABILITY_INTENT_MAX_LENGTH ||
391
- !descriptor ||
392
- !validPendingSelectionControls(pending, descriptor)) {
393
- throw new Error("worker_pending_capability_selection_invalid");
394
- }
73
+ function traceRejectedWorkerDecision(selectedAction, issues, diagnostic) {
74
+ if (!diagnostic)
395
75
  return;
396
- }
397
- const pendingBatch = options.pendingCapabilityBatchSelection;
398
- if (!Array.isArray(pendingBatch) ||
399
- pendingBatch.length < 2 ||
400
- !Number.isInteger(options.maxBatchCapabilityExecutions) ||
401
- pendingBatch.length > options.maxBatchCapabilityExecutions ||
402
- pendingBatch.some((pending) => {
403
- const descriptor = options.availableCapabilities.find(({ capabilityId }) => capabilityId === pending.capabilityId);
404
- return (!descriptor ||
405
- descriptor.effect !== "observation" ||
406
- pending.intent.trim() !== pending.intent ||
407
- pending.intent.length === 0 ||
408
- pending.intent.length > WORKER_CAPABILITY_INTENT_MAX_LENGTH ||
409
- !validPendingSelectionControls(pending, descriptor));
410
- })) {
411
- throw new Error("worker_pending_capability_batch_selection_invalid");
412
- }
413
- }
414
- function validPendingSelectionControls(pending, descriptor) {
415
- const partition = partitionWorkerCapabilityControlsSchema(descriptor.controls, descriptor.selectionControlIds);
416
- if (!partition.ok)
417
- return false;
418
- const expected = partition.value.selectionControlIds.length > 0;
419
- return (Object.hasOwn(pending, "selectionControls") === expected &&
420
- validateWorkerCapabilitySelectionControls(partition.value, pending.selectionControls ?? {}).ok);
76
+ traceWorkerDecisionRejected({
77
+ diagnostic,
78
+ issues,
79
+ ...(selectedAction ? { selectedAction } : {}),
80
+ });
421
81
  }
422
- function rejectEnvelope(outputLength, issues, diagnostic) {
82
+ function rejectWorkerDecisionEnvelope(outputLength, issues, diagnostic) {
423
83
  if (diagnostic) {
424
84
  traceWorkerEnvelopeRejected({ diagnostic, outputLength, issues });
425
85
  }
@@ -429,60 +89,6 @@ function rejectEnvelope(outputLength, issues, diagnostic) {
429
89
  issues: Object.freeze([...issues]),
430
90
  };
431
91
  }
432
- function exactKeys(record, expectedKeys, issues, path = "decision") {
433
- const expected = new Set(expectedKeys);
434
- const actual = Object.keys(record);
435
- if (actual.length !== expected.size ||
436
- actual.some((key) => !expected.has(key))) {
437
- issues.push(issue("worker_decision_shape_invalid", path));
438
- }
439
- }
440
- function normalizeGeneratedCapabilityControls(value, schema) {
441
- const record = asRecord(value);
442
- if (!record)
443
- return value;
444
- const required = new Set(schema.required);
445
- return Object.fromEntries(Object.entries(record).filter(([controlId, controlValue]) => controlValue !== null ||
446
- required.has(controlId) ||
447
- !Object.prototype.hasOwnProperty.call(schema.properties, controlId)));
448
- }
449
- function validateBoundedText(value, maximumLength, code, path, issues) {
450
- const normalized = typeof value === "string" ? value.trim() : "";
451
- if (typeof value !== "string" ||
452
- normalized.length === 0 ||
453
- value.length > maximumLength) {
454
- issues.push(issue(code, path));
455
- }
456
- }
457
- function asRecord(value) {
458
- return value !== null && typeof value === "object" && !Array.isArray(value)
459
- ? value
460
- : undefined;
461
- }
462
- function workerCapabilityControlsIssue(params) {
463
- const code = `worker_capability_${params.issueCode}`;
464
- if (params.issueCode !== "controls_unknown" &&
465
- params.issueCode !== "controls_required_missing") {
466
- return issue(code, params.path);
467
- }
468
- const pendingBinding = params.pendingSlotId
469
- ? `Pending slot ${JSON.stringify(params.pendingSlotId)} is frozen to capabilityId ${JSON.stringify(params.capability.capabilityId)}.`
470
- : `Pending capabilityId is ${JSON.stringify(params.capability.capabilityId)}.`;
471
- const problem = params.issueCode === "controls_unknown"
472
- ? `Control ${JSON.stringify(params.controlId)} is not allowed for this capability.`
473
- : `Required control ${JSON.stringify(params.controlId)} is missing for this capability.`;
474
- return issue(code, params.path, `${pendingBinding} ${problem} Allowed control IDs: ${JSON.stringify(Object.keys(params.schema.properties))}. Required control IDs: ${JSON.stringify(params.schema.required)}.`);
475
- }
476
- function issue(code, path, message) {
477
- return {
478
- code,
479
- path,
480
- message: message ??
481
- (code === "worker_action_invalid"
482
- ? `Action must be one of: ${WORKER_DECISION_ACTIONS.join(", ")}.`
483
- : `Worker decision failed ${code}.`),
484
- };
485
- }
486
92
  function deepFreeze(value, seen = new WeakSet()) {
487
93
  if (typeof value !== "object" || value === null || seen.has(value)) {
488
94
  return value;
@@ -0,0 +1,8 @@
1
+ import type { SemanticCompactionDependencyResult } from "../../context/semantic-compaction/dependency-results.js";
2
+ export type WorkerPayloadDependencyResult = Readonly<Pick<SemanticCompactionDependencyResult, "resultRef" | "producerCallId" | "roleId" | "outcome" | "summary" | "semanticCheckpoints">>;
3
+ export type WorkerPayloadDependencyInput = Readonly<{
4
+ dependencyResults?: readonly WorkerPayloadDependencyResult[];
5
+ }>;
6
+ /** Keeps role lineage out of the raw capability-payload authoring boundary. */
7
+ export declare function projectWorkerPayloadDependencyResults(dependencyResults: readonly SemanticCompactionDependencyResult[]): readonly WorkerPayloadDependencyResult[];
8
+ export declare function projectWorkerPayloadDependencyInput(dependencyResults: readonly SemanticCompactionDependencyResult[]): WorkerPayloadDependencyInput;
@@ -0,0 +1,19 @@
1
+ /** Keeps role lineage out of the raw capability-payload authoring boundary. */
2
+ export function projectWorkerPayloadDependencyResults(dependencyResults) {
3
+ return Object.freeze(dependencyResults.map((result) => Object.freeze({
4
+ resultRef: result.resultRef,
5
+ producerCallId: result.producerCallId,
6
+ roleId: result.roleId,
7
+ outcome: result.outcome,
8
+ summary: result.summary,
9
+ ...(result.semanticCheckpoints
10
+ ? { semanticCheckpoints: result.semanticCheckpoints }
11
+ : {}),
12
+ })));
13
+ }
14
+ export function projectWorkerPayloadDependencyInput(dependencyResults) {
15
+ const projected = projectWorkerPayloadDependencyResults(dependencyResults);
16
+ return projected.length > 0
17
+ ? Object.freeze({ dependencyResults: projected })
18
+ : Object.freeze({});
19
+ }
@@ -5,6 +5,8 @@ export declare function buildWorkerCapabilityExecutionInstructions(options?: Rea
5
5
  selectedCapabilityBatchExecution?: boolean;
6
6
  hasDependencyResults?: boolean;
7
7
  hasRequestToolResults?: boolean;
8
+ returnResultAvailable?: boolean;
9
+ returnFailureAvailable?: boolean;
8
10
  }>): string;
9
11
  export declare function buildWorkerResultInstructions(): string;
10
12
  export declare function buildWorkerResultRepairHint(params: RawModelRepairHintInput): string;
@@ -14,6 +16,7 @@ export declare function buildWorkerDecisionInstructions(options?: Readonly<{
14
16
  hasCapabilityResult?: boolean;
15
17
  hasDependencyResults?: boolean;
16
18
  hasRequestToolResults?: boolean;
19
+ hasOperationSupervision?: boolean;
17
20
  selectedCapabilityExecution?: boolean;
18
21
  selectedCapabilityBatchExecution?: boolean;
19
22
  hasCapabilitySelectionRejection?: boolean;