@pellux/goodvibes-tui 0.18.11 → 0.18.13

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 (570) hide show
  1. package/CHANGELOG.md +72 -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/config/index.ts +1 -138
  6. package/src/config/subscription-providers.ts +1 -127
  7. package/src/core/conversation-rendering.ts +5 -5
  8. package/src/core/conversation.ts +177 -424
  9. package/src/core/history.ts +45 -0
  10. package/src/core/orchestrator.ts +3 -733
  11. package/src/core/system-message-router.ts +19 -58
  12. package/src/input/command-registry.ts +3 -3
  13. package/src/input/commands/session-content.ts +2 -2
  14. package/src/input/commands/session-workflow.ts +1 -1
  15. package/src/input/handler-content-actions.ts +2 -2
  16. package/src/input/handler-feed.ts +2 -2
  17. package/src/input/handler-modal-token-routes.ts +1 -1
  18. package/src/input/handler-ui-state.ts +1 -1
  19. package/src/input/handler.ts +1 -1
  20. package/src/input/search.ts +1 -1
  21. package/src/input/selection.ts +2 -2
  22. package/src/input/session-picker-modal.ts +1 -1
  23. package/src/main.ts +1 -1
  24. package/src/panels/agent-inspector-panel.ts +3 -3
  25. package/src/panels/agent-logs-panel.ts +3 -3
  26. package/src/panels/approval-panel.ts +2 -2
  27. package/src/panels/automation-control-panel.ts +3 -3
  28. package/src/panels/base-panel.ts +14 -14
  29. package/src/panels/builtin/agent.ts +1 -0
  30. package/src/panels/builtin/operations.ts +2 -1
  31. package/src/panels/builtin/session.ts +2 -2
  32. package/src/panels/builtin/shared.ts +5 -5
  33. package/src/panels/cockpit-panel.ts +2 -2
  34. package/src/panels/communication-panel.ts +3 -3
  35. package/src/panels/context-visualizer-panel.ts +6 -3
  36. package/src/panels/control-plane-panel.ts +3 -3
  37. package/src/panels/cost-tracker-panel.ts +3 -3
  38. package/src/panels/debug-panel.ts +2 -2
  39. package/src/panels/diff-panel.ts +2 -2
  40. package/src/panels/docs-panel.ts +1 -1
  41. package/src/panels/eval-panel.ts +2 -2
  42. package/src/panels/file-explorer-panel.ts +3 -3
  43. package/src/panels/file-preview-panel.ts +3 -3
  44. package/src/panels/forensics-panel.ts +2 -2
  45. package/src/panels/git-panel.ts +1 -1
  46. package/src/panels/hooks-panel.ts +3 -3
  47. package/src/panels/incident-review-panel.ts +1 -1
  48. package/src/panels/intelligence-panel.ts +2 -2
  49. package/src/panels/knowledge-panel.ts +1 -1
  50. package/src/panels/local-auth-panel.ts +2 -2
  51. package/src/panels/marketplace-panel.ts +1 -1
  52. package/src/panels/mcp-panel.ts +3 -3
  53. package/src/panels/memory-panel.ts +1 -1
  54. package/src/panels/ops-control-panel.ts +3 -3
  55. package/src/panels/ops-strategy-panel.ts +2 -2
  56. package/src/panels/orchestration-panel.ts +2 -2
  57. package/src/panels/panel-list-panel.ts +6 -6
  58. package/src/panels/plan-dashboard-panel.ts +1 -1
  59. package/src/panels/plugins-panel.ts +2 -2
  60. package/src/panels/policy-panel.ts +2 -2
  61. package/src/panels/polish.ts +3 -3
  62. package/src/panels/provider-accounts-panel.ts +2 -2
  63. package/src/panels/provider-health-domains.ts +5 -1
  64. package/src/panels/provider-health-panel.ts +7 -3
  65. package/src/panels/provider-stats-panel.ts +3 -3
  66. package/src/panels/remote-panel.ts +3 -3
  67. package/src/panels/routes-panel.ts +3 -3
  68. package/src/panels/sandbox-panel.ts +2 -2
  69. package/src/panels/schedule-panel.ts +1 -1
  70. package/src/panels/security-panel.ts +2 -2
  71. package/src/panels/services-panel.ts +2 -2
  72. package/src/panels/session-browser-panel.ts +3 -3
  73. package/src/panels/settings-sync-panel.ts +2 -2
  74. package/src/panels/skills-panel.ts +6 -6
  75. package/src/panels/subscription-panel.ts +2 -2
  76. package/src/panels/symbol-outline-panel.ts +3 -3
  77. package/src/panels/system-messages-panel.ts +4 -4
  78. package/src/panels/tasks-panel.ts +2 -2
  79. package/src/panels/thinking-panel.ts +3 -3
  80. package/src/panels/token-budget-panel.ts +7 -3
  81. package/src/panels/tool-inspector-panel.ts +3 -3
  82. package/src/panels/types.ts +5 -5
  83. package/src/panels/watchers-panel.ts +3 -3
  84. package/src/panels/welcome-panel.ts +1 -1
  85. package/src/panels/worktree-panel.ts +2 -2
  86. package/src/panels/wrfc-panel.ts +3 -3
  87. package/src/permissions/prompt.ts +3 -22
  88. package/src/plugins/loader.ts +15 -304
  89. package/src/renderer/agent-detail-modal.ts +1 -1
  90. package/src/renderer/autocomplete-overlay.ts +2 -2
  91. package/src/renderer/bookmark-modal.ts +1 -1
  92. package/src/renderer/bottom-bar.ts +2 -2
  93. package/src/renderer/buffer.ts +1 -1
  94. package/src/renderer/code-block.ts +2 -2
  95. package/src/renderer/compositor.ts +2 -2
  96. package/src/renderer/context-inspector.ts +1 -1
  97. package/src/renderer/conversation-layout.ts +2 -2
  98. package/src/renderer/conversation-overlays.ts +1 -1
  99. package/src/renderer/conversation-surface.ts +2 -2
  100. package/src/renderer/diff-view.ts +2 -2
  101. package/src/renderer/diff.ts +1 -1
  102. package/src/renderer/file-picker-overlay.ts +2 -2
  103. package/src/renderer/file-tree.ts +2 -2
  104. package/src/renderer/help-overlay.ts +1 -1
  105. package/src/renderer/history-search-overlay.ts +2 -2
  106. package/src/renderer/live-tail-modal.ts +1 -1
  107. package/src/renderer/markdown.ts +2 -2
  108. package/src/renderer/modal-factory.ts +3 -3
  109. package/src/renderer/model-picker-overlay.ts +2 -2
  110. package/src/renderer/overlay-box.ts +2 -2
  111. package/src/renderer/panel-composite.ts +1 -1
  112. package/src/renderer/panel-picker-overlay.ts +2 -2
  113. package/src/renderer/panel-tab-bar.ts +1 -1
  114. package/src/renderer/panel-workspace-bar.ts +1 -1
  115. package/src/renderer/process-indicator.ts +2 -2
  116. package/src/renderer/process-modal.ts +1 -1
  117. package/src/renderer/profile-picker-modal.ts +2 -2
  118. package/src/renderer/progress.ts +2 -2
  119. package/src/renderer/search-overlay.ts +2 -2
  120. package/src/renderer/selection-modal-overlay.ts +2 -2
  121. package/src/renderer/session-picker-modal.ts +2 -2
  122. package/src/renderer/settings-modal.ts +2 -2
  123. package/src/renderer/shell-surface.ts +1 -1
  124. package/src/renderer/system-message.ts +1 -1
  125. package/src/renderer/tab-strip.ts +2 -2
  126. package/src/renderer/text-layout.ts +1 -1
  127. package/src/renderer/thinking.ts +1 -1
  128. package/src/renderer/tool-call.ts +2 -2
  129. package/src/renderer/ui-factory.ts +2 -2
  130. package/src/runtime/bootstrap-command-context.ts +7 -8
  131. package/src/runtime/bootstrap-command-parts.ts +4 -6
  132. package/src/runtime/bootstrap-core.ts +5 -4
  133. package/src/runtime/bootstrap-hook-bridge.ts +16 -175
  134. package/src/runtime/bootstrap-shell.ts +5 -5
  135. package/src/runtime/bootstrap.ts +6 -5
  136. package/src/runtime/context.ts +4 -20
  137. package/src/runtime/diagnostics/panels/index.ts +1 -1
  138. package/src/runtime/diagnostics/panels/ops.ts +1 -1
  139. package/src/runtime/diagnostics/panels/panel-resources.ts +118 -0
  140. package/src/runtime/perf/panel-contracts.ts +32 -0
  141. package/src/runtime/perf/panel-health-monitor.ts +18 -0
  142. package/src/runtime/services.ts +6 -6
  143. package/src/runtime/store/domains/conversation.ts +1 -181
  144. package/src/runtime/store/domains/permissions.ts +1 -143
  145. package/src/runtime/store/helpers/reducers/conversation.ts +1 -228
  146. package/src/runtime/store/helpers/reducers/lifecycle.ts +1 -440
  147. package/src/runtime/store/selectors/index.ts +11 -6
  148. package/src/runtime/store/state.ts +12 -4
  149. package/src/runtime/ui-read-models-observability-security.ts +2 -2
  150. package/src/runtime/ui-read-models-observability-system.ts +1 -1
  151. package/src/runtime/ui-service-queries.ts +1 -1
  152. package/src/runtime/ui-services.ts +1 -1
  153. package/src/shell/ui-openers.ts +1 -1
  154. package/src/tools/index.ts +1 -186
  155. package/src/types/grid.ts +48 -0
  156. package/src/utils/clipboard.ts +21 -0
  157. package/src/utils/splash-lines.ts +1 -1
  158. package/src/utils/terminal-width.ts +185 -0
  159. package/src/version.ts +1 -1
  160. package/src/acp/connection.ts +0 -447
  161. package/src/acp/index.ts +0 -7
  162. package/src/acp/manager.ts +0 -1
  163. package/src/adapters/bluebubbles/index.ts +0 -127
  164. package/src/adapters/discord/index.ts +0 -297
  165. package/src/adapters/github/index.ts +0 -73
  166. package/src/adapters/google-chat/index.ts +0 -119
  167. package/src/adapters/imessage/index.ts +0 -92
  168. package/src/adapters/index.ts +0 -15
  169. package/src/adapters/matrix/index.ts +0 -116
  170. package/src/adapters/mattermost/index.ts +0 -151
  171. package/src/adapters/msteams/index.ts +0 -180
  172. package/src/adapters/ntfy/index.ts +0 -118
  173. package/src/adapters/signal/index.ts +0 -92
  174. package/src/adapters/slack/index.ts +0 -323
  175. package/src/adapters/telegram/index.ts +0 -160
  176. package/src/adapters/types.ts +0 -97
  177. package/src/adapters/webhook/index.ts +0 -178
  178. package/src/adapters/whatsapp/index.ts +0 -135
  179. package/src/agents/message-bus-core.ts +0 -312
  180. package/src/agents/message-bus.ts +0 -2
  181. package/src/agents/orchestrator-prompts.ts +0 -351
  182. package/src/agents/orchestrator-runner.ts +0 -668
  183. package/src/agents/orchestrator.ts +0 -438
  184. package/src/agents/session.ts +0 -108
  185. package/src/agents/worktree.ts +0 -153
  186. package/src/agents/wrfc-config.ts +0 -47
  187. package/src/agents/wrfc-controller.ts +0 -747
  188. package/src/agents/wrfc-gate-runtime.ts +0 -75
  189. package/src/agents/wrfc-reporting.ts +0 -284
  190. package/src/agents/wrfc-runtime-events.ts +0 -150
  191. package/src/agents/wrfc-types.ts +0 -67
  192. package/src/automation/delivery-manager.ts +0 -368
  193. package/src/automation/index.ts +0 -72
  194. package/src/automation/manager-runtime-delivery.ts +0 -139
  195. package/src/automation/manager-runtime-events.ts +0 -131
  196. package/src/automation/manager-runtime-execution.ts +0 -511
  197. package/src/automation/manager-runtime-helpers.ts +0 -433
  198. package/src/automation/manager-runtime-job-mutations.ts +0 -175
  199. package/src/automation/manager-runtime-reconcile.ts +0 -148
  200. package/src/automation/manager-runtime-scheduling.ts +0 -189
  201. package/src/automation/manager-runtime-sync.ts +0 -54
  202. package/src/automation/manager-runtime.ts +0 -721
  203. package/src/automation/manager.ts +0 -10
  204. package/src/automation/service.ts +0 -242
  205. package/src/channels/builtin/account-actions.ts +0 -490
  206. package/src/channels/builtin/accounts.ts +0 -433
  207. package/src/channels/builtin/contracts.ts +0 -405
  208. package/src/channels/builtin/plugins.ts +0 -308
  209. package/src/channels/builtin/rendering.ts +0 -174
  210. package/src/channels/builtin/setup-schema.ts +0 -504
  211. package/src/channels/builtin/shared.ts +0 -96
  212. package/src/channels/builtin/surfaces.ts +0 -57
  213. package/src/channels/builtin/targets.ts +0 -693
  214. package/src/channels/builtin-runtime.ts +0 -443
  215. package/src/channels/delivery/shared.ts +0 -199
  216. package/src/channels/delivery/strategies-bridge.ts +0 -246
  217. package/src/channels/delivery/strategies-core.ts +0 -299
  218. package/src/channels/delivery/strategies-enterprise.ts +0 -178
  219. package/src/channels/delivery/types.ts +0 -59
  220. package/src/channels/delivery-router.ts +0 -127
  221. package/src/channels/index.ts +0 -77
  222. package/src/channels/plugin-registry.ts +0 -551
  223. package/src/channels/provider-runtime.ts +0 -330
  224. package/src/channels/reply-pipeline.ts +0 -522
  225. package/src/channels/route-manager.ts +0 -340
  226. package/src/channels/surface-registry.ts +0 -186
  227. package/src/config/helper-model.ts +0 -1
  228. package/src/config/manager.ts +0 -8
  229. package/src/config/subscription-auth.ts +0 -31
  230. package/src/config/tool-llm.ts +0 -110
  231. package/src/control-plane/approval-broker.ts +0 -351
  232. package/src/control-plane/gateway.ts +0 -1
  233. package/src/control-plane/index.ts +0 -54
  234. package/src/control-plane/media-contract-schemas.ts +0 -1
  235. package/src/control-plane/method-catalog-admin.ts +0 -1
  236. package/src/control-plane/method-catalog-channels.ts +0 -1
  237. package/src/control-plane/method-catalog-control-automation.ts +0 -1
  238. package/src/control-plane/method-catalog-control-core.ts +0 -1
  239. package/src/control-plane/method-catalog-control.ts +0 -1
  240. package/src/control-plane/method-catalog-events.ts +0 -1
  241. package/src/control-plane/method-catalog-knowledge.ts +0 -1
  242. package/src/control-plane/method-catalog-media.ts +0 -1
  243. package/src/control-plane/method-catalog-runtime.ts +0 -1
  244. package/src/control-plane/method-catalog-shared.ts +0 -1
  245. package/src/control-plane/method-catalog.ts +0 -1
  246. package/src/control-plane/operator-contract-schemas-admin.ts +0 -1
  247. package/src/control-plane/operator-contract-schemas-channels.ts +0 -1
  248. package/src/control-plane/operator-contract-schemas-control.ts +0 -1
  249. package/src/control-plane/operator-contract-schemas-domains.ts +0 -1
  250. package/src/control-plane/operator-contract-schemas-knowledge.ts +0 -1
  251. package/src/control-plane/operator-contract-schemas-media.ts +0 -1
  252. package/src/control-plane/operator-contract-schemas-permissions.ts +0 -1
  253. package/src/control-plane/operator-contract-schemas-remote.ts +0 -1
  254. package/src/control-plane/operator-contract-schemas-runtime.ts +0 -1
  255. package/src/control-plane/operator-contract-schemas-shared.ts +0 -1
  256. package/src/control-plane/operator-contract-schemas-telemetry.ts +0 -1
  257. package/src/control-plane/operator-contract-schemas.ts +0 -1
  258. package/src/control-plane/operator-contract.ts +0 -165
  259. package/src/control-plane/session-broker.ts +0 -780
  260. package/src/core/compaction-sections.ts +0 -492
  261. package/src/core/compaction-types.ts +0 -147
  262. package/src/core/context-compaction.ts +0 -542
  263. package/src/core/conversation-compaction.ts +0 -68
  264. package/src/core/conversation-diff.ts +0 -55
  265. package/src/core/conversation-utils.ts +0 -72
  266. package/src/core/event-replay.ts +0 -287
  267. package/src/core/orchestrator-context-runtime.ts +0 -407
  268. package/src/core/orchestrator-follow-up-runtime.ts +0 -134
  269. package/src/core/orchestrator-runtime.ts +0 -132
  270. package/src/core/orchestrator-tool-runtime.ts +0 -468
  271. package/src/core/orchestrator-turn-helpers.ts +0 -355
  272. package/src/core/orchestrator-turn-loop.ts +0 -443
  273. package/src/core/plan-command-handler.ts +0 -169
  274. package/src/core/transcript-events/classify.ts +0 -95
  275. package/src/core/transcript-events/index.ts +0 -15
  276. package/src/daemon/control-plane.ts +0 -522
  277. package/src/daemon/facade-composition.ts +0 -398
  278. package/src/daemon/facade.ts +0 -638
  279. package/src/daemon/helpers.ts +0 -74
  280. package/src/daemon/http/router-route-contexts.ts +0 -370
  281. package/src/daemon/http/router.ts +0 -531
  282. package/src/daemon/http-listener.ts +0 -301
  283. package/src/daemon/index.ts +0 -1
  284. package/src/daemon/server.ts +0 -1
  285. package/src/daemon/service-manager.ts +0 -413
  286. package/src/daemon/surface-actions.ts +0 -183
  287. package/src/daemon/surface-delivery.ts +0 -530
  288. package/src/daemon/surface-policy.ts +0 -60
  289. package/src/daemon/transport-events.ts +0 -110
  290. package/src/daemon/types.ts +0 -191
  291. package/src/export/markdown.ts +0 -213
  292. package/src/export/session-export.ts +0 -1
  293. package/src/git/index.ts +0 -1
  294. package/src/git/service.ts +0 -414
  295. package/src/hooks/chain-engine.ts +0 -414
  296. package/src/hooks/dispatcher.ts +0 -414
  297. package/src/hooks/hook-api.ts +0 -170
  298. package/src/hooks/index.ts +0 -48
  299. package/src/hooks/runners/agent.ts +0 -93
  300. package/src/hooks/runners/prompt.ts +0 -69
  301. package/src/hooks/workbench.ts +0 -360
  302. package/src/integrations/index.ts +0 -42
  303. package/src/integrations/notifier.ts +0 -206
  304. package/src/integrations/webhooks.ts +0 -1
  305. package/src/knowledge/consolidation.ts +0 -346
  306. package/src/knowledge/graphql.ts +0 -324
  307. package/src/knowledge/index.ts +0 -60
  308. package/src/knowledge/ingest-compile.ts +0 -386
  309. package/src/knowledge/ingest-context.ts +0 -18
  310. package/src/knowledge/ingest-inputs.ts +0 -387
  311. package/src/knowledge/ingest.ts +0 -1
  312. package/src/knowledge/internal.ts +0 -257
  313. package/src/knowledge/knowledge-api.ts +0 -432
  314. package/src/knowledge/lint.ts +0 -121
  315. package/src/knowledge/memory-sync.ts +0 -62
  316. package/src/knowledge/packet.ts +0 -370
  317. package/src/knowledge/scheduling.ts +0 -283
  318. package/src/knowledge/service.ts +0 -715
  319. package/src/mcp/client.ts +0 -383
  320. package/src/mcp/index.ts +0 -12
  321. package/src/mcp/mcp-api.ts +0 -90
  322. package/src/mcp/registry.ts +0 -1
  323. package/src/media/builtin-image-understanding.ts +0 -303
  324. package/src/media/builtin-providers.ts +0 -26
  325. package/src/media/index.ts +0 -18
  326. package/src/multimodal/index.ts +0 -13
  327. package/src/multimodal/service.ts +0 -492
  328. package/src/permissions/briefs/build.ts +0 -88
  329. package/src/permissions/manager.ts +0 -1
  330. package/src/plugins/api.ts +0 -383
  331. package/src/plugins/manager.ts +0 -481
  332. package/src/profiles/shape.ts +0 -58
  333. package/src/providers/amazon-bedrock-mantle.ts +0 -50
  334. package/src/providers/amazon-bedrock.ts +0 -61
  335. package/src/providers/anthropic-compat.ts +0 -373
  336. package/src/providers/anthropic-sdk-provider.ts +0 -230
  337. package/src/providers/anthropic-vertex.ts +0 -59
  338. package/src/providers/anthropic.ts +0 -469
  339. package/src/providers/auto-register.ts +0 -417
  340. package/src/providers/builtin-catalog.ts +0 -326
  341. package/src/providers/builtin-registry.ts +0 -575
  342. package/src/providers/cache-planner.ts +0 -258
  343. package/src/providers/capabilities.ts +0 -1
  344. package/src/providers/custom-loader.ts +0 -425
  345. package/src/providers/discovered-compat.ts +0 -7
  346. package/src/providers/discovered-factory.ts +0 -61
  347. package/src/providers/discovered-traits.ts +0 -138
  348. package/src/providers/gemini.ts +0 -462
  349. package/src/providers/github-copilot.ts +0 -254
  350. package/src/providers/index.ts +0 -1
  351. package/src/providers/interface.ts +0 -185
  352. package/src/providers/llama-cpp.ts +0 -402
  353. package/src/providers/lm-studio-helpers.ts +0 -367
  354. package/src/providers/lm-studio.ts +0 -484
  355. package/src/providers/model-catalog-cache.ts +0 -221
  356. package/src/providers/model-catalog-notifications.ts +0 -97
  357. package/src/providers/model-catalog-synthetic.ts +0 -202
  358. package/src/providers/model-catalog.ts +0 -211
  359. package/src/providers/model-limits.ts +0 -1
  360. package/src/providers/ollama.ts +0 -469
  361. package/src/providers/openai-codex.ts +0 -472
  362. package/src/providers/openai-compat.ts +0 -615
  363. package/src/providers/openai.ts +0 -231
  364. package/src/providers/optimizer.ts +0 -1
  365. package/src/providers/provider-api.ts +0 -1
  366. package/src/providers/registry-helpers.ts +0 -34
  367. package/src/providers/registry-models.ts +0 -77
  368. package/src/providers/registry-types.ts +0 -67
  369. package/src/providers/registry.ts +0 -1
  370. package/src/providers/runtime-metadata.ts +0 -149
  371. package/src/providers/runtime-snapshot.ts +0 -130
  372. package/src/providers/synthetic.ts +0 -561
  373. package/src/providers/tier-prompts.ts +0 -84
  374. package/src/providers/tool-formats.ts +0 -414
  375. package/src/runtime/auth/inspection.ts +0 -125
  376. package/src/runtime/bootstrap-background.ts +0 -157
  377. package/src/runtime/bootstrap-helpers.ts +0 -88
  378. package/src/runtime/bootstrap-runtime-events.ts +0 -254
  379. package/src/runtime/bootstrap-services.ts +0 -197
  380. package/src/runtime/compaction/index.ts +0 -1
  381. package/src/runtime/compaction/lifecycle.ts +0 -1
  382. package/src/runtime/compaction/manager.ts +0 -474
  383. package/src/runtime/compaction/quality-score.ts +0 -1
  384. package/src/runtime/compaction/resume-repair.ts +0 -1
  385. package/src/runtime/compaction/strategies/autocompact.ts +0 -1
  386. package/src/runtime/compaction/strategies/boundary-commit.ts +0 -1
  387. package/src/runtime/compaction/strategies/collapse.ts +0 -1
  388. package/src/runtime/compaction/strategies/index.ts +0 -1
  389. package/src/runtime/compaction/strategies/microcompact.ts +0 -1
  390. package/src/runtime/compaction/strategies/reactive.ts +0 -1
  391. package/src/runtime/compaction/types.ts +0 -1
  392. package/src/runtime/ecosystem/recommendations.ts +0 -117
  393. package/src/runtime/emitters/agents.ts +0 -96
  394. package/src/runtime/emitters/automation.ts +0 -112
  395. package/src/runtime/emitters/communication.ts +0 -53
  396. package/src/runtime/emitters/compaction.ts +0 -161
  397. package/src/runtime/emitters/control-plane.ts +0 -65
  398. package/src/runtime/emitters/deliveries.ts +0 -65
  399. package/src/runtime/emitters/forensics.ts +0 -17
  400. package/src/runtime/emitters/index.ts +0 -59
  401. package/src/runtime/emitters/knowledge.ts +0 -129
  402. package/src/runtime/emitters/mcp.ts +0 -95
  403. package/src/runtime/emitters/ops.ts +0 -163
  404. package/src/runtime/emitters/orchestration.ts +0 -87
  405. package/src/runtime/emitters/permissions.ts +0 -98
  406. package/src/runtime/emitters/planner.ts +0 -23
  407. package/src/runtime/emitters/plugins.ts +0 -78
  408. package/src/runtime/emitters/providers.ts +0 -30
  409. package/src/runtime/emitters/routes.ts +0 -57
  410. package/src/runtime/emitters/security.ts +0 -53
  411. package/src/runtime/emitters/session.ts +0 -93
  412. package/src/runtime/emitters/surfaces.ts +0 -57
  413. package/src/runtime/emitters/tasks.ts +0 -69
  414. package/src/runtime/emitters/tools.ts +0 -140
  415. package/src/runtime/emitters/transport.ts +0 -78
  416. package/src/runtime/emitters/turn.ts +0 -155
  417. package/src/runtime/emitters/ui.ts +0 -57
  418. package/src/runtime/emitters/watchers.ts +0 -57
  419. package/src/runtime/emitters/workflows.ts +0 -79
  420. package/src/runtime/eval/index.ts +0 -48
  421. package/src/runtime/eval/runner.ts +0 -163
  422. package/src/runtime/eval/suites.ts +0 -264
  423. package/src/runtime/events/domain-map.ts +0 -148
  424. package/src/runtime/events/index.ts +0 -1
  425. package/src/runtime/events/turn.ts +0 -1
  426. package/src/runtime/events/workflows.ts +0 -1
  427. package/src/runtime/forensics/collector.ts +0 -693
  428. package/src/runtime/forensics/index.ts +0 -23
  429. package/src/runtime/foundation-clients.ts +0 -78
  430. package/src/runtime/foundation-services.ts +0 -96
  431. package/src/runtime/guidance.ts +0 -183
  432. package/src/runtime/health/effect-handlers.ts +0 -189
  433. package/src/runtime/health/index.ts +0 -70
  434. package/src/runtime/health/wiring.ts +0 -115
  435. package/src/runtime/integration/helpers.ts +0 -640
  436. package/src/runtime/lifecycle.ts +0 -107
  437. package/src/runtime/mcp/index.ts +0 -68
  438. package/src/runtime/mcp/manager.ts +0 -513
  439. package/src/runtime/network/inbound.ts +0 -131
  440. package/src/runtime/network/index.ts +0 -30
  441. package/src/runtime/network/outbound.ts +0 -292
  442. package/src/runtime/network/shared.ts +0 -82
  443. package/src/runtime/operator-client.ts +0 -235
  444. package/src/runtime/ops/control-plane.ts +0 -363
  445. package/src/runtime/ops/index.ts +0 -122
  446. package/src/runtime/ops/playbooks/index.ts +0 -10
  447. package/src/runtime/ops/playbooks/session-unrecoverable.ts +0 -196
  448. package/src/runtime/ops/playbooks/stuck-turn.ts +0 -197
  449. package/src/runtime/ops/runtime-context.ts +0 -100
  450. package/src/runtime/ops-api.ts +0 -27
  451. package/src/runtime/orchestration/spawn-policy.ts +0 -83
  452. package/src/runtime/peer-client.ts +0 -404
  453. package/src/runtime/perf/index.ts +0 -57
  454. package/src/runtime/perf/slo-collector.ts +0 -375
  455. package/src/runtime/permissions/index.ts +0 -190
  456. package/src/runtime/permissions/policy-runtime.ts +0 -1
  457. package/src/runtime/permissions/preflight.ts +0 -101
  458. package/src/runtime/permissions/rule-suggestions.ts +0 -36
  459. package/src/runtime/plugins/hot-reload.ts +0 -221
  460. package/src/runtime/plugins/index.ts +0 -84
  461. package/src/runtime/plugins/lifecycle.ts +0 -95
  462. package/src/runtime/plugins/manager.ts +0 -474
  463. package/src/runtime/plugins/manifest.ts +0 -167
  464. package/src/runtime/plugins/quarantine.ts +0 -202
  465. package/src/runtime/plugins/trust.ts +0 -291
  466. package/src/runtime/plugins/types.ts +0 -205
  467. package/src/runtime/provider-accounts/registry.ts +0 -326
  468. package/src/runtime/remote/distributed-runtime-contract-schemas.ts +0 -386
  469. package/src/runtime/remote/index.ts +0 -488
  470. package/src/runtime/remote/runner-registry.ts +0 -438
  471. package/src/runtime/remote/supervisor.ts +0 -70
  472. package/src/runtime/runtime-hook-api.ts +0 -5
  473. package/src/runtime/runtime-knowledge-api.ts +0 -14
  474. package/src/runtime/runtime-mcp-api.ts +0 -5
  475. package/src/runtime/runtime-ops-api.ts +0 -86
  476. package/src/runtime/runtime-provider-api.ts +0 -18
  477. package/src/runtime/session-maintenance.ts +0 -188
  478. package/src/runtime/session-persistence.ts +0 -288
  479. package/src/runtime/session-return-context.ts +0 -195
  480. package/src/runtime/settings/control-plane-store.ts +0 -258
  481. package/src/runtime/settings/control-plane.ts +0 -599
  482. package/src/runtime/shell-command-extensions.ts +0 -54
  483. package/src/runtime/shell-command-ops.ts +0 -207
  484. package/src/runtime/shell-command-platform.ts +0 -47
  485. package/src/runtime/shell-command-services.ts +0 -143
  486. package/src/runtime/shell-command-workspace.ts +0 -31
  487. package/src/runtime/tasks/adapters/acp-adapter.ts +0 -211
  488. package/src/runtime/tasks/adapters/agent-adapter.ts +0 -208
  489. package/src/runtime/tasks/adapters/index.ts +0 -16
  490. package/src/runtime/tasks/adapters/process-adapter.ts +0 -214
  491. package/src/runtime/tasks/adapters/scheduler-adapter.ts +0 -193
  492. package/src/runtime/tasks/index.ts +0 -68
  493. package/src/runtime/tasks/manager.ts +0 -415
  494. package/src/runtime/telemetry/api-helpers.ts +0 -517
  495. package/src/runtime/telemetry/api.ts +0 -768
  496. package/src/runtime/telemetry/index.ts +0 -178
  497. package/src/runtime/telemetry/instrumentation/domain-bridge-agent-session.ts +0 -440
  498. package/src/runtime/telemetry/instrumentation/domain-bridge-plugin-mcp.ts +0 -200
  499. package/src/runtime/telemetry/instrumentation/domain-bridge-shared.ts +0 -18
  500. package/src/runtime/telemetry/instrumentation/domain-bridge-transport-task.ts +0 -204
  501. package/src/runtime/telemetry/instrumentation/domain-bridge.ts +0 -125
  502. package/src/runtime/telemetry/instrumentation/index.ts +0 -67
  503. package/src/runtime/tools/context.ts +0 -114
  504. package/src/runtime/tools/index.ts +0 -46
  505. package/src/runtime/tools/phased-executor.ts +0 -448
  506. package/src/runtime/tools/phases/budget.ts +0 -130
  507. package/src/runtime/tools/phases/execute.ts +0 -69
  508. package/src/runtime/tools/phases/index.ts +0 -13
  509. package/src/runtime/tools/phases/map-output.ts +0 -98
  510. package/src/runtime/tools/phases/permission.ts +0 -133
  511. package/src/runtime/tools/phases/posthook.ts +0 -57
  512. package/src/runtime/tools/phases/prehook.ts +0 -68
  513. package/src/runtime/tools/phases/validate.ts +0 -53
  514. package/src/runtime/transports/direct.ts +0 -73
  515. package/src/runtime/transports/http-helpers.ts +0 -218
  516. package/src/runtime/transports/http-types.ts +0 -364
  517. package/src/runtime/transports/http.ts +0 -629
  518. package/src/runtime/transports/realtime.ts +0 -50
  519. package/src/runtime/transports/remote-events.ts +0 -16
  520. package/src/runtime/transports/shared.ts +0 -39
  521. package/src/runtime/transports/ui-runtime-events.ts +0 -35
  522. package/src/runtime/ui-read-models-core.ts +0 -95
  523. package/src/runtime/ui-read-models-operations.ts +0 -203
  524. package/src/runtime/worktree/registry.ts +0 -252
  525. package/src/sessions/manager.ts +0 -14
  526. package/src/state/file-watcher.ts +0 -294
  527. package/src/state/index.ts +0 -56
  528. package/src/state/knowledge-injection.ts +0 -214
  529. package/src/state/memory-embedding-http.ts +0 -642
  530. package/src/state/memory-embeddings.ts +0 -312
  531. package/src/state/memory-ingest.ts +0 -132
  532. package/src/state/memory-registry.ts +0 -111
  533. package/src/state/memory-store-helpers.ts +0 -160
  534. package/src/state/memory-store.ts +0 -728
  535. package/src/state/memory-vector-store.ts +0 -418
  536. package/src/templates/manager.ts +0 -187
  537. package/src/tools/agent/index.ts +0 -610
  538. package/src/tools/agent/manager.ts +0 -476
  539. package/src/tools/analyze/git-modes.ts +0 -380
  540. package/src/tools/analyze/index.ts +0 -128
  541. package/src/tools/channel/agent-tools.ts +0 -16
  542. package/src/tools/channel/index.ts +0 -268
  543. package/src/tools/control/index.ts +0 -90
  544. package/src/tools/edit/core.ts +0 -619
  545. package/src/tools/edit/index.ts +0 -4
  546. package/src/tools/edit/phased.ts +0 -33
  547. package/src/tools/fetch/index.ts +0 -3
  548. package/src/tools/fetch/phased.ts +0 -34
  549. package/src/tools/fetch/runtime.ts +0 -499
  550. package/src/tools/mcp/index.ts +0 -190
  551. package/src/tools/remote-trigger/index.ts +0 -130
  552. package/src/tools/shared/auto-heal.ts +0 -282
  553. package/src/tools/state/index.ts +0 -688
  554. package/src/tools/web-search/index.ts +0 -38
  555. package/src/tools/write/index.ts +0 -604
  556. package/src/tools/write/phased.ts +0 -41
  557. package/src/types/generated/foundation-client-types.ts +0 -22
  558. package/src/watchers/index.ts +0 -11
  559. package/src/watchers/registry.ts +0 -517
  560. package/src/web-search/index.ts +0 -26
  561. package/src/web-search/provider-registry.ts +0 -64
  562. package/src/web-search/providers/brave.ts +0 -100
  563. package/src/web-search/providers/duckduckgo.ts +0 -270
  564. package/src/web-search/providers/exa.ts +0 -77
  565. package/src/web-search/providers/firecrawl.ts +0 -90
  566. package/src/web-search/providers/perplexity.ts +0 -86
  567. package/src/web-search/providers/searxng.ts +0 -88
  568. package/src/web-search/providers/shared.ts +0 -249
  569. package/src/web-search/providers/tavily.ts +0 -90
  570. 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
- }