@abot-ai/runtime 1.0.0 → 1.1.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 (549) hide show
  1. package/README.md +17 -3
  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/cli/abot.js +11 -2
  30. package/dist/src/model-gateway/client/embeddings.d.ts +3 -0
  31. package/dist/src/model-gateway/client/embeddings.js +48 -0
  32. package/dist/src/model-gateway/client.d.ts +3 -1
  33. package/dist/src/model-gateway/client.js +5 -0
  34. package/dist/src/model-gateway/embeddings/constants.d.ts +1 -0
  35. package/dist/src/model-gateway/embeddings/constants.js +1 -0
  36. package/dist/src/model-gateway/embeddings/discovery.d.ts +10 -0
  37. package/dist/src/model-gateway/embeddings/discovery.js +39 -0
  38. package/dist/src/model-gateway/embeddings/execution.d.ts +16 -0
  39. package/dist/src/model-gateway/embeddings/execution.js +64 -0
  40. package/dist/src/model-gateway/embeddings/fingerprint.d.ts +3 -0
  41. package/dist/src/model-gateway/embeddings/fingerprint.js +36 -0
  42. package/dist/src/model-gateway/embeddings/profile.d.ts +11 -0
  43. package/dist/src/model-gateway/embeddings/profile.js +37 -0
  44. package/dist/src/model-gateway/embeddings/server-handler.d.ts +3 -0
  45. package/dist/src/model-gateway/embeddings/server-handler.js +89 -0
  46. package/dist/src/model-gateway/embeddings/validation.d.ts +7 -0
  47. package/dist/src/model-gateway/embeddings/validation.js +69 -0
  48. package/dist/src/model-gateway/index.d.ts +5 -3
  49. package/dist/src/model-gateway/index.js +3 -1
  50. package/dist/src/model-gateway/providers/contracts.d.ts +27 -1
  51. package/dist/src/model-gateway/providers/ollama/adapter.js +4 -0
  52. package/dist/src/model-gateway/providers/ollama/base-url.d.ts +1 -0
  53. package/dist/src/model-gateway/providers/ollama/base-url.js +4 -0
  54. package/dist/src/model-gateway/providers/ollama/embedding-models.d.ts +2 -0
  55. package/dist/src/model-gateway/providers/ollama/embedding-models.js +31 -0
  56. package/dist/src/model-gateway/providers/ollama/embeddings.d.ts +2 -0
  57. package/dist/src/model-gateway/providers/ollama/embeddings.js +43 -0
  58. package/dist/src/model-gateway/providers/ollama/request-diagnostics.js +2 -1
  59. package/dist/src/model-gateway/providers/openai/adapter.js +2 -0
  60. package/dist/src/model-gateway/providers/openai/embeddings.d.ts +2 -0
  61. package/dist/src/model-gateway/providers/openai/embeddings.js +87 -0
  62. package/dist/src/model-gateway/providers/openai/payload.js +5 -8
  63. package/dist/src/model-gateway/server/contracts.d.ts +5 -3
  64. package/dist/src/model-gateway/server/create-server.js +9 -0
  65. package/dist/src/model-gateway/server/errors.js +34 -0
  66. package/dist/src/model-gateway/server/index.d.ts +2 -0
  67. package/dist/src/model-gateway/server/index.js +2 -0
  68. package/dist/src/model-gateway/server/provider-fetch.d.ts +5 -3
  69. package/dist/src/model-gateway/server/provider-fetch.js +3 -1
  70. package/dist/src/model-gateway/server/request-body.d.ts +1 -1
  71. package/dist/src/model-gateway/types.d.ts +39 -0
  72. package/dist/src/plugin-contract/manifest.d.ts +1 -0
  73. package/dist/src/runtime/adapters/index.d.ts +4 -0
  74. package/dist/src/runtime/adapters/index.js +4 -0
  75. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.d.ts +2 -0
  76. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.js +77 -0
  77. package/dist/src/runtime/adapters/long-term-memory/file-lock/cleanup.d.ts +4 -0
  78. package/dist/src/runtime/adapters/long-term-memory/file-lock/cleanup.js +52 -0
  79. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.d.ts +31 -0
  80. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.js +17 -0
  81. package/dist/src/runtime/adapters/long-term-memory/file-lock/install.d.ts +1 -0
  82. package/dist/src/runtime/adapters/long-term-memory/file-lock/install.js +36 -0
  83. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-record.d.ts +2 -0
  84. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-record.js +114 -0
  85. package/dist/src/runtime/adapters/long-term-memory/file-lock/snapshot.d.ts +2 -0
  86. package/dist/src/runtime/adapters/long-term-memory/file-lock/snapshot.js +103 -0
  87. package/dist/src/runtime/adapters/long-term-memory/file-lock.d.ts +2 -0
  88. package/dist/src/runtime/adapters/long-term-memory/file-lock.js +10 -0
  89. package/dist/src/runtime/adapters/long-term-memory/file-repository.d.ts +2 -0
  90. package/dist/src/runtime/adapters/long-term-memory/file-repository.js +57 -0
  91. package/dist/src/runtime/adapters/long-term-memory/in-memory-repository.d.ts +2 -0
  92. package/dist/src/runtime/adapters/long-term-memory/in-memory-repository.js +21 -0
  93. package/dist/src/runtime/adapters/long-term-memory/onboarding-config-repository.d.ts +5 -0
  94. package/dist/src/runtime/adapters/long-term-memory/onboarding-config-repository.js +60 -0
  95. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.d.ts +8 -0
  96. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.js +34 -0
  97. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.d.ts +7 -1
  98. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.js +54 -25
  99. package/dist/src/runtime/adapters/registered-tool-normal-invocations/executor.js +18 -4
  100. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.d.ts +6 -1
  101. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.js +25 -12
  102. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/action-fingerprint.d.ts +22 -0
  103. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/action-fingerprint.js +65 -0
  104. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +44 -0
  105. package/dist/src/runtime/adapters/registered-tool-normal-invocations.d.ts +1 -1
  106. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/catalog.js +14 -4
  107. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.js +218 -87
  108. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/failure-outcome-fingerprint.d.ts +7 -0
  109. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/failure-outcome-fingerprint.js +84 -0
  110. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.d.ts +5 -4
  111. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.js +7 -1
  112. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.d.ts +35 -0
  113. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.js +32 -0
  114. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.d.ts +3 -3
  115. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.js +13 -8
  116. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.d.ts +5 -4
  117. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.js +4 -2
  118. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.js +12 -4
  119. package/dist/src/runtime/composition.d.ts +3 -0
  120. package/dist/src/runtime/composition.js +5 -2
  121. package/dist/src/runtime/config/builders.js +34 -1
  122. package/dist/src/runtime/config/effective-model-config-validation.js +9 -0
  123. package/dist/src/runtime/config/embedding-profiles.d.ts +5 -0
  124. package/dist/src/runtime/config/embedding-profiles.js +66 -0
  125. package/dist/src/runtime/config/fields.js +22 -0
  126. package/dist/src/runtime/config/long-term-memory.d.ts +9 -0
  127. package/dist/src/runtime/config/long-term-memory.js +71 -0
  128. package/dist/src/runtime/config/runner/config-normalization.d.ts +16 -0
  129. package/dist/src/runtime/config/runner/config-normalization.js +109 -0
  130. package/dist/src/runtime/config/runner/loader.d.ts +1 -1
  131. package/dist/src/runtime/config/runner/loader.js +2 -69
  132. package/dist/src/runtime/config/runner/model-policy.js +3 -0
  133. package/dist/src/runtime/config/runner/schema-version.d.ts +14 -0
  134. package/dist/src/runtime/config/runner/schema-version.js +35 -0
  135. package/dist/src/runtime/config/runner/versioned-config.d.ts +2 -0
  136. package/dist/src/runtime/config/runner/versioned-config.js +51 -0
  137. package/dist/src/runtime/config/schema.js +36 -0
  138. package/dist/src/runtime/config/types.d.ts +1 -0
  139. package/dist/src/runtime/config/validation/environment-config-validation.d.ts +1 -0
  140. package/dist/src/runtime/config/validation/environment-config-validation.js +41 -0
  141. package/dist/src/runtime/config/validation/model-invocation-config-validation.d.ts +2 -0
  142. package/dist/src/runtime/config/validation/model-invocation-config-validation.js +64 -0
  143. package/dist/src/runtime/config/validation/model-invocation-override-validation.d.ts +2 -0
  144. package/dist/src/runtime/config/validation/model-invocation-override-validation.js +72 -0
  145. package/dist/src/runtime/config/validation/model-profile-validation.d.ts +4 -0
  146. package/dist/src/runtime/config/validation/model-profile-validation.js +87 -0
  147. package/dist/src/runtime/config/validation/model-registry-validation.d.ts +2 -0
  148. package/dist/src/runtime/config/validation/model-registry-validation.js +118 -0
  149. package/dist/src/runtime/config/validation/path-config-validation.d.ts +1 -0
  150. package/dist/src/runtime/config/validation/path-config-validation.js +7 -0
  151. package/dist/src/runtime/config/validation/runtime-config-field-validation.d.ts +12 -0
  152. package/dist/src/runtime/config/validation/runtime-config-field-validation.js +158 -0
  153. package/dist/src/runtime/config/validation/runtime-config-validation-contract.d.ts +9 -0
  154. package/dist/src/runtime/config/validation/runtime-config-validation-contract.js +13 -0
  155. package/dist/src/runtime/config/validation/runtime-root-section-validation.d.ts +6 -0
  156. package/dist/src/runtime/config/validation/runtime-root-section-validation.js +82 -0
  157. package/dist/src/runtime/config/validation/web-ui-config-validation.d.ts +3 -0
  158. package/dist/src/runtime/config/validation/web-ui-config-validation.js +26 -0
  159. package/dist/src/runtime/config/validation.d.ts +4 -15
  160. package/dist/src/runtime/config/validation.js +27 -499
  161. package/dist/src/runtime/config.js +3 -0
  162. package/dist/src/runtime/context/accepted-capability-action.d.ts +11 -0
  163. package/dist/src/runtime/context/accepted-capability-action.js +29 -0
  164. package/dist/src/runtime/context/model-step-compaction.js +6 -0
  165. package/dist/src/runtime/context/operation-supervision-evidence.d.ts +37 -0
  166. package/dist/src/runtime/context/operation-supervision-evidence.js +90 -0
  167. package/dist/src/runtime/context/request-tool-results.d.ts +3 -0
  168. package/dist/src/runtime/context/request-tool-results.js +11 -2
  169. package/dist/src/runtime/default-adapters.d.ts +3 -0
  170. package/dist/src/runtime/default-adapters.js +64 -3
  171. package/dist/src/runtime/index.d.ts +1 -0
  172. package/dist/src/runtime/index.js +1 -0
  173. package/dist/src/runtime/lifecycle/request-finalizer.d.ts +3 -0
  174. package/dist/src/runtime/lifecycle/request-finalizer.js +8 -0
  175. package/dist/src/runtime/long-term-memory/background-save-queue.d.ts +17 -0
  176. package/dist/src/runtime/long-term-memory/background-save-queue.js +66 -0
  177. package/dist/src/runtime/long-term-memory/candidate-persistence.d.ts +16 -0
  178. package/dist/src/runtime/long-term-memory/candidate-persistence.js +109 -0
  179. package/dist/src/runtime/long-term-memory/candidate-preparation.d.ts +8 -0
  180. package/dist/src/runtime/long-term-memory/candidate-preparation.js +36 -0
  181. package/dist/src/runtime/long-term-memory/candidate-processing.d.ts +9 -0
  182. package/dist/src/runtime/long-term-memory/candidate-processing.js +79 -0
  183. package/dist/src/runtime/long-term-memory/contracts.d.ts +108 -0
  184. package/dist/src/runtime/long-term-memory/contracts.js +1 -0
  185. package/dist/src/runtime/long-term-memory/diagnostics.d.ts +9 -0
  186. package/dist/src/runtime/long-term-memory/diagnostics.js +42 -0
  187. package/dist/src/runtime/long-term-memory/embedding-batches.d.ts +13 -0
  188. package/dist/src/runtime/long-term-memory/embedding-batches.js +87 -0
  189. package/dist/src/runtime/long-term-memory/events.d.ts +13 -0
  190. package/dist/src/runtime/long-term-memory/events.js +15 -0
  191. package/dist/src/runtime/long-term-memory/finalization.d.ts +8 -0
  192. package/dist/src/runtime/long-term-memory/finalization.js +24 -0
  193. package/dist/src/runtime/long-term-memory/index.d.ts +6 -0
  194. package/dist/src/runtime/long-term-memory/index.js +6 -0
  195. package/dist/src/runtime/long-term-memory/management/contracts.d.ts +54 -0
  196. package/dist/src/runtime/long-term-memory/management/contracts.js +1 -0
  197. package/dist/src/runtime/long-term-memory/management/errors.d.ts +10 -0
  198. package/dist/src/runtime/long-term-memory/management/errors.js +13 -0
  199. package/dist/src/runtime/long-term-memory/management/mutations.d.ts +17 -0
  200. package/dist/src/runtime/long-term-memory/management/mutations.js +178 -0
  201. package/dist/src/runtime/long-term-memory/management/queries.d.ts +8 -0
  202. package/dist/src/runtime/long-term-memory/management/queries.js +46 -0
  203. package/dist/src/runtime/long-term-memory/management/search.d.ts +7 -0
  204. package/dist/src/runtime/long-term-memory/management/search.js +18 -0
  205. package/dist/src/runtime/long-term-memory/management/service.d.ts +13 -0
  206. package/dist/src/runtime/long-term-memory/management/service.js +61 -0
  207. package/dist/src/runtime/long-term-memory/management/validation.d.ts +24 -0
  208. package/dist/src/runtime/long-term-memory/management/validation.js +77 -0
  209. package/dist/src/runtime/long-term-memory/onboarding/configuration.d.ts +14 -0
  210. package/dist/src/runtime/long-term-memory/onboarding/configuration.js +92 -0
  211. package/dist/src/runtime/long-term-memory/onboarding/contracts.d.ts +52 -0
  212. package/dist/src/runtime/long-term-memory/onboarding/contracts.js +1 -0
  213. package/dist/src/runtime/long-term-memory/onboarding/service.d.ts +21 -0
  214. package/dist/src/runtime/long-term-memory/onboarding/service.js +88 -0
  215. package/dist/src/runtime/long-term-memory/policies/normalization.d.ts +10 -0
  216. package/dist/src/runtime/long-term-memory/policies/normalization.js +45 -0
  217. package/dist/src/runtime/long-term-memory/policies/reconciliation.d.ts +20 -0
  218. package/dist/src/runtime/long-term-memory/policies/reconciliation.js +21 -0
  219. package/dist/src/runtime/long-term-memory/policies/scoring.d.ts +13 -0
  220. package/dist/src/runtime/long-term-memory/policies/scoring.js +55 -0
  221. package/dist/src/runtime/long-term-memory/policies/sensitive-data.d.ts +5 -0
  222. package/dist/src/runtime/long-term-memory/policies/sensitive-data.js +12 -0
  223. package/dist/src/runtime/long-term-memory/projection.d.ts +4 -0
  224. package/dist/src/runtime/long-term-memory/projection.js +39 -0
  225. package/dist/src/runtime/long-term-memory/ranked-search.d.ts +11 -0
  226. package/dist/src/runtime/long-term-memory/ranked-search.js +111 -0
  227. package/dist/src/runtime/long-term-memory/repository-state.d.ts +4 -0
  228. package/dist/src/runtime/long-term-memory/repository-state.js +131 -0
  229. package/dist/src/runtime/long-term-memory/response-context.d.ts +5 -0
  230. package/dist/src/runtime/long-term-memory/response-context.js +21 -0
  231. package/dist/src/runtime/long-term-memory/retrieval.d.ts +8 -0
  232. package/dist/src/runtime/long-term-memory/retrieval.js +73 -0
  233. package/dist/src/runtime/long-term-memory/service.d.ts +10 -0
  234. package/dist/src/runtime/long-term-memory/service.js +83 -0
  235. package/dist/src/runtime/orchestration/capability-adapters/index.d.ts +2 -0
  236. package/dist/src/runtime/orchestration/capability-adapters/index.js +2 -0
  237. package/dist/src/runtime/orchestration/final-response/authoring-contract.d.ts +10 -0
  238. package/dist/src/runtime/orchestration/final-response/authoring-contract.js +94 -0
  239. package/dist/src/runtime/orchestration/final-response/finalization.d.ts +1 -0
  240. package/dist/src/runtime/orchestration/final-response/finalization.js +1 -0
  241. package/dist/src/runtime/orchestration/final-response/format.d.ts +2 -0
  242. package/dist/src/runtime/orchestration/final-response/format.js +49 -0
  243. package/dist/src/runtime/orchestration/final-response/invoke.d.ts +16 -0
  244. package/dist/src/runtime/orchestration/final-response/invoke.js +24 -0
  245. package/dist/src/runtime/orchestration/role-calls/activation-budget.d.ts +14 -0
  246. package/dist/src/runtime/orchestration/role-calls/activation-budget.js +52 -0
  247. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +154 -0
  248. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.js +1 -8
  249. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-issuance.d.ts +17 -0
  250. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-issuance.js +155 -0
  251. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision.d.ts +78 -0
  252. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision.js +339 -0
  253. package/dist/src/runtime/orchestration/role-calls/command-decoder.js +35 -10
  254. package/dist/src/runtime/orchestration/role-calls/command-dispatch/active-capability-caller.d.ts +6 -0
  255. package/dist/src/runtime/orchestration/role-calls/command-dispatch/active-capability-caller.js +15 -0
  256. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-frame-state.d.ts +3 -0
  257. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-frame-state.js +6 -0
  258. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-scope-transitions.d.ts +3 -0
  259. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-scope-transitions.js +86 -0
  260. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-batch-transitions.d.ts +3 -0
  261. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-batch-transitions.js +172 -0
  262. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-state.d.ts +9 -0
  263. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-state.js +28 -0
  264. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-transitions.d.ts +3 -0
  265. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-transitions.js +117 -0
  266. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-invocation.d.ts +4 -0
  267. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-invocation.js +16 -0
  268. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-selection-transition.d.ts +2 -0
  269. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-selection-transition.js +114 -0
  270. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-settlement.d.ts +6 -0
  271. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-settlement.js +54 -0
  272. package/dist/src/runtime/orchestration/role-calls/command-dispatch/child-transitions.d.ts +3 -0
  273. package/dist/src/runtime/orchestration/role-calls/command-dispatch/child-transitions.js +206 -0
  274. package/dist/src/runtime/orchestration/role-calls/command-dispatch/operation-supervision-intervention.d.ts +13 -0
  275. package/dist/src/runtime/orchestration/role-calls/command-dispatch/operation-supervision-intervention.js +25 -0
  276. package/dist/src/runtime/orchestration/role-calls/command-dispatch/root-transitions.d.ts +3 -0
  277. package/dist/src/runtime/orchestration/role-calls/command-dispatch/root-transitions.js +70 -0
  278. package/dist/src/runtime/orchestration/role-calls/command-dispatch.d.ts +1 -1
  279. package/dist/src/runtime/orchestration/role-calls/command-dispatch.js +6 -580
  280. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +45 -5
  281. package/dist/src/runtime/orchestration/role-calls/contracts.js +2 -2
  282. package/dist/src/runtime/orchestration/role-calls/diagnostics.d.ts +4 -0
  283. package/dist/src/runtime/orchestration/role-calls/diagnostics.js +152 -1
  284. package/dist/src/runtime/orchestration/role-calls/index.d.ts +6 -0
  285. package/dist/src/runtime/orchestration/role-calls/index.js +6 -0
  286. package/dist/src/runtime/orchestration/role-calls/ledger.js +131 -7
  287. package/dist/src/runtime/orchestration/role-calls/operation-supervision-issuance.d.ts +11 -0
  288. package/dist/src/runtime/orchestration/role-calls/operation-supervision-issuance.js +66 -0
  289. package/dist/src/runtime/orchestration/role-calls/operation-supervision-projection.d.ts +16 -0
  290. package/dist/src/runtime/orchestration/role-calls/operation-supervision-projection.js +52 -0
  291. package/dist/src/runtime/orchestration/role-calls/operation-supervision-state-validation.d.ts +3 -0
  292. package/dist/src/runtime/orchestration/role-calls/operation-supervision-state-validation.js +151 -0
  293. package/dist/src/runtime/orchestration/role-calls/operation-supervision.d.ts +112 -0
  294. package/dist/src/runtime/orchestration/role-calls/operation-supervision.js +197 -0
  295. package/dist/src/runtime/orchestration/role-calls/reconsideration-cause.d.ts +26 -0
  296. package/dist/src/runtime/orchestration/role-calls/reconsideration-cause.js +127 -0
  297. package/dist/src/runtime/orchestration/role-calls/reducer-primitives.d.ts +1 -2
  298. package/dist/src/runtime/orchestration/role-calls/reducer-primitives.js +2 -12
  299. package/dist/src/runtime/orchestration/role-calls/reducer.js +19 -2
  300. package/dist/src/runtime/orchestration/role-calls/transactions.js +62 -5
  301. package/dist/src/runtime/orchestration/role-executors/activation/capability-continuation.d.ts +15 -0
  302. package/dist/src/runtime/orchestration/role-executors/activation/capability-continuation.js +73 -0
  303. package/dist/src/runtime/orchestration/role-executors/activation/loop.d.ts +0 -1
  304. package/dist/src/runtime/orchestration/role-executors/activation/loop.js +16 -54
  305. package/dist/src/runtime/orchestration/role-executors/activation/result-normalization.js +14 -0
  306. package/dist/src/runtime/orchestration/role-executors/activation/state-validation.d.ts +13 -1
  307. package/dist/src/runtime/orchestration/role-executors/activation/state-validation.js +137 -1
  308. package/dist/src/runtime/orchestration/role-executors/contracts.d.ts +7 -3
  309. package/dist/src/runtime/orchestration/role-executors/diagnostics.d.ts +2 -0
  310. package/dist/src/runtime/orchestration/role-executors/diagnostics.js +1 -6
  311. package/dist/src/runtime/orchestration/worker-capabilities/batch-selection.d.ts +10 -0
  312. package/dist/src/runtime/orchestration/worker-capabilities/batch-selection.js +8 -0
  313. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-catalog.d.ts +14 -0
  314. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-catalog.js +76 -0
  315. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-normalization.d.ts +10 -0
  316. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-normalization.js +160 -0
  317. package/dist/src/runtime/orchestration/worker-capabilities/binding/binding-rejection.d.ts +2 -0
  318. package/dist/src/runtime/orchestration/worker-capabilities/binding/binding-rejection.js +8 -0
  319. package/dist/src/runtime/orchestration/worker-capabilities/binding/bound-capability-session.d.ts +24 -0
  320. package/dist/src/runtime/orchestration/worker-capabilities/binding/bound-capability-session.js +100 -0
  321. package/dist/src/runtime/orchestration/worker-capabilities/binding/call-authority.d.ts +29 -0
  322. package/dist/src/runtime/orchestration/worker-capabilities/binding/call-authority.js +193 -0
  323. package/dist/src/runtime/orchestration/worker-capabilities/binding/create-binding.d.ts +11 -0
  324. package/dist/src/runtime/orchestration/worker-capabilities/binding/create-binding.js +109 -0
  325. package/dist/src/runtime/orchestration/worker-capabilities/binding/dependency-results.d.ts +2 -0
  326. package/dist/src/runtime/orchestration/worker-capabilities/binding/dependency-results.js +34 -0
  327. package/dist/src/runtime/orchestration/worker-capabilities/binding/invocation-preparation.d.ts +21 -0
  328. package/dist/src/runtime/orchestration/worker-capabilities/binding/invocation-preparation.js +167 -0
  329. package/dist/src/runtime/orchestration/worker-capabilities/binding.d.ts +1 -13
  330. package/dist/src/runtime/orchestration/worker-capabilities/binding.js +1 -625
  331. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +57 -14
  332. package/dist/src/runtime/orchestration/worker-capabilities/contracts.js +3 -1
  333. package/dist/src/runtime/orchestration/worker-capabilities/controls.d.ts +7 -0
  334. package/dist/src/runtime/orchestration/worker-capabilities/controls.js +50 -0
  335. package/dist/src/runtime/orchestration/worker-capabilities/error-fingerprint.d.ts +5 -0
  336. package/dist/src/runtime/orchestration/worker-capabilities/error-fingerprint.js +119 -0
  337. package/dist/src/runtime/orchestration/worker-capabilities/errors.d.ts +6 -0
  338. package/dist/src/runtime/orchestration/worker-capabilities/errors.js +11 -0
  339. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-exact-result.d.ts +7 -0
  340. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-exact-result.js +35 -0
  341. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-execution.d.ts +9 -0
  342. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-execution.js +28 -0
  343. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-normalization.d.ts +18 -0
  344. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-normalization.js +197 -0
  345. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-references.d.ts +2 -0
  346. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-references.js +44 -0
  347. package/dist/src/runtime/orchestration/worker-capabilities/execution/context-projection.d.ts +12 -0
  348. package/dist/src/runtime/orchestration/worker-capabilities/execution/context-projection.js +51 -0
  349. package/dist/src/runtime/orchestration/worker-capabilities/execution/invocation-preparation.d.ts +25 -0
  350. package/dist/src/runtime/orchestration/worker-capabilities/execution/invocation-preparation.js +111 -0
  351. package/dist/src/runtime/orchestration/worker-capabilities/execution/ledger-transaction.d.ts +20 -0
  352. package/dist/src/runtime/orchestration/worker-capabilities/execution/ledger-transaction.js +142 -0
  353. package/dist/src/runtime/orchestration/worker-capabilities/execution.d.ts +10 -14
  354. package/dist/src/runtime/orchestration/worker-capabilities/execution.js +84 -357
  355. package/dist/src/runtime/orchestration/worker-capabilities/index.d.ts +3 -0
  356. package/dist/src/runtime/orchestration/worker-capabilities/index.js +3 -0
  357. package/dist/src/runtime/orchestration/worker-capabilities/outcome-fingerprint.d.ts +8 -0
  358. package/dist/src/runtime/orchestration/worker-capabilities/outcome-fingerprint.js +21 -0
  359. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.js +31 -9
  360. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.d.ts +15 -6
  361. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.js +2 -0
  362. package/dist/src/runtime/orchestration/worker-capabilities/payload-instructions.js +4 -4
  363. package/dist/src/runtime/orchestration/worker-capabilities/preparation-fingerprint.d.ts +23 -0
  364. package/dist/src/runtime/orchestration/worker-capabilities/preparation-fingerprint.js +109 -0
  365. package/dist/src/runtime/plugins/manifest-projection.js +3 -0
  366. package/dist/src/runtime/plugins/manifest-validator.js +20 -0
  367. package/dist/src/runtime/ports.d.ts +10 -1
  368. package/dist/src/runtime/request/contracts.d.ts +7 -0
  369. package/dist/src/runtime/request/dependencies.d.ts +1 -0
  370. package/dist/src/runtime/request/dependencies.js +10 -1
  371. package/dist/src/runtime/request/execution-agent-root-execution.js +5 -4
  372. package/dist/src/runtime/request/execution-facets.d.ts +2 -1
  373. package/dist/src/runtime/request/execution-facets.js +6 -0
  374. package/dist/src/runtime/request/execution-scope-surfaces.js +6 -0
  375. package/dist/src/runtime/request/execution-scope.d.ts +3 -2
  376. package/dist/src/runtime/request/handler.js +4 -1
  377. package/dist/src/runtime/request/result.d.ts +2 -0
  378. package/dist/src/runtime/request/root-contract.d.ts +4 -2
  379. package/dist/src/runtime/request/root-execution-kernel.js +100 -31
  380. package/dist/src/runtime/request/supervisor-root-execution.js +4 -2
  381. package/dist/src/runtime/request/worker-capability-payload-prompts.js +1 -1
  382. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.d.ts +24 -0
  383. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.js +52 -0
  384. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +5 -2
  385. package/dist/src/runtime/steps/execution-agent/format.js +19 -6
  386. package/dist/src/runtime/steps/execution-agent/input.js +8 -12
  387. package/dist/src/runtime/steps/execution-agent/parser.js +25 -19
  388. package/dist/src/runtime/steps/execution-agent/prompt.js +3 -2
  389. package/dist/src/runtime/steps/execution-agent/reconsideration-context.d.ts +3 -0
  390. package/dist/src/runtime/steps/execution-agent/reconsideration-context.js +76 -0
  391. package/dist/src/runtime/steps/execution-agent/refinement-prompt.js +4 -4
  392. package/dist/src/runtime/steps/execution-agent/refinement-reconsideration.d.ts +3 -0
  393. package/dist/src/runtime/steps/execution-agent/refinement-reconsideration.js +25 -0
  394. package/dist/src/runtime/steps/execution-agent/refinement.d.ts +4 -7
  395. package/dist/src/runtime/steps/execution-agent/refinement.js +24 -35
  396. package/dist/src/runtime/steps/execution-agent/response-input.d.ts +2 -0
  397. package/dist/src/runtime/steps/execution-agent/response-input.js +22 -6
  398. package/dist/src/runtime/steps/execution-agent/response-prompt.d.ts +1 -1
  399. package/dist/src/runtime/steps/execution-agent/response-prompt.js +8 -3
  400. package/dist/src/runtime/steps/execution-agent/response-run.d.ts +6 -0
  401. package/dist/src/runtime/steps/execution-agent/response-run.js +40 -10
  402. package/dist/src/runtime/steps/execution-agent/run.js +6 -6
  403. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +4 -1
  404. package/dist/src/runtime/steps/execution-agent/state-context.js +40 -23
  405. package/dist/src/runtime/steps/supervisor-response/index.d.ts +1 -1
  406. package/dist/src/runtime/steps/supervisor-response/index.js +1 -1
  407. package/dist/src/runtime/steps/supervisor-response/input.d.ts +13 -5
  408. package/dist/src/runtime/steps/supervisor-response/input.js +27 -8
  409. package/dist/src/runtime/steps/supervisor-response/memory-authoring.d.ts +10 -0
  410. package/dist/src/runtime/steps/supervisor-response/memory-authoring.js +125 -0
  411. package/dist/src/runtime/steps/supervisor-response/prompt.d.ts +4 -0
  412. package/dist/src/runtime/steps/supervisor-response/prompt.js +19 -0
  413. package/dist/src/runtime/steps/supervisor-response/run.d.ts +8 -0
  414. package/dist/src/runtime/steps/supervisor-response/run.js +46 -17
  415. package/dist/src/runtime/steps/worker-decision/contracts.d.ts +8 -1
  416. package/dist/src/runtime/steps/worker-decision/contracts.js +3 -0
  417. package/dist/src/runtime/steps/worker-decision/format.d.ts +4 -0
  418. package/dist/src/runtime/steps/worker-decision/format.js +97 -22
  419. package/dist/src/runtime/steps/worker-decision/input/action-policy.d.ts +9 -0
  420. package/dist/src/runtime/steps/worker-decision/input/action-policy.js +15 -0
  421. package/dist/src/runtime/steps/worker-decision/input/canonical-state.d.ts +2 -2
  422. package/dist/src/runtime/steps/worker-decision/input/canonical-state.js +19 -7
  423. package/dist/src/runtime/steps/worker-decision/input/capability-selection.js +44 -3
  424. package/dist/src/runtime/steps/worker-decision/input/contract.d.ts +1 -0
  425. package/dist/src/runtime/steps/worker-decision/input/contract.js +12 -6
  426. package/dist/src/runtime/steps/worker-decision/input/diagnostic-projection.js +14 -5
  427. package/dist/src/runtime/steps/worker-decision/input/prompt-context.js +9 -6
  428. package/dist/src/runtime/steps/worker-decision/input/reference-context.js +21 -3
  429. package/dist/src/runtime/steps/worker-decision/input/session.js +2 -1
  430. package/dist/src/runtime/steps/worker-decision/input/types.d.ts +6 -1
  431. package/dist/src/runtime/steps/worker-decision/input.d.ts +2 -2
  432. package/dist/src/runtime/steps/worker-decision/input.js +1 -2
  433. package/dist/src/runtime/steps/worker-decision/parser/accepted-decision.d.ts +3 -0
  434. package/dist/src/runtime/steps/worker-decision/parser/accepted-decision.js +70 -0
  435. package/dist/src/runtime/steps/worker-decision/parser/action-validation.d.ts +4 -0
  436. package/dist/src/runtime/steps/worker-decision/parser/action-validation.js +55 -0
  437. package/dist/src/runtime/steps/worker-decision/parser/capability-batch-validation.d.ts +3 -0
  438. package/dist/src/runtime/steps/worker-decision/parser/capability-batch-validation.js +135 -0
  439. package/dist/src/runtime/steps/worker-decision/parser/capability-controls-validation.d.ts +6 -0
  440. package/dist/src/runtime/steps/worker-decision/parser/capability-controls-validation.js +132 -0
  441. package/dist/src/runtime/steps/worker-decision/parser/capability-invocation-validation.d.ts +4 -0
  442. package/dist/src/runtime/steps/worker-decision/parser/capability-invocation-validation.js +104 -0
  443. package/dist/src/runtime/steps/worker-decision/parser/decision-shape-validation.d.ts +4 -0
  444. package/dist/src/runtime/steps/worker-decision/parser/decision-shape-validation.js +28 -0
  445. package/dist/src/runtime/steps/worker-decision/parser/pending-capability-selection-validation.d.ts +4 -0
  446. package/dist/src/runtime/steps/worker-decision/parser/pending-capability-selection-validation.js +105 -0
  447. package/dist/src/runtime/steps/worker-decision/parser/validation-contract.d.ts +50 -0
  448. package/dist/src/runtime/steps/worker-decision/parser/validation-contract.js +19 -0
  449. package/dist/src/runtime/steps/worker-decision/parser.d.ts +5 -1
  450. package/dist/src/runtime/steps/worker-decision/parser.js +32 -426
  451. package/dist/src/runtime/steps/worker-decision/prompt.d.ts +3 -0
  452. package/dist/src/runtime/steps/worker-decision/prompt.js +57 -20
  453. package/dist/src/runtime/steps/worker-decision/result-author.js +11 -1
  454. package/dist/src/runtime/steps/worker-decision/run.js +97 -19
  455. package/dist/src/runtime/validation/strict-record.d.ts +2 -0
  456. package/dist/src/runtime/validation/strict-record.js +12 -0
  457. package/dist/src/shared/model-step-registry-data.json +9 -0
  458. package/dist/src/shared/model-step-registry.d.ts +9 -0
  459. package/dist/src/shared/model-step-registry.generated.d.ts +9 -0
  460. package/dist/src/shared/model-step-registry.generated.js +9 -0
  461. package/dist/src/web-ui/app/ARCHITECTURE.md +1 -1
  462. package/dist/src/web-ui/app/app.js +56 -11
  463. package/dist/src/web-ui/app/components/config-workspace/config-model.js +320 -0
  464. package/dist/src/web-ui/app/components/config-workspace/dashboard-rendering.js +155 -0
  465. package/dist/src/web-ui/app/components/config-workspace/field-rendering.js +278 -0
  466. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +251 -0
  467. package/dist/src/web-ui/app/components/config-workspace/step-rendering.js +145 -0
  468. package/dist/src/web-ui/app/components/config-workspace/workspace-events.js +271 -0
  469. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +195 -0
  470. package/dist/src/web-ui/app/components/config-workspace/workspace-persistence.js +247 -0
  471. package/dist/src/web-ui/app/components/config-workspace/workspace-view.js +299 -0
  472. package/dist/src/web-ui/app/components/config-workspace.js +179 -866
  473. package/dist/src/web-ui/app/components/conversation-activity.d.ts +7 -1
  474. package/dist/src/web-ui/app/components/long-term-memory/icons.js +16 -0
  475. package/dist/src/web-ui/app/components/long-term-memory/manager.js +192 -0
  476. package/dist/src/web-ui/app/components/long-term-memory/record-editor.d.ts +9 -0
  477. package/dist/src/web-ui/app/components/long-term-memory/record-editor.js +62 -0
  478. package/dist/src/web-ui/app/components/long-term-memory/record-list.d.ts +5 -0
  479. package/dist/src/web-ui/app/components/long-term-memory/record-list.js +97 -0
  480. package/dist/src/web-ui/app/components/long-term-memory/view-model.d.ts +29 -0
  481. package/dist/src/web-ui/app/components/long-term-memory/view-model.js +69 -0
  482. package/dist/src/web-ui/app/components/long-term-memory-setup.js +334 -0
  483. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +39 -0
  484. package/dist/src/web-ui/app/components/tool-approval-card.d.ts +18 -0
  485. package/dist/src/web-ui/app/components/workspace-shell.js +48 -7
  486. package/dist/src/web-ui/app/controllers/app-event-bindings.js +43 -6
  487. package/dist/src/web-ui/app/controllers/composer-attachments-controller.d.ts +92 -0
  488. package/dist/src/web-ui/app/controllers/composer-queue-controller.d.ts +109 -0
  489. package/dist/src/web-ui/app/controllers/composer-submit-controller.d.ts +77 -0
  490. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +149 -0
  491. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +43 -3
  492. package/dist/src/web-ui/app/controllers/long-term-memory/controller.d.ts +87 -0
  493. package/dist/src/web-ui/app/controllers/long-term-memory/controller.js +302 -0
  494. package/dist/src/web-ui/app/controllers/long-term-memory/policy.d.ts +14 -0
  495. package/dist/src/web-ui/app/controllers/long-term-memory/policy.js +61 -0
  496. package/dist/src/web-ui/app/controllers/long-term-memory/state.js +85 -0
  497. package/dist/src/web-ui/app/controllers/operations-controller.d.ts +25 -0
  498. package/dist/src/web-ui/app/controllers/realtime-event-controller.d.ts +57 -0
  499. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.d.ts +32 -0
  500. package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts +177 -0
  501. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +78 -11
  502. package/dist/src/web-ui/app/controllers/tool-approval-controller.d.ts +28 -0
  503. package/dist/src/web-ui/app/index.html +13 -15
  504. package/dist/src/web-ui/app/services/runtime-web-client/memory.js +127 -0
  505. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +84 -0
  506. package/dist/src/web-ui/app/services/runtime-web-client.js +27 -1
  507. package/dist/src/web-ui/app/styles/30-inspector-config.css +151 -1423
  508. package/dist/src/web-ui/app/styles/35-memory-onboarding.css +153 -0
  509. package/dist/src/web-ui/app/styles/36-memory-management.css +419 -0
  510. package/dist/src/web-ui/app/styles/40-config-workspace.css +992 -0
  511. package/dist/src/web-ui/app/styles/90-responsive.css +187 -26
  512. package/dist/src/web-ui/app/styles.css +3 -0
  513. package/dist/src/web-ui/config-dashboard-backend.js +9 -1
  514. package/dist/src/web-ui/local-runtime/api-router.d.ts +4 -2
  515. package/dist/src/web-ui/local-runtime/api-router.js +33 -0
  516. package/dist/src/web-ui/local-runtime/contracts.d.ts +5 -0
  517. package/dist/src/web-ui/local-runtime/memory-management-input.d.ts +12 -0
  518. package/dist/src/web-ui/local-runtime/memory-management-input.js +68 -0
  519. package/dist/src/web-ui/local-runtime/memory-management-response.d.ts +17 -0
  520. package/dist/src/web-ui/local-runtime/memory-management-response.js +47 -0
  521. package/dist/src/web-ui/local-runtime/memory-management-routes.d.ts +24 -0
  522. package/dist/src/web-ui/local-runtime/memory-management-routes.js +128 -0
  523. package/dist/src/web-ui/local-runtime/memory-onboarding-routes.d.ts +17 -0
  524. package/dist/src/web-ui/local-runtime/memory-onboarding-routes.js +81 -0
  525. package/dist/src/web-ui/local-runtime/request-abort.d.ts +7 -0
  526. package/dist/src/web-ui/local-runtime/request-abort.js +19 -0
  527. package/dist/src/web-ui/local-runtime-backend.js +10 -3
  528. package/dist/src/web-ui/server.d.ts +2 -0
  529. package/dist/src/web-ui/server.js +3 -0
  530. package/docs/configuration.md +128 -45
  531. package/docs/installation.md +21 -0
  532. package/docs/known-limitations.md +11 -0
  533. package/docs/long-term-memory.md +181 -0
  534. package/docs/publishing.md +52 -25
  535. package/docs/runtime-invariant-coverage.md +1 -1
  536. package/docs/runtime-library.md +16 -1
  537. package/docs/runtime-prompt-policy-contracts.md +12 -2
  538. package/docs/troubleshooting.md +21 -0
  539. package/examples/models/default.config.json +1 -0
  540. package/examples/request-runner.config.example.json +16 -22
  541. package/examples/runtime.config.example.json +4 -0
  542. package/methodologies/memory-informed-response.md +15 -0
  543. package/methodologies/response-ux.md +17 -0
  544. package/package.json +8 -2
  545. package/plugins/exec/source/handlers.ts +65 -5
  546. package/plugins/exec/src/index.cjs +39 -3
  547. package/plugins/filesystem/plugin.json +1 -0
  548. package/runtime.config.schema.json +30 -0
  549. package/src/runtime/README.md +77 -38
@@ -0,0 +1,84 @@
1
+ import { createHash } from "node:crypto";
2
+ /**
3
+ * Owns stable failure interpretation for the registered-tool adapter. The
4
+ * generic capability engine receives only the resulting opaque identity.
5
+ */
6
+ export function createRegisteredToolWorkerFailureOutcomeFingerprint(exactResult) {
7
+ try {
8
+ if (exactResult.kind === "runtime_capability_rejection_v1") {
9
+ return digest([
10
+ "registered_tool_runtime_rejection_v1",
11
+ exactResult.stage,
12
+ exactResult.code,
13
+ ]);
14
+ }
15
+ if (exactResult.kind === "registered_tool_execution_result_v1") {
16
+ const discriminants = registeredToolFailureDiscriminants(exactResult.result);
17
+ if (discriminants.length > 0) {
18
+ return digest(["registered_tool_execution_failure_v1", discriminants]);
19
+ }
20
+ }
21
+ return digest([
22
+ "registered_tool_canonical_failure_v1",
23
+ canonicalValue(exactResult),
24
+ ]);
25
+ }
26
+ catch {
27
+ return null;
28
+ }
29
+ }
30
+ function digest(value) {
31
+ return `sha256:${createHash("sha256")
32
+ .update(JSON.stringify(value))
33
+ .digest("hex")}`;
34
+ }
35
+ function registeredToolFailureDiscriminants(input) {
36
+ const discriminants = [];
37
+ const errorCode = input.errorCode?.trim();
38
+ if (errorCode) {
39
+ discriminants.push(Object.freeze(["error_code", errorCode]));
40
+ }
41
+ if (input.exitCode !== undefined) {
42
+ if (!Number.isFinite(input.exitCode)) {
43
+ throw new Error("registered_tool_failure_exit_code_invalid");
44
+ }
45
+ discriminants.push(Object.freeze(["exit_code", input.exitCode]));
46
+ }
47
+ return Object.freeze(discriminants);
48
+ }
49
+ function canonicalValue(value) {
50
+ if (value === null ||
51
+ typeof value === "string" ||
52
+ typeof value === "boolean") {
53
+ return value;
54
+ }
55
+ if (typeof value === "number") {
56
+ if (!Number.isFinite(value)) {
57
+ throw new Error("registered_tool_failure_number_invalid");
58
+ }
59
+ return value;
60
+ }
61
+ if (Array.isArray(value)) {
62
+ return Object.freeze(value.map((entry) => canonicalValue(entry)));
63
+ }
64
+ if (!isPlainRecord(value)) {
65
+ throw new Error("registered_tool_failure_value_invalid");
66
+ }
67
+ return Object.freeze(Object.entries(value)
68
+ .sort(([left], [right]) => compareText(left, right))
69
+ .map(([key, entry]) => Object.freeze([key, canonicalValue(entry)])));
70
+ }
71
+ function isPlainRecord(value) {
72
+ if (typeof value !== "object" || value === null || Array.isArray(value)) {
73
+ return false;
74
+ }
75
+ const prototype = Object.getPrototypeOf(value);
76
+ return prototype === Object.prototype || prototype === null;
77
+ }
78
+ function compareText(left, right) {
79
+ if (left < right)
80
+ return -1;
81
+ if (left > right)
82
+ return 1;
83
+ return 0;
84
+ }
@@ -1,21 +1,22 @@
1
1
  import type { ToolExecutionSharedState } from "../../../capabilities/tool-types.js";
2
2
  import type { CapabilityAdapterResult } from "../../orchestration/capability-adapters/index.js";
3
3
  import type { WorkerCapabilityAdapterResult, WorkerCapabilityExecutionFreshness, WorkerCapabilityPayloadAuthor } from "../../orchestration/worker-capabilities/index.js";
4
- import type { RegisteredToolNormalInvocationExecutor, RegisteredToolNormalInvocationProjection } from "../registered-tool-normal-invocations.js";
5
- import type { RegisteredToolWorkerCapabilityProviderDiagnostic } from "../registered-tool-worker-capability-diagnostics.js";
4
+ import type { RegisteredToolNormalInvocationProjection } from "../registered-tool-normal-invocations.js";
5
+ import type { PayloadLifecycleEmitter, PayloadStageMaterializationDetails } from "./payload-observability.js";
6
6
  export declare function prepareOperationPayload(params: Readonly<{
7
7
  projection: RegisteredToolNormalInvocationProjection;
8
- executor: RegisteredToolNormalInvocationExecutor;
8
+ executor: PayloadLifecycleEmitter;
9
9
  sharedState: ToolExecutionSharedState;
10
10
  payloadAuthor?: WorkerCapabilityPayloadAuthor;
11
11
  call: Parameters<WorkerCapabilityPayloadAuthor["author"]>[0]["call"];
12
12
  executionId: string;
13
13
  descriptor: Parameters<WorkerCapabilityPayloadAuthor["author"]>[0]["descriptor"];
14
14
  intent: string;
15
+ authoringObjective?: string;
15
16
  controls: Readonly<Record<string, unknown>>;
16
17
  dependencyResults?: Parameters<WorkerCapabilityPayloadAuthor["author"]>[0]["dependencyResults"];
17
18
  settledCapabilityResults: Parameters<WorkerCapabilityPayloadAuthor["author"]>[0]["settledCapabilityResults"];
18
- diagnostic: RegisteredToolWorkerCapabilityProviderDiagnostic;
19
+ deferPayloadStageMaterialized(details: PayloadStageMaterializationDetails): void;
19
20
  executionFreshness?: WorkerCapabilityExecutionFreshness;
20
21
  }>): Promise<Readonly<{
21
22
  status: "ready";
@@ -14,12 +14,15 @@ export async function prepareOperationPayload(params) {
14
14
  executionId: params.executionId,
15
15
  descriptor: params.descriptor,
16
16
  intent: params.intent,
17
+ ...(params.authoringObjective
18
+ ? { authoringObjective: params.authoringObjective }
19
+ : {}),
17
20
  controls: params.controls,
18
21
  ...(params.dependencyResults
19
22
  ? { dependencyResults: params.dependencyResults }
20
23
  : {}),
21
24
  settledCapabilityResults: params.settledCapabilityResults,
22
- diagnostic: params.diagnostic,
25
+ deferPayloadStageMaterialized: params.deferPayloadStageMaterialized,
23
26
  ...(params.executionFreshness
24
27
  ? { executionFreshness: params.executionFreshness }
25
28
  : {}),
@@ -58,6 +61,9 @@ export async function prepareOperationPayload(params) {
58
61
  call: params.call,
59
62
  executionId: params.executionId,
60
63
  descriptor: params.descriptor,
64
+ ...(params.authoringObjective
65
+ ? { authoringObjective: params.authoringObjective }
66
+ : {}),
61
67
  controls: params.controls,
62
68
  contextScope,
63
69
  ...(params.dependencyResults
@@ -0,0 +1,35 @@
1
+ import type { RoleCallFrame } from "../../orchestration/role-calls/index.js";
2
+ import type { RegisteredToolNormalInvocationExecutor } from "../registered-tool-normal-invocations.js";
3
+ import { type RegisteredToolWorkerCapabilityProviderDiagnostic } from "../registered-tool-worker-capability-diagnostics.js";
4
+ export type PayloadStageMaterializationDetails = Readonly<{
5
+ payloadStage: number;
6
+ payloadStageCount: number;
7
+ source: "manifest_literal";
8
+ byteCount: number;
9
+ }>;
10
+ /**
11
+ * Keeps tool-payload lifecycle and its adapter diagnostic provisional during
12
+ * preparation. Canonically admitted execution releases them in their original
13
+ * order; discarded preparations never publish them.
14
+ */
15
+ export declare function createDeferredPayloadObservability(params: {
16
+ executor: RegisteredToolNormalInvocationExecutor;
17
+ diagnostic: RegisteredToolWorkerCapabilityProviderDiagnostic;
18
+ operationId: string;
19
+ call: RoleCallFrame;
20
+ }): Readonly<{
21
+ lifecycleEmitter: Readonly<{
22
+ emitPayloadLifecycle(input: Parameters<RegisteredToolNormalInvocationExecutor["emitPayloadLifecycle"]>[0]): Readonly<{
23
+ status: "rejected";
24
+ code: string;
25
+ message: string;
26
+ }> | Readonly<{
27
+ status: "emitted";
28
+ }>;
29
+ }>;
30
+ deferPayloadStageMaterialized(details: PayloadStageMaterializationDetails): void;
31
+ release(executionId: string): void;
32
+ }>;
33
+ export type PayloadLifecycleEmitter = Readonly<{
34
+ emitPayloadLifecycle: RegisteredToolNormalInvocationExecutor["emitPayloadLifecycle"];
35
+ }>;
@@ -0,0 +1,32 @@
1
+ import { traceRegisteredToolWorkerCapabilityPayloadStageMaterialized, } from "../registered-tool-worker-capability-diagnostics.js";
2
+ /**
3
+ * Keeps tool-payload lifecycle and its adapter diagnostic provisional during
4
+ * preparation. Canonically admitted execution releases them in their original
5
+ * order; discarded preparations never publish them.
6
+ */
7
+ export function createDeferredPayloadObservability(params) {
8
+ const deferred = [];
9
+ const lifecycleEmitter = Object.freeze({
10
+ emitPayloadLifecycle(input) {
11
+ const prepared = params.executor.preparePayloadLifecycle(input);
12
+ if (prepared.status === "rejected")
13
+ return prepared;
14
+ deferred.push(() => {
15
+ prepared.emit();
16
+ });
17
+ return Object.freeze({ status: "emitted" });
18
+ },
19
+ });
20
+ return Object.freeze({
21
+ lifecycleEmitter,
22
+ deferPayloadStageMaterialized(details) {
23
+ deferred.push((executionId) => {
24
+ traceRegisteredToolWorkerCapabilityPayloadStageMaterialized(params.diagnostic, params.operationId, params.call, executionId, details);
25
+ });
26
+ },
27
+ release(executionId) {
28
+ for (const publish of deferred)
29
+ publish(executionId);
30
+ },
31
+ });
32
+ }
@@ -1,11 +1,11 @@
1
1
  import type { CapabilityAdapterResult } from "../../orchestration/capability-adapters/index.js";
2
2
  import type { WorkerCapabilityAdapterResult, WorkerCapabilityExecutionFreshness } from "../../orchestration/worker-capabilities/index.js";
3
- import type { RegisteredToolNormalInvocationExecutor } from "../registered-tool-normal-invocations.js";
3
+ import type { PayloadLifecycleEmitter } from "./payload-observability.js";
4
4
  export declare const STEERING_SUPERSEDED_BEFORE_EXTERNAL_EXECUTION: "steering_superseded_before_external_execution";
5
5
  export declare const STEERING_SUPERSEDED_SUMMARY = "steering_superseded_before_external_execution: No external execution occurred because a newer active-request update superseded this capability invocation.";
6
- export type PayloadLifecycleContext = Readonly<Omit<Parameters<RegisteredToolNormalInvocationExecutor["emitPayloadLifecycle"]>[0], "phase" | "errorCode">>;
6
+ export type PayloadLifecycleContext = Readonly<Omit<Parameters<PayloadLifecycleEmitter["emitPayloadLifecycle"]>[0], "phase" | "errorCode">>;
7
7
  export declare function rejectPayloadLifecycle(params: {
8
- executor: RegisteredToolNormalInvocationExecutor;
8
+ executor: PayloadLifecycleEmitter;
9
9
  lifecycle: PayloadLifecycleContext;
10
10
  code: string;
11
11
  message: string;
@@ -1,4 +1,5 @@
1
1
  import { boundedSummary, requireCapabilityAdapterResult, } from "./result-observer.js";
2
+ import { createRegisteredToolWorkerFailureOutcomeFingerprint } from "./failure-outcome-fingerprint.js";
2
3
  export const STEERING_SUPERSEDED_BEFORE_EXTERNAL_EXECUTION = "steering_superseded_before_external_execution";
3
4
  export const STEERING_SUPERSEDED_SUMMARY = "steering_superseded_before_external_execution: No external execution occurred because a newer active-request update superseded this capability invocation.";
4
5
  export function rejectPayloadLifecycle(params) {
@@ -12,22 +13,26 @@ export function rejectPayloadLifecycle(params) {
12
13
  : (params.fallback ?? payloadRejection(params.code, params.message));
13
14
  }
14
15
  export function payloadRejection(sourceIssueCode, summary) {
16
+ const exactResult = requireCapabilityAdapterResult({
17
+ kind: "runtime_capability_rejection_v1",
18
+ authority: "runtime",
19
+ status: "rejected",
20
+ stage: "before_external_execution",
21
+ code: sourceIssueCode,
22
+ message: summary,
23
+ });
15
24
  return Object.freeze({
16
25
  status: "rejected",
17
26
  result: Object.freeze({
18
27
  outcome: "failed",
19
28
  observedEffect: "none",
20
29
  summary: boundedSummary(summary),
30
+ failureOutcomeFingerprint: sourceIssueCode === STEERING_SUPERSEDED_BEFORE_EXTERNAL_EXECUTION
31
+ ? null
32
+ : createRegisteredToolWorkerFailureOutcomeFingerprint(exactResult),
21
33
  }),
22
34
  sourceIssueCode,
23
- exactResult: requireCapabilityAdapterResult({
24
- kind: "runtime_capability_rejection_v1",
25
- authority: "runtime",
26
- status: "rejected",
27
- stage: "before_external_execution",
28
- code: sourceIssueCode,
29
- message: summary,
30
- }),
35
+ exactResult,
31
36
  });
32
37
  }
33
38
  export function executionFreshnessRejection(freshness) {
@@ -1,23 +1,24 @@
1
1
  import type { ToolExecutionSharedState } from "../../../capabilities/tool-types.js";
2
2
  import type { CapabilityAdapterResult } from "../../orchestration/capability-adapters/index.js";
3
3
  import type { WorkerCapabilityAdapterResult, WorkerCapabilityExecutionFreshness, WorkerCapabilityPayloadAuthor } from "../../orchestration/worker-capabilities/index.js";
4
- import type { RegisteredToolNormalInvocationExecutor, RegisteredToolNormalInvocationProjection } from "../registered-tool-normal-invocations.js";
4
+ import type { RegisteredToolNormalInvocationProjection } from "../registered-tool-normal-invocations.js";
5
5
  import { type RegisteredToolStagedPayloadPlan } from "../registered-tool-payload-plan.js";
6
- import { type RegisteredToolWorkerCapabilityProviderDiagnostic } from "../registered-tool-worker-capability-diagnostics.js";
6
+ import type { PayloadLifecycleEmitter, PayloadStageMaterializationDetails } from "./payload-observability.js";
7
7
  export type StagedOperationPayloadParams = Readonly<{
8
8
  plan: RegisteredToolStagedPayloadPlan;
9
9
  handle: RegisteredToolNormalInvocationProjection["handle"];
10
- executor: RegisteredToolNormalInvocationExecutor;
10
+ executor: PayloadLifecycleEmitter;
11
11
  sharedState: ToolExecutionSharedState;
12
12
  payloadAuthor?: WorkerCapabilityPayloadAuthor;
13
13
  call: Parameters<WorkerCapabilityPayloadAuthor["author"]>[0]["call"];
14
14
  executionId: string;
15
15
  descriptor: Parameters<WorkerCapabilityPayloadAuthor["author"]>[0]["descriptor"];
16
16
  intent: string;
17
+ authoringObjective?: string;
17
18
  controls: Readonly<Record<string, unknown>>;
18
19
  dependencyResults?: Parameters<WorkerCapabilityPayloadAuthor["author"]>[0]["dependencyResults"];
19
20
  settledCapabilityResults: Parameters<WorkerCapabilityPayloadAuthor["author"]>[0]["settledCapabilityResults"];
20
- diagnostic: RegisteredToolWorkerCapabilityProviderDiagnostic;
21
+ deferPayloadStageMaterialized(details: PayloadStageMaterializationDetails): void;
21
22
  executionFreshness?: WorkerCapabilityExecutionFreshness;
22
23
  }>;
23
24
  export type StagedOperationPayloadResult = Readonly<{
@@ -1,5 +1,4 @@
1
1
  import { materializeRegisteredToolPayloadStageResponseFormat, resolveRegisteredToolPayloadRelatedArtifactContexts, resolveRegisteredToolPayloadStageLiteralOutput, resolveRegisteredToolPayloadStageMinBytes, resolveRegisteredToolPayloadTargetContext, validateRegisteredToolPayloadStageTargetLineBounds, } from "../registered-tool-payload-plan.js";
2
- import { traceRegisteredToolWorkerCapabilityPayloadStageMaterialized, } from "../registered-tool-worker-capability-diagnostics.js";
3
2
  import { normalizePayloadAuthoringResult } from "./payload-authoring-result.js";
4
3
  import { executionFreshnessRejection, payloadRejection, rejectPayloadLifecycle, STEERING_SUPERSEDED_BEFORE_EXTERNAL_EXECUTION, STEERING_SUPERSEDED_SUMMARY, } from "./payload-rejection.js";
5
4
  export async function prepareStagedOperationPayload(params) {
@@ -179,6 +178,9 @@ class PayloadStageRunner {
179
178
  call: this.params.call,
180
179
  executionId: this.params.executionId,
181
180
  descriptor: this.params.descriptor,
181
+ ...(this.params.authoringObjective
182
+ ? { authoringObjective: this.params.authoringObjective }
183
+ : {}),
182
184
  controls: this.params.controls,
183
185
  contextScope,
184
186
  ...(this.params.dependencyResults
@@ -267,7 +269,7 @@ class PayloadStageRunner {
267
269
  }
268
270
  completeStage(input) {
269
271
  if (input.stageInputs.literalResolution.status === "matched") {
270
- traceRegisteredToolWorkerCapabilityPayloadStageMaterialized(this.params.diagnostic, this.params.descriptor.capabilityId, this.params.call, this.params.executionId, {
272
+ this.params.deferPayloadStageMaterialized({
271
273
  payloadStage: input.started.stageIndex,
272
274
  payloadStageCount: input.started.stageCount,
273
275
  source: "manifest_literal",
@@ -1,14 +1,22 @@
1
1
  import { executionProtocolError } from "./errors.js";
2
+ import { createRegisteredToolWorkerFailureOutcomeFingerprint } from "./failure-outcome-fingerprint.js";
2
3
  import { boundedSummary, captureRegisteredToolResult, projectMutationGrounding, projectObservationOutput, projectToolTargetReferences, summarizeCompletedMutation, validateToolExecutionResult, } from "./result-evidence.js";
3
4
  import { isPlainRecord, nonEmpty, safeIssueCode } from "./values.js";
4
5
  export function observeExternalResult(input, expectedEffect, directRoot) {
5
6
  const observed = observeExternalResultLegacy(input, expectedEffect, directRoot);
7
+ const exactResult = captureRegisteredToolResult(input);
6
8
  return Object.freeze({
7
9
  ...observed,
8
- result: Object.freeze({
9
- ...observed.result,
10
- exactResult: captureRegisteredToolResult(input),
11
- }),
10
+ result: observed.result.outcome === "failed"
11
+ ? Object.freeze({
12
+ ...observed.result,
13
+ exactResult,
14
+ failureOutcomeFingerprint: createRegisteredToolWorkerFailureOutcomeFingerprint(exactResult),
15
+ })
16
+ : Object.freeze({
17
+ ...observed.result,
18
+ exactResult,
19
+ }),
12
20
  });
13
21
  }
14
22
  function observeExternalResultLegacy(input, expectedEffect, directRoot) {
@@ -3,6 +3,7 @@ import type { EventSinkFactory, ModelGatewayClient, RuntimeConfig, RuntimeHost,
3
3
  import type { RuntimeAttachmentStore } from "./attachments/store.js";
4
4
  import type { RequestHandlerOptions, RunRequestMessage } from "./request/contracts.js";
5
5
  import { type SessionMemoryCompactor } from "./context/session-memory/index.js";
6
+ import type { LongTermMemoryService } from "./long-term-memory/contracts.js";
6
7
  export type RuntimeEnvironmentServices = Readonly<{
7
8
  config: RuntimeConfig;
8
9
  sessions: SessionStore;
@@ -11,6 +12,7 @@ export type RuntimeEnvironmentServices = Readonly<{
11
12
  models: ModelGatewayClient;
12
13
  events: EventSinkFactory;
13
14
  sessionMemoryCompactor: SessionMemoryCompactor;
15
+ longTermMemory: LongTermMemoryService;
14
16
  }>;
15
17
  export type RuntimeRequestOptions = Pick<RequestHandlerOptions, "toolApprovalController" | "requestSteering">;
16
18
  export type RuntimeRequestHandler = Readonly<{
@@ -30,6 +32,7 @@ export type RuntimeDependencies = {
30
32
  models: ModelGatewayClient;
31
33
  events: EventSinkFactory;
32
34
  sessionMemoryCompactor: SessionMemoryCompactor;
35
+ longTermMemory: LongTermMemoryService;
33
36
  };
34
37
  export type RuntimeDependencyOverrides = Partial<Omit<RuntimeDependencies, "config">>;
35
38
  export type RuntimeApplicationOverrides = RuntimeDependencyOverrides;
@@ -1,16 +1,19 @@
1
- import { createBoundRuntimeRequestHandler, createDefaultAttachmentStore, createDefaultEventSinkFactory, createDefaultModelGatewayClient, createDefaultRuntimeHost, createDefaultSessionStore, createDefaultToolRegistry, } from "./default-adapters.js";
1
+ import { createBoundRuntimeRequestHandler, createDefaultAttachmentStore, createDefaultEventSinkFactory, createDefaultModelGatewayClient, createDefaultLongTermMemoryService, createDefaultRuntimeHost, createDefaultSessionStore, createDefaultToolRegistry, } from "./default-adapters.js";
2
2
  import { loadRuntimeConfig } from "./config.js";
3
3
  import { createModelSessionMemoryCompactor, } from "./context/session-memory/index.js";
4
4
  export function createRuntimeApplication(config = loadRuntimeConfig(), overrides = {}) {
5
5
  const tools = overrides.tools ?? createDefaultToolRegistry(config);
6
+ const models = overrides.models ?? createDefaultModelGatewayClient(config);
6
7
  const services = Object.freeze({
7
8
  config,
8
9
  sessions: overrides.sessions ?? createDefaultSessionStore(config),
9
10
  attachments: overrides.attachments ?? createDefaultAttachmentStore(config),
10
11
  tools,
11
- models: overrides.models ?? createDefaultModelGatewayClient(config),
12
+ models,
12
13
  events: overrides.events ?? createDefaultEventSinkFactory(config),
13
14
  sessionMemoryCompactor: overrides.sessionMemoryCompactor ?? createModelSessionMemoryCompactor(),
15
+ longTermMemory: overrides.longTermMemory ??
16
+ createDefaultLongTermMemoryService(config, models),
14
17
  });
15
18
  const requests = createRuntimeRequestHandler(services);
16
19
  const host = overrides.host ??
@@ -378,6 +378,33 @@ function buildModelProviders(providers) {
378
378
  }
379
379
  return entries.length > 0 ? Object.fromEntries(entries) : undefined;
380
380
  }
381
+ function buildEmbeddingProfiles(profiles) {
382
+ if (!isRecord(profiles)) {
383
+ return undefined;
384
+ }
385
+ const entries = [];
386
+ for (const [profileId, value] of Object.entries(profiles)) {
387
+ if (!isRecord(value)) {
388
+ continue;
389
+ }
390
+ const provider = readNestedConfigString(value, "provider");
391
+ const model = readNestedConfigString(value, "model");
392
+ if (!provider || !model) {
393
+ continue;
394
+ }
395
+ const label = readNestedConfigString(value, "label");
396
+ entries.push([
397
+ profileId,
398
+ {
399
+ provider,
400
+ model,
401
+ ...(label ? { label } : {}),
402
+ ...(isRecord(value.options) ? { options: { ...value.options } } : {}),
403
+ },
404
+ ]);
405
+ }
406
+ return entries.length > 0 ? Object.fromEntries(entries) : undefined;
407
+ }
381
408
  function buildModelProfiles(profiles, options) {
382
409
  if (!isRecord(profiles)) {
383
410
  return {};
@@ -461,14 +488,20 @@ export function buildRuntimeModelConfiguration(config, options) {
461
488
  }
462
489
  const providers = buildModelProviders(config.models.providers);
463
490
  const builtProfiles = buildModelProfiles(config.models.profiles, options);
491
+ const embeddingProfiles = buildEmbeddingProfiles(config.models.embeddingProfiles);
464
492
  const invocationProfiles = buildModelInvocationProfiles(config.models.invocationProfiles);
465
493
  const defaults = buildModelDefaults(config.models.defaults);
466
- const modelPolicy = providers || builtProfiles.gatewayProfiles || invocationProfiles || defaults
494
+ const modelPolicy = providers ||
495
+ builtProfiles.gatewayProfiles ||
496
+ embeddingProfiles ||
497
+ invocationProfiles ||
498
+ defaults
467
499
  ? {
468
500
  ...(providers ? { providers } : {}),
469
501
  ...(builtProfiles.gatewayProfiles
470
502
  ? { profiles: builtProfiles.gatewayProfiles }
471
503
  : {}),
504
+ ...(embeddingProfiles ? { embeddingProfiles } : {}),
472
505
  ...(invocationProfiles ? { invocationProfiles } : {}),
473
506
  ...(defaults ? { defaults } : {}),
474
507
  }
@@ -53,7 +53,13 @@ function validateInvocationTarget(params) {
53
53
  params.issues.push(`${params.field} references unknown model or invocation profile ${params.targetId}`);
54
54
  }
55
55
  }
56
+ function isImplicitRunnerStepTarget(params) {
57
+ return (params.acceptsIdentityDefault === true && params.targetId === params.stepId);
58
+ }
56
59
  function validateStepTarget(params) {
60
+ if (isImplicitRunnerStepTarget(params)) {
61
+ return;
62
+ }
57
63
  if (hasConfiguredProfile(params.profiles, params.targetId) ||
58
64
  hasConfiguredInvocationProfile(params.invocationProfiles, params.targetId) ||
59
65
  hasConfiguredCalibrationSlot(params.profiles, params.targetId)) {
@@ -139,6 +145,7 @@ export function validateEffectiveRuntimeModelConfig(params) {
139
145
  validateStepTarget({
140
146
  issues,
141
147
  field: `models.defaults.steps.${stepId}`,
148
+ stepId,
142
149
  targetId,
143
150
  profiles,
144
151
  invocationProfiles,
@@ -154,9 +161,11 @@ export function validateEffectiveRuntimeModelConfig(params) {
154
161
  validateStepTarget({
155
162
  issues,
156
163
  field: `requestRunner.models.defaults.steps.${stepId}`,
164
+ stepId,
157
165
  targetId,
158
166
  profiles,
159
167
  invocationProfiles,
168
+ acceptsIdentityDefault: true,
160
169
  });
161
170
  }
162
171
  if (issues.length > 0) {
@@ -0,0 +1,5 @@
1
+ export declare function validateEmbeddingProfiles(params: {
2
+ issues: string[];
3
+ models: Record<string, unknown>;
4
+ allowIncompleteSetup: boolean;
5
+ }): void;
@@ -0,0 +1,66 @@
1
+ import { hasOwnValue, isRecord } from "./utils.js";
2
+ export function validateEmbeddingProfiles(params) {
3
+ if (!hasOwnValue(params.models, "embeddingProfiles")) {
4
+ return;
5
+ }
6
+ const profiles = params.models.embeddingProfiles;
7
+ if (!isRecord(profiles)) {
8
+ params.issues.push("models.embeddingProfiles must be an object");
9
+ return;
10
+ }
11
+ for (const [profileId, profile] of Object.entries(profiles)) {
12
+ validateEmbeddingProfile({ ...params, profileId, profile });
13
+ }
14
+ }
15
+ function validateEmbeddingProfile(params) {
16
+ const displayKey = `models.embeddingProfiles.${params.profileId}`;
17
+ if (!params.profileId.trim()) {
18
+ params.issues.push("models.embeddingProfiles keys must be non-empty strings");
19
+ }
20
+ if (!isRecord(params.profile)) {
21
+ params.issues.push(`${displayKey} must be an object`);
22
+ return;
23
+ }
24
+ const profile = params.profile;
25
+ rejectUnsupportedFields(params.issues, profile, displayKey);
26
+ validateOptionalString(params.issues, profile, "label", displayKey);
27
+ validateRequiredString({ ...params, profile }, "provider", displayKey);
28
+ validateRequiredString({ ...params, profile }, "model", displayKey);
29
+ if (hasOwnValue(profile, "options") && !isRecord(profile.options)) {
30
+ params.issues.push(`${displayKey}.options must be an object`);
31
+ }
32
+ validateProviderReference({ ...params, profile }, displayKey);
33
+ }
34
+ function rejectUnsupportedFields(issues, profile, displayKey) {
35
+ const supported = new Set(["label", "provider", "model", "options"]);
36
+ for (const key of Object.keys(profile)) {
37
+ if (!supported.has(key)) {
38
+ issues.push(`${displayKey}.${key} is not supported for embeddings`);
39
+ }
40
+ }
41
+ }
42
+ function validateRequiredString(params, key, displayKey) {
43
+ if (params.allowIncompleteSetup && !hasOwnValue(params.profile, key)) {
44
+ return;
45
+ }
46
+ const value = params.profile[key];
47
+ if (typeof value !== "string" || !value.trim()) {
48
+ params.issues.push(`${displayKey}.${key} must be a non-empty string`);
49
+ }
50
+ }
51
+ function validateOptionalString(issues, profile, key, displayKey) {
52
+ const value = profile[key];
53
+ if (value !== undefined && (typeof value !== "string" || !value.trim())) {
54
+ issues.push(`${displayKey}.${key} must be a non-empty string`);
55
+ }
56
+ }
57
+ function validateProviderReference(params, displayKey) {
58
+ const providerId = params.profile.provider;
59
+ if (typeof providerId !== "string" || !providerId.trim()) {
60
+ return;
61
+ }
62
+ const providers = params.models.providers;
63
+ if (!isRecord(providers) || !Object.hasOwn(providers, providerId.trim())) {
64
+ params.issues.push(`${displayKey}.provider references unknown provider ${providerId.trim()}`);
65
+ }
66
+ }
@@ -194,6 +194,11 @@ export const RUNTIME_CONFIG_SCHEMA_FIELDS = [
194
194
  type: "object-map",
195
195
  description: "Host-defined model profiles keyed by profile id for model-gateway policy.",
196
196
  },
197
+ {
198
+ path: "models.embeddingProfiles",
199
+ type: "object-map",
200
+ description: "Provider and model bindings for non-generative embedding operations.",
201
+ },
197
202
  {
198
203
  path: "models.profiles.<profileId>.configRef",
199
204
  type: "non-empty-string",
@@ -246,6 +251,23 @@ export const RUNTIME_CONFIG_SCHEMA_FIELDS = [
246
251
  type: "non-empty-string",
247
252
  description: "Path to the runtime request-runner config file, resolved relative to the runtime config file.",
248
253
  },
254
+ {
255
+ path: "longTermMemory.enabled",
256
+ type: "boolean",
257
+ defaultValue: "false",
258
+ description: "Whether passive cross-session memory retrieval and collection are enabled.",
259
+ },
260
+ {
261
+ path: "longTermMemory.emitClientEvents",
262
+ type: "boolean",
263
+ defaultValue: "false",
264
+ description: "Whether bounded memory lifecycle events are visible to clients.",
265
+ },
266
+ {
267
+ path: "longTermMemory.embeddingProfileId",
268
+ type: "non-empty-string",
269
+ description: "Embedding profile used by passive long-term memory when enabled.",
270
+ },
249
271
  {
250
272
  path: "features",
251
273
  type: "feature-flag-map",
@@ -0,0 +1,9 @@
1
+ import type { RuntimeLongTermMemoryConfig } from "../ports.js";
2
+ import type { RuntimeConfigFile } from "./types.js";
3
+ export declare const DEFAULT_LONG_TERM_MEMORY_CONFIG: RuntimeLongTermMemoryConfig;
4
+ export declare function buildLongTermMemoryConfig(config: RuntimeConfigFile): RuntimeLongTermMemoryConfig;
5
+ export declare function validateLongTermMemoryConfig(params: {
6
+ issues: string[];
7
+ value: unknown;
8
+ embeddingProfiles: unknown;
9
+ }): void;