@namzu/sdk 30.2.0 → 31.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (718) hide show
  1. package/CHANGELOG.md +562 -0
  2. package/README.md +43 -2
  3. package/dist/advisory/executor.d.ts +2 -1
  4. package/dist/advisory/executor.d.ts.map +1 -1
  5. package/dist/advisory/executor.js +4 -1
  6. package/dist/advisory/executor.js.map +1 -1
  7. package/dist/agents/ReactiveAgent.d.ts.map +1 -1
  8. package/dist/agents/ReactiveAgent.js +12 -0
  9. package/dist/agents/ReactiveAgent.js.map +1 -1
  10. package/dist/agents/RouterAgent.d.ts.map +1 -1
  11. package/dist/agents/RouterAgent.js +21 -3
  12. package/dist/agents/RouterAgent.js.map +1 -1
  13. package/dist/agents/SupervisorAgent.d.ts.map +1 -1
  14. package/dist/agents/SupervisorAgent.js +34 -11
  15. package/dist/agents/SupervisorAgent.js.map +1 -1
  16. package/dist/agents/runAgent.d.ts +12 -0
  17. package/dist/agents/runAgent.d.ts.map +1 -1
  18. package/dist/agents/runAgent.js +26 -2
  19. package/dist/agents/runAgent.js.map +1 -1
  20. package/dist/authorization/command-line.d.ts +81 -0
  21. package/dist/authorization/command-line.d.ts.map +1 -0
  22. package/dist/authorization/command-line.js +347 -0
  23. package/dist/authorization/command-line.js.map +1 -0
  24. package/dist/authorization/rules.d.ts.map +1 -1
  25. package/dist/authorization/rules.js +22 -1
  26. package/dist/authorization/rules.js.map +1 -1
  27. package/dist/bridge/a2a/client.d.ts +23 -5
  28. package/dist/bridge/a2a/client.d.ts.map +1 -1
  29. package/dist/bridge/a2a/client.js +320 -73
  30. package/dist/bridge/a2a/client.js.map +1 -1
  31. package/dist/bridge/a2a/mapper.d.ts.map +1 -1
  32. package/dist/bridge/a2a/mapper.js +4 -0
  33. package/dist/bridge/a2a/mapper.js.map +1 -1
  34. package/dist/bridge/acp/server.d.ts +13 -1
  35. package/dist/bridge/acp/server.d.ts.map +1 -1
  36. package/dist/bridge/acp/server.js +150 -44
  37. package/dist/bridge/acp/server.js.map +1 -1
  38. package/dist/bridge/mcp/connector/adapter.d.ts +3 -2
  39. package/dist/bridge/mcp/connector/adapter.d.ts.map +1 -1
  40. package/dist/bridge/mcp/connector/adapter.js +17 -21
  41. package/dist/bridge/mcp/connector/adapter.js.map +1 -1
  42. package/dist/bridge/sse/mapper.d.ts.map +1 -1
  43. package/dist/bridge/sse/mapper.js +3 -0
  44. package/dist/bridge/sse/mapper.js.map +1 -1
  45. package/dist/compaction/dangling.d.ts +29 -2
  46. package/dist/compaction/dangling.d.ts.map +1 -1
  47. package/dist/compaction/dangling.js +172 -35
  48. package/dist/compaction/dangling.js.map +1 -1
  49. package/dist/compaction/index.d.ts +3 -2
  50. package/dist/compaction/index.d.ts.map +1 -1
  51. package/dist/compaction/index.js +1 -1
  52. package/dist/compaction/index.js.map +1 -1
  53. package/dist/compaction/manual.d.ts +11 -1
  54. package/dist/compaction/manual.d.ts.map +1 -1
  55. package/dist/compaction/manual.js +89 -14
  56. package/dist/compaction/manual.js.map +1 -1
  57. package/dist/compaction/plan.d.ts +19 -6
  58. package/dist/compaction/plan.d.ts.map +1 -1
  59. package/dist/compaction/plan.js +18 -4
  60. package/dist/compaction/plan.js.map +1 -1
  61. package/dist/compaction/retention.d.ts +10 -7
  62. package/dist/compaction/retention.d.ts.map +1 -1
  63. package/dist/compaction/retention.js +26 -8
  64. package/dist/compaction/retention.js.map +1 -1
  65. package/dist/compaction/summary.d.ts +4 -4
  66. package/dist/compaction/summary.js +4 -4
  67. package/dist/compaction/verifier.d.ts +19 -1
  68. package/dist/compaction/verifier.d.ts.map +1 -1
  69. package/dist/compaction/verifier.js +20 -1
  70. package/dist/compaction/verifier.js.map +1 -1
  71. package/dist/config/runtime.d.ts +6 -6
  72. package/dist/connector/BaseConnector.d.ts +6 -4
  73. package/dist/connector/BaseConnector.d.ts.map +1 -1
  74. package/dist/connector/BaseConnector.js +8 -2
  75. package/dist/connector/BaseConnector.js.map +1 -1
  76. package/dist/connector/builtins/http.d.ts +16 -4
  77. package/dist/connector/builtins/http.d.ts.map +1 -1
  78. package/dist/connector/builtins/http.js +177 -44
  79. package/dist/connector/builtins/http.js.map +1 -1
  80. package/dist/connector/builtins/webhook.d.ts +15 -4
  81. package/dist/connector/builtins/webhook.d.ts.map +1 -1
  82. package/dist/connector/builtins/webhook.js +165 -45
  83. package/dist/connector/builtins/webhook.js.map +1 -1
  84. package/dist/connector/execution-contract.d.ts +11 -0
  85. package/dist/connector/execution-contract.d.ts.map +1 -0
  86. package/dist/connector/execution-contract.js +14 -0
  87. package/dist/connector/execution-contract.js.map +1 -0
  88. package/dist/connector/http-operation.d.ts +48 -0
  89. package/dist/connector/http-operation.d.ts.map +1 -0
  90. package/dist/connector/http-operation.js +205 -0
  91. package/dist/connector/http-operation.js.map +1 -0
  92. package/dist/connector/mcp/adapter.d.ts.map +1 -1
  93. package/dist/connector/mcp/adapter.js +8 -3
  94. package/dist/connector/mcp/adapter.js.map +1 -1
  95. package/dist/connector/mcp/client.d.ts +14 -8
  96. package/dist/connector/mcp/client.d.ts.map +1 -1
  97. package/dist/connector/mcp/client.js +160 -44
  98. package/dist/connector/mcp/client.js.map +1 -1
  99. package/dist/connector/mcp/http-sse.d.ts +8 -2
  100. package/dist/connector/mcp/http-sse.d.ts.map +1 -1
  101. package/dist/connector/mcp/http-sse.js +70 -17
  102. package/dist/connector/mcp/http-sse.js.map +1 -1
  103. package/dist/connector/mcp/prompt-adapter.d.ts.map +1 -1
  104. package/dist/connector/mcp/prompt-adapter.js +9 -2
  105. package/dist/connector/mcp/prompt-adapter.js.map +1 -1
  106. package/dist/connector/mcp/stdio.d.ts +2 -2
  107. package/dist/connector/mcp/stdio.d.ts.map +1 -1
  108. package/dist/connector/mcp/stdio.js +14 -50
  109. package/dist/connector/mcp/stdio.js.map +1 -1
  110. package/dist/connector/mcp/streamable-http.d.ts +7 -2
  111. package/dist/connector/mcp/streamable-http.d.ts.map +1 -1
  112. package/dist/connector/mcp/streamable-http.js +66 -18
  113. package/dist/connector/mcp/streamable-http.js.map +1 -1
  114. package/dist/connector/tools/adapter.d.ts +2 -2
  115. package/dist/connector/tools/adapter.d.ts.map +1 -1
  116. package/dist/connector/tools/adapter.js +23 -14
  117. package/dist/connector/tools/adapter.js.map +1 -1
  118. package/dist/connector/tools/definitions.d.ts.map +1 -1
  119. package/dist/connector/tools/definitions.js +5 -2
  120. package/dist/connector/tools/definitions.js.map +1 -1
  121. package/dist/connector/tools/result.d.ts +4 -0
  122. package/dist/connector/tools/result.d.ts.map +1 -0
  123. package/dist/connector/tools/result.js +20 -0
  124. package/dist/connector/tools/result.js.map +1 -0
  125. package/dist/connector/web/guarded-fetch.d.ts +4 -2
  126. package/dist/connector/web/guarded-fetch.d.ts.map +1 -1
  127. package/dist/connector/web/guarded-fetch.js +157 -43
  128. package/dist/connector/web/guarded-fetch.js.map +1 -1
  129. package/dist/constants/sandbox/index.d.ts +3 -2
  130. package/dist/constants/sandbox/index.d.ts.map +1 -1
  131. package/dist/constants/sandbox/index.js +3 -2
  132. package/dist/constants/sandbox/index.js.map +1 -1
  133. package/dist/contracts/api.d.ts +2 -0
  134. package/dist/contracts/api.d.ts.map +1 -1
  135. package/dist/contracts/schemas.d.ts +38 -12
  136. package/dist/contracts/schemas.d.ts.map +1 -1
  137. package/dist/contracts/schemas.js +7 -0
  138. package/dist/contracts/schemas.js.map +1 -1
  139. package/dist/directory/derive-supervisor.d.ts.map +1 -1
  140. package/dist/directory/derive-supervisor.js +8 -0
  141. package/dist/directory/derive-supervisor.js.map +1 -1
  142. package/dist/directory/derive.d.ts.map +1 -1
  143. package/dist/directory/derive.js +8 -0
  144. package/dist/directory/derive.js.map +1 -1
  145. package/dist/directory/load.d.ts.map +1 -1
  146. package/dist/directory/load.js +2 -0
  147. package/dist/directory/load.js.map +1 -1
  148. package/dist/directory/types.d.ts +4 -0
  149. package/dist/directory/types.d.ts.map +1 -1
  150. package/dist/eval/experiment.d.ts +10 -10
  151. package/dist/eval/experiment.d.ts.map +1 -1
  152. package/dist/eval/experiment.js +121 -91
  153. package/dist/eval/experiment.js.map +1 -1
  154. package/dist/eval/judge.d.ts +6 -0
  155. package/dist/eval/judge.d.ts.map +1 -1
  156. package/dist/eval/judge.js +7 -2
  157. package/dist/eval/judge.js.map +1 -1
  158. package/dist/eval/types.d.ts +7 -1
  159. package/dist/eval/types.d.ts.map +1 -1
  160. package/dist/manager/agent/lifecycle.d.ts +12 -10
  161. package/dist/manager/agent/lifecycle.d.ts.map +1 -1
  162. package/dist/manager/agent/lifecycle.js +16 -3
  163. package/dist/manager/agent/lifecycle.js.map +1 -1
  164. package/dist/manager/connector/environment.d.ts +2 -2
  165. package/dist/manager/connector/environment.d.ts.map +1 -1
  166. package/dist/manager/connector/environment.js +2 -2
  167. package/dist/manager/connector/environment.js.map +1 -1
  168. package/dist/manager/connector/lifecycle.d.ts +10 -2
  169. package/dist/manager/connector/lifecycle.d.ts.map +1 -1
  170. package/dist/manager/connector/lifecycle.js +273 -24
  171. package/dist/manager/connector/lifecycle.js.map +1 -1
  172. package/dist/manager/connector/tenant.d.ts +5 -4
  173. package/dist/manager/connector/tenant.d.ts.map +1 -1
  174. package/dist/manager/connector/tenant.js +47 -22
  175. package/dist/manager/connector/tenant.js.map +1 -1
  176. package/dist/manager/goal/activation.d.ts +23 -0
  177. package/dist/manager/goal/activation.d.ts.map +1 -0
  178. package/dist/manager/goal/activation.js +41 -0
  179. package/dist/manager/goal/activation.js.map +1 -0
  180. package/dist/manager/index.d.ts +3 -2
  181. package/dist/manager/index.d.ts.map +1 -1
  182. package/dist/manager/index.js.map +1 -1
  183. package/dist/manager/run/persistence.d.ts +2 -0
  184. package/dist/manager/run/persistence.d.ts.map +1 -1
  185. package/dist/manager/run/persistence.js +5 -1
  186. package/dist/manager/run/persistence.js.map +1 -1
  187. package/dist/manager/topic/dependency.d.ts +24 -0
  188. package/dist/manager/topic/dependency.d.ts.map +1 -0
  189. package/dist/manager/topic/dependency.js +13 -0
  190. package/dist/manager/topic/dependency.js.map +1 -0
  191. package/dist/manager/topic/lifecycle.d.ts +9 -21
  192. package/dist/manager/topic/lifecycle.d.ts.map +1 -1
  193. package/dist/manager/topic/lifecycle.js +17 -29
  194. package/dist/manager/topic/lifecycle.js.map +1 -1
  195. package/dist/plugin/index.d.ts +1 -0
  196. package/dist/plugin/index.d.ts.map +1 -1
  197. package/dist/plugin/index.js.map +1 -1
  198. package/dist/plugin/lifecycle.d.ts +15 -0
  199. package/dist/plugin/lifecycle.d.ts.map +1 -1
  200. package/dist/plugin/lifecycle.js +144 -38
  201. package/dist/plugin/lifecycle.js.map +1 -1
  202. package/dist/plugin/loader.d.ts +3 -3
  203. package/dist/plugin/loader.d.ts.map +1 -1
  204. package/dist/plugin/loader.js +58 -12
  205. package/dist/plugin/loader.js.map +1 -1
  206. package/dist/provider/collect-chat-completion.d.ts.map +1 -1
  207. package/dist/provider/collect-chat-completion.js +4 -0
  208. package/dist/provider/collect-chat-completion.js.map +1 -1
  209. package/dist/provider/fallback.d.ts +3 -1
  210. package/dist/provider/fallback.d.ts.map +1 -1
  211. package/dist/provider/fallback.js +62 -10
  212. package/dist/provider/fallback.js.map +1 -1
  213. package/dist/provider/idle-timeout.d.ts +4 -0
  214. package/dist/provider/idle-timeout.d.ts.map +1 -1
  215. package/dist/provider/idle-timeout.js +131 -15
  216. package/dist/provider/idle-timeout.js.map +1 -1
  217. package/dist/provider/index.d.ts +2 -0
  218. package/dist/provider/index.d.ts.map +1 -1
  219. package/dist/provider/index.js +1 -0
  220. package/dist/provider/index.js.map +1 -1
  221. package/dist/provider/instrumentation.d.ts.map +1 -1
  222. package/dist/provider/instrumentation.js +1 -0
  223. package/dist/provider/instrumentation.js.map +1 -1
  224. package/dist/provider/retry.d.ts.map +1 -1
  225. package/dist/provider/retry.js +13 -1
  226. package/dist/provider/retry.js.map +1 -1
  227. package/dist/public-runtime.d.ts +57 -24
  228. package/dist/public-runtime.d.ts.map +1 -1
  229. package/dist/public-runtime.js +42 -35
  230. package/dist/public-runtime.js.map +1 -1
  231. package/dist/public-tools.d.ts +1 -0
  232. package/dist/public-tools.d.ts.map +1 -1
  233. package/dist/public-tools.js +5 -0
  234. package/dist/public-tools.js.map +1 -1
  235. package/dist/public-types.d.ts +33 -12
  236. package/dist/public-types.d.ts.map +1 -1
  237. package/dist/rag/embedding.d.ts +8 -3
  238. package/dist/rag/embedding.d.ts.map +1 -1
  239. package/dist/rag/embedding.js +120 -9
  240. package/dist/rag/embedding.js.map +1 -1
  241. package/dist/rag/index.d.ts +1 -1
  242. package/dist/rag/index.d.ts.map +1 -1
  243. package/dist/rag/index.js +1 -1
  244. package/dist/rag/index.js.map +1 -1
  245. package/dist/rag/ingestion.d.ts +2 -2
  246. package/dist/rag/ingestion.d.ts.map +1 -1
  247. package/dist/rag/ingestion.js +15 -3
  248. package/dist/rag/ingestion.js.map +1 -1
  249. package/dist/rag/knowledge-base.d.ts +3 -3
  250. package/dist/rag/knowledge-base.d.ts.map +1 -1
  251. package/dist/rag/knowledge-base.js +8 -4
  252. package/dist/rag/knowledge-base.js.map +1 -1
  253. package/dist/rag/operation.d.ts +10 -0
  254. package/dist/rag/operation.d.ts.map +1 -0
  255. package/dist/rag/operation.js +26 -0
  256. package/dist/rag/operation.js.map +1 -0
  257. package/dist/rag/rag-tool.d.ts.map +1 -1
  258. package/dist/rag/rag-tool.js +6 -3
  259. package/dist/rag/rag-tool.js.map +1 -1
  260. package/dist/rag/retriever.d.ts +2 -2
  261. package/dist/rag/retriever.d.ts.map +1 -1
  262. package/dist/rag/retriever.js +31 -15
  263. package/dist/rag/retriever.js.map +1 -1
  264. package/dist/rag/vector-store.d.ts +3 -3
  265. package/dist/rag/vector-store.d.ts.map +1 -1
  266. package/dist/rag/vector-store.js +4 -2
  267. package/dist/rag/vector-store.js.map +1 -1
  268. package/dist/registry/command/kernel-commands.d.ts +16 -4
  269. package/dist/registry/command/kernel-commands.d.ts.map +1 -1
  270. package/dist/registry/command/kernel-commands.js +171 -0
  271. package/dist/registry/command/kernel-commands.js.map +1 -1
  272. package/dist/run/reporter.d.ts.map +1 -1
  273. package/dist/run/reporter.js +9 -0
  274. package/dist/run/reporter.js.map +1 -1
  275. package/dist/run-query/index.d.ts +15 -1
  276. package/dist/run-query/index.d.ts.map +1 -1
  277. package/dist/run-query/index.js +69 -15
  278. package/dist/run-query/index.js.map +1 -1
  279. package/dist/runtime/query/context.d.ts.map +1 -1
  280. package/dist/runtime/query/context.js +10 -3
  281. package/dist/runtime/query/context.js.map +1 -1
  282. package/dist/runtime/query/executor.d.ts +3 -0
  283. package/dist/runtime/query/executor.d.ts.map +1 -1
  284. package/dist/runtime/query/executor.js +80 -18
  285. package/dist/runtime/query/executor.js.map +1 -1
  286. package/dist/runtime/query/guard.d.ts +9 -0
  287. package/dist/runtime/query/guard.d.ts.map +1 -1
  288. package/dist/runtime/query/guard.js +11 -0
  289. package/dist/runtime/query/guard.js.map +1 -1
  290. package/dist/runtime/query/index.d.ts +30 -1
  291. package/dist/runtime/query/index.d.ts.map +1 -1
  292. package/dist/runtime/query/index.js +548 -95
  293. package/dist/runtime/query/index.js.map +1 -1
  294. package/dist/runtime/query/iteration/index.d.ts.map +1 -1
  295. package/dist/runtime/query/iteration/index.js +74 -14
  296. package/dist/runtime/query/iteration/index.js.map +1 -1
  297. package/dist/runtime/query/iteration/phases/compaction.d.ts.map +1 -1
  298. package/dist/runtime/query/iteration/phases/compaction.js +94 -53
  299. package/dist/runtime/query/iteration/phases/compaction.js.map +1 -1
  300. package/dist/runtime/query/iteration/phases/context.d.ts +3 -0
  301. package/dist/runtime/query/iteration/phases/context.d.ts.map +1 -1
  302. package/dist/runtime/query/iteration/phases/context.js.map +1 -1
  303. package/dist/runtime/query/iteration/phases/tool-review.d.ts.map +1 -1
  304. package/dist/runtime/query/iteration/phases/tool-review.js +21 -0
  305. package/dist/runtime/query/iteration/phases/tool-review.js.map +1 -1
  306. package/dist/runtime/query/iteration/stream-turn.d.ts.map +1 -1
  307. package/dist/runtime/query/iteration/stream-turn.js +4 -0
  308. package/dist/runtime/query/iteration/stream-turn.js.map +1 -1
  309. package/dist/runtime/query/project-instructions.d.ts +69 -0
  310. package/dist/runtime/query/project-instructions.d.ts.map +1 -0
  311. package/dist/runtime/query/project-instructions.js +137 -0
  312. package/dist/runtime/query/project-instructions.js.map +1 -0
  313. package/dist/runtime/query/request-rich-content.d.ts +22 -0
  314. package/dist/runtime/query/request-rich-content.d.ts.map +1 -0
  315. package/dist/runtime/query/request-rich-content.js +122 -0
  316. package/dist/runtime/query/request-rich-content.js.map +1 -0
  317. package/dist/runtime/query/result.d.ts.map +1 -1
  318. package/dist/runtime/query/result.js +12 -1
  319. package/dist/runtime/query/result.js.map +1 -1
  320. package/dist/runtime/query/resume-pending.d.ts.map +1 -1
  321. package/dist/runtime/query/resume-pending.js +19 -20
  322. package/dist/runtime/query/resume-pending.js.map +1 -1
  323. package/dist/runtime/query/resume-run.d.ts.map +1 -1
  324. package/dist/runtime/query/resume-run.js +54 -8
  325. package/dist/runtime/query/resume-run.js.map +1 -1
  326. package/dist/runtime/query/run-state.d.ts +5 -0
  327. package/dist/runtime/query/run-state.d.ts.map +1 -1
  328. package/dist/runtime/query/run-state.js +6 -1
  329. package/dist/runtime/query/run-state.js.map +1 -1
  330. package/dist/runtime/query/sandbox-lifecycle.d.ts +54 -0
  331. package/dist/runtime/query/sandbox-lifecycle.d.ts.map +1 -0
  332. package/dist/runtime/query/sandbox-lifecycle.js +167 -0
  333. package/dist/runtime/query/sandbox-lifecycle.js.map +1 -0
  334. package/dist/sandbox/isolation.d.ts.map +1 -1
  335. package/dist/sandbox/isolation.js +9 -0
  336. package/dist/sandbox/isolation.js.map +1 -1
  337. package/dist/sandbox/provider/local.d.ts +56 -6
  338. package/dist/sandbox/provider/local.d.ts.map +1 -1
  339. package/dist/sandbox/provider/local.js +181 -76
  340. package/dist/sandbox/provider/local.js.map +1 -1
  341. package/dist/sandbox/terminal.d.ts +13 -5
  342. package/dist/sandbox/terminal.d.ts.map +1 -1
  343. package/dist/sandbox/terminal.js +11 -3
  344. package/dist/sandbox/terminal.js.map +1 -1
  345. package/dist/session/errors.d.ts +28 -29
  346. package/dist/session/errors.d.ts.map +1 -1
  347. package/dist/session/errors.js +28 -29
  348. package/dist/session/errors.js.map +1 -1
  349. package/dist/session/handoff/broadcast.d.ts +5 -8
  350. package/dist/session/handoff/broadcast.d.ts.map +1 -1
  351. package/dist/session/handoff/broadcast.js +16 -6
  352. package/dist/session/handoff/broadcast.js.map +1 -1
  353. package/dist/session/handoff/single.d.ts +5 -8
  354. package/dist/session/handoff/single.d.ts.map +1 -1
  355. package/dist/session/handoff/single.js +7 -4
  356. package/dist/session/handoff/single.js.map +1 -1
  357. package/dist/store/attachment/index.d.ts +11 -3
  358. package/dist/store/attachment/index.d.ts.map +1 -1
  359. package/dist/store/attachment/index.js +49 -4
  360. package/dist/store/attachment/index.js.map +1 -1
  361. package/dist/store/feedback/conformance.d.ts.map +1 -1
  362. package/dist/store/feedback/conformance.js +32 -0
  363. package/dist/store/feedback/conformance.js.map +1 -1
  364. package/dist/store/feedback/disk.d.ts +8 -6
  365. package/dist/store/feedback/disk.d.ts.map +1 -1
  366. package/dist/store/feedback/disk.js +111 -76
  367. package/dist/store/feedback/disk.js.map +1 -1
  368. package/dist/store/goal/index.d.ts +111 -0
  369. package/dist/store/goal/index.d.ts.map +1 -0
  370. package/dist/store/goal/index.js +436 -0
  371. package/dist/store/goal/index.js.map +1 -0
  372. package/dist/store/index.d.ts +1 -1
  373. package/dist/store/index.d.ts.map +1 -1
  374. package/dist/store/index.js +1 -1
  375. package/dist/store/index.js.map +1 -1
  376. package/dist/store/kv/revision-record-store.d.ts +70 -0
  377. package/dist/store/kv/revision-record-store.d.ts.map +1 -0
  378. package/dist/store/kv/revision-record-store.js +290 -0
  379. package/dist/store/kv/revision-record-store.js.map +1 -0
  380. package/dist/store/memory/disk.d.ts +9 -7
  381. package/dist/store/memory/disk.d.ts.map +1 -1
  382. package/dist/store/memory/disk.js +256 -98
  383. package/dist/store/memory/disk.js.map +1 -1
  384. package/dist/store/run/disk.d.ts +10 -2
  385. package/dist/store/run/disk.d.ts.map +1 -1
  386. package/dist/store/run/disk.js +70 -4
  387. package/dist/store/run/disk.js.map +1 -1
  388. package/dist/store/run/memory.d.ts +4 -2
  389. package/dist/store/run/memory.d.ts.map +1 -1
  390. package/dist/store/run/memory.js +15 -1
  391. package/dist/store/run/memory.js.map +1 -1
  392. package/dist/store/session/disk.d.ts +9 -0
  393. package/dist/store/session/disk.d.ts.map +1 -1
  394. package/dist/store/session/disk.js +57 -5
  395. package/dist/store/session/disk.js.map +1 -1
  396. package/dist/store/session/memory.d.ts +1 -0
  397. package/dist/store/session/memory.d.ts.map +1 -1
  398. package/dist/store/session/memory.js +14 -0
  399. package/dist/store/session/memory.js.map +1 -1
  400. package/dist/store/topic/memory.d.ts +1 -2
  401. package/dist/store/topic/memory.d.ts.map +1 -1
  402. package/dist/store/topic/memory.js +4 -5
  403. package/dist/store/topic/memory.js.map +1 -1
  404. package/dist/store/topic/objective.d.ts +8 -4
  405. package/dist/store/topic/objective.d.ts.map +1 -1
  406. package/dist/store/topic/objective.js +185 -100
  407. package/dist/store/topic/objective.js.map +1 -1
  408. package/dist/store/topic/state.d.ts +1 -2
  409. package/dist/store/topic/state.d.ts.map +1 -1
  410. package/dist/store/topic/state.js +50 -62
  411. package/dist/store/topic/state.js.map +1 -1
  412. package/dist/tools/builtins/bash.d.ts.map +1 -1
  413. package/dist/tools/builtins/bash.js +20 -0
  414. package/dist/tools/builtins/bash.js.map +1 -1
  415. package/dist/tools/builtins/computer-use.d.ts +9 -1
  416. package/dist/tools/builtins/computer-use.d.ts.map +1 -1
  417. package/dist/tools/builtins/computer-use.js.map +1 -1
  418. package/dist/tools/builtins/content-fingerprint.d.ts +8 -7
  419. package/dist/tools/builtins/content-fingerprint.d.ts.map +1 -1
  420. package/dist/tools/builtins/content-fingerprint.js +9 -10
  421. package/dist/tools/builtins/content-fingerprint.js.map +1 -1
  422. package/dist/tools/builtins/edit.d.ts +6 -1
  423. package/dist/tools/builtins/edit.d.ts.map +1 -1
  424. package/dist/tools/builtins/edit.js +166 -27
  425. package/dist/tools/builtins/edit.js.map +1 -1
  426. package/dist/tools/builtins/write-file.d.ts.map +1 -1
  427. package/dist/tools/builtins/write-file.js +45 -19
  428. package/dist/tools/builtins/write-file.js.map +1 -1
  429. package/dist/tools/command-arguments.d.ts +43 -0
  430. package/dist/tools/command-arguments.d.ts.map +1 -0
  431. package/dist/tools/command-arguments.js +52 -0
  432. package/dist/tools/command-arguments.js.map +1 -0
  433. package/dist/tools/coordinator/index.d.ts +2 -0
  434. package/dist/tools/coordinator/index.d.ts.map +1 -1
  435. package/dist/tools/coordinator/index.js +3 -1
  436. package/dist/tools/coordinator/index.js.map +1 -1
  437. package/dist/tools/defineTool.d.ts +10 -0
  438. package/dist/tools/defineTool.d.ts.map +1 -1
  439. package/dist/tools/defineTool.js +1 -0
  440. package/dist/tools/defineTool.js.map +1 -1
  441. package/dist/tools/env-scrub.d.ts +7 -5
  442. package/dist/tools/env-scrub.d.ts.map +1 -1
  443. package/dist/tools/env-scrub.js +7 -5
  444. package/dist/tools/env-scrub.js.map +1 -1
  445. package/dist/tools/goal/index.d.ts +20 -0
  446. package/dist/tools/goal/index.d.ts.map +1 -0
  447. package/dist/tools/goal/index.js +104 -0
  448. package/dist/tools/goal/index.js.map +1 -0
  449. package/dist/tools/memory/index.d.ts +16 -0
  450. package/dist/tools/memory/index.d.ts.map +1 -1
  451. package/dist/tools/memory/index.js +6 -2
  452. package/dist/tools/memory/index.js.map +1 -1
  453. package/dist/tools/memory/search.d.ts +4 -1
  454. package/dist/tools/memory/search.d.ts.map +1 -1
  455. package/dist/tools/memory/search.js +10 -2
  456. package/dist/tools/memory/search.js.map +1 -1
  457. package/dist/types/agent/base.d.ts +11 -3
  458. package/dist/types/agent/base.d.ts.map +1 -1
  459. package/dist/types/agent/factory.d.ts +2 -0
  460. package/dist/types/agent/factory.d.ts.map +1 -1
  461. package/dist/types/agent/reactive.d.ts +2 -0
  462. package/dist/types/agent/reactive.d.ts.map +1 -1
  463. package/dist/types/agent/supervisor.d.ts +6 -0
  464. package/dist/types/agent/supervisor.d.ts.map +1 -1
  465. package/dist/types/agent/task.d.ts +6 -2
  466. package/dist/types/agent/task.d.ts.map +1 -1
  467. package/dist/types/connector/core.d.ts +13 -8
  468. package/dist/types/connector/core.d.ts.map +1 -1
  469. package/dist/types/connector/definition.d.ts +37 -18
  470. package/dist/types/connector/definition.d.ts.map +1 -1
  471. package/dist/types/connector/http.d.ts +6 -0
  472. package/dist/types/connector/http.d.ts.map +1 -1
  473. package/dist/types/connector/mcp.d.ts +24 -6
  474. package/dist/types/connector/mcp.d.ts.map +1 -1
  475. package/dist/types/connector/tenant.d.ts +17 -7
  476. package/dist/types/connector/tenant.d.ts.map +1 -1
  477. package/dist/types/connector/webhook.d.ts +6 -0
  478. package/dist/types/connector/webhook.d.ts.map +1 -1
  479. package/dist/types/goal/index.d.ts +46 -0
  480. package/dist/types/goal/index.d.ts.map +1 -0
  481. package/dist/types/goal/index.js +2 -0
  482. package/dist/types/goal/index.js.map +1 -0
  483. package/dist/types/ids/index.d.ts +2 -0
  484. package/dist/types/ids/index.d.ts.map +1 -1
  485. package/dist/types/ids/index.js.map +1 -1
  486. package/dist/types/message/index.d.ts +79 -13
  487. package/dist/types/message/index.d.ts.map +1 -1
  488. package/dist/types/message/index.js +49 -3
  489. package/dist/types/message/index.js.map +1 -1
  490. package/dist/types/plugin/index.d.ts +7 -5
  491. package/dist/types/plugin/index.d.ts.map +1 -1
  492. package/dist/types/plugin/index.js.map +1 -1
  493. package/dist/types/provider/chat.d.ts +27 -4
  494. package/dist/types/provider/chat.d.ts.map +1 -1
  495. package/dist/types/provider/index.d.ts +1 -1
  496. package/dist/types/provider/index.d.ts.map +1 -1
  497. package/dist/types/provider/interface.d.ts +18 -7
  498. package/dist/types/provider/interface.d.ts.map +1 -1
  499. package/dist/types/provider/model.d.ts +12 -0
  500. package/dist/types/provider/model.d.ts.map +1 -1
  501. package/dist/types/provider/stream.d.ts +6 -0
  502. package/dist/types/provider/stream.d.ts.map +1 -1
  503. package/dist/types/rag/embedding.d.ts +15 -2
  504. package/dist/types/rag/embedding.d.ts.map +1 -1
  505. package/dist/types/rag/ingestion.d.ts +2 -2
  506. package/dist/types/rag/ingestion.d.ts.map +1 -1
  507. package/dist/types/rag/knowledge-base.d.ts +3 -3
  508. package/dist/types/rag/knowledge-base.d.ts.map +1 -1
  509. package/dist/types/rag/retrieval.d.ts +2 -2
  510. package/dist/types/rag/retrieval.d.ts.map +1 -1
  511. package/dist/types/rag/scope.d.ts +4 -0
  512. package/dist/types/rag/scope.d.ts.map +1 -1
  513. package/dist/types/rag/vector.d.ts +5 -2
  514. package/dist/types/rag/vector.d.ts.map +1 -1
  515. package/dist/types/run/config.d.ts +20 -0
  516. package/dist/types/run/config.d.ts.map +1 -1
  517. package/dist/types/run/events.d.ts +25 -1
  518. package/dist/types/run/events.d.ts.map +1 -1
  519. package/dist/types/run/events.js.map +1 -1
  520. package/dist/types/run/metadata.d.ts +2 -0
  521. package/dist/types/run/metadata.d.ts.map +1 -1
  522. package/dist/types/run/step.d.ts +2 -6
  523. package/dist/types/run/step.d.ts.map +1 -1
  524. package/dist/types/run/step.js.map +1 -1
  525. package/dist/types/run/store.d.ts +55 -2
  526. package/dist/types/run/store.d.ts.map +1 -1
  527. package/dist/types/sandbox/index.d.ts +47 -6
  528. package/dist/types/sandbox/index.d.ts.map +1 -1
  529. package/dist/types/sandbox/index.js +23 -10
  530. package/dist/types/sandbox/index.js.map +1 -1
  531. package/dist/types/session/store.d.ts +13 -0
  532. package/dist/types/session/store.d.ts.map +1 -1
  533. package/dist/types/tool/index.d.ts +33 -11
  534. package/dist/types/tool/index.d.ts.map +1 -1
  535. package/dist/types/tool/index.js.map +1 -1
  536. package/dist/types/topic/entity.d.ts +3 -4
  537. package/dist/types/topic/entity.d.ts.map +1 -1
  538. package/dist/types/topic/store.d.ts +3 -3
  539. package/dist/utils/id.d.ts +3 -1
  540. package/dist/utils/id.d.ts.map +1 -1
  541. package/dist/utils/id.js +4 -0
  542. package/dist/utils/id.js.map +1 -1
  543. package/dist/utils/process-environment.d.ts +26 -0
  544. package/dist/utils/process-environment.d.ts.map +1 -0
  545. package/dist/utils/process-environment.js +78 -0
  546. package/dist/utils/process-environment.js.map +1 -0
  547. package/dist/vault/InMemoryCredentialVault.d.ts +2 -0
  548. package/dist/vault/InMemoryCredentialVault.d.ts.map +1 -1
  549. package/dist/vault/InMemoryCredentialVault.js +24 -4
  550. package/dist/vault/InMemoryCredentialVault.js.map +1 -1
  551. package/dist/vault/instrumentation.d.ts.map +1 -1
  552. package/dist/vault/instrumentation.js +15 -0
  553. package/dist/vault/instrumentation.js.map +1 -1
  554. package/package.json +1 -1
  555. package/src/advisory/executor.ts +4 -1
  556. package/src/agents/ReactiveAgent.ts +12 -0
  557. package/src/agents/RouterAgent.ts +25 -3
  558. package/src/agents/SupervisorAgent.ts +33 -11
  559. package/src/agents/runAgent.ts +38 -2
  560. package/src/authorization/command-line.ts +390 -0
  561. package/src/authorization/rules.ts +22 -1
  562. package/src/bridge/a2a/client.ts +384 -97
  563. package/src/bridge/a2a/mapper.ts +5 -0
  564. package/src/bridge/acp/server.ts +184 -42
  565. package/src/bridge/mcp/connector/adapter.ts +28 -20
  566. package/src/bridge/sse/mapper.ts +3 -0
  567. package/src/compaction/dangling.ts +203 -38
  568. package/src/compaction/index.ts +9 -2
  569. package/src/compaction/manual.ts +125 -18
  570. package/src/compaction/plan.ts +42 -11
  571. package/src/compaction/retention.ts +23 -8
  572. package/src/compaction/summary.ts +4 -4
  573. package/src/compaction/verifier.ts +66 -0
  574. package/src/connector/BaseConnector.ts +19 -4
  575. package/src/connector/builtins/http.ts +236 -46
  576. package/src/connector/builtins/webhook.ts +207 -47
  577. package/src/connector/execution-contract.ts +27 -0
  578. package/src/connector/http-operation.ts +238 -0
  579. package/src/connector/mcp/adapter.ts +8 -3
  580. package/src/connector/mcp/client.ts +207 -58
  581. package/src/connector/mcp/http-sse.ts +91 -23
  582. package/src/connector/mcp/prompt-adapter.ts +8 -2
  583. package/src/connector/mcp/stdio.ts +21 -46
  584. package/src/connector/mcp/streamable-http.ts +86 -22
  585. package/src/connector/tools/adapter.ts +23 -14
  586. package/src/connector/tools/definitions.ts +5 -2
  587. package/src/connector/tools/result.ts +21 -0
  588. package/src/connector/web/guarded-fetch.ts +188 -48
  589. package/src/constants/sandbox/index.ts +3 -2
  590. package/src/contracts/api.ts +2 -0
  591. package/src/contracts/schemas.ts +7 -0
  592. package/src/directory/derive-supervisor.ts +8 -0
  593. package/src/directory/derive.ts +8 -0
  594. package/src/directory/load.ts +2 -0
  595. package/src/directory/types.ts +4 -0
  596. package/src/eval/experiment.ts +160 -111
  597. package/src/eval/judge.ts +13 -2
  598. package/src/eval/types.ts +7 -1
  599. package/src/manager/agent/lifecycle.ts +28 -12
  600. package/src/manager/connector/environment.ts +3 -1
  601. package/src/manager/connector/lifecycle.ts +364 -24
  602. package/src/manager/connector/tenant.ts +56 -23
  603. package/src/manager/goal/activation.ts +52 -0
  604. package/src/manager/index.ts +10 -2
  605. package/src/manager/run/persistence.ts +6 -1
  606. package/src/manager/topic/dependency.ts +39 -0
  607. package/src/manager/topic/lifecycle.ts +19 -31
  608. package/src/plugin/index.ts +1 -0
  609. package/src/plugin/lifecycle.ts +180 -39
  610. package/src/plugin/loader.ts +70 -13
  611. package/src/provider/collect-chat-completion.ts +3 -0
  612. package/src/provider/fallback.ts +79 -11
  613. package/src/provider/idle-timeout.ts +143 -17
  614. package/src/provider/index.ts +2 -0
  615. package/src/provider/instrumentation.ts +1 -0
  616. package/src/provider/retry.ts +16 -1
  617. package/src/public-runtime.ts +190 -32
  618. package/src/public-tools.ts +5 -0
  619. package/src/public-types.ts +85 -11
  620. package/src/rag/embedding.ts +147 -19
  621. package/src/rag/index.ts +1 -1
  622. package/src/rag/ingestion.ts +16 -2
  623. package/src/rag/knowledge-base.ts +13 -4
  624. package/src/rag/operation.ts +28 -0
  625. package/src/rag/rag-tool.ts +6 -3
  626. package/src/rag/retriever.ts +62 -11
  627. package/src/rag/vector-store.ts +8 -2
  628. package/src/registry/command/kernel-commands.ts +223 -4
  629. package/src/run/reporter.ts +10 -0
  630. package/src/run-query/index.ts +84 -15
  631. package/src/runtime/query/context.ts +13 -3
  632. package/src/runtime/query/executor.ts +90 -17
  633. package/src/runtime/query/guard.ts +12 -0
  634. package/src/runtime/query/index.ts +652 -103
  635. package/src/runtime/query/iteration/index.ts +89 -13
  636. package/src/runtime/query/iteration/phases/compaction.ts +120 -55
  637. package/src/runtime/query/iteration/phases/context.ts +4 -0
  638. package/src/runtime/query/iteration/phases/tool-review.ts +28 -0
  639. package/src/runtime/query/iteration/stream-turn.ts +3 -0
  640. package/src/runtime/query/project-instructions.ts +212 -0
  641. package/src/runtime/query/request-rich-content.ts +153 -0
  642. package/src/runtime/query/result.ts +12 -1
  643. package/src/runtime/query/resume-pending.ts +20 -18
  644. package/src/runtime/query/resume-run.ts +52 -8
  645. package/src/runtime/query/run-state.ts +11 -1
  646. package/src/runtime/query/sandbox-lifecycle.ts +210 -0
  647. package/src/sandbox/isolation.ts +9 -0
  648. package/src/sandbox/provider/local.ts +255 -90
  649. package/src/sandbox/terminal.ts +13 -5
  650. package/src/session/errors.ts +68 -42
  651. package/src/session/handoff/broadcast.ts +20 -14
  652. package/src/session/handoff/single.ts +14 -13
  653. package/src/store/attachment/index.ts +65 -3
  654. package/src/store/feedback/conformance.ts +39 -0
  655. package/src/store/feedback/disk.ts +128 -82
  656. package/src/store/goal/index.ts +594 -0
  657. package/src/store/index.ts +1 -1
  658. package/src/store/kv/revision-record-store.ts +346 -0
  659. package/src/store/memory/disk.ts +288 -113
  660. package/src/store/run/disk.ts +96 -5
  661. package/src/store/run/memory.ts +22 -2
  662. package/src/store/session/disk.ts +93 -6
  663. package/src/store/session/memory.ts +22 -0
  664. package/src/store/topic/memory.ts +4 -5
  665. package/src/store/topic/objective.ts +215 -100
  666. package/src/store/topic/state.ts +100 -63
  667. package/src/tools/builtins/bash.ts +21 -0
  668. package/src/tools/builtins/computer-use.ts +9 -1
  669. package/src/tools/builtins/content-fingerprint.ts +9 -12
  670. package/src/tools/builtins/edit.ts +190 -27
  671. package/src/tools/builtins/write-file.ts +55 -19
  672. package/src/tools/command-arguments.ts +54 -0
  673. package/src/tools/coordinator/index.ts +4 -1
  674. package/src/tools/defineTool.ts +11 -0
  675. package/src/tools/env-scrub.ts +7 -5
  676. package/src/tools/goal/index.ts +129 -0
  677. package/src/tools/memory/index.ts +26 -3
  678. package/src/tools/memory/search.ts +20 -3
  679. package/src/types/agent/base.ts +12 -3
  680. package/src/types/agent/factory.ts +2 -0
  681. package/src/types/agent/reactive.ts +2 -0
  682. package/src/types/agent/supervisor.ts +6 -0
  683. package/src/types/agent/task.ts +6 -2
  684. package/src/types/connector/core.ts +13 -8
  685. package/src/types/connector/definition.ts +54 -20
  686. package/src/types/connector/http.ts +7 -0
  687. package/src/types/connector/mcp.ts +27 -6
  688. package/src/types/connector/tenant.ts +21 -7
  689. package/src/types/connector/webhook.ts +7 -0
  690. package/src/types/goal/index.ts +50 -0
  691. package/src/types/ids/index.ts +2 -0
  692. package/src/types/message/index.ts +147 -12
  693. package/src/types/plugin/index.ts +7 -5
  694. package/src/types/provider/chat.ts +35 -4
  695. package/src/types/provider/index.ts +1 -1
  696. package/src/types/provider/interface.ts +22 -7
  697. package/src/types/provider/model.ts +13 -0
  698. package/src/types/provider/stream.ts +6 -0
  699. package/src/types/rag/embedding.ts +16 -2
  700. package/src/types/rag/ingestion.ts +2 -1
  701. package/src/types/rag/knowledge-base.ts +7 -3
  702. package/src/types/rag/retrieval.ts +2 -1
  703. package/src/types/rag/scope.ts +5 -0
  704. package/src/types/rag/vector.ts +5 -2
  705. package/src/types/run/config.ts +20 -0
  706. package/src/types/run/events.ts +28 -3
  707. package/src/types/run/metadata.ts +2 -0
  708. package/src/types/run/step.ts +2 -7
  709. package/src/types/run/store.ts +60 -2
  710. package/src/types/sandbox/index.ts +57 -14
  711. package/src/types/session/store.ts +18 -0
  712. package/src/types/tool/index.ts +33 -11
  713. package/src/types/topic/entity.ts +3 -4
  714. package/src/types/topic/store.ts +3 -3
  715. package/src/utils/id.ts +6 -0
  716. package/src/utils/process-environment.ts +101 -0
  717. package/src/vault/InMemoryCredentialVault.ts +29 -4
  718. package/src/vault/instrumentation.ts +24 -0
@@ -2,11 +2,28 @@ import { createHmac } from 'node:crypto';
2
2
  import { z } from 'zod';
3
3
  import { asConnectorId } from '../../utils/id.js';
4
4
  import { BaseConnector } from '../BaseConnector.js';
5
+ import { CONNECTOR_HEALTH_TIMEOUT_MS, ConnectorHttpOperation, DEFAULT_CONNECTOR_MAX_RESPONSE_BYTES, DEFAULT_CONNECTOR_REQUEST_TIMEOUT_MS, readConnectorResponseBody, requireHttpUrl, requireSafeConnectorInputHeaders, requireSameOrigin, validateConnectorMaxResponseBytes, validateConnectorTimeoutMs, } from '../http-operation.js';
5
6
  const WebhookConnectorConfigSchema = z.object({
6
- url: z.string().url(),
7
+ url: z
8
+ .string()
9
+ .url()
10
+ .refine((value) => /^https?:/i.test(value), 'url must use http: or https:'),
7
11
  secret: z.string().optional(),
8
12
  defaultHeaders: z.record(z.string()).optional(),
9
- timeoutMs: z.number().positive().optional().default(30_000),
13
+ maxResponseBytes: z
14
+ .number()
15
+ .int()
16
+ .positive()
17
+ .max(2_147_483_647)
18
+ .optional()
19
+ .default(DEFAULT_CONNECTOR_MAX_RESPONSE_BYTES),
20
+ timeoutMs: z
21
+ .number()
22
+ .int()
23
+ .positive()
24
+ .max(2_147_483_647)
25
+ .optional()
26
+ .default(DEFAULT_CONNECTOR_REQUEST_TIMEOUT_MS),
10
27
  });
11
28
  const WebhookSendInputSchema = z.object({
12
29
  payload: z.unknown(),
@@ -20,6 +37,7 @@ export class WebhookConnector extends BaseConnector {
20
37
  name = 'Webhook Connector';
21
38
  description = 'Send webhook payloads to configured endpoints with optional HMAC signing';
22
39
  connectionType = 'webhook';
40
+ supportedAuth = ['none', 'bearer'];
23
41
  configSchema = WebhookConnectorConfigSchema;
24
42
  methods = [
25
43
  {
@@ -29,62 +47,72 @@ export class WebhookConnector extends BaseConnector {
29
47
  },
30
48
  ];
31
49
  url = '';
50
+ origin = '';
32
51
  secret;
33
52
  defaultHeaders = {};
34
- timeoutMs = 30_000;
53
+ timeoutMs = DEFAULT_CONNECTOR_REQUEST_TIMEOUT_MS;
54
+ maxResponseBytes = DEFAULT_CONNECTOR_MAX_RESPONSE_BYTES;
35
55
  async connect(config, auth) {
36
- this.config = config;
56
+ const validated = WebhookConnectorConfigSchema.parse(config);
57
+ const parsedUrl = requireHttpUrl(validated.url, 'WebhookConnector url');
58
+ this.config = validated;
37
59
  this.auth = auth;
38
- this.url = config.url;
39
- this.secret = config.secret;
40
- this.defaultHeaders = config.defaultHeaders ?? {};
41
- this.timeoutMs = config.timeoutMs ?? 30_000;
60
+ this.url = validated.url;
61
+ this.origin = parsedUrl.origin;
62
+ this.secret = validated.secret;
63
+ this.defaultHeaders = { ...(validated.defaultHeaders ?? {}) };
64
+ this.timeoutMs = validateConnectorTimeoutMs(validated.timeoutMs, 'WebhookConnector timeoutMs');
65
+ this.maxResponseBytes = validateConnectorMaxResponseBytes(validated.maxResponseBytes, 'WebhookConnector maxResponseBytes');
42
66
  if (auth?.type === 'bearer' && auth.credentials?.token) {
43
67
  this.defaultHeaders.Authorization = `Bearer ${auth.credentials.token}`;
44
68
  }
45
- this.log.info('Webhook connector connected', { 'namzu.connector.url': this.url });
69
+ this.log.info('Webhook connector connected', {
70
+ 'namzu.connector.url': this.url,
71
+ });
46
72
  }
47
73
  async disconnect() {
48
74
  this.config = null;
49
75
  this.auth = undefined;
50
76
  this.url = '';
77
+ this.origin = '';
51
78
  this.secret = undefined;
52
79
  this.defaultHeaders = {};
53
80
  this.log.info('Webhook connector disconnected');
54
81
  }
55
- async healthCheck() {
82
+ async healthCheck(options) {
56
83
  if (!this.url)
57
84
  return false;
85
+ let operation;
58
86
  try {
59
- const controller = new AbortController();
60
- const timeout = setTimeout(() => controller.abort(), 5_000);
61
- const response = await fetch(this.url, {
87
+ operation = new ConnectorHttpOperation(options?.signal, CONNECTOR_HEALTH_TIMEOUT_MS, 'Webhook connector health check');
88
+ const activeOperation = operation;
89
+ const response = await activeOperation.run(() => fetch(this.url, {
62
90
  method: 'HEAD',
63
- signal: controller.signal,
64
- });
65
- clearTimeout(timeout);
91
+ redirect: 'manual',
92
+ signal: activeOperation.signal,
93
+ }));
66
94
  return response.ok || response.status < 500;
67
95
  }
68
96
  catch {
69
97
  return false;
70
98
  }
99
+ finally {
100
+ operation?.close();
101
+ }
71
102
  }
72
- async execute(method, input) {
103
+ async execute(method, input, options) {
73
104
  this.requireMethod(method);
74
- const validated = this.validateInput(this.requireMethod(method), input);
75
- const { result, durationMs } = await this.measureExecution(() => this.doSend(validated));
76
- return {
77
- success: result.status >= 200 && result.status < 400,
78
- output: result,
79
- durationMs,
80
- metadata: {
81
- status: result.status,
82
- deliveredAt: result.deliveredAt,
83
- },
84
- };
105
+ const validated = (await this.validateInput(this.requireMethod(method), input, options));
106
+ const startedAt = performance.now();
107
+ if (options?.signal?.aborted) {
108
+ return this.notStarted(options.signal.reason, startedAt);
109
+ }
110
+ return this.doSend(validated, options, startedAt);
85
111
  }
86
- async doSend(input) {
112
+ async doSend(input, options, startedAt) {
87
113
  const targetUrl = input.url ?? this.url;
114
+ requireSameOrigin(targetUrl, this.origin, 'WebhookConnector request URL');
115
+ requireSafeConnectorInputHeaders(input.headers, 'WebhookConnector request headers');
88
116
  const bodyStr = JSON.stringify(input.payload);
89
117
  const headers = {
90
118
  'Content-Type': 'application/json',
@@ -95,32 +123,124 @@ export class WebhookConnector extends BaseConnector {
95
123
  const signature = createHmac('sha256', this.secret).update(bodyStr).digest('hex');
96
124
  headers['X-Webhook-Signature'] = `sha256=${signature}`;
97
125
  }
98
- const controller = new AbortController();
99
- const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
126
+ let operation;
100
127
  try {
101
- const response = await fetch(targetUrl, {
102
- method: 'POST',
103
- headers,
104
- body: bodyStr,
105
- signal: controller.signal,
106
- });
128
+ try {
129
+ operation = new ConnectorHttpOperation(options?.signal, this.timeoutMs, 'Webhook connector POST');
130
+ }
131
+ catch (error) {
132
+ return this.notStarted(error, startedAt);
133
+ }
134
+ let response;
135
+ try {
136
+ const activeOperation = operation;
137
+ response = await activeOperation.run(() => fetch(targetUrl, {
138
+ method: 'POST',
139
+ headers,
140
+ body: bodyStr,
141
+ redirect: 'manual',
142
+ signal: activeOperation.signal,
143
+ }));
144
+ }
145
+ catch (error) {
146
+ return this.unknownOutcome(error, startedAt);
147
+ }
148
+ const deliveredAt = Date.now();
149
+ const metadata = {
150
+ status: response.status,
151
+ deliveredAt,
152
+ remoteOutcome: 'response_received',
153
+ retrySafety: 'unsafe',
154
+ bodyAvailable: true,
155
+ };
156
+ const redirectLocation = response.headers.get('location');
157
+ if (redirectLocation)
158
+ metadata.redirectLocation = redirectLocation;
107
159
  let body;
108
- const contentType = response.headers.get('content-type') ?? '';
109
- if (contentType.includes('application/json')) {
110
- body = await response.json();
160
+ try {
161
+ body = await readConnectorResponseBody(response, operation, this.maxResponseBytes);
111
162
  }
112
- else {
113
- body = await response.text();
163
+ catch (error) {
164
+ const output = {
165
+ status: response.status,
166
+ body: null,
167
+ deliveredAt,
168
+ bodyAvailable: false,
169
+ bodyError: `Response body unavailable: ${this.errorText(error)}`,
170
+ remoteOutcome: 'response_received',
171
+ retrySafety: 'unsafe',
172
+ };
173
+ metadata.bodyAvailable = false;
174
+ return {
175
+ success: response.status >= 200 && response.status < 300,
176
+ output,
177
+ ...(response.status < 200 || response.status >= 300
178
+ ? { error: this.statusError(response, true) }
179
+ : {}),
180
+ durationMs: this.duration(startedAt),
181
+ metadata,
182
+ };
114
183
  }
115
- return {
184
+ const output = {
116
185
  status: response.status,
117
186
  body,
118
- deliveredAt: Date.now(),
187
+ deliveredAt,
188
+ bodyAvailable: true,
189
+ remoteOutcome: 'response_received',
190
+ retrySafety: 'unsafe',
191
+ };
192
+ return {
193
+ success: response.status >= 200 && response.status < 300,
194
+ output,
195
+ ...(response.status < 200 || response.status >= 300
196
+ ? { error: this.statusError(response, false) }
197
+ : {}),
198
+ durationMs: this.duration(startedAt),
199
+ metadata,
119
200
  };
120
201
  }
121
202
  finally {
122
- clearTimeout(timeout);
203
+ operation?.close();
123
204
  }
124
205
  }
206
+ notStarted(reason, startedAt) {
207
+ return {
208
+ success: false,
209
+ output: null,
210
+ error: `Webhook POST was cancelled before it started: ${this.errorText(reason)}. No remote request was started; retry is safe.`,
211
+ durationMs: this.duration(startedAt),
212
+ metadata: {
213
+ remoteOutcome: 'not_started',
214
+ retrySafety: 'safe',
215
+ bodyAvailable: false,
216
+ },
217
+ };
218
+ }
219
+ unknownOutcome(error, startedAt) {
220
+ return {
221
+ success: false,
222
+ output: null,
223
+ error: `Webhook POST produced no response: ${this.errorText(error)}. The remote outcome is unknown. Do not automatically retry this request; it may duplicate a delivery.`,
224
+ durationMs: this.duration(startedAt),
225
+ metadata: {
226
+ remoteOutcome: 'unknown',
227
+ retrySafety: 'unsafe',
228
+ bodyAvailable: false,
229
+ },
230
+ };
231
+ }
232
+ statusError(response, bodyMissing) {
233
+ if (response.status >= 300 && response.status < 400) {
234
+ const location = response.headers.get('location');
235
+ return `HTTP ${response.status}: ${response.statusText}. The redirect was not followed because webhook requests cannot leave their configured origin.${location ? ` Location: ${location}.` : ''} Do not automatically retry; the webhook may already have been applied.`;
236
+ }
237
+ return `HTTP ${response.status}: ${response.statusText}.${bodyMissing ? ' The response body was unavailable.' : ''} Do not automatically retry; the webhook may already have been applied.`;
238
+ }
239
+ duration(startedAt) {
240
+ return Math.round(performance.now() - startedAt);
241
+ }
242
+ errorText(error) {
243
+ return error instanceof Error ? error.message : String(error);
244
+ }
125
245
  }
126
246
  //# sourceMappingURL=webhook.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../../src/connector/builtins/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;CAC3D,CAAC,CAAA;AAEF,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAA;AAEF,wEAAwE;AACxE,MAAM,oBAAoB,GAAG,aAAa,CAAC,cAAc,CAAC,CAAA;AAE1D,MAAM,OAAO,gBAAiB,SAAQ,aAAqC;IACjE,EAAE,GAAG,oBAAoB,CAAA;IACzB,IAAI,GAAG,mBAAmB,CAAA;IAC1B,WAAW,GAAG,0EAA0E,CAAA;IACxF,cAAc,GAAmB,SAAS,CAAA;IAC1C,YAAY,GAAG,4BAA4B,CAAA;IAC3C,OAAO,GAAsB;QACrC;YACC,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,8CAA8C;YAC3D,WAAW,EAAE,sBAAsB;SACnC;KACD,CAAA;IAEO,GAAG,GAAG,EAAE,CAAA;IACR,MAAM,CAAoB;IAC1B,cAAc,GAA2B,EAAE,CAAA;IAC3C,SAAS,GAAG,MAAM,CAAA;IAE1B,KAAK,CAAC,OAAO,CAAC,MAA8B,EAAE,IAAiB;QAC9D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAA;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QAC3B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAA;QACjD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAA;QAE3C,IAAI,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;YACxD,IAAI,CAAC,cAAc,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;QACvE,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,qBAAqB,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAClF,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAA;QACrB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAA;QACb,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;QACvB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAA;QACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,CAAC,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAA;QAC3B,IAAI,CAAC;YACJ,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;YACxC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAA;YAC3D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBACtC,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,UAAU,CAAC,MAAM;aACzB,CAAC,CAAA;YACF,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAA;QACb,CAAC;IACF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,KAAc;QAC3C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,CAAqB,CAAA;QAE3F,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;QAExF,OAAO;YACN,OAAO,EAAE,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;YACpD,MAAM,EAAE,MAAM;YACd,UAAU;YACV,QAAQ,EAAE;gBACT,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;aAC/B;SACD,CAAA;IACF,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,KAAuB;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAE7C,MAAM,OAAO,GAA2B;YACvC,cAAc,EAAE,kBAAkB;YAClC,GAAG,IAAI,CAAC,cAAc;YACtB,GAAG,KAAK,CAAC,OAAO;SAChB,CAAA;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACjF,OAAO,CAAC,qBAAqB,CAAC,GAAG,UAAU,SAAS,EAAE,CAAA;QACvD,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QAEpE,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;gBACvC,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,UAAU,CAAC,MAAM;aACzB,CAAC,CAAA;YAEF,IAAI,IAAa,CAAA;YACjB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;YAC9D,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC9C,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAC7B,CAAC;iBAAM,CAAC;gBACP,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAC7B,CAAC;YAED,OAAO;gBACN,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,IAAI;gBACJ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;aACvB,CAAA;QACF,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,OAAO,CAAC,CAAA;QACtB,CAAC;IACF,CAAC;CACD"}
1
+ {"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../../src/connector/builtins/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAavB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,EACtB,oCAAoC,EACpC,oCAAoC,EACpC,yBAAyB,EACzB,cAAc,EACd,gCAAgC,EAChC,iBAAiB,EACjB,iCAAiC,EACjC,0BAA0B,GAC1B,MAAM,sBAAsB,CAAA;AAE7B,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,GAAG,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,8BAA8B,CAAC;IAC5E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/C,gBAAgB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,aAAa,CAAC;SAClB,QAAQ,EAAE;SACV,OAAO,CAAC,oCAAoC,CAAC;IAC/C,SAAS,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,aAAa,CAAC;SAClB,QAAQ,EAAE;SACV,OAAO,CAAC,oCAAoC,CAAC;CAC/C,CAAC,CAAA;AAEF,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAA;AAEF,wEAAwE;AACxE,MAAM,oBAAoB,GAAG,aAAa,CAAC,cAAc,CAAC,CAAA;AAE1D,MAAM,OAAO,gBAAiB,SAAQ,aAAqC;IACjE,EAAE,GAAG,oBAAoB,CAAA;IACzB,IAAI,GAAG,mBAAmB,CAAA;IAC1B,WAAW,GAAG,0EAA0E,CAAA;IACxF,cAAc,GAAmB,SAAS,CAAA;IACjC,aAAa,GAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAChE,YAAY,GAAG,4BAA4B,CAAA;IAC3C,OAAO,GAAsB;QACrC;YACC,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,8CAA8C;YAC3D,WAAW,EAAE,sBAAsB;SACnC;KACD,CAAA;IAEO,GAAG,GAAG,EAAE,CAAA;IACR,MAAM,GAAG,EAAE,CAAA;IACX,MAAM,CAAoB;IAC1B,cAAc,GAA2B,EAAE,CAAA;IAC3C,SAAS,GAAG,oCAAoC,CAAA;IAChD,gBAAgB,GAAG,oCAAoC,CAAA;IAE/D,KAAK,CAAC,OAAO,CAAC,MAA8B,EAAE,IAAiB;QAC9D,MAAM,SAAS,GAAG,4BAA4B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC5D,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAA;QACvE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,CAAA;QACxB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;QAC9B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;QAC9B,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,CAAA;QAC7D,IAAI,CAAC,SAAS,GAAG,0BAA0B,CAAC,SAAS,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAA;QAC9F,IAAI,CAAC,gBAAgB,GAAG,iCAAiC,CACxD,SAAS,CAAC,gBAAgB,EAC1B,mCAAmC,CACnC,CAAA;QAED,IAAI,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;YACxD,IAAI,CAAC,cAAc,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;QACvE,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE;YAC5C,qBAAqB,EAAE,IAAI,CAAC,GAAG;SAC/B,CAAC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAA;QACrB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAA;QACb,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAChB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;QACvB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAA;QACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAmC;QACpD,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAA;QAC3B,IAAI,SAA6C,CAAA;QACjD,IAAI,CAAC;YACJ,SAAS,GAAG,IAAI,sBAAsB,CACrC,OAAO,EAAE,MAAM,EACf,2BAA2B,EAC3B,gCAAgC,CAChC,CAAA;YACD,MAAM,eAAe,GAAG,SAAS,CAAA;YACjC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,CAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBACf,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,eAAe,CAAC,MAAM;aAC9B,CAAC,CACF,CAAA;YACD,OAAO,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAA;QACb,CAAC;gBAAS,CAAC;YACV,SAAS,EAAE,KAAK,EAAE,CAAA;QACnB,CAAC;IACF,CAAC;IAED,KAAK,CAAC,OAAO,CACZ,MAAc,EACd,KAAc,EACd,OAAmC;QAEnC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,CAC1C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAC1B,KAAK,EACL,OAAO,CACP,CAAqB,CAAA;QACtB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QACnC,IAAI,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QACzD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IAClD,CAAC;IAEO,KAAK,CAAC,MAAM,CACnB,KAAuB,EACvB,OAA8C,EAC9C,SAAiB;QAEjB,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;QACvC,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAA;QACzE,gCAAgC,CAAC,KAAK,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAA;QACnF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAE7C,MAAM,OAAO,GAA2B;YACvC,cAAc,EAAE,kBAAkB;YAClC,GAAG,IAAI,CAAC,cAAc;YACtB,GAAG,KAAK,CAAC,OAAO;SAChB,CAAA;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACjF,OAAO,CAAC,qBAAqB,CAAC,GAAG,UAAU,SAAS,EAAE,CAAA;QACvD,CAAC;QAED,IAAI,SAA6C,CAAA;QAEjD,IAAI,CAAC;YACJ,IAAI,CAAC;gBACJ,SAAS,GAAG,IAAI,sBAAsB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,SAAS,EACd,wBAAwB,CACxB,CAAA;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YACzC,CAAC;YACD,IAAI,QAAkB,CAAA;YACtB,IAAI,CAAC;gBACJ,MAAM,eAAe,GAAG,SAAS,CAAA;gBACjC,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,CACzC,KAAK,CAAC,SAAS,EAAE;oBAChB,MAAM,EAAE,MAAM;oBACd,OAAO;oBACP,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,eAAe,CAAC,MAAM;iBAC9B,CAAC,CACF,CAAA;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YAC7C,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC9B,MAAM,QAAQ,GAA+B;gBAC5C,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,WAAW;gBACX,aAAa,EAAE,mBAAmB;gBAClC,WAAW,EAAE,QAAQ;gBACrB,aAAa,EAAE,IAAI;aACnB,CAAA;YACD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YACzD,IAAI,gBAAgB;gBAAE,QAAQ,CAAC,gBAAgB,GAAG,gBAAgB,CAAA;YAClE,IAAI,IAAa,CAAA;YACjB,IAAI,CAAC;gBACJ,IAAI,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAA;YACnF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAsB;oBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,IAAI,EAAE,IAAI;oBACV,WAAW;oBACX,aAAa,EAAE,KAAK;oBACpB,SAAS,EAAE,8BAA8B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;oBAChE,aAAa,EAAE,mBAAmB;oBAClC,WAAW,EAAE,QAAQ;iBACrB,CAAA;gBACD,QAAQ,CAAC,aAAa,GAAG,KAAK,CAAA;gBAC9B,OAAO;oBACN,OAAO,EAAE,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;oBACxD,MAAM;oBACN,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;wBAClD,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE;wBAC7C,CAAC,CAAC,EAAE,CAAC;oBACN,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;oBACpC,QAAQ;iBACR,CAAA;YACF,CAAC;YAED,MAAM,MAAM,GAAsB;gBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,IAAI;gBACJ,WAAW;gBACX,aAAa,EAAE,IAAI;gBACnB,aAAa,EAAE,mBAAmB;gBAClC,WAAW,EAAE,QAAQ;aACrB,CAAA;YACD,OAAO;gBACN,OAAO,EAAE,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;gBACxD,MAAM;gBACN,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;oBAClD,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE;oBAC9C,CAAC,CAAC,EAAE,CAAC;gBACN,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACpC,QAAQ;aACR,CAAA;QACF,CAAC;gBAAS,CAAC;YACV,SAAS,EAAE,KAAK,EAAE,CAAA;QACnB,CAAC;IACF,CAAC;IAEO,UAAU,CAAC,MAAe,EAAE,SAAiB;QACpD,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,iDAAiD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iDAAiD;YAC/H,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACpC,QAAQ,EAAE;gBACT,aAAa,EAAE,aAAa;gBAC5B,WAAW,EAAE,MAAM;gBACnB,aAAa,EAAE,KAAK;aACpB;SACD,CAAA;IACF,CAAC;IAEO,cAAc,CAAC,KAAc,EAAE,SAAiB;QACvD,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,sCAAsC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,wGAAwG;YAC1K,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACpC,QAAQ,EAAE;gBACT,aAAa,EAAE,SAAS;gBACxB,WAAW,EAAE,QAAQ;gBACrB,aAAa,EAAE,KAAK;aACpB;SACD,CAAA;IACF,CAAC;IAEO,WAAW,CAAC,QAAkB,EAAE,WAAoB;QAC3D,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YACjD,OAAO,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,iGAAiG,QAAQ,CAAC,CAAC,CAAC,cAAc,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,yEAAyE,CAAA;QAC1Q,CAAC;QACD,OAAO,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,IAAI,WAAW,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,EAAE,yEAAyE,CAAA;IAC5L,CAAC;IAEO,QAAQ,CAAC,SAAiB;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAA;IACjD,CAAC;IAEO,SAAS,CAAC,KAAc;QAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9D,CAAC;CACD"}
@@ -0,0 +1,11 @@
1
+ import type { ConnectorOperationOptions } from '../types/connector/index.js';
2
+ declare const MANAGER_VALIDATED_INPUT: unique symbol;
3
+ export type ManagedConnectorOperationOptions = ConnectorOperationOptions & {
4
+ readonly [MANAGER_VALIDATED_INPUT]: true;
5
+ };
6
+ /** Internal hand-off: the manager already produced the method's canonical input. */
7
+ export declare function managedConnectorOptions(options: ConnectorOperationOptions): ManagedConnectorOperationOptions;
8
+ /** Used by BaseConnector helpers so direct calls still validate exactly once. */
9
+ export declare function hasManagerValidatedInput(options: ConnectorOperationOptions | undefined): options is ManagedConnectorOperationOptions;
10
+ export {};
11
+ //# sourceMappingURL=execution-contract.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-contract.d.ts","sourceRoot":"","sources":["../../src/connector/execution-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAE5E,QAAA,MAAM,uBAAuB,eAAoD,CAAA;AAEjF,MAAM,MAAM,gCAAgC,GAAG,yBAAyB,GAAG;IAC1E,QAAQ,CAAC,CAAC,uBAAuB,CAAC,EAAE,IAAI,CAAA;CACxC,CAAA;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,yBAAyB,GAChC,gCAAgC,CAKlC;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAC5C,OAAO,IAAI,gCAAgC,CAK7C"}
@@ -0,0 +1,14 @@
1
+ const MANAGER_VALIDATED_INPUT = Symbol('namzu.connector.manager-validated-input');
2
+ /** Internal hand-off: the manager already produced the method's canonical input. */
3
+ export function managedConnectorOptions(options) {
4
+ return {
5
+ ...options,
6
+ [MANAGER_VALIDATED_INPUT]: true,
7
+ };
8
+ }
9
+ /** Used by BaseConnector helpers so direct calls still validate exactly once. */
10
+ export function hasManagerValidatedInput(options) {
11
+ return Boolean(options &&
12
+ options[MANAGER_VALIDATED_INPUT] === true);
13
+ }
14
+ //# sourceMappingURL=execution-contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-contract.js","sourceRoot":"","sources":["../../src/connector/execution-contract.ts"],"names":[],"mappings":"AAEA,MAAM,uBAAuB,GAAG,MAAM,CAAC,yCAAyC,CAAC,CAAA;AAMjF,oFAAoF;AACpF,MAAM,UAAU,uBAAuB,CACtC,OAAkC;IAElC,OAAO;QACN,GAAG,OAAO;QACV,CAAC,uBAAuB,CAAC,EAAE,IAAI;KAC/B,CAAA;AACF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,wBAAwB,CACvC,OAA8C;IAE9C,OAAO,OAAO,CACb,OAAO;QACL,OAAqD,CAAC,uBAAuB,CAAC,KAAK,IAAI,CACzF,CAAA;AACF,CAAC"}
@@ -0,0 +1,48 @@
1
+ export declare const DEFAULT_CONNECTOR_REQUEST_TIMEOUT_MS = 30000;
2
+ export declare const CONNECTOR_HEALTH_TIMEOUT_MS = 5000;
3
+ export declare const DEFAULT_CONNECTOR_MAX_RESPONSE_BYTES: number;
4
+ export declare function validateConnectorTimeoutMs(value: number, label: string): number;
5
+ export declare function validateConnectorMaxResponseBytes(value: number, label: string): number;
6
+ export declare function requireSafeConnectorInputHeaders(headers: Readonly<Record<string, string>> | undefined, label: string): void;
7
+ export declare function requireHttpUrl(value: string, label: string): URL;
8
+ export declare function requireSameOrigin(value: string, configuredOrigin: string, label: string): URL;
9
+ /**
10
+ * Read a platform response without allocating beyond the connector's byte
11
+ * budget. `Content-Length` is only an early refusal; the streaming count is
12
+ * authoritative because chunked and dishonest responses omit or understate it.
13
+ */
14
+ export declare function readConnectorResponseBody(response: Response, operation: ConnectorHttpOperation, maxBytes: number): Promise<unknown>;
15
+ /**
16
+ * One whole HTTP operation boundary: fetch and body reads share one clock.
17
+ *
18
+ * The promise race is intentional. Forwarding a signal cannot settle a custom
19
+ * fetch/body implementation that ignores it, and a connector lifecycle is a
20
+ * public entry point independent of the run executor's own tool deadline.
21
+ */
22
+ export declare class ConnectorHttpOperation {
23
+ readonly signal: AbortSignal;
24
+ private readonly controller;
25
+ private readonly aborted;
26
+ private readonly callerSignal;
27
+ private readonly onCallerAbort;
28
+ private readonly timer;
29
+ private rejectAbort;
30
+ private hasCause;
31
+ private firstCause;
32
+ constructor(callerSignal: AbortSignal | undefined, timeoutMs: number, label: string);
33
+ get cause(): unknown;
34
+ wait<T>(operation: Promise<T>): Promise<T>;
35
+ /**
36
+ * Check authority before starting foreign work, then again after it wins.
37
+ *
38
+ * Passing an already-created promise to `wait()` cannot prevent the work
39
+ * that created it from starting. Callers use this thunk form at every
40
+ * network, resolver and stream boundary where admission matters.
41
+ */
42
+ run<T>(start: () => Promise<T>): Promise<T>;
43
+ throwIfStopped(): void;
44
+ close(): void;
45
+ cancel(reason: unknown): void;
46
+ private stop;
47
+ }
48
+ //# sourceMappingURL=http-operation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-operation.d.ts","sourceRoot":"","sources":["../../src/connector/http-operation.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,oCAAoC,QAAS,CAAA;AAC1D,eAAO,MAAM,2BAA2B,OAAQ,CAAA;AAChD,eAAO,MAAM,oCAAoC,QAAkB,CAAA;AAEnE,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOtF;AAED,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EACrD,KAAK,EAAE,MAAM,GACX,IAAI,CAON;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAMhE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAQ7F;AAcD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC9C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,sBAAsB,EACjC,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAkDlB;AAED;;;;;;GAMG;AACH,qBAAa,sBAAsB;IAClC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,UAAU,CAAS;gBAEf,YAAY,EAAE,WAAW,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAkBnF,IAAI,KAAK,IAAI,OAAO,CAEnB;IAEK,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBhD;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjD,cAAc,IAAI,IAAI;IAItB,KAAK,IAAI,IAAI;IAOb,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAI7B,OAAO,CAAC,IAAI;CAUZ"}
@@ -0,0 +1,205 @@
1
+ const MAX_TIMER_DELAY_MS = 2_147_483_647;
2
+ const MAX_RESPONSE_BYTES = 2_147_483_647;
3
+ // These headers can change where an already-validated URL is routed. Connector
4
+ // method input is commonly model-authored, while the base URL and credentials
5
+ // are host-configured. Letting the former supply `Host` would attach the
6
+ // latter's bearer/cookie headers to a different virtual host on the same
7
+ // socket. Proxy credentials are equally outside method-input authority.
8
+ const FORBIDDEN_CONNECTOR_INPUT_HEADERS = new Set([
9
+ 'host',
10
+ 'proxy-authorization',
11
+ 'proxy-connection',
12
+ ]);
13
+ export const DEFAULT_CONNECTOR_REQUEST_TIMEOUT_MS = 30_000;
14
+ export const CONNECTOR_HEALTH_TIMEOUT_MS = 5_000;
15
+ export const DEFAULT_CONNECTOR_MAX_RESPONSE_BYTES = 2 * 1024 * 1024;
16
+ export function validateConnectorTimeoutMs(value, label) {
17
+ if (!Number.isInteger(value) || value < 1 || value > MAX_TIMER_DELAY_MS) {
18
+ throw new Error(`${label} must be an integer from 1 to ${MAX_TIMER_DELAY_MS}; received ${String(value)}`);
19
+ }
20
+ return value;
21
+ }
22
+ export function validateConnectorMaxResponseBytes(value, label) {
23
+ if (!Number.isInteger(value) || value < 1 || value > MAX_RESPONSE_BYTES) {
24
+ throw new Error(`${label} must be an integer from 1 to ${MAX_RESPONSE_BYTES}; received ${String(value)}`);
25
+ }
26
+ return value;
27
+ }
28
+ export function requireSafeConnectorInputHeaders(headers, label) {
29
+ if (!headers)
30
+ return;
31
+ for (const name of Object.keys(headers)) {
32
+ if (FORBIDDEN_CONNECTOR_INPUT_HEADERS.has(name.toLowerCase())) {
33
+ throw new Error(`${label} cannot set routing header "${name}"`);
34
+ }
35
+ }
36
+ }
37
+ export function requireHttpUrl(value, label) {
38
+ const parsed = new URL(value);
39
+ if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
40
+ throw new Error(`${label} must use http: or https:; received ${parsed.protocol}`);
41
+ }
42
+ return parsed;
43
+ }
44
+ export function requireSameOrigin(value, configuredOrigin, label) {
45
+ const parsed = requireHttpUrl(value, label);
46
+ if (parsed.origin !== configuredOrigin) {
47
+ throw new Error(`${label} must stay on the configured connector origin ${configuredOrigin}; received ${parsed.origin}`);
48
+ }
49
+ return parsed;
50
+ }
51
+ function timeoutError(label, timeoutMs) {
52
+ const error = new Error(`${label} timed out after ${timeoutMs}ms`);
53
+ error.name = 'TimeoutError';
54
+ return error;
55
+ }
56
+ function responseSizeError(maxBytes) {
57
+ const error = new Error(`Response body exceeded the configured ${maxBytes}-byte limit`);
58
+ error.name = 'ResponseSizeError';
59
+ return error;
60
+ }
61
+ /**
62
+ * Read a platform response without allocating beyond the connector's byte
63
+ * budget. `Content-Length` is only an early refusal; the streaming count is
64
+ * authoritative because chunked and dishonest responses omit or understate it.
65
+ */
66
+ export async function readConnectorResponseBody(response, operation, maxBytes) {
67
+ const contentType = response.headers.get('content-type') ?? '';
68
+ const contentLength = response.headers.get('content-length');
69
+ if (contentLength !== null) {
70
+ const declaredBytes = Number(contentLength);
71
+ if (Number.isFinite(declaredBytes) && declaredBytes > maxBytes) {
72
+ const error = responseSizeError(maxBytes);
73
+ operation.cancel(error);
74
+ throw error;
75
+ }
76
+ }
77
+ // A real fetch Response has a byte stream whenever it has a body. The
78
+ // fallback preserves compatibility with body-less responses and injected
79
+ // Response-shaped test doubles; there are no remote bytes to stream when
80
+ // the platform reports `body === null`.
81
+ if (!response.body) {
82
+ return operation.run(() => contentType.includes('application/json') ? response.json() : response.text());
83
+ }
84
+ const reader = response.body.getReader();
85
+ const chunks = [];
86
+ let totalBytes = 0;
87
+ try {
88
+ while (true) {
89
+ const { done, value } = await operation.run(() => reader.read());
90
+ if (done)
91
+ break;
92
+ totalBytes += value.byteLength;
93
+ if (totalBytes > maxBytes) {
94
+ const error = responseSizeError(maxBytes);
95
+ void reader.cancel(error).catch(() => undefined);
96
+ operation.cancel(error);
97
+ throw error;
98
+ }
99
+ chunks.push(value);
100
+ }
101
+ }
102
+ finally {
103
+ reader.releaseLock();
104
+ }
105
+ const bytes = new Uint8Array(totalBytes);
106
+ let offset = 0;
107
+ for (const chunk of chunks) {
108
+ bytes.set(chunk, offset);
109
+ offset += chunk.byteLength;
110
+ }
111
+ const text = new TextDecoder().decode(bytes);
112
+ return contentType.includes('application/json') ? JSON.parse(text) : text;
113
+ }
114
+ /**
115
+ * One whole HTTP operation boundary: fetch and body reads share one clock.
116
+ *
117
+ * The promise race is intentional. Forwarding a signal cannot settle a custom
118
+ * fetch/body implementation that ignores it, and a connector lifecycle is a
119
+ * public entry point independent of the run executor's own tool deadline.
120
+ */
121
+ export class ConnectorHttpOperation {
122
+ signal;
123
+ controller = new AbortController();
124
+ aborted;
125
+ callerSignal;
126
+ onCallerAbort;
127
+ timer;
128
+ rejectAbort;
129
+ hasCause = false;
130
+ firstCause;
131
+ constructor(callerSignal, timeoutMs, label) {
132
+ callerSignal?.throwIfAborted();
133
+ this.signal = this.controller.signal;
134
+ this.callerSignal = callerSignal;
135
+ this.aborted = new Promise((_resolve, reject) => {
136
+ this.rejectAbort = reject;
137
+ });
138
+ // Cancellation may arrive between construction and the first `wait`.
139
+ // Keep that owned rejection observed even when the next `run` refuses
140
+ // before attaching a race handler.
141
+ void this.aborted.catch(() => undefined);
142
+ this.onCallerAbort = callerSignal ? () => this.stop(callerSignal.reason) : undefined;
143
+ callerSignal?.addEventListener('abort', this.onCallerAbort, {
144
+ once: true,
145
+ });
146
+ this.timer = setTimeout(() => this.stop(timeoutError(label, timeoutMs)), timeoutMs);
147
+ }
148
+ get cause() {
149
+ return this.firstCause;
150
+ }
151
+ async wait(operation) {
152
+ this.throwIfStopped();
153
+ try {
154
+ const result = await Promise.race([operation, this.aborted]);
155
+ // A foreign promise and caller abort can settle in the same turn. The
156
+ // promise race may pick the value first even though authority has
157
+ // already been withdrawn; never publish that late value as success.
158
+ this.throwIfStopped();
159
+ return result;
160
+ }
161
+ catch (error) {
162
+ if (this.hasCause &&
163
+ error instanceof Error &&
164
+ (error.name === 'AbortError' || error.name === 'TimeoutError')) {
165
+ throw this.firstCause;
166
+ }
167
+ throw error;
168
+ }
169
+ }
170
+ /**
171
+ * Check authority before starting foreign work, then again after it wins.
172
+ *
173
+ * Passing an already-created promise to `wait()` cannot prevent the work
174
+ * that created it from starting. Callers use this thunk form at every
175
+ * network, resolver and stream boundary where admission matters.
176
+ */
177
+ async run(start) {
178
+ this.throwIfStopped();
179
+ return this.wait(start());
180
+ }
181
+ throwIfStopped() {
182
+ this.signal.throwIfAborted();
183
+ }
184
+ close() {
185
+ clearTimeout(this.timer);
186
+ if (this.callerSignal && this.onCallerAbort) {
187
+ this.callerSignal.removeEventListener('abort', this.onCallerAbort);
188
+ }
189
+ }
190
+ cancel(reason) {
191
+ this.stop(reason);
192
+ }
193
+ stop(reason) {
194
+ if (this.hasCause)
195
+ return;
196
+ this.hasCause = true;
197
+ this.firstCause = reason;
198
+ // Reject the owned wait before aborting transport. A fetch implementation
199
+ // may synchronously translate transport abort into a generic AbortError;
200
+ // that fallout must not erase the caller/deadline cause that won first.
201
+ this.rejectAbort(reason);
202
+ this.controller.abort(reason);
203
+ }
204
+ }
205
+ //# sourceMappingURL=http-operation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-operation.js","sourceRoot":"","sources":["../../src/connector/http-operation.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/connector/mcp/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EACX,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,MAAM,gCAAgC,CAAA;AAEvC,OAAO,KAAK,EAAe,cAAc,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACxF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,CAAC,OAAO,CAOnE;AAwXD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,GAAG,aAAa,CAMtE;AAED,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM;AAClB;;;;GAIG;AACH,mBAAmB,UAAQ,GACzB,cAAc,CA+BhB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,GAAG,iBAAiB,CAU/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACd,UAAU,CAcZ;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAgD3E;AAaD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAmB3E"}
1
+ {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/connector/mcp/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EACX,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,MAAM,gCAAgC,CAAA;AAEvC,OAAO,KAAK,EAAe,cAAc,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACxF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,CAAC,OAAO,CAOnE;AAwXD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,GAAG,aAAa,CAMtE;AAED,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM;AAClB;;;;GAIG;AACH,mBAAmB,UAAQ,GACzB,cAAc,CAiChB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,GAAG,iBAAiB,CAa/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACd,UAAU,CAcZ;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAgD3E;AAaD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAmB3E"}