@oscharko-dev/keiko 1.3.1 → 1.3.2

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 (356) hide show
  1. package/README.md +14 -1
  2. package/dist/ui/csp-hashes.json +7 -7
  3. package/dist/ui/static/404.html +1 -1
  4. package/dist/ui/static/__next.__PAGE__.txt +4 -4
  5. package/dist/ui/static/__next._full.txt +4 -4
  6. package/dist/ui/static/__next._tree.txt +1 -1
  7. package/dist/ui/static/_next/static/chunks/01f2r2l4gzscm.css +4 -0
  8. package/dist/ui/static/_next/static/chunks/{3_10vm9g45_8y.js → 06j35fs_cota7.js} +1 -1
  9. package/dist/ui/static/_next/static/chunks/0egrai9cigb1t.js +1 -0
  10. package/dist/ui/static/_next/static/chunks/0gzualdhleagc.js +1 -0
  11. package/dist/ui/static/_next/static/chunks/{3_qhvykv4ncye.js → 0wsxu0g-c4dbf.js} +1 -1
  12. package/dist/ui/static/_next/static/chunks/{1jh83l6i471hs.js → 1axubnnxhxh-s.js} +1 -1
  13. package/dist/ui/static/_next/static/chunks/1gnjh00dyjkye.js +1 -0
  14. package/dist/ui/static/_next/static/chunks/{21yx7habl0roe.js → 1jgm4793jm1pv.js} +1 -1
  15. package/dist/ui/static/_next/static/chunks/1livbv_zx95bb.js +1 -0
  16. package/dist/ui/static/_next/static/chunks/1lpdde9w2vl93.js +1 -0
  17. package/dist/ui/static/_next/static/chunks/2muaa_i0plkwf.js +1 -0
  18. package/dist/ui/static/_next/static/chunks/{3dgn8o9f1kc8m.js → 3_2d222-16b9x.js} +1 -1
  19. package/dist/ui/static/_next/static/chunks/{3jgowfcbukuu6.js → 3__pdxfo3bpc1.js} +1 -1
  20. package/dist/ui/static/_next/static/chunks/{3tl76hukh2-pb.js → 3hw8-lgs3prjc.js} +1 -1
  21. package/dist/ui/static/_next/static/chunks/{26dysjhfplkru.js → 3pe5ji2-axln6.js} +1 -1
  22. package/dist/ui/static/_next/static/chunks/{1nz7wziy2b21i.js → 3qgbq3-b3p7a3.js} +1 -1
  23. package/dist/ui/static/_next/static/chunks/{3e-3pvlfnqvhc.js → 3ts6g_psw2r__.js} +1 -1
  24. package/dist/ui/static/_next/static/chunks/3ulj-p08q5sh1.js +1 -0
  25. package/dist/ui/static/_next/static/chunks/3yaa0g7ymbq5e.js +1 -0
  26. package/dist/ui/static/_not-found/__next._full.txt +1 -1
  27. package/dist/ui/static/_not-found/__next._not-found.__PAGE__.txt +1 -1
  28. package/dist/ui/static/_not-found/__next._tree.txt +1 -1
  29. package/dist/ui/static/_not-found.html +1 -1
  30. package/dist/ui/static/_not-found.txt +1 -1
  31. package/dist/ui/static/atlassian-connectors/__next._full.txt +1 -1
  32. package/dist/ui/static/atlassian-connectors/__next._tree.txt +1 -1
  33. package/dist/ui/static/atlassian-connectors/__next.atlassian-connectors.__PAGE__.txt +1 -1
  34. package/dist/ui/static/atlassian-connectors.html +1 -1
  35. package/dist/ui/static/atlassian-connectors.txt +1 -1
  36. package/dist/ui/static/index.html +1 -1
  37. package/dist/ui/static/index.txt +4 -4
  38. package/dist/ui/static/launch/__next._full.txt +4 -4
  39. package/dist/ui/static/launch/__next._tree.txt +1 -1
  40. package/dist/ui/static/launch/__next.launch.__PAGE__.txt +4 -4
  41. package/dist/ui/static/launch.html +1 -1
  42. package/dist/ui/static/launch.txt +4 -4
  43. package/dist/ui/static/local-knowledge/__next._full.txt +4 -4
  44. package/dist/ui/static/local-knowledge/__next._tree.txt +1 -1
  45. package/dist/ui/static/local-knowledge/__next.local-knowledge.__PAGE__.txt +4 -4
  46. package/dist/ui/static/local-knowledge/capsule/__next._full.txt +1 -1
  47. package/dist/ui/static/local-knowledge/capsule/__next._tree.txt +1 -1
  48. package/dist/ui/static/local-knowledge/capsule/__next.local-knowledge.capsule.__PAGE__.txt +1 -1
  49. package/dist/ui/static/local-knowledge/capsule.html +1 -1
  50. package/dist/ui/static/local-knowledge/capsule.txt +1 -1
  51. package/dist/ui/static/local-knowledge.html +1 -1
  52. package/dist/ui/static/local-knowledge.txt +4 -4
  53. package/node_modules/@oscharko-dev/keiko-activity-log/dist/reader/support-code-inventory-data.generated.json +14 -1
  54. package/node_modules/@oscharko-dev/keiko-activity-log/dist/reader/support-code-inventory.generated.d.ts +5 -0
  55. package/node_modules/@oscharko-dev/keiko-activity-log/dist/reader/support-code-inventory.generated.d.ts.map +1 -1
  56. package/node_modules/@oscharko-dev/keiko-activity-log/dist/reader/support-code-inventory.generated.js +6 -0
  57. package/node_modules/@oscharko-dev/keiko-activity-log/dist/reader/support-registry-history.generated.d.ts +7 -0
  58. package/node_modules/@oscharko-dev/keiko-activity-log/dist/reader/support-registry-history.generated.d.ts.map +1 -1
  59. package/node_modules/@oscharko-dev/keiko-activity-log/dist/reader/support-registry-history.generated.js +9 -1
  60. package/node_modules/@oscharko-dev/keiko-activity-log/package.json +3 -3
  61. package/node_modules/@oscharko-dev/keiko-cli/dist/lifecycle.d.ts +2 -0
  62. package/node_modules/@oscharko-dev/keiko-cli/dist/lifecycle.d.ts.map +1 -1
  63. package/node_modules/@oscharko-dev/keiko-cli/dist/lifecycle.js +38 -2
  64. package/node_modules/@oscharko-dev/keiko-cli/package.json +15 -15
  65. package/node_modules/@oscharko-dev/keiko-connectors/dist/version.d.ts +1 -1
  66. package/node_modules/@oscharko-dev/keiko-connectors/dist/version.js +1 -1
  67. package/node_modules/@oscharko-dev/keiko-connectors/package.json +3 -3
  68. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-failure-class-contracts.d.ts +24 -4
  69. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-failure-class-contracts.d.ts.map +1 -1
  70. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-failure-class-contracts.js +29 -1
  71. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-failure-class-coverage.generated.json +128 -3
  72. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-identity.generated.d.ts +1 -1
  73. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-identity.generated.js +1 -1
  74. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-operation-surfaces.generated.json +2 -0
  75. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-operations.generated.d.ts +103 -3
  76. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-operations.generated.d.ts.map +1 -1
  77. package/node_modules/@oscharko-dev/keiko-contracts/dist/activity-log-operations.generated.js +107 -1
  78. package/node_modules/@oscharko-dev/keiko-contracts/dist/diagnostics.d.ts +5 -1
  79. package/node_modules/@oscharko-dev/keiko-contracts/dist/diagnostics.d.ts.map +1 -1
  80. package/node_modules/@oscharko-dev/keiko-contracts/dist/diagnostics.js +8 -0
  81. package/node_modules/@oscharko-dev/keiko-contracts/dist/editor-agent.d.ts +48 -1
  82. package/node_modules/@oscharko-dev/keiko-contracts/dist/editor-agent.d.ts.map +1 -1
  83. package/node_modules/@oscharko-dev/keiko-contracts/dist/editor-agent.js +85 -6
  84. package/node_modules/@oscharko-dev/keiko-contracts/dist/governed-tool-bridge.d.ts +14 -1
  85. package/node_modules/@oscharko-dev/keiko-contracts/dist/governed-tool-bridge.d.ts.map +1 -1
  86. package/node_modules/@oscharko-dev/keiko-contracts/dist/governed-tool-bridge.js +23 -0
  87. package/node_modules/@oscharko-dev/keiko-contracts/dist/governed-tool-catalog.d.ts +23 -0
  88. package/node_modules/@oscharko-dev/keiko-contracts/dist/governed-tool-catalog.d.ts.map +1 -1
  89. package/node_modules/@oscharko-dev/keiko-contracts/dist/governed-tool-catalog.js +29 -0
  90. package/node_modules/@oscharko-dev/keiko-contracts/dist/version.d.ts +2 -2
  91. package/node_modules/@oscharko-dev/keiko-contracts/dist/version.js +2 -2
  92. package/node_modules/@oscharko-dev/keiko-contracts/package.json +1 -1
  93. package/node_modules/@oscharko-dev/keiko-evaluations/package.json +9 -9
  94. package/node_modules/@oscharko-dev/keiko-evidence/dist/version.d.ts +1 -1
  95. package/node_modules/@oscharko-dev/keiko-evidence/dist/version.js +1 -1
  96. package/node_modules/@oscharko-dev/keiko-evidence/package.json +4 -4
  97. package/node_modules/@oscharko-dev/keiko-git/dist/version.d.ts +1 -1
  98. package/node_modules/@oscharko-dev/keiko-git/dist/version.js +1 -1
  99. package/node_modules/@oscharko-dev/keiko-git/package.json +1 -1
  100. package/node_modules/@oscharko-dev/keiko-harness/dist/version.d.ts +1 -1
  101. package/node_modules/@oscharko-dev/keiko-harness/dist/version.js +1 -1
  102. package/node_modules/@oscharko-dev/keiko-harness/package.json +7 -7
  103. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/version.d.ts +1 -1
  104. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/version.js +1 -1
  105. package/node_modules/@oscharko-dev/keiko-local-knowledge/package.json +5 -5
  106. package/node_modules/@oscharko-dev/keiko-memory-capture/dist/version.d.ts +1 -1
  107. package/node_modules/@oscharko-dev/keiko-memory-capture/dist/version.js +1 -1
  108. package/node_modules/@oscharko-dev/keiko-memory-capture/package.json +3 -3
  109. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/version.d.ts +1 -1
  110. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/version.js +1 -1
  111. package/node_modules/@oscharko-dev/keiko-memory-consolidation/package.json +3 -3
  112. package/node_modules/@oscharko-dev/keiko-memory-governance/dist/version.d.ts +1 -1
  113. package/node_modules/@oscharko-dev/keiko-memory-governance/dist/version.js +1 -1
  114. package/node_modules/@oscharko-dev/keiko-memory-governance/package.json +3 -3
  115. package/node_modules/@oscharko-dev/keiko-memory-retrieval/dist/version.d.ts +1 -1
  116. package/node_modules/@oscharko-dev/keiko-memory-retrieval/dist/version.js +1 -1
  117. package/node_modules/@oscharko-dev/keiko-memory-retrieval/package.json +3 -3
  118. package/node_modules/@oscharko-dev/keiko-memory-vault/dist/version.d.ts +1 -1
  119. package/node_modules/@oscharko-dev/keiko-memory-vault/dist/version.js +1 -1
  120. package/node_modules/@oscharko-dev/keiko-memory-vault/package.json +3 -3
  121. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/gateway.d.ts +10 -7
  122. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/gateway.d.ts.map +1 -1
  123. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/http.d.ts.map +1 -1
  124. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/http.js +20 -4
  125. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/index.d.ts +1 -1
  126. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/index.d.ts.map +1 -1
  127. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/index.js +1 -1
  128. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/normalize.d.ts +1 -1
  129. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/normalize.d.ts.map +1 -1
  130. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/normalize.js +24 -3
  131. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/observability.d.ts.map +1 -1
  132. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/observability.js +8 -0
  133. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/openai-adapter.d.ts +7 -1
  134. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/openai-adapter.d.ts.map +1 -1
  135. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/openai-adapter.js +70 -12
  136. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/toolCatalogBridge.d.ts.map +1 -1
  137. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/toolCatalogBridge.js +24 -6
  138. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/version.d.ts +1 -1
  139. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/version.js +1 -1
  140. package/node_modules/@oscharko-dev/keiko-model-gateway/package.json +4 -4
  141. package/node_modules/@oscharko-dev/keiko-quality-intelligence/package.json +3 -3
  142. package/node_modules/@oscharko-dev/keiko-sandbox/package.json +2 -2
  143. package/node_modules/@oscharko-dev/keiko-sdk/package.json +9 -9
  144. package/node_modules/@oscharko-dev/keiko-security/dist/redaction-code.d.ts +6 -0
  145. package/node_modules/@oscharko-dev/keiko-security/dist/redaction-code.d.ts.map +1 -1
  146. package/node_modules/@oscharko-dev/keiko-security/dist/redaction-diff.d.ts.map +1 -1
  147. package/node_modules/@oscharko-dev/keiko-security/dist/redaction-diff.js +77 -9
  148. package/node_modules/@oscharko-dev/keiko-security/dist/redaction.d.ts +12 -3
  149. package/node_modules/@oscharko-dev/keiko-security/dist/redaction.d.ts.map +1 -1
  150. package/node_modules/@oscharko-dev/keiko-security/dist/redaction.js +32 -5
  151. package/node_modules/@oscharko-dev/keiko-security/dist/version.d.ts +1 -1
  152. package/node_modules/@oscharko-dev/keiko-security/dist/version.js +1 -1
  153. package/node_modules/@oscharko-dev/keiko-security/package.json +2 -2
  154. package/node_modules/@oscharko-dev/keiko-server/dist/agent-run-governance.d.ts.map +1 -1
  155. package/node_modules/@oscharko-dev/keiko-server/dist/agent-run-governance.js +4 -1
  156. package/node_modules/@oscharko-dev/keiko-server/dist/browser.d.ts.map +1 -1
  157. package/node_modules/@oscharko-dev/keiko-server/dist/browser.js +5 -5
  158. package/node_modules/@oscharko-dev/keiko-server/dist/chat-stream-handlers.js +4 -4
  159. package/node_modules/@oscharko-dev/keiko-server/dist/coding-app-session/codingRunSessionLease.d.ts +13 -2
  160. package/node_modules/@oscharko-dev/keiko-server/dist/coding-app-session/codingRunSessionLease.d.ts.map +1 -1
  161. package/node_modules/@oscharko-dev/keiko-server/dist/coding-app-session/codingRunSessionLease.js +8 -2
  162. package/node_modules/@oscharko-dev/keiko-server/dist/coding-app-session/sessionStreamWriter.d.ts +3 -2
  163. package/node_modules/@oscharko-dev/keiko-server/dist/coding-app-session/sessionStreamWriter.d.ts.map +1 -1
  164. package/node_modules/@oscharko-dev/keiko-server/dist/coding-app-session/sessionStreamWriter.js +4 -3
  165. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeControlPlane.d.ts +5 -0
  166. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeControlPlane.d.ts.map +1 -1
  167. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeControlPlane.js +9 -0
  168. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeOrchestrator.d.ts +25 -0
  169. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeOrchestrator.d.ts.map +1 -1
  170. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeOrchestrator.js +127 -28
  171. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeRoutes.d.ts.map +1 -1
  172. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeRoutes.js +3 -7
  173. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingSafeActivityProjection.js +25 -6
  174. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolFacade.js +2 -2
  175. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolInvocationRegistry.d.ts +12 -1
  176. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolInvocationRegistry.d.ts.map +1 -1
  177. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolInvocationRegistry.js +14 -2
  178. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolIpc.d.ts +8 -0
  179. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolIpc.d.ts.map +1 -1
  180. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolIpc.js +14 -2
  181. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolNativeEffect.d.ts.map +1 -1
  182. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolNativeEffect.js +6 -1
  183. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolReplacementEdits.d.ts +3 -3
  184. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolReplacementEdits.d.ts.map +1 -1
  185. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingToolReplacementEdits.js +28 -13
  186. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/nativeRuntimeProcessTree.d.ts +4 -0
  187. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/nativeRuntimeProcessTree.d.ts.map +1 -1
  188. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/nativeRuntimeProcessTree.js +53 -6
  189. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeHttpClient.js +3 -0
  190. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeLaunchProfile.d.ts +7 -1
  191. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeLaunchProfile.d.ts.map +1 -1
  192. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeLaunchProfile.js +8 -1
  193. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeNativePolicy.d.ts +3 -3
  194. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeNativePolicy.d.ts.map +1 -1
  195. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeNativePolicy.js +4 -1
  196. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeProtocol.d.ts +17 -7
  197. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeProtocol.d.ts.map +1 -1
  198. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeProtocol.js +36 -16
  199. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRipgrepLaunch.d.ts +9 -7
  200. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRipgrepLaunch.d.ts.map +1 -1
  201. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRipgrepLaunch.js +53 -12
  202. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRunStateSweep.d.ts +27 -0
  203. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRunStateSweep.d.ts.map +1 -0
  204. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRunStateSweep.js +114 -0
  205. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRuntimeAdapter.d.ts +12 -0
  206. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRuntimeAdapter.d.ts.map +1 -1
  207. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRuntimeAdapter.js +62 -2
  208. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRuntimeComposition.d.ts +8 -0
  209. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRuntimeComposition.d.ts.map +1 -1
  210. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeRuntimeComposition.js +52 -8
  211. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeToolSchemas.d.ts +7 -7
  212. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeToolSchemas.d.ts.map +1 -1
  213. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeToolSchemas.js +7 -2
  214. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeV2History.d.ts +23 -2
  215. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeV2History.d.ts.map +1 -1
  216. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeV2History.js +145 -55
  217. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeV2HttpClient.d.ts +11 -0
  218. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeV2HttpClient.d.ts.map +1 -1
  219. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeV2HttpClient.js +35 -11
  220. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeV2LiveText.d.ts +5 -0
  221. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeV2LiveText.d.ts.map +1 -1
  222. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/opencodeV2LiveText.js +7 -0
  223. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/productionCodingRuntimeHost.js +1 -0
  224. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/productionCodingRuntimeResolver.d.ts +5 -0
  225. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/productionCodingRuntimeResolver.d.ts.map +1 -1
  226. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/productionCodingRuntimeResolver.js +10 -2
  227. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/productionOpenCodeBackend.d.ts.map +1 -1
  228. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/productionOpenCodeBackend.js +13 -2
  229. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/productionRuntimeWorkspaceAuthority.d.ts.map +1 -1
  230. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/productionRuntimeWorkspaceAuthority.js +3 -1
  231. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/runtimeProcessSupervisor.d.ts +3 -0
  232. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/runtimeProcessSupervisor.d.ts.map +1 -1
  233. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/runtimeProcessSupervisor.js +21 -3
  234. package/node_modules/@oscharko-dev/keiko-server/dist/coding-sidecar-gateway.d.ts.map +1 -1
  235. package/node_modules/@oscharko-dev/keiko-server/dist/coding-sidecar-gateway.js +96 -23
  236. package/node_modules/@oscharko-dev/keiko-server/dist/coding-sidecar-tool-facade.js +2 -2
  237. package/node_modules/@oscharko-dev/keiko-server/dist/command-runner-routes.d.ts.map +1 -1
  238. package/node_modules/@oscharko-dev/keiko-server/dist/command-runner-routes.js +4 -4
  239. package/node_modules/@oscharko-dev/keiko-server/dist/deps.d.ts +1 -3
  240. package/node_modules/@oscharko-dev/keiko-server/dist/deps.d.ts.map +1 -1
  241. package/node_modules/@oscharko-dev/keiko-server/dist/deps.js +2 -80
  242. package/node_modules/@oscharko-dev/keiko-server/dist/diagnostics-log.d.ts +1 -1
  243. package/node_modules/@oscharko-dev/keiko-server/dist/diagnostics-log.d.ts.map +1 -1
  244. package/node_modules/@oscharko-dev/keiko-server/dist/diagnostics-log.js +8 -2
  245. package/node_modules/@oscharko-dev/keiko-server/dist/editor/agentRoutes.d.ts.map +1 -1
  246. package/node_modules/@oscharko-dev/keiko-server/dist/editor/agentRoutes.js +12 -6
  247. package/node_modules/@oscharko-dev/keiko-server/dist/editor/dap/dapDebugRoutes.js +5 -5
  248. package/node_modules/@oscharko-dev/keiko-server/dist/editor/settings/editorSettingsEvents.js +2 -2
  249. package/node_modules/@oscharko-dev/keiko-server/dist/editor/snippets/workspaceSnippetsRoutes.js +3 -3
  250. package/node_modules/@oscharko-dev/keiko-server/dist/editor/verificationRoutes.d.ts.map +1 -1
  251. package/node_modules/@oscharko-dev/keiko-server/dist/editor/verificationRoutes.js +9 -8
  252. package/node_modules/@oscharko-dev/keiko-server/dist/editor/watch/workspaceWatchRoutes.js +6 -6
  253. package/node_modules/@oscharko-dev/keiko-server/dist/gateway-readiness.d.ts.map +1 -1
  254. package/node_modules/@oscharko-dev/keiko-server/dist/gateway-readiness.js +89 -5
  255. package/node_modules/@oscharko-dev/keiko-server/dist/gitDiffTruncation.d.ts +2 -0
  256. package/node_modules/@oscharko-dev/keiko-server/dist/gitDiffTruncation.d.ts.map +1 -0
  257. package/node_modules/@oscharko-dev/keiko-server/dist/gitDiffTruncation.js +78 -0
  258. package/node_modules/@oscharko-dev/keiko-server/dist/gitDiffView.d.ts +9 -0
  259. package/node_modules/@oscharko-dev/keiko-server/dist/gitDiffView.d.ts.map +1 -0
  260. package/node_modules/@oscharko-dev/keiko-server/dist/gitDiffView.js +54 -0
  261. package/node_modules/@oscharko-dev/keiko-server/dist/gitRoutes.d.ts.map +1 -1
  262. package/node_modules/@oscharko-dev/keiko-server/dist/gitRoutes.js +27 -3
  263. package/node_modules/@oscharko-dev/keiko-server/dist/qualityIntelligence/runRoutes.js +3 -3
  264. package/node_modules/@oscharko-dev/keiko-server/dist/redaction-secrets.d.ts +13 -0
  265. package/node_modules/@oscharko-dev/keiko-server/dist/redaction-secrets.d.ts.map +1 -0
  266. package/node_modules/@oscharko-dev/keiko-server/dist/redaction-secrets.js +85 -0
  267. package/node_modules/@oscharko-dev/keiko-server/dist/relationship-activity-broadcast.d.ts +1 -1
  268. package/node_modules/@oscharko-dev/keiko-server/dist/relationship-activity-broadcast.d.ts.map +1 -1
  269. package/node_modules/@oscharko-dev/keiko-server/dist/relationship-activity-broadcast.js +4 -4
  270. package/node_modules/@oscharko-dev/keiko-server/dist/relationship-handlers.js +3 -3
  271. package/node_modules/@oscharko-dev/keiko-server/dist/run-handlers.d.ts.map +1 -1
  272. package/node_modules/@oscharko-dev/keiko-server/dist/run-handlers.js +4 -14
  273. package/node_modules/@oscharko-dev/keiko-server/dist/runtime/containerRoutes.d.ts.map +1 -1
  274. package/node_modules/@oscharko-dev/keiko-server/dist/runtime/containerRoutes.js +4 -4
  275. package/node_modules/@oscharko-dev/keiko-server/dist/sse-write.d.ts +42 -18
  276. package/node_modules/@oscharko-dev/keiko-server/dist/sse-write.d.ts.map +1 -1
  277. package/node_modules/@oscharko-dev/keiko-server/dist/sse-write.js +122 -35
  278. package/node_modules/@oscharko-dev/keiko-server/dist/sse.d.ts +6 -4
  279. package/node_modules/@oscharko-dev/keiko-server/dist/sse.d.ts.map +1 -1
  280. package/node_modules/@oscharko-dev/keiko-server/dist/sse.js +13 -29
  281. package/node_modules/@oscharko-dev/keiko-server/dist/terminal-routes.d.ts.map +1 -1
  282. package/node_modules/@oscharko-dev/keiko-server/dist/terminal-routes.js +5 -5
  283. package/node_modules/@oscharko-dev/keiko-server/dist/tool-catalog/catalogToolFacadeBridge.d.ts.map +1 -1
  284. package/node_modules/@oscharko-dev/keiko-server/dist/tool-catalog/catalogToolFacadeBridge.js +4 -3
  285. package/node_modules/@oscharko-dev/keiko-server/dist/tool-catalog/catalogToolLifecycle.d.ts.map +1 -1
  286. package/node_modules/@oscharko-dev/keiko-server/dist/tool-catalog/catalogToolLifecycle.js +15 -1
  287. package/node_modules/@oscharko-dev/keiko-server/dist/tool-catalog/catalogToolRuntimeAuthority.d.ts +1 -1
  288. package/node_modules/@oscharko-dev/keiko-server/dist/tool-catalog/catalogToolRuntimeAuthority.d.ts.map +1 -1
  289. package/node_modules/@oscharko-dev/keiko-server/dist/tool-catalog/catalogToolRuntimeAuthority.js +19 -5
  290. package/node_modules/@oscharko-dev/keiko-server/package.json +23 -23
  291. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/arguments.d.ts +1 -1
  292. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/arguments.d.ts.map +1 -1
  293. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/arguments.js +2 -1
  294. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/descriptor.d.ts +2 -2
  295. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/descriptor.d.ts.map +1 -1
  296. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/descriptor.js +6 -5
  297. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/json.d.ts +9 -3
  298. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/json.d.ts.map +1 -1
  299. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/json.js +19 -8
  300. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/opencode.d.ts.map +1 -1
  301. package/node_modules/@oscharko-dev/keiko-tool-catalog/dist/opencode.js +6 -4
  302. package/node_modules/@oscharko-dev/keiko-tool-catalog/package.json +3 -3
  303. package/node_modules/@oscharko-dev/keiko-tools/dist/version.d.ts +1 -1
  304. package/node_modules/@oscharko-dev/keiko-tools/dist/version.js +1 -1
  305. package/node_modules/@oscharko-dev/keiko-tools/package.json +7 -7
  306. package/node_modules/@oscharko-dev/keiko-verification/package.json +5 -5
  307. package/node_modules/@oscharko-dev/keiko-workflows/package.json +10 -10
  308. package/node_modules/@oscharko-dev/keiko-workspace/dist/version.d.ts +1 -1
  309. package/node_modules/@oscharko-dev/keiko-workspace/dist/version.js +1 -1
  310. package/node_modules/@oscharko-dev/keiko-workspace/package.json +3 -3
  311. package/package.json +27 -27
  312. package/release-impact.catalog.json +70 -0
  313. package/vendor/oscharko-dev-keiko-activity-log-1.3.2.tgz +0 -0
  314. package/vendor/oscharko-dev-keiko-cli-1.3.2.tgz +0 -0
  315. package/vendor/{oscharko-dev-keiko-connectors-1.3.1.tgz → oscharko-dev-keiko-connectors-1.3.2.tgz} +0 -0
  316. package/vendor/oscharko-dev-keiko-contracts-1.3.2.tgz +0 -0
  317. package/vendor/{oscharko-dev-keiko-evaluations-1.3.1.tgz → oscharko-dev-keiko-evaluations-1.3.2.tgz} +0 -0
  318. package/vendor/{oscharko-dev-keiko-evidence-1.3.1.tgz → oscharko-dev-keiko-evidence-1.3.2.tgz} +0 -0
  319. package/vendor/{oscharko-dev-keiko-git-1.3.1.tgz → oscharko-dev-keiko-git-1.3.2.tgz} +0 -0
  320. package/vendor/{oscharko-dev-keiko-harness-1.3.1.tgz → oscharko-dev-keiko-harness-1.3.2.tgz} +0 -0
  321. package/vendor/{oscharko-dev-keiko-local-knowledge-1.3.1.tgz → oscharko-dev-keiko-local-knowledge-1.3.2.tgz} +0 -0
  322. package/vendor/{oscharko-dev-keiko-memory-capture-1.3.1.tgz → oscharko-dev-keiko-memory-capture-1.3.2.tgz} +0 -0
  323. package/vendor/{oscharko-dev-keiko-memory-consolidation-1.3.1.tgz → oscharko-dev-keiko-memory-consolidation-1.3.2.tgz} +0 -0
  324. package/vendor/{oscharko-dev-keiko-memory-governance-1.3.1.tgz → oscharko-dev-keiko-memory-governance-1.3.2.tgz} +0 -0
  325. package/vendor/{oscharko-dev-keiko-memory-retrieval-1.3.1.tgz → oscharko-dev-keiko-memory-retrieval-1.3.2.tgz} +0 -0
  326. package/vendor/{oscharko-dev-keiko-memory-vault-1.3.1.tgz → oscharko-dev-keiko-memory-vault-1.3.2.tgz} +0 -0
  327. package/vendor/oscharko-dev-keiko-model-gateway-1.3.2.tgz +0 -0
  328. package/vendor/{oscharko-dev-keiko-quality-intelligence-1.3.1.tgz → oscharko-dev-keiko-quality-intelligence-1.3.2.tgz} +0 -0
  329. package/vendor/{oscharko-dev-keiko-sandbox-1.3.1.tgz → oscharko-dev-keiko-sandbox-1.3.2.tgz} +0 -0
  330. package/vendor/{oscharko-dev-keiko-sdk-1.3.1.tgz → oscharko-dev-keiko-sdk-1.3.2.tgz} +0 -0
  331. package/vendor/oscharko-dev-keiko-security-1.3.2.tgz +0 -0
  332. package/vendor/oscharko-dev-keiko-server-1.3.2.tgz +0 -0
  333. package/vendor/oscharko-dev-keiko-tool-catalog-1.3.2.tgz +0 -0
  334. package/vendor/{oscharko-dev-keiko-tools-1.3.1.tgz → oscharko-dev-keiko-tools-1.3.2.tgz} +0 -0
  335. package/vendor/{oscharko-dev-keiko-verification-1.3.1.tgz → oscharko-dev-keiko-verification-1.3.2.tgz} +0 -0
  336. package/vendor/{oscharko-dev-keiko-workflows-1.3.1.tgz → oscharko-dev-keiko-workflows-1.3.2.tgz} +0 -0
  337. package/vendor/{oscharko-dev-keiko-workspace-1.3.1.tgz → oscharko-dev-keiko-workspace-1.3.2.tgz} +0 -0
  338. package/dist/ui/static/_next/static/chunks/0dq9bimpknhi-.js +0 -1
  339. package/dist/ui/static/_next/static/chunks/1cirwobl5ywpw.js +0 -1
  340. package/dist/ui/static/_next/static/chunks/1ufe9d586c16n.js +0 -1
  341. package/dist/ui/static/_next/static/chunks/1xyltb603pg9u.css +0 -4
  342. package/dist/ui/static/_next/static/chunks/2ajat_rv2v0wp.js +0 -1
  343. package/dist/ui/static/_next/static/chunks/2bm_bps837c8s.js +0 -1
  344. package/dist/ui/static/_next/static/chunks/2l0_e_qyhvve_.js +0 -1
  345. package/dist/ui/static/_next/static/chunks/3-ejbbkmhwal-.js +0 -1
  346. package/dist/ui/static/_next/static/chunks/4598s2z_w_1la.js +0 -1
  347. package/vendor/oscharko-dev-keiko-activity-log-1.3.1.tgz +0 -0
  348. package/vendor/oscharko-dev-keiko-cli-1.3.1.tgz +0 -0
  349. package/vendor/oscharko-dev-keiko-contracts-1.3.1.tgz +0 -0
  350. package/vendor/oscharko-dev-keiko-model-gateway-1.3.1.tgz +0 -0
  351. package/vendor/oscharko-dev-keiko-security-1.3.1.tgz +0 -0
  352. package/vendor/oscharko-dev-keiko-server-1.3.1.tgz +0 -0
  353. package/vendor/oscharko-dev-keiko-tool-catalog-1.3.1.tgz +0 -0
  354. /package/dist/ui/static/_next/static/{UsrqVgAeCxovpV7C_di1N → xKDN0SO4oRp9dU6qR6ood}/_buildManifest.js +0 -0
  355. /package/dist/ui/static/_next/static/{UsrqVgAeCxovpV7C_di1N → xKDN0SO4oRp9dU6qR6ood}/_clientMiddlewareManifest.js +0 -0
  356. /package/dist/ui/static/_next/static/{UsrqVgAeCxovpV7C_di1N → xKDN0SO4oRp9dU6qR6ood}/_ssgManifest.js +0 -0
@@ -1,10 +1,11 @@
1
1
  import type { ServerResponse } from "node:http";
2
2
  import { type ServerDiagnosticSink } from "./diagnostics-log.js";
3
3
  /**
4
- * Backpressure signal (GEN-PERF-CHAT-006). Emitted exactly once when a write is rejected because the
5
- * client is not draining, BEFORE the socket is destroyed, so a slow-client termination is observable
6
- * and distinguishable from an intentional user cancel. Carries only non-secret counts — never body
7
- * bytes — so it cannot leak model tokens if logged.
4
+ * Stalled-reader signal (GEN-PERF-CHAT-006). Emitted exactly once when a stream is torn down because
5
+ * its reader drained nothing within `SSE_STALLED_READER_TIMEOUT_MS`, BEFORE the socket is destroyed,
6
+ * so a stalled-reader termination is observable and distinguishable from an intentional user cancel.
7
+ * `frameBytes` is the size of the frame that started the wait. Carries only non-secret counts —
8
+ * never body bytes — so it cannot leak model tokens if logged.
8
9
  */
9
10
  export interface SseBackpressureSignal {
10
11
  readonly frameBytes: number;
@@ -21,37 +22,60 @@ export declare function resetServerShuttingDownForTests(): void;
21
22
  export declare function currentOpenSseStreamCount(): number;
22
23
  /**
23
24
  * Records one SSE frame write against `res`'s per-stream counter (#2902 w5-sse-counters). Closed
24
- * over the SAME write path every SSE route already funnels through — `writeOrDestroy` below, plus
25
+ * over the SAME write path every SSE route already funnels through — `writeSseFrame` below, plus
25
26
  * `sse.ts`'s legacy write path, `writeEvent`, `writeMessageEvent` and the heartbeat — so no route
26
27
  * handler has to opt in. Never throws: observability must never break a write.
27
28
  */
28
29
  export declare function recordSseStreamFrame(res: ServerResponse, frame: string, correlationId?: string): void;
29
30
  /**
30
31
  * Marks `res`'s stream as ended-by-backpressure so the terminal line reports `"backpressure-killed"`
31
- * rather than the generic `"client-disconnected"`. Called only from a write path that is about to
32
- * `destroy()` the socket as a direct, deterministic consequence of the rejected write — never from
33
- * `writeEvent`/`writeMessageEvent`, where a caller-observed `false` does not by itself mean the
34
- * stream is being torn down.
32
+ * rather than the generic `"client-disconnected"`. Called only when a stalled reader is about to be
33
+ * destroyed because it drained nothing within its bound — never for a write that merely returned
34
+ * `false`, which is ordinary flow control and does not by itself mean the stream is torn down.
35
35
  */
36
36
  export declare function markSseStreamBackpressureKilled(res: ServerResponse): void;
37
37
  /** Marks a caught transport failure before destroy(error), which need not emit a response error. */
38
38
  export declare function markSseStreamServerErrored(res: ServerResponse): void;
39
39
  /**
40
- * Writes `frame` to `res`. When `res.write` returns false (TCP send-buffer full / slow client),
41
- * aborts `controller` (stops the upstream producer) and destroys the socket.
42
- *
43
- * When the write is rejected, `onBackpressure` (if supplied) is invoked exactly once with the frame
44
- * byte count before the socket is destroyed, giving callers a distinct, observable signal for a
45
- * backpressure kill rather than silently relabeling it as a user cancel. The callback is wrapped in a
46
- * try/catch so an observer throw can never propagate into the write loop.
40
+ * How long a stream may keep frames above Node's high-water mark without its peer draining any of
41
+ * them before it counts as a stalled reader. `res.write()` returning `false` only says that Node's
42
+ * buffer is above its high-water mark — Node 24 answers so for every single write of 64 KiB or more,
43
+ * even to an idle loopback client — so a false write is ordinary flow control, never by itself a
44
+ * reason to end a stream. Only a peer that drains nothing for this long is torn down: that bound is
45
+ * time, never frame size, so a frame of any size reaches a reader that is still reading.
46
+ */
47
+ export declare const SSE_STALLED_READER_TIMEOUT_MS = 30000;
48
+ /**
49
+ * Holds `res` open until its peer drains what Node buffered above the high-water mark. Called after a
50
+ * write returned `false`. When the peer drains, the stream simply continues. When it drains nothing
51
+ * within `SSE_STALLED_READER_TIMEOUT_MS`, the stream is a stalled reader: it is marked
52
+ * `backpressure-killed`, `onBackpressure` is told once, `controller` is aborted so the producer stops,
53
+ * and the socket is destroyed. A peer that closes first ends the wait through its own `close`.
54
+ */
55
+ export declare function awaitSseDrain(res: ServerResponse, frameBytes: number, controller: AbortController | null, onBackpressure?: (signal: SseBackpressureSignal) => void): void;
56
+ /**
57
+ * Resolves once `res` can take more data: at once while Node's buffer is below the high-water mark,
58
+ * otherwise on `drain`, or on `close` (a peer that left, or a stalled reader the bound destroyed).
59
+ * A producer that awaits it before pulling more input carries the reader's pace upstream instead of
60
+ * buffering an unbounded backlog in memory; it re-checks its own cancellation after the wait.
61
+ */
62
+ export declare function whenSseWritable(res: ServerResponse): Promise<void>;
63
+ /**
64
+ * Writes one SSE `frame` to `res` with drain-based flow control. A `false` result from `res.write`
65
+ * is Node's buffer accounting, not a dead client: the frame is already queued and the stream waits
66
+ * for `drain` (see `awaitSseDrain`). Only a reader that drains nothing within
67
+ * `SSE_STALLED_READER_TIMEOUT_MS` is torn down: `onBackpressure` (if supplied) is invoked exactly once
68
+ * with the byte count of the frame that started the wait, `controller` is aborted and the socket is
69
+ * destroyed — so a stalled-reader termination stays distinguishable from a user cancel.
47
70
  *
48
71
  * `correlationId` is optional (most SSE routes never received a `RouteContext`, mirroring
49
72
  * `readBoundedRequestBody`'s own optional correlation id) and, when supplied, is attached to this
50
73
  * stream's terminal `sse.stream.closed` line.
51
74
  *
52
- * Returns the raw boolean from `res.write` so callers can short-circuit if needed.
75
+ * Returns `false` only when the frame could not be queued because the stream is already gone, so a
76
+ * caller that sees `false` stops producing.
53
77
  */
54
- export declare function writeOrDestroy(res: ServerResponse, frame: string, controller: AbortController, onBackpressure?: (signal: SseBackpressureSignal) => void, correlationId?: string): boolean;
78
+ export declare function writeSseFrame(res: ServerResponse, frame: string, controller: AbortController | null, onBackpressure?: (signal: SseBackpressureSignal) => void, correlationId?: string): boolean;
55
79
  /**
56
80
  * Builds the production `onBackpressure` observer for an SSE route: a body-free operator diagnostic
57
81
  * naming the stream that was killed for not draining. Without this, a slow-client termination is
@@ -1 +1 @@
1
- {"version":3,"file":"sse-write.d.ts","sourceRoot":"","sources":["../src/sse-write.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGvF;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B;AA2CD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,iFAAiF;AACjF,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAMD,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAsFD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAQN;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAGzE;AAED,oGAAoG;AACpG,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAGpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,eAAe,EAC3B,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,EACxD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAgBT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAA;CAAE,EACjE,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,MAAqB,GACnC,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAYzC"}
1
+ {"version":3,"file":"sse-write.d.ts","sourceRoot":"","sources":["../src/sse-write.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAMhD,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAG9B;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B;AA8CD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,iFAAiF;AACjF,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAMD,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAyFD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAGzE;AAED,oGAAoG;AACpG,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAGpE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAOpD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,GACvD,IAAI,CAoBN;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAalE;AAkCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,EACxD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAOT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAA;CAAE,EACjE,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,MAAqB,GACnC,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAYzC"}
@@ -1,18 +1,22 @@
1
- // Shared SSE backpressure helper. Every SSE path in the server must call res.write() and react to
2
- // the boolean it returns: false means the kernel send-buffer is full and the client is not draining.
3
- // Continuing to write would grow Node's internal stream buffer without bound; the correct response is
4
- // to abort the in-flight generator (so the model/queue call stops producing) and destroy the socket.
1
+ // Shared SSE flow control. Every SSE path in the server writes through `writeSseFrame` (or, for a
2
+ // framing helper that writes itself, calls `awaitSseDrain` on a false write). `res.write()` returning
3
+ // false means Node buffered the frame above its high-water mark — true for any single frame of
4
+ // 64 KiB or more even to an idle client — so the frame is queued and the stream waits for `drain`.
5
+ // Frame size never ends a stream. Only a reader that drains nothing within
6
+ // `SSE_STALLED_READER_TIMEOUT_MS` is a stalled reader: the producer is aborted and the socket
7
+ // destroyed, so a dead peer cannot grow the buffer without bound.
5
8
  //
6
9
  // Usage (mirrors terminal-routes.ts writeTerminalEvent and run-handlers.ts SseWriter.write):
7
10
  //
8
- // writeOrDestroy(ctx.res, frame, controller);
11
+ // writeSseFrame(ctx.res, frame, controller);
9
12
  //
10
13
  // The controller parameter is an AbortController (or null when the caller manages abort separately
11
14
  // via its own signal). Destroying the socket fires "close" on res, which the caller's existing
12
15
  // res.on("close", …) listener picks up for any additional cleanup (e.g. registry deregistration).
13
16
  import { randomUUID } from "node:crypto";
14
17
  import { activityLogEvent, defineActivityLogOperation, } from "@oscharko-dev/keiko-contracts/runtime/observability";
15
- import { emitServerDiagnostic } from "./diagnostics-log.js";
18
+ import { UNKNOWN_CORRELATION_ID } from "./correlation.js";
19
+ import { emitServerDiagnostic, serverDiagnosticFromError, } from "./diagnostics-log.js";
16
20
  import { getServerLogger } from "./observability/index.js";
17
21
  const SSE_STREAM_CLOSED_OPERATION = defineActivityLogOperation({
18
22
  contractKind: "activity-log-operation",
@@ -24,6 +28,9 @@ const SSE_STREAM_CLOSED_OPERATION = defineActivityLogOperation({
24
28
  fields: {
25
29
  frameCount: { type: "integer", dataClass: "count", required: true },
26
30
  bytesStreamed: { type: "integer", dataClass: "count", required: true },
31
+ // Writes that left Node's buffer above its high-water mark and then waited for `drain`; absent
32
+ // when the stream never had to wait.
33
+ drainWaitCount: { type: "integer", dataClass: "count", required: false },
27
34
  reason: {
28
35
  type: "string",
29
36
  dataClass: "closed-enum",
@@ -69,7 +76,7 @@ export function currentOpenSseStreamCount() {
69
76
  return openSseStreamCount;
70
77
  }
71
78
  // Per-response frame/byte counters (#2902 w5-sse-counters), keyed by the live `ServerResponse` so
72
- // every SSE write path in the server — `writeOrDestroy` here, plus `sse.ts`'s legacy write path,
79
+ // every SSE write path in the server — `writeSseFrame` here, plus `sse.ts`'s legacy write path,
73
80
  // `writeEvent`/`writeMessageEvent` and the heartbeat — shares ONE count per stream without any of
74
81
  // them needing a threaded "deps" object. A `WeakMap` means a stream that never gets tracked (a
75
82
  // minimal unit-test double with no `.on`) costs nothing and is never retained past `res`'s own
@@ -105,6 +112,7 @@ function emitSseStreamClosed(res, state) {
105
112
  }, {
106
113
  frameCount: state.frameCount,
107
114
  bytesStreamed: state.bytesStreamed,
115
+ ...(state.drainWaitCount === 0 ? {} : { drainWaitCount: state.drainWaitCount }),
108
116
  reason: sseStreamReason(res, state),
109
117
  }));
110
118
  }
@@ -125,6 +133,7 @@ function sseStreamState(res) {
125
133
  startedAt: Date.now(),
126
134
  backpressureKilled: false,
127
135
  serverErrored: false,
136
+ drainWaitCount: 0,
128
137
  emitted: false,
129
138
  correlationId: undefined,
130
139
  };
@@ -140,7 +149,7 @@ function sseStreamState(res) {
140
149
  }
141
150
  /**
142
151
  * Records one SSE frame write against `res`'s per-stream counter (#2902 w5-sse-counters). Closed
143
- * over the SAME write path every SSE route already funnels through — `writeOrDestroy` below, plus
152
+ * over the SAME write path every SSE route already funnels through — `writeSseFrame` below, plus
144
153
  * `sse.ts`'s legacy write path, `writeEvent`, `writeMessageEvent` and the heartbeat — so no route
145
154
  * handler has to opt in. Never throws: observability must never break a write.
146
155
  */
@@ -156,10 +165,9 @@ export function recordSseStreamFrame(res, frame, correlationId) {
156
165
  }
157
166
  /**
158
167
  * Marks `res`'s stream as ended-by-backpressure so the terminal line reports `"backpressure-killed"`
159
- * rather than the generic `"client-disconnected"`. Called only from a write path that is about to
160
- * `destroy()` the socket as a direct, deterministic consequence of the rejected write — never from
161
- * `writeEvent`/`writeMessageEvent`, where a caller-observed `false` does not by itself mean the
162
- * stream is being torn down.
168
+ * rather than the generic `"client-disconnected"`. Called only when a stalled reader is about to be
169
+ * destroyed because it drained nothing within its bound — never for a write that merely returned
170
+ * `false`, which is ordinary flow control and does not by itself mean the stream is torn down.
163
171
  */
164
172
  export function markSseStreamBackpressureKilled(res) {
165
173
  const state = sseStreamCounters.get(res);
@@ -173,37 +181,116 @@ export function markSseStreamServerErrored(res) {
173
181
  state.serverErrored = true;
174
182
  }
175
183
  /**
176
- * Writes `frame` to `res`. When `res.write` returns false (TCP send-buffer full / slow client),
177
- * aborts `controller` (stops the upstream producer) and destroys the socket.
178
- *
179
- * When the write is rejected, `onBackpressure` (if supplied) is invoked exactly once with the frame
180
- * byte count before the socket is destroyed, giving callers a distinct, observable signal for a
181
- * backpressure kill rather than silently relabeling it as a user cancel. The callback is wrapped in a
182
- * try/catch so an observer throw can never propagate into the write loop.
184
+ * How long a stream may keep frames above Node's high-water mark without its peer draining any of
185
+ * them before it counts as a stalled reader. `res.write()` returning `false` only says that Node's
186
+ * buffer is above its high-water mark — Node 24 answers so for every single write of 64 KiB or more,
187
+ * even to an idle loopback client — so a false write is ordinary flow control, never by itself a
188
+ * reason to end a stream. Only a peer that drains nothing for this long is torn down: that bound is
189
+ * time, never frame size, so a frame of any size reaches a reader that is still reading.
190
+ */
191
+ export const SSE_STALLED_READER_TIMEOUT_MS = 30_000;
192
+ // One pending drain wait per stream. A stream already waiting keeps its first deadline: frames
193
+ // written meanwhile are buffered behind the ones the peer has not taken yet, and the stall bound
194
+ // measures how long the peer has taken nothing.
195
+ const pendingSseDrains = new WeakSet();
196
+ /**
197
+ * Holds `res` open until its peer drains what Node buffered above the high-water mark. Called after a
198
+ * write returned `false`. When the peer drains, the stream simply continues. When it drains nothing
199
+ * within `SSE_STALLED_READER_TIMEOUT_MS`, the stream is a stalled reader: it is marked
200
+ * `backpressure-killed`, `onBackpressure` is told once, `controller` is aborted so the producer stops,
201
+ * and the socket is destroyed. A peer that closes first ends the wait through its own `close`.
202
+ */
203
+ export function awaitSseDrain(res, frameBytes, controller, onBackpressure) {
204
+ // A response double without `.once` cannot report a drain; it never reaches a real socket either.
205
+ if (typeof res.once !== "function" || pendingSseDrains.has(res))
206
+ return;
207
+ pendingSseDrains.add(res);
208
+ const state = sseStreamCounters.get(res);
209
+ if (state !== undefined)
210
+ state.drainWaitCount += 1;
211
+ const settle = () => {
212
+ clearTimeout(timer);
213
+ pendingSseDrains.delete(res);
214
+ res.off("drain", settle);
215
+ res.off("close", settle);
216
+ };
217
+ const timer = setTimeout(() => {
218
+ settle();
219
+ killStalledSseStream(res, frameBytes, controller, onBackpressure);
220
+ }, SSE_STALLED_READER_TIMEOUT_MS);
221
+ timer.unref();
222
+ res.once("drain", settle);
223
+ res.once("finish", settle);
224
+ res.once("close", settle);
225
+ }
226
+ /**
227
+ * Resolves once `res` can take more data: at once while Node's buffer is below the high-water mark,
228
+ * otherwise on `drain`, or on `close` (a peer that left, or a stalled reader the bound destroyed).
229
+ * A producer that awaits it before pulling more input carries the reader's pace upstream instead of
230
+ * buffering an unbounded backlog in memory; it re-checks its own cancellation after the wait.
231
+ */
232
+ export function whenSseWritable(res) {
233
+ if (res.destroyed || res.writableEnded || !res.writableNeedDrain) {
234
+ return Promise.resolve();
235
+ }
236
+ return new Promise((resolve) => {
237
+ const settle = () => {
238
+ res.off("drain", settle);
239
+ res.off("close", settle);
240
+ resolve();
241
+ };
242
+ res.once("drain", settle);
243
+ res.once("close", settle);
244
+ });
245
+ }
246
+ function killStalledSseStream(res, frameBytes, controller, onBackpressure) {
247
+ // An ended stream whose buffered tail the peer still has not taken is a stalled reader too: it
248
+ // would otherwise hold its socket and buffer for as long as the peer stays silent.
249
+ if (res.destroyed || res.writableFinished)
250
+ return;
251
+ markSseStreamBackpressureKilled(res);
252
+ if (onBackpressure !== undefined) {
253
+ try {
254
+ onBackpressure({ frameBytes, accepted: false });
255
+ }
256
+ catch (error) {
257
+ // Observability must never break the protective abort+destroy path, and a throwing observer
258
+ // is itself recorded rather than lost.
259
+ emitServerDiagnostic(undefined, serverDiagnosticFromError({
260
+ correlationId: sseStreamCounters.get(res)?.correlationId ?? UNKNOWN_CORRELATION_ID,
261
+ operation: "sse.stream.stalled-reader",
262
+ source: "sse.stream.stalled-reader.observer",
263
+ error,
264
+ redact: () => "sse-stalled-reader-observer-failed",
265
+ }));
266
+ }
267
+ }
268
+ controller?.abort();
269
+ res.destroy();
270
+ }
271
+ /**
272
+ * Writes one SSE `frame` to `res` with drain-based flow control. A `false` result from `res.write`
273
+ * is Node's buffer accounting, not a dead client: the frame is already queued and the stream waits
274
+ * for `drain` (see `awaitSseDrain`). Only a reader that drains nothing within
275
+ * `SSE_STALLED_READER_TIMEOUT_MS` is torn down: `onBackpressure` (if supplied) is invoked exactly once
276
+ * with the byte count of the frame that started the wait, `controller` is aborted and the socket is
277
+ * destroyed — so a stalled-reader termination stays distinguishable from a user cancel.
183
278
  *
184
279
  * `correlationId` is optional (most SSE routes never received a `RouteContext`, mirroring
185
280
  * `readBoundedRequestBody`'s own optional correlation id) and, when supplied, is attached to this
186
281
  * stream's terminal `sse.stream.closed` line.
187
282
  *
188
- * Returns the raw boolean from `res.write` so callers can short-circuit if needed.
283
+ * Returns `false` only when the frame could not be queued because the stream is already gone, so a
284
+ * caller that sees `false` stops producing.
189
285
  */
190
- export function writeOrDestroy(res, frame, controller, onBackpressure, correlationId) {
286
+ export function writeSseFrame(res, frame, controller, onBackpressure, correlationId) {
287
+ if (res.destroyed || res.writableEnded)
288
+ return false;
191
289
  recordSseStreamFrame(res, frame, correlationId);
192
- const accepted = res.write(frame);
193
- if (!accepted) {
194
- markSseStreamBackpressureKilled(res);
195
- if (onBackpressure !== undefined) {
196
- try {
197
- onBackpressure({ frameBytes: Buffer.byteLength(frame, "utf8"), accepted: false });
198
- }
199
- catch {
200
- // Observability must never break the protective abort+destroy path.
201
- }
202
- }
203
- controller.abort();
204
- res.destroy();
290
+ if (!res.write(frame)) {
291
+ awaitSseDrain(res, Buffer.byteLength(frame, "utf8"), controller, onBackpressure);
205
292
  }
206
- return accepted;
293
+ return true;
207
294
  }
208
295
  /**
209
296
  * Builds the production `onBackpressure` observer for an SSE route: a body-free operator diagnostic
@@ -3,10 +3,10 @@ import type { StreamEvent } from "./sink.js";
3
3
  import type { Redactor } from "./deps.js";
4
4
  import { type SseBackpressureSignal } from "./sse-write.js";
5
5
  /**
6
- * Optional protective wiring for the heartbeat. A heartbeat can be the FIRST write rejected on an
7
- * idle stream, so without this the connection is destroyed with no abort of the producer and no
8
- * backpressure signal — the slow-client kill is silent and indistinguishable from a normal close.
9
- * Omitting it preserves the historical behaviour exactly (plain write + destroy).
6
+ * Optional stalled-reader wiring for the heartbeat. A heartbeat can be the first frame written to an
7
+ * idle stream whose reader has gone quiet; with this supplied, tearing that reader down also aborts
8
+ * the producer and emits the stalled-reader signal, so the termination is never silent. Without it a
9
+ * stalled heartbeat stream is still destroyed after the shared bound, only without those two effects.
10
10
  */
11
11
  export interface SseHeartbeatBackpressure {
12
12
  readonly controller: AbortController;
@@ -14,6 +14,8 @@ export interface SseHeartbeatBackpressure {
14
14
  readonly correlationId?: string | undefined;
15
15
  }
16
16
  export declare const SSE_HEADERS: Readonly<Record<string, string>>;
17
+ /** The default keep-alive interval of an SSE stream. */
18
+ export declare const SSE_HEARTBEAT_INTERVAL_MS = 15000;
17
19
  export declare function startSseHeartbeat(res: ServerResponse, intervalMs?: number, observableEvent?: "heartbeat", backpressure?: SseHeartbeatBackpressure): () => void;
18
20
  export declare function frameEvent(event: StreamEvent, redactor: Redactor): string;
19
21
  export declare function frameMessageEvent(event: StreamEvent, redactor: Redactor): string;
@@ -1 +1 @@
1
- {"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAGhF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAYD,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxD,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,UAAU,SAAQ,EAClB,eAAe,CAAC,EAAE,WAAW,EAC7B,YAAY,CAAC,EAAE,wBAAwB,GACtC,MAAM,IAAI,CAiCZ;AAMD,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAGzE;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAGhF;AAID,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAYD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAItF;AAID,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAI/F;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,QAAQ,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAIT"}
1
+ {"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAiB,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAGhF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxD,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,UAAU,SAA4B,EACtC,eAAe,CAAC,EAAE,WAAW,EAC7B,YAAY,CAAC,EAAE,wBAAwB,GACtC,MAAM,IAAI,CA8BZ;AAMD,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAGzE;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAGhF;AAID,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAYD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAEtF;AAID,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE/F;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,QAAQ,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAET"}
@@ -5,29 +5,19 @@
5
5
  // (newlines are escaped as `\n`), so a single `data:` line is always valid — no regex, no manual
6
6
  // escaping. A synthetic `ready` message is sent after the buffered replay.
7
7
  import { redactedEventJson } from "./sse-frame-cache.js";
8
- import { markSseStreamBackpressureKilled, recordSseStreamFrame, writeOrDestroy, } from "./sse-write.js";
9
- function writeOrDestroyLegacy(res, frame) {
10
- recordSseStreamFrame(res, frame);
11
- const accepted = res.write(frame);
12
- if (!accepted) {
13
- markSseStreamBackpressureKilled(res);
14
- res.destroy();
15
- }
16
- return accepted;
17
- }
8
+ import { writeSseFrame } from "./sse-write.js";
18
9
  export const SSE_HEADERS = {
19
10
  "Content-Type": "text/event-stream; charset=utf-8",
20
11
  "Cache-Control": "no-store",
21
12
  Connection: "keep-alive",
22
13
  "X-Accel-Buffering": "no",
23
14
  };
24
- export function startSseHeartbeat(res, intervalMs = 15000, observableEvent, backpressure) {
25
- // With `backpressure` supplied every heartbeat frame goes through the same protective path as
26
- // event frames: abort the producer, signal the observer, then destroy. Without it the historical
27
- // plain write + destroy is kept byte-for-byte so the six other SSE callers are unaffected.
28
- const writeFrame = (frame) => backpressure === undefined
29
- ? writeOrDestroyLegacy(res, frame)
30
- : writeOrDestroy(res, frame, backpressure.controller, backpressure.onBackpressure, backpressure.correlationId);
15
+ /** The default keep-alive interval of an SSE stream. */
16
+ export const SSE_HEARTBEAT_INTERVAL_MS = 15_000;
17
+ export function startSseHeartbeat(res, intervalMs = SSE_HEARTBEAT_INTERVAL_MS, observableEvent, backpressure) {
18
+ // Every heartbeat frame goes through the shared flow control. With `backpressure` supplied a
19
+ // stalled reader also aborts the producer and signals the observer before the socket is destroyed.
20
+ const writeFrame = (frame) => writeSseFrame(res, frame, backpressure?.controller ?? null, backpressure?.onBackpressure, backpressure?.correlationId);
31
21
  const timer = setInterval(() => {
32
22
  if (res.destroyed || res.writableEnded)
33
23
  return;
@@ -77,21 +67,15 @@ export function readyMessage() {
77
67
  // record-then-write shape, so a caller that opens with `ready` gets the same guarantee those get.
78
68
  // `correlationId`, when supplied, is bound to the stream by the same set-once-wins rule
79
69
  // `recordSseStreamFrame` already applies — most openers call this before their first event write, so
80
- // it is normally this call that actually attaches the id (mirrors `writeOrDestroy`'s own parameter).
70
+ // it is normally this call that actually attaches the id (mirrors `writeSseFrame`'s own parameter).
81
71
  export function writeReadyMessage(res, correlationId) {
82
- const frame = readyMessage();
83
- recordSseStreamFrame(res, frame, correlationId);
84
- return res.write(frame);
72
+ return writeSseFrame(res, readyMessage(), null, undefined, correlationId);
85
73
  }
86
- // Writes one framed event to the response stream. Returns Node's backpressure signal so the caller can
87
- // detach a slow client instead of letting the HTTP response buffer grow without bound.
74
+ // Writes one framed event to the response stream through the shared flow control (sse-write.ts):
75
+ // a buffered frame waits for `drain`, and `false` means only that the stream is already gone.
88
76
  export function writeEvent(res, event, redactor) {
89
- const frame = frameEvent(event, redactor);
90
- recordSseStreamFrame(res, frame);
91
- return res.write(frame);
77
+ return writeSseFrame(res, frameEvent(event, redactor), null);
92
78
  }
93
79
  export function writeMessageEvent(res, event, redactor, correlationId) {
94
- const frame = frameMessageEvent(event, redactor);
95
- recordSseStreamFrame(res, frame, correlationId);
96
- return res.write(frame);
80
+ return writeSseFrame(res, frameMessageEvent(event, redactor), null, undefined, correlationId);
97
81
  }
@@ -1 +1 @@
1
- {"version":3,"file":"terminal-routes.d.ts","sourceRoot":"","sources":["../src/terminal-routes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,WAAW,CAAC;AACjE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAKL,KAAK,wBAAwB,EAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAK/C,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAiIrB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,GAAG,WAAW,CAE1F;AA4BD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAED,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CA+BtB;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,GAAG,WAAW,CAYjG;AAID,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,GAAG,cAAc,CAgB3F;AAKD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EACnC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,EACxD,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAoCN;AAmBD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}
1
+ {"version":3,"file":"terminal-routes.d.ts","sourceRoot":"","sources":["../src/terminal-routes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,WAAW,CAAC;AACjE,OAAO,EAA0C,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEpG,OAAO,EAKL,KAAK,wBAAwB,EAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAK/C,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAiIrB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,GAAG,WAAW,CAE1F;AA4BD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAED,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CA+BtB;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,GAAG,WAAW,CAYjG;AAID,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,GAAG,cAAc,CAgB3F;AAKD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EACnC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,EACxD,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAoCN;AAmBD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}
@@ -1,7 +1,7 @@
1
1
  // ADR-0018 D8 — five /api/terminal/* BFF route handlers. CSRF is enforced by the server's
2
2
  // state-changing-request gate (POST/DELETE flow through it); GET routes are read-only and exempt.
3
3
  // SSE framing mirrors /api/browser/*/events.
4
- import { sseBackpressureReporter, writeOrDestroy, } from "./sse-write.js";
4
+ import { sseBackpressureReporter, writeSseFrame } from "./sse-write.js";
5
5
  import { TerminalToolError } from "./terminal-errors.js";
6
6
  import { buildTerminalPolicySummary, listDirectories, } from "./terminal.js";
7
7
  import { requiresConfiguredManagedWorkspaceAuthority } from "./task-workspace/workspace-root-access.js";
@@ -231,7 +231,7 @@ export function handleTerminalEvents(ctx, deps) {
231
231
  // because the client is not draining, before the socket is destroyed.
232
232
  export function openTerminalSseStream(res, manager, redactor, onBackpressure, correlationId) {
233
233
  res.writeHead(200, SSE_HEADERS);
234
- // Per-connection abort: a slow-client backpressure kill (writeOrDestroy) aborts this controller,
234
+ // Per-connection abort: a slow-client backpressure kill (writeSseFrame) aborts this controller,
235
235
  // which unsubscribes from the manager so no further frames are produced for a dead socket. The
236
236
  // res.on("close") listener also unsubscribes; `unsubscribed` guards against the double call.
237
237
  // subscribe() returns synchronously and events fire only asynchronously afterward, so no event
@@ -261,8 +261,8 @@ export function openTerminalSseStream(res, manager, redactor, onBackpressure, co
261
261
  controller.signal.addEventListener("abort", stop, { once: true });
262
262
  // The ready frame goes through the same protective path: a client that is already not draining
263
263
  // must abort and unsubscribe here too, rather than leaving the subscription live until some
264
- // later event happens to trip writeOrDestroy.
265
- writeOrDestroy(res, readyMessage(), controller, onBackpressure, correlationId);
264
+ // later event happens to trip writeSseFrame.
265
+ writeSseFrame(res, readyMessage(), controller, onBackpressure, correlationId);
266
266
  res.on("close", () => {
267
267
  stop();
268
268
  });
@@ -272,5 +272,5 @@ function writeTerminalEvent(res, event, seq, redactor, controller, onBackpressur
272
272
  // the per-connection `id:` cursor differs between them.
273
273
  const data = redactedEventJson(redactor, event);
274
274
  const frame = `id: ${String(seq)}\nevent: terminal:${event.kind}\ndata: ${data}\n\n`;
275
- writeOrDestroy(res, frame, controller, onBackpressure);
275
+ writeSseFrame(res, frame, controller, onBackpressure);
276
276
  }
@@ -1 +1 @@
1
- {"version":3,"file":"catalogToolFacadeBridge.d.ts","sourceRoot":"","sources":["../../src/tool-catalog/catalogToolFacadeBridge.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACpG,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC/F,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACtG,OAAO,EAGL,KAAK,8BAA8B,EACnC,KAAK,mBAAmB,EACzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAE3F,OAAO,EAA0B,KAAK,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAWjG,OAAO,KAAK,EAIV,qBAAqB,EAItB,MAAM,uBAAuB,CAAC;AAsD/B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iCAAiC;IAChD,iGAAiG;IACjG,QAAQ,CAAC,uBAAuB,CAAC,EAC7B,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC,GAC7F,SAAS,CAAC;IACd,qEAAqE;IACrE,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACvD,+EAA+E;IAC/E,QAAQ,CAAC,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,0BAA0B,CAAC;IACtD,QAAQ,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,uBAAuB,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAChF,gGAAgG;IAChG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC;IAC/D,QAAQ,CAAC,aAAa,EAAE,CACtB,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,EAChD,KAAK,EAAE,qBAAqB,KACzB,IAAI,CAAC;IACV,QAAQ,CAAC,OAAO,EAAE,CAChB,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,CAAC,KAC5F,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CACrC,OAAO,EAAE,OAAO,CAAC,uBAAuB,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EACtE,KAAK,EAAE,8BAA8B,EACrC,GAAG,EAAE,CACH,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,uBAAuB,EAC9B,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,gBAAgB,CAAC,KAC3B,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAC7B,OAAO,EAAE,OAAO,CAAC,uBAAuB,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EACtE,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,CAAC,KAC5F,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAChC;AAgGD;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,uBAAuB,GAC/B,MAAM,GAAG,SAAS,CAKpB;AAwbD,qGAAqG;AACrG,wBAAgB,sCAAsC,CACpD,WAAW,EAAE,WAAW,CAAC,wBAAwB,CAAC,EAClD,OAAO,GAAE,mBAA8B,GACtC,8BAA8B,CA8BhC;AAgLD,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,iCAAiC,GAC7C,4BAA4B,CA8C9B;AAED,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,GAAG,SAAS,CAK5F"}
1
+ {"version":3,"file":"catalogToolFacadeBridge.d.ts","sourceRoot":"","sources":["../../src/tool-catalog/catalogToolFacadeBridge.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,5 @@
1
1
  import { randomUUID } from "node:crypto";
2
+ import { CHANGESET_EDIT_ARGUMENT_LIMITS, GOVERNED_CHANGESET_EDIT_TOOL_ID, } from "@oscharko-dev/keiko-contracts/runtime/governed-tool-catalog";
2
3
  import { compareStrings } from "@oscharko-dev/keiko-contracts/runtime/comparators";
3
4
  import { activityLogEvent, defineActivityLogOperation, } from "@oscharko-dev/keiko-contracts/runtime/observability";
4
5
  import { compileToolProjection, createKeikoToolCatalog, nativeTextSnapshotRegistrationSet, captureCatalogJson, lookupCatalogTool, } from "@oscharko-dev/keiko-tool-catalog";
@@ -91,13 +92,13 @@ function workspaceCatalogAction(request) {
91
92
  }
92
93
  function editCatalogAction(request) {
93
94
  return {
94
- toolId: "keiko.changeset.edit",
95
+ toolId: GOVERNED_CHANGESET_EDIT_TOOL_ID,
95
96
  arguments: captureCatalogJson({
96
97
  changeset: {
97
98
  ...request.changeset,
98
99
  selectedFiles: request.changeset.selectedFiles ?? request.changeset.files.map((file) => file.file),
99
100
  },
100
- }),
101
+ }, undefined, CHANGESET_EDIT_ARGUMENT_LIMITS),
101
102
  };
102
103
  }
103
104
  // Exhaustive translation from the closed IPC action union into canonical catalog actions.
@@ -263,7 +264,7 @@ function representative(canonicalId, identity) {
263
264
  const workspace = workspaceRepresentative(canonicalId, base);
264
265
  if (workspace !== undefined)
265
266
  return workspace;
266
- if (canonicalId === "keiko.changeset.edit")
267
+ if (canonicalId === GOVERNED_CHANGESET_EDIT_TOOL_ID)
267
268
  return {
268
269
  ...base,
269
270
  action: "edit",
@@ -1 +1 @@
1
- {"version":3,"file":"catalogToolLifecycle.d.ts","sourceRoot":"","sources":["../../src/tool-catalog/catalogToolLifecycle.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,kBAAkB,EAExB,MAAM,+DAA+D,CAAC;AAevE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAkd/B,+FAA+F;AAC/F,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAY9E;AA4ND,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;CACpC;AAyBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAM3F;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC"}
1
+ {"version":3,"file":"catalogToolLifecycle.d.ts","sourceRoot":"","sources":["../../src/tool-catalog/catalogToolLifecycle.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,kBAAkB,EAExB,MAAM,+DAA+D,CAAC;AAevE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAge/B,+FAA+F;AAC/F,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAY9E;AA4ND,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;CACpC;AAyBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAM3F;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC"}
@@ -1,5 +1,5 @@
1
1
  import { captureCatalogJson, createToolRef } from "@oscharko-dev/keiko-tool-catalog";
2
- import { TOOL_CATALOG_LIMITS, TOOL_RESULT_REASONS, } from "@oscharko-dev/keiko-contracts/runtime/governed-tool-catalog";
2
+ import { CHANGESET_EDIT_ARGUMENT_LIMITS, TOOL_CATALOG_LIMITS, TOOL_RESULT_REASONS, toolArgumentLimits, } from "@oscharko-dev/keiko-contracts/runtime/governed-tool-catalog";
3
3
  import { TOOL_HANDLER_READINESS, captureToolInvocationReceipt, toolLifecyclePhaseFor, } from "@oscharko-dev/keiko-contracts/runtime/governed-tool-lifecycle";
4
4
  import { deepFreeze } from "@oscharko-dev/keiko-contracts/runtime/deep-freeze";
5
5
  import { activityLogEvent, defineActivityLogOperation, isErrorKind, recordActivityLogLoss, } from "@oscharko-dev/keiko-contracts/runtime/observability";
@@ -356,6 +356,9 @@ function metricMaximum(key) {
356
356
  return TOOL_CATALOG_LIMITS.maxArrayItems;
357
357
  if (key === "durationMs")
358
358
  return Number.MAX_SAFE_INTEGER;
359
+ // The largest per-tool argument ceiling; `inputBytesWithinTool` holds each tool to its own.
360
+ if (key === "inputBytes")
361
+ return CHANGESET_EDIT_ARGUMENT_LIMITS.maxArgumentBytes;
359
362
  return TOOL_CATALOG_LIMITS.maxResultBytes;
360
363
  }
361
364
  function validMetric(key, value) {
@@ -424,7 +427,18 @@ function terminalReservation(value) {
424
427
  !value.effectStarted &&
425
428
  value.budgetDisposition === "not-reserved");
426
429
  }
430
+ // A call's argument bytes are bounded by the ceiling of the tool the event names: the generic one
431
+ // unless the tool has its own (`toolArgumentLimits`), and always the generic one without a tool.
432
+ function inputBytesWithinTool(value) {
433
+ if (value.inputBytes === undefined)
434
+ return;
435
+ const tool = value.toolRef ?? null;
436
+ const canonicalId = tool === null ? undefined : object(tool).canonicalId;
437
+ const maximum = toolArgumentLimits(typeof canonicalId === "string" ? canonicalId : "").maxArgumentBytes;
438
+ requireLifecycle(typeof value.inputBytes === "number" && value.inputBytes <= maximum);
439
+ }
427
440
  function phaseShape(phase, value) {
441
+ inputBytesWithinTool(value);
428
442
  if (phase === "terminal") {
429
443
  terminalStatus(value);
430
444
  terminalReservation(value);
@@ -1,4 +1,4 @@
1
- import type { CatalogJsonValue, CatalogProfile, ToolResultReason, ToolResultStatus } from "@oscharko-dev/keiko-contracts/runtime/governed-tool-catalog";
1
+ import { type CatalogJsonValue, type CatalogProfile, type ToolResultReason, type ToolResultStatus } from "@oscharko-dev/keiko-contracts/runtime/governed-tool-catalog";
2
2
  import { type CodingToolActionRequest } from "../coding-runtime/codingToolIpc.js";
3
3
  import { type CatalogBindingState, type CatalogBoundHandler } from "./catalogToolBinder.js";
4
4
  import type { BoundToolInvocation, CatalogActionIdentity, CatalogToolExecutionOverride, CatalogTrustedContext } from "./catalogToolPorts.js";
@@ -1 +1 @@
1
- {"version":3,"file":"catalogToolRuntimeAuthority.d.ts","sourceRoot":"","sources":["../../src/tool-catalog/catalogToolRuntimeAuthority.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,6DAA6D,CAAC;AAGrE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC;aAC9C,MAAM,EAAE,gBAAgB;IAF1C,YACkB,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC,EAC9C,MAAM,EAAE,gBAAgB,EACxC,KAAK,CAAC,EAAE,OAAO,EAGhB;CACF;AAKD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC,EAC9C,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,SAAS,CAEnB;AACD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAM/D;AAeD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,OAAO,GACd,mBAAmB,CA6CrB;AA0BD,wBAAgB,OAAO,CACrB,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,EACpC,KAAK,EAAE,mBAAmB,CAAC,SAAS,CAAC,GACpC,OAAO,CAET;AACD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,qBAAqB,CAExF;AAMD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,MAAM,GACjB,qBAAqB,CAqCvB;AACD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,qBAAqB,EAC/B,iBAAiB,CAAC,EAAE,4BAA4B,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,uBAAuB,CAwBzB;AA6ED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAmBlC"}
1
+ {"version":3,"file":"catalogToolRuntimeAuthority.d.ts","sourceRoot":"","sources":["../../src/tool-catalog/catalogToolRuntimeAuthority.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAEnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,6DAA6D,CAAC;AAGrE,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC;aAC9C,MAAM,EAAE,gBAAgB;IAF1C,YACkB,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC,EAC9C,MAAM,EAAE,gBAAgB,EACxC,KAAK,CAAC,EAAE,OAAO,EAGhB;CACF;AAKD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC,EAC9C,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,SAAS,CAEnB;AACD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAM/D;AAyBD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,OAAO,GACd,mBAAmB,CA6CrB;AA0BD,wBAAgB,OAAO,CACrB,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,EACpC,KAAK,EAAE,mBAAmB,CAAC,SAAS,CAAC,GACpC,OAAO,CAET;AACD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,qBAAqB,CAExF;AAMD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,MAAM,GACjB,qBAAqB,CAqCvB;AACD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,qBAAqB,EAC/B,iBAAiB,CAAC,EAAE,4BAA4B,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,uBAAuB,CA4BzB;AA6ED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CA2BlC"}