@abot-ai/runtime 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (751) hide show
  1. package/README.md +23 -6
  2. package/dist/scripts/add-runtime-model.js +4 -0
  3. package/dist/scripts/configure-long-term-memory.d.ts +6 -0
  4. package/dist/scripts/configure-long-term-memory.js +139 -0
  5. package/dist/scripts/init-runtime.js +11 -1
  6. package/dist/scripts/runtime-setup-files.d.ts +1 -0
  7. package/dist/scripts/runtime-setup-files.js +4 -0
  8. package/dist/src/capabilities/normal-invocation/contracts.d.ts +1 -0
  9. package/dist/src/capabilities/normal-invocation/validator.d.ts +5 -0
  10. package/dist/src/capabilities/normal-invocation/validator.js +35 -2
  11. package/dist/src/capabilities/tool-definition-validator/definition-fields.d.ts +7 -0
  12. package/dist/src/capabilities/tool-definition-validator/definition-fields.js +156 -0
  13. package/dist/src/capabilities/tool-definition-validator/definition-parser.d.ts +2 -0
  14. package/dist/src/capabilities/tool-definition-validator/definition-parser.js +76 -0
  15. package/dist/src/capabilities/tool-definition-validator/definition-shape.d.ts +7 -0
  16. package/dist/src/capabilities/tool-definition-validator/definition-shape.js +34 -0
  17. package/dist/src/capabilities/tool-definition-validator/event-presentation.d.ts +2 -0
  18. package/dist/src/capabilities/tool-definition-validator/event-presentation.js +97 -0
  19. package/dist/src/capabilities/tool-definition-validator/module-registry.d.ts +3 -0
  20. package/dist/src/capabilities/tool-definition-validator/module-registry.js +99 -0
  21. package/dist/src/capabilities/tool-definition-validator/payload-channel-spec.d.ts +2 -0
  22. package/dist/src/capabilities/tool-definition-validator/payload-channel-spec.js +190 -0
  23. package/dist/src/capabilities/tool-definition-validator/payload-channel-stage.d.ts +11 -0
  24. package/dist/src/capabilities/tool-definition-validator/payload-channel-stage.js +155 -0
  25. package/dist/src/capabilities/tool-definition-validator/payload-stage-conditions.d.ts +24 -0
  26. package/dist/src/capabilities/tool-definition-validator/payload-stage-conditions.js +193 -0
  27. package/dist/src/capabilities/tool-definition-validator.d.ts +2 -4
  28. package/dist/src/capabilities/tool-definition-validator.js +2 -776
  29. package/dist/src/capabilities/tool-types.d.ts +1 -1
  30. package/dist/src/cli/abot.js +11 -2
  31. package/dist/src/model-gateway/client/embeddings.d.ts +3 -0
  32. package/dist/src/model-gateway/client/embeddings.js +48 -0
  33. package/dist/src/model-gateway/client.d.ts +3 -1
  34. package/dist/src/model-gateway/client.js +5 -0
  35. package/dist/src/model-gateway/embeddings/constants.d.ts +1 -0
  36. package/dist/src/model-gateway/embeddings/constants.js +1 -0
  37. package/dist/src/model-gateway/embeddings/discovery.d.ts +10 -0
  38. package/dist/src/model-gateway/embeddings/discovery.js +39 -0
  39. package/dist/src/model-gateway/embeddings/execution.d.ts +16 -0
  40. package/dist/src/model-gateway/embeddings/execution.js +64 -0
  41. package/dist/src/model-gateway/embeddings/fingerprint.d.ts +3 -0
  42. package/dist/src/model-gateway/embeddings/fingerprint.js +36 -0
  43. package/dist/src/model-gateway/embeddings/profile.d.ts +11 -0
  44. package/dist/src/model-gateway/embeddings/profile.js +37 -0
  45. package/dist/src/model-gateway/embeddings/server-handler.d.ts +3 -0
  46. package/dist/src/model-gateway/embeddings/server-handler.js +89 -0
  47. package/dist/src/model-gateway/embeddings/validation.d.ts +7 -0
  48. package/dist/src/model-gateway/embeddings/validation.js +69 -0
  49. package/dist/src/model-gateway/index.d.ts +5 -3
  50. package/dist/src/model-gateway/index.js +3 -1
  51. package/dist/src/model-gateway/providers/contracts.d.ts +27 -1
  52. package/dist/src/model-gateway/providers/ollama/adapter.js +4 -0
  53. package/dist/src/model-gateway/providers/ollama/base-url.d.ts +1 -0
  54. package/dist/src/model-gateway/providers/ollama/base-url.js +4 -0
  55. package/dist/src/model-gateway/providers/ollama/embedding-models.d.ts +2 -0
  56. package/dist/src/model-gateway/providers/ollama/embedding-models.js +31 -0
  57. package/dist/src/model-gateway/providers/ollama/embeddings.d.ts +2 -0
  58. package/dist/src/model-gateway/providers/ollama/embeddings.js +43 -0
  59. package/dist/src/model-gateway/providers/ollama/generation-options.d.ts +1 -3
  60. package/dist/src/model-gateway/providers/ollama/generation-options.js +1 -5
  61. package/dist/src/model-gateway/providers/ollama/payload.js +0 -8
  62. package/dist/src/model-gateway/providers/ollama/request-diagnostics.js +2 -1
  63. package/dist/src/model-gateway/providers/openai/adapter.js +2 -0
  64. package/dist/src/model-gateway/providers/openai/embeddings.d.ts +2 -0
  65. package/dist/src/model-gateway/providers/openai/embeddings.js +87 -0
  66. package/dist/src/model-gateway/providers/openai/payload.js +5 -8
  67. package/dist/src/model-gateway/server/contracts.d.ts +5 -3
  68. package/dist/src/model-gateway/server/create-server.js +9 -0
  69. package/dist/src/model-gateway/server/errors.js +34 -0
  70. package/dist/src/model-gateway/server/index.d.ts +2 -0
  71. package/dist/src/model-gateway/server/index.js +2 -0
  72. package/dist/src/model-gateway/server/provider-fetch.d.ts +5 -3
  73. package/dist/src/model-gateway/server/provider-fetch.js +3 -1
  74. package/dist/src/model-gateway/server/request-body.d.ts +1 -1
  75. package/dist/src/model-gateway/server/request-body.js +1 -0
  76. package/dist/src/model-gateway/types.d.ts +39 -0
  77. package/dist/src/plugin-contract/manifest.d.ts +1 -0
  78. package/dist/src/plugin-sdk/index.d.ts +2 -0
  79. package/dist/src/plugin-sdk/index.js +2 -0
  80. package/dist/src/plugin-sdk/tool-availability-brief.d.ts +9 -0
  81. package/dist/src/plugin-sdk/tool-availability-brief.js +48 -0
  82. package/dist/src/plugin-sdk/tool-availability-overview.d.ts +9 -0
  83. package/dist/src/plugin-sdk/tool-availability-overview.js +62 -0
  84. package/dist/src/runtime/adapters/index.d.ts +4 -0
  85. package/dist/src/runtime/adapters/index.js +4 -0
  86. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.d.ts +2 -0
  87. package/dist/src/runtime/adapters/long-term-memory/file-lock/acquisition.js +77 -0
  88. package/dist/src/runtime/adapters/long-term-memory/file-lock/cleanup.d.ts +4 -0
  89. package/dist/src/runtime/adapters/long-term-memory/file-lock/cleanup.js +52 -0
  90. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.d.ts +31 -0
  91. package/dist/src/runtime/adapters/long-term-memory/file-lock/contracts.js +17 -0
  92. package/dist/src/runtime/adapters/long-term-memory/file-lock/install.d.ts +1 -0
  93. package/dist/src/runtime/adapters/long-term-memory/file-lock/install.js +36 -0
  94. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-record.d.ts +2 -0
  95. package/dist/src/runtime/adapters/long-term-memory/file-lock/owner-record.js +114 -0
  96. package/dist/src/runtime/adapters/long-term-memory/file-lock/snapshot.d.ts +2 -0
  97. package/dist/src/runtime/adapters/long-term-memory/file-lock/snapshot.js +103 -0
  98. package/dist/src/runtime/adapters/long-term-memory/file-lock.d.ts +2 -0
  99. package/dist/src/runtime/adapters/long-term-memory/file-lock.js +10 -0
  100. package/dist/src/runtime/adapters/long-term-memory/file-repository.d.ts +2 -0
  101. package/dist/src/runtime/adapters/long-term-memory/file-repository.js +57 -0
  102. package/dist/src/runtime/adapters/long-term-memory/in-memory-repository.d.ts +2 -0
  103. package/dist/src/runtime/adapters/long-term-memory/in-memory-repository.js +21 -0
  104. package/dist/src/runtime/adapters/long-term-memory/onboarding-config-repository.d.ts +5 -0
  105. package/dist/src/runtime/adapters/long-term-memory/onboarding-config-repository.js +60 -0
  106. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.d.ts +8 -0
  107. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.js +34 -0
  108. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.d.ts +7 -1
  109. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.js +54 -25
  110. package/dist/src/runtime/adapters/registered-tool-normal-invocations/executor.js +18 -4
  111. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.d.ts +6 -1
  112. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.js +25 -12
  113. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/action-fingerprint.d.ts +22 -0
  114. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/action-fingerprint.js +65 -0
  115. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +44 -0
  116. package/dist/src/runtime/adapters/registered-tool-normal-invocations.d.ts +1 -1
  117. package/dist/src/runtime/adapters/registered-tool-payload-plan.d.ts +0 -9
  118. package/dist/src/runtime/adapters/registered-tool-payload-plan.js +0 -67
  119. package/dist/src/runtime/adapters/registered-tool-payload-related-artifacts.d.ts +13 -0
  120. package/dist/src/runtime/adapters/registered-tool-payload-related-artifacts.js +84 -0
  121. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/catalog.js +18 -4
  122. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.js +221 -87
  123. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/failure-outcome-fingerprint.d.ts +7 -0
  124. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/failure-outcome-fingerprint.js +84 -0
  125. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.d.ts +6 -4
  126. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.js +18 -2
  127. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.d.ts +35 -0
  128. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.js +32 -0
  129. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.d.ts +3 -3
  130. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.js +13 -8
  131. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.d.ts +6 -4
  132. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.js +13 -3
  133. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.js +12 -4
  134. package/dist/src/runtime/capabilities/request-bound-tool-registry.js +1 -24
  135. package/dist/src/runtime/capabilities/tool-availability.d.ts +6 -0
  136. package/dist/src/runtime/capabilities/tool-availability.js +28 -0
  137. package/dist/src/runtime/composition.d.ts +3 -0
  138. package/dist/src/runtime/composition.js +5 -2
  139. package/dist/src/runtime/config/builders.js +34 -1
  140. package/dist/src/runtime/config/effective-model-config-validation.js +9 -0
  141. package/dist/src/runtime/config/embedding-profiles.d.ts +5 -0
  142. package/dist/src/runtime/config/embedding-profiles.js +66 -0
  143. package/dist/src/runtime/config/fields.js +22 -0
  144. package/dist/src/runtime/config/long-term-memory.d.ts +9 -0
  145. package/dist/src/runtime/config/long-term-memory.js +71 -0
  146. package/dist/src/runtime/config/runner/config-normalization.d.ts +16 -0
  147. package/dist/src/runtime/config/runner/config-normalization.js +109 -0
  148. package/dist/src/runtime/config/runner/loader.d.ts +1 -1
  149. package/dist/src/runtime/config/runner/loader.js +2 -69
  150. package/dist/src/runtime/config/runner/model-policy.js +3 -0
  151. package/dist/src/runtime/config/runner/schema-version.d.ts +14 -0
  152. package/dist/src/runtime/config/runner/schema-version.js +35 -0
  153. package/dist/src/runtime/config/runner/versioned-config.d.ts +2 -0
  154. package/dist/src/runtime/config/runner/versioned-config.js +51 -0
  155. package/dist/src/runtime/config/schema.js +36 -0
  156. package/dist/src/runtime/config/types.d.ts +1 -0
  157. package/dist/src/runtime/config/validation/environment-config-validation.d.ts +1 -0
  158. package/dist/src/runtime/config/validation/environment-config-validation.js +41 -0
  159. package/dist/src/runtime/config/validation/model-invocation-config-validation.d.ts +2 -0
  160. package/dist/src/runtime/config/validation/model-invocation-config-validation.js +64 -0
  161. package/dist/src/runtime/config/validation/model-invocation-override-validation.d.ts +2 -0
  162. package/dist/src/runtime/config/validation/model-invocation-override-validation.js +72 -0
  163. package/dist/src/runtime/config/validation/model-profile-validation.d.ts +4 -0
  164. package/dist/src/runtime/config/validation/model-profile-validation.js +87 -0
  165. package/dist/src/runtime/config/validation/model-registry-validation.d.ts +2 -0
  166. package/dist/src/runtime/config/validation/model-registry-validation.js +118 -0
  167. package/dist/src/runtime/config/validation/path-config-validation.d.ts +1 -0
  168. package/dist/src/runtime/config/validation/path-config-validation.js +7 -0
  169. package/dist/src/runtime/config/validation/runtime-config-field-validation.d.ts +12 -0
  170. package/dist/src/runtime/config/validation/runtime-config-field-validation.js +158 -0
  171. package/dist/src/runtime/config/validation/runtime-config-validation-contract.d.ts +9 -0
  172. package/dist/src/runtime/config/validation/runtime-config-validation-contract.js +13 -0
  173. package/dist/src/runtime/config/validation/runtime-root-section-validation.d.ts +6 -0
  174. package/dist/src/runtime/config/validation/runtime-root-section-validation.js +82 -0
  175. package/dist/src/runtime/config/validation/web-ui-config-validation.d.ts +3 -0
  176. package/dist/src/runtime/config/validation/web-ui-config-validation.js +26 -0
  177. package/dist/src/runtime/config/validation.d.ts +4 -15
  178. package/dist/src/runtime/config/validation.js +27 -499
  179. package/dist/src/runtime/config.js +3 -0
  180. package/dist/src/runtime/context/accepted-capability-action.d.ts +11 -0
  181. package/dist/src/runtime/context/accepted-capability-action.js +29 -0
  182. package/dist/src/runtime/context/capability-brief.d.ts +25 -0
  183. package/dist/src/runtime/context/capability-brief.js +106 -0
  184. package/dist/src/runtime/context/model-step-compaction.js +6 -0
  185. package/dist/src/runtime/context/operation-supervision-evidence.d.ts +37 -0
  186. package/dist/src/runtime/context/operation-supervision-evidence.js +90 -0
  187. package/dist/src/runtime/context/request-tool-results-message-binding.d.ts +6 -0
  188. package/dist/src/runtime/context/request-tool-results-message-binding.js +30 -0
  189. package/dist/src/runtime/context/request-tool-results-scope.d.ts +3 -0
  190. package/dist/src/runtime/context/request-tool-results-scope.js +8 -0
  191. package/dist/src/runtime/context/request-tool-results.d.ts +11 -4
  192. package/dist/src/runtime/context/request-tool-results.js +60 -40
  193. package/dist/src/runtime/default-adapters.d.ts +3 -0
  194. package/dist/src/runtime/default-adapters.js +64 -3
  195. package/dist/src/runtime/index.d.ts +1 -0
  196. package/dist/src/runtime/index.js +1 -0
  197. package/dist/src/runtime/lifecycle/request-finalizer.d.ts +3 -0
  198. package/dist/src/runtime/lifecycle/request-finalizer.js +8 -0
  199. package/dist/src/runtime/long-term-memory/background-save-queue.d.ts +17 -0
  200. package/dist/src/runtime/long-term-memory/background-save-queue.js +66 -0
  201. package/dist/src/runtime/long-term-memory/candidate-persistence.d.ts +16 -0
  202. package/dist/src/runtime/long-term-memory/candidate-persistence.js +109 -0
  203. package/dist/src/runtime/long-term-memory/candidate-preparation.d.ts +8 -0
  204. package/dist/src/runtime/long-term-memory/candidate-preparation.js +36 -0
  205. package/dist/src/runtime/long-term-memory/candidate-processing.d.ts +9 -0
  206. package/dist/src/runtime/long-term-memory/candidate-processing.js +79 -0
  207. package/dist/src/runtime/long-term-memory/contracts.d.ts +108 -0
  208. package/dist/src/runtime/long-term-memory/contracts.js +1 -0
  209. package/dist/src/runtime/long-term-memory/diagnostics.d.ts +9 -0
  210. package/dist/src/runtime/long-term-memory/diagnostics.js +42 -0
  211. package/dist/src/runtime/long-term-memory/embedding-batches.d.ts +13 -0
  212. package/dist/src/runtime/long-term-memory/embedding-batches.js +87 -0
  213. package/dist/src/runtime/long-term-memory/events.d.ts +13 -0
  214. package/dist/src/runtime/long-term-memory/events.js +15 -0
  215. package/dist/src/runtime/long-term-memory/finalization.d.ts +8 -0
  216. package/dist/src/runtime/long-term-memory/finalization.js +24 -0
  217. package/dist/src/runtime/long-term-memory/index.d.ts +6 -0
  218. package/dist/src/runtime/long-term-memory/index.js +6 -0
  219. package/dist/src/runtime/long-term-memory/management/contracts.d.ts +54 -0
  220. package/dist/src/runtime/long-term-memory/management/contracts.js +1 -0
  221. package/dist/src/runtime/long-term-memory/management/errors.d.ts +10 -0
  222. package/dist/src/runtime/long-term-memory/management/errors.js +13 -0
  223. package/dist/src/runtime/long-term-memory/management/mutations.d.ts +17 -0
  224. package/dist/src/runtime/long-term-memory/management/mutations.js +178 -0
  225. package/dist/src/runtime/long-term-memory/management/queries.d.ts +8 -0
  226. package/dist/src/runtime/long-term-memory/management/queries.js +46 -0
  227. package/dist/src/runtime/long-term-memory/management/search.d.ts +7 -0
  228. package/dist/src/runtime/long-term-memory/management/search.js +18 -0
  229. package/dist/src/runtime/long-term-memory/management/service.d.ts +13 -0
  230. package/dist/src/runtime/long-term-memory/management/service.js +61 -0
  231. package/dist/src/runtime/long-term-memory/management/validation.d.ts +24 -0
  232. package/dist/src/runtime/long-term-memory/management/validation.js +77 -0
  233. package/dist/src/runtime/long-term-memory/onboarding/configuration.d.ts +14 -0
  234. package/dist/src/runtime/long-term-memory/onboarding/configuration.js +92 -0
  235. package/dist/src/runtime/long-term-memory/onboarding/contracts.d.ts +52 -0
  236. package/dist/src/runtime/long-term-memory/onboarding/contracts.js +1 -0
  237. package/dist/src/runtime/long-term-memory/onboarding/service.d.ts +21 -0
  238. package/dist/src/runtime/long-term-memory/onboarding/service.js +88 -0
  239. package/dist/src/runtime/long-term-memory/policies/normalization.d.ts +10 -0
  240. package/dist/src/runtime/long-term-memory/policies/normalization.js +45 -0
  241. package/dist/src/runtime/long-term-memory/policies/reconciliation.d.ts +20 -0
  242. package/dist/src/runtime/long-term-memory/policies/reconciliation.js +21 -0
  243. package/dist/src/runtime/long-term-memory/policies/scoring.d.ts +13 -0
  244. package/dist/src/runtime/long-term-memory/policies/scoring.js +55 -0
  245. package/dist/src/runtime/long-term-memory/policies/sensitive-data.d.ts +5 -0
  246. package/dist/src/runtime/long-term-memory/policies/sensitive-data.js +12 -0
  247. package/dist/src/runtime/long-term-memory/projection.d.ts +4 -0
  248. package/dist/src/runtime/long-term-memory/projection.js +39 -0
  249. package/dist/src/runtime/long-term-memory/ranked-search.d.ts +11 -0
  250. package/dist/src/runtime/long-term-memory/ranked-search.js +111 -0
  251. package/dist/src/runtime/long-term-memory/repository-state.d.ts +4 -0
  252. package/dist/src/runtime/long-term-memory/repository-state.js +131 -0
  253. package/dist/src/runtime/long-term-memory/response-context.d.ts +5 -0
  254. package/dist/src/runtime/long-term-memory/response-context.js +21 -0
  255. package/dist/src/runtime/long-term-memory/retrieval.d.ts +8 -0
  256. package/dist/src/runtime/long-term-memory/retrieval.js +73 -0
  257. package/dist/src/runtime/long-term-memory/service.d.ts +10 -0
  258. package/dist/src/runtime/long-term-memory/service.js +83 -0
  259. package/dist/src/runtime/orchestration/capability-adapters/index.d.ts +2 -0
  260. package/dist/src/runtime/orchestration/capability-adapters/index.js +2 -0
  261. package/dist/src/runtime/orchestration/final-response/authoring-contract.d.ts +10 -0
  262. package/dist/src/runtime/orchestration/final-response/authoring-contract.js +94 -0
  263. package/dist/src/runtime/orchestration/final-response/finalization.d.ts +1 -0
  264. package/dist/src/runtime/orchestration/final-response/finalization.js +1 -0
  265. package/dist/src/runtime/orchestration/final-response/format.d.ts +2 -0
  266. package/dist/src/runtime/orchestration/final-response/format.js +49 -0
  267. package/dist/src/runtime/orchestration/final-response/invoke.d.ts +16 -0
  268. package/dist/src/runtime/orchestration/final-response/invoke.js +24 -0
  269. package/dist/src/runtime/orchestration/role-calls/activation-budget.d.ts +14 -0
  270. package/dist/src/runtime/orchestration/role-calls/activation-budget.js +52 -0
  271. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +162 -1
  272. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.js +1 -8
  273. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-issuance.d.ts +17 -0
  274. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision-issuance.js +155 -0
  275. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision.d.ts +78 -0
  276. package/dist/src/runtime/orchestration/role-calls/capability-selection-supervision.js +339 -0
  277. package/dist/src/runtime/orchestration/role-calls/child-return.d.ts +4 -0
  278. package/dist/src/runtime/orchestration/role-calls/child-return.js +25 -5
  279. package/dist/src/runtime/orchestration/role-calls/command-decoder.js +43 -13
  280. package/dist/src/runtime/orchestration/role-calls/command-dispatch/active-capability-caller.d.ts +6 -0
  281. package/dist/src/runtime/orchestration/role-calls/command-dispatch/active-capability-caller.js +15 -0
  282. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-frame-state.d.ts +3 -0
  283. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-frame-state.js +6 -0
  284. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-scope-transitions.d.ts +3 -0
  285. package/dist/src/runtime/orchestration/role-calls/command-dispatch/call-scope-transitions.js +86 -0
  286. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-batch-transitions.d.ts +3 -0
  287. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-batch-transitions.js +172 -0
  288. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-state.d.ts +9 -0
  289. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-state.js +28 -0
  290. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-transitions.d.ts +3 -0
  291. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-execution-transitions.js +117 -0
  292. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-invocation.d.ts +4 -0
  293. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-invocation.js +16 -0
  294. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-selection-transition.d.ts +2 -0
  295. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-selection-transition.js +114 -0
  296. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-settlement.d.ts +6 -0
  297. package/dist/src/runtime/orchestration/role-calls/command-dispatch/capability-settlement.js +54 -0
  298. package/dist/src/runtime/orchestration/role-calls/command-dispatch/child-transitions.d.ts +3 -0
  299. package/dist/src/runtime/orchestration/role-calls/command-dispatch/child-transitions.js +221 -0
  300. package/dist/src/runtime/orchestration/role-calls/command-dispatch/operation-supervision-intervention.d.ts +13 -0
  301. package/dist/src/runtime/orchestration/role-calls/command-dispatch/operation-supervision-intervention.js +25 -0
  302. package/dist/src/runtime/orchestration/role-calls/command-dispatch/root-transitions.d.ts +3 -0
  303. package/dist/src/runtime/orchestration/role-calls/command-dispatch/root-transitions.js +70 -0
  304. package/dist/src/runtime/orchestration/role-calls/command-dispatch.d.ts +2 -2
  305. package/dist/src/runtime/orchestration/role-calls/command-dispatch.js +8 -582
  306. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +48 -5
  307. package/dist/src/runtime/orchestration/role-calls/contracts.js +4 -4
  308. package/dist/src/runtime/orchestration/role-calls/dependency-results.d.ts +1 -1
  309. package/dist/src/runtime/orchestration/role-calls/dependency-results.js +1 -0
  310. package/dist/src/runtime/orchestration/role-calls/diagnostics.d.ts +4 -0
  311. package/dist/src/runtime/orchestration/role-calls/diagnostics.js +152 -1
  312. package/dist/src/runtime/orchestration/role-calls/index.d.ts +11 -1
  313. package/dist/src/runtime/orchestration/role-calls/index.js +11 -1
  314. package/dist/src/runtime/orchestration/role-calls/ledger.d.ts +3 -1
  315. package/dist/src/runtime/orchestration/role-calls/ledger.js +139 -8
  316. package/dist/src/runtime/orchestration/role-calls/operation-supervision-issuance.d.ts +11 -0
  317. package/dist/src/runtime/orchestration/role-calls/operation-supervision-issuance.js +66 -0
  318. package/dist/src/runtime/orchestration/role-calls/operation-supervision-projection.d.ts +16 -0
  319. package/dist/src/runtime/orchestration/role-calls/operation-supervision-projection.js +52 -0
  320. package/dist/src/runtime/orchestration/role-calls/operation-supervision-state-validation.d.ts +3 -0
  321. package/dist/src/runtime/orchestration/role-calls/operation-supervision-state-validation.js +151 -0
  322. package/dist/src/runtime/orchestration/role-calls/operation-supervision.d.ts +112 -0
  323. package/dist/src/runtime/orchestration/role-calls/operation-supervision.js +197 -0
  324. package/dist/src/runtime/orchestration/role-calls/reconsideration-cause.d.ts +26 -0
  325. package/dist/src/runtime/orchestration/role-calls/reconsideration-cause.js +127 -0
  326. package/dist/src/runtime/orchestration/role-calls/reducer-primitives.d.ts +1 -2
  327. package/dist/src/runtime/orchestration/role-calls/reducer-primitives.js +2 -12
  328. package/dist/src/runtime/orchestration/role-calls/reducer.d.ts +1 -1
  329. package/dist/src/runtime/orchestration/role-calls/reducer.js +20 -3
  330. package/dist/src/runtime/orchestration/role-calls/result-receipt.d.ts +49 -0
  331. package/dist/src/runtime/orchestration/role-calls/result-receipt.js +188 -0
  332. package/dist/src/runtime/orchestration/role-calls/return-result-receipt.d.ts +19 -0
  333. package/dist/src/runtime/orchestration/role-calls/return-result-receipt.js +52 -0
  334. package/dist/src/runtime/orchestration/role-calls/transactions.js +63 -5
  335. package/dist/src/runtime/orchestration/role-calls/work-result-lineage.d.ts +34 -0
  336. package/dist/src/runtime/orchestration/role-calls/work-result-lineage.js +185 -0
  337. package/dist/src/runtime/orchestration/role-calls/work-result-receipt.d.ts +36 -0
  338. package/dist/src/runtime/orchestration/role-calls/work-result-receipt.js +187 -0
  339. package/dist/src/runtime/orchestration/role-executors/activation/capability-continuation.d.ts +15 -0
  340. package/dist/src/runtime/orchestration/role-executors/activation/capability-continuation.js +73 -0
  341. package/dist/src/runtime/orchestration/role-executors/activation/loop.d.ts +0 -1
  342. package/dist/src/runtime/orchestration/role-executors/activation/loop.js +16 -54
  343. package/dist/src/runtime/orchestration/role-executors/activation/result-normalization.js +20 -3
  344. package/dist/src/runtime/orchestration/role-executors/activation/state-validation.d.ts +13 -1
  345. package/dist/src/runtime/orchestration/role-executors/activation/state-validation.js +137 -1
  346. package/dist/src/runtime/orchestration/role-executors/child-invocation/transaction.js +1 -0
  347. package/dist/src/runtime/orchestration/role-executors/contracts.d.ts +8 -3
  348. package/dist/src/runtime/orchestration/role-executors/diagnostics.d.ts +2 -0
  349. package/dist/src/runtime/orchestration/role-executors/diagnostics.js +1 -6
  350. package/dist/src/runtime/orchestration/worker-capabilities/assignment-provenance.d.ts +36 -0
  351. package/dist/src/runtime/orchestration/worker-capabilities/assignment-provenance.js +171 -0
  352. package/dist/src/runtime/orchestration/worker-capabilities/batch-selection.d.ts +10 -0
  353. package/dist/src/runtime/orchestration/worker-capabilities/batch-selection.js +8 -0
  354. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-catalog.d.ts +14 -0
  355. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-catalog.js +76 -0
  356. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-normalization.d.ts +10 -0
  357. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-normalization.js +160 -0
  358. package/dist/src/runtime/orchestration/worker-capabilities/binding/binding-rejection.d.ts +2 -0
  359. package/dist/src/runtime/orchestration/worker-capabilities/binding/binding-rejection.js +8 -0
  360. package/dist/src/runtime/orchestration/worker-capabilities/binding/bound-capability-session.d.ts +24 -0
  361. package/dist/src/runtime/orchestration/worker-capabilities/binding/bound-capability-session.js +100 -0
  362. package/dist/src/runtime/orchestration/worker-capabilities/binding/call-authority.d.ts +29 -0
  363. package/dist/src/runtime/orchestration/worker-capabilities/binding/call-authority.js +193 -0
  364. package/dist/src/runtime/orchestration/worker-capabilities/binding/create-binding.d.ts +11 -0
  365. package/dist/src/runtime/orchestration/worker-capabilities/binding/create-binding.js +109 -0
  366. package/dist/src/runtime/orchestration/worker-capabilities/binding/dependency-results.d.ts +2 -0
  367. package/dist/src/runtime/orchestration/worker-capabilities/binding/dependency-results.js +34 -0
  368. package/dist/src/runtime/orchestration/worker-capabilities/binding/invocation-preparation.d.ts +21 -0
  369. package/dist/src/runtime/orchestration/worker-capabilities/binding/invocation-preparation.js +167 -0
  370. package/dist/src/runtime/orchestration/worker-capabilities/binding.d.ts +1 -13
  371. package/dist/src/runtime/orchestration/worker-capabilities/binding.js +1 -625
  372. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +89 -15
  373. package/dist/src/runtime/orchestration/worker-capabilities/contracts.js +3 -1
  374. package/dist/src/runtime/orchestration/worker-capabilities/controls.d.ts +7 -0
  375. package/dist/src/runtime/orchestration/worker-capabilities/controls.js +50 -0
  376. package/dist/src/runtime/orchestration/worker-capabilities/error-fingerprint.d.ts +5 -0
  377. package/dist/src/runtime/orchestration/worker-capabilities/error-fingerprint.js +119 -0
  378. package/dist/src/runtime/orchestration/worker-capabilities/errors.d.ts +6 -0
  379. package/dist/src/runtime/orchestration/worker-capabilities/errors.js +11 -0
  380. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-exact-result.d.ts +7 -0
  381. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-exact-result.js +35 -0
  382. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-execution.d.ts +9 -0
  383. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-execution.js +28 -0
  384. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-normalization.d.ts +18 -0
  385. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-normalization.js +197 -0
  386. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-references.d.ts +2 -0
  387. package/dist/src/runtime/orchestration/worker-capabilities/execution/adapter-result-references.js +44 -0
  388. package/dist/src/runtime/orchestration/worker-capabilities/execution/context-projection.d.ts +12 -0
  389. package/dist/src/runtime/orchestration/worker-capabilities/execution/context-projection.js +51 -0
  390. package/dist/src/runtime/orchestration/worker-capabilities/execution/invocation-preparation.d.ts +26 -0
  391. package/dist/src/runtime/orchestration/worker-capabilities/execution/invocation-preparation.js +114 -0
  392. package/dist/src/runtime/orchestration/worker-capabilities/execution/ledger-transaction.d.ts +20 -0
  393. package/dist/src/runtime/orchestration/worker-capabilities/execution/ledger-transaction.js +142 -0
  394. package/dist/src/runtime/orchestration/worker-capabilities/execution.d.ts +10 -14
  395. package/dist/src/runtime/orchestration/worker-capabilities/execution.js +107 -357
  396. package/dist/src/runtime/orchestration/worker-capabilities/index.d.ts +5 -0
  397. package/dist/src/runtime/orchestration/worker-capabilities/index.js +5 -0
  398. package/dist/src/runtime/orchestration/worker-capabilities/outcome-fingerprint.d.ts +8 -0
  399. package/dist/src/runtime/orchestration/worker-capabilities/outcome-fingerprint.js +21 -0
  400. package/dist/src/runtime/orchestration/worker-capabilities/payload-assignment-validation.d.ts +3 -0
  401. package/dist/src/runtime/orchestration/worker-capabilities/payload-assignment-validation.js +30 -0
  402. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.js +23 -12
  403. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.d.ts +20 -7
  404. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.js +2 -0
  405. package/dist/src/runtime/orchestration/worker-capabilities/payload-instructions.js +4 -4
  406. package/dist/src/runtime/orchestration/worker-capabilities/payload-source-provenance.d.ts +14 -0
  407. package/dist/src/runtime/orchestration/worker-capabilities/payload-source-provenance.js +132 -0
  408. package/dist/src/runtime/orchestration/worker-capabilities/preparation-fingerprint.d.ts +23 -0
  409. package/dist/src/runtime/orchestration/worker-capabilities/preparation-fingerprint.js +109 -0
  410. package/dist/src/runtime/plugins/manifest-projection.js +3 -0
  411. package/dist/src/runtime/plugins/manifest-validator.js +20 -0
  412. package/dist/src/runtime/ports.d.ts +10 -1
  413. package/dist/src/runtime/request/capability-brief.d.ts +5 -0
  414. package/dist/src/runtime/request/capability-brief.js +24 -0
  415. package/dist/src/runtime/request/contracts.d.ts +7 -0
  416. package/dist/src/runtime/request/dependencies.d.ts +1 -0
  417. package/dist/src/runtime/request/dependencies.js +10 -1
  418. package/dist/src/runtime/request/execution-agent-root-execution.js +5 -4
  419. package/dist/src/runtime/request/execution-facets.d.ts +2 -1
  420. package/dist/src/runtime/request/execution-facets.js +6 -0
  421. package/dist/src/runtime/request/execution-scope-surfaces.js +6 -0
  422. package/dist/src/runtime/request/execution-scope.d.ts +5 -3
  423. package/dist/src/runtime/request/handler.js +4 -1
  424. package/dist/src/runtime/request/result.d.ts +2 -0
  425. package/dist/src/runtime/request/role-executor-composition.js +1 -1
  426. package/dist/src/runtime/request/root-contract.d.ts +4 -2
  427. package/dist/src/runtime/request/root-execution-kernel.js +100 -31
  428. package/dist/src/runtime/request/supervisor-root-execution.js +4 -2
  429. package/dist/src/runtime/request/worker-capability-composition.d.ts +2 -1
  430. package/dist/src/runtime/request/worker-capability-composition.js +6 -1
  431. package/dist/src/runtime/request/worker-capability-payload-prompts.js +1 -1
  432. package/dist/src/runtime/request/worker-capability-payload.js +11 -8
  433. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.d.ts +24 -0
  434. package/dist/src/runtime/steps/execution-agent/capability-invocation-contract.js +52 -0
  435. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +5 -2
  436. package/dist/src/runtime/steps/execution-agent/format.js +19 -6
  437. package/dist/src/runtime/steps/execution-agent/input.js +8 -12
  438. package/dist/src/runtime/steps/execution-agent/parser.js +25 -19
  439. package/dist/src/runtime/steps/execution-agent/prompt.js +6 -4
  440. package/dist/src/runtime/steps/execution-agent/reconsideration-context.d.ts +3 -0
  441. package/dist/src/runtime/steps/execution-agent/reconsideration-context.js +76 -0
  442. package/dist/src/runtime/steps/execution-agent/refinement-prompt.js +4 -4
  443. package/dist/src/runtime/steps/execution-agent/refinement-reconsideration.d.ts +3 -0
  444. package/dist/src/runtime/steps/execution-agent/refinement-reconsideration.js +25 -0
  445. package/dist/src/runtime/steps/execution-agent/refinement.d.ts +4 -7
  446. package/dist/src/runtime/steps/execution-agent/refinement.js +24 -35
  447. package/dist/src/runtime/steps/execution-agent/response-input.d.ts +2 -0
  448. package/dist/src/runtime/steps/execution-agent/response-input.js +22 -6
  449. package/dist/src/runtime/steps/execution-agent/response-prompt.d.ts +1 -1
  450. package/dist/src/runtime/steps/execution-agent/response-prompt.js +8 -3
  451. package/dist/src/runtime/steps/execution-agent/response-run.d.ts +6 -0
  452. package/dist/src/runtime/steps/execution-agent/response-run.js +40 -10
  453. package/dist/src/runtime/steps/execution-agent/run.js +6 -6
  454. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +4 -1
  455. package/dist/src/runtime/steps/execution-agent/state-context.js +40 -23
  456. package/dist/src/runtime/steps/planner-decision/capability-catalog-context.d.ts +14 -0
  457. package/dist/src/runtime/steps/planner-decision/capability-catalog-context.js +87 -0
  458. package/dist/src/runtime/steps/planner-decision/contracts.d.ts +3 -5
  459. package/dist/src/runtime/steps/planner-decision/contracts.js +3 -3
  460. package/dist/src/runtime/steps/planner-decision/format.d.ts +3 -2
  461. package/dist/src/runtime/steps/planner-decision/format.js +73 -76
  462. package/dist/src/runtime/steps/planner-decision/input.d.ts +4 -3
  463. package/dist/src/runtime/steps/planner-decision/input.js +10 -7
  464. package/dist/src/runtime/steps/planner-decision/parser.d.ts +3 -2
  465. package/dist/src/runtime/steps/planner-decision/parser.js +10 -19
  466. package/dist/src/runtime/steps/planner-decision/plan-parser.js +18 -12
  467. package/dist/src/runtime/steps/planner-decision/prompt.js +33 -28
  468. package/dist/src/runtime/steps/planner-decision/resume.d.ts +1 -1
  469. package/dist/src/runtime/steps/planner-decision/resume.js +38 -1
  470. package/dist/src/runtime/steps/planner-decision/run.d.ts +3 -2
  471. package/dist/src/runtime/steps/reviewer-decision/audit-coverage.d.ts +10 -0
  472. package/dist/src/runtime/steps/reviewer-decision/audit-coverage.js +186 -0
  473. package/dist/src/runtime/steps/reviewer-decision/contracts.d.ts +3 -8
  474. package/dist/src/runtime/steps/reviewer-decision/contracts.js +12 -6
  475. package/dist/src/runtime/steps/reviewer-decision/delegated-context.d.ts +24 -0
  476. package/dist/src/runtime/steps/reviewer-decision/delegated-context.js +70 -0
  477. package/dist/src/runtime/steps/reviewer-decision/diagnostics.js +1 -1
  478. package/dist/src/runtime/steps/reviewer-decision/format.js +37 -24
  479. package/dist/src/runtime/steps/reviewer-decision/input.js +1 -1
  480. package/dist/src/runtime/steps/reviewer-decision/model-context.d.ts +4 -3
  481. package/dist/src/runtime/steps/reviewer-decision/model-context.js +92 -10
  482. package/dist/src/runtime/steps/reviewer-decision/parser.js +19 -1
  483. package/dist/src/runtime/steps/reviewer-decision/projection.js +42 -68
  484. package/dist/src/runtime/steps/reviewer-decision/prompt.js +10 -5
  485. package/dist/src/runtime/steps/reviewer-decision/run.js +12 -3
  486. package/dist/src/runtime/steps/reviewer-decision/verification-coverage.d.ts +14 -0
  487. package/dist/src/runtime/steps/reviewer-decision/verification-coverage.js +52 -0
  488. package/dist/src/runtime/steps/supervisor-decision/capability-brief.d.ts +14 -0
  489. package/dist/src/runtime/steps/supervisor-decision/capability-brief.js +38 -0
  490. package/dist/src/runtime/steps/supervisor-decision/contracts.d.ts +7 -3
  491. package/dist/src/runtime/steps/supervisor-decision/diagnostics.d.ts +2 -0
  492. package/dist/src/runtime/steps/supervisor-decision/diagnostics.js +8 -2
  493. package/dist/src/runtime/steps/supervisor-decision/format.js +32 -20
  494. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +4 -1
  495. package/dist/src/runtime/steps/supervisor-decision/input.js +19 -1
  496. package/dist/src/runtime/steps/supervisor-decision/parser.js +62 -59
  497. package/dist/src/runtime/steps/supervisor-decision/prompt.js +6 -7
  498. package/dist/src/runtime/steps/supervisor-decision/resume.js +47 -1
  499. package/dist/src/runtime/steps/supervisor-decision/run.js +10 -0
  500. package/dist/src/runtime/steps/supervisor-decision/working-directory.js +2 -1
  501. package/dist/src/runtime/steps/supervisor-response/index.d.ts +1 -1
  502. package/dist/src/runtime/steps/supervisor-response/index.js +1 -1
  503. package/dist/src/runtime/steps/supervisor-response/input.d.ts +13 -5
  504. package/dist/src/runtime/steps/supervisor-response/input.js +27 -8
  505. package/dist/src/runtime/steps/supervisor-response/memory-authoring.d.ts +10 -0
  506. package/dist/src/runtime/steps/supervisor-response/memory-authoring.js +125 -0
  507. package/dist/src/runtime/steps/supervisor-response/prompt.d.ts +4 -0
  508. package/dist/src/runtime/steps/supervisor-response/prompt.js +19 -0
  509. package/dist/src/runtime/steps/supervisor-response/run.d.ts +8 -0
  510. package/dist/src/runtime/steps/supervisor-response/run.js +46 -17
  511. package/dist/src/runtime/steps/worker-decision/contracts.d.ts +10 -2
  512. package/dist/src/runtime/steps/worker-decision/contracts.js +3 -0
  513. package/dist/src/runtime/steps/worker-decision/format.d.ts +4 -0
  514. package/dist/src/runtime/steps/worker-decision/format.js +97 -22
  515. package/dist/src/runtime/steps/worker-decision/input/action-policy.d.ts +9 -0
  516. package/dist/src/runtime/steps/worker-decision/input/action-policy.js +15 -0
  517. package/dist/src/runtime/steps/worker-decision/input/canonical-state.d.ts +2 -2
  518. package/dist/src/runtime/steps/worker-decision/input/canonical-state.js +27 -8
  519. package/dist/src/runtime/steps/worker-decision/input/capability-selection.js +44 -3
  520. package/dist/src/runtime/steps/worker-decision/input/contract.d.ts +1 -0
  521. package/dist/src/runtime/steps/worker-decision/input/contract.js +12 -6
  522. package/dist/src/runtime/steps/worker-decision/input/diagnostic-projection.js +16 -7
  523. package/dist/src/runtime/steps/worker-decision/input/prompt-context.d.ts +1 -0
  524. package/dist/src/runtime/steps/worker-decision/input/prompt-context.js +13 -7
  525. package/dist/src/runtime/steps/worker-decision/input/reference-context.js +53 -15
  526. package/dist/src/runtime/steps/worker-decision/input/session.js +2 -1
  527. package/dist/src/runtime/steps/worker-decision/input/types.d.ts +8 -2
  528. package/dist/src/runtime/steps/worker-decision/input.d.ts +3 -2
  529. package/dist/src/runtime/steps/worker-decision/input.js +2 -2
  530. package/dist/src/runtime/steps/worker-decision/parser/accepted-decision.d.ts +3 -0
  531. package/dist/src/runtime/steps/worker-decision/parser/accepted-decision.js +70 -0
  532. package/dist/src/runtime/steps/worker-decision/parser/action-validation.d.ts +4 -0
  533. package/dist/src/runtime/steps/worker-decision/parser/action-validation.js +55 -0
  534. package/dist/src/runtime/steps/worker-decision/parser/capability-batch-validation.d.ts +3 -0
  535. package/dist/src/runtime/steps/worker-decision/parser/capability-batch-validation.js +135 -0
  536. package/dist/src/runtime/steps/worker-decision/parser/capability-controls-validation.d.ts +6 -0
  537. package/dist/src/runtime/steps/worker-decision/parser/capability-controls-validation.js +132 -0
  538. package/dist/src/runtime/steps/worker-decision/parser/capability-invocation-validation.d.ts +4 -0
  539. package/dist/src/runtime/steps/worker-decision/parser/capability-invocation-validation.js +104 -0
  540. package/dist/src/runtime/steps/worker-decision/parser/decision-shape-validation.d.ts +4 -0
  541. package/dist/src/runtime/steps/worker-decision/parser/decision-shape-validation.js +28 -0
  542. package/dist/src/runtime/steps/worker-decision/parser/pending-capability-selection-validation.d.ts +4 -0
  543. package/dist/src/runtime/steps/worker-decision/parser/pending-capability-selection-validation.js +105 -0
  544. package/dist/src/runtime/steps/worker-decision/parser/validation-contract.d.ts +50 -0
  545. package/dist/src/runtime/steps/worker-decision/parser/validation-contract.js +19 -0
  546. package/dist/src/runtime/steps/worker-decision/parser.d.ts +5 -1
  547. package/dist/src/runtime/steps/worker-decision/parser.js +32 -426
  548. package/dist/src/runtime/steps/worker-decision/payload-dependency-results.d.ts +8 -0
  549. package/dist/src/runtime/steps/worker-decision/payload-dependency-results.js +19 -0
  550. package/dist/src/runtime/steps/worker-decision/prompt.d.ts +3 -0
  551. package/dist/src/runtime/steps/worker-decision/prompt.js +63 -26
  552. package/dist/src/runtime/steps/worker-decision/result-author.js +28 -11
  553. package/dist/src/runtime/steps/worker-decision/run.js +99 -21
  554. package/dist/src/runtime/validation/strict-record.d.ts +2 -0
  555. package/dist/src/runtime/validation/strict-record.js +12 -0
  556. package/dist/src/shared/model-step-registry-data.json +9 -0
  557. package/dist/src/shared/model-step-registry.d.ts +9 -0
  558. package/dist/src/shared/model-step-registry.generated.d.ts +9 -0
  559. package/dist/src/shared/model-step-registry.generated.js +9 -0
  560. package/dist/src/web-ui/app/ARCHITECTURE.md +20 -7
  561. package/dist/src/web-ui/app/app.js +62 -18
  562. package/dist/src/web-ui/app/components/composer-context-window.d.ts +25 -0
  563. package/dist/src/web-ui/app/components/composer-context-window.js +155 -0
  564. package/dist/src/web-ui/app/components/composer-plan.d.ts +9 -0
  565. package/dist/src/web-ui/app/components/composer-plan.js +128 -0
  566. package/dist/src/web-ui/app/components/config-workspace/config-model.js +320 -0
  567. package/dist/src/web-ui/app/components/config-workspace/dashboard-rendering.js +155 -0
  568. package/dist/src/web-ui/app/components/config-workspace/field-rendering.js +278 -0
  569. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +251 -0
  570. package/dist/src/web-ui/app/components/config-workspace/step-rendering.js +145 -0
  571. package/dist/src/web-ui/app/components/config-workspace/workspace-events.js +271 -0
  572. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +195 -0
  573. package/dist/src/web-ui/app/components/config-workspace/workspace-persistence.js +247 -0
  574. package/dist/src/web-ui/app/components/config-workspace/workspace-view.js +299 -0
  575. package/dist/src/web-ui/app/components/config-workspace.js +179 -866
  576. package/dist/src/web-ui/app/components/conversation-activity.d.ts +12 -7
  577. package/dist/src/web-ui/app/components/conversation-activity.js +64 -157
  578. package/dist/src/web-ui/app/components/conversation-role-cards.d.ts +23 -0
  579. package/dist/src/web-ui/app/components/conversation-role-cards.js +181 -0
  580. package/dist/src/web-ui/app/components/conversation-sidebar-layout.js +12 -0
  581. package/dist/src/web-ui/app/components/conversation-sources.d.ts +7 -0
  582. package/dist/src/web-ui/app/components/conversation-sources.js +182 -0
  583. package/dist/src/web-ui/app/components/conversation-view.js +34 -6
  584. package/dist/src/web-ui/app/components/long-term-memory/icons.js +16 -0
  585. package/dist/src/web-ui/app/components/long-term-memory/manager.js +192 -0
  586. package/dist/src/web-ui/app/components/long-term-memory/record-editor.d.ts +9 -0
  587. package/dist/src/web-ui/app/components/long-term-memory/record-editor.js +62 -0
  588. package/dist/src/web-ui/app/components/long-term-memory/record-list.d.ts +5 -0
  589. package/dist/src/web-ui/app/components/long-term-memory/record-list.js +97 -0
  590. package/dist/src/web-ui/app/components/long-term-memory/view-model.d.ts +29 -0
  591. package/dist/src/web-ui/app/components/long-term-memory/view-model.js +69 -0
  592. package/dist/src/web-ui/app/components/long-term-memory-setup.js +334 -0
  593. package/dist/src/web-ui/app/components/model-selector.js +4 -1
  594. package/dist/src/web-ui/app/components/operations-section.js +46 -0
  595. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +39 -0
  596. package/dist/src/web-ui/app/components/tool-approval-card.d.ts +18 -0
  597. package/dist/src/web-ui/app/components/workspace-shell.js +134 -85
  598. package/dist/src/web-ui/app/controllers/app-event-bindings.js +43 -6
  599. package/dist/src/web-ui/app/controllers/composer-attachments-controller.d.ts +92 -0
  600. package/dist/src/web-ui/app/controllers/composer-queue-controller.d.ts +109 -0
  601. package/dist/src/web-ui/app/controllers/composer-submit-controller.d.ts +77 -0
  602. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +149 -0
  603. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +43 -3
  604. package/dist/src/web-ui/app/controllers/long-term-memory/controller.d.ts +87 -0
  605. package/dist/src/web-ui/app/controllers/long-term-memory/controller.js +302 -0
  606. package/dist/src/web-ui/app/controllers/long-term-memory/policy.d.ts +14 -0
  607. package/dist/src/web-ui/app/controllers/long-term-memory/policy.js +61 -0
  608. package/dist/src/web-ui/app/controllers/long-term-memory/state.js +85 -0
  609. package/dist/src/web-ui/app/controllers/operations-controller.d.ts +25 -0
  610. package/dist/src/web-ui/app/controllers/realtime-event-controller.d.ts +58 -0
  611. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +55 -90
  612. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.d.ts +32 -0
  613. package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts +177 -0
  614. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +80 -11
  615. package/dist/src/web-ui/app/controllers/session-controller.js +17 -12
  616. package/dist/src/web-ui/app/controllers/tool-approval-controller.d.ts +28 -0
  617. package/dist/src/web-ui/app/index.html +221 -224
  618. package/dist/src/web-ui/app/lib/composer-plan-model.d.ts +32 -0
  619. package/dist/src/web-ui/app/lib/composer-plan-model.js +108 -0
  620. package/dist/src/web-ui/app/lib/conversation-role-model.d.ts +19 -0
  621. package/dist/src/web-ui/app/lib/conversation-role-model.js +193 -0
  622. package/dist/src/web-ui/app/lib/event-presentation.js +30 -9
  623. package/dist/src/web-ui/app/lib/source-url-policy.d.ts +2 -0
  624. package/dist/src/web-ui/app/lib/source-url-policy.js +31 -0
  625. package/dist/src/web-ui/app/lib/task-progress.d.ts +53 -0
  626. package/dist/src/web-ui/app/lib/task-progress.js +233 -0
  627. package/dist/src/web-ui/app/lib/tool-invocation-count.d.ts +5 -0
  628. package/dist/src/web-ui/app/lib/tool-invocation-count.js +21 -0
  629. package/dist/src/web-ui/app/lib/web-source-event.d.ts +8 -0
  630. package/dist/src/web-ui/app/lib/web-source-event.js +21 -0
  631. package/dist/src/web-ui/app/lib/web-sources.d.ts +36 -0
  632. package/dist/src/web-ui/app/lib/web-sources.js +177 -0
  633. package/dist/src/web-ui/app/services/runtime-web-client/memory.js +127 -0
  634. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +84 -0
  635. package/dist/src/web-ui/app/services/runtime-web-client.js +27 -1
  636. package/dist/src/web-ui/app/styles/00-tokens-base.css +15 -3
  637. package/dist/src/web-ui/app/styles/10-shell-sessions.css +24 -34
  638. package/dist/src/web-ui/app/styles/12-conversation-sidebar.css +93 -0
  639. package/dist/src/web-ui/app/styles/20-chat-composer.css +55 -472
  640. package/dist/src/web-ui/app/styles/21-composer-controls.css +368 -0
  641. package/dist/src/web-ui/app/styles/22-composer-context-window.css +90 -0
  642. package/dist/src/web-ui/app/styles/23-composer-plan.css +171 -0
  643. package/dist/src/web-ui/app/styles/24-conversation-role-cards.css +205 -0
  644. package/dist/src/web-ui/app/styles/25-conversation-sources.css +141 -0
  645. package/dist/src/web-ui/app/styles/30-inspector-config.css +142 -1602
  646. package/dist/src/web-ui/app/styles/35-memory-onboarding.css +153 -0
  647. package/dist/src/web-ui/app/styles/36-memory-management.css +419 -0
  648. package/dist/src/web-ui/app/styles/37-config-operations.css +197 -0
  649. package/dist/src/web-ui/app/styles/40-config-workspace.css +992 -0
  650. package/dist/src/web-ui/app/styles/90-responsive.css +199 -101
  651. package/dist/src/web-ui/app/styles/foundation.css +2 -2
  652. package/dist/src/web-ui/app/styles.css +10 -0
  653. package/dist/src/web-ui/app/ui-behavior.d.ts +1 -1
  654. package/dist/src/web-ui/app/ui-behavior.js +1 -1
  655. package/dist/src/web-ui/config-dashboard-backend.js +9 -1
  656. package/dist/src/web-ui/local-runtime/api-router.d.ts +4 -2
  657. package/dist/src/web-ui/local-runtime/api-router.js +33 -0
  658. package/dist/src/web-ui/local-runtime/contracts.d.ts +5 -0
  659. package/dist/src/web-ui/local-runtime/memory-management-input.d.ts +12 -0
  660. package/dist/src/web-ui/local-runtime/memory-management-input.js +68 -0
  661. package/dist/src/web-ui/local-runtime/memory-management-response.d.ts +17 -0
  662. package/dist/src/web-ui/local-runtime/memory-management-response.js +47 -0
  663. package/dist/src/web-ui/local-runtime/memory-management-routes.d.ts +24 -0
  664. package/dist/src/web-ui/local-runtime/memory-management-routes.js +128 -0
  665. package/dist/src/web-ui/local-runtime/memory-onboarding-routes.d.ts +17 -0
  666. package/dist/src/web-ui/local-runtime/memory-onboarding-routes.js +81 -0
  667. package/dist/src/web-ui/local-runtime/request-abort.d.ts +7 -0
  668. package/dist/src/web-ui/local-runtime/request-abort.js +19 -0
  669. package/dist/src/web-ui/local-runtime-backend.js +10 -3
  670. package/dist/src/web-ui/server.d.ts +2 -0
  671. package/dist/src/web-ui/server.js +3 -0
  672. package/docs/configuration.md +144 -54
  673. package/docs/installation.md +28 -4
  674. package/docs/known-limitations.md +32 -0
  675. package/docs/long-term-memory.md +181 -0
  676. package/docs/plugins.md +28 -13
  677. package/docs/publishing.md +52 -25
  678. package/docs/runtime-invariant-coverage.md +18 -17
  679. package/docs/runtime-library.md +16 -1
  680. package/docs/runtime-prompt-policy-contracts.md +39 -19
  681. package/docs/troubleshooting.md +21 -0
  682. package/examples/models/default.config.json +1 -0
  683. package/examples/request-runner.config.example.json +16 -22
  684. package/examples/runtime.config.example.json +4 -0
  685. package/methodologies/memory-informed-response.md +15 -0
  686. package/methodologies/response-ux.md +17 -0
  687. package/package.json +11 -4
  688. package/plugins/capability-brief/source/index.ts +5 -48
  689. package/plugins/capability-brief/src/index.cjs +46 -33
  690. package/plugins/exec/source/handlers.ts +65 -5
  691. package/plugins/exec/src/index.cjs +39 -3
  692. package/plugins/filesystem/plugin.json +1 -0
  693. package/plugins/system-probe/plugin.json +1 -0
  694. package/plugins/web/README.md +125 -0
  695. package/plugins/web/plugin.json +1 -1
  696. package/plugins/web/skills/web_fetch_skill/SKILL.md +2 -2
  697. package/plugins/web/skills/web_search_skill/SKILL.md +8 -4
  698. package/plugins/web/source/errors.ts +5 -1
  699. package/plugins/web/source/fetch-presentation.ts +61 -0
  700. package/plugins/web/source/fetch-service.ts +2 -31
  701. package/plugins/web/source/light/config.ts +196 -0
  702. package/plugins/web/source/light/crawl/origin-gate.ts +134 -0
  703. package/plugins/web/source/light/crawl/robots-cache.ts +71 -0
  704. package/plugins/web/source/light/crawl/robots-parser.ts +132 -0
  705. package/plugins/web/source/light/crawl/robots-policy.ts +154 -0
  706. package/plugins/web/source/light/crawl/session-budget.ts +141 -0
  707. package/plugins/web/source/light/crawl/transport.ts +216 -0
  708. package/plugins/web/source/light/discovery/candidate-values.ts +63 -0
  709. package/plugins/web/source/light/discovery/feed-document.ts +127 -0
  710. package/plugins/web/source/light/discovery/html-links.ts +80 -0
  711. package/plugins/web/source/light/discovery/html-robots-directives.ts +29 -0
  712. package/plugins/web/source/light/discovery/markup-tree.ts +145 -0
  713. package/plugins/web/source/light/discovery/origin-dates.ts +71 -0
  714. package/plugins/web/source/light/discovery/sitemap-document.ts +63 -0
  715. package/plugins/web/source/light/documents/cache-policy.ts +28 -0
  716. package/plugins/web/source/light/documents/document-cache.ts +99 -0
  717. package/plugins/web/source/light/documents/document-charset.ts +89 -0
  718. package/plugins/web/source/light/documents/document-contract.ts +20 -0
  719. package/plugins/web/source/light/documents/document-reader.ts +75 -0
  720. package/plugins/web/source/light/documents/extract-document.ts +124 -0
  721. package/plugins/web/source/light/documents/http-cache-freshness.ts +68 -0
  722. package/plugins/web/source/light/documents/response-decoding.ts +120 -0
  723. package/plugins/web/source/light/ranking/document-ranking.ts +114 -0
  724. package/plugins/web/source/light/ranking/query-normalization.ts +69 -0
  725. package/plugins/web/source/light/search-collection.ts +136 -0
  726. package/plugins/web/source/light/search-frontier.ts +246 -0
  727. package/plugins/web/source/light/search-metadata.ts +84 -0
  728. package/plugins/web/source/light/search-service.ts +154 -0
  729. package/plugins/web/source/light/search-unavailable.ts +33 -0
  730. package/plugins/web/source/light/sources/catalog.ts +312 -0
  731. package/plugins/web/source/light/sources/source-definition.ts +9 -0
  732. package/plugins/web/source/light/sources/source-selection.ts +35 -0
  733. package/plugins/web/source/plugin.ts +70 -56
  734. package/plugins/web/source/public-http.ts +10 -1
  735. package/plugins/web/source/search-presentation.ts +63 -63
  736. package/plugins/web/source/search-service-selector.ts +31 -0
  737. package/plugins/web/source/search-service.ts +6 -0
  738. package/plugins/web/source/search-source-presentation.ts +76 -0
  739. package/plugins/web/source/search-types.ts +4 -0
  740. package/plugins/web/source/source-output-receipts.ts +267 -0
  741. package/plugins/web/source/source-receipt-budget.ts +51 -0
  742. package/plugins/web/source/source-receipt-contract.ts +18 -0
  743. package/plugins/web/src/index.cjs +3214 -288
  744. package/runtime.config.schema.json +30 -0
  745. package/src/runtime/README.md +107 -47
  746. package/dist/src/model-gateway/structured-output/budget.d.ts +0 -7
  747. package/dist/src/model-gateway/structured-output/budget.js +0 -20
  748. package/dist/src/model-gateway/structured-output/schema-character-estimator.d.ts +0 -1
  749. package/dist/src/model-gateway/structured-output/schema-character-estimator.js +0 -211
  750. package/dist/src/model-gateway/structured-output-budget.d.ts +0 -1
  751. package/dist/src/model-gateway/structured-output-budget.js +0 -1
@@ -0,0 +1,87 @@
1
+ import { isRequestExecutionPolicyId, REQUEST_EXECUTION_POLICY_IDS, } from "../model-execution-policy.js";
2
+ import { hasOwnValue, isRecord } from "../utils.js";
3
+ import { validateModelContextConfig, validateModelGenerationConfig, } from "./model-invocation-config-validation.js";
4
+ import { validateOptionalModelCalibrations } from "./model-invocation-override-validation.js";
5
+ import { validateOptionalBoolean, validateOptionalModelModalityArray, validateOptionalObject, validateOptionalPositiveInteger, validateOptionalSetupString, validateOptionalString, } from "./runtime-config-field-validation.js";
6
+ function hasUnsafeContextWindowTokenCount(profile) {
7
+ if (!hasOwnValue(profile, "contextWindowTokens")) {
8
+ return false;
9
+ }
10
+ if (typeof profile.contextWindowTokens !== "number") {
11
+ return false;
12
+ }
13
+ return !Number.isSafeInteger(profile.contextWindowTokens);
14
+ }
15
+ function validateRequiredModelReference(issues, profile, displayKey, allowConfigRef) {
16
+ const modelIsMissing = !hasOwnValue(profile, "model");
17
+ const configRefIsMissing = !hasOwnValue(profile, "configRef");
18
+ const modelOrConfigRefIsRequired = allowConfigRef && modelIsMissing && configRefIsMissing;
19
+ if (modelOrConfigRefIsRequired) {
20
+ issues.push(`${displayKey}.model or configRef must be provided`);
21
+ }
22
+ const directModelIsRequired = !allowConfigRef && modelIsMissing;
23
+ if (directModelIsRequired) {
24
+ issues.push(`${displayKey}.model must be provided`);
25
+ }
26
+ }
27
+ function validateRequiredContextWindowTokens(issues, profile, displayKey, allowConfigRef) {
28
+ const configRefProvidesProfileDefinition = allowConfigRef && hasOwnValue(profile, "configRef");
29
+ const contextWindowTokensAreMissing = !hasOwnValue(profile, "contextWindowTokens");
30
+ if (!configRefProvidesProfileDefinition && contextWindowTokensAreMissing) {
31
+ issues.push(`${displayKey}.contextWindowTokens must be provided`);
32
+ }
33
+ }
34
+ function validateRequiredModelProfileFields(issues, profile, displayKey, allowConfigRef, allowIncompleteSetup) {
35
+ if (allowIncompleteSetup) {
36
+ return;
37
+ }
38
+ validateRequiredModelReference(issues, profile, displayKey, allowConfigRef);
39
+ validateRequiredContextWindowTokens(issues, profile, displayKey, allowConfigRef);
40
+ }
41
+ function validateModelProfileCapabilities(issues, capabilities, displayKey) {
42
+ validateOptionalModelModalityArray(issues, capabilities, "inputModalities", `${displayKey}.inputModalities`);
43
+ validateOptionalModelModalityArray(issues, capabilities, "outputModalities", `${displayKey}.outputModalities`);
44
+ }
45
+ function validateModelExecutionPolicy(issues, execution, displayKey) {
46
+ const hasUnsupportedExecutionField = Object.keys(execution).some((key) => key !== "policy");
47
+ if (hasUnsupportedExecutionField) {
48
+ issues.push(`${displayKey} may contain only: policy`);
49
+ }
50
+ const hasUnsupportedExecutionPolicy = hasOwnValue(execution, "policy") &&
51
+ !isRequestExecutionPolicyId(execution.policy);
52
+ if (hasUnsupportedExecutionPolicy) {
53
+ issues.push(`${displayKey}.policy must be one of: ${REQUEST_EXECUTION_POLICY_IDS.join(", ")}`);
54
+ }
55
+ }
56
+ export function validateModelProfileConfig(issues, profile, displayKey, options = { allowConfigRef: true }) {
57
+ validateOptionalSetupString(issues, profile, "configRef", `${displayKey}.configRef`, options.allowIncompleteSetup === true);
58
+ validateOptionalString(issues, profile, "label", `${displayKey}.label`);
59
+ validateOptionalSetupString(issues, profile, "provider", `${displayKey}.provider`, options.allowIncompleteSetup === true);
60
+ validateOptionalSetupString(issues, profile, "model", `${displayKey}.model`, options.allowIncompleteSetup === true);
61
+ validateOptionalPositiveInteger(issues, profile, "contextWindowTokens", `${displayKey}.contextWindowTokens`);
62
+ if (hasUnsafeContextWindowTokenCount(profile)) {
63
+ issues.push(`${displayKey}.contextWindowTokens must be a safe integer`);
64
+ }
65
+ validateRequiredModelProfileFields(issues, profile, displayKey, options.allowConfigRef, options.allowIncompleteSetup);
66
+ validateOptionalBoolean(issues, profile, "supportsThinking", `${displayKey}.supportsThinking`);
67
+ if (hasOwnValue(profile, "options") && !isRecord(profile.options)) {
68
+ issues.push(`${displayKey}.options must be an object`);
69
+ }
70
+ const capabilities = validateOptionalObject(issues, profile, "capabilities", `${displayKey}.capabilities`);
71
+ if (capabilities) {
72
+ validateModelProfileCapabilities(issues, capabilities, `${displayKey}.capabilities`);
73
+ }
74
+ const generation = validateOptionalObject(issues, profile, "generation", `${displayKey}.generation`);
75
+ if (generation) {
76
+ validateModelGenerationConfig(issues, generation, `${displayKey}.generation`);
77
+ }
78
+ const context = validateOptionalObject(issues, profile, "context", `${displayKey}.context`);
79
+ if (context) {
80
+ validateModelContextConfig(issues, context, `${displayKey}.context`);
81
+ }
82
+ const execution = validateOptionalObject(issues, profile, "execution", `${displayKey}.execution`);
83
+ if (execution) {
84
+ validateModelExecutionPolicy(issues, execution, `${displayKey}.execution`);
85
+ }
86
+ validateOptionalModelCalibrations(issues, profile, "calibration", `${displayKey}.calibration`);
87
+ }
@@ -0,0 +1,2 @@
1
+ import type { RuntimeConfigValidationOptions } from "./runtime-config-validation-contract.js";
2
+ export declare function validateModelConfig(issues: string[], models: Record<string, unknown>, options?: RuntimeConfigValidationOptions): void;
@@ -0,0 +1,118 @@
1
+ import { validateEmbeddingProfiles } from "../embedding-profiles.js";
2
+ import { hasOwnValue, isRecord } from "../utils.js";
3
+ import { validateModelContextConfig } from "./model-invocation-config-validation.js";
4
+ import { validateOptionalInvocationProfiles } from "./model-invocation-override-validation.js";
5
+ import { validateModelProfileConfig } from "./model-profile-validation.js";
6
+ import { validateOptionalBoolean, validateOptionalEnvVarName, validateOptionalObject, validateOptionalString, validateOptionalStringMap, } from "./runtime-config-field-validation.js";
7
+ const PROVIDER_ADAPTER_IDENTIFIER_PATTERN = /^[A-Za-z][A-Za-z0-9._-]*$/u;
8
+ function isAllowedIncompleteProviderType(provider, options) {
9
+ if (options.allowIncompleteSetup !== true) {
10
+ return false;
11
+ }
12
+ if (!hasOwnValue(provider, "type")) {
13
+ return true;
14
+ }
15
+ if (typeof provider.type !== "string") {
16
+ return false;
17
+ }
18
+ return provider.type.trim().length === 0;
19
+ }
20
+ function hasInvalidProviderAdapterIdentifier(provider, options) {
21
+ if (isAllowedIncompleteProviderType(provider, options)) {
22
+ return false;
23
+ }
24
+ if (!hasOwnValue(provider, "type")) {
25
+ return true;
26
+ }
27
+ if (typeof provider.type !== "string") {
28
+ return true;
29
+ }
30
+ return !PROVIDER_ADAPTER_IDENTIFIER_PATTERN.test(provider.type.trim());
31
+ }
32
+ function validateProviderEntry(issues, providerId, provider, options) {
33
+ const providerKey = `models.providers.${providerId}`;
34
+ if (providerId.trim().length === 0) {
35
+ issues.push("models.providers keys must be non-empty strings");
36
+ }
37
+ if (!isRecord(provider)) {
38
+ issues.push(`${providerKey} must be an object`);
39
+ return;
40
+ }
41
+ if (hasInvalidProviderAdapterIdentifier(provider, options)) {
42
+ issues.push(`${providerKey}.type must be a provider adapter identifier`);
43
+ }
44
+ validateOptionalString(issues, provider, "baseUrl", `${providerKey}.baseUrl`);
45
+ validateOptionalEnvVarName(issues, provider, "apiKeyEnv", `${providerKey}.apiKeyEnv`);
46
+ validateOptionalString(issues, provider, "keepAlive", `${providerKey}.keepAlive`);
47
+ validateOptionalObject(issues, provider, "settings", `${providerKey}.settings`);
48
+ }
49
+ function validateModelProviders(issues, models, options) {
50
+ const providers = validateOptionalObject(issues, models, "providers");
51
+ const requiredProvidersAreMissing = !hasOwnValue(models, "providers") && !options.allowIncompleteSetup;
52
+ if (requiredProvidersAreMissing) {
53
+ issues.push("models.providers must declare at least one provider");
54
+ }
55
+ if (!providers) {
56
+ return;
57
+ }
58
+ if (Object.keys(providers).length === 0 && !options.allowIncompleteSetup) {
59
+ issues.push("models.providers must declare at least one provider");
60
+ }
61
+ for (const [providerId, provider] of Object.entries(providers)) {
62
+ validateProviderEntry(issues, providerId, provider, options);
63
+ }
64
+ }
65
+ function validateModelProfileEntry(issues, profileId, profile, options) {
66
+ if (profileId.trim().length === 0) {
67
+ issues.push("models.profiles keys must be non-empty strings");
68
+ }
69
+ if (!isRecord(profile)) {
70
+ issues.push(`models.profiles.${profileId} must be an object`);
71
+ return;
72
+ }
73
+ validateModelProfileConfig(issues, profile, `models.profiles.${profileId}`, {
74
+ allowConfigRef: true,
75
+ allowIncompleteSetup: options.allowIncompleteSetup,
76
+ });
77
+ }
78
+ function validateModelProfiles(issues, models, options) {
79
+ const profiles = validateOptionalObject(issues, models, "profiles");
80
+ const requiredProfilesAreMissing = !hasOwnValue(models, "profiles") && !options.allowIncompleteSetup;
81
+ if (requiredProfilesAreMissing) {
82
+ issues.push("models.profiles must declare at least one model profile");
83
+ }
84
+ if (!profiles) {
85
+ return;
86
+ }
87
+ if (Object.keys(profiles).length === 0 && !options.allowIncompleteSetup) {
88
+ issues.push("models.profiles must declare at least one model profile");
89
+ }
90
+ for (const [profileId, profile] of Object.entries(profiles)) {
91
+ validateModelProfileEntry(issues, profileId, profile, options);
92
+ }
93
+ }
94
+ function validateModelDefaults(issues, models) {
95
+ const defaults = validateOptionalObject(issues, models, "defaults");
96
+ if (!defaults) {
97
+ return;
98
+ }
99
+ validateOptionalBoolean(issues, defaults, "overrideClientPreference", "models.defaults.overrideClientPreference");
100
+ validateOptionalString(issues, defaults, "profileId", "models.defaults.profileId");
101
+ validateOptionalStringMap(issues, defaults, "roles", "models.defaults.roles");
102
+ validateOptionalStringMap(issues, defaults, "steps", "models.defaults.steps");
103
+ const defaultContext = validateOptionalObject(issues, defaults, "context", "models.defaults.context");
104
+ if (defaultContext) {
105
+ validateModelContextConfig(issues, defaultContext, "models.defaults.context");
106
+ }
107
+ }
108
+ export function validateModelConfig(issues, models, options = {}) {
109
+ validateModelProviders(issues, models, options);
110
+ validateModelProfiles(issues, models, options);
111
+ validateOptionalInvocationProfiles(issues, models, "invocationProfiles", "models.invocationProfiles");
112
+ validateEmbeddingProfiles({
113
+ issues,
114
+ models,
115
+ allowIncompleteSetup: options.allowIncompleteSetup === true,
116
+ });
117
+ validateModelDefaults(issues, models);
118
+ }
@@ -0,0 +1 @@
1
+ export declare function validatePathConfigRecord(issues: string[], paths: Record<string, unknown>, displayKey: string): void;
@@ -0,0 +1,7 @@
1
+ import { PATH_CONFIG_FIELDS } from "../fields.js";
2
+ import { validateOptionalString } from "./runtime-config-field-validation.js";
3
+ export function validatePathConfigRecord(issues, paths, displayKey) {
4
+ for (const field of PATH_CONFIG_FIELDS) {
5
+ validateOptionalString(issues, paths, field.key, `${displayKey}.${field.key}`);
6
+ }
7
+ }
@@ -0,0 +1,12 @@
1
+ export declare function validateOptionalString(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
2
+ export declare function validateOptionalSetupString(issues: string[], record: Record<string, unknown>, key: string, displayKey: string, allowIncompleteSetup: boolean): void;
3
+ export declare function validateOptionalEnvVarName(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
4
+ export declare function validateOptionalObject(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): Record<string, unknown> | undefined;
5
+ export declare function validateOptionalBoolean(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
6
+ export declare function validateOptionalStringArray(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
7
+ export declare function validateOptionalModelModalityArray(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
8
+ export declare function validateOptionalStringMap(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
9
+ export declare function validateOptionalNumber(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
10
+ export declare function validateOptionalPositiveNumber(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
11
+ export declare function validateOptionalPositiveInteger(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
12
+ export declare function validateOptionalNonNegativeInteger(issues: string[], record: Record<string, unknown>, key: string, displayKey?: string): void;
@@ -0,0 +1,158 @@
1
+ import { hasOwnValue, isRecord } from "../utils.js";
2
+ const ENV_VAR_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
3
+ function isNonEmptyConfigString(value) {
4
+ return typeof value === "string" && value.trim().length > 0;
5
+ }
6
+ function isAllowedIncompleteSetupString(record, key, allowIncompleteSetup) {
7
+ if (!allowIncompleteSetup) {
8
+ return false;
9
+ }
10
+ if (!hasOwnValue(record, key)) {
11
+ return false;
12
+ }
13
+ const value = record[key];
14
+ return typeof value === "string" && value.trim().length === 0;
15
+ }
16
+ function isFiniteNumber(value) {
17
+ return typeof value === "number" && Number.isFinite(value);
18
+ }
19
+ function isPositiveNumber(value) {
20
+ if (!isFiniteNumber(value)) {
21
+ return false;
22
+ }
23
+ return value > 0;
24
+ }
25
+ function isPositiveInteger(value) {
26
+ if (!isPositiveNumber(value)) {
27
+ return false;
28
+ }
29
+ return Number.isInteger(value);
30
+ }
31
+ function isNonNegativeInteger(value) {
32
+ if (!isFiniteNumber(value) || value < 0) {
33
+ return false;
34
+ }
35
+ return Number.isInteger(value);
36
+ }
37
+ export function validateOptionalString(issues, record, key, displayKey = key) {
38
+ if (!hasOwnValue(record, key)) {
39
+ return;
40
+ }
41
+ if (!isNonEmptyConfigString(record[key])) {
42
+ issues.push(`${displayKey} must be a non-empty string`);
43
+ }
44
+ }
45
+ export function validateOptionalSetupString(issues, record, key, displayKey, allowIncompleteSetup) {
46
+ if (isAllowedIncompleteSetupString(record, key, allowIncompleteSetup)) {
47
+ return;
48
+ }
49
+ validateOptionalString(issues, record, key, displayKey);
50
+ }
51
+ export function validateOptionalEnvVarName(issues, record, key, displayKey = key) {
52
+ if (!hasOwnValue(record, key)) {
53
+ return;
54
+ }
55
+ const value = record[key];
56
+ if (!isNonEmptyConfigString(value)) {
57
+ issues.push(`${displayKey} must be a non-empty string`);
58
+ return;
59
+ }
60
+ if (!ENV_VAR_NAME_PATTERN.test(value.trim())) {
61
+ issues.push(`${displayKey} must be an environment variable name`);
62
+ }
63
+ }
64
+ export function validateOptionalObject(issues, record, key, displayKey = key) {
65
+ if (!hasOwnValue(record, key)) {
66
+ return undefined;
67
+ }
68
+ const value = record[key];
69
+ if (!isRecord(value)) {
70
+ issues.push(`${displayKey} must be an object`);
71
+ return undefined;
72
+ }
73
+ return value;
74
+ }
75
+ export function validateOptionalBoolean(issues, record, key, displayKey = key) {
76
+ if (!hasOwnValue(record, key)) {
77
+ return;
78
+ }
79
+ if (typeof record[key] !== "boolean") {
80
+ issues.push(`${displayKey} must be a boolean`);
81
+ }
82
+ }
83
+ export function validateOptionalStringArray(issues, record, key, displayKey = key) {
84
+ if (!hasOwnValue(record, key)) {
85
+ return;
86
+ }
87
+ const value = record[key];
88
+ if (!Array.isArray(value)) {
89
+ issues.push(`${displayKey} must be an array of strings`);
90
+ return;
91
+ }
92
+ if (value.some((entry) => typeof entry !== "string")) {
93
+ issues.push(`${displayKey} must contain only strings`);
94
+ }
95
+ }
96
+ export function validateOptionalModelModalityArray(issues, record, key, displayKey = key) {
97
+ if (!hasOwnValue(record, key)) {
98
+ return;
99
+ }
100
+ const value = record[key];
101
+ if (!Array.isArray(value)) {
102
+ issues.push(`${displayKey} must be an array of model modalities`);
103
+ return;
104
+ }
105
+ for (const entry of value) {
106
+ if (entry !== "text" && entry !== "image" && entry !== "audio") {
107
+ issues.push(`${displayKey} must contain only text, image, or audio`);
108
+ return;
109
+ }
110
+ }
111
+ }
112
+ export function validateOptionalStringMap(issues, record, key, displayKey = key) {
113
+ if (!hasOwnValue(record, key)) {
114
+ return;
115
+ }
116
+ const value = record[key];
117
+ if (!isRecord(value)) {
118
+ issues.push(`${displayKey} must be an object`);
119
+ return;
120
+ }
121
+ for (const [entryKey, entryValue] of Object.entries(value)) {
122
+ if (typeof entryValue !== "string" || entryValue.trim().length === 0) {
123
+ issues.push(`${displayKey}.${entryKey} must be a non-empty string`);
124
+ }
125
+ }
126
+ }
127
+ export function validateOptionalNumber(issues, record, key, displayKey = key) {
128
+ if (!hasOwnValue(record, key)) {
129
+ return;
130
+ }
131
+ if (!isFiniteNumber(record[key])) {
132
+ issues.push(`${displayKey} must be a number`);
133
+ }
134
+ }
135
+ export function validateOptionalPositiveNumber(issues, record, key, displayKey = key) {
136
+ if (!hasOwnValue(record, key)) {
137
+ return;
138
+ }
139
+ if (!isPositiveNumber(record[key])) {
140
+ issues.push(`${displayKey} must be a positive number`);
141
+ }
142
+ }
143
+ export function validateOptionalPositiveInteger(issues, record, key, displayKey = key) {
144
+ if (!hasOwnValue(record, key)) {
145
+ return;
146
+ }
147
+ if (!isPositiveInteger(record[key])) {
148
+ issues.push(`${displayKey} must be a positive integer`);
149
+ }
150
+ }
151
+ export function validateOptionalNonNegativeInteger(issues, record, key, displayKey = key) {
152
+ if (!hasOwnValue(record, key)) {
153
+ return;
154
+ }
155
+ if (!isNonNegativeInteger(record[key])) {
156
+ issues.push(`${displayKey} must be a non-negative integer`);
157
+ }
158
+ }
@@ -0,0 +1,9 @@
1
+ export type RuntimeConfigValidationOptions = Readonly<{
2
+ /** Inspection-only mode. Canonical runtime loading always omits this flag. */
3
+ allowIncompleteSetup?: boolean;
4
+ }>;
5
+ export declare class RuntimeConfigValidationError extends Error {
6
+ readonly configPath: string;
7
+ readonly issues: string[];
8
+ constructor(configPath: string, issues: string[]);
9
+ }
@@ -0,0 +1,13 @@
1
+ export class RuntimeConfigValidationError extends Error {
2
+ configPath;
3
+ issues;
4
+ constructor(configPath, issues) {
5
+ super([
6
+ `Invalid runtime config at ${configPath}:`,
7
+ ...issues.map((issue) => `- ${issue}`),
8
+ ].join("\n"));
9
+ this.name = "RuntimeConfigValidationError";
10
+ this.configPath = configPath;
11
+ this.issues = issues;
12
+ }
13
+ }
@@ -0,0 +1,6 @@
1
+ import type { RuntimeConfigValidationOptions } from "./runtime-config-validation-contract.js";
2
+ export declare function validateLoggingConfig(issues: string[], logging: Record<string, unknown>): void;
3
+ export declare function validatePluginConfig(issues: string[], plugins: Record<string, unknown>): void;
4
+ export declare function validateRuntimeTimeouts(issues: string[], timeouts: Record<string, unknown>): void;
5
+ export declare function validateRootRequestRunnerConfig(issues: string[], requestRunner: Record<string, unknown>, options: RuntimeConfigValidationOptions): void;
6
+ export declare function validateFeatureFlagSections(issues: string[], record: Record<string, unknown>): void;
@@ -0,0 +1,82 @@
1
+ import { TIMEOUT_CONFIG_FIELDS } from "../fields.js";
2
+ import { hasOwnValue } from "../utils.js";
3
+ import { validateOptionalBoolean, validateOptionalObject, validateOptionalPositiveNumber, validateOptionalSetupString, validateOptionalStringArray, } from "./runtime-config-field-validation.js";
4
+ export function validateLoggingConfig(issues, logging) {
5
+ validateOptionalBoolean(issues, logging, "enabled", "logging.enabled");
6
+ const rotation = validateOptionalObject(issues, logging, "rotation", "logging.rotation");
7
+ if (!rotation) {
8
+ return;
9
+ }
10
+ for (const key of ["maxFileSizeMb", "maxFiles", "maxAgeDays"]) {
11
+ validateOptionalPositiveNumber(issues, rotation, key, `logging.rotation.${key}`);
12
+ }
13
+ }
14
+ export function validatePluginConfig(issues, plugins) {
15
+ validateOptionalBoolean(issues, plugins, "enabled", "plugins.enabled");
16
+ validateOptionalStringArray(issues, plugins, "allow", "plugins.allow");
17
+ validateOptionalStringArray(issues, plugins, "deny", "plugins.deny");
18
+ for (const key of Object.keys(plugins)) {
19
+ const isUnsupportedPluginField = key !== "enabled" && key !== "allow" && key !== "deny";
20
+ if (isUnsupportedPluginField) {
21
+ issues.push(`plugins.${key} is not a supported configuration field`);
22
+ }
23
+ }
24
+ }
25
+ function hasInvalidRuntimeTimeout(value) {
26
+ if (typeof value !== "number") {
27
+ return true;
28
+ }
29
+ if (!Number.isFinite(value)) {
30
+ return true;
31
+ }
32
+ return value <= 0;
33
+ }
34
+ export function validateRuntimeTimeouts(issues, timeouts) {
35
+ for (const field of TIMEOUT_CONFIG_FIELDS) {
36
+ if (!hasOwnValue(timeouts, field.key)) {
37
+ continue;
38
+ }
39
+ if (hasInvalidRuntimeTimeout(timeouts[field.key])) {
40
+ issues.push(`timeouts.${field.key} must be a positive number`);
41
+ }
42
+ }
43
+ }
44
+ export function validateRootRequestRunnerConfig(issues, requestRunner, options) {
45
+ const keys = Object.keys(requestRunner);
46
+ const hasUnsupportedRequestRunnerFields = keys.some((key) => key !== "configRef");
47
+ const requiresExactlyOneRequestRunnerField = !options.allowIncompleteSetup && keys.length !== 1;
48
+ if (hasUnsupportedRequestRunnerFields ||
49
+ requiresExactlyOneRequestRunnerField) {
50
+ issues.push("requestRunner must contain exactly: configRef");
51
+ }
52
+ const configRefIsMissing = !hasOwnValue(requestRunner, "configRef");
53
+ if (configRefIsMissing && !options.allowIncompleteSetup) {
54
+ issues.push("requestRunner.configRef is required");
55
+ }
56
+ if (configRefIsMissing) {
57
+ return;
58
+ }
59
+ validateOptionalSetupString(issues, requestRunner, "configRef", "requestRunner.configRef", options.allowIncompleteSetup === true);
60
+ }
61
+ function hasUnsupportedFeatureFlagValue(value) {
62
+ if (typeof value === "boolean") {
63
+ return false;
64
+ }
65
+ if (typeof value === "number") {
66
+ return false;
67
+ }
68
+ return typeof value !== "string";
69
+ }
70
+ export function validateFeatureFlagSections(issues, record) {
71
+ for (const key of ["features", "featureFlags"]) {
72
+ const flags = validateOptionalObject(issues, record, key);
73
+ if (!flags) {
74
+ continue;
75
+ }
76
+ for (const [flagName, value] of Object.entries(flags)) {
77
+ if (hasUnsupportedFeatureFlagValue(value)) {
78
+ issues.push(`${key}.${flagName} must be a boolean, number, or string`);
79
+ }
80
+ }
81
+ }
82
+ }
@@ -0,0 +1,3 @@
1
+ import type { RuntimeConfigFile } from "../types.js";
2
+ export declare function validateWebUiConfigSection(issues: string[], config: Record<string, unknown>): void;
3
+ export declare function validateRuntimeWebUiConfig(config: RuntimeConfigFile, configPath: string): void;
@@ -0,0 +1,26 @@
1
+ import { validateOptionalBoolean, validateOptionalObject, } from "./runtime-config-field-validation.js";
2
+ import { RuntimeConfigValidationError } from "./runtime-config-validation-contract.js";
3
+ function isUnsupportedWebUiField(key) {
4
+ return key !== "openOnRuntimeServiceStart";
5
+ }
6
+ function validateWebUiConfig(issues, webUi) {
7
+ validateOptionalBoolean(issues, webUi, "openOnRuntimeServiceStart", "webUi.openOnRuntimeServiceStart");
8
+ for (const key of Object.keys(webUi)) {
9
+ if (isUnsupportedWebUiField(key)) {
10
+ issues.push(`webUi.${key} is not a supported configuration field`);
11
+ }
12
+ }
13
+ }
14
+ export function validateWebUiConfigSection(issues, config) {
15
+ const webUi = validateOptionalObject(issues, config, "webUi");
16
+ if (webUi) {
17
+ validateWebUiConfig(issues, webUi);
18
+ }
19
+ }
20
+ export function validateRuntimeWebUiConfig(config, configPath) {
21
+ const issues = [];
22
+ validateWebUiConfigSection(issues, config);
23
+ if (issues.length > 0) {
24
+ throw new RuntimeConfigValidationError(configPath, issues);
25
+ }
26
+ }
@@ -1,17 +1,6 @@
1
1
  import type { RuntimeConfigFile } from "./types.js";
2
- type RuntimeConfigValidationOptions = Readonly<{
3
- /** Inspection-only mode. Canonical runtime loading always omits this flag. */
4
- allowIncompleteSetup?: boolean;
5
- }>;
6
- export declare class RuntimeConfigValidationError extends Error {
7
- readonly configPath: string;
8
- readonly issues: string[];
9
- constructor(configPath: string, issues: string[]);
10
- }
11
- export declare function validateModelProfileConfig(issues: string[], profile: Record<string, unknown>, displayKey: string, options?: {
12
- allowConfigRef: boolean;
13
- allowIncompleteSetup?: boolean;
14
- }): void;
15
- export declare function validateRuntimeWebUiConfig(config: RuntimeConfigFile, configPath: string): void;
2
+ import { RuntimeConfigValidationError, type RuntimeConfigValidationOptions } from "./validation/runtime-config-validation-contract.js";
3
+ export { validateModelProfileConfig } from "./validation/model-profile-validation.js";
4
+ export { validateRuntimeWebUiConfig } from "./validation/web-ui-config-validation.js";
5
+ export { RuntimeConfigValidationError };
16
6
  export declare function validateRuntimeConfigFile(config: RuntimeConfigFile, configPath: string, options?: RuntimeConfigValidationOptions): void;
17
- export {};