@the-open-engine/zeroshot 6.38.0 → 6.39.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 (381) hide show
  1. package/cli/event-copy.js +8 -7
  2. package/cli/event-copy.ts +12 -0
  3. package/cli/index.js +7 -31
  4. package/cli/json-export.js +61 -64
  5. package/cli/json-export.ts +112 -0
  6. package/cli/message-formatter-utils.js +68 -56
  7. package/cli/message-formatter-utils.ts +121 -0
  8. package/cli/message-formatters-normal.js +124 -259
  9. package/cli/message-formatters-normal.ts +250 -0
  10. package/cli/message-formatters-watch.js +81 -84
  11. package/cli/message-formatters-watch.ts +189 -0
  12. package/lib/agent-cli-provider/adapters/codex.d.ts.map +1 -1
  13. package/lib/agent-cli-provider/adapters/codex.js +3 -1
  14. package/lib/agent-cli-provider/adapters/codex.js.map +1 -1
  15. package/lib/cluster/generated/protocol-schema.cjs +1 -1
  16. package/lib/cluster/generated/protocol-schema.mjs +1 -1
  17. package/lib/cluster/generated/protocol.d.cts +8 -0
  18. package/lib/cluster/generated/protocol.d.mts +8 -0
  19. package/lib/cluster/generated/protocol.d.ts +8 -0
  20. package/lib/clusters-registry.d.ts +23 -0
  21. package/lib/clusters-registry.js +17 -29
  22. package/lib/completion.d.ts +12 -0
  23. package/lib/completion.js +84 -94
  24. package/lib/compose-utils.d.ts +32 -0
  25. package/lib/compose-utils.js +57 -72
  26. package/lib/detached-startup.d.ts +83 -0
  27. package/lib/detached-startup.js +231 -302
  28. package/lib/docker-config.d.ts +43 -0
  29. package/lib/docker-config.js +150 -325
  30. package/lib/docker-env-auth.d.ts +17 -0
  31. package/lib/docker-env-auth.js +75 -0
  32. package/lib/git-remote-utils.d.ts +48 -0
  33. package/lib/git-remote-utils.js +147 -213
  34. package/lib/id-detector.d.ts +15 -0
  35. package/lib/id-detector.js +37 -41
  36. package/lib/path-check.d.ts +30 -0
  37. package/lib/path-check.js +42 -45
  38. package/lib/process-liveness.d.ts +16 -0
  39. package/lib/process-liveness.js +19 -12
  40. package/lib/provider-credential-path.d.ts +16 -0
  41. package/lib/provider-credential-path.js +31 -29
  42. package/lib/provider-defaults.d.ts +30 -0
  43. package/lib/provider-defaults.js +47 -42
  44. package/lib/provider-detection.d.ts +11 -0
  45. package/lib/provider-detection.js +91 -54
  46. package/lib/provider-names.d.ts +38 -0
  47. package/lib/provider-names.js +56 -64
  48. package/lib/repo-settings.d.ts +28 -0
  49. package/lib/repo-settings.js +83 -59
  50. package/lib/run-mode.d.ts +21 -0
  51. package/lib/run-mode.js +21 -20
  52. package/lib/run-plan.d.ts +28 -0
  53. package/lib/run-plan.js +17 -16
  54. package/lib/settings/claude-auth.d.ts +35 -0
  55. package/lib/settings/claude-auth.js +30 -47
  56. package/lib/settings-defaults.d.ts +20 -0
  57. package/lib/settings-defaults.js +149 -0
  58. package/lib/settings-error.d.ts +7 -0
  59. package/lib/settings-error.js +8 -0
  60. package/lib/settings-issue-providers.d.ts +10 -0
  61. package/lib/settings-issue-providers.js +12 -0
  62. package/lib/settings-models.d.ts +22 -0
  63. package/lib/settings-models.js +93 -0
  64. package/lib/settings-storage.d.ts +23 -0
  65. package/lib/settings-storage.js +205 -0
  66. package/lib/settings-validation.d.ts +7 -0
  67. package/lib/settings-validation.js +182 -0
  68. package/lib/settings.d.ts +29 -0
  69. package/lib/settings.js +41 -736
  70. package/lib/setup-apply-types.d.ts +66 -0
  71. package/lib/setup-apply-types.js +2 -0
  72. package/lib/setup-apply.d.ts +39 -0
  73. package/lib/setup-apply.js +267 -264
  74. package/lib/setup-journal.d.ts +41 -0
  75. package/lib/setup-journal.js +119 -76
  76. package/lib/setup-plan-types.d.ts +102 -0
  77. package/lib/setup-plan-types.js +2 -0
  78. package/lib/setup-plan.d.ts +30 -0
  79. package/lib/setup-plan.js +300 -324
  80. package/lib/setup-undo.d.ts +44 -0
  81. package/lib/setup-undo.js +61 -74
  82. package/lib/start-cluster-config.d.ts +26 -0
  83. package/lib/start-cluster-config.js +56 -0
  84. package/lib/start-cluster-environment.d.ts +40 -0
  85. package/lib/start-cluster-environment.js +134 -0
  86. package/lib/start-cluster-run-options.d.ts +53 -0
  87. package/lib/start-cluster-run-options.js +147 -0
  88. package/lib/start-cluster.d.ts +64 -0
  89. package/lib/start-cluster.js +98 -454
  90. package/lib/stream-json-parser.d.ts +17 -0
  91. package/lib/stream-json-parser.js +51 -52
  92. package/npm-shrinkwrap.json +2 -2
  93. package/package.json +12 -6
  94. package/scripts/postinstall.js +27 -0
  95. package/scripts/rust-distribution.js +23 -14
  96. package/src/agent/agent-command-proofs-context.js +35 -45
  97. package/src/agent/agent-command-proofs-context.ts +87 -0
  98. package/src/agent/agent-config-settings.js +19 -0
  99. package/src/agent/agent-config-settings.ts +41 -0
  100. package/src/agent/agent-config.js +122 -231
  101. package/src/agent/agent-config.ts +285 -0
  102. package/src/agent/agent-context-builder.js +38 -273
  103. package/src/agent/agent-context-builder.ts +51 -0
  104. package/src/agent/agent-context-environment-sections.js +105 -0
  105. package/src/agent/agent-context-environment-sections.ts +134 -0
  106. package/src/agent/agent-context-packs.js +165 -0
  107. package/src/agent/agent-context-packs.ts +296 -0
  108. package/src/agent/agent-context-prompt-sections.js +100 -0
  109. package/src/agent/agent-context-prompt-sections.ts +148 -0
  110. package/src/agent/agent-context-sections.js +25 -334
  111. package/src/agent/agent-context-sections.ts +36 -0
  112. package/src/agent/agent-context-sources.js +96 -149
  113. package/src/agent/agent-context-sources.ts +253 -0
  114. package/src/agent/agent-context-types.js +2 -0
  115. package/src/agent/agent-context-types.ts +132 -0
  116. package/src/agent/agent-context-validation-sections.js +73 -0
  117. package/src/agent/agent-context-validation-sections.ts +129 -0
  118. package/src/agent/agent-input-injector.js +99 -118
  119. package/src/agent/agent-input-injector.ts +195 -0
  120. package/src/agent/agent-liveness-poll.js +74 -78
  121. package/src/agent/agent-liveness-poll.ts +163 -0
  122. package/src/agent/agent-quality-gate-schema.js +77 -86
  123. package/src/agent/agent-quality-gate-schema.ts +135 -0
  124. package/src/agent/agent-quality-gates-context.js +44 -50
  125. package/src/agent/agent-quality-gates-context.ts +91 -0
  126. package/src/agent/agent-stuck-detector.js +171 -239
  127. package/src/agent/agent-stuck-detector.ts +288 -0
  128. package/src/agent/agent-trigger-evaluator.js +29 -46
  129. package/src/agent/agent-trigger-evaluator.ts +98 -0
  130. package/src/agent/context-metrics.js +110 -141
  131. package/src/agent/context-metrics.ts +261 -0
  132. package/src/agent/context-pack-builder.js +72 -358
  133. package/src/agent/context-pack-builder.ts +105 -0
  134. package/src/agent/context-pack-core.js +70 -0
  135. package/src/agent/context-pack-core.ts +96 -0
  136. package/src/agent/context-pack-selection.js +119 -0
  137. package/src/agent/context-pack-selection.ts +187 -0
  138. package/src/agent/context-pack-truncation.js +139 -0
  139. package/src/agent/context-pack-truncation.ts +208 -0
  140. package/src/agent/context-pack-types.js +2 -0
  141. package/src/agent/context-pack-types.ts +98 -0
  142. package/src/agent/context-replay-policy.js +30 -39
  143. package/src/agent/context-replay-policy.ts +71 -0
  144. package/src/agent/critical-agent-policy.js +6 -10
  145. package/src/agent/critical-agent-policy.ts +20 -0
  146. package/src/agent/guidance-queue.js +74 -87
  147. package/src/agent/guidance-queue.ts +166 -0
  148. package/src/agent/output-extraction-error-detail.js +45 -0
  149. package/src/agent/output-extraction-error-detail.ts +49 -0
  150. package/src/agent/output-extraction-failures.js +125 -0
  151. package/src/agent/output-extraction-failures.ts +149 -0
  152. package/src/agent/output-extraction-json.js +234 -0
  153. package/src/agent/output-extraction-json.ts +235 -0
  154. package/src/agent/output-extraction-pi.js +124 -0
  155. package/src/agent/output-extraction-pi.ts +137 -0
  156. package/src/agent/output-extraction-types.js +2 -0
  157. package/src/agent/output-extraction-types.ts +49 -0
  158. package/src/agent/output-extraction.js +17 -617
  159. package/src/agent/output-extraction.ts +30 -0
  160. package/src/agent/output-reformatter-errors.js +83 -0
  161. package/src/agent/output-reformatter-errors.ts +106 -0
  162. package/src/agent/output-reformatter-types.js +2 -0
  163. package/src/agent/output-reformatter-types.ts +86 -0
  164. package/src/agent/output-reformatter.js +140 -185
  165. package/src/agent/output-reformatter.ts +238 -0
  166. package/src/agent/pi-terminal-lifecycle-types.js +2 -0
  167. package/src/agent/pi-terminal-lifecycle-types.ts +41 -0
  168. package/src/agent/pi-terminal-lifecycle.js +186 -206
  169. package/src/agent/pi-terminal-lifecycle.ts +297 -0
  170. package/src/agent/provider-control-plane.js +22 -21
  171. package/src/agent/provider-control-plane.ts +52 -0
  172. package/src/agent/provider-terminal-failure-types.js +2 -0
  173. package/src/agent/provider-terminal-failure-types.ts +60 -0
  174. package/src/agent/provider-terminal-failure.js +194 -191
  175. package/src/agent/provider-terminal-failure.ts +262 -0
  176. package/src/agent/rate-limit-backoff.js +31 -74
  177. package/src/agent/rate-limit-backoff.ts +71 -0
  178. package/src/agent/schema-utils.js +85 -125
  179. package/src/agent/schema-utils.ts +148 -0
  180. package/src/agent/structured-output-error.js +34 -33
  181. package/src/agent/structured-output-error.ts +105 -0
  182. package/src/agent/validation-platform.js +27 -27
  183. package/src/agent/validation-platform.ts +49 -0
  184. package/src/agent-cli-provider/adapters/codex.ts +3 -1
  185. package/src/attach/attach-client.js +232 -405
  186. package/src/attach/attach-client.ts +300 -0
  187. package/src/attach/attach-server-cleanup.js +43 -0
  188. package/src/attach/attach-server-cleanup.ts +39 -0
  189. package/src/attach/attach-server-clients.js +117 -0
  190. package/src/attach/attach-server-clients.ts +122 -0
  191. package/src/attach/attach-server-events.js +38 -0
  192. package/src/attach/attach-server-events.ts +36 -0
  193. package/src/attach/attach-server-pty.js +45 -0
  194. package/src/attach/attach-server-pty.ts +64 -0
  195. package/src/attach/attach-server-runtime.js +73 -0
  196. package/src/attach/attach-server-runtime.ts +62 -0
  197. package/src/attach/attach-server-socket.js +28 -0
  198. package/src/attach/attach-server-socket.ts +23 -0
  199. package/src/attach/attach-server-types.js +2 -0
  200. package/src/attach/attach-server-types.ts +82 -0
  201. package/src/attach/attach-server.js +106 -523
  202. package/src/attach/attach-server.ts +158 -0
  203. package/src/attach/index.js +18 -35
  204. package/src/attach/index.ts +18 -0
  205. package/src/attach/protocol.js +95 -184
  206. package/src/attach/protocol.ts +181 -0
  207. package/src/attach/ring-buffer.js +76 -102
  208. package/src/attach/ring-buffer.ts +109 -0
  209. package/src/attach/send-input.js +64 -75
  210. package/src/attach/send-input.ts +94 -0
  211. package/src/attach/socket-discovery.js +164 -218
  212. package/src/attach/socket-discovery.ts +230 -0
  213. package/src/attach/socket-paths.js +42 -61
  214. package/src/attach/socket-paths.ts +81 -0
  215. package/src/claude-credentials.js +51 -54
  216. package/src/claude-credentials.ts +89 -0
  217. package/src/cluster/generated/protocol-schema.ts +1 -1
  218. package/src/cluster/generated/protocol.ts +2 -1
  219. package/src/command-proofs.js +110 -141
  220. package/src/command-proofs.ts +216 -0
  221. package/src/config-router.js +81 -73
  222. package/src/config-router.ts +131 -0
  223. package/src/copy-worker.js +53 -29
  224. package/src/copy-worker.ts +75 -0
  225. package/src/darwin-keychain-boundary.js +80 -111
  226. package/src/darwin-keychain-boundary.ts +148 -0
  227. package/src/guidance-topics.js +4 -5
  228. package/src/guidance-topics.ts +10 -0
  229. package/src/input-helpers.js +33 -54
  230. package/src/input-helpers.ts +58 -0
  231. package/src/ledger-sequence.js +45 -48
  232. package/src/ledger-sequence.ts +63 -0
  233. package/src/legacy-lib/clusters-registry.ts +40 -0
  234. package/src/legacy-lib/completion.ts +148 -0
  235. package/src/legacy-lib/compose-utils.ts +102 -0
  236. package/src/legacy-lib/detached-startup.ts +449 -0
  237. package/src/legacy-lib/docker-config.ts +282 -0
  238. package/src/legacy-lib/docker-env-auth.ts +116 -0
  239. package/src/legacy-lib/git-remote-utils.ts +244 -0
  240. package/src/legacy-lib/id-detector.ts +57 -0
  241. package/src/legacy-lib/js-yaml.d.ts +3 -0
  242. package/src/legacy-lib/omelette.d.ts +15 -0
  243. package/src/legacy-lib/path-check.ts +89 -0
  244. package/src/legacy-lib/process-liveness.ts +36 -0
  245. package/src/legacy-lib/provider-credential-path.ts +57 -0
  246. package/src/legacy-lib/provider-defaults.ts +114 -0
  247. package/src/legacy-lib/provider-detection.ts +67 -0
  248. package/src/legacy-lib/provider-names.ts +126 -0
  249. package/src/legacy-lib/repo-settings.ts +88 -0
  250. package/src/legacy-lib/run-mode.ts +58 -0
  251. package/src/legacy-lib/run-plan.ts +49 -0
  252. package/src/legacy-lib/settings/claude-auth.ts +80 -0
  253. package/src/legacy-lib/settings-defaults.ts +212 -0
  254. package/src/legacy-lib/settings-error.ts +8 -0
  255. package/src/legacy-lib/settings-issue-providers.ts +18 -0
  256. package/src/legacy-lib/settings-models.ts +124 -0
  257. package/src/legacy-lib/settings-storage.ts +277 -0
  258. package/src/legacy-lib/settings-validation.ts +220 -0
  259. package/src/legacy-lib/settings.ts +87 -0
  260. package/src/legacy-lib/setup-apply-types.ts +70 -0
  261. package/src/legacy-lib/setup-apply.ts +456 -0
  262. package/src/legacy-lib/setup-journal.ts +185 -0
  263. package/src/legacy-lib/setup-plan-types.ts +96 -0
  264. package/src/legacy-lib/setup-plan.ts +500 -0
  265. package/src/legacy-lib/setup-undo.ts +142 -0
  266. package/src/legacy-lib/start-cluster-config.ts +124 -0
  267. package/src/legacy-lib/start-cluster-environment.ts +165 -0
  268. package/src/legacy-lib/start-cluster-run-options.ts +279 -0
  269. package/src/legacy-lib/start-cluster.ts +237 -0
  270. package/src/legacy-lib/stream-json-parser.ts +88 -0
  271. package/src/message-buffer.js +55 -71
  272. package/src/message-buffer.ts +107 -0
  273. package/src/message-bus-bridge.js +92 -133
  274. package/src/message-bus-bridge.ts +149 -0
  275. package/src/name-generator-shared.js +220 -0
  276. package/src/name-generator-shared.ts +231 -0
  277. package/src/name-generator.js +8 -217
  278. package/src/name-generator.ts +27 -0
  279. package/src/omp-blob-root.js +83 -64
  280. package/src/omp-blob-root.ts +116 -0
  281. package/src/omp-config-overlay.js +65 -38
  282. package/src/omp-config-overlay.ts +110 -0
  283. package/src/omp-execution-fingerprint.js +38 -43
  284. package/src/omp-execution-fingerprint.ts +92 -0
  285. package/src/omp-session-limits.js +10 -15
  286. package/src/omp-session-limits.ts +53 -0
  287. package/src/omp-session-partition.js +2 -2
  288. package/src/omp-session-verifier.js +1 -1
  289. package/src/orchestrator.js +19 -4
  290. package/src/providers/anthropic/index.js +3 -1
  291. package/src/providers/anthropic/index.ts +13 -0
  292. package/src/providers/capabilities.js +19 -27
  293. package/src/providers/capabilities.ts +44 -0
  294. package/src/providers/google/index.js +3 -1
  295. package/src/providers/google/index.ts +13 -0
  296. package/src/providers/openai/index.js +3 -1
  297. package/src/providers/openai/index.ts +13 -0
  298. package/src/providers/opencode/index.js +3 -1
  299. package/src/providers/opencode/index.ts +13 -0
  300. package/src/quality-gates.js +67 -127
  301. package/src/quality-gates.ts +149 -0
  302. package/src/repo-settings-access.js +40 -0
  303. package/src/repo-settings-access.ts +64 -0
  304. package/src/schemas/sub-cluster.js +127 -183
  305. package/src/schemas/sub-cluster.ts +238 -0
  306. package/src/state-snapshot-normalization.js +224 -0
  307. package/src/state-snapshot-normalization.ts +222 -0
  308. package/src/state-snapshot.js +192 -359
  309. package/src/state-snapshot.ts +291 -0
  310. package/src/state-snapshotter.js +118 -130
  311. package/src/state-snapshotter.ts +167 -0
  312. package/src/sub-cluster-wrapper.js +4 -13
  313. package/src/task-run-model-args.js +87 -124
  314. package/src/task-run-model-args.ts +204 -0
  315. package/src/task-runner.js +5 -25
  316. package/src/task-runner.ts +28 -0
  317. package/src/task-startup-error.js +73 -58
  318. package/src/task-startup-error.ts +126 -0
  319. package/src/template-validation/consensus-gate-contracts.js +2 -0
  320. package/src/template-validation/consensus-gate-contracts.ts +70 -0
  321. package/src/template-validation/consensus-gate-scenarios.js +76 -0
  322. package/src/template-validation/consensus-gate-scenarios.ts +130 -0
  323. package/src/template-validation/consensus-gate-stage.js +34 -0
  324. package/src/template-validation/consensus-gate-stage.ts +56 -0
  325. package/src/template-validation/random-topology-contracts.js +2 -0
  326. package/src/template-validation/random-topology-contracts.ts +54 -0
  327. package/src/template-validation/random-topology-dispatch.js +25 -0
  328. package/src/template-validation/random-topology-dispatch.ts +33 -0
  329. package/src/template-validation/random-topology-message-loop.js +53 -0
  330. package/src/template-validation/random-topology-message-loop.ts +73 -0
  331. package/src/template-validation/random-topology-operations.js +79 -0
  332. package/src/template-validation/random-topology-operations.ts +101 -0
  333. package/src/template-validation/random-topology-runtime.js +25 -0
  334. package/src/template-validation/random-topology-runtime.ts +43 -0
  335. package/src/template-validation/random-topology-scenario.js +52 -0
  336. package/src/template-validation/random-topology-scenario.ts +57 -0
  337. package/src/template-validation/random-topology-schema.js +159 -0
  338. package/src/template-validation/random-topology-schema.ts +190 -0
  339. package/src/template-validation/random-topology-state.js +28 -0
  340. package/src/template-validation/random-topology-state.ts +30 -0
  341. package/src/template-validation/random-topology-trigger-evaluation.js +45 -0
  342. package/src/template-validation/random-topology-trigger-evaluation.ts +65 -0
  343. package/src/template-validation/random-topology-trigger.js +75 -0
  344. package/src/template-validation/random-topology-trigger.ts +88 -0
  345. package/src/template-validation/report-formatter.js +40 -46
  346. package/src/template-validation/report-formatter.ts +101 -0
  347. package/src/template-validation/simulate-consensus-gates.js +111 -302
  348. package/src/template-validation/simulate-consensus-gates.ts +196 -0
  349. package/src/template-validation/simulate-random-topology.js +26 -519
  350. package/src/template-validation/simulate-random-topology.ts +57 -0
  351. package/src/template-validation/simulate-two-stage-validation.js +41 -265
  352. package/src/template-validation/simulate-two-stage-validation.ts +55 -0
  353. package/src/template-validation/simulation-agent-runtime.js +25 -0
  354. package/src/template-validation/simulation-agent-runtime.ts +40 -0
  355. package/src/template-validation/simulation-agent.js +29 -0
  356. package/src/template-validation/simulation-agent.ts +73 -0
  357. package/src/template-validation/simulation-runtime.js +34 -0
  358. package/src/template-validation/simulation-runtime.ts +72 -0
  359. package/src/template-validation/two-stage-contracts.js +2 -0
  360. package/src/template-validation/two-stage-contracts.ts +41 -0
  361. package/src/template-validation/two-stage-inputs.js +21 -0
  362. package/src/template-validation/two-stage-inputs.ts +29 -0
  363. package/src/template-validation/two-stage-results.js +30 -0
  364. package/src/template-validation/two-stage-results.ts +40 -0
  365. package/src/template-validation/two-stage-scenario.js +86 -0
  366. package/src/template-validation/two-stage-scenario.ts +120 -0
  367. package/src/worktree-claude-config.js +182 -220
  368. package/src/worktree-claude-config.ts +272 -0
  369. package/src/worktree-tooling-env.js +103 -125
  370. package/src/worktree-tooling-env.ts +142 -0
  371. package/task-lib/completion.js +2 -3
  372. package/task-lib/completion.ts +9 -0
  373. package/task-lib/config.js +1 -4
  374. package/task-lib/config.ts +11 -0
  375. package/task-lib/name-generator.js +4 -226
  376. package/task-lib/name-generator.ts +11 -0
  377. package/task-lib/omp-session-cleanup.js +1 -1
  378. package/task-lib/omp-storage-root.js +8 -12
  379. package/task-lib/omp-storage-root.ts +62 -0
  380. package/task-lib/process-termination.js +143 -166
  381. package/task-lib/process-termination.ts +268 -0
@@ -1,144 +1,103 @@
1
+ "use strict";
1
2
  /**
2
- * MessageBusBridge - Bridges parent and child message buses
3
- *
4
- * Forwards specified topics between parent and child clusters while maintaining
5
- * isolation and preventing message loops.
6
- *
7
- * Features:
8
- * - Forward specified parent topics to child (contextStrategy.parentTopics)
9
- * - Forward child completion events to parent
10
- * - Namespace child topics to avoid collisions
11
- * - Prevent message loops via forwarding flags
3
+ * Bridges parent and child message buses while preserving cluster isolation and
4
+ * preventing forwarding loops.
12
5
  */
13
-
6
+ function parentTopicName(entry) {
7
+ if (typeof entry === 'string')
8
+ return entry;
9
+ if (typeof entry !== 'object' || entry === null)
10
+ return undefined;
11
+ return 'topic' in entry ? entry.topic : undefined;
12
+ }
13
+ function isNonEmptyString(value) {
14
+ return typeof value === 'string' && value.length > 0;
15
+ }
14
16
  class MessageBusBridge {
15
- constructor(parentBus, childBus, config) {
16
- this.parentBus = parentBus;
17
- this.childBus = childBus;
18
- this.config = config;
19
- this.parentTopicNames = new Set(
20
- (config.parentTopics || [])
21
- .map((entry) => (typeof entry === 'string' ? entry : entry?.topic))
22
- .filter((topic) => typeof topic === 'string' && topic.length > 0)
23
- );
24
-
25
- this.parentUnsubscribe = null;
26
- this.childUnsubscribe = null;
27
- this.active = false;
28
-
29
- this._setupBridge();
30
- }
31
-
32
- /**
33
- * Set up bidirectional message forwarding
34
- * @private
35
- */
36
- _setupBridge() {
37
- // Forward specified parent topics to child
38
- if (this.parentTopicNames.size > 0) {
39
- this.parentUnsubscribe = this.parentBus.subscribe((message) => {
40
- this._forwardParentToChild(message);
41
- });
42
- }
43
-
44
- // Forward child completion/failure events to parent
45
- this.childUnsubscribe = this.childBus.subscribe((message) => {
46
- this._forwardChildToParent(message);
47
- });
48
-
49
- this.active = true;
50
- }
51
-
52
- /**
53
- * Forward parent message to child cluster
54
- * @private
55
- */
56
- _forwardParentToChild(message) {
57
- // Only forward messages from parent cluster
58
- if (message.cluster_id !== this.config.parentClusterId) {
59
- return;
60
- }
61
-
62
- // Only forward topics specified in config
63
- if (!this.parentTopicNames.has(message.topic)) {
64
- return;
65
- }
66
-
67
- // Skip already-forwarded messages (prevent loops)
68
- if (message.metadata?.forwarded) {
69
- return;
17
+ parentBus;
18
+ childBus;
19
+ config;
20
+ parentTopicNames;
21
+ parentUnsubscribe;
22
+ childUnsubscribe;
23
+ active;
24
+ constructor(parentBus, childBus, config) {
25
+ this.parentBus = parentBus;
26
+ this.childBus = childBus;
27
+ this.config = config;
28
+ this.parentTopicNames = new Set((config.parentTopics || []).map(parentTopicName).filter(isNonEmptyString));
29
+ this.parentUnsubscribe = null;
30
+ this.childUnsubscribe = null;
31
+ this.active = false;
32
+ this._setupBridge();
70
33
  }
71
-
72
- // Forward to child with metadata flag
73
- this.childBus.publish({
74
- ...message,
75
- cluster_id: this.config.childClusterId,
76
- metadata: {
77
- ...message.metadata,
78
- forwarded: true,
79
- forwardedFrom: this.config.parentClusterId,
80
- },
81
- });
82
- }
83
-
84
- /**
85
- * Forward child message to parent cluster
86
- * @private
87
- */
88
- _forwardChildToParent(message) {
89
- // Only forward messages from child cluster
90
- if (message.cluster_id !== this.config.childClusterId) {
91
- return;
34
+ _setupBridge() {
35
+ if (this.parentTopicNames.size > 0) {
36
+ this.parentUnsubscribe = this.parentBus.subscribe((message) => {
37
+ this._forwardParentToChild(message);
38
+ });
39
+ }
40
+ this.childUnsubscribe = this.childBus.subscribe((message) => {
41
+ this._forwardChildToParent(message);
42
+ });
43
+ this.active = true;
92
44
  }
93
-
94
- // Only forward completion/failure events
95
- const forwardTopics = ['CLUSTER_COMPLETE', 'CLUSTER_FAILED', 'AGENT_ERROR'];
96
- if (!forwardTopics.includes(message.topic)) {
97
- return;
45
+ _forwardParentToChild(message) {
46
+ if (message.cluster_id !== this.config.parentClusterId) {
47
+ return;
48
+ }
49
+ if (!this.parentTopicNames.has(message.topic)) {
50
+ return;
51
+ }
52
+ if (message.metadata?.forwarded) {
53
+ return;
54
+ }
55
+ this.childBus.publish({
56
+ ...message,
57
+ cluster_id: this.config.childClusterId,
58
+ metadata: {
59
+ ...message.metadata,
60
+ forwarded: true,
61
+ forwardedFrom: this.config.parentClusterId,
62
+ },
63
+ });
98
64
  }
99
-
100
- // Skip already-forwarded messages (prevent loops)
101
- if (message.metadata?.forwarded) {
102
- return;
65
+ _forwardChildToParent(message) {
66
+ if (message.cluster_id !== this.config.childClusterId) {
67
+ return;
68
+ }
69
+ const forwardTopics = ['CLUSTER_COMPLETE', 'CLUSTER_FAILED', 'AGENT_ERROR'];
70
+ if (!forwardTopics.includes(message.topic)) {
71
+ return;
72
+ }
73
+ if (message.metadata?.forwarded) {
74
+ return;
75
+ }
76
+ this.parentBus.publish({
77
+ ...message,
78
+ cluster_id: this.config.parentClusterId,
79
+ topic: `CHILD_${message.topic}`,
80
+ metadata: {
81
+ ...message.metadata,
82
+ forwarded: true,
83
+ forwardedFrom: this.config.childClusterId,
84
+ childClusterId: this.config.childClusterId,
85
+ },
86
+ });
103
87
  }
104
-
105
- // Forward to parent with namespaced topic and metadata flag
106
- this.parentBus.publish({
107
- ...message,
108
- cluster_id: this.config.parentClusterId,
109
- topic: `CHILD_${message.topic}`,
110
- metadata: {
111
- ...message.metadata,
112
- forwarded: true,
113
- forwardedFrom: this.config.childClusterId,
114
- childClusterId: this.config.childClusterId,
115
- },
116
- });
117
- }
118
-
119
- /**
120
- * Close the bridge and stop forwarding
121
- */
122
- close() {
123
- if (this.parentUnsubscribe) {
124
- this.parentUnsubscribe();
125
- this.parentUnsubscribe = null;
88
+ close() {
89
+ if (this.parentUnsubscribe) {
90
+ this.parentUnsubscribe();
91
+ this.parentUnsubscribe = null;
92
+ }
93
+ if (this.childUnsubscribe) {
94
+ this.childUnsubscribe();
95
+ this.childUnsubscribe = null;
96
+ }
97
+ this.active = false;
126
98
  }
127
-
128
- if (this.childUnsubscribe) {
129
- this.childUnsubscribe();
130
- this.childUnsubscribe = null;
99
+ isActive() {
100
+ return this.active;
131
101
  }
132
-
133
- this.active = false;
134
- }
135
-
136
- /**
137
- * Check if bridge is active
138
- */
139
- isActive() {
140
- return this.active;
141
- }
142
102
  }
143
-
144
103
  module.exports = MessageBusBridge;
@@ -0,0 +1,149 @@
1
+ /**
2
+ * Bridges parent and child message buses while preserving cluster isolation and
3
+ * preventing forwarding loops.
4
+ */
5
+
6
+ interface BridgeMetadata extends Record<string, unknown> {
7
+ forwarded?: unknown;
8
+ }
9
+
10
+ interface BridgeMessage extends Record<string, unknown> {
11
+ cluster_id: string;
12
+ topic: string;
13
+ metadata?: BridgeMetadata;
14
+ }
15
+
16
+ interface BridgeMessageBus {
17
+ subscribe(handler: (message: BridgeMessage) => void): () => void;
18
+ publish(message: BridgeMessage): unknown;
19
+ }
20
+
21
+ interface MessageBusBridgeConfig {
22
+ parentClusterId: string;
23
+ childClusterId: string;
24
+ parentTopics?: unknown[];
25
+ }
26
+
27
+ function parentTopicName(entry: unknown): unknown {
28
+ if (typeof entry === 'string') return entry;
29
+ if (typeof entry !== 'object' || entry === null) return undefined;
30
+ return 'topic' in entry ? entry.topic : undefined;
31
+ }
32
+
33
+ function isNonEmptyString(value: unknown): value is string {
34
+ return typeof value === 'string' && value.length > 0;
35
+ }
36
+
37
+ class MessageBusBridge {
38
+ parentBus: BridgeMessageBus;
39
+ childBus: BridgeMessageBus;
40
+ config: MessageBusBridgeConfig;
41
+ parentTopicNames: Set<string>;
42
+ parentUnsubscribe: (() => void) | null;
43
+ childUnsubscribe: (() => void) | null;
44
+ active: boolean;
45
+
46
+ constructor(
47
+ parentBus: BridgeMessageBus,
48
+ childBus: BridgeMessageBus,
49
+ config: MessageBusBridgeConfig
50
+ ) {
51
+ this.parentBus = parentBus;
52
+ this.childBus = childBus;
53
+ this.config = config;
54
+ this.parentTopicNames = new Set(
55
+ (config.parentTopics || []).map(parentTopicName).filter(isNonEmptyString)
56
+ );
57
+
58
+ this.parentUnsubscribe = null;
59
+ this.childUnsubscribe = null;
60
+ this.active = false;
61
+
62
+ this._setupBridge();
63
+ }
64
+
65
+ _setupBridge(): void {
66
+ if (this.parentTopicNames.size > 0) {
67
+ this.parentUnsubscribe = this.parentBus.subscribe((message: BridgeMessage) => {
68
+ this._forwardParentToChild(message);
69
+ });
70
+ }
71
+
72
+ this.childUnsubscribe = this.childBus.subscribe((message: BridgeMessage) => {
73
+ this._forwardChildToParent(message);
74
+ });
75
+
76
+ this.active = true;
77
+ }
78
+
79
+ _forwardParentToChild(message: BridgeMessage): void {
80
+ if (message.cluster_id !== this.config.parentClusterId) {
81
+ return;
82
+ }
83
+
84
+ if (!this.parentTopicNames.has(message.topic)) {
85
+ return;
86
+ }
87
+
88
+ if (message.metadata?.forwarded) {
89
+ return;
90
+ }
91
+
92
+ this.childBus.publish({
93
+ ...message,
94
+ cluster_id: this.config.childClusterId,
95
+ metadata: {
96
+ ...message.metadata,
97
+ forwarded: true,
98
+ forwardedFrom: this.config.parentClusterId,
99
+ },
100
+ });
101
+ }
102
+
103
+ _forwardChildToParent(message: BridgeMessage): void {
104
+ if (message.cluster_id !== this.config.childClusterId) {
105
+ return;
106
+ }
107
+
108
+ const forwardTopics = ['CLUSTER_COMPLETE', 'CLUSTER_FAILED', 'AGENT_ERROR'];
109
+ if (!forwardTopics.includes(message.topic)) {
110
+ return;
111
+ }
112
+
113
+ if (message.metadata?.forwarded) {
114
+ return;
115
+ }
116
+
117
+ this.parentBus.publish({
118
+ ...message,
119
+ cluster_id: this.config.parentClusterId,
120
+ topic: `CHILD_${message.topic}`,
121
+ metadata: {
122
+ ...message.metadata,
123
+ forwarded: true,
124
+ forwardedFrom: this.config.childClusterId,
125
+ childClusterId: this.config.childClusterId,
126
+ },
127
+ });
128
+ }
129
+
130
+ close(): void {
131
+ if (this.parentUnsubscribe) {
132
+ this.parentUnsubscribe();
133
+ this.parentUnsubscribe = null;
134
+ }
135
+
136
+ if (this.childUnsubscribe) {
137
+ this.childUnsubscribe();
138
+ this.childUnsubscribe = null;
139
+ }
140
+
141
+ this.active = false;
142
+ }
143
+
144
+ isActive(): boolean {
145
+ return this.active;
146
+ }
147
+ }
148
+
149
+ export = MessageBusBridge;
@@ -0,0 +1,220 @@
1
+ "use strict";
2
+ const ADJECTIVES = [
3
+ // Colors
4
+ 'amber',
5
+ 'azure',
6
+ 'crimson',
7
+ 'emerald',
8
+ 'golden',
9
+ 'indigo',
10
+ 'jade',
11
+ 'ruby',
12
+ 'sapphire',
13
+ 'silver',
14
+ 'violet',
15
+ 'bronze',
16
+ 'coral',
17
+ 'ivory',
18
+ 'pearl',
19
+ 'platinum',
20
+ 'scarlet',
21
+ 'cobalt',
22
+ 'copper',
23
+ 'obsidian',
24
+ 'onyx',
25
+ 'opal',
26
+ 'topaz',
27
+ 'turquoise',
28
+ // Nature
29
+ 'wandering',
30
+ 'bright',
31
+ 'silent',
32
+ 'ancient',
33
+ 'swift',
34
+ 'noble',
35
+ 'bold',
36
+ 'wild',
37
+ 'gentle',
38
+ 'hidden',
39
+ 'fierce',
40
+ 'calm',
41
+ 'frozen',
42
+ 'misty',
43
+ 'stormy',
44
+ 'sunny',
45
+ // Cosmic
46
+ 'cosmic',
47
+ 'crystal',
48
+ 'electric',
49
+ 'lunar',
50
+ 'solar',
51
+ 'stellar',
52
+ 'astral',
53
+ 'orbital',
54
+ 'mystic',
55
+ 'quantum',
56
+ 'radiant',
57
+ 'twilight',
58
+ 'vivid',
59
+ 'zen',
60
+ 'infinite',
61
+ 'eternal',
62
+ // Tech/Abstract
63
+ 'clever',
64
+ 'rapid',
65
+ 'steady',
66
+ 'agile',
67
+ 'nimble',
68
+ 'keen',
69
+ 'sharp',
70
+ 'quick',
71
+ 'prime',
72
+ 'binary',
73
+ 'neural',
74
+ 'atomic',
75
+ 'sonic',
76
+ 'hyper',
77
+ 'mega',
78
+ 'ultra',
79
+ // Descriptive
80
+ 'blazing',
81
+ 'gleaming',
82
+ 'glowing',
83
+ 'shining',
84
+ 'burning',
85
+ 'flaming',
86
+ 'sparkling',
87
+ 'dazzling',
88
+ 'roaring',
89
+ 'rushing',
90
+ 'soaring',
91
+ 'flying',
92
+ 'rising',
93
+ 'falling',
94
+ 'spinning',
95
+ 'dancing',
96
+ ];
97
+ const NOUNS = [
98
+ // Nature
99
+ 'forest',
100
+ 'river',
101
+ 'mountain',
102
+ 'ocean',
103
+ 'thunder',
104
+ 'canyon',
105
+ 'summit',
106
+ 'valley',
107
+ 'cascade',
108
+ 'glacier',
109
+ 'volcano',
110
+ 'desert',
111
+ 'meadow',
112
+ 'tundra',
113
+ 'jungle',
114
+ 'reef',
115
+ // Space
116
+ 'star',
117
+ 'comet',
118
+ 'nebula',
119
+ 'galaxy',
120
+ 'pulsar',
121
+ 'quasar',
122
+ 'aurora',
123
+ 'eclipse',
124
+ 'meteor',
125
+ 'nova',
126
+ 'cosmos',
127
+ 'orbit',
128
+ 'void',
129
+ 'horizon',
130
+ 'zenith',
131
+ 'equinox',
132
+ // Mythical
133
+ 'phoenix',
134
+ 'dragon',
135
+ 'griffin',
136
+ 'sphinx',
137
+ 'hydra',
138
+ 'kraken',
139
+ 'titan',
140
+ 'atlas',
141
+ 'oracle',
142
+ 'rune',
143
+ 'sigil',
144
+ 'glyph',
145
+ 'totem',
146
+ 'aegis',
147
+ 'aether',
148
+ 'flux',
149
+ // Animals
150
+ 'falcon',
151
+ 'eagle',
152
+ 'wolf',
153
+ 'bear',
154
+ 'tiger',
155
+ 'hawk',
156
+ 'lion',
157
+ 'panther',
158
+ 'raven',
159
+ 'serpent',
160
+ 'shark',
161
+ 'owl',
162
+ 'fox',
163
+ 'lynx',
164
+ 'viper',
165
+ 'condor',
166
+ // Architecture
167
+ 'citadel',
168
+ 'temple',
169
+ 'spire',
170
+ 'tower',
171
+ 'fortress',
172
+ 'bastion',
173
+ 'vault',
174
+ 'sanctum',
175
+ 'beacon',
176
+ 'arch',
177
+ 'bridge',
178
+ 'gate',
179
+ 'hall',
180
+ 'keep',
181
+ 'dome',
182
+ 'obelisk',
183
+ // Abstract
184
+ 'cipher',
185
+ 'echo',
186
+ 'nexus',
187
+ 'prism',
188
+ 'relic',
189
+ 'vertex',
190
+ 'vortex',
191
+ 'pulse',
192
+ 'surge',
193
+ 'spark',
194
+ 'flame',
195
+ 'storm',
196
+ 'wave',
197
+ 'drift',
198
+ 'shift',
199
+ 'core',
200
+ ];
201
+ function isNameRandomSource(value) {
202
+ return typeof value === 'function';
203
+ }
204
+ function nextNameRandomValue() {
205
+ const randomSource = Reflect.get(Math, 'random');
206
+ if (!isNameRandomSource(randomSource)) {
207
+ throw new TypeError('Math.random must be a function');
208
+ }
209
+ return randomSource.call(Math);
210
+ }
211
+ function generateReadableName(adjectiveFallback, nounFallback) {
212
+ const adjective = ADJECTIVES[Math.floor(nextNameRandomValue() * ADJECTIVES.length)] ?? adjectiveFallback;
213
+ const noun = NOUNS[Math.floor(nextNameRandomValue() * NOUNS.length)] ?? nounFallback;
214
+ const number = Math.floor(nextNameRandomValue() * 100);
215
+ return `${adjective}-${noun}-${number}`;
216
+ }
217
+ function generateNameSuffix() {
218
+ return nextNameRandomValue().toString(36).slice(2, 6);
219
+ }
220
+ module.exports = { generateReadableName, generateNameSuffix };