@pellux/goodvibes-tui 0.18.11 → 0.18.12

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 (443) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +1 -1
  3. package/docs/foundation-artifacts/operator-contract.json +1 -1
  4. package/package.json +2 -2
  5. package/src/core/conversation-rendering.ts +2 -2
  6. package/src/core/conversation.ts +5 -5
  7. package/src/core/orchestrator.ts +13 -11
  8. package/src/daemon/facade-composition.ts +8 -8
  9. package/src/daemon/facade.ts +8 -8
  10. package/src/daemon/types.ts +3 -3
  11. package/src/input/command-registry.ts +3 -3
  12. package/src/input/commands/session-content.ts +2 -2
  13. package/src/input/commands/session-workflow.ts +1 -1
  14. package/src/input/handler-feed.ts +1 -1
  15. package/src/input/session-picker-modal.ts +1 -1
  16. package/src/panels/builtin/agent.ts +1 -0
  17. package/src/panels/builtin/operations.ts +1 -0
  18. package/src/panels/builtin/session.ts +1 -1
  19. package/src/panels/builtin/shared.ts +2 -2
  20. package/src/panels/context-visualizer-panel.ts +4 -1
  21. package/src/panels/provider-health-domains.ts +5 -1
  22. package/src/panels/provider-health-panel.ts +5 -1
  23. package/src/panels/session-browser-panel.ts +1 -1
  24. package/src/panels/token-budget-panel.ts +6 -2
  25. package/src/plugins/loader.ts +2 -2
  26. package/src/runtime/bootstrap-command-context.ts +3 -3
  27. package/src/runtime/bootstrap-command-parts.ts +3 -3
  28. package/src/runtime/bootstrap-core.ts +2 -2
  29. package/src/runtime/bootstrap-hook-bridge.ts +1 -1
  30. package/src/runtime/bootstrap-shell.ts +1 -1
  31. package/src/runtime/bootstrap.ts +5 -4
  32. package/src/runtime/services.ts +2 -2
  33. package/src/runtime/ui-read-models-observability-security.ts +2 -2
  34. package/src/runtime/ui-read-models-observability-system.ts +1 -1
  35. package/src/runtime/ui-service-queries.ts +1 -1
  36. package/src/tools/index.ts +1 -1
  37. package/src/version.ts +1 -1
  38. package/src/acp/connection.ts +0 -447
  39. package/src/acp/index.ts +0 -7
  40. package/src/acp/manager.ts +0 -1
  41. package/src/adapters/bluebubbles/index.ts +0 -127
  42. package/src/adapters/discord/index.ts +0 -297
  43. package/src/adapters/github/index.ts +0 -73
  44. package/src/adapters/google-chat/index.ts +0 -119
  45. package/src/adapters/imessage/index.ts +0 -92
  46. package/src/adapters/index.ts +0 -15
  47. package/src/adapters/matrix/index.ts +0 -116
  48. package/src/adapters/mattermost/index.ts +0 -151
  49. package/src/adapters/msteams/index.ts +0 -180
  50. package/src/adapters/ntfy/index.ts +0 -118
  51. package/src/adapters/signal/index.ts +0 -92
  52. package/src/adapters/slack/index.ts +0 -323
  53. package/src/adapters/telegram/index.ts +0 -160
  54. package/src/adapters/types.ts +0 -97
  55. package/src/adapters/webhook/index.ts +0 -178
  56. package/src/adapters/whatsapp/index.ts +0 -135
  57. package/src/agents/message-bus-core.ts +0 -312
  58. package/src/agents/message-bus.ts +0 -2
  59. package/src/agents/orchestrator-prompts.ts +0 -351
  60. package/src/agents/orchestrator-runner.ts +0 -668
  61. package/src/agents/orchestrator.ts +0 -438
  62. package/src/agents/session.ts +0 -108
  63. package/src/agents/worktree.ts +0 -153
  64. package/src/agents/wrfc-config.ts +0 -47
  65. package/src/agents/wrfc-controller.ts +0 -747
  66. package/src/agents/wrfc-gate-runtime.ts +0 -75
  67. package/src/agents/wrfc-reporting.ts +0 -284
  68. package/src/agents/wrfc-runtime-events.ts +0 -150
  69. package/src/agents/wrfc-types.ts +0 -67
  70. package/src/automation/delivery-manager.ts +0 -368
  71. package/src/automation/index.ts +0 -72
  72. package/src/automation/manager-runtime-delivery.ts +0 -139
  73. package/src/automation/manager-runtime-events.ts +0 -131
  74. package/src/automation/manager-runtime-execution.ts +0 -511
  75. package/src/automation/manager-runtime-helpers.ts +0 -433
  76. package/src/automation/manager-runtime-job-mutations.ts +0 -175
  77. package/src/automation/manager-runtime-reconcile.ts +0 -148
  78. package/src/automation/manager-runtime-scheduling.ts +0 -189
  79. package/src/automation/manager-runtime-sync.ts +0 -54
  80. package/src/automation/manager-runtime.ts +0 -721
  81. package/src/automation/manager.ts +0 -10
  82. package/src/automation/service.ts +0 -242
  83. package/src/channels/builtin/account-actions.ts +0 -490
  84. package/src/channels/builtin/accounts.ts +0 -433
  85. package/src/channels/builtin/contracts.ts +0 -405
  86. package/src/channels/builtin/plugins.ts +0 -308
  87. package/src/channels/builtin/rendering.ts +0 -174
  88. package/src/channels/builtin/setup-schema.ts +0 -504
  89. package/src/channels/builtin/shared.ts +0 -96
  90. package/src/channels/builtin/surfaces.ts +0 -57
  91. package/src/channels/builtin/targets.ts +0 -693
  92. package/src/channels/builtin-runtime.ts +0 -443
  93. package/src/channels/delivery/shared.ts +0 -199
  94. package/src/channels/delivery/strategies-bridge.ts +0 -246
  95. package/src/channels/delivery/strategies-core.ts +0 -299
  96. package/src/channels/delivery/strategies-enterprise.ts +0 -178
  97. package/src/channels/delivery/types.ts +0 -59
  98. package/src/channels/delivery-router.ts +0 -127
  99. package/src/channels/index.ts +0 -77
  100. package/src/channels/plugin-registry.ts +0 -551
  101. package/src/channels/provider-runtime.ts +0 -330
  102. package/src/channels/reply-pipeline.ts +0 -522
  103. package/src/channels/route-manager.ts +0 -340
  104. package/src/channels/surface-registry.ts +0 -186
  105. package/src/config/helper-model.ts +0 -1
  106. package/src/config/manager.ts +0 -8
  107. package/src/config/subscription-auth.ts +0 -31
  108. package/src/config/tool-llm.ts +0 -110
  109. package/src/control-plane/approval-broker.ts +0 -351
  110. package/src/control-plane/gateway.ts +0 -1
  111. package/src/control-plane/index.ts +0 -54
  112. package/src/control-plane/media-contract-schemas.ts +0 -1
  113. package/src/control-plane/method-catalog-admin.ts +0 -1
  114. package/src/control-plane/method-catalog-channels.ts +0 -1
  115. package/src/control-plane/method-catalog-control-automation.ts +0 -1
  116. package/src/control-plane/method-catalog-control-core.ts +0 -1
  117. package/src/control-plane/method-catalog-control.ts +0 -1
  118. package/src/control-plane/method-catalog-events.ts +0 -1
  119. package/src/control-plane/method-catalog-knowledge.ts +0 -1
  120. package/src/control-plane/method-catalog-media.ts +0 -1
  121. package/src/control-plane/method-catalog-runtime.ts +0 -1
  122. package/src/control-plane/method-catalog-shared.ts +0 -1
  123. package/src/control-plane/method-catalog.ts +0 -1
  124. package/src/control-plane/operator-contract-schemas-admin.ts +0 -1
  125. package/src/control-plane/operator-contract-schemas-channels.ts +0 -1
  126. package/src/control-plane/operator-contract-schemas-control.ts +0 -1
  127. package/src/control-plane/operator-contract-schemas-domains.ts +0 -1
  128. package/src/control-plane/operator-contract-schemas-knowledge.ts +0 -1
  129. package/src/control-plane/operator-contract-schemas-media.ts +0 -1
  130. package/src/control-plane/operator-contract-schemas-permissions.ts +0 -1
  131. package/src/control-plane/operator-contract-schemas-remote.ts +0 -1
  132. package/src/control-plane/operator-contract-schemas-runtime.ts +0 -1
  133. package/src/control-plane/operator-contract-schemas-shared.ts +0 -1
  134. package/src/control-plane/operator-contract-schemas-telemetry.ts +0 -1
  135. package/src/control-plane/operator-contract-schemas.ts +0 -1
  136. package/src/control-plane/operator-contract.ts +0 -165
  137. package/src/control-plane/session-broker.ts +0 -780
  138. package/src/core/compaction-sections.ts +0 -492
  139. package/src/core/compaction-types.ts +0 -147
  140. package/src/core/context-compaction.ts +0 -542
  141. package/src/core/conversation-compaction.ts +0 -68
  142. package/src/core/conversation-diff.ts +0 -55
  143. package/src/core/conversation-utils.ts +0 -72
  144. package/src/core/event-replay.ts +0 -287
  145. package/src/core/orchestrator-context-runtime.ts +0 -407
  146. package/src/core/orchestrator-follow-up-runtime.ts +0 -134
  147. package/src/core/orchestrator-runtime.ts +0 -132
  148. package/src/core/orchestrator-tool-runtime.ts +0 -468
  149. package/src/core/orchestrator-turn-helpers.ts +0 -355
  150. package/src/core/orchestrator-turn-loop.ts +0 -443
  151. package/src/core/plan-command-handler.ts +0 -169
  152. package/src/core/transcript-events/classify.ts +0 -95
  153. package/src/core/transcript-events/index.ts +0 -15
  154. package/src/daemon/control-plane.ts +0 -522
  155. package/src/daemon/helpers.ts +0 -74
  156. package/src/daemon/http/router-route-contexts.ts +0 -370
  157. package/src/daemon/http/router.ts +0 -531
  158. package/src/daemon/http-listener.ts +0 -301
  159. package/src/daemon/index.ts +0 -1
  160. package/src/daemon/server.ts +0 -1
  161. package/src/daemon/service-manager.ts +0 -413
  162. package/src/daemon/surface-actions.ts +0 -183
  163. package/src/daemon/surface-delivery.ts +0 -530
  164. package/src/daemon/transport-events.ts +0 -110
  165. package/src/export/markdown.ts +0 -213
  166. package/src/export/session-export.ts +0 -1
  167. package/src/git/index.ts +0 -1
  168. package/src/git/service.ts +0 -414
  169. package/src/hooks/chain-engine.ts +0 -414
  170. package/src/hooks/dispatcher.ts +0 -414
  171. package/src/hooks/hook-api.ts +0 -170
  172. package/src/hooks/index.ts +0 -48
  173. package/src/hooks/runners/agent.ts +0 -93
  174. package/src/hooks/runners/prompt.ts +0 -69
  175. package/src/hooks/workbench.ts +0 -360
  176. package/src/integrations/index.ts +0 -42
  177. package/src/integrations/notifier.ts +0 -206
  178. package/src/integrations/webhooks.ts +0 -1
  179. package/src/knowledge/consolidation.ts +0 -346
  180. package/src/knowledge/graphql.ts +0 -324
  181. package/src/knowledge/index.ts +0 -60
  182. package/src/knowledge/ingest-compile.ts +0 -386
  183. package/src/knowledge/ingest-context.ts +0 -18
  184. package/src/knowledge/ingest-inputs.ts +0 -387
  185. package/src/knowledge/ingest.ts +0 -1
  186. package/src/knowledge/internal.ts +0 -257
  187. package/src/knowledge/knowledge-api.ts +0 -432
  188. package/src/knowledge/lint.ts +0 -121
  189. package/src/knowledge/memory-sync.ts +0 -62
  190. package/src/knowledge/packet.ts +0 -370
  191. package/src/knowledge/scheduling.ts +0 -283
  192. package/src/knowledge/service.ts +0 -715
  193. package/src/mcp/client.ts +0 -383
  194. package/src/mcp/index.ts +0 -12
  195. package/src/mcp/mcp-api.ts +0 -90
  196. package/src/mcp/registry.ts +0 -1
  197. package/src/media/builtin-image-understanding.ts +0 -303
  198. package/src/media/builtin-providers.ts +0 -26
  199. package/src/media/index.ts +0 -18
  200. package/src/multimodal/index.ts +0 -13
  201. package/src/multimodal/service.ts +0 -492
  202. package/src/permissions/briefs/build.ts +0 -88
  203. package/src/permissions/manager.ts +0 -1
  204. package/src/plugins/api.ts +0 -383
  205. package/src/plugins/manager.ts +0 -481
  206. package/src/profiles/shape.ts +0 -58
  207. package/src/providers/amazon-bedrock-mantle.ts +0 -50
  208. package/src/providers/amazon-bedrock.ts +0 -61
  209. package/src/providers/anthropic-compat.ts +0 -373
  210. package/src/providers/anthropic-sdk-provider.ts +0 -230
  211. package/src/providers/anthropic-vertex.ts +0 -59
  212. package/src/providers/anthropic.ts +0 -469
  213. package/src/providers/auto-register.ts +0 -417
  214. package/src/providers/builtin-catalog.ts +0 -326
  215. package/src/providers/builtin-registry.ts +0 -575
  216. package/src/providers/cache-planner.ts +0 -258
  217. package/src/providers/capabilities.ts +0 -1
  218. package/src/providers/custom-loader.ts +0 -425
  219. package/src/providers/discovered-compat.ts +0 -7
  220. package/src/providers/discovered-factory.ts +0 -61
  221. package/src/providers/discovered-traits.ts +0 -138
  222. package/src/providers/gemini.ts +0 -462
  223. package/src/providers/github-copilot.ts +0 -254
  224. package/src/providers/index.ts +0 -1
  225. package/src/providers/interface.ts +0 -185
  226. package/src/providers/llama-cpp.ts +0 -402
  227. package/src/providers/lm-studio-helpers.ts +0 -367
  228. package/src/providers/lm-studio.ts +0 -484
  229. package/src/providers/model-catalog-cache.ts +0 -221
  230. package/src/providers/model-catalog-notifications.ts +0 -97
  231. package/src/providers/model-catalog-synthetic.ts +0 -202
  232. package/src/providers/model-catalog.ts +0 -211
  233. package/src/providers/model-limits.ts +0 -1
  234. package/src/providers/ollama.ts +0 -469
  235. package/src/providers/openai-codex.ts +0 -472
  236. package/src/providers/openai-compat.ts +0 -615
  237. package/src/providers/openai.ts +0 -231
  238. package/src/providers/optimizer.ts +0 -1
  239. package/src/providers/provider-api.ts +0 -1
  240. package/src/providers/registry-helpers.ts +0 -34
  241. package/src/providers/registry-models.ts +0 -77
  242. package/src/providers/registry-types.ts +0 -67
  243. package/src/providers/registry.ts +0 -1
  244. package/src/providers/runtime-metadata.ts +0 -149
  245. package/src/providers/runtime-snapshot.ts +0 -130
  246. package/src/providers/synthetic.ts +0 -561
  247. package/src/providers/tier-prompts.ts +0 -84
  248. package/src/providers/tool-formats.ts +0 -414
  249. package/src/runtime/auth/inspection.ts +0 -125
  250. package/src/runtime/bootstrap-background.ts +0 -157
  251. package/src/runtime/bootstrap-helpers.ts +0 -88
  252. package/src/runtime/bootstrap-runtime-events.ts +0 -254
  253. package/src/runtime/bootstrap-services.ts +0 -197
  254. package/src/runtime/compaction/index.ts +0 -1
  255. package/src/runtime/compaction/lifecycle.ts +0 -1
  256. package/src/runtime/compaction/manager.ts +0 -474
  257. package/src/runtime/compaction/quality-score.ts +0 -1
  258. package/src/runtime/compaction/resume-repair.ts +0 -1
  259. package/src/runtime/compaction/strategies/autocompact.ts +0 -1
  260. package/src/runtime/compaction/strategies/boundary-commit.ts +0 -1
  261. package/src/runtime/compaction/strategies/collapse.ts +0 -1
  262. package/src/runtime/compaction/strategies/index.ts +0 -1
  263. package/src/runtime/compaction/strategies/microcompact.ts +0 -1
  264. package/src/runtime/compaction/strategies/reactive.ts +0 -1
  265. package/src/runtime/compaction/types.ts +0 -1
  266. package/src/runtime/ecosystem/recommendations.ts +0 -117
  267. package/src/runtime/emitters/agents.ts +0 -96
  268. package/src/runtime/emitters/automation.ts +0 -112
  269. package/src/runtime/emitters/communication.ts +0 -53
  270. package/src/runtime/emitters/compaction.ts +0 -161
  271. package/src/runtime/emitters/control-plane.ts +0 -65
  272. package/src/runtime/emitters/deliveries.ts +0 -65
  273. package/src/runtime/emitters/forensics.ts +0 -17
  274. package/src/runtime/emitters/index.ts +0 -59
  275. package/src/runtime/emitters/knowledge.ts +0 -129
  276. package/src/runtime/emitters/mcp.ts +0 -95
  277. package/src/runtime/emitters/ops.ts +0 -163
  278. package/src/runtime/emitters/orchestration.ts +0 -87
  279. package/src/runtime/emitters/permissions.ts +0 -98
  280. package/src/runtime/emitters/planner.ts +0 -23
  281. package/src/runtime/emitters/plugins.ts +0 -78
  282. package/src/runtime/emitters/providers.ts +0 -30
  283. package/src/runtime/emitters/routes.ts +0 -57
  284. package/src/runtime/emitters/security.ts +0 -53
  285. package/src/runtime/emitters/session.ts +0 -93
  286. package/src/runtime/emitters/surfaces.ts +0 -57
  287. package/src/runtime/emitters/tasks.ts +0 -69
  288. package/src/runtime/emitters/tools.ts +0 -140
  289. package/src/runtime/emitters/transport.ts +0 -78
  290. package/src/runtime/emitters/turn.ts +0 -155
  291. package/src/runtime/emitters/ui.ts +0 -57
  292. package/src/runtime/emitters/watchers.ts +0 -57
  293. package/src/runtime/emitters/workflows.ts +0 -79
  294. package/src/runtime/eval/index.ts +0 -48
  295. package/src/runtime/eval/runner.ts +0 -163
  296. package/src/runtime/eval/suites.ts +0 -264
  297. package/src/runtime/events/domain-map.ts +0 -148
  298. package/src/runtime/events/index.ts +0 -1
  299. package/src/runtime/events/turn.ts +0 -1
  300. package/src/runtime/events/workflows.ts +0 -1
  301. package/src/runtime/forensics/collector.ts +0 -693
  302. package/src/runtime/forensics/index.ts +0 -23
  303. package/src/runtime/foundation-clients.ts +0 -78
  304. package/src/runtime/foundation-services.ts +0 -96
  305. package/src/runtime/guidance.ts +0 -183
  306. package/src/runtime/health/effect-handlers.ts +0 -189
  307. package/src/runtime/health/index.ts +0 -70
  308. package/src/runtime/health/wiring.ts +0 -115
  309. package/src/runtime/integration/helpers.ts +0 -640
  310. package/src/runtime/lifecycle.ts +0 -107
  311. package/src/runtime/mcp/index.ts +0 -68
  312. package/src/runtime/mcp/manager.ts +0 -513
  313. package/src/runtime/network/inbound.ts +0 -131
  314. package/src/runtime/network/index.ts +0 -30
  315. package/src/runtime/network/outbound.ts +0 -292
  316. package/src/runtime/network/shared.ts +0 -82
  317. package/src/runtime/operator-client.ts +0 -235
  318. package/src/runtime/ops/control-plane.ts +0 -363
  319. package/src/runtime/ops/index.ts +0 -122
  320. package/src/runtime/ops/playbooks/index.ts +0 -10
  321. package/src/runtime/ops/playbooks/session-unrecoverable.ts +0 -196
  322. package/src/runtime/ops/playbooks/stuck-turn.ts +0 -197
  323. package/src/runtime/ops/runtime-context.ts +0 -100
  324. package/src/runtime/ops-api.ts +0 -27
  325. package/src/runtime/orchestration/spawn-policy.ts +0 -83
  326. package/src/runtime/peer-client.ts +0 -404
  327. package/src/runtime/perf/index.ts +0 -57
  328. package/src/runtime/perf/slo-collector.ts +0 -375
  329. package/src/runtime/permissions/index.ts +0 -190
  330. package/src/runtime/permissions/policy-runtime.ts +0 -1
  331. package/src/runtime/permissions/preflight.ts +0 -101
  332. package/src/runtime/permissions/rule-suggestions.ts +0 -36
  333. package/src/runtime/plugins/hot-reload.ts +0 -221
  334. package/src/runtime/plugins/index.ts +0 -84
  335. package/src/runtime/plugins/lifecycle.ts +0 -95
  336. package/src/runtime/plugins/manager.ts +0 -474
  337. package/src/runtime/plugins/manifest.ts +0 -167
  338. package/src/runtime/plugins/quarantine.ts +0 -202
  339. package/src/runtime/plugins/trust.ts +0 -291
  340. package/src/runtime/plugins/types.ts +0 -205
  341. package/src/runtime/provider-accounts/registry.ts +0 -326
  342. package/src/runtime/remote/distributed-runtime-contract-schemas.ts +0 -386
  343. package/src/runtime/remote/index.ts +0 -488
  344. package/src/runtime/remote/runner-registry.ts +0 -438
  345. package/src/runtime/remote/supervisor.ts +0 -70
  346. package/src/runtime/runtime-hook-api.ts +0 -5
  347. package/src/runtime/runtime-knowledge-api.ts +0 -14
  348. package/src/runtime/runtime-mcp-api.ts +0 -5
  349. package/src/runtime/runtime-ops-api.ts +0 -86
  350. package/src/runtime/runtime-provider-api.ts +0 -18
  351. package/src/runtime/session-maintenance.ts +0 -188
  352. package/src/runtime/session-persistence.ts +0 -288
  353. package/src/runtime/session-return-context.ts +0 -195
  354. package/src/runtime/settings/control-plane-store.ts +0 -258
  355. package/src/runtime/settings/control-plane.ts +0 -599
  356. package/src/runtime/shell-command-extensions.ts +0 -54
  357. package/src/runtime/shell-command-ops.ts +0 -207
  358. package/src/runtime/shell-command-platform.ts +0 -47
  359. package/src/runtime/shell-command-services.ts +0 -143
  360. package/src/runtime/shell-command-workspace.ts +0 -31
  361. package/src/runtime/tasks/adapters/acp-adapter.ts +0 -211
  362. package/src/runtime/tasks/adapters/agent-adapter.ts +0 -208
  363. package/src/runtime/tasks/adapters/index.ts +0 -16
  364. package/src/runtime/tasks/adapters/process-adapter.ts +0 -214
  365. package/src/runtime/tasks/adapters/scheduler-adapter.ts +0 -193
  366. package/src/runtime/tasks/index.ts +0 -68
  367. package/src/runtime/tasks/manager.ts +0 -415
  368. package/src/runtime/telemetry/api-helpers.ts +0 -517
  369. package/src/runtime/telemetry/api.ts +0 -768
  370. package/src/runtime/telemetry/index.ts +0 -178
  371. package/src/runtime/telemetry/instrumentation/domain-bridge-agent-session.ts +0 -440
  372. package/src/runtime/telemetry/instrumentation/domain-bridge-plugin-mcp.ts +0 -200
  373. package/src/runtime/telemetry/instrumentation/domain-bridge-shared.ts +0 -18
  374. package/src/runtime/telemetry/instrumentation/domain-bridge-transport-task.ts +0 -204
  375. package/src/runtime/telemetry/instrumentation/domain-bridge.ts +0 -125
  376. package/src/runtime/telemetry/instrumentation/index.ts +0 -67
  377. package/src/runtime/tools/context.ts +0 -114
  378. package/src/runtime/tools/index.ts +0 -46
  379. package/src/runtime/tools/phased-executor.ts +0 -448
  380. package/src/runtime/tools/phases/budget.ts +0 -130
  381. package/src/runtime/tools/phases/execute.ts +0 -69
  382. package/src/runtime/tools/phases/index.ts +0 -13
  383. package/src/runtime/tools/phases/map-output.ts +0 -98
  384. package/src/runtime/tools/phases/permission.ts +0 -133
  385. package/src/runtime/tools/phases/posthook.ts +0 -57
  386. package/src/runtime/tools/phases/prehook.ts +0 -68
  387. package/src/runtime/tools/phases/validate.ts +0 -53
  388. package/src/runtime/transports/direct.ts +0 -73
  389. package/src/runtime/transports/http-helpers.ts +0 -218
  390. package/src/runtime/transports/http-types.ts +0 -364
  391. package/src/runtime/transports/http.ts +0 -629
  392. package/src/runtime/transports/realtime.ts +0 -50
  393. package/src/runtime/transports/remote-events.ts +0 -16
  394. package/src/runtime/transports/shared.ts +0 -39
  395. package/src/runtime/transports/ui-runtime-events.ts +0 -35
  396. package/src/runtime/ui-events.ts +0 -46
  397. package/src/runtime/worktree/registry.ts +0 -252
  398. package/src/sessions/manager.ts +0 -14
  399. package/src/state/file-watcher.ts +0 -294
  400. package/src/state/index.ts +0 -56
  401. package/src/state/knowledge-injection.ts +0 -214
  402. package/src/state/memory-embedding-http.ts +0 -642
  403. package/src/state/memory-embeddings.ts +0 -312
  404. package/src/state/memory-ingest.ts +0 -132
  405. package/src/state/memory-registry.ts +0 -111
  406. package/src/state/memory-store-helpers.ts +0 -160
  407. package/src/state/memory-store.ts +0 -728
  408. package/src/state/memory-vector-store.ts +0 -418
  409. package/src/templates/manager.ts +0 -187
  410. package/src/tools/agent/index.ts +0 -610
  411. package/src/tools/agent/manager.ts +0 -476
  412. package/src/tools/analyze/git-modes.ts +0 -380
  413. package/src/tools/analyze/index.ts +0 -128
  414. package/src/tools/channel/agent-tools.ts +0 -16
  415. package/src/tools/channel/index.ts +0 -268
  416. package/src/tools/control/index.ts +0 -90
  417. package/src/tools/edit/core.ts +0 -619
  418. package/src/tools/edit/index.ts +0 -4
  419. package/src/tools/edit/phased.ts +0 -33
  420. package/src/tools/fetch/index.ts +0 -3
  421. package/src/tools/fetch/phased.ts +0 -34
  422. package/src/tools/fetch/runtime.ts +0 -499
  423. package/src/tools/mcp/index.ts +0 -190
  424. package/src/tools/remote-trigger/index.ts +0 -130
  425. package/src/tools/shared/auto-heal.ts +0 -282
  426. package/src/tools/state/index.ts +0 -688
  427. package/src/tools/web-search/index.ts +0 -38
  428. package/src/tools/write/index.ts +0 -604
  429. package/src/tools/write/phased.ts +0 -41
  430. package/src/types/generated/foundation-client-types.ts +0 -22
  431. package/src/watchers/index.ts +0 -11
  432. package/src/watchers/registry.ts +0 -517
  433. package/src/web-search/index.ts +0 -26
  434. package/src/web-search/provider-registry.ts +0 -64
  435. package/src/web-search/providers/brave.ts +0 -100
  436. package/src/web-search/providers/duckduckgo.ts +0 -270
  437. package/src/web-search/providers/exa.ts +0 -77
  438. package/src/web-search/providers/firecrawl.ts +0 -90
  439. package/src/web-search/providers/perplexity.ts +0 -86
  440. package/src/web-search/providers/searxng.ts +0 -88
  441. package/src/web-search/providers/shared.ts +0 -249
  442. package/src/web-search/providers/tavily.ts +0 -90
  443. package/src/web-search/service.ts +0 -142
@@ -1,23 +0,0 @@
1
- /**
2
- * Forensics subsystem — public API.
3
- *
4
- * Usage:
5
- * 1. Create a ForensicsRegistry owned by the current runtime/session.
6
- * 2. Create a ForensicsCollector, passing the RuntimeEventBus and registry.
7
- * 3. The collector auto-generates reports on terminal failure states.
8
- * 4. Pass the registry to ForensicsPanel (diagnostic provider) and the
9
- * /forensics command handler via CommandContext.forensicsRegistry.
10
- */
11
- export type {
12
- FailureReport,
13
- FailureClass,
14
- PhaseTimingEntry,
15
- CausalChainEntry,
16
- ForensicsJumpLink,
17
- ForensicsBundle,
18
- ForensicsReplayEvidence,
19
- ForensicsEvidenceSummary,
20
- } from '@pellux/goodvibes-sdk/platform/runtime/forensics/types';
21
- export { classifyFailure, summariseFailure } from '@pellux/goodvibes-sdk/platform/runtime/forensics/classifier';
22
- export { ForensicsRegistry, DEFAULT_REGISTRY_LIMIT } from '@pellux/goodvibes-sdk/platform/runtime/forensics/registry';
23
- export { ForensicsCollector } from '@pellux/goodvibes-sdk/platform/runtime/forensics/collector';
@@ -1,78 +0,0 @@
1
- import { listHookPointContracts } from '@pellux/goodvibes-sdk/platform/hooks/index';
2
- import type { HookApi } from '@pellux/goodvibes-sdk/platform/hooks/hook-api';
3
- import type { KnowledgeApi } from '@pellux/goodvibes-sdk/platform/knowledge/knowledge-api';
4
- import type { McpApi } from '@pellux/goodvibes-sdk/platform/mcp/mcp-api';
5
- import type { ProviderApi } from '@pellux/goodvibes-sdk/platform/providers/provider-api';
6
- import type { RuntimeServices } from './services.ts';
7
- import {
8
- createDirectTransportServices,
9
- type DirectTransportServices,
10
- type OperatorClientServicesOptions,
11
- } from '@pellux/goodvibes-sdk/platform/runtime/foundation-services';
12
- import type { OpsApi } from '@pellux/goodvibes-sdk/platform/runtime/ops-api';
13
- import type { OpsControlPlane } from '@pellux/goodvibes-sdk/platform/runtime/ops/control-plane';
14
- import { createRuntimeHookApi } from '@pellux/goodvibes-sdk/platform/runtime/runtime-hook-api';
15
- import { createRuntimeKnowledgeApi } from '@pellux/goodvibes-sdk/platform/runtime/runtime-knowledge-api';
16
- import { createRuntimeMcpApi } from '@pellux/goodvibes-sdk/platform/runtime/runtime-mcp-api';
17
- import { createRuntimeOpsApi } from '@pellux/goodvibes-sdk/platform/runtime/runtime-ops-api';
18
- import { createRuntimeProviderApi } from '@pellux/goodvibes-sdk/platform/runtime/runtime-provider-api';
19
- import type { TaskManager } from '@pellux/goodvibes-sdk/platform/runtime/tasks/types';
20
- import { createDirectTransportFromServices, type DirectTransport } from '@pellux/goodvibes-sdk/platform/runtime/transports/direct';
21
- import type { UiTasksSnapshot } from './ui-read-models.ts';
22
-
23
- export interface RuntimeFoundationClientsOptions extends OperatorClientServicesOptions {
24
- readonly runtimeServices: RuntimeServices;
25
- readonly tasksReadModel: {
26
- getSnapshot(): UiTasksSnapshot;
27
- };
28
- readonly taskManager: TaskManager;
29
- readonly opsControlPlane?: OpsControlPlane;
30
- }
31
-
32
- export interface RuntimeFoundationClients {
33
- readonly transportServices: DirectTransportServices;
34
- readonly directTransport: DirectTransport;
35
- readonly providerApi: ProviderApi;
36
- readonly knowledgeApi: KnowledgeApi;
37
- readonly hookApi: HookApi;
38
- readonly mcpApi: McpApi;
39
- readonly opsApi: OpsApi;
40
- }
41
-
42
- export function createRuntimeFoundationClients(
43
- options: RuntimeFoundationClientsOptions,
44
- ): RuntimeFoundationClients {
45
- const {
46
- runtimeServices,
47
- tasksReadModel,
48
- taskManager,
49
- opsControlPlane,
50
- getControlPlaneRecentEvents,
51
- } = options;
52
-
53
- const transportServices = createDirectTransportServices(runtimeServices, {
54
- ...(getControlPlaneRecentEvents ? { getControlPlaneRecentEvents } : {}),
55
- });
56
- const directTransport = createDirectTransportFromServices(transportServices);
57
-
58
- return {
59
- transportServices,
60
- directTransport,
61
- providerApi: createRuntimeProviderApi(runtimeServices),
62
- knowledgeApi: createRuntimeKnowledgeApi(runtimeServices),
63
- hookApi: createRuntimeHookApi({
64
- dispatcher: {
65
- listHooks: () => runtimeServices.hookDispatcher.listHooks(),
66
- listChains: () => runtimeServices.hookWorkbench.listManagedChains(),
67
- },
68
- workbench: runtimeServices.hookWorkbench,
69
- listContracts: () => listHookPointContracts(),
70
- }),
71
- mcpApi: createRuntimeMcpApi(runtimeServices.mcpRegistry),
72
- opsApi: createRuntimeOpsApi({
73
- tasksReadModel,
74
- taskManager,
75
- opsControlPlane,
76
- }),
77
- };
78
- }
@@ -1,96 +0,0 @@
1
- import type { ApprovalBroker } from '@pellux/goodvibes-sdk/platform/control-plane/approval-broker';
2
- import type { SharedSessionBroker } from '@pellux/goodvibes-sdk/platform/control-plane/session-broker';
3
- import type { SecretsManager } from '../config/secrets.ts';
4
- import type { ServiceRegistry } from '../config/service-registry.ts';
5
- import type { SubscriptionManager } from '@pellux/goodvibes-sdk/platform/config/subscriptions';
6
- import type { ProviderRegistry } from '@pellux/goodvibes-sdk/platform/providers/registry';
7
- import type { RuntimeServices } from './services.ts';
8
- import type { ShellPathService } from '@pellux/goodvibes-sdk/platform/runtime/shell-paths';
9
- import type { UiRuntimeEvents } from '@pellux/goodvibes-sdk/platform/runtime/ui-events';
10
- import { createUiRuntimeEvents } from '@pellux/goodvibes-sdk/platform/runtime/ui-events';
11
- import { createCoreReadModels } from '@pellux/goodvibes-sdk/platform/runtime/ui-read-models-core';
12
- import {
13
- createOperationsReadModels,
14
- type UiOperationsReadModelOptions,
15
- } from '@pellux/goodvibes-sdk/platform/runtime/ui-read-models-operations';
16
- import type { PeerClientDependencies } from '@pellux/goodvibes-sdk/platform/runtime/peer-client';
17
-
18
- export interface OperatorClientReadModels {
19
- readonly controlPlane: ReturnType<typeof createOperationsReadModels>['controlPlane'];
20
- readonly providers: ReturnType<typeof createCoreReadModels>['providers'];
21
- readonly session: ReturnType<typeof createCoreReadModels>['session'];
22
- readonly tasks: ReturnType<typeof createCoreReadModels>['tasks'];
23
- }
24
-
25
- export interface OperatorClientServices {
26
- readonly events: UiRuntimeEvents;
27
- readonly shellPaths: ShellPathService;
28
- readonly readModels: OperatorClientReadModels;
29
- readonly sessionBroker: SharedSessionBroker;
30
- readonly approvalBroker: ApprovalBroker;
31
- readonly providerRegistry: ProviderRegistry;
32
- readonly serviceRegistry: ServiceRegistry;
33
- readonly subscriptionManager: SubscriptionManager;
34
- readonly secretsManager: SecretsManager;
35
- }
36
-
37
- export interface OperatorClientServicesOptions extends UiOperationsReadModelOptions {}
38
-
39
- export interface DirectTransportServices {
40
- readonly operator: OperatorClientServices;
41
- readonly peer: PeerClientDependencies;
42
- }
43
-
44
- function createOperatorClientReadModels(
45
- runtimeServices: RuntimeServices,
46
- options: OperatorClientServicesOptions = {},
47
- ): OperatorClientReadModels {
48
- const core = createCoreReadModels(runtimeServices);
49
- const operations = createOperationsReadModels(runtimeServices, options);
50
- return {
51
- controlPlane: operations.controlPlane,
52
- providers: core.providers,
53
- session: core.session,
54
- tasks: core.tasks,
55
- };
56
- }
57
-
58
- export function createOperatorClientServices(
59
- runtimeServices: RuntimeServices,
60
- options: OperatorClientServicesOptions = {},
61
- ): OperatorClientServices {
62
- return {
63
- events: createUiRuntimeEvents(runtimeServices.runtimeBus),
64
- shellPaths: runtimeServices.shellPaths,
65
- readModels: createOperatorClientReadModels(runtimeServices, options),
66
- sessionBroker: runtimeServices.sessionBroker,
67
- approvalBroker: runtimeServices.approvalBroker,
68
- providerRegistry: runtimeServices.providerRegistry,
69
- serviceRegistry: runtimeServices.serviceRegistry,
70
- subscriptionManager: runtimeServices.subscriptionManager,
71
- secretsManager: runtimeServices.secretsManager,
72
- };
73
- }
74
-
75
- export function createPeerClientDependencies(
76
- runtimeServices: Pick<RuntimeServices, 'distributedRuntime' | 'remoteRunnerRegistry' | 'remoteSupervisor' | 'runtimeStore'>,
77
- ): PeerClientDependencies {
78
- return {
79
- runtimeStore: runtimeServices.runtimeStore,
80
- distributedRuntime: runtimeServices.distributedRuntime,
81
- remoteRunnerRegistry: runtimeServices.remoteRunnerRegistry,
82
- remoteSupervisor: runtimeServices.remoteSupervisor,
83
- };
84
- }
85
-
86
- export interface DirectTransportServicesOptions extends OperatorClientServicesOptions {}
87
-
88
- export function createDirectTransportServices(
89
- runtimeServices: RuntimeServices,
90
- options: DirectTransportServicesOptions = {},
91
- ): DirectTransportServices {
92
- return {
93
- operator: createOperatorClientServices(runtimeServices, options),
94
- peer: createPeerClientDependencies(runtimeServices),
95
- };
96
- }
@@ -1,183 +0,0 @@
1
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
2
- import { dirname, join } from 'path';
3
- import type { ConfigManager } from '@pellux/goodvibes-sdk/platform/config/manager';
4
- import type { SessionMaintenanceStatus } from '@pellux/goodvibes-sdk/platform/runtime/session-maintenance';
5
- import type { EcosystemRecommendation } from '@pellux/goodvibes-sdk/platform/runtime/ecosystem/recommendations';
6
-
7
- export type GuidanceMode = 'off' | 'minimal' | 'guided';
8
- export type GuidanceCategory = 'onboarding' | 'operational' | 'recovery' | 'optimization';
9
-
10
- export interface GuidanceItem {
11
- readonly id: string;
12
- readonly category: GuidanceCategory;
13
- readonly title: string;
14
- readonly summary: string;
15
- readonly commands: readonly string[];
16
- }
17
-
18
- export interface ContextualGuidanceSnapshot {
19
- readonly pendingApproval: boolean;
20
- readonly denialCount: number;
21
- readonly authRequiredMcpCount: number;
22
- readonly degradedProviderCount: number;
23
- readonly intelligenceUnavailable: boolean;
24
- readonly recommendations: readonly EcosystemRecommendation[];
25
- }
26
-
27
- interface GuidanceDismissalStore {
28
- readonly version: 1;
29
- readonly dismissed: Record<string, number>;
30
- }
31
-
32
- export interface GuidancePersistenceOptions {
33
- readonly guidancePath?: string;
34
- readonly userRoot?: string;
35
- readonly homeDirectory?: string;
36
- }
37
-
38
- function resolveGuidancePath(options?: GuidancePersistenceOptions): string {
39
- if (options?.guidancePath) {
40
- return options.guidancePath;
41
- }
42
- const userRoot = options?.userRoot ?? options?.homeDirectory;
43
- if (!userRoot) {
44
- throw new Error('Guidance persistence requires guidancePath or an explicit userRoot/homeDirectory.');
45
- }
46
- return join(userRoot, '.goodvibes', 'tui', 'guidance.json');
47
- }
48
-
49
- function readDismissals(options?: GuidancePersistenceOptions): GuidanceDismissalStore {
50
- try {
51
- const guidanceFile = resolveGuidancePath(options);
52
- if (!existsSync(guidanceFile)) return { version: 1, dismissed: {} };
53
- return JSON.parse(readFileSync(guidanceFile, 'utf-8')) as GuidanceDismissalStore;
54
- } catch {
55
- return { version: 1, dismissed: {} };
56
- }
57
- }
58
-
59
- function writeDismissals(store: GuidanceDismissalStore, options?: GuidancePersistenceOptions): void {
60
- const guidanceFile = resolveGuidancePath(options);
61
- mkdirSync(dirname(guidanceFile), { recursive: true });
62
- writeFileSync(guidanceFile, `${JSON.stringify(store, null, 2)}\n`, 'utf-8');
63
- }
64
-
65
- export function dismissGuidance(id: string, options?: GuidancePersistenceOptions): void {
66
- const store = readDismissals(options);
67
- store.dismissed[id] = Date.now();
68
- writeDismissals(store, options);
69
- }
70
-
71
- export function resetGuidance(id?: string, options?: GuidancePersistenceOptions): void {
72
- if (!id) {
73
- writeDismissals({ version: 1, dismissed: {} }, options);
74
- return;
75
- }
76
- const store = readDismissals(options);
77
- delete store.dismissed[id];
78
- writeDismissals(store, options);
79
- }
80
-
81
- export function evaluateContextualGuidance(
82
- configManager: ConfigManager,
83
- snapshot: ContextualGuidanceSnapshot,
84
- maintenance: SessionMaintenanceStatus,
85
- options?: GuidancePersistenceOptions,
86
- ): GuidanceItem[] {
87
- const mode = (configManager.get('behavior.guidanceMode') as GuidanceMode | undefined) ?? 'minimal';
88
- if (mode === 'off') return [];
89
-
90
- const dismissed = readDismissals(options).dismissed;
91
- const items: GuidanceItem[] = [];
92
-
93
- if (maintenance.level === 'suggest-compact' || maintenance.level === 'needs-repair') {
94
- items.push({
95
- id: 'context-maintenance',
96
- category: 'recovery',
97
- title: 'Context pressure needs attention',
98
- summary: 'The active session is near or beyond its healthy context budget.',
99
- commands: maintenance.nextSteps,
100
- });
101
- } else if (mode === 'guided' && maintenance.level === 'watch') {
102
- items.push({
103
- id: 'context-watch',
104
- category: 'optimization',
105
- title: 'Context pressure is rising',
106
- summary: 'Context is still healthy, but it is moving toward the configured compaction threshold.',
107
- commands: maintenance.nextSteps,
108
- });
109
- }
110
-
111
- if (snapshot.pendingApproval) {
112
- items.push({
113
- id: 'pending-approval',
114
- category: 'recovery',
115
- title: 'A permission decision is waiting',
116
- summary: 'Operator approval is currently blocking the active workflow.',
117
- commands: ['/approval', '/security'],
118
- });
119
- }
120
-
121
- if (snapshot.denialCount >= 3 && mode === 'guided') {
122
- items.push({
123
- id: 'repeated-denials',
124
- category: 'operational',
125
- title: 'Repeated denials suggest a policy mismatch',
126
- summary: 'Several actions were denied in this session. Review whether a scoped durable rule should be added.',
127
- commands: ['/policy', '/security', '/approval'],
128
- });
129
- }
130
-
131
- if (snapshot.authRequiredMcpCount > 0) {
132
- items.push({
133
- id: 'mcp-auth-required',
134
- category: 'recovery',
135
- title: 'One or more MCP servers require authentication',
136
- summary: `${snapshot.authRequiredMcpCount} MCP server${snapshot.authRequiredMcpCount === 1 ? '' : 's'} cannot operate until auth is completed.`,
137
- commands: ['/mcp', '/services auth-review'],
138
- });
139
- }
140
-
141
- if (snapshot.degradedProviderCount > 0) {
142
- items.push({
143
- id: 'provider-health',
144
- category: 'recovery',
145
- title: 'Provider health is degraded',
146
- summary: 'At least one configured provider is rate-limited, unavailable, or in an auth error state.',
147
- commands: ['/provider', '/health'],
148
- });
149
- }
150
-
151
- if (mode === 'guided' && snapshot.intelligenceUnavailable) {
152
- items.push({
153
- id: 'intelligence-setup',
154
- category: 'onboarding',
155
- title: 'Workspace intelligence is not ready',
156
- summary: 'Diagnostics and symbol search are unavailable for this workspace. Enable or configure intelligence to improve code-aware workflows.',
157
- commands: ['/setup onboarding', '/health'],
158
- });
159
- }
160
-
161
- if (snapshot.recommendations.length > 0) {
162
- const top = snapshot.recommendations[0]!;
163
- items.push({
164
- id: 'ecosystem-recommendation',
165
- category: 'operational',
166
- title: top.title,
167
- summary: top.reason,
168
- commands: [top.command, '/marketplace recommend'],
169
- });
170
- }
171
-
172
- return items.filter((item) => !(item.id in dismissed));
173
- }
174
-
175
- export function formatGuidanceItems(items: readonly GuidanceItem[]): string[] {
176
- if (items.length === 0) return ['No active guidance items.'];
177
- return items.flatMap((item) => [
178
- `[${item.category}] ${item.title}`,
179
- ` ${item.summary}`,
180
- ...(item.commands.length > 0 ? [` next: ${item.commands.join(' ')}`] : []),
181
- ` dismiss: /guidance dismiss ${item.id}`,
182
- ]);
183
- }
@@ -1,189 +0,0 @@
1
- /**
2
- * Health Error Propagation — Effect Handlers
3
- *
4
- * Implements concrete actions for each CascadeEffect type produced by the
5
- * CascadeEngine. Each handler is a pure dispatch function — side effects
6
- * are performed through the provided aggregator and eventBus context.
7
- *
8
- * Callers (e.g. HealthStoreWiring) are responsible for iterating over
9
- * CascadeResult arrays and invoking this function for each result.
10
- *
11
- * @module health/effect-handlers
12
- */
13
-
14
- import type { CascadeEffect, CascadeResult } from '@pellux/goodvibes-sdk/platform/runtime/health/types';
15
- import { createCascadeAppliedEvent } from '@pellux/goodvibes-sdk/platform/runtime/health/types';
16
- import type { RuntimeHealthAggregator } from '@pellux/goodvibes-sdk/platform/runtime/health/aggregator';
17
- import type { RuntimeEventBus, RuntimeEventEnvelope } from '@pellux/goodvibes-sdk/platform/runtime/events/index';
18
- import { createEventEnvelope } from '@pellux/goodvibes-sdk/platform/runtime/events/index';
19
- import type { AnyRuntimeEvent } from '@pellux/goodvibes-sdk/platform/runtime/events/index';
20
-
21
- /**
22
- * Emits a synthetic health event on the bus.
23
- *
24
- * Health events (e.g. CASCADE_APPLIED) are not part of AnyRuntimeEvent — they live
25
- * outside the typed domain-event union. This helper centralises the necessary
26
- * cross-domain cast in a single, documented location rather than duplicating it
27
- * at each call site.
28
- */
29
- /**
30
- * GC-ARCH-002 allowlist: This file is explicitly permitted to call
31
- * RuntimeEventBus.emit() directly because it emits synthetic health events
32
- * (CASCADE_APPLIED, EMIT_EVENT effects) that are intentionally outside the
33
- * AnyRuntimeEvent typed union. The necessary cast is isolated here to avoid
34
- * duplicating it at every effect-handler call site.
35
- *
36
- * Do NOT copy this pattern elsewhere — use typed emitters from
37
- * src/runtime/emitters/ for all standard domain events.
38
- */
39
- function emitHealthEvent(
40
- bus: RuntimeEventBus,
41
- envelope: RuntimeEventEnvelope<string, unknown>,
42
- ): void {
43
- bus.emit('session', envelope as unknown as RuntimeEventEnvelope<AnyRuntimeEvent['type'], AnyRuntimeEvent>);
44
- }
45
-
46
- /** Context injected into each effect handler. */
47
- export interface EffectHandlerContext {
48
- /** The health aggregator — used to mark domain state changes. */
49
- readonly aggregator: RuntimeHealthAggregator;
50
- /** The event bus — used to emit CASCADE_APPLIED and domain events. */
51
- readonly eventBus: RuntimeEventBus;
52
- }
53
-
54
- /**
55
- * Dispatches the appropriate runtime action for a given CascadeEffect.
56
- *
57
- * Handles all six CascadeEffect variants:
58
- * - `CANCEL_INFLIGHT` — cancels in-flight operations in the given scope
59
- * - `BLOCK_DISPATCH` — blocks new dispatch in the given scope (optionally queues)
60
- * - `MARK_CHILDREN` — marks child tasks/agents as failed or blocked
61
- * - `DEREGISTER_TOOLS` — deregisters tools, scoped by pluginId from sourceContext
62
- * - `EMIT_EVENT` — emits a domain event of the given eventType on the bus
63
- * - `BLOCK_NEW` — blocks new operations of the given scope
64
- *
65
- * After applying the effect, emits a `CASCADE_APPLIED` event on the event bus
66
- * so that other subsystems can observe cascade propagation.
67
- *
68
- * @param effect - The CascadeEffect to apply.
69
- * @param result - The CascadeResult that produced this effect (carries ruleId, source, etc.).
70
- * @param context - The aggregator and eventBus needed to perform side effects.
71
- */
72
- export function handleCascadeEffect(
73
- effect: CascadeEffect,
74
- result: CascadeResult,
75
- context: EffectHandlerContext,
76
- ): void {
77
- const { aggregator, eventBus } = context;
78
-
79
- switch (effect.type) {
80
- case 'CANCEL_INFLIGHT': {
81
- // Mark the target domain as degraded to signal in-flight cancellation.
82
- // Actual cancellation of network/async operations is domain-specific;
83
- // subscribers observing CASCADE_APPLIED will perform the real cancellation.
84
- if (result.target !== 'ALL') {
85
- aggregator.updateDomainHealth(result.target, 'degraded', {
86
- failureReason: `In-flight operations cancelled (scope: ${effect.scope})`,
87
- });
88
- }
89
- break;
90
- }
91
-
92
- case 'BLOCK_DISPATCH': {
93
- // Mark the target domain as degraded with the blocked scope noted.
94
- // If queueable, subscribers may hold and retry; otherwise, they must reject.
95
- if (result.target !== 'ALL') {
96
- aggregator.updateDomainHealth(result.target, 'degraded', {
97
- failureReason: effect.queueable
98
- ? `Dispatch blocked (scope: ${effect.scope}) — queuing enabled`
99
- : `Dispatch blocked (scope: ${effect.scope}) — queuing disabled`,
100
- degradedCapabilities: [effect.scope],
101
- });
102
- }
103
- break;
104
- }
105
-
106
- case 'MARK_CHILDREN': {
107
- // Mark child domains as failed or blocked.
108
- // For 'ALL' target, propagate to tasks and agents as the primary child domains.
109
- const childDomains =
110
- result.target === 'ALL'
111
- ? (['tasks', 'agents'] as const)
112
- : ([result.target] as const);
113
-
114
- for (const childDomain of childDomains) {
115
- aggregator.updateDomainHealth(childDomain, 'failed', {
116
- failureReason: `Marked ${effect.status} by cascade from '${result.source}'${effect.notifyParent ? ' (parent notified)' : ''}`,
117
- });
118
- }
119
- break;
120
- }
121
-
122
- case 'DEREGISTER_TOOLS': {
123
- // Signal tool deregistration by marking the toolExecution domain degraded.
124
- // Subscribers (tool registry) observe CASCADE_APPLIED to perform actual deregistration.
125
- // If pluginId is in sourceContext, the scope is limited to that plugin's tools.
126
- const pluginId = result.sourceContext?.['pluginId'];
127
- const scope = pluginId ? `plugin:${pluginId}` : 'all-plugins';
128
-
129
- if (result.target !== 'ALL') {
130
- aggregator.updateDomainHealth(result.target, 'degraded', {
131
- failureReason: `Tools deregistered (${scope})`,
132
- degradedCapabilities: [`tool-dispatch:${scope}`],
133
- });
134
- }
135
- break;
136
- }
137
-
138
- case 'EMIT_EVENT': {
139
- // Emit the specified event type on the bus as a synthetic health event.
140
- // Since CASCADE_APPLIED is not in AnyRuntimeEvent, we use a cast to
141
- // emit on the 'session' domain (the most general available routing domain).
142
- const syntheticEnvelope = createEventEnvelope(
143
- effect.eventType,
144
- {
145
- type: effect.eventType,
146
- ruleId: result.ruleId,
147
- source: result.source,
148
- target: result.target,
149
- timestamp: result.timestamp,
150
- sourceContext: result.sourceContext,
151
- },
152
- {
153
- sessionId: result.sourceContext?.['sessionId'] ?? 'runtime',
154
- source: 'health/effect-handlers',
155
- },
156
- );
157
- emitHealthEvent(eventBus, syntheticEnvelope);
158
- break;
159
- }
160
-
161
- case 'BLOCK_NEW': {
162
- // Block new operations in the given scope by marking target domain degraded.
163
- if (result.target !== 'ALL') {
164
- aggregator.updateDomainHealth(result.target, 'degraded', {
165
- failureReason: `New operations blocked (scope: ${effect.scope})`,
166
- degradedCapabilities: [effect.scope],
167
- });
168
- }
169
- break;
170
- }
171
-
172
- default: {
173
- const _exhaustive: never = effect;
174
- throw new Error(`Unhandled cascade effect type: ${(effect as { type: string }).type}`);
175
- }
176
- }
177
-
178
- // Emit CASCADE_APPLIED event for observability
179
- const appliedEvent = createCascadeAppliedEvent(result);
180
- const appliedEnvelope = createEventEnvelope(
181
- 'CASCADE_APPLIED',
182
- appliedEvent,
183
- {
184
- sessionId: result.sourceContext?.['sessionId'] ?? 'runtime',
185
- source: 'health/effect-handlers',
186
- },
187
- );
188
- emitHealthEvent(eventBus, appliedEnvelope);
189
- }
@@ -1,70 +0,0 @@
1
- /**
2
- * Runtime health monitoring system — barrel exports and factory.
3
- *
4
- * Usage:
5
- * ```ts
6
- * import { createHealthSystem } from './health/index.ts';
7
- * const { aggregator, cascadeEngine } = createHealthSystem();
8
- * ```
9
- */
10
-
11
- export type {
12
- HealthStatus,
13
- HealthDomain,
14
- DomainHealth,
15
- CompositeHealth,
16
- CascadeEffect,
17
- CascadeRule,
18
- CascadeResult,
19
- EvaluateResult,
20
- CascadeAppliedEvent,
21
- } from '@pellux/goodvibes-sdk/platform/runtime/health/types';
22
- export { createCascadeAppliedEvent } from '@pellux/goodvibes-sdk/platform/runtime/health/types';
23
-
24
- export { RuntimeHealthAggregator } from '@pellux/goodvibes-sdk/platform/runtime/health/aggregator';
25
- export { CascadeEngine } from '@pellux/goodvibes-sdk/platform/runtime/health/cascade-engine';
26
- export { CASCADE_RULES } from '@pellux/goodvibes-sdk/platform/runtime/health/cascade-rules';
27
- export { HealthStoreWiring } from '@pellux/goodvibes-sdk/platform/runtime/health/wiring';
28
- export { handleCascadeEffect } from '@pellux/goodvibes-sdk/platform/runtime/health/effect-handlers';
29
- export type { EffectHandlerContext } from '@pellux/goodvibes-sdk/platform/runtime/health/effect-handlers';
30
- export { CascadeTimer, deriveCascadeSeverity } from '@pellux/goodvibes-sdk/platform/runtime/health/cascade-timing';
31
- export type { CascadeSeverity, TimedCascadeResult, TimedEvaluateResult } from '@pellux/goodvibes-sdk/platform/runtime/health/cascade-timing';
32
- export { CASCADE_PLAYBOOK_MAP, ALL_CASCADE_RULE_IDS } from '@pellux/goodvibes-sdk/platform/runtime/health/cascade-playbook-map';
33
-
34
- import { RuntimeHealthAggregator } from '@pellux/goodvibes-sdk/platform/runtime/health/aggregator';
35
- import { CascadeEngine } from '@pellux/goodvibes-sdk/platform/runtime/health/cascade-engine';
36
- import { CASCADE_RULES } from '@pellux/goodvibes-sdk/platform/runtime/health/cascade-rules';
37
- import { HealthStoreWiring } from '@pellux/goodvibes-sdk/platform/runtime/health/wiring';
38
-
39
- /**
40
- * Factory function that creates a fully wired health monitoring system.
41
- * The CascadeEngine is pre-loaded with all cascade rules from the rules table.
42
- *
43
- * @returns aggregator for tracking domain health, and cascadeEngine for evaluating cascades.
44
- */
45
- export function createHealthSystem(): {
46
- aggregator: RuntimeHealthAggregator;
47
- cascadeEngine: CascadeEngine;
48
- } {
49
- const aggregator = new RuntimeHealthAggregator();
50
- const cascadeEngine = new CascadeEngine(CASCADE_RULES, aggregator);
51
- return { aggregator, cascadeEngine };
52
- }
53
-
54
- /**
55
- * Factory function that creates a fully wired health monitoring system
56
- * with error propagation connected to the event bus.
57
- *
58
- * @param eventBus - The RuntimeEventBus to receive CASCADE_APPLIED events.
59
- * @returns aggregator, cascadeEngine, and the wiring controller.
60
- */
61
- export function createWiredHealthSystem(eventBus: import('../events/index.ts').RuntimeEventBus): {
62
- aggregator: RuntimeHealthAggregator;
63
- cascadeEngine: CascadeEngine;
64
- wiring: HealthStoreWiring;
65
- } {
66
- const aggregator = new RuntimeHealthAggregator();
67
- const cascadeEngine = new CascadeEngine(CASCADE_RULES, aggregator);
68
- const wiring = new HealthStoreWiring(aggregator, cascadeEngine, eventBus);
69
- return { aggregator, cascadeEngine, wiring };
70
- }