@abot-ai/runtime 1.0.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 (1141) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +251 -0
  3. package/dist/scripts/add-runtime-model.d.ts +6 -0
  4. package/dist/scripts/add-runtime-model.js +239 -0
  5. package/dist/scripts/init-runtime.d.ts +6 -0
  6. package/dist/scripts/init-runtime.js +254 -0
  7. package/dist/scripts/runtime-setup-files.d.ts +12 -0
  8. package/dist/scripts/runtime-setup-files.js +96 -0
  9. package/dist/scripts/runtime-setup-presentation.d.ts +6 -0
  10. package/dist/scripts/runtime-setup-presentation.js +34 -0
  11. package/dist/src/bridge/request-steering.d.ts +8 -0
  12. package/dist/src/bridge/request-steering.js +90 -0
  13. package/dist/src/bridge/runtime-admin.d.ts +13 -0
  14. package/dist/src/bridge/runtime-admin.js +207 -0
  15. package/dist/src/bridge/runtime-replay.d.ts +10 -0
  16. package/dist/src/bridge/runtime-replay.js +497 -0
  17. package/dist/src/bridge/start-agent-bridge.d.ts +40 -0
  18. package/dist/src/bridge/start-agent-bridge.js +519 -0
  19. package/dist/src/capabilities/normal-invocation/contracts.d.ts +73 -0
  20. package/dist/src/capabilities/normal-invocation/contracts.js +3 -0
  21. package/dist/src/capabilities/normal-invocation/definition-projection.d.ts +10 -0
  22. package/dist/src/capabilities/normal-invocation/definition-projection.js +41 -0
  23. package/dist/src/capabilities/normal-invocation/index.d.ts +3 -0
  24. package/dist/src/capabilities/normal-invocation/index.js +3 -0
  25. package/dist/src/capabilities/normal-invocation/validator.d.ts +23 -0
  26. package/dist/src/capabilities/normal-invocation/validator.js +497 -0
  27. package/dist/src/capabilities/registry.d.ts +14 -0
  28. package/dist/src/capabilities/registry.js +34 -0
  29. package/dist/src/capabilities/tool-definition-validator.d.ts +4 -0
  30. package/dist/src/capabilities/tool-definition-validator.js +776 -0
  31. package/dist/src/capabilities/tool-event-metadata.d.ts +8 -0
  32. package/dist/src/capabilities/tool-event-metadata.js +181 -0
  33. package/dist/src/capabilities/tool-executor.d.ts +10 -0
  34. package/dist/src/capabilities/tool-executor.js +160 -0
  35. package/dist/src/capabilities/tool-types.d.ts +287 -0
  36. package/dist/src/capabilities/tool-types.js +8 -0
  37. package/dist/src/cli/abot.d.ts +1 -0
  38. package/dist/src/cli/abot.js +102 -0
  39. package/dist/src/cli/bin.d.ts +2 -0
  40. package/dist/src/cli/bin.js +6 -0
  41. package/dist/src/model-gateway/client/chat.d.ts +5 -0
  42. package/dist/src/model-gateway/client/chat.js +116 -0
  43. package/dist/src/model-gateway/client/contracts.d.ts +71 -0
  44. package/dist/src/model-gateway/client/contracts.js +1 -0
  45. package/dist/src/model-gateway/client/input-token-count.d.ts +4 -0
  46. package/dist/src/model-gateway/client/input-token-count.js +112 -0
  47. package/dist/src/model-gateway/client/invocation-metrics.d.ts +17 -0
  48. package/dist/src/model-gateway/client/invocation-metrics.js +107 -0
  49. package/dist/src/model-gateway/client/message-projection.d.ts +23 -0
  50. package/dist/src/model-gateway/client/message-projection.js +176 -0
  51. package/dist/src/model-gateway/client/options.d.ts +10 -0
  52. package/dist/src/model-gateway/client/options.js +33 -0
  53. package/dist/src/model-gateway/client/raw.d.ts +2 -0
  54. package/dist/src/model-gateway/client/raw.js +107 -0
  55. package/dist/src/model-gateway/client/stream-consumer.d.ts +37 -0
  56. package/dist/src/model-gateway/client/stream-consumer.js +183 -0
  57. package/dist/src/model-gateway/client/stream-parser.d.ts +16 -0
  58. package/dist/src/model-gateway/client/stream-parser.js +129 -0
  59. package/dist/src/model-gateway/client-stream-parser.d.ts +1 -0
  60. package/dist/src/model-gateway/client-stream-parser.js +1 -0
  61. package/dist/src/model-gateway/client.d.ts +19 -0
  62. package/dist/src/model-gateway/client.js +25 -0
  63. package/dist/src/model-gateway/index.d.ts +3 -0
  64. package/dist/src/model-gateway/index.js +2 -0
  65. package/dist/src/model-gateway/invocation-policy.d.ts +1 -0
  66. package/dist/src/model-gateway/invocation-policy.js +1 -0
  67. package/dist/src/model-gateway/invocation-profile-policy.d.ts +1 -0
  68. package/dist/src/model-gateway/invocation-profile-policy.js +1 -0
  69. package/dist/src/model-gateway/message-contract.d.ts +1 -0
  70. package/dist/src/model-gateway/message-contract.js +1 -0
  71. package/dist/src/model-gateway/model-io-trace.d.ts +3 -0
  72. package/dist/src/model-gateway/model-io-trace.js +3 -0
  73. package/dist/src/model-gateway/model-registry.d.ts +1 -0
  74. package/dist/src/model-gateway/model-registry.js +1 -0
  75. package/dist/src/model-gateway/observability/context-window-guard.d.ts +27 -0
  76. package/dist/src/model-gateway/observability/context-window-guard.js +81 -0
  77. package/dist/src/model-gateway/observability/provider-trace-context.d.ts +12 -0
  78. package/dist/src/model-gateway/observability/provider-trace-context.js +22 -0
  79. package/dist/src/model-gateway/observability/provider-trace.d.ts +19 -0
  80. package/dist/src/model-gateway/observability/provider-trace.js +90 -0
  81. package/dist/src/model-gateway/observability/trace-store.d.ts +32 -0
  82. package/dist/src/model-gateway/observability/trace-store.js +74 -0
  83. package/dist/src/model-gateway/policy/invocation-policy.d.ts +11 -0
  84. package/dist/src/model-gateway/policy/invocation-policy.js +178 -0
  85. package/dist/src/model-gateway/policy/invocation-profile-policy.d.ts +25 -0
  86. package/dist/src/model-gateway/policy/invocation-profile-policy.js +28 -0
  87. package/dist/src/model-gateway/policy/model-registry.d.ts +9 -0
  88. package/dist/src/model-gateway/policy/model-registry.js +164 -0
  89. package/dist/src/model-gateway/protocol/message-contract.d.ts +15 -0
  90. package/dist/src/model-gateway/protocol/message-contract.js +181 -0
  91. package/dist/src/model-gateway/protocol/usage.d.ts +9 -0
  92. package/dist/src/model-gateway/protocol/usage.js +39 -0
  93. package/dist/src/model-gateway/provider-adapter.d.ts +1 -0
  94. package/dist/src/model-gateway/provider-adapter.js +1 -0
  95. package/dist/src/model-gateway/provider-envelope-budget.d.ts +1 -0
  96. package/dist/src/model-gateway/provider-envelope-budget.js +1 -0
  97. package/dist/src/model-gateway/providers/contracts.d.ts +62 -0
  98. package/dist/src/model-gateway/providers/contracts.js +32 -0
  99. package/dist/src/model-gateway/providers/envelope-budget.d.ts +15 -0
  100. package/dist/src/model-gateway/providers/envelope-budget.js +79 -0
  101. package/dist/src/model-gateway/providers/ollama/adapter.d.ts +4 -0
  102. package/dist/src/model-gateway/providers/ollama/adapter.js +115 -0
  103. package/dist/src/model-gateway/providers/ollama/generation-options.d.ts +20 -0
  104. package/dist/src/model-gateway/providers/ollama/generation-options.js +49 -0
  105. package/dist/src/model-gateway/providers/ollama/message-projection.d.ts +7 -0
  106. package/dist/src/model-gateway/providers/ollama/message-projection.js +92 -0
  107. package/dist/src/model-gateway/providers/ollama/options.d.ts +1 -0
  108. package/dist/src/model-gateway/providers/ollama/options.js +10 -0
  109. package/dist/src/model-gateway/providers/ollama/payload.d.ts +10 -0
  110. package/dist/src/model-gateway/providers/ollama/payload.js +111 -0
  111. package/dist/src/model-gateway/providers/ollama/request-diagnostics.d.ts +16 -0
  112. package/dist/src/model-gateway/providers/ollama/request-diagnostics.js +98 -0
  113. package/dist/src/model-gateway/providers/ollama/stream-diagnostics.d.ts +11 -0
  114. package/dist/src/model-gateway/providers/ollama/stream-diagnostics.js +137 -0
  115. package/dist/src/model-gateway/providers/ollama/stream-normalizer.d.ts +21 -0
  116. package/dist/src/model-gateway/providers/ollama/stream-normalizer.js +201 -0
  117. package/dist/src/model-gateway/providers/ollama-adapter.d.ts +1 -0
  118. package/dist/src/model-gateway/providers/ollama-adapter.js +1 -0
  119. package/dist/src/model-gateway/providers/ollama.d.ts +1 -0
  120. package/dist/src/model-gateway/providers/ollama.js +1 -0
  121. package/dist/src/model-gateway/providers/openai/adapter.d.ts +2 -0
  122. package/dist/src/model-gateway/providers/openai/adapter.js +114 -0
  123. package/dist/src/model-gateway/providers/openai/diagnostics.d.ts +14 -0
  124. package/dist/src/model-gateway/providers/openai/diagnostics.js +71 -0
  125. package/dist/src/model-gateway/providers/openai/input-token-count.d.ts +2 -0
  126. package/dist/src/model-gateway/providers/openai/input-token-count.js +55 -0
  127. package/dist/src/model-gateway/providers/openai/payload.d.ts +9 -0
  128. package/dist/src/model-gateway/providers/openai/payload.js +127 -0
  129. package/dist/src/model-gateway/providers/openai/protocol.d.ts +4 -0
  130. package/dist/src/model-gateway/providers/openai/protocol.js +3 -0
  131. package/dist/src/model-gateway/providers/openai/settings.d.ts +6 -0
  132. package/dist/src/model-gateway/providers/openai/settings.js +25 -0
  133. package/dist/src/model-gateway/providers/openai/stream-normalizer.d.ts +51 -0
  134. package/dist/src/model-gateway/providers/openai/stream-normalizer.js +179 -0
  135. package/dist/src/model-gateway/providers/openai/stream.d.ts +10 -0
  136. package/dist/src/model-gateway/providers/openai/stream.js +96 -0
  137. package/dist/src/model-gateway/providers/openai-adapter.d.ts +1 -0
  138. package/dist/src/model-gateway/providers/openai-adapter.js +1 -0
  139. package/dist/src/model-gateway/providers/openai.d.ts +1 -0
  140. package/dist/src/model-gateway/providers/openai.js +1 -0
  141. package/dist/src/model-gateway/providers/registry.d.ts +5 -0
  142. package/dist/src/model-gateway/providers/registry.js +10 -0
  143. package/dist/src/model-gateway/server/admin.d.ts +5 -0
  144. package/dist/src/model-gateway/server/admin.js +64 -0
  145. package/dist/src/model-gateway/server/chat-handler.d.ts +4 -0
  146. package/dist/src/model-gateway/server/chat-handler.js +83 -0
  147. package/dist/src/model-gateway/server/configuration.d.ts +4 -0
  148. package/dist/src/model-gateway/server/configuration.js +57 -0
  149. package/dist/src/model-gateway/server/contracts.d.ts +48 -0
  150. package/dist/src/model-gateway/server/contracts.js +1 -0
  151. package/dist/src/model-gateway/server/create-server.d.ts +3 -0
  152. package/dist/src/model-gateway/server/create-server.js +96 -0
  153. package/dist/src/model-gateway/server/errors.d.ts +12 -0
  154. package/dist/src/model-gateway/server/errors.js +47 -0
  155. package/dist/src/model-gateway/server/http-response.d.ts +3 -0
  156. package/dist/src/model-gateway/server/http-response.js +13 -0
  157. package/dist/src/model-gateway/server/index.d.ts +6 -0
  158. package/dist/src/model-gateway/server/index.js +5 -0
  159. package/dist/src/model-gateway/server/input-token-count-handler.d.ts +4 -0
  160. package/dist/src/model-gateway/server/input-token-count-handler.js +84 -0
  161. package/dist/src/model-gateway/server/input-token-measurements.d.ts +16 -0
  162. package/dist/src/model-gateway/server/input-token-measurements.js +58 -0
  163. package/dist/src/model-gateway/server/invocation-validation.d.ts +18 -0
  164. package/dist/src/model-gateway/server/invocation-validation.js +91 -0
  165. package/dist/src/model-gateway/server/provider-fetch.d.ts +16 -0
  166. package/dist/src/model-gateway/server/provider-fetch.js +108 -0
  167. package/dist/src/model-gateway/server/provider-registry.d.ts +3 -0
  168. package/dist/src/model-gateway/server/provider-registry.js +12 -0
  169. package/dist/src/model-gateway/server/raw-handler.d.ts +3 -0
  170. package/dist/src/model-gateway/server/raw-handler.js +70 -0
  171. package/dist/src/model-gateway/server/request-body.d.ts +3 -0
  172. package/dist/src/model-gateway/server/request-body.js +12 -0
  173. package/dist/src/model-gateway/server.d.ts +2 -0
  174. package/dist/src/model-gateway/server.js +9 -0
  175. package/dist/src/model-gateway/stream-normalizer.d.ts +1 -0
  176. package/dist/src/model-gateway/stream-normalizer.js +1 -0
  177. package/dist/src/model-gateway/structured-output/budget.d.ts +7 -0
  178. package/dist/src/model-gateway/structured-output/budget.js +20 -0
  179. package/dist/src/model-gateway/structured-output/format-contract.d.ts +5 -0
  180. package/dist/src/model-gateway/structured-output/format-contract.js +28 -0
  181. package/dist/src/model-gateway/structured-output/ollama-format.d.ts +13 -0
  182. package/dist/src/model-gateway/structured-output/ollama-format.js +136 -0
  183. package/dist/src/model-gateway/structured-output/openai-format.d.ts +14 -0
  184. package/dist/src/model-gateway/structured-output/openai-format.js +75 -0
  185. package/dist/src/model-gateway/structured-output/projection.d.ts +3 -0
  186. package/dist/src/model-gateway/structured-output/projection.js +3 -0
  187. package/dist/src/model-gateway/structured-output/schema-character-estimator.d.ts +1 -0
  188. package/dist/src/model-gateway/structured-output/schema-character-estimator.js +211 -0
  189. package/dist/src/model-gateway/structured-output-budget.d.ts +1 -0
  190. package/dist/src/model-gateway/structured-output-budget.js +1 -0
  191. package/dist/src/model-gateway/structured-output.d.ts +1 -0
  192. package/dist/src/model-gateway/structured-output.js +1 -0
  193. package/dist/src/model-gateway/types.d.ts +214 -0
  194. package/dist/src/model-gateway/types.js +1 -0
  195. package/dist/src/plugin-contract/entrypoint.d.ts +34 -0
  196. package/dist/src/plugin-contract/entrypoint.js +1 -0
  197. package/dist/src/plugin-contract/index.d.ts +2 -0
  198. package/dist/src/plugin-contract/index.js +1 -0
  199. package/dist/src/plugin-contract/manifest.d.ts +49 -0
  200. package/dist/src/plugin-contract/manifest.js +3 -0
  201. package/dist/src/plugin-sdk/bounds.d.ts +28 -0
  202. package/dist/src/plugin-sdk/bounds.js +48 -0
  203. package/dist/src/plugin-sdk/files.d.ts +16 -0
  204. package/dist/src/plugin-sdk/files.js +95 -0
  205. package/dist/src/plugin-sdk/index.d.ts +7 -0
  206. package/dist/src/plugin-sdk/index.js +7 -0
  207. package/dist/src/plugin-sdk/parameters.d.ts +44 -0
  208. package/dist/src/plugin-sdk/parameters.js +123 -0
  209. package/dist/src/plugin-sdk/paths.d.ts +9 -0
  210. package/dist/src/plugin-sdk/paths.js +15 -0
  211. package/dist/src/plugin-sdk/plugin.d.ts +7 -0
  212. package/dist/src/plugin-sdk/plugin.js +7 -0
  213. package/dist/src/plugin-sdk/results.d.ts +21 -0
  214. package/dist/src/plugin-sdk/results.js +70 -0
  215. package/dist/src/runtime/adapters/compiled-workspace-provider.d.ts +5 -0
  216. package/dist/src/runtime/adapters/compiled-workspace-provider.js +7 -0
  217. package/dist/src/runtime/adapters/configured-skill-provider.d.ts +16 -0
  218. package/dist/src/runtime/adapters/configured-skill-provider.js +59 -0
  219. package/dist/src/runtime/adapters/default-session-adapters.d.ts +3 -0
  220. package/dist/src/runtime/adapters/default-session-adapters.js +16 -0
  221. package/dist/src/runtime/adapters/file-session-store.d.ts +8 -0
  222. package/dist/src/runtime/adapters/file-session-store.js +26 -0
  223. package/dist/src/runtime/adapters/in-memory-session-store.d.ts +8 -0
  224. package/dist/src/runtime/adapters/in-memory-session-store.js +475 -0
  225. package/dist/src/runtime/adapters/index.d.ts +8 -0
  226. package/dist/src/runtime/adapters/index.js +8 -0
  227. package/dist/src/runtime/adapters/multi-workspace-provider.d.ts +7 -0
  228. package/dist/src/runtime/adapters/multi-workspace-provider.js +14 -0
  229. package/dist/src/runtime/adapters/registered-tool-normal-invocations/catalog/registrations.d.ts +2 -0
  230. package/dist/src/runtime/adapters/registered-tool-normal-invocations/catalog/registrations.js +39 -0
  231. package/dist/src/runtime/adapters/registered-tool-normal-invocations/catalog/runtime-path-bindings.d.ts +5 -0
  232. package/dist/src/runtime/adapters/registered-tool-normal-invocations/catalog/runtime-path-bindings.js +18 -0
  233. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.d.ts +19 -0
  234. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.js +47 -0
  235. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/call-binding.d.ts +23 -0
  236. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/call-binding.js +117 -0
  237. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.d.ts +8 -0
  238. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.js +113 -0
  239. package/dist/src/runtime/adapters/registered-tool-normal-invocations/executor.d.ts +7 -0
  240. package/dist/src/runtime/adapters/registered-tool-normal-invocations/executor.js +56 -0
  241. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/input-preparation.d.ts +10 -0
  242. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/input-preparation.js +91 -0
  243. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.d.ts +6 -0
  244. package/dist/src/runtime/adapters/registered-tool-normal-invocations/payload/lifecycle.js +97 -0
  245. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +86 -0
  246. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.js +1 -0
  247. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/event-metadata.d.ts +2 -0
  248. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/event-metadata.js +10 -0
  249. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/rejection.d.ts +2 -0
  250. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/rejection.js +3 -0
  251. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/values.d.ts +1 -0
  252. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/values.js +7 -0
  253. package/dist/src/runtime/adapters/registered-tool-normal-invocations.d.ts +3 -0
  254. package/dist/src/runtime/adapters/registered-tool-normal-invocations.js +2 -0
  255. package/dist/src/runtime/adapters/registered-tool-payload-plan.d.ts +90 -0
  256. package/dist/src/runtime/adapters/registered-tool-payload-plan.js +495 -0
  257. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/catalog.d.ts +6 -0
  258. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/catalog.js +144 -0
  259. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/contracts.d.ts +33 -0
  260. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/contracts.js +1 -0
  261. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/errors.d.ts +11 -0
  262. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/errors.js +30 -0
  263. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.d.ts +12 -0
  264. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.js +155 -0
  265. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-authoring-result.d.ts +5 -0
  266. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-authoring-result.js +60 -0
  267. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.d.ts +30 -0
  268. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.js +119 -0
  269. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.d.ts +20 -0
  270. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-rejection.js +46 -0
  271. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.d.ts +32 -0
  272. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.js +303 -0
  273. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-evidence.d.ts +21 -0
  274. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-evidence.js +151 -0
  275. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.d.ts +8 -0
  276. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-observer.js +167 -0
  277. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/runtime-path-controls.d.ts +12 -0
  278. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/runtime-path-controls.js +39 -0
  279. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/values.d.ts +3 -0
  280. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/values.js +21 -0
  281. package/dist/src/runtime/adapters/registered-tool-worker-capabilities.d.ts +8 -0
  282. package/dist/src/runtime/adapters/registered-tool-worker-capabilities.js +147 -0
  283. package/dist/src/runtime/adapters/registered-tool-worker-capability-diagnostics.d.ts +37 -0
  284. package/dist/src/runtime/adapters/registered-tool-worker-capability-diagnostics.js +133 -0
  285. package/dist/src/runtime/adapters/request-tool-model-invoker.d.ts +4 -0
  286. package/dist/src/runtime/adapters/request-tool-model-invoker.js +20 -0
  287. package/dist/src/runtime/adapters/source-workspace-provider.d.ts +5 -0
  288. package/dist/src/runtime/adapters/source-workspace-provider.js +14 -0
  289. package/dist/src/runtime/admin/config-control.d.ts +42 -0
  290. package/dist/src/runtime/admin/config-control.js +211 -0
  291. package/dist/src/runtime/admin/system-control.d.ts +89 -0
  292. package/dist/src/runtime/admin/system-control.js +227 -0
  293. package/dist/src/runtime/attachments/store.d.ts +32 -0
  294. package/dist/src/runtime/attachments/store.js +169 -0
  295. package/dist/src/runtime/capabilities/configured-tool-registry.d.ts +3 -0
  296. package/dist/src/runtime/capabilities/configured-tool-registry.js +40 -0
  297. package/dist/src/runtime/capabilities/request-bound-tool-registry.d.ts +11 -0
  298. package/dist/src/runtime/capabilities/request-bound-tool-registry.js +80 -0
  299. package/dist/src/runtime/capabilities/request-runtime-tool-registry.d.ts +14 -0
  300. package/dist/src/runtime/capabilities/request-runtime-tool-registry.js +18 -0
  301. package/dist/src/runtime/capabilities/runtime-target-path.d.ts +42 -0
  302. package/dist/src/runtime/capabilities/runtime-target-path.js +261 -0
  303. package/dist/src/runtime/composition.d.ts +38 -0
  304. package/dist/src/runtime/composition.js +36 -0
  305. package/dist/src/runtime/config/builders.d.ts +23 -0
  306. package/dist/src/runtime/config/builders.js +485 -0
  307. package/dist/src/runtime/config/constants.d.ts +8 -0
  308. package/dist/src/runtime/config/constants.js +8 -0
  309. package/dist/src/runtime/config/effective-model-config-validation.d.ts +11 -0
  310. package/dist/src/runtime/config/effective-model-config-validation.js +165 -0
  311. package/dist/src/runtime/config/environment.d.ts +12 -0
  312. package/dist/src/runtime/config/environment.js +40 -0
  313. package/dist/src/runtime/config/fields.d.ts +5 -0
  314. package/dist/src/runtime/config/fields.js +259 -0
  315. package/dist/src/runtime/config/layout.d.ts +17 -0
  316. package/dist/src/runtime/config/layout.js +24 -0
  317. package/dist/src/runtime/config/loader.d.ts +12 -0
  318. package/dist/src/runtime/config/loader.js +46 -0
  319. package/dist/src/runtime/config/model-execution-policy.d.ts +13 -0
  320. package/dist/src/runtime/config/model-execution-policy.js +8 -0
  321. package/dist/src/runtime/config/request-runner-config.d.ts +6 -0
  322. package/dist/src/runtime/config/request-runner-config.js +16 -0
  323. package/dist/src/runtime/config/runner/contracts.d.ts +30 -0
  324. package/dist/src/runtime/config/runner/contracts.js +6 -0
  325. package/dist/src/runtime/config/runner/instruction-refs.d.ts +6 -0
  326. package/dist/src/runtime/config/runner/instruction-refs.js +48 -0
  327. package/dist/src/runtime/config/runner/loader.d.ts +4 -0
  328. package/dist/src/runtime/config/runner/loader.js +100 -0
  329. package/dist/src/runtime/config/runner/model-policy.d.ts +6 -0
  330. package/dist/src/runtime/config/runner/model-policy.js +26 -0
  331. package/dist/src/runtime/config/runner/step-instructions.d.ts +34 -0
  332. package/dist/src/runtime/config/runner/step-instructions.js +72 -0
  333. package/dist/src/runtime/config/runner/validation.d.ts +10 -0
  334. package/dist/src/runtime/config/runner/validation.js +57 -0
  335. package/dist/src/runtime/config/schema.d.ts +3 -0
  336. package/dist/src/runtime/config/schema.js +467 -0
  337. package/dist/src/runtime/config/types.d.ts +56 -0
  338. package/dist/src/runtime/config/types.js +1 -0
  339. package/dist/src/runtime/config/utils.d.ts +12 -0
  340. package/dist/src/runtime/config/utils.js +83 -0
  341. package/dist/src/runtime/config/validation.d.ts +17 -0
  342. package/dist/src/runtime/config/validation.js +561 -0
  343. package/dist/src/runtime/config.d.ts +11 -0
  344. package/dist/src/runtime/config.js +166 -0
  345. package/dist/src/runtime/context/model-step-compaction.d.ts +17 -0
  346. package/dist/src/runtime/context/model-step-compaction.js +456 -0
  347. package/dist/src/runtime/context/pinned-context-compaction.d.ts +33 -0
  348. package/dist/src/runtime/context/pinned-context-compaction.js +235 -0
  349. package/dist/src/runtime/context/request-context-budget.d.ts +17 -0
  350. package/dist/src/runtime/context/request-context-budget.js +51 -0
  351. package/dist/src/runtime/context/request-context-contracts.d.ts +64 -0
  352. package/dist/src/runtime/context/request-context-contracts.js +1 -0
  353. package/dist/src/runtime/context/request-context.d.ts +30 -0
  354. package/dist/src/runtime/context/request-context.js +242 -0
  355. package/dist/src/runtime/context/request-source.d.ts +33 -0
  356. package/dist/src/runtime/context/request-source.js +92 -0
  357. package/dist/src/runtime/context/request-temporal-context.d.ts +18 -0
  358. package/dist/src/runtime/context/request-temporal-context.js +43 -0
  359. package/dist/src/runtime/context/request-tool-results.d.ts +48 -0
  360. package/dist/src/runtime/context/request-tool-results.js +319 -0
  361. package/dist/src/runtime/context/semantic-compaction/chunking.d.ts +24 -0
  362. package/dist/src/runtime/context/semantic-compaction/chunking.js +50 -0
  363. package/dist/src/runtime/context/semantic-compaction/contracts.d.ts +60 -0
  364. package/dist/src/runtime/context/semantic-compaction/contracts.js +134 -0
  365. package/dist/src/runtime/context/semantic-compaction/dependency-results.d.ts +20 -0
  366. package/dist/src/runtime/context/semantic-compaction/dependency-results.js +81 -0
  367. package/dist/src/runtime/context/semantic-compaction/format.d.ts +3 -0
  368. package/dist/src/runtime/context/semantic-compaction/format.js +105 -0
  369. package/dist/src/runtime/context/semantic-compaction/index.d.ts +5 -0
  370. package/dist/src/runtime/context/semantic-compaction/index.js +5 -0
  371. package/dist/src/runtime/context/semantic-compaction/parser.d.ts +12 -0
  372. package/dist/src/runtime/context/semantic-compaction/parser.js +153 -0
  373. package/dist/src/runtime/context/semantic-compaction/prompt.d.ts +1 -0
  374. package/dist/src/runtime/context/semantic-compaction/prompt.js +12 -0
  375. package/dist/src/runtime/context/semantic-compaction/repair-headroom.d.ts +31 -0
  376. package/dist/src/runtime/context/semantic-compaction/repair-headroom.js +50 -0
  377. package/dist/src/runtime/context/semantic-compaction/run.d.ts +25 -0
  378. package/dist/src/runtime/context/semantic-compaction/run.js +561 -0
  379. package/dist/src/runtime/context/semantic-compaction/store.d.ts +9 -0
  380. package/dist/src/runtime/context/semantic-compaction/store.js +82 -0
  381. package/dist/src/runtime/context/session-artifact-paths.d.ts +42 -0
  382. package/dist/src/runtime/context/session-artifact-paths.js +58 -0
  383. package/dist/src/runtime/context/session-memory/compaction/batching.d.ts +4 -0
  384. package/dist/src/runtime/context/session-memory/compaction/batching.js +17 -0
  385. package/dist/src/runtime/context/session-memory/compaction/format.d.ts +2 -0
  386. package/dist/src/runtime/context/session-memory/compaction/format.js +26 -0
  387. package/dist/src/runtime/context/session-memory/compaction/parser.d.ts +8 -0
  388. package/dist/src/runtime/context/session-memory/compaction/parser.js +30 -0
  389. package/dist/src/runtime/context/session-memory/compaction/prompt.d.ts +1 -0
  390. package/dist/src/runtime/context/session-memory/compaction/prompt.js +10 -0
  391. package/dist/src/runtime/context/session-memory/compaction/repair-headroom.d.ts +6 -0
  392. package/dist/src/runtime/context/session-memory/compaction/repair-headroom.js +24 -0
  393. package/dist/src/runtime/context/session-memory/compaction/run.d.ts +9 -0
  394. package/dist/src/runtime/context/session-memory/compaction/run.js +125 -0
  395. package/dist/src/runtime/context/session-memory/contracts.d.ts +38 -0
  396. package/dist/src/runtime/context/session-memory/contracts.js +1 -0
  397. package/dist/src/runtime/context/session-memory/controller.d.ts +2 -0
  398. package/dist/src/runtime/context/session-memory/controller.js +90 -0
  399. package/dist/src/runtime/context/session-memory/index.d.ts +4 -0
  400. package/dist/src/runtime/context/session-memory/index.js +3 -0
  401. package/dist/src/runtime/context/session-memory/message-replacement.d.ts +7 -0
  402. package/dist/src/runtime/context/session-memory/message-replacement.js +39 -0
  403. package/dist/src/runtime/context/session-memory/model-step-controller.d.ts +3 -0
  404. package/dist/src/runtime/context/session-memory/model-step-controller.js +42 -0
  405. package/dist/src/runtime/context/session-memory/projection.d.ts +5 -0
  406. package/dist/src/runtime/context/session-memory/projection.js +26 -0
  407. package/dist/src/runtime/context/session-memory/root-projection.d.ts +9 -0
  408. package/dist/src/runtime/context/session-memory/root-projection.js +14 -0
  409. package/dist/src/runtime/context/session-memory/selection.d.ts +8 -0
  410. package/dist/src/runtime/context/session-memory/selection.js +35 -0
  411. package/dist/src/runtime/context/skills-context.d.ts +12 -0
  412. package/dist/src/runtime/context/skills-context.js +27 -0
  413. package/dist/src/runtime/context/token-estimator.d.ts +6 -0
  414. package/dist/src/runtime/context/token-estimator.js +53 -0
  415. package/dist/src/runtime/context/workspace-context.d.ts +8 -0
  416. package/dist/src/runtime/context/workspace-context.js +49 -0
  417. package/dist/src/runtime/default-adapters.d.ts +29 -0
  418. package/dist/src/runtime/default-adapters.js +209 -0
  419. package/dist/src/runtime/events/event-status.d.ts +20 -0
  420. package/dist/src/runtime/events/event-status.js +298 -0
  421. package/dist/src/runtime/events/planner-event-status.d.ts +9 -0
  422. package/dist/src/runtime/events/planner-event-status.js +56 -0
  423. package/dist/src/runtime/events/runtime-emitter.d.ts +30 -0
  424. package/dist/src/runtime/events/runtime-emitter.js +186 -0
  425. package/dist/src/runtime/events/runtime-status.d.ts +5 -0
  426. package/dist/src/runtime/events/runtime-status.js +3 -0
  427. package/dist/src/runtime/index.d.ts +12 -0
  428. package/dist/src/runtime/index.js +12 -0
  429. package/dist/src/runtime/lifecycle/request-finalizer.d.ts +30 -0
  430. package/dist/src/runtime/lifecycle/request-finalizer.js +42 -0
  431. package/dist/src/runtime/model/input-token-count.d.ts +10 -0
  432. package/dist/src/runtime/model/input-token-count.js +42 -0
  433. package/dist/src/runtime/model/invoke-raw-step.d.ts +57 -0
  434. package/dist/src/runtime/model/invoke-raw-step.js +146 -0
  435. package/dist/src/runtime/model/invoke-step.d.ts +16 -0
  436. package/dist/src/runtime/model/invoke-step.js +535 -0
  437. package/dist/src/runtime/model/invoke-structured-step.d.ts +41 -0
  438. package/dist/src/runtime/model/invoke-structured-step.js +143 -0
  439. package/dist/src/runtime/model/json-schema-value.d.ts +9 -0
  440. package/dist/src/runtime/model/json-schema-value.js +261 -0
  441. package/dist/src/runtime/model/model-catalog.d.ts +18 -0
  442. package/dist/src/runtime/model/model-catalog.js +55 -0
  443. package/dist/src/runtime/model/model-context-budget.d.ts +25 -0
  444. package/dist/src/runtime/model/model-context-budget.js +51 -0
  445. package/dist/src/runtime/model/model-selection.d.ts +16 -0
  446. package/dist/src/runtime/model/model-selection.js +66 -0
  447. package/dist/src/runtime/model/model-step-capability-policy.d.ts +14 -0
  448. package/dist/src/runtime/model/model-step-capability-policy.js +49 -0
  449. package/dist/src/runtime/model/model-step-port.d.ts +37 -0
  450. package/dist/src/runtime/model/model-step-port.js +1 -0
  451. package/dist/src/runtime/model/model-step-timeout-policy.d.ts +15 -0
  452. package/dist/src/runtime/model/model-step-timeout-policy.js +34 -0
  453. package/dist/src/runtime/model/provider-completion.d.ts +13 -0
  454. package/dist/src/runtime/model/provider-completion.js +29 -0
  455. package/dist/src/runtime/model/repair-prompts.d.ts +13 -0
  456. package/dist/src/runtime/model/repair-prompts.js +22 -0
  457. package/dist/src/runtime/model/structured-decision-envelope.d.ts +4 -0
  458. package/dist/src/runtime/model/structured-decision-envelope.js +47 -0
  459. package/dist/src/runtime/model/thinking-trace.d.ts +6 -0
  460. package/dist/src/runtime/model/thinking-trace.js +1 -0
  461. package/dist/src/runtime/observability/debug-logger.d.ts +27 -0
  462. package/dist/src/runtime/observability/debug-logger.js +132 -0
  463. package/dist/src/runtime/observability/error-type.d.ts +1 -0
  464. package/dist/src/runtime/observability/error-type.js +33 -0
  465. package/dist/src/runtime/observability/log-rotation.d.ts +24 -0
  466. package/dist/src/runtime/observability/log-rotation.js +142 -0
  467. package/dist/src/runtime/orchestration/capability-adapters/descriptor.d.ts +13 -0
  468. package/dist/src/runtime/orchestration/capability-adapters/descriptor.js +54 -0
  469. package/dist/src/runtime/orchestration/capability-adapters/index.d.ts +14 -0
  470. package/dist/src/runtime/orchestration/capability-adapters/index.js +12 -0
  471. package/dist/src/runtime/orchestration/capability-adapters/result.d.ts +74 -0
  472. package/dist/src/runtime/orchestration/capability-adapters/result.js +307 -0
  473. package/dist/src/runtime/orchestration/capability-adapters/scope.d.ts +17 -0
  474. package/dist/src/runtime/orchestration/capability-adapters/scope.js +51 -0
  475. package/dist/src/runtime/orchestration/capability-adapters/working-directory.d.ts +4 -0
  476. package/dist/src/runtime/orchestration/capability-adapters/working-directory.js +7 -0
  477. package/dist/src/runtime/orchestration/final-response/finalization.d.ts +15 -0
  478. package/dist/src/runtime/orchestration/final-response/finalization.js +18 -0
  479. package/dist/src/runtime/orchestration/lifecycle/request-lifecycle.d.ts +37 -0
  480. package/dist/src/runtime/orchestration/lifecycle/request-lifecycle.js +109 -0
  481. package/dist/src/runtime/orchestration/request/request-attachment-prompt.d.ts +2 -0
  482. package/dist/src/runtime/orchestration/request/request-attachment-prompt.js +17 -0
  483. package/dist/src/runtime/orchestration/request/request-attachments.d.ts +18 -0
  484. package/dist/src/runtime/orchestration/request/request-attachments.js +81 -0
  485. package/dist/src/runtime/orchestration/role-calls/assignment-scope.d.ts +22 -0
  486. package/dist/src/runtime/orchestration/role-calls/assignment-scope.js +100 -0
  487. package/dist/src/runtime/orchestration/role-calls/candidate-validation.d.ts +5 -0
  488. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +328 -0
  489. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.d.ts +25 -0
  490. package/dist/src/runtime/orchestration/role-calls/capability-selection-reconsideration.js +158 -0
  491. package/dist/src/runtime/orchestration/role-calls/child-return.d.ts +32 -0
  492. package/dist/src/runtime/orchestration/role-calls/child-return.js +85 -0
  493. package/dist/src/runtime/orchestration/role-calls/command-decoder.d.ts +9 -0
  494. package/dist/src/runtime/orchestration/role-calls/command-decoder.js +390 -0
  495. package/dist/src/runtime/orchestration/role-calls/command-dispatch.d.ts +2 -0
  496. package/dist/src/runtime/orchestration/role-calls/command-dispatch.js +606 -0
  497. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +418 -0
  498. package/dist/src/runtime/orchestration/role-calls/contracts.js +36 -0
  499. package/dist/src/runtime/orchestration/role-calls/dependency-results.d.ts +8 -0
  500. package/dist/src/runtime/orchestration/role-calls/dependency-results.js +73 -0
  501. package/dist/src/runtime/orchestration/role-calls/diagnostics.d.ts +38 -0
  502. package/dist/src/runtime/orchestration/role-calls/diagnostics.js +270 -0
  503. package/dist/src/runtime/orchestration/role-calls/index.d.ts +11 -0
  504. package/dist/src/runtime/orchestration/role-calls/index.js +11 -0
  505. package/dist/src/runtime/orchestration/role-calls/ledger.d.ts +5 -0
  506. package/dist/src/runtime/orchestration/role-calls/ledger.js +334 -0
  507. package/dist/src/runtime/orchestration/role-calls/plan-binding.d.ts +35 -0
  508. package/dist/src/runtime/orchestration/role-calls/plan-binding.js +179 -0
  509. package/dist/src/runtime/orchestration/role-calls/plan-child-objective.d.ts +12 -0
  510. package/dist/src/runtime/orchestration/role-calls/plan-child-objective.js +38 -0
  511. package/dist/src/runtime/orchestration/role-calls/plan-codec.d.ts +2 -0
  512. package/dist/src/runtime/orchestration/role-calls/plan-codec.js +91 -0
  513. package/dist/src/runtime/orchestration/role-calls/plan-validation.d.ts +22 -0
  514. package/dist/src/runtime/orchestration/role-calls/plan-validation.js +158 -0
  515. package/dist/src/runtime/orchestration/role-calls/plan.d.ts +4 -0
  516. package/dist/src/runtime/orchestration/role-calls/plan.js +4 -0
  517. package/dist/src/runtime/orchestration/role-calls/reducer-primitives.d.ts +31 -0
  518. package/dist/src/runtime/orchestration/role-calls/reducer-primitives.js +161 -0
  519. package/dist/src/runtime/orchestration/role-calls/reducer.d.ts +9 -0
  520. package/dist/src/runtime/orchestration/role-calls/reducer.js +50 -0
  521. package/dist/src/runtime/orchestration/role-calls/transactions.d.ts +5 -0
  522. package/dist/src/runtime/orchestration/role-calls/transactions.js +195 -0
  523. package/dist/src/runtime/orchestration/role-calls/worker-capability-scope.d.ts +4 -0
  524. package/dist/src/runtime/orchestration/role-calls/worker-capability-scope.js +28 -0
  525. package/dist/src/runtime/orchestration/role-calls/working-directory.d.ts +16 -0
  526. package/dist/src/runtime/orchestration/role-calls/working-directory.js +51 -0
  527. package/dist/src/runtime/orchestration/role-executors/activation/loop.d.ts +21 -0
  528. package/dist/src/runtime/orchestration/role-executors/activation/loop.js +245 -0
  529. package/dist/src/runtime/orchestration/role-executors/activation/result-normalization.d.ts +8 -0
  530. package/dist/src/runtime/orchestration/role-executors/activation/result-normalization.js +117 -0
  531. package/dist/src/runtime/orchestration/role-executors/activation/state-validation.d.ts +24 -0
  532. package/dist/src/runtime/orchestration/role-executors/activation/state-validation.js +137 -0
  533. package/dist/src/runtime/orchestration/role-executors/child-invocation/diagnostic-fields.d.ts +4 -0
  534. package/dist/src/runtime/orchestration/role-executors/child-invocation/diagnostic-fields.js +39 -0
  535. package/dist/src/runtime/orchestration/role-executors/child-invocation/state-validation.d.ts +41 -0
  536. package/dist/src/runtime/orchestration/role-executors/child-invocation/state-validation.js +80 -0
  537. package/dist/src/runtime/orchestration/role-executors/child-invocation/transaction.d.ts +22 -0
  538. package/dist/src/runtime/orchestration/role-executors/child-invocation/transaction.js +232 -0
  539. package/dist/src/runtime/orchestration/role-executors/contracts.d.ts +72 -0
  540. package/dist/src/runtime/orchestration/role-executors/contracts.js +1 -0
  541. package/dist/src/runtime/orchestration/role-executors/diagnostics.d.ts +100 -0
  542. package/dist/src/runtime/orchestration/role-executors/diagnostics.js +133 -0
  543. package/dist/src/runtime/orchestration/role-executors/index.d.ts +2 -0
  544. package/dist/src/runtime/orchestration/role-executors/index.js +2 -0
  545. package/dist/src/runtime/orchestration/role-executors/registry.d.ts +2 -0
  546. package/dist/src/runtime/orchestration/role-executors/registry.js +39 -0
  547. package/dist/src/runtime/orchestration/role-executors/shared/diagnostic-context.d.ts +9 -0
  548. package/dist/src/runtime/orchestration/role-executors/shared/diagnostic-context.js +16 -0
  549. package/dist/src/runtime/orchestration/role-executors/shared/runtime-invariants.d.ts +14 -0
  550. package/dist/src/runtime/orchestration/role-executors/shared/runtime-invariants.js +45 -0
  551. package/dist/src/runtime/orchestration/roles.d.ts +7 -0
  552. package/dist/src/runtime/orchestration/roles.js +15 -0
  553. package/dist/src/runtime/orchestration/state-head.d.ts +110 -0
  554. package/dist/src/runtime/orchestration/state-head.js +349 -0
  555. package/dist/src/runtime/orchestration/synchronous-boundary.d.ts +6 -0
  556. package/dist/src/runtime/orchestration/synchronous-boundary.js +26 -0
  557. package/dist/src/runtime/orchestration/worker-capabilities/binding.d.ts +13 -0
  558. package/dist/src/runtime/orchestration/worker-capabilities/binding.js +625 -0
  559. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +178 -0
  560. package/dist/src/runtime/orchestration/worker-capabilities/contracts.js +18 -0
  561. package/dist/src/runtime/orchestration/worker-capabilities/controls.d.ts +18 -0
  562. package/dist/src/runtime/orchestration/worker-capabilities/controls.js +251 -0
  563. package/dist/src/runtime/orchestration/worker-capabilities/diagnostics.d.ts +33 -0
  564. package/dist/src/runtime/orchestration/worker-capabilities/diagnostics.js +117 -0
  565. package/dist/src/runtime/orchestration/worker-capabilities/execution.d.ts +38 -0
  566. package/dist/src/runtime/orchestration/worker-capabilities/execution.js +400 -0
  567. package/dist/src/runtime/orchestration/worker-capabilities/index.d.ts +8 -0
  568. package/dist/src/runtime/orchestration/worker-capabilities/index.js +8 -0
  569. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.d.ts +8 -0
  570. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.js +575 -0
  571. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.d.ts +116 -0
  572. package/dist/src/runtime/orchestration/worker-capabilities/payload-contracts.js +27 -0
  573. package/dist/src/runtime/orchestration/worker-capabilities/payload-diagnostics.d.ts +33 -0
  574. package/dist/src/runtime/orchestration/worker-capabilities/payload-diagnostics.js +82 -0
  575. package/dist/src/runtime/orchestration/worker-capabilities/payload-instructions.d.ts +6 -0
  576. package/dist/src/runtime/orchestration/worker-capabilities/payload-instructions.js +56 -0
  577. package/dist/src/runtime/orchestration/worker-capabilities/scope.d.ts +35 -0
  578. package/dist/src/runtime/orchestration/worker-capabilities/scope.js +141 -0
  579. package/dist/src/runtime/orchestration/worker-capabilities/selection-controls.d.ts +37 -0
  580. package/dist/src/runtime/orchestration/worker-capabilities/selection-controls.js +95 -0
  581. package/dist/src/runtime/orchestration/worker-capabilities/settled-results.d.ts +15 -0
  582. package/dist/src/runtime/orchestration/worker-capabilities/settled-results.js +119 -0
  583. package/dist/src/runtime/plugins/bundled-root.d.ts +5 -0
  584. package/dist/src/runtime/plugins/bundled-root.js +35 -0
  585. package/dist/src/runtime/plugins/compiled-catalog.d.ts +16 -0
  586. package/dist/src/runtime/plugins/compiled-catalog.js +1 -0
  587. package/dist/src/runtime/plugins/discovered-manifest.d.ts +6 -0
  588. package/dist/src/runtime/plugins/discovered-manifest.js +1 -0
  589. package/dist/src/runtime/plugins/loader.d.ts +6 -0
  590. package/dist/src/runtime/plugins/loader.js +337 -0
  591. package/dist/src/runtime/plugins/manifest-discovery.d.ts +8 -0
  592. package/dist/src/runtime/plugins/manifest-discovery.js +125 -0
  593. package/dist/src/runtime/plugins/manifest-projection.d.ts +19 -0
  594. package/dist/src/runtime/plugins/manifest-projection.js +92 -0
  595. package/dist/src/runtime/plugins/manifest-validator.d.ts +2 -0
  596. package/dist/src/runtime/plugins/manifest-validator.js +459 -0
  597. package/dist/src/runtime/ports.d.ts +240 -0
  598. package/dist/src/runtime/ports.js +1 -0
  599. package/dist/src/runtime/request/contracts.d.ts +121 -0
  600. package/dist/src/runtime/request/contracts.js +6 -0
  601. package/dist/src/runtime/request/dependencies.d.ts +23 -0
  602. package/dist/src/runtime/request/dependencies.js +40 -0
  603. package/dist/src/runtime/request/execution-agent-root-execution.d.ts +2 -0
  604. package/dist/src/runtime/request/execution-agent-root-execution.js +117 -0
  605. package/dist/src/runtime/request/execution-facets.d.ts +11 -0
  606. package/dist/src/runtime/request/execution-facets.js +90 -0
  607. package/dist/src/runtime/request/execution-scope-surfaces.d.ts +14 -0
  608. package/dist/src/runtime/request/execution-scope-surfaces.js +138 -0
  609. package/dist/src/runtime/request/execution-scope.d.ts +43 -0
  610. package/dist/src/runtime/request/execution-scope.js +34 -0
  611. package/dist/src/runtime/request/handler.d.ts +3 -0
  612. package/dist/src/runtime/request/handler.js +244 -0
  613. package/dist/src/runtime/request/immutable-view.d.ts +4 -0
  614. package/dist/src/runtime/request/immutable-view.js +10 -0
  615. package/dist/src/runtime/request/input.d.ts +10 -0
  616. package/dist/src/runtime/request/input.js +21 -0
  617. package/dist/src/runtime/request/plan-event-projection.d.ts +61 -0
  618. package/dist/src/runtime/request/plan-event-projection.js +64 -0
  619. package/dist/src/runtime/request/planner-plan-events.d.ts +6 -0
  620. package/dist/src/runtime/request/planner-plan-events.js +44 -0
  621. package/dist/src/runtime/request/request-steering-context.d.ts +3 -0
  622. package/dist/src/runtime/request/request-steering-context.js +22 -0
  623. package/dist/src/runtime/request/request-steering.d.ts +36 -0
  624. package/dist/src/runtime/request/request-steering.js +193 -0
  625. package/dist/src/runtime/request/result.d.ts +15 -0
  626. package/dist/src/runtime/request/result.js +1 -0
  627. package/dist/src/runtime/request/role-call-planner-event-diagnostics.d.ts +17 -0
  628. package/dist/src/runtime/request/role-call-planner-event-diagnostics.js +78 -0
  629. package/dist/src/runtime/request/role-call-planner-events.d.ts +19 -0
  630. package/dist/src/runtime/request/role-call-planner-events.js +104 -0
  631. package/dist/src/runtime/request/role-executor-composition.d.ts +9 -0
  632. package/dist/src/runtime/request/role-executor-composition.js +150 -0
  633. package/dist/src/runtime/request/root-contract.d.ts +98 -0
  634. package/dist/src/runtime/request/root-contract.js +1 -0
  635. package/dist/src/runtime/request/root-execution-kernel.d.ts +11 -0
  636. package/dist/src/runtime/request/root-execution-kernel.js +472 -0
  637. package/dist/src/runtime/request/runner.d.ts +6 -0
  638. package/dist/src/runtime/request/runner.js +81 -0
  639. package/dist/src/runtime/request/session-artifact-path-persistence.d.ts +11 -0
  640. package/dist/src/runtime/request/session-artifact-path-persistence.js +78 -0
  641. package/dist/src/runtime/request/session-store.d.ts +2 -0
  642. package/dist/src/runtime/request/session-store.js +1 -0
  643. package/dist/src/runtime/request/supervisor-root-execution-diagnostics.d.ts +46 -0
  644. package/dist/src/runtime/request/supervisor-root-execution-diagnostics.js +82 -0
  645. package/dist/src/runtime/request/supervisor-root-execution.d.ts +10 -0
  646. package/dist/src/runtime/request/supervisor-root-execution.js +35 -0
  647. package/dist/src/runtime/request/worker-capability-composition.d.ts +18 -0
  648. package/dist/src/runtime/request/worker-capability-composition.js +61 -0
  649. package/dist/src/runtime/request/worker-capability-payload-prompts.d.ts +2 -0
  650. package/dist/src/runtime/request/worker-capability-payload-prompts.js +16 -0
  651. package/dist/src/runtime/request/worker-capability-payload.d.ts +7 -0
  652. package/dist/src/runtime/request/worker-capability-payload.js +420 -0
  653. package/dist/src/runtime/session/request-history.d.ts +3 -0
  654. package/dist/src/runtime/session/request-history.js +10 -0
  655. package/dist/src/runtime/session/request-session.d.ts +33 -0
  656. package/dist/src/runtime/session/request-session.js +40 -0
  657. package/dist/src/runtime/session/session-title.d.ts +12 -0
  658. package/dist/src/runtime/session/session-title.js +38 -0
  659. package/dist/src/runtime/steps/auditor-decision/contracts.d.ts +91 -0
  660. package/dist/src/runtime/steps/auditor-decision/contracts.js +79 -0
  661. package/dist/src/runtime/steps/auditor-decision/format.d.ts +3 -0
  662. package/dist/src/runtime/steps/auditor-decision/format.js +86 -0
  663. package/dist/src/runtime/steps/auditor-decision/index.d.ts +7 -0
  664. package/dist/src/runtime/steps/auditor-decision/index.js +7 -0
  665. package/dist/src/runtime/steps/auditor-decision/input.d.ts +11 -0
  666. package/dist/src/runtime/steps/auditor-decision/input.js +67 -0
  667. package/dist/src/runtime/steps/auditor-decision/parser.d.ts +2 -0
  668. package/dist/src/runtime/steps/auditor-decision/parser.js +146 -0
  669. package/dist/src/runtime/steps/auditor-decision/projection.d.ts +4 -0
  670. package/dist/src/runtime/steps/auditor-decision/projection.js +120 -0
  671. package/dist/src/runtime/steps/auditor-decision/prompt.d.ts +1 -0
  672. package/dist/src/runtime/steps/auditor-decision/prompt.js +11 -0
  673. package/dist/src/runtime/steps/auditor-decision/run.d.ts +4 -0
  674. package/dist/src/runtime/steps/auditor-decision/run.js +70 -0
  675. package/dist/src/runtime/steps/degraded-finalization/contract.d.ts +27 -0
  676. package/dist/src/runtime/steps/degraded-finalization/contract.js +26 -0
  677. package/dist/src/runtime/steps/degraded-finalization/fallback.d.ts +2 -0
  678. package/dist/src/runtime/steps/degraded-finalization/fallback.js +10 -0
  679. package/dist/src/runtime/steps/degraded-finalization/input.d.ts +10 -0
  680. package/dist/src/runtime/steps/degraded-finalization/input.js +20 -0
  681. package/dist/src/runtime/steps/degraded-finalization/parser.d.ts +2 -0
  682. package/dist/src/runtime/steps/degraded-finalization/parser.js +31 -0
  683. package/dist/src/runtime/steps/degraded-finalization/prompt.d.ts +5 -0
  684. package/dist/src/runtime/steps/degraded-finalization/prompt.js +32 -0
  685. package/dist/src/runtime/steps/degraded-finalization/render.d.ts +5 -0
  686. package/dist/src/runtime/steps/degraded-finalization/render.js +25 -0
  687. package/dist/src/runtime/steps/degraded-finalization/run.d.ts +6 -0
  688. package/dist/src/runtime/steps/degraded-finalization/run.js +77 -0
  689. package/dist/src/runtime/steps/execution-agent/compaction.d.ts +15 -0
  690. package/dist/src/runtime/steps/execution-agent/compaction.js +12 -0
  691. package/dist/src/runtime/steps/execution-agent/contracts.d.ts +98 -0
  692. package/dist/src/runtime/steps/execution-agent/contracts.js +22 -0
  693. package/dist/src/runtime/steps/execution-agent/format.d.ts +25 -0
  694. package/dist/src/runtime/steps/execution-agent/format.js +340 -0
  695. package/dist/src/runtime/steps/execution-agent/index.d.ts +11 -0
  696. package/dist/src/runtime/steps/execution-agent/index.js +11 -0
  697. package/dist/src/runtime/steps/execution-agent/input.d.ts +29 -0
  698. package/dist/src/runtime/steps/execution-agent/input.js +153 -0
  699. package/dist/src/runtime/steps/execution-agent/parser.d.ts +2 -0
  700. package/dist/src/runtime/steps/execution-agent/parser.js +466 -0
  701. package/dist/src/runtime/steps/execution-agent/prompt.d.ts +11 -0
  702. package/dist/src/runtime/steps/execution-agent/prompt.js +48 -0
  703. package/dist/src/runtime/steps/execution-agent/refinement-prompt.d.ts +5 -0
  704. package/dist/src/runtime/steps/execution-agent/refinement-prompt.js +16 -0
  705. package/dist/src/runtime/steps/execution-agent/refinement.d.ts +31 -0
  706. package/dist/src/runtime/steps/execution-agent/refinement.js +379 -0
  707. package/dist/src/runtime/steps/execution-agent/response-input.d.ts +16 -0
  708. package/dist/src/runtime/steps/execution-agent/response-input.js +70 -0
  709. package/dist/src/runtime/steps/execution-agent/response-prompt.d.ts +3 -0
  710. package/dist/src/runtime/steps/execution-agent/response-prompt.js +22 -0
  711. package/dist/src/runtime/steps/execution-agent/response-run.d.ts +8 -0
  712. package/dist/src/runtime/steps/execution-agent/response-run.js +50 -0
  713. package/dist/src/runtime/steps/execution-agent/run.d.ts +15 -0
  714. package/dist/src/runtime/steps/execution-agent/run.js +95 -0
  715. package/dist/src/runtime/steps/execution-agent/state-context.d.ts +19 -0
  716. package/dist/src/runtime/steps/execution-agent/state-context.js +205 -0
  717. package/dist/src/runtime/steps/model-step-timeout.d.ts +8 -0
  718. package/dist/src/runtime/steps/model-step-timeout.js +24 -0
  719. package/dist/src/runtime/steps/planner-decision/contracts.d.ts +79 -0
  720. package/dist/src/runtime/steps/planner-decision/contracts.js +37 -0
  721. package/dist/src/runtime/steps/planner-decision/diagnostics.d.ts +75 -0
  722. package/dist/src/runtime/steps/planner-decision/diagnostics.js +227 -0
  723. package/dist/src/runtime/steps/planner-decision/format.d.ts +10 -0
  724. package/dist/src/runtime/steps/planner-decision/format.js +251 -0
  725. package/dist/src/runtime/steps/planner-decision/index.d.ts +9 -0
  726. package/dist/src/runtime/steps/planner-decision/index.js +9 -0
  727. package/dist/src/runtime/steps/planner-decision/input.d.ts +35 -0
  728. package/dist/src/runtime/steps/planner-decision/input.js +218 -0
  729. package/dist/src/runtime/steps/planner-decision/parser.d.ts +9 -0
  730. package/dist/src/runtime/steps/planner-decision/parser.js +241 -0
  731. package/dist/src/runtime/steps/planner-decision/plan-parser.d.ts +7 -0
  732. package/dist/src/runtime/steps/planner-decision/plan-parser.js +178 -0
  733. package/dist/src/runtime/steps/planner-decision/plan.d.ts +8 -0
  734. package/dist/src/runtime/steps/planner-decision/plan.js +125 -0
  735. package/dist/src/runtime/steps/planner-decision/prompt.d.ts +10 -0
  736. package/dist/src/runtime/steps/planner-decision/prompt.js +98 -0
  737. package/dist/src/runtime/steps/planner-decision/resume.d.ts +16 -0
  738. package/dist/src/runtime/steps/planner-decision/resume.js +78 -0
  739. package/dist/src/runtime/steps/planner-decision/run.d.ts +18 -0
  740. package/dist/src/runtime/steps/planner-decision/run.js +141 -0
  741. package/dist/src/runtime/steps/planner-decision/tool-results.d.ts +16 -0
  742. package/dist/src/runtime/steps/planner-decision/tool-results.js +43 -0
  743. package/dist/src/runtime/steps/planner-graph/contracts.d.ts +51 -0
  744. package/dist/src/runtime/steps/planner-graph/contracts.js +25 -0
  745. package/dist/src/runtime/steps/planner-graph/format.d.ts +3 -0
  746. package/dist/src/runtime/steps/planner-graph/format.js +80 -0
  747. package/dist/src/runtime/steps/planner-graph/index.d.ts +6 -0
  748. package/dist/src/runtime/steps/planner-graph/index.js +6 -0
  749. package/dist/src/runtime/steps/planner-graph/input.d.ts +11 -0
  750. package/dist/src/runtime/steps/planner-graph/input.js +58 -0
  751. package/dist/src/runtime/steps/planner-graph/parser.d.ts +2 -0
  752. package/dist/src/runtime/steps/planner-graph/parser.js +227 -0
  753. package/dist/src/runtime/steps/planner-graph/prompt.d.ts +1 -0
  754. package/dist/src/runtime/steps/planner-graph/prompt.js +11 -0
  755. package/dist/src/runtime/steps/planner-graph/run.d.ts +7 -0
  756. package/dist/src/runtime/steps/planner-graph/run.js +72 -0
  757. package/dist/src/runtime/steps/reviewer-decision/contracts.d.ts +103 -0
  758. package/dist/src/runtime/steps/reviewer-decision/contracts.js +42 -0
  759. package/dist/src/runtime/steps/reviewer-decision/diagnostics.d.ts +98 -0
  760. package/dist/src/runtime/steps/reviewer-decision/diagnostics.js +246 -0
  761. package/dist/src/runtime/steps/reviewer-decision/final-evidence.d.ts +42 -0
  762. package/dist/src/runtime/steps/reviewer-decision/final-evidence.js +309 -0
  763. package/dist/src/runtime/steps/reviewer-decision/format.d.ts +3 -0
  764. package/dist/src/runtime/steps/reviewer-decision/format.js +97 -0
  765. package/dist/src/runtime/steps/reviewer-decision/index.d.ts +8 -0
  766. package/dist/src/runtime/steps/reviewer-decision/index.js +8 -0
  767. package/dist/src/runtime/steps/reviewer-decision/input.d.ts +32 -0
  768. package/dist/src/runtime/steps/reviewer-decision/input.js +464 -0
  769. package/dist/src/runtime/steps/reviewer-decision/model-context.d.ts +17 -0
  770. package/dist/src/runtime/steps/reviewer-decision/model-context.js +95 -0
  771. package/dist/src/runtime/steps/reviewer-decision/parser.d.ts +5 -0
  772. package/dist/src/runtime/steps/reviewer-decision/parser.js +242 -0
  773. package/dist/src/runtime/steps/reviewer-decision/projection.d.ts +18 -0
  774. package/dist/src/runtime/steps/reviewer-decision/projection.js +296 -0
  775. package/dist/src/runtime/steps/reviewer-decision/prompt.d.ts +1 -0
  776. package/dist/src/runtime/steps/reviewer-decision/prompt.js +18 -0
  777. package/dist/src/runtime/steps/reviewer-decision/run.d.ts +13 -0
  778. package/dist/src/runtime/steps/reviewer-decision/run.js +158 -0
  779. package/dist/src/runtime/steps/supervisor-decision/contracts.d.ts +107 -0
  780. package/dist/src/runtime/steps/supervisor-decision/contracts.js +19 -0
  781. package/dist/src/runtime/steps/supervisor-decision/diagnostics.d.ts +111 -0
  782. package/dist/src/runtime/steps/supervisor-decision/diagnostics.js +277 -0
  783. package/dist/src/runtime/steps/supervisor-decision/format.d.ts +9 -0
  784. package/dist/src/runtime/steps/supervisor-decision/format.js +151 -0
  785. package/dist/src/runtime/steps/supervisor-decision/index.d.ts +10 -0
  786. package/dist/src/runtime/steps/supervisor-decision/index.js +10 -0
  787. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +26 -0
  788. package/dist/src/runtime/steps/supervisor-decision/input.js +176 -0
  789. package/dist/src/runtime/steps/supervisor-decision/ledger-projection.d.ts +4 -0
  790. package/dist/src/runtime/steps/supervisor-decision/ledger-projection.js +32 -0
  791. package/dist/src/runtime/steps/supervisor-decision/parser.d.ts +9 -0
  792. package/dist/src/runtime/steps/supervisor-decision/parser.js +259 -0
  793. package/dist/src/runtime/steps/supervisor-decision/prompt.d.ts +12 -0
  794. package/dist/src/runtime/steps/supervisor-decision/prompt.js +140 -0
  795. package/dist/src/runtime/steps/supervisor-decision/resume.d.ts +11 -0
  796. package/dist/src/runtime/steps/supervisor-decision/resume.js +113 -0
  797. package/dist/src/runtime/steps/supervisor-decision/run.d.ts +14 -0
  798. package/dist/src/runtime/steps/supervisor-decision/run.js +221 -0
  799. package/dist/src/runtime/steps/supervisor-decision/worker-affordances.d.ts +7 -0
  800. package/dist/src/runtime/steps/supervisor-decision/worker-affordances.js +10 -0
  801. package/dist/src/runtime/steps/supervisor-decision/working-directory.d.ts +17 -0
  802. package/dist/src/runtime/steps/supervisor-decision/working-directory.js +174 -0
  803. package/dist/src/runtime/steps/supervisor-response/contracts.d.ts +13 -0
  804. package/dist/src/runtime/steps/supervisor-response/contracts.js +2 -0
  805. package/dist/src/runtime/steps/supervisor-response/diagnostics.d.ts +27 -0
  806. package/dist/src/runtime/steps/supervisor-response/diagnostics.js +55 -0
  807. package/dist/src/runtime/steps/supervisor-response/index.d.ts +4 -0
  808. package/dist/src/runtime/steps/supervisor-response/index.js +4 -0
  809. package/dist/src/runtime/steps/supervisor-response/input.d.ts +13 -0
  810. package/dist/src/runtime/steps/supervisor-response/input.js +73 -0
  811. package/dist/src/runtime/steps/supervisor-response/prompt.d.ts +6 -0
  812. package/dist/src/runtime/steps/supervisor-response/prompt.js +33 -0
  813. package/dist/src/runtime/steps/supervisor-response/run.d.ts +8 -0
  814. package/dist/src/runtime/steps/supervisor-response/run.js +108 -0
  815. package/dist/src/runtime/steps/worker-capability-scope-decision.d.ts +9 -0
  816. package/dist/src/runtime/steps/worker-capability-scope-decision.js +38 -0
  817. package/dist/src/runtime/steps/worker-decision/capability-affordances.d.ts +12 -0
  818. package/dist/src/runtime/steps/worker-decision/capability-affordances.js +8 -0
  819. package/dist/src/runtime/steps/worker-decision/capability-catalog.d.ts +28 -0
  820. package/dist/src/runtime/steps/worker-decision/capability-catalog.js +52 -0
  821. package/dist/src/runtime/steps/worker-decision/capability-selection-rejection.d.ts +15 -0
  822. package/dist/src/runtime/steps/worker-decision/capability-selection-rejection.js +41 -0
  823. package/dist/src/runtime/steps/worker-decision/contracts.d.ts +92 -0
  824. package/dist/src/runtime/steps/worker-decision/contracts.js +34 -0
  825. package/dist/src/runtime/steps/worker-decision/diagnostics.d.ts +110 -0
  826. package/dist/src/runtime/steps/worker-decision/diagnostics.js +298 -0
  827. package/dist/src/runtime/steps/worker-decision/format.d.ts +18 -0
  828. package/dist/src/runtime/steps/worker-decision/format.js +306 -0
  829. package/dist/src/runtime/steps/worker-decision/index.d.ts +8 -0
  830. package/dist/src/runtime/steps/worker-decision/index.js +8 -0
  831. package/dist/src/runtime/steps/worker-decision/input/canonical-state.d.ts +19 -0
  832. package/dist/src/runtime/steps/worker-decision/input/canonical-state.js +167 -0
  833. package/dist/src/runtime/steps/worker-decision/input/capability-selection.d.ts +9 -0
  834. package/dist/src/runtime/steps/worker-decision/input/capability-selection.js +135 -0
  835. package/dist/src/runtime/steps/worker-decision/input/contract.d.ts +9 -0
  836. package/dist/src/runtime/steps/worker-decision/input/contract.js +92 -0
  837. package/dist/src/runtime/steps/worker-decision/input/diagnostic-projection.d.ts +4 -0
  838. package/dist/src/runtime/steps/worker-decision/input/diagnostic-projection.js +114 -0
  839. package/dist/src/runtime/steps/worker-decision/input/prompt-context.d.ts +3 -0
  840. package/dist/src/runtime/steps/worker-decision/input/prompt-context.js +189 -0
  841. package/dist/src/runtime/steps/worker-decision/input/reference-context.d.ts +2 -0
  842. package/dist/src/runtime/steps/worker-decision/input/reference-context.js +50 -0
  843. package/dist/src/runtime/steps/worker-decision/input/session.d.ts +3 -0
  844. package/dist/src/runtime/steps/worker-decision/input/session.js +55 -0
  845. package/dist/src/runtime/steps/worker-decision/input/types.d.ts +122 -0
  846. package/dist/src/runtime/steps/worker-decision/input/types.js +1 -0
  847. package/dist/src/runtime/steps/worker-decision/input.d.ts +21 -0
  848. package/dist/src/runtime/steps/worker-decision/input.js +31 -0
  849. package/dist/src/runtime/steps/worker-decision/ledger-projection.d.ts +9 -0
  850. package/dist/src/runtime/steps/worker-decision/ledger-projection.js +40 -0
  851. package/dist/src/runtime/steps/worker-decision/parser.d.ts +17 -0
  852. package/dist/src/runtime/steps/worker-decision/parser.js +495 -0
  853. package/dist/src/runtime/steps/worker-decision/prompt.d.ts +21 -0
  854. package/dist/src/runtime/steps/worker-decision/prompt.js +167 -0
  855. package/dist/src/runtime/steps/worker-decision/result-author.d.ts +6 -0
  856. package/dist/src/runtime/steps/worker-decision/result-author.js +177 -0
  857. package/dist/src/runtime/steps/worker-decision/run.d.ts +20 -0
  858. package/dist/src/runtime/steps/worker-decision/run.js +433 -0
  859. package/dist/src/runtime/steps/worker-decision/runtime-path-refinement.d.ts +5 -0
  860. package/dist/src/runtime/steps/worker-decision/runtime-path-refinement.js +30 -0
  861. package/dist/src/runtime/streaming/request-callbacks.d.ts +25 -0
  862. package/dist/src/runtime/streaming/request-callbacks.js +52 -0
  863. package/dist/src/sessions/artifact-paths.d.ts +9 -0
  864. package/dist/src/sessions/artifact-paths.js +51 -0
  865. package/dist/src/sessions/context-window.d.ts +20 -0
  866. package/dist/src/sessions/context-window.js +214 -0
  867. package/dist/src/sessions/index.d.ts +49 -0
  868. package/dist/src/sessions/index.js +64 -0
  869. package/dist/src/sessions/memory/contracts.d.ts +29 -0
  870. package/dist/src/sessions/memory/contracts.js +2 -0
  871. package/dist/src/sessions/memory/rules.d.ts +5 -0
  872. package/dist/src/sessions/memory/rules.js +77 -0
  873. package/dist/src/sessions/memory/source.d.ts +14 -0
  874. package/dist/src/sessions/memory/source.js +116 -0
  875. package/dist/src/sessions/record/projection.d.ts +25 -0
  876. package/dist/src/sessions/record/projection.js +212 -0
  877. package/dist/src/sessions/record/rules.d.ts +6 -0
  878. package/dist/src/sessions/record/rules.js +45 -0
  879. package/dist/src/sessions/session-service.d.ts +61 -0
  880. package/dist/src/sessions/session-service.js +435 -0
  881. package/dist/src/sessions/session-store.d.ts +6 -0
  882. package/dist/src/sessions/session-store.js +61 -0
  883. package/dist/src/sessions/types.d.ts +169 -0
  884. package/dist/src/sessions/types.js +1 -0
  885. package/dist/src/shared/agent.d.ts +4 -0
  886. package/dist/src/shared/agent.js +18 -0
  887. package/dist/src/shared/attachments.d.ts +64 -0
  888. package/dist/src/shared/attachments.js +26 -0
  889. package/dist/src/shared/constants.d.ts +4 -0
  890. package/dist/src/shared/constants.js +4 -0
  891. package/dist/src/shared/invocation-profile-selection.d.ts +42 -0
  892. package/dist/src/shared/invocation-profile-selection.js +125 -0
  893. package/dist/src/shared/load-dotenv.d.ts +1 -0
  894. package/dist/src/shared/load-dotenv.js +40 -0
  895. package/dist/src/shared/model-role-policy.d.ts +3 -0
  896. package/dist/src/shared/model-role-policy.js +12 -0
  897. package/dist/src/shared/model-step-registry-data.json +125 -0
  898. package/dist/src/shared/model-step-registry.d.ts +133 -0
  899. package/dist/src/shared/model-step-registry.generated.d.ts +123 -0
  900. package/dist/src/shared/model-step-registry.generated.js +123 -0
  901. package/dist/src/shared/model-step-registry.js +36 -0
  902. package/dist/src/shared/model-step-registry.types.d.ts +19 -0
  903. package/dist/src/shared/model-step-registry.types.js +1 -0
  904. package/dist/src/shared/model-steps.d.ts +5 -0
  905. package/dist/src/shared/model-steps.js +12 -0
  906. package/dist/src/shared/types.d.ts +17 -0
  907. package/dist/src/shared/types.js +1 -0
  908. package/dist/src/web-ui/app/ARCHITECTURE.md +52 -0
  909. package/dist/src/web-ui/app/app.js +749 -0
  910. package/dist/src/web-ui/app/components/composer-actions.d.ts +26 -0
  911. package/dist/src/web-ui/app/components/composer-actions.js +118 -0
  912. package/dist/src/web-ui/app/components/config-workspace.js +875 -0
  913. package/dist/src/web-ui/app/components/conversation-activity.d.ts +72 -0
  914. package/dist/src/web-ui/app/components/conversation-activity.js +523 -0
  915. package/dist/src/web-ui/app/components/conversation-view.js +278 -0
  916. package/dist/src/web-ui/app/components/menu-navigation.js +39 -0
  917. package/dist/src/web-ui/app/components/message-attachments.d.ts +27 -0
  918. package/dist/src/web-ui/app/components/message-attachments.js +114 -0
  919. package/dist/src/web-ui/app/components/message-timestamp.d.ts +22 -0
  920. package/dist/src/web-ui/app/components/message-timestamp.js +44 -0
  921. package/dist/src/web-ui/app/components/model-selector.d.ts +15 -0
  922. package/dist/src/web-ui/app/components/model-selector.js +142 -0
  923. package/dist/src/web-ui/app/components/runtime-setup-guide.js +519 -0
  924. package/dist/src/web-ui/app/components/session-actions-menu.d.ts +17 -0
  925. package/dist/src/web-ui/app/components/session-actions-menu.js +121 -0
  926. package/dist/src/web-ui/app/components/tool-approval-card.js +58 -0
  927. package/dist/src/web-ui/app/components/workspace-shell.js +236 -0
  928. package/dist/src/web-ui/app/controllers/app-event-bindings.js +280 -0
  929. package/dist/src/web-ui/app/controllers/chat-request-controller.js +79 -0
  930. package/dist/src/web-ui/app/controllers/composer-attachments-controller.js +227 -0
  931. package/dist/src/web-ui/app/controllers/composer-queue-controller.js +273 -0
  932. package/dist/src/web-ui/app/controllers/composer-submit-controller.js +108 -0
  933. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +556 -0
  934. package/dist/src/web-ui/app/controllers/operations-controller.js +137 -0
  935. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +444 -0
  936. package/dist/src/web-ui/app/controllers/runtime-onboarding-controller.js +134 -0
  937. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +419 -0
  938. package/dist/src/web-ui/app/controllers/session-controller.js +312 -0
  939. package/dist/src/web-ui/app/controllers/steer-controller.d.ts +21 -0
  940. package/dist/src/web-ui/app/controllers/steer-controller.js +97 -0
  941. package/dist/src/web-ui/app/controllers/tool-approval-controller.js +64 -0
  942. package/dist/src/web-ui/app/index.html +513 -0
  943. package/dist/src/web-ui/app/lib/attachment-policy.d.ts +15 -0
  944. package/dist/src/web-ui/app/lib/attachment-policy.js +49 -0
  945. package/dist/src/web-ui/app/lib/event-presentation.d.ts +23 -0
  946. package/dist/src/web-ui/app/lib/event-presentation.js +248 -0
  947. package/dist/src/web-ui/app/lib/realtime-message.js +25 -0
  948. package/dist/src/web-ui/app/lib/session-composer-queue.d.ts +76 -0
  949. package/dist/src/web-ui/app/lib/session-composer-queue.js +318 -0
  950. package/dist/src/web-ui/app/lib/text-format.d.ts +13 -0
  951. package/dist/src/web-ui/app/lib/text-format.js +197 -0
  952. package/dist/src/web-ui/app/services/client-preferences.js +117 -0
  953. package/dist/src/web-ui/app/services/realtime-transport.d.ts +17 -0
  954. package/dist/src/web-ui/app/services/realtime-transport.js +65 -0
  955. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +96 -0
  956. package/dist/src/web-ui/app/services/runtime-web-client.js +270 -0
  957. package/dist/src/web-ui/app/styles/00-tokens-base.css +151 -0
  958. package/dist/src/web-ui/app/styles/10-shell-sessions.css +867 -0
  959. package/dist/src/web-ui/app/styles/20-chat-composer.css +1936 -0
  960. package/dist/src/web-ui/app/styles/30-inspector-config.css +2108 -0
  961. package/dist/src/web-ui/app/styles/90-responsive.css +451 -0
  962. package/dist/src/web-ui/app/styles/foundation.css +173 -0
  963. package/dist/src/web-ui/app/styles.css +6 -0
  964. package/dist/src/web-ui/app/ui-behavior.d.ts +55 -0
  965. package/dist/src/web-ui/app/ui-behavior.js +82 -0
  966. package/dist/src/web-ui/config-dashboard-backend.d.ts +41 -0
  967. package/dist/src/web-ui/config-dashboard-backend.js +276 -0
  968. package/dist/src/web-ui/external-bridge-backend.d.ts +20 -0
  969. package/dist/src/web-ui/external-bridge-backend.js +292 -0
  970. package/dist/src/web-ui/local-runtime/api-router.d.ts +13 -0
  971. package/dist/src/web-ui/local-runtime/api-router.js +253 -0
  972. package/dist/src/web-ui/local-runtime/attachment-routes.d.ts +10 -0
  973. package/dist/src/web-ui/local-runtime/attachment-routes.js +122 -0
  974. package/dist/src/web-ui/local-runtime/contracts.d.ts +33 -0
  975. package/dist/src/web-ui/local-runtime/contracts.js +1 -0
  976. package/dist/src/web-ui/local-runtime/control-routes.d.ts +11 -0
  977. package/dist/src/web-ui/local-runtime/control-routes.js +52 -0
  978. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +12 -0
  979. package/dist/src/web-ui/local-runtime/environment-registry.js +58 -0
  980. package/dist/src/web-ui/local-runtime/http.d.ts +14 -0
  981. package/dist/src/web-ui/local-runtime/http.js +78 -0
  982. package/dist/src/web-ui/local-runtime/realtime-controller.d.ts +15 -0
  983. package/dist/src/web-ui/local-runtime/realtime-controller.js +69 -0
  984. package/dist/src/web-ui/local-runtime/realtime-hub.d.ts +8 -0
  985. package/dist/src/web-ui/local-runtime/realtime-hub.js +18 -0
  986. package/dist/src/web-ui/local-runtime/request-execution.d.ts +18 -0
  987. package/dist/src/web-ui/local-runtime/request-execution.js +199 -0
  988. package/dist/src/web-ui/local-runtime/runtime-availability.d.ts +3 -0
  989. package/dist/src/web-ui/local-runtime/runtime-availability.js +45 -0
  990. package/dist/src/web-ui/local-runtime-backend.d.ts +14 -0
  991. package/dist/src/web-ui/local-runtime-backend.js +60 -0
  992. package/dist/src/web-ui/runtime-service-auto-open.d.ts +58 -0
  993. package/dist/src/web-ui/runtime-service-auto-open.js +167 -0
  994. package/dist/src/web-ui/server.d.ts +36 -0
  995. package/dist/src/web-ui/server.js +326 -0
  996. package/dist/src/web-ui/web-ui-address.d.ts +7 -0
  997. package/dist/src/web-ui/web-ui-address.js +33 -0
  998. package/dist/src/workspace/files.d.ts +4 -0
  999. package/dist/src/workspace/files.js +49 -0
  1000. package/dist/src/workspace/types.d.ts +10 -0
  1001. package/dist/src/workspace/types.js +1 -0
  1002. package/docs/architecture.md +134 -0
  1003. package/docs/bridge-compatibility.md +128 -0
  1004. package/docs/configuration.md +462 -0
  1005. package/docs/installation.md +207 -0
  1006. package/docs/known-limitations.md +89 -0
  1007. package/docs/plugins.md +324 -0
  1008. package/docs/publishing.md +140 -0
  1009. package/docs/running-locally.md +184 -0
  1010. package/docs/runtime-invariant-coverage.md +39 -0
  1011. package/docs/runtime-library.md +289 -0
  1012. package/docs/runtime-prompt-policy-contracts.md +70 -0
  1013. package/docs/runtime-public-contracts.md +304 -0
  1014. package/docs/tool-execution-result-evidence-contract.md +151 -0
  1015. package/docs/troubleshooting.md +115 -0
  1016. package/examples/env.example +9 -0
  1017. package/examples/minimal-runtime-composition.ts +24 -0
  1018. package/examples/models/default.config.json +28 -0
  1019. package/examples/request-runner.config.example.json +42 -0
  1020. package/examples/runtime-library-host.ts +24 -0
  1021. package/examples/runtime.config.example.json +63 -0
  1022. package/package.json +169 -0
  1023. package/plugins/capability-brief/plugin.json +33 -0
  1024. package/plugins/capability-brief/source/index.ts +84 -0
  1025. package/plugins/capability-brief/src/index.cjs +194 -0
  1026. package/plugins/code-outline/plugin.json +56 -0
  1027. package/plugins/code-outline/skills/code_outline_skill/SKILL.md +9 -0
  1028. package/plugins/code-outline/source/index.ts +125 -0
  1029. package/plugins/code-outline/source/parser.ts +234 -0
  1030. package/plugins/code-outline/src/index.cjs +572 -0
  1031. package/plugins/document-reader/plugin.json +67 -0
  1032. package/plugins/document-reader/skills/document_reader_skill/SKILL.md +26 -0
  1033. package/plugins/document-reader/source/archive.ts +245 -0
  1034. package/plugins/document-reader/source/constants.ts +41 -0
  1035. package/plugins/document-reader/source/errors.ts +75 -0
  1036. package/plugins/document-reader/source/extract.ts +53 -0
  1037. package/plugins/document-reader/source/handler.ts +288 -0
  1038. package/plugins/document-reader/source/index.ts +11 -0
  1039. package/plugins/document-reader/source/ooxml.ts +182 -0
  1040. package/plugins/document-reader/source/pdf-worker.ts +425 -0
  1041. package/plugins/document-reader/source/pdf.ts +13 -0
  1042. package/plugins/document-reader/source/reader.ts +55 -0
  1043. package/plugins/document-reader/source/source-resolution.ts +137 -0
  1044. package/plugins/document-reader/source/text-accumulator.ts +53 -0
  1045. package/plugins/document-reader/source/types.ts +73 -0
  1046. package/plugins/document-reader/src/index.cjs +1455 -0
  1047. package/plugins/exec/plugin.json +113 -0
  1048. package/plugins/exec/skills/exec_process_skill/SKILL.md +7 -0
  1049. package/plugins/exec/skills/exec_skill/SKILL.md +12 -0
  1050. package/plugins/exec/source/errors.ts +33 -0
  1051. package/plugins/exec/source/filesystem-observer.ts +362 -0
  1052. package/plugins/exec/source/handlers.ts +402 -0
  1053. package/plugins/exec/source/index.ts +12 -0
  1054. package/plugins/exec/source/paths.ts +97 -0
  1055. package/plugins/exec/source/process-manager.ts +430 -0
  1056. package/plugins/exec/source/settings.ts +46 -0
  1057. package/plugins/exec/source/types.ts +77 -0
  1058. package/plugins/exec/source/validation.ts +214 -0
  1059. package/plugins/exec/src/index.cjs +1362 -0
  1060. package/plugins/filesystem/plugin.json +259 -0
  1061. package/plugins/filesystem/skills/edit_file_skill/SKILL.md +8 -0
  1062. package/plugins/filesystem/skills/follow_up_existing_file_edit_skill/SKILL.md +9 -0
  1063. package/plugins/filesystem/skills/read_file_skill/SKILL.md +6 -0
  1064. package/plugins/filesystem/source/adapters.ts +44 -0
  1065. package/plugins/filesystem/source/atomic-write.ts +115 -0
  1066. package/plugins/filesystem/source/bounded-io.ts +514 -0
  1067. package/plugins/filesystem/source/dev-view.ts +262 -0
  1068. package/plugins/filesystem/source/draft/grounding.ts +171 -0
  1069. package/plugins/filesystem/source/draft/prepare.ts +176 -0
  1070. package/plugins/filesystem/source/draft/repair.ts +218 -0
  1071. package/plugins/filesystem/source/draft/types.ts +36 -0
  1072. package/plugins/filesystem/source/draft/validators.ts +237 -0
  1073. package/plugins/filesystem/source/edit-file.ts +298 -0
  1074. package/plugins/filesystem/source/errors.ts +61 -0
  1075. package/plugins/filesystem/source/index.ts +59 -0
  1076. package/plugins/filesystem/source/mutation-coordinator.ts +37 -0
  1077. package/plugins/filesystem/source/mutation-parent.ts +164 -0
  1078. package/plugins/filesystem/source/path-service.ts +73 -0
  1079. package/plugins/filesystem/source/read-file.ts +63 -0
  1080. package/plugins/filesystem/source/view-window.ts +95 -0
  1081. package/plugins/filesystem/source/write-file.ts +146 -0
  1082. package/plugins/filesystem/src/index.cjs +2187 -0
  1083. package/plugins/json-inspector/plugin.json +52 -0
  1084. package/plugins/json-inspector/skills/json_inspector_skill/SKILL.md +9 -0
  1085. package/plugins/json-inspector/source/index.ts +145 -0
  1086. package/plugins/json-inspector/source/shape.ts +144 -0
  1087. package/plugins/json-inspector/src/index.cjs +536 -0
  1088. package/plugins/local-search/plugin.json +65 -0
  1089. package/plugins/local-search/skills/local_search_skill/SKILL.md +20 -0
  1090. package/plugins/local-search/source/errors.ts +21 -0
  1091. package/plugins/local-search/source/index.ts +195 -0
  1092. package/plugins/local-search/source/output.ts +101 -0
  1093. package/plugins/local-search/source/paths.ts +194 -0
  1094. package/plugins/local-search/source/ripgrep.ts +353 -0
  1095. package/plugins/local-search/src/index.cjs +840 -0
  1096. package/plugins/memory/plugin.json +149 -0
  1097. package/plugins/memory/skills/memory_lookup_skill/SKILL.md +12 -0
  1098. package/plugins/memory/skills/memory_mutation_skill/SKILL.md +9 -0
  1099. package/plugins/memory/source/format.ts +51 -0
  1100. package/plugins/memory/source/index.ts +199 -0
  1101. package/plugins/memory/source/search.ts +47 -0
  1102. package/plugins/memory/source/store-lock.ts +482 -0
  1103. package/plugins/memory/source/store.ts +331 -0
  1104. package/plugins/memory/source/types.ts +31 -0
  1105. package/plugins/memory/src/index.cjs +1082 -0
  1106. package/plugins/project-orientation/plugin.json +63 -0
  1107. package/plugins/project-orientation/skills/project_orientation_skill/SKILL.md +11 -0
  1108. package/plugins/project-orientation/source/index.ts +118 -0
  1109. package/plugins/project-orientation/source/manifest-summary.ts +153 -0
  1110. package/plugins/project-orientation/source/tree.ts +126 -0
  1111. package/plugins/project-orientation/src/index.cjs +584 -0
  1112. package/plugins/system-probe/plugin.json +60 -0
  1113. package/plugins/system-probe/source/index.ts +125 -0
  1114. package/plugins/system-probe/source/metrics.ts +39 -0
  1115. package/plugins/system-probe/src/index.cjs +309 -0
  1116. package/plugins/web/plugin.json +146 -0
  1117. package/plugins/web/skills/web_fetch_skill/SKILL.md +9 -0
  1118. package/plugins/web/skills/web_search_skill/SKILL.md +16 -0
  1119. package/plugins/web/source/aggregate-gate.ts +141 -0
  1120. package/plugins/web/source/brave-client.ts +251 -0
  1121. package/plugins/web/source/concurrency.ts +23 -0
  1122. package/plugins/web/source/content.ts +291 -0
  1123. package/plugins/web/source/deadline.ts +61 -0
  1124. package/plugins/web/source/errors.ts +31 -0
  1125. package/plugins/web/source/fetch-service.ts +81 -0
  1126. package/plugins/web/source/index.ts +5 -0
  1127. package/plugins/web/source/limits.ts +29 -0
  1128. package/plugins/web/source/network-policy.ts +242 -0
  1129. package/plugins/web/source/output-budget.ts +42 -0
  1130. package/plugins/web/source/parameters.ts +145 -0
  1131. package/plugins/web/source/plugin.ts +149 -0
  1132. package/plugins/web/source/public-http.ts +142 -0
  1133. package/plugins/web/source/request-hop.ts +196 -0
  1134. package/plugins/web/source/research.ts +109 -0
  1135. package/plugins/web/source/search-presentation.ts +111 -0
  1136. package/plugins/web/source/search-service.ts +139 -0
  1137. package/plugins/web/source/search-types.ts +47 -0
  1138. package/plugins/web/source/untrusted-text.ts +8 -0
  1139. package/plugins/web/src/index.cjs +1906 -0
  1140. package/runtime.config.schema.json +791 -0
  1141. package/src/runtime/README.md +411 -0
@@ -0,0 +1,304 @@
1
+ # Runtime Public Contracts
2
+
3
+ This document describes the stable runtime contracts that host applications can
4
+ depend on. It intentionally does not describe internal request execution,
5
+ role orchestration, model, or context modules.
6
+
7
+ ## Public Entrypoints
8
+
9
+ Use package exports from `package.json`:
10
+
11
+ - `@abot-ai/runtime/runtime`
12
+ - `@abot-ai/runtime/runtime/config`
13
+ - `@abot-ai/runtime/runtime/composition`
14
+ - `@abot-ai/runtime/runtime/default-adapters`
15
+ - `@abot-ai/runtime/runtime/adapters`
16
+ - `@abot-ai/runtime/runtime/ports`
17
+ - `@abot-ai/runtime/plugin-sdk`
18
+ - `@abot-ai/runtime/model-gateway`
19
+
20
+ Do not import from `src/runtime/request`, `src/runtime/orchestration`,
21
+ `src/runtime/steps`, `src/runtime/model`, `src/runtime/context`, or
22
+ `src/runtime/events` in a host application. Those modules are internal and may
23
+ move while public ports remain stable.
24
+
25
+ ## RuntimeDependencies
26
+
27
+ `createDefaultRuntimeDependencies(config)` returns the current default
28
+ composition:
29
+
30
+ - `config`
31
+ - `host`
32
+ - `sessions`
33
+ - `attachments`
34
+ - `tools`
35
+ - `models`
36
+ - `events`
37
+
38
+ Hosts may replace any dependency except `config` through
39
+ `RuntimeDependencyOverrides`.
40
+
41
+ ## RuntimeHost
42
+
43
+ `RuntimeHost.start(options)` accepts the current runtime and adapter boundary:
44
+
45
+ - `runtimeConfig`
46
+ - `runtimeId`
47
+ - `agentBridgeUrl`
48
+ - `agentBridgeToken`
49
+ - `eventSinkFactory`
50
+ - `modelGatewayClient`
51
+ - `sessionStore`
52
+ - `attachmentStore`
53
+ - `toolRegistry`
54
+
55
+ Hosts may use `createDefaultRuntimeDependencies(config)` for default adapters or
56
+ inject their own ports. Injected ports are responsible for preserving the same
57
+ semantic contracts described below.
58
+
59
+ `conversationContextProvider`, `skillProvider`, and `workspaceProvider` are not
60
+ `RuntimeHostStartOptions`.
61
+
62
+ ## SessionStore
63
+
64
+ `SessionStore` is the source of truth for durable session state. It owns:
65
+
66
+ - session records and snapshots
67
+ - user and assistant messages
68
+ - request stream lifecycle
69
+ - persisted request events
70
+ - request replay by `requestId`
71
+ - message deletion and session reset operations
72
+
73
+ Request event replay is append-only from the runtime perspective. Consumers
74
+ should treat event sequence order as meaningful and should not infer final
75
+ request success from a single event when later failure/completion events exist.
76
+
77
+ ## RuntimeAttachmentStore
78
+
79
+ `RuntimeAttachmentStore` owns durable request attachment storage and
80
+ session-bound reference validation:
81
+
82
+ - `saveAttachment(input)`
83
+ - `validateAttachmentReferences(attachments, options?)`
84
+ - `resolveAttachment(attachment)`
85
+ - optional `deleteAttachment(attachment, options?)`
86
+ - `deleteSessionAttachments(sessionId)`
87
+
88
+ `createDefaultRuntimeDependencies(config)` exposes this port as
89
+ `runtime.attachments`; pass it to `RuntimeHost.start(...)` as
90
+ `attachmentStore`.
91
+
92
+ Attachment references use `kind: "image" | "file"`. Supported images continue
93
+ through the model vision input. Supported document files are exposed to the
94
+ request-bound `document_reader` capability by id/name; their binary payload is
95
+ never inserted into model context. The `local-search` plugin can search bounded
96
+ filenames or text only beneath configured agent-work and workspace roots.
97
+
98
+ ## EventSink
99
+
100
+ `EventSink` is the UI/bridge event output boundary for one request. Stable
101
+ methods are:
102
+
103
+ - `publish(payload)`
104
+ - `event(name, extra)`
105
+ - `runtimeState(state)`
106
+ - `token(token)`
107
+ - `legacyToken(text)`
108
+ - `thinkingDelta(delta, accumulatedText)`
109
+ - `completed(output)`
110
+ - `failed(error, details)`
111
+ - `drain()`
112
+ - `dispose()`
113
+
114
+ `event(name, extra)` preserves the raw runtime event name in the payload while
115
+ UI-facing status helpers may add display-oriented names. Consumers that need
116
+ logic should key off raw event names and payload fields, not display strings.
117
+
118
+ Planner events follow snapshot-plus-diff semantics:
119
+
120
+ - `planner.plan.created` and `planner.plan.updated` carry the current plan
121
+ snapshot.
122
+ - `planner.plan.item.*` events are timeline/update events for individual plan
123
+ items.
124
+ - Planner payloads retain `stage=development_plan` for client compatibility.
125
+ This field is presentation metadata and does not identify a runtime loop.
126
+
127
+ These events describe canonical delegated Planner state. A `planner.graph`
128
+ advisory under `execution-agent-v1` is a passive subordinate result and does
129
+ not create `planner.plan.*` state or events.
130
+
131
+ Runtime capabilities use the stable tool event envelope. Adapter-owned
132
+ presentation metadata supplies the tool, operation and action type; target
133
+ metadata contains only resolved logical paths. Physical
134
+ roots, opaque subject identities and authored payload bodies are never exposed.
135
+ These events describe capability execution only. Only `planner.plan.*` events
136
+ report canonical item-status changes or semantic progress.
137
+
138
+ Tool events use the current tool execution boundary:
139
+
140
+ - `tool.started`
141
+ - `tool.payload.started`
142
+ - `tool.payload.completed`
143
+ - `tool.payload.failed`
144
+ - `tool.completed`
145
+
146
+ A `tool.completed` event with `ok: true` proves only that the tool step
147
+ succeeded. It does not prove the user request is complete.
148
+
149
+ ## ToolRegistry
150
+
151
+ `ToolRegistry` owns active tool capability discovery and execution:
152
+
153
+ - `listDefinitions(taskType?)`
154
+ - `getDefinition(name)`
155
+ - `getAdapter(name)`
156
+ - `hasToolsAvailable()`
157
+ - `getImplementations()`
158
+ - `execute(call, options?)`
159
+
160
+ Runtime orchestration must treat the registry as the capability authority. Tool
161
+ names, normal-invocation contracts, payload-channel specs, and plugin-provided
162
+ tools belong to the registry/tool layer, not to core orchestration. The frozen
163
+ execution policy determines whether the canonical Worker or root may bind an
164
+ offered capability; both principals use the same registry and adapter engine.
165
+
166
+ `ToolModule.adapter` is the tool-layer extension point for call-shape
167
+ normalization. Built-in tool packs and runtime plugin tools may provide an
168
+ adapter. The parser may invoke an adapter generically through the active
169
+ registry, but tool-specific aliases, compatibility rewrites, or routing from one
170
+ legacy tool shape to a current tool must live in the owning tool module or pack,
171
+ not in parser or runtime orchestration code.
172
+
173
+ ## ToolDefinition And ToolExecutionResult
174
+
175
+ `ToolDefinition.routingCapability` and `developmentRoles` are tool metadata
176
+ retained for compatibility. They must not select a request path or role.
177
+ Model-facing availability and controls come from the registered
178
+ `normalInvocation` contract.
179
+
180
+ Every plugin-handler return is normalized by `ToolRegistry` into one complete
181
+ `ToolExecutionResult`, whether the operation succeeds or fails. The selected
182
+ tool identity is Runtime-owned; plugins provide the operation result. The
183
+ public envelope contains:
184
+
185
+ - `ok`: execution success
186
+ - `tool`: the non-empty selected capability id added by `ToolRegistry`
187
+ - `output`: the textual operation result
188
+ - `progress`: step made runtime progress
189
+ - `producedNewInformation`: step revealed new information
190
+ - `actions`: tool-owned structured action summaries
191
+ - optional process and failure fields: `exitCode`, `stdout`, `stderr`, `error`,
192
+ and `errorCode`
193
+ - `data.mutationEvidence`: tool observed or applied mutation evidence
194
+ - `data.stateAlreadySatisfied`: requested state was already satisfied
195
+ - `data.hasData`: inspection returned useful data
196
+ - `data.observationMeta`: carry policy for future request context
197
+
198
+ Failed execution does not count as progress. A successful tool step proves only
199
+ the reported result, not overall completion.
200
+
201
+ The complete result is a mandatory canonical evidence object. Before capability
202
+ settlement, the Runtime validates that it contains only plain JSON-safe data and
203
+ fits the 256 KiB serialized producer boundary. Functions, symbols, accessors,
204
+ cycles, non-plain prototypes, non-finite numbers, and oversized results fail
205
+ explicitly. The Runtime does not silently truncate, partially parse, or discard
206
+ structured fields.
207
+
208
+ The registered-tool adapter wraps the complete result as
209
+ `registered_tool_execution_result_v1`; Runtime-owned rejections and generic
210
+ adapters use their corresponding canonical envelopes. The capability engine
211
+ atomically settles the operation outcome and exactly one validated canonical
212
+ adapter result in the RoleCall ledger. A settled execution cannot omit that
213
+ evidence, and a running execution cannot carry it.
214
+
215
+ Exact result projection is bound mechanically to the producing call. A direct
216
+ root keeps its strict native assistant-tool-call / linked-tool-result lane. A
217
+ delegated Worker receives its own complete adapter result through
218
+ `runtime_request_tool_results_v1`, and later payload authoring in that same call
219
+ receives the same canonical evidence. Supervisors, Planners, Reviewers, sibling
220
+ Workers, unrelated calls, and unrelated requests receive only their existing
221
+ bounded receipts or child handoffs; the exact body is not copied to them.
222
+
223
+ This lifecycle is generic for every registered plugin and must not require
224
+ plugin-specific Runtime projection code. See
225
+ [tool-execution-result-evidence-contract.md](tool-execution-result-evidence-contract.md)
226
+ for the producer rules, lifecycle, authority boundary, compaction semantics,
227
+ and compatibility guarantees.
228
+
229
+ ## SkillProvider
230
+
231
+ `SkillProvider` owns model-facing skill text:
232
+
233
+ - `getActionContext(action)`
234
+
235
+ The default provider projects this context only from the selected capability's
236
+ mapping in its loaded plugin manifest. It has no built-in, file-backed, or
237
+ composite skill source.
238
+
239
+ ## WorkspaceProvider
240
+
241
+ `WorkspaceProvider.getSystemSummary()` provides host/workspace context. This is
242
+ context only; filesystem truth for a requested mutation or verification still
243
+ comes from tool execution results.
244
+
245
+ `WorkspaceProvider` and its public adapters remain standalone public contracts;
246
+ they are not `RuntimeHost.start(...)` options.
247
+
248
+ ## ModelGatewayClient
249
+
250
+ `ModelGatewayClient` owns model invocation transport:
251
+
252
+ - `invoke(params)` for streamed/chat-style model steps
253
+ - `invokeRaw(params)` for raw payload generation
254
+
255
+ Callers provide intent fields such as `modelStep`, `agentMode`,
256
+ `modelPreference`, `modelPolicy`, and optional overrides. Model routing belongs
257
+ to the model gateway policy, not request orchestration.
258
+
259
+ Text-only message arrays retain their existing transport contract. When a
260
+ message array contains the native tool-interaction lane, it is strict: one
261
+ assistant message carries non-empty `toolCalls`, each exact call is followed in
262
+ order by its matching `role: "tool"` result, and call id, tool name, arguments,
263
+ and result content are not semantically rewritten. The gateway validates this
264
+ linkage before provider projection, and token accounting includes the complete
265
+ lane. `execution-agent-v1` uses this lane to resume the same canonical root
266
+ after direct capability settlement; it is not a second tool or evidence store.
267
+
268
+ ## Runtime Completion Semantics
269
+
270
+ The canonical root alone owns request completion and the final user-facing
271
+ response. Its frozen model-facing contract is Supervisor under the omitted
272
+ default `supervisor-worker-v1` policy and Execution Agent under the opt-in
273
+ `execution-agent-v1` policy. Planner, Worker, Reviewer, and Auditor return
274
+ bounded results to their exact callers. The RoleCall ledger validates state
275
+ transitions; capability adapters establish only their reported operation
276
+ outcomes. No layer should combine these owners into a transcript-shaped
277
+ conditional or infer completion from one successful tool event.
278
+
279
+ The default policy keeps the established normalized final-text behavior.
280
+ `execution-agent-v1` alone selects exact terminal text mode: its committed
281
+ terminal string, including raw non-empty `execution.response` output, passes
282
+ through the same finalizer without trimming. This presentation choice does not
283
+ create a policy-specific persistence or completion path.
284
+
285
+ ## Prompt And Policy Contracts
286
+
287
+ Prompt text parsed into a Supervisor, Execution Agent, delegated Planner,
288
+ Planner Graph, Worker, Reviewer, or Auditor action is part of the runtime
289
+ contract. Changing a role action, advisory result, or capability envelope is a
290
+ behavior change and requires coverage at its owning parser, ledger, or
291
+ capability boundary. `planner.graph` and `planner.decision` are distinct model
292
+ steps and contracts; neither is a compatibility alias for the other.
293
+
294
+ Prompt and policy ownership is tracked in
295
+ [runtime-prompt-policy-contracts.md](runtime-prompt-policy-contracts.md), and
296
+ runtime invariant coverage is tracked in
297
+ [runtime-invariant-coverage.md](runtime-invariant-coverage.md).
298
+
299
+ ## Stable Consumer Rule
300
+
301
+ Host applications should depend on ports, config schema, event payloads, session
302
+ snapshots, request replay, tool definitions, and tool execution results. They
303
+ should not depend on internal file layout, prompt wording, private helper
304
+ functions, or display-only event labels.
@@ -0,0 +1,151 @@
1
+ # Tool Execution Result Evidence Contract
2
+
3
+ ## Status
4
+
5
+ This document defines the stable product contract for Runtime-owned capability
6
+ result evidence. It applies equally to direct-root and delegated execution.
7
+
8
+ The contract is intentionally generic. No runtime branch may inspect a plugin
9
+ id, capability id, operation id, field name, or prompt wording to decide which
10
+ tool facts the model receives.
11
+
12
+ ## Goals
13
+
14
+ 1. Every settled capability execution owns one canonical, JSON-safe adapter
15
+ result in the RoleCall ledger.
16
+ 2. Every registered plugin result is represented by the same complete
17
+ `ToolExecutionResult` envelope, including `output`, `data`, actions, failure
18
+ fields, and execution metadata.
19
+ 3. The exact producing call can consume that result regardless of whether the
20
+ authorized principal is the direct root or a delegated Worker.
21
+ 4. Subsequent payload authoring inside the same call can consume the same
22
+ evidence without a plugin-specific bridge.
23
+ 5. Request-wide receipts, child handoffs, role authority, and completion
24
+ semantics remain unchanged.
25
+ 6. Invalid, cyclic, non-JSON-safe, or oversized results fail explicitly before
26
+ canonical settlement. Evidence is never silently truncated or partially
27
+ parsed.
28
+
29
+ ## Non-goals
30
+
31
+ - The Runtime does not decide which tool a model should select.
32
+ - The Runtime does not infer semantic completion from a successful tool result.
33
+ - The Runtime does not add retries, repeated-call guards, or plugin-specific
34
+ fallback behavior.
35
+ - The Runtime does not copy complete child evidence into a Supervisor,
36
+ Planner, Reviewer, sibling Worker, or unrelated request.
37
+ - The contract does not require capability-specific projection or plugin
38
+ migrations.
39
+
40
+ ## Public Producer Contract
41
+
42
+ Plugin handlers return `ToolImplementationOutput`. `ToolRegistry` is the sole
43
+ owner that adds the selected tool identity and produces `ToolExecutionResult`:
44
+
45
+ ```text
46
+ ToolExecutionResult
47
+ ok: boolean
48
+ tool: non-empty string
49
+ output: string
50
+ producedNewInformation: boolean
51
+ progress?: boolean
52
+ actions?: ToolActionSummary[]
53
+ exitCode?: finite number
54
+ stdout?: string
55
+ stderr?: string
56
+ data?: JSON-safe object
57
+ error?: string
58
+ errorCode?: string
59
+ ```
60
+
61
+ The registered-tool adapter wraps this value once as
62
+ `registered_tool_execution_result_v1`. Runtime-owned rejections use
63
+ `runtime_capability_rejection_v1`. Legacy or injected adapters that do not
64
+ provide an envelope are captured mechanically as
65
+ `generic_capability_result_v1`; their payload is not semantically rewritten.
66
+
67
+ All three variants are `CapabilityAdapterResult`. The capability engine must
68
+ attach one normalized variant to every settlement.
69
+
70
+ ## Validation And Bounds
71
+
72
+ The Runtime validates the result before ledger settlement:
73
+
74
+ - plain enumerable data properties only;
75
+ - JSON primitives, objects, and dense arrays only;
76
+ - finite numbers only;
77
+ - no functions, symbols, accessors, cycles, or non-plain prototypes;
78
+ - the registered result must match the public `ToolExecutionResult` fields;
79
+ - references remain bounded by the RoleCall reference contract;
80
+ - one serialized canonical adapter result is limited to 256 KiB.
81
+
82
+ The 256 KiB limit is a hard producer boundary, not a model-context truncation
83
+ rule. An over-limit result becomes an explicit technical capability failure.
84
+ The Runtime never sends a syntactically valid but incomplete object and never
85
+ pretends that omitted structured facts were observed.
86
+
87
+ Plugin results are model-facing evidence and therefore must not contain
88
+ secrets. Secret acquisition and redaction remain responsibilities of the
89
+ owning tool/host boundary; core orchestration must not guess sensitive field
90
+ semantics from arbitrary JSON keys.
91
+
92
+ ## Canonical Lifecycle
93
+
94
+ ```text
95
+ plugin handler
96
+ -> ToolRegistry creates ToolExecutionResult
97
+ -> normal invocation returns the complete result
98
+ -> registered adapter creates CapabilityAdapterResult
99
+ -> capability engine validates/captures the result
100
+ -> RoleCall reducer atomically settles outcome + exact result
101
+ -> exact producing consumer receives the result
102
+ ```
103
+
104
+ Settlement is atomic. A ledger entry cannot be `settled` without a valid
105
+ canonical adapter result. Running entries cannot contain one.
106
+
107
+ ## Model Projection And Authority
108
+
109
+ The canonical result proves only its own recorded execution and effect. Its
110
+ contents are untrusted reference data, never instructions, user intent,
111
+ authority, or proof that the whole request is complete.
112
+
113
+ Projection is deliberately exact-consumer scoped:
114
+
115
+ - `execution-agent-v1`: the active root keeps the existing provider-native
116
+ assistant-tool-call / linked-tool-result lane. Its message shape and order do
117
+ not change.
118
+ - `supervisor-worker-v1`: the Worker that produced the execution receives
119
+ `adapterResult` on its entry in `runtime_request_tool_results_v1` when it
120
+ resumes and when its result author runs.
121
+ - Capability payload authoring for that same call receives the canonical
122
+ result in `settledCapabilityResults`.
123
+ - Other calls receive the existing bounded receipt (`outcome`, effect,
124
+ `summary`, references, and allowed `referenceData`) and the normal child
125
+ handoff. They do not receive a second copy of the exact body.
126
+
127
+ This preserves least authority and prevents context presence from being
128
+ mistaken for user intent. A Worker may use exact facts to fulfill its immutable
129
+ objective, but those facts cannot broaden that objective.
130
+
131
+ ## Compaction
132
+
133
+ An exact result is a semantic-compaction source for its producing Worker. Until
134
+ a checkpoint covers that execution id, the complete result remains in the
135
+ Worker evidence block. After a validated checkpoint is committed, the exact
136
+ body and legacy `referenceData` may be replaced in model context by the
137
+ checkpoint digest plus the immutable execution receipt. The canonical ledger
138
+ entry remains unchanged.
139
+
140
+ Compaction is never a fallback for an invalid or over-limit result and never
141
+ changes execution outcome, authority, or persistence.
142
+
143
+ ## Compatibility
144
+
145
+ - Existing summaries and `referenceData` remain populated and projected.
146
+ - Existing tool events and client payloads do not change.
147
+ - Direct-root native tool linkage and exact result content remain unchanged.
148
+ - Role result, request finalization, artifact continuity, and tool-selection
149
+ contracts remain unchanged.
150
+ - Settled RoleCall execution state requires canonical result evidence for every
151
+ authorized principal.
@@ -0,0 +1,115 @@
1
+ # Troubleshooting
2
+
3
+ ## `runtime.config.json` Is Missing
4
+
5
+ The default config file is optional. For local development, prefer an ignored
6
+ local config:
7
+
8
+ ```bash
9
+ npm run init -- --provider ollama --model <model-id>
10
+ ```
11
+
12
+ ## Model Gateway Returns 500
13
+
14
+ Check whether the configured provider is installed, running, and reachable.
15
+ ABot Runtime provides the Ollama adapter; it does not install the Ollama server
16
+ or download model weights.
17
+
18
+ For Ollama, install it from the
19
+ [official download page](https://ollama.com/download), make sure its service is
20
+ running, and then pull the exact model id used by the runtime profile before
21
+ checking the API:
22
+
23
+ ```bash
24
+ ollama pull <model-id>
25
+ curl http://127.0.0.1:11434/api/tags
26
+ ```
27
+
28
+ Confirm that the response lists the same `<model-id>` configured in the model
29
+ profile. `127.0.0.1` is the runtime process's own loopback network; it is not
30
+ automatically the Windows host from WSL, the container host from inside a
31
+ container, or a remote Ollama machine. In those layouts, pass an address
32
+ reachable from the runtime to the initializer with
33
+ `--base-url http://<ollama-host>:11434`, or update
34
+ `models.providers.ollama.baseUrl` in existing runtime config. Run the
35
+ `/api/tags` check against that URL.
36
+
37
+ See [Running Locally](running-locally.md#ollama) for the complete Ollama setup
38
+ sequence.
39
+
40
+ Check gateway logs:
41
+
42
+ ```bash
43
+ tail -n 100 .runtime/shared/logs/model-gateway.jsonl
44
+ ```
45
+
46
+ If `MODEL_GATEWAY_TRACE_FILE` is set, read that file instead.
47
+
48
+ ## Missing OpenAI API Key
49
+
50
+ Set the key in the environment, not in JSON config:
51
+
52
+ ```bash
53
+ OPENAI_API_KEY=...
54
+ ```
55
+
56
+ Provider config should contain only the env var name:
57
+
58
+ ```json
59
+ {
60
+ "type": "openai",
61
+ "apiKeyEnv": "OPENAI_API_KEY"
62
+ }
63
+ ```
64
+
65
+ ## Runtime Connects But App Requests Do Not Arrive
66
+
67
+ The runtime bridge client connects outbound to `agentBridgeUrl`. Make sure the
68
+ bridge server is running, the URL is correct, and `AGENT_BRIDGE_TOKEN` matches
69
+ the bridge configuration when auth is enabled.
70
+
71
+ ## Dev And Prod Use The Same State
72
+
73
+ Check the active profile:
74
+
75
+ ```bash
76
+ echo "$LLM_RUNTIME_PROFILE"
77
+ ```
78
+
79
+ Use environment profiles to isolate state:
80
+
81
+ ```json
82
+ {
83
+ "environment": {
84
+ "default": "prod",
85
+ "profiles": {
86
+ "prod": {
87
+ "paths": {
88
+ "runtimeDir": ".runtime/prod",
89
+ "agentWorkDir": ".runtime/prod/agent-work"
90
+ }
91
+ },
92
+ "dev": {
93
+ "paths": {
94
+ "runtimeDir": ".runtime/dev",
95
+ "agentWorkDir": ".runtime/dev/agent-work"
96
+ }
97
+ }
98
+ }
99
+ }
100
+ }
101
+ ```
102
+
103
+ ## Package Smoke Checks Fail
104
+
105
+ Run the checks from a clean working tree after building:
106
+
107
+ ```bash
108
+ npm run build
109
+ npm run smoke:runtime-package
110
+ npm run check:runtime-package
111
+ npm run smoke:packed-runtime-package
112
+ ```
113
+
114
+ Do not publish if package checks include `.env`, `local/runtime.config.json`,
115
+ tests, source maps, local runtime state, or model-gateway server internals.
@@ -0,0 +1,9 @@
1
+ # Optional credentials for providers and integrations you explicitly configure.
2
+ OPENAI_API_KEY=
3
+ BRAVE_SEARCH_API_KEY=
4
+
5
+ # Optional process-level runtime overrides.
6
+ AGENT_BRIDGE_TOKEN=
7
+ LLM_RUNTIME_CONFIG_FILE=local/runtime.config.json
8
+ LLM_RUNTIME_SHARED_DIR=
9
+ NODE_ENV=development
@@ -0,0 +1,24 @@
1
+ import {
2
+ createDefaultRuntimeDependencies,
3
+ loadRuntimeConfig,
4
+ } from "@abot-ai/runtime/runtime";
5
+
6
+ const config = loadRuntimeConfig({ rootDir: process.cwd() });
7
+ const runtime = createDefaultRuntimeDependencies(config);
8
+
9
+ console.log({
10
+ runtimeId: config.runtimeId,
11
+ modelGatewayUrl: config.modelGatewayUrl,
12
+ paths: {
13
+ runtimeDir: config.paths.runtimeDir,
14
+ attachmentsDir: config.paths.attachmentsDir,
15
+ },
16
+ dependencies: {
17
+ host: Boolean(runtime.host),
18
+ sessions: Boolean(runtime.sessions),
19
+ attachments: Boolean(runtime.attachments),
20
+ tools: Boolean(runtime.tools),
21
+ models: Boolean(runtime.models),
22
+ events: Boolean(runtime.events),
23
+ },
24
+ });
@@ -0,0 +1,28 @@
1
+ {
2
+ "label": "Replace with your model",
3
+ "provider": "provider",
4
+ "model": "replace-with-model-id",
5
+ "contextWindowTokens": 32768,
6
+ "context": {
7
+ "formatTokenAccounting": {
8
+ "mode": "estimate"
9
+ }
10
+ },
11
+ "calibration": {
12
+ "supervisor.decision": { "format": "json" },
13
+ "worker.decision": { "format": "json" },
14
+ "planner.decision": { "format": "json" },
15
+ "planner.graph": { "format": "json" },
16
+ "reviewer.decision": { "format": "json" },
17
+ "degraded.finalization": { "format": "json" },
18
+ "execution.decision": { "format": "json" },
19
+ "auditor.decision": { "format": "json" },
20
+ "context.compact": { "format": "json" },
21
+ "toolPayload.raw": {
22
+ "instructions": [
23
+ "Return only the literal payload text requested for the selected tool.",
24
+ "Do not include JSON wrappers, tool names, params, status text, markdown fences, or commentary."
25
+ ]
26
+ }
27
+ }
28
+ }
@@ -0,0 +1,42 @@
1
+ {
2
+ "models": {
3
+ "defaults": {
4
+ "profileId": "default",
5
+ "steps": {
6
+ "supervisor.decision": "supervisor.decision",
7
+ "supervisor.response": "default",
8
+ "worker.decision": "worker.decision",
9
+ "worker.result": "default",
10
+ "planner.decision": "planner.decision",
11
+ "planner.graph": "planner.graph",
12
+ "reviewer.decision": "reviewer.decision",
13
+ "degraded.finalization": "degraded.finalization",
14
+ "execution.decision": "execution.decision",
15
+ "execution.response": "default",
16
+ "auditor.decision": "auditor.decision",
17
+ "context.compact": "context.compact",
18
+ "tool_payload.raw": "toolPayload.raw"
19
+ }
20
+ }
21
+ },
22
+ "context": {
23
+ "outputReserveTokens": 4096,
24
+ "safetyReserveTokens": 1200,
25
+ "attachmentReserveTokens": 1024
26
+ },
27
+ "steps": {
28
+ "supervisor.decision": { "timeoutMs": 90000 },
29
+ "supervisor.response": { "timeoutMs": 90000 },
30
+ "worker.decision": { "timeoutMs": 90000 },
31
+ "worker.result": { "timeoutMs": 90000 },
32
+ "planner.decision": { "timeoutMs": 90000 },
33
+ "planner.graph": { "timeoutMs": 90000 },
34
+ "reviewer.decision": { "timeoutMs": 90000 },
35
+ "degraded.finalization": { "timeoutMs": 90000 },
36
+ "execution.decision": { "timeoutMs": 90000 },
37
+ "execution.response": { "timeoutMs": 90000 },
38
+ "auditor.decision": { "timeoutMs": 90000 },
39
+ "context.compact": { "timeoutMs": 90000 },
40
+ "tool_payload.raw": { "timeoutMs": 90000 }
41
+ }
42
+ }