@alan512/experienceengine 0.1.3 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (605) hide show
  1. package/.claude-plugin/marketplace.json +0 -0
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/.env.example +0 -0
  4. package/.mcp.json +0 -0
  5. package/LICENSE +0 -0
  6. package/README.md +196 -114
  7. package/README.zh-CN.md +230 -100
  8. package/dist/adapters/claude-code/event-store.d.ts +0 -0
  9. package/dist/adapters/claude-code/event-store.js +0 -0
  10. package/dist/adapters/claude-code/event-store.js.map +0 -0
  11. package/dist/adapters/claude-code/hook-normalizer.d.ts +0 -0
  12. package/dist/adapters/claude-code/hook-normalizer.js +0 -0
  13. package/dist/adapters/claude-code/hook-normalizer.js.map +0 -0
  14. package/dist/adapters/claude-code/runtime-projection.d.ts +0 -0
  15. package/dist/adapters/claude-code/runtime-projection.js +0 -0
  16. package/dist/adapters/claude-code/runtime-projection.js.map +0 -0
  17. package/dist/adapters/claude-code/session-store.d.ts +1 -0
  18. package/dist/adapters/claude-code/session-store.js +24 -1
  19. package/dist/adapters/claude-code/session-store.js.map +1 -1
  20. package/dist/adapters/codex/action-registry.d.ts +84 -0
  21. package/dist/adapters/codex/action-registry.js +277 -0
  22. package/dist/adapters/codex/action-registry.js.map +1 -0
  23. package/dist/adapters/codex/broker-tools.d.ts +114 -0
  24. package/dist/adapters/codex/broker-tools.js +130 -0
  25. package/dist/adapters/codex/broker-tools.js.map +1 -0
  26. package/dist/adapters/codex/instruction-template.d.ts +0 -0
  27. package/dist/adapters/codex/instruction-template.js +0 -0
  28. package/dist/adapters/codex/instruction-template.js.map +0 -0
  29. package/dist/adapters/codex/mcp-server.d.ts +21 -0
  30. package/dist/adapters/codex/mcp-server.js +103 -423
  31. package/dist/adapters/codex/mcp-server.js.map +1 -1
  32. package/dist/analyzer/candidate-signals.d.ts +3 -1
  33. package/dist/analyzer/candidate-signals.js +159 -0
  34. package/dist/analyzer/candidate-signals.js.map +1 -1
  35. package/dist/analyzer/experience-analyzer.d.ts +0 -0
  36. package/dist/analyzer/experience-analyzer.js +0 -0
  37. package/dist/analyzer/experience-analyzer.js.map +0 -0
  38. package/dist/analyzer/extraction-evidence.d.ts +0 -0
  39. package/dist/analyzer/extraction-evidence.js +0 -0
  40. package/dist/analyzer/extraction-evidence.js.map +0 -0
  41. package/dist/analyzer/llm-learning-gate.d.ts +12 -1
  42. package/dist/analyzer/llm-learning-gate.js +633 -16
  43. package/dist/analyzer/llm-learning-gate.js.map +1 -1
  44. package/dist/analyzer/node-deduper.d.ts +0 -0
  45. package/dist/analyzer/node-deduper.js +0 -0
  46. package/dist/analyzer/node-deduper.js.map +0 -0
  47. package/dist/analyzer/node-normalizer.d.ts +0 -0
  48. package/dist/analyzer/node-normalizer.js +0 -0
  49. package/dist/analyzer/node-normalizer.js.map +0 -0
  50. package/dist/analyzer/storage-gate.d.ts +0 -0
  51. package/dist/analyzer/storage-gate.js +0 -0
  52. package/dist/analyzer/storage-gate.js.map +0 -0
  53. package/dist/analyzer/strategy-extractor.d.ts +0 -0
  54. package/dist/analyzer/strategy-extractor.js +0 -0
  55. package/dist/analyzer/strategy-extractor.js.map +0 -0
  56. package/dist/analyzer/warning-extractor.d.ts +0 -0
  57. package/dist/analyzer/warning-extractor.js +0 -0
  58. package/dist/analyzer/warning-extractor.js.map +0 -0
  59. package/dist/cli/commands/backup.d.ts +0 -0
  60. package/dist/cli/commands/backup.js +0 -0
  61. package/dist/cli/commands/backup.js.map +0 -0
  62. package/dist/cli/commands/claude-hook.d.ts +0 -0
  63. package/dist/cli/commands/claude-hook.js +11 -4
  64. package/dist/cli/commands/claude-hook.js.map +1 -1
  65. package/dist/cli/commands/codex-mcp-server.d.ts +0 -0
  66. package/dist/cli/commands/codex-mcp-server.js +0 -0
  67. package/dist/cli/commands/codex-mcp-server.js.map +0 -0
  68. package/dist/cli/commands/codex.d.ts +60 -0
  69. package/dist/cli/commands/codex.js +188 -0
  70. package/dist/cli/commands/codex.js.map +1 -0
  71. package/dist/cli/commands/config.d.ts +0 -0
  72. package/dist/cli/commands/config.js +0 -0
  73. package/dist/cli/commands/config.js.map +0 -0
  74. package/dist/cli/commands/cool.d.ts +0 -0
  75. package/dist/cli/commands/cool.js +0 -0
  76. package/dist/cli/commands/cool.js.map +0 -0
  77. package/dist/cli/commands/disable.d.ts +0 -0
  78. package/dist/cli/commands/disable.js +0 -0
  79. package/dist/cli/commands/disable.js.map +0 -0
  80. package/dist/cli/commands/doctor.d.ts +0 -0
  81. package/dist/cli/commands/doctor.js +20 -0
  82. package/dist/cli/commands/doctor.js.map +1 -1
  83. package/dist/cli/commands/enable.d.ts +0 -0
  84. package/dist/cli/commands/enable.js +0 -0
  85. package/dist/cli/commands/enable.js.map +0 -0
  86. package/dist/cli/commands/evaluate.d.ts +9 -3
  87. package/dist/cli/commands/evaluate.js +31 -5
  88. package/dist/cli/commands/evaluate.js.map +1 -1
  89. package/dist/cli/commands/export.d.ts +0 -0
  90. package/dist/cli/commands/export.js +0 -0
  91. package/dist/cli/commands/export.js.map +0 -0
  92. package/dist/cli/commands/feedback.d.ts +0 -0
  93. package/dist/cli/commands/feedback.js +0 -0
  94. package/dist/cli/commands/feedback.js.map +0 -0
  95. package/dist/cli/commands/import.d.ts +0 -0
  96. package/dist/cli/commands/import.js +0 -0
  97. package/dist/cli/commands/import.js.map +0 -0
  98. package/dist/cli/commands/init.d.ts +0 -0
  99. package/dist/cli/commands/init.js +21 -8
  100. package/dist/cli/commands/init.js.map +1 -1
  101. package/dist/cli/commands/inspect.d.ts +0 -0
  102. package/dist/cli/commands/inspect.js +69 -1
  103. package/dist/cli/commands/inspect.js.map +1 -1
  104. package/dist/cli/commands/install.d.ts +0 -0
  105. package/dist/cli/commands/install.js +0 -0
  106. package/dist/cli/commands/install.js.map +0 -0
  107. package/dist/cli/commands/maintenance.d.ts +0 -0
  108. package/dist/cli/commands/maintenance.js +0 -0
  109. package/dist/cli/commands/maintenance.js.map +0 -0
  110. package/dist/cli/commands/mcp-server.d.ts +0 -0
  111. package/dist/cli/commands/mcp-server.js +0 -0
  112. package/dist/cli/commands/mcp-server.js.map +0 -0
  113. package/dist/cli/commands/models.d.ts +0 -0
  114. package/dist/cli/commands/models.js +0 -0
  115. package/dist/cli/commands/models.js.map +0 -0
  116. package/dist/cli/commands/repair.d.ts +0 -0
  117. package/dist/cli/commands/repair.js +3 -3
  118. package/dist/cli/commands/repair.js.map +1 -1
  119. package/dist/cli/commands/retire.d.ts +0 -0
  120. package/dist/cli/commands/retire.js +0 -0
  121. package/dist/cli/commands/retire.js.map +0 -0
  122. package/dist/cli/commands/rollback.d.ts +0 -0
  123. package/dist/cli/commands/rollback.js +0 -0
  124. package/dist/cli/commands/rollback.js.map +0 -0
  125. package/dist/cli/commands/stats.d.ts +0 -0
  126. package/dist/cli/commands/stats.js +0 -0
  127. package/dist/cli/commands/stats.js.map +0 -0
  128. package/dist/cli/commands/status.d.ts +0 -0
  129. package/dist/cli/commands/status.js +32 -0
  130. package/dist/cli/commands/status.js.map +1 -1
  131. package/dist/cli/commands/upgrade.d.ts +0 -0
  132. package/dist/cli/commands/upgrade.js +0 -0
  133. package/dist/cli/commands/upgrade.js.map +0 -0
  134. package/dist/cli/dispatch.d.ts +0 -0
  135. package/dist/cli/dispatch.js +16 -4
  136. package/dist/cli/dispatch.js.map +1 -1
  137. package/dist/cli/index.d.ts +0 -0
  138. package/dist/cli/index.js.map +0 -0
  139. package/dist/cli/state-model.d.ts +0 -0
  140. package/dist/cli/state-model.js +0 -0
  141. package/dist/cli/state-model.js.map +0 -0
  142. package/dist/config/config-schema.d.ts +177 -0
  143. package/dist/config/config-schema.js +142 -1
  144. package/dist/config/config-schema.js.map +1 -1
  145. package/dist/config/default-config.d.ts +0 -0
  146. package/dist/config/default-config.js +19 -1
  147. package/dist/config/default-config.js.map +1 -1
  148. package/dist/config/load-config.d.ts +0 -0
  149. package/dist/config/load-config.js +72 -1
  150. package/dist/config/load-config.js.map +1 -1
  151. package/dist/config/path-resolver.d.ts +0 -0
  152. package/dist/config/path-resolver.js +0 -0
  153. package/dist/config/path-resolver.js.map +0 -0
  154. package/dist/config/runtime-env.d.ts +0 -0
  155. package/dist/config/runtime-env.js +0 -0
  156. package/dist/config/runtime-env.js.map +0 -0
  157. package/dist/config/secrets-store.d.ts +0 -0
  158. package/dist/config/secrets-store.js +0 -0
  159. package/dist/config/secrets-store.js.map +0 -0
  160. package/dist/config/settings-store.d.ts +19 -0
  161. package/dist/config/settings-store.js +11 -0
  162. package/dist/config/settings-store.js.map +1 -1
  163. package/dist/controller/candidate-retriever.d.ts +15 -1
  164. package/dist/controller/candidate-retriever.js +91 -137
  165. package/dist/controller/candidate-retriever.js.map +1 -1
  166. package/dist/controller/injection-renderer.d.ts +0 -0
  167. package/dist/controller/injection-renderer.js +0 -0
  168. package/dist/controller/injection-renderer.js.map +0 -0
  169. package/dist/controller/injection-scorecard.d.ts +2 -14
  170. package/dist/controller/injection-scorecard.js +29 -0
  171. package/dist/controller/injection-scorecard.js.map +1 -1
  172. package/dist/controller/inline-notice.d.ts +0 -0
  173. package/dist/controller/inline-notice.js +0 -0
  174. package/dist/controller/inline-notice.js.map +0 -0
  175. package/dist/controller/intervention-controller.d.ts +3 -15
  176. package/dist/controller/intervention-controller.js +217 -57
  177. package/dist/controller/intervention-controller.js.map +1 -1
  178. package/dist/controller/lexical-retriever.d.ts +0 -0
  179. package/dist/controller/lexical-retriever.js +0 -0
  180. package/dist/controller/lexical-retriever.js.map +0 -0
  181. package/dist/controller/model-reranker.d.ts +0 -0
  182. package/dist/controller/model-reranker.js +0 -0
  183. package/dist/controller/model-reranker.js.map +0 -0
  184. package/dist/controller/node-ranker.d.ts +0 -0
  185. package/dist/controller/node-ranker.js +0 -0
  186. package/dist/controller/node-ranker.js.map +0 -0
  187. package/dist/controller/policy-enricher.d.ts +10 -0
  188. package/dist/controller/policy-enricher.js +186 -0
  189. package/dist/controller/policy-enricher.js.map +1 -0
  190. package/dist/controller/query-rewrite.d.ts +0 -0
  191. package/dist/controller/query-rewrite.js +0 -0
  192. package/dist/controller/query-rewrite.js.map +0 -0
  193. package/dist/controller/retrieval-context.d.ts +3 -0
  194. package/dist/controller/retrieval-context.js +37 -0
  195. package/dist/controller/retrieval-context.js.map +1 -0
  196. package/dist/controller/second-opinion-gate.d.ts +41 -0
  197. package/dist/controller/second-opinion-gate.js +225 -0
  198. package/dist/controller/second-opinion-gate.js.map +1 -0
  199. package/dist/controller/trigger-evaluator.d.ts +4 -0
  200. package/dist/controller/trigger-evaluator.js +8 -2
  201. package/dist/controller/trigger-evaluator.js.map +1 -1
  202. package/dist/distillation/errors.d.ts +0 -0
  203. package/dist/distillation/errors.js +0 -0
  204. package/dist/distillation/errors.js.map +0 -0
  205. package/dist/distillation/experience-family.d.ts +0 -0
  206. package/dist/distillation/experience-family.js +0 -0
  207. package/dist/distillation/experience-family.js.map +0 -0
  208. package/dist/distillation/host-llm.d.ts +0 -0
  209. package/dist/distillation/host-llm.js +0 -0
  210. package/dist/distillation/host-llm.js.map +0 -0
  211. package/dist/distillation/llm-distiller.d.ts +0 -0
  212. package/dist/distillation/llm-distiller.js +0 -0
  213. package/dist/distillation/llm-distiller.js.map +0 -0
  214. package/dist/distillation/merge-decider.d.ts +0 -0
  215. package/dist/distillation/merge-decider.js +0 -0
  216. package/dist/distillation/merge-decider.js.map +0 -0
  217. package/dist/distillation/model-catalog.d.ts +0 -0
  218. package/dist/distillation/model-catalog.js +0 -0
  219. package/dist/distillation/model-catalog.js.map +0 -0
  220. package/dist/distillation/prompt-contract.d.ts +1 -1
  221. package/dist/distillation/prompt-contract.js +3 -1
  222. package/dist/distillation/prompt-contract.js.map +1 -1
  223. package/dist/distillation/providers/anthropic.d.ts +0 -0
  224. package/dist/distillation/providers/anthropic.js +0 -0
  225. package/dist/distillation/providers/anthropic.js.map +0 -0
  226. package/dist/distillation/providers/azure-openai.d.ts +0 -0
  227. package/dist/distillation/providers/azure-openai.js +0 -0
  228. package/dist/distillation/providers/azure-openai.js.map +0 -0
  229. package/dist/distillation/providers/baidu-qianfan.d.ts +0 -0
  230. package/dist/distillation/providers/baidu-qianfan.js +0 -0
  231. package/dist/distillation/providers/baidu-qianfan.js.map +0 -0
  232. package/dist/distillation/providers/bedrock.d.ts +0 -0
  233. package/dist/distillation/providers/bedrock.js +0 -0
  234. package/dist/distillation/providers/bedrock.js.map +0 -0
  235. package/dist/distillation/providers/dashscope.d.ts +0 -0
  236. package/dist/distillation/providers/dashscope.js +0 -0
  237. package/dist/distillation/providers/dashscope.js.map +0 -0
  238. package/dist/distillation/providers/deepseek.d.ts +0 -0
  239. package/dist/distillation/providers/deepseek.js +0 -0
  240. package/dist/distillation/providers/deepseek.js.map +0 -0
  241. package/dist/distillation/providers/gemini.d.ts +0 -0
  242. package/dist/distillation/providers/gemini.js +5 -1
  243. package/dist/distillation/providers/gemini.js.map +1 -1
  244. package/dist/distillation/providers/google-adc.d.ts +0 -0
  245. package/dist/distillation/providers/google-adc.js +0 -0
  246. package/dist/distillation/providers/google-adc.js.map +0 -0
  247. package/dist/distillation/providers/minimax.d.ts +0 -0
  248. package/dist/distillation/providers/minimax.js +0 -0
  249. package/dist/distillation/providers/minimax.js.map +0 -0
  250. package/dist/distillation/providers/moonshot.d.ts +0 -0
  251. package/dist/distillation/providers/moonshot.js +0 -0
  252. package/dist/distillation/providers/moonshot.js.map +0 -0
  253. package/dist/distillation/providers/openai-compatible-factory.d.ts +0 -0
  254. package/dist/distillation/providers/openai-compatible-factory.js +0 -0
  255. package/dist/distillation/providers/openai-compatible-factory.js.map +0 -0
  256. package/dist/distillation/providers/openai-compatible.d.ts +0 -0
  257. package/dist/distillation/providers/openai-compatible.js +0 -0
  258. package/dist/distillation/providers/openai-compatible.js.map +0 -0
  259. package/dist/distillation/providers/openai.d.ts +0 -0
  260. package/dist/distillation/providers/openai.js +0 -0
  261. package/dist/distillation/providers/openai.js.map +0 -0
  262. package/dist/distillation/providers/openrouter.d.ts +0 -0
  263. package/dist/distillation/providers/openrouter.js +0 -0
  264. package/dist/distillation/providers/openrouter.js.map +0 -0
  265. package/dist/distillation/providers/registry.d.ts +0 -0
  266. package/dist/distillation/providers/registry.js +0 -0
  267. package/dist/distillation/providers/registry.js.map +0 -0
  268. package/dist/distillation/providers/siliconflow.d.ts +0 -0
  269. package/dist/distillation/providers/siliconflow.js +0 -0
  270. package/dist/distillation/providers/siliconflow.js.map +0 -0
  271. package/dist/distillation/providers/tencent-hunyuan.d.ts +0 -0
  272. package/dist/distillation/providers/tencent-hunyuan.js +0 -0
  273. package/dist/distillation/providers/tencent-hunyuan.js.map +0 -0
  274. package/dist/distillation/providers/types.d.ts +0 -0
  275. package/dist/distillation/providers/types.js +0 -0
  276. package/dist/distillation/providers/types.js.map +0 -0
  277. package/dist/distillation/providers/volcengine-ark.d.ts +0 -0
  278. package/dist/distillation/providers/volcengine-ark.js +0 -0
  279. package/dist/distillation/providers/volcengine-ark.js.map +0 -0
  280. package/dist/distillation/providers/zhipu.d.ts +0 -0
  281. package/dist/distillation/providers/zhipu.js +0 -0
  282. package/dist/distillation/providers/zhipu.js.map +0 -0
  283. package/dist/distillation/queue-worker.d.ts +0 -0
  284. package/dist/distillation/queue-worker.js +22 -3
  285. package/dist/distillation/queue-worker.js.map +1 -1
  286. package/dist/distillation/types.d.ts +0 -0
  287. package/dist/distillation/types.js +0 -0
  288. package/dist/distillation/types.js.map +0 -0
  289. package/dist/evaluation/benchmark-report.d.ts +0 -0
  290. package/dist/evaluation/benchmark-report.js +0 -0
  291. package/dist/evaluation/benchmark-report.js.map +0 -0
  292. package/dist/evaluation/benchmark-summary.d.ts +0 -0
  293. package/dist/evaluation/benchmark-summary.js +0 -0
  294. package/dist/evaluation/benchmark-summary.js.map +0 -0
  295. package/dist/evaluation/codex-lifecycle-validation.d.ts +60 -0
  296. package/dist/evaluation/codex-lifecycle-validation.js +233 -0
  297. package/dist/evaluation/codex-lifecycle-validation.js.map +1 -0
  298. package/dist/evaluation/hybrid-phase1-rollout-summary.d.ts +63 -0
  299. package/dist/evaluation/hybrid-phase1-rollout-summary.js +108 -0
  300. package/dist/evaluation/hybrid-phase1-rollout-summary.js.map +1 -0
  301. package/dist/evaluation/hybrid-phase3-gate-metrics.d.ts +26 -0
  302. package/dist/evaluation/hybrid-phase3-gate-metrics.js +23 -0
  303. package/dist/evaluation/hybrid-phase3-gate-metrics.js.map +1 -0
  304. package/dist/evaluation/openclaw-baseline.d.ts +8 -0
  305. package/dist/evaluation/openclaw-baseline.js +27 -0
  306. package/dist/evaluation/openclaw-baseline.js.map +1 -1
  307. package/dist/evaluation/openclaw-scenarios.d.ts +0 -0
  308. package/dist/evaluation/openclaw-scenarios.js +0 -0
  309. package/dist/evaluation/openclaw-scenarios.js.map +0 -0
  310. package/dist/experience-management/governance-observability.d.ts +13 -0
  311. package/dist/experience-management/governance-observability.js +37 -0
  312. package/dist/experience-management/governance-observability.js.map +1 -0
  313. package/dist/experience-management/node-lifecycle-governance.d.ts +8 -0
  314. package/dist/experience-management/node-lifecycle-governance.js +80 -0
  315. package/dist/experience-management/node-lifecycle-governance.js.map +1 -0
  316. package/dist/experience-management/task-management-signals.d.ts +29 -0
  317. package/dist/experience-management/task-management-signals.js +148 -0
  318. package/dist/experience-management/task-management-signals.js.map +1 -0
  319. package/dist/feedback/automatic-attribution.d.ts +0 -0
  320. package/dist/feedback/automatic-attribution.js +0 -0
  321. package/dist/feedback/automatic-attribution.js.map +0 -0
  322. package/dist/feedback/feedback-manager.d.ts +4 -1
  323. package/dist/feedback/feedback-manager.js +11 -22
  324. package/dist/feedback/feedback-manager.js.map +1 -1
  325. package/dist/feedback/harm-detector.d.ts +0 -0
  326. package/dist/feedback/harm-detector.js +0 -0
  327. package/dist/feedback/harm-detector.js.map +0 -0
  328. package/dist/feedback/state-transition.d.ts +6 -1
  329. package/dist/feedback/state-transition.js +6 -3
  330. package/dist/feedback/state-transition.js.map +1 -1
  331. package/dist/feedback/stats-updater.d.ts +0 -0
  332. package/dist/feedback/stats-updater.js +0 -0
  333. package/dist/feedback/stats-updater.js.map +0 -0
  334. package/dist/hybrid/capsule-builder.d.ts +23 -0
  335. package/dist/hybrid/capsule-builder.js +114 -0
  336. package/dist/hybrid/capsule-builder.js.map +1 -0
  337. package/dist/hybrid/explain-provider-client.d.ts +19 -0
  338. package/dist/hybrid/explain-provider-client.js +34 -0
  339. package/dist/hybrid/explain-provider-client.js.map +1 -0
  340. package/dist/hybrid/postmortem-provider-client.d.ts +19 -0
  341. package/dist/hybrid/postmortem-provider-client.js +34 -0
  342. package/dist/hybrid/postmortem-provider-client.js.map +1 -0
  343. package/dist/hybrid/rollout.d.ts +9 -0
  344. package/dist/hybrid/rollout.js +49 -0
  345. package/dist/hybrid/rollout.js.map +1 -0
  346. package/dist/hybrid/router.d.ts +4 -0
  347. package/dist/hybrid/router.js +62 -0
  348. package/dist/hybrid/router.js.map +1 -0
  349. package/dist/hybrid/types.d.ts +140 -0
  350. package/dist/hybrid/types.js +2 -0
  351. package/dist/hybrid/types.js.map +1 -0
  352. package/dist/hybrid/validators.d.ts +5 -0
  353. package/dist/hybrid/validators.js +94 -0
  354. package/dist/hybrid/validators.js.map +1 -0
  355. package/dist/hybrid/worker-client.d.ts +61 -0
  356. package/dist/hybrid/worker-client.js +196 -0
  357. package/dist/hybrid/worker-client.js.map +1 -0
  358. package/dist/hybrid/workers/explain-decision-llm.d.ts +8 -0
  359. package/dist/hybrid/workers/explain-decision-llm.js +152 -0
  360. package/dist/hybrid/workers/explain-decision-llm.js.map +1 -0
  361. package/dist/hybrid/workers/explain-decision.d.ts +2 -0
  362. package/dist/hybrid/workers/explain-decision.js +40 -0
  363. package/dist/hybrid/workers/explain-decision.js.map +1 -0
  364. package/dist/hybrid/workers/postmortem-review-llm.d.ts +8 -0
  365. package/dist/hybrid/workers/postmortem-review-llm.js +398 -0
  366. package/dist/hybrid/workers/postmortem-review-llm.js.map +1 -0
  367. package/dist/hybrid/workers/postmortem-review.d.ts +2 -0
  368. package/dist/hybrid/workers/postmortem-review.js +66 -0
  369. package/dist/hybrid/workers/postmortem-review.js.map +1 -0
  370. package/dist/index.d.ts +0 -0
  371. package/dist/index.js +0 -0
  372. package/dist/index.js.map +0 -0
  373. package/dist/input/context-summary-adapter.d.ts +0 -0
  374. package/dist/input/context-summary-adapter.js +0 -0
  375. package/dist/input/context-summary-adapter.js.map +0 -0
  376. package/dist/input/input-adapter.d.ts +0 -0
  377. package/dist/input/input-adapter.js +0 -0
  378. package/dist/input/input-adapter.js.map +0 -0
  379. package/dist/input/outcome-resolver.d.ts +0 -0
  380. package/dist/input/outcome-resolver.js +0 -0
  381. package/dist/input/outcome-resolver.js.map +0 -0
  382. package/dist/input/scope-resolver.d.ts +0 -0
  383. package/dist/input/scope-resolver.js +0 -0
  384. package/dist/input/scope-resolver.js.map +0 -0
  385. package/dist/input/tasktype-resolver.d.ts +0 -0
  386. package/dist/input/tasktype-resolver.js +0 -0
  387. package/dist/input/tasktype-resolver.js.map +0 -0
  388. package/dist/input/tool-event-significance.d.ts +0 -0
  389. package/dist/input/tool-event-significance.js +0 -0
  390. package/dist/input/tool-event-significance.js.map +0 -0
  391. package/dist/install/claude-cli.d.ts +0 -0
  392. package/dist/install/claude-cli.js +0 -0
  393. package/dist/install/claude-cli.js.map +0 -0
  394. package/dist/install/claude-code-doctor.d.ts +1 -0
  395. package/dist/install/claude-code-doctor.js +20 -4
  396. package/dist/install/claude-code-doctor.js.map +1 -1
  397. package/dist/install/claude-code-installer.d.ts +0 -0
  398. package/dist/install/claude-code-installer.js +50 -1
  399. package/dist/install/claude-code-installer.js.map +1 -1
  400. package/dist/install/claude-marketplace-state.d.ts +0 -0
  401. package/dist/install/claude-marketplace-state.js +0 -0
  402. package/dist/install/claude-marketplace-state.js.map +0 -0
  403. package/dist/install/claude-runtime-target.d.ts +0 -0
  404. package/dist/install/claude-runtime-target.js +0 -0
  405. package/dist/install/claude-runtime-target.js.map +0 -0
  406. package/dist/install/codex-cli.d.ts +15 -0
  407. package/dist/install/codex-cli.js +55 -3
  408. package/dist/install/codex-cli.js.map +1 -1
  409. package/dist/install/codex-installer.d.ts +0 -0
  410. package/dist/install/codex-installer.js +0 -0
  411. package/dist/install/codex-installer.js.map +0 -0
  412. package/dist/install/codex-runtime-target.d.ts +0 -0
  413. package/dist/install/codex-runtime-target.js +0 -0
  414. package/dist/install/codex-runtime-target.js.map +0 -0
  415. package/dist/install/host-detection.d.ts +0 -0
  416. package/dist/install/host-detection.js +0 -0
  417. package/dist/install/host-detection.js.map +0 -0
  418. package/dist/install/openclaw-cli.d.ts +11 -0
  419. package/dist/install/openclaw-cli.js +0 -0
  420. package/dist/install/openclaw-cli.js.map +1 -1
  421. package/dist/install/openclaw-installer.d.ts +12 -7
  422. package/dist/install/openclaw-installer.js +197 -46
  423. package/dist/install/openclaw-installer.js.map +1 -1
  424. package/dist/install/public-install.d.ts +0 -0
  425. package/dist/install/public-install.js +0 -0
  426. package/dist/install/public-install.js.map +0 -0
  427. package/dist/install/registry-health.d.ts +0 -0
  428. package/dist/install/registry-health.js +0 -0
  429. package/dist/install/registry-health.js.map +0 -0
  430. package/dist/interaction/operational-actions-service.d.ts +0 -0
  431. package/dist/interaction/operational-actions-service.js +0 -0
  432. package/dist/interaction/operational-actions-service.js.map +0 -0
  433. package/dist/interaction/operational-service.d.ts +0 -0
  434. package/dist/interaction/operational-service.js +0 -0
  435. package/dist/interaction/operational-service.js.map +0 -0
  436. package/dist/interaction/repo-summary.d.ts +0 -0
  437. package/dist/interaction/repo-summary.js +0 -0
  438. package/dist/interaction/repo-summary.js.map +0 -0
  439. package/dist/interaction/service.d.ts +15 -0
  440. package/dist/interaction/service.js +174 -20
  441. package/dist/interaction/service.js.map +1 -1
  442. package/dist/interaction/state-artifact-service.d.ts +0 -0
  443. package/dist/interaction/state-artifact-service.js +0 -0
  444. package/dist/interaction/state-artifact-service.js.map +0 -0
  445. package/dist/maintenance/claude-validate-print.d.ts +0 -0
  446. package/dist/maintenance/claude-validate-print.js +0 -0
  447. package/dist/maintenance/claude-validate-print.js.map +0 -0
  448. package/dist/maintenance/embedding-smoke.d.ts +0 -0
  449. package/dist/maintenance/embedding-smoke.js +0 -0
  450. package/dist/maintenance/embedding-smoke.js.map +0 -0
  451. package/dist/maintenance/redistill-rule-nodes.d.ts +0 -0
  452. package/dist/maintenance/redistill-rule-nodes.js +0 -0
  453. package/dist/maintenance/redistill-rule-nodes.js.map +0 -0
  454. package/dist/maintenance/scope-merge.d.ts +0 -0
  455. package/dist/maintenance/scope-merge.js +0 -0
  456. package/dist/maintenance/scope-merge.js.map +0 -0
  457. package/dist/maintenance/warning-variant-cleanup.d.ts +0 -0
  458. package/dist/maintenance/warning-variant-cleanup.js +0 -0
  459. package/dist/maintenance/warning-variant-cleanup.js.map +0 -0
  460. package/dist/plugin/fixture-sanitizer.d.ts +0 -0
  461. package/dist/plugin/fixture-sanitizer.js +0 -0
  462. package/dist/plugin/fixture-sanitizer.js.map +0 -0
  463. package/dist/plugin/hooks/before-prompt-build.d.ts +1 -0
  464. package/dist/plugin/hooks/before-prompt-build.js +4 -1
  465. package/dist/plugin/hooks/before-prompt-build.js.map +1 -1
  466. package/dist/plugin/hooks/message-sent.d.ts +0 -0
  467. package/dist/plugin/hooks/message-sent.js +0 -0
  468. package/dist/plugin/hooks/message-sent.js.map +0 -0
  469. package/dist/plugin/hooks/tool-result-persist.d.ts +0 -0
  470. package/dist/plugin/hooks/tool-result-persist.js +0 -0
  471. package/dist/plugin/hooks/tool-result-persist.js.map +0 -0
  472. package/dist/plugin/openclaw-install-state.d.ts +39 -0
  473. package/dist/plugin/openclaw-install-state.js +24 -0
  474. package/dist/plugin/openclaw-install-state.js.map +1 -0
  475. package/dist/plugin/openclaw-plugin.d.ts +125 -0
  476. package/dist/plugin/openclaw-plugin.js +18 -7
  477. package/dist/plugin/openclaw-plugin.js.map +1 -1
  478. package/dist/plugin/openclaw-routine-interaction.d.ts +2 -1
  479. package/dist/plugin/openclaw-routine-interaction.js +12 -7
  480. package/dist/plugin/openclaw-routine-interaction.js.map +1 -1
  481. package/dist/plugin/openclaw-runtime-defaults.d.ts +16 -0
  482. package/dist/plugin/openclaw-runtime-defaults.js +16 -0
  483. package/dist/plugin/openclaw-runtime-defaults.js.map +1 -0
  484. package/dist/plugin/runtime-capture.d.ts +0 -0
  485. package/dist/plugin/runtime-capture.js +0 -0
  486. package/dist/plugin/runtime-capture.js.map +0 -0
  487. package/dist/plugin/runtime-helpers.d.ts +0 -0
  488. package/dist/plugin/runtime-helpers.js +0 -0
  489. package/dist/plugin/runtime-helpers.js.map +0 -0
  490. package/dist/runtime/service.d.ts +33 -5
  491. package/dist/runtime/service.js +408 -22
  492. package/dist/runtime/service.js.map +1 -1
  493. package/dist/store/logs/jsonl-logger.d.ts +0 -0
  494. package/dist/store/logs/jsonl-logger.js +0 -0
  495. package/dist/store/logs/jsonl-logger.js.map +0 -0
  496. package/dist/store/sqlite/db.d.ts +0 -0
  497. package/dist/store/sqlite/db.js +28 -0
  498. package/dist/store/sqlite/db.js.map +1 -1
  499. package/dist/store/sqlite/migrations.d.ts +0 -0
  500. package/dist/store/sqlite/migrations.js +0 -0
  501. package/dist/store/sqlite/migrations.js.map +0 -0
  502. package/dist/store/sqlite/repositories/candidate-repo.d.ts +0 -0
  503. package/dist/store/sqlite/repositories/candidate-repo.js +0 -0
  504. package/dist/store/sqlite/repositories/candidate-repo.js.map +0 -0
  505. package/dist/store/sqlite/repositories/distillation-job-repo.d.ts +0 -0
  506. package/dist/store/sqlite/repositories/distillation-job-repo.js +0 -0
  507. package/dist/store/sqlite/repositories/distillation-job-repo.js.map +0 -0
  508. package/dist/store/sqlite/repositories/hybrid-invocation-trace-repo.d.ts +11 -0
  509. package/dist/store/sqlite/repositories/hybrid-invocation-trace-repo.js +76 -0
  510. package/dist/store/sqlite/repositories/hybrid-invocation-trace-repo.js.map +1 -0
  511. package/dist/store/sqlite/repositories/hybrid-review-artifact-repo.d.ts +11 -0
  512. package/dist/store/sqlite/repositories/hybrid-review-artifact-repo.js +73 -0
  513. package/dist/store/sqlite/repositories/hybrid-review-artifact-repo.js.map +1 -0
  514. package/dist/store/sqlite/repositories/injection-repo.d.ts +0 -0
  515. package/dist/store/sqlite/repositories/injection-repo.js +0 -0
  516. package/dist/store/sqlite/repositories/injection-repo.js.map +0 -0
  517. package/dist/store/sqlite/repositories/input-record-repo.d.ts +1 -0
  518. package/dist/store/sqlite/repositories/input-record-repo.js +13 -0
  519. package/dist/store/sqlite/repositories/input-record-repo.js.map +1 -1
  520. package/dist/store/sqlite/repositories/node-repo.d.ts +3 -0
  521. package/dist/store/sqlite/repositories/node-repo.js +45 -6
  522. package/dist/store/sqlite/repositories/node-repo.js.map +1 -1
  523. package/dist/store/sqlite/repositories/outcome-record-repo.d.ts +0 -0
  524. package/dist/store/sqlite/repositories/outcome-record-repo.js +0 -0
  525. package/dist/store/sqlite/repositories/outcome-record-repo.js.map +0 -0
  526. package/dist/store/sqlite/repositories/review-event-repo.d.ts +0 -0
  527. package/dist/store/sqlite/repositories/review-event-repo.js +0 -0
  528. package/dist/store/sqlite/repositories/review-event-repo.js.map +0 -0
  529. package/dist/store/sqlite/repositories/scope-repo.d.ts +0 -0
  530. package/dist/store/sqlite/repositories/scope-repo.js +0 -0
  531. package/dist/store/sqlite/repositories/scope-repo.js.map +0 -0
  532. package/dist/store/sqlite/repositories/stats-repo.d.ts +0 -0
  533. package/dist/store/sqlite/repositories/stats-repo.js +0 -0
  534. package/dist/store/sqlite/repositories/stats-repo.js.map +0 -0
  535. package/dist/store/sqlite/repositories/task-run-repo.d.ts +0 -0
  536. package/dist/store/sqlite/repositories/task-run-repo.js +0 -0
  537. package/dist/store/sqlite/repositories/task-run-repo.js.map +0 -0
  538. package/dist/store/sqlite/schema.sql +40 -0
  539. package/dist/store/vector/api-embedding-provider.d.ts +0 -0
  540. package/dist/store/vector/api-embedding-provider.js +0 -0
  541. package/dist/store/vector/api-embedding-provider.js.map +0 -0
  542. package/dist/store/vector/embeddings.d.ts +0 -0
  543. package/dist/store/vector/embeddings.js +26 -8
  544. package/dist/store/vector/embeddings.js.map +1 -1
  545. package/dist/store/vector/lancedb.d.ts +0 -0
  546. package/dist/store/vector/lancedb.js +0 -0
  547. package/dist/store/vector/lancedb.js.map +0 -0
  548. package/dist/store/vector/local-provider.d.ts +0 -0
  549. package/dist/store/vector/local-provider.js +0 -0
  550. package/dist/store/vector/local-provider.js.map +0 -0
  551. package/dist/store/vector/node-index.d.ts +0 -0
  552. package/dist/store/vector/node-index.js +0 -0
  553. package/dist/store/vector/node-index.js.map +0 -0
  554. package/dist/store/vector/provider-types.d.ts +0 -0
  555. package/dist/store/vector/provider-types.js +0 -0
  556. package/dist/store/vector/provider-types.js.map +0 -0
  557. package/dist/types/analyzer.d.ts +0 -0
  558. package/dist/types/analyzer.js +0 -0
  559. package/dist/types/analyzer.js.map +0 -0
  560. package/dist/types/domain.d.ts +136 -1
  561. package/dist/types/domain.js +0 -0
  562. package/dist/types/domain.js.map +0 -0
  563. package/dist/types/plugin.d.ts +2 -1
  564. package/dist/types/plugin.js +0 -0
  565. package/dist/types/plugin.js.map +0 -0
  566. package/dist/types/storage.d.ts +0 -0
  567. package/dist/types/storage.js +0 -0
  568. package/dist/types/storage.js.map +0 -0
  569. package/dist/utils/clock.d.ts +0 -0
  570. package/dist/utils/clock.js +0 -0
  571. package/dist/utils/clock.js.map +0 -0
  572. package/dist/utils/errors.d.ts +0 -0
  573. package/dist/utils/errors.js +0 -0
  574. package/dist/utils/errors.js.map +0 -0
  575. package/dist/utils/hashing.d.ts +0 -0
  576. package/dist/utils/hashing.js +0 -0
  577. package/dist/utils/hashing.js.map +0 -0
  578. package/dist/utils/ids.d.ts +0 -0
  579. package/dist/utils/ids.js +0 -0
  580. package/dist/utils/ids.js.map +0 -0
  581. package/dist/utils/text.d.ts +0 -0
  582. package/dist/utils/text.js +0 -0
  583. package/dist/utils/text.js.map +0 -0
  584. package/dist/version/package-version.d.ts +0 -0
  585. package/dist/version/package-version.js +0 -0
  586. package/dist/version/package-version.js.map +0 -0
  587. package/dist/version/remote-release.d.ts +0 -0
  588. package/dist/version/remote-release.js +0 -0
  589. package/dist/version/remote-release.js.map +0 -0
  590. package/docs/releases/v0.1.0.md +0 -0
  591. package/docs/releases/v0.1.1.md +0 -0
  592. package/docs/releases/v0.1.2.md +0 -0
  593. package/docs/releases/v0.1.3.md +3 -2
  594. package/docs/releases/v0.2.0.md +85 -0
  595. package/docs/user-guide.md +39 -12
  596. package/hooks/hooks.json +0 -0
  597. package/openclaw.plugin.json +81 -1
  598. package/package.json +23 -15
  599. package/plugins/claude-code-experienceengine/.claude-plugin/plugin.json +1 -1
  600. package/plugins/claude-code-experienceengine/.mcp.json +0 -0
  601. package/plugins/claude-code-experienceengine/hooks/hooks.json +0 -0
  602. package/plugins/claude-code-experienceengine/scripts/claude-hook.sh +0 -0
  603. package/plugins/claude-code-experienceengine/scripts/install-deps.sh +1 -1
  604. package/scripts/claude-plugin/claude-hook.sh +0 -0
  605. package/scripts/claude-plugin/install-deps.sh +0 -0
@@ -0,0 +1,62 @@
1
+ const DEFAULT_POLICY = {
2
+ enabled: true,
3
+ syncExplainEnabled: true,
4
+ asyncPostmortemEnabled: true,
5
+ policyVersion: "hybrid-phase1-v1"
6
+ };
7
+ export const deriveAsyncPostmortemEligibility = (signals) => {
8
+ if (signals.taskStage !== "posttask") {
9
+ return false;
10
+ }
11
+ if (!signals.completedRun || !signals.terminalOutcomeRecorded) {
12
+ return false;
13
+ }
14
+ if (!signals.boundedPosttaskCapsuleAvailable || !signals.rolloutAllowsAsyncPostmortem) {
15
+ return false;
16
+ }
17
+ if (signals.postmortemAlreadyRecorded || signals.lightweightOrExcludedTask) {
18
+ return false;
19
+ }
20
+ return (signals.directionalCorrectionPresent
21
+ || signals.injectedNodeInteractionPresent
22
+ || signals.retryOrInvalidationSignaturePresent
23
+ || signals.meaningfulFailureSignaturePresent
24
+ || signals.conservativeTransitionReviewWorthy);
25
+ };
26
+ export const selectHybridRoute = (signals, policy = {}) => {
27
+ const effectivePolicy = { ...DEFAULT_POLICY, ...policy };
28
+ if (!effectivePolicy.enabled) {
29
+ return {
30
+ route: "FAST_PATH",
31
+ reasonCode: "default_fast_path",
32
+ policyVersion: effectivePolicy.policyVersion
33
+ };
34
+ }
35
+ if (signals.explicitExplanationRequest && effectivePolicy.syncExplainEnabled) {
36
+ return {
37
+ route: "ESCALATE_SYNC_EXPLAIN",
38
+ reasonCode: "explicit_explanation_request",
39
+ policyVersion: effectivePolicy.policyVersion
40
+ };
41
+ }
42
+ if (signals.existingConservativePathRequired) {
43
+ return {
44
+ route: "FAST_PATH_CONSERVATIVE",
45
+ reasonCode: "existing_conservative_path_required",
46
+ policyVersion: effectivePolicy.policyVersion
47
+ };
48
+ }
49
+ if (effectivePolicy.asyncPostmortemEnabled && deriveAsyncPostmortemEligibility(signals)) {
50
+ return {
51
+ route: "ESCALATE_ASYNC_POSTMORTEM",
52
+ reasonCode: "eligible_async_postmortem_review",
53
+ policyVersion: effectivePolicy.policyVersion
54
+ };
55
+ }
56
+ return {
57
+ route: "FAST_PATH",
58
+ reasonCode: "default_fast_path",
59
+ policyVersion: effectivePolicy.policyVersion
60
+ };
61
+ };
62
+ //# sourceMappingURL=router.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/hybrid/router.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAsB;IACxC,OAAO,EAAE,IAAI;IACb,kBAAkB,EAAE,IAAI;IACxB,sBAAsB,EAAE,IAAI;IAC5B,aAAa,EAAE,kBAAkB;CAClC,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,OAA2B,EAAW,EAAE;IACvF,IAAI,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,+BAA+B,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC;QACtF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,yBAAyB,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,OAAO,CAAC,4BAA4B;WACjC,OAAO,CAAC,8BAA8B;WACtC,OAAO,CAAC,mCAAmC;WAC3C,OAAO,CAAC,iCAAiC;WACzC,OAAO,CAAC,kCAAkC,CAC9C,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,OAA2B,EAC3B,SAAqC,EAAE,EAClB,EAAE;IACvB,MAAM,eAAe,GAAsB,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAE5E,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,UAAU,EAAE,mBAAmB;YAC/B,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,0BAA0B,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC;QAC7E,OAAO;YACL,KAAK,EAAE,uBAAuB;YAC9B,UAAU,EAAE,8BAA8B;YAC1C,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,gCAAgC,EAAE,CAAC;QAC7C,OAAO;YACL,KAAK,EAAE,wBAAwB;YAC/B,UAAU,EAAE,qCAAqC;YACjD,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,CAAC,sBAAsB,IAAI,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC;QACxF,OAAO;YACL,KAAK,EAAE,2BAA2B;YAClC,UAAU,EAAE,kCAAkC;YAC9C,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,mBAAmB;QAC/B,aAAa,EAAE,eAAe,CAAC,aAAa;KAC7C,CAAC;AACJ,CAAC,CAAC"}
@@ -0,0 +1,140 @@
1
+ import type { DeliveryState, ExperienceNodeType, ExperienceState, FeedbackVerdict, TaskType } from "../types/domain.js";
2
+ export type HybridRoute = "FAST_PATH" | "FAST_PATH_CONSERVATIVE" | "ESCALATE_SYNC_EXPLAIN" | "ESCALATE_ASYNC_POSTMORTEM";
3
+ export type HybridRolloutMode = "live" | "shadow" | "canary";
4
+ export type HybridTaskStage = "prompt" | "posttask";
5
+ export type HybridRouteSignals = {
6
+ taskStage: HybridTaskStage;
7
+ explicitExplanationRequest: boolean;
8
+ existingConservativePathRequired: boolean;
9
+ completedRun: boolean;
10
+ terminalOutcomeRecorded: boolean;
11
+ boundedPosttaskCapsuleAvailable: boolean;
12
+ postmortemAlreadyRecorded: boolean;
13
+ lightweightOrExcludedTask: boolean;
14
+ directionalCorrectionPresent: boolean;
15
+ injectedNodeInteractionPresent: boolean;
16
+ retryOrInvalidationSignaturePresent: boolean;
17
+ meaningfulFailureSignaturePresent: boolean;
18
+ conservativeTransitionReviewWorthy: boolean;
19
+ rolloutAllowsAsyncPostmortem: boolean;
20
+ };
21
+ export type HybridRouteDecision = {
22
+ route: HybridRoute;
23
+ reasonCode: "default_fast_path" | "existing_conservative_path_required" | "explicit_explanation_request" | "eligible_async_postmortem_review";
24
+ policyVersion: string;
25
+ };
26
+ export type HybridRoutePolicy = {
27
+ enabled: boolean;
28
+ syncExplainEnabled: boolean;
29
+ asyncPostmortemEnabled: boolean;
30
+ policyVersion: string;
31
+ };
32
+ export type HybridCapsuleEvidenceSource = "task_summary" | "context_summary" | "decision_explanation" | "retrieval_note" | "timeline" | "tool_event";
33
+ export type HybridCapsuleEvidence = {
34
+ source: HybridCapsuleEvidenceSource;
35
+ text: string;
36
+ trust: "untrusted_evidence";
37
+ truncated: boolean;
38
+ };
39
+ export type ExplainDecisionCapsule = {
40
+ task: "explain_decision";
41
+ schemaVersion: string;
42
+ trusted: {
43
+ route: HybridRouteDecision;
44
+ inspection: {
45
+ scopeId: string;
46
+ taskType: string;
47
+ intervention: "inject" | "skip" | "shadow" | "holdout";
48
+ deliveryMode?: string;
49
+ autoFeedback: "helped" | "harmed" | "none";
50
+ outcome: "success" | "failure" | "unknown";
51
+ learningStatus?: "captured" | "rejected" | "not_applicable";
52
+ };
53
+ scorecard?: {
54
+ mode?: "inject" | "inject_conservative" | "skip";
55
+ decisionReason?: string;
56
+ riskLevel?: "low" | "medium" | "high";
57
+ confidence?: "low" | "medium" | "high";
58
+ budgetClass?: "none" | "single_hint" | "multi_hint";
59
+ fastPathApplied?: boolean;
60
+ queryRewriteApplied?: boolean;
61
+ };
62
+ };
63
+ evidence: HybridCapsuleEvidence[];
64
+ };
65
+ export type PostmortemReviewCapsule = {
66
+ task: "postmortem_review";
67
+ schemaVersion: string;
68
+ trusted: {
69
+ route: HybridRouteDecision;
70
+ run: {
71
+ taskRunId: string;
72
+ scopeId: string;
73
+ taskType: string;
74
+ finalStatus: "success" | "failure" | "cancelled" | "unknown";
75
+ learningStatus?: "captured" | "rejected" | "not_applicable";
76
+ outcomeSignal: "success" | "failure" | "unknown";
77
+ };
78
+ injectedNodes?: Array<{
79
+ nodeId: string;
80
+ nodeType: ExperienceNodeType;
81
+ state: ExperienceState;
82
+ deliveryState: DeliveryState;
83
+ taskType: TaskType;
84
+ helpedCount: number;
85
+ harmedCount: number;
86
+ compactHint: string;
87
+ }>;
88
+ reviewTriggers: {
89
+ directionalCorrectionPresent: boolean;
90
+ injectedNodeInteractionPresent: boolean;
91
+ retryOrInvalidationSignaturePresent: boolean;
92
+ meaningfulFailureSignaturePresent: boolean;
93
+ conservativeTransitionReviewWorthy: boolean;
94
+ };
95
+ };
96
+ evidence: HybridCapsuleEvidence[];
97
+ };
98
+ export type HybridApprovalClass = "advisory" | "review_artifact" | "policy_gated" | "blocked";
99
+ export type ExplainDecisionWorkerOutput = {
100
+ task: "explain_decision";
101
+ decision: string;
102
+ reason: string;
103
+ confidence: "high" | "medium" | "low";
104
+ evidence_summary?: string;
105
+ };
106
+ export type PostmortemReviewWorkerOutput = {
107
+ task: "postmortem_review";
108
+ review_verdict: "review_artifact" | "policy_gated";
109
+ candidate_recommendation: "capture" | "reject" | "observe";
110
+ feedback_followup_recommendation: "none" | "mark_helped" | "mark_harmed" | "review";
111
+ confidence: "high" | "medium" | "low";
112
+ reason: string;
113
+ injected_node_reviews?: Array<{
114
+ node_id: string;
115
+ feedback_verdict: FeedbackVerdict;
116
+ confidence: "high" | "medium" | "low";
117
+ delivery_recommendation: "keep" | "conservative_only" | "quarantine" | "review";
118
+ reason: string;
119
+ evidence_summary?: string;
120
+ }>;
121
+ review_artifact?: {
122
+ summary: string;
123
+ notes: string[];
124
+ };
125
+ suggestedFollowUps?: string[];
126
+ candidateShapingSuggestions?: string[];
127
+ governanceRecommendations?: string[];
128
+ lifecycleSuggestions?: string[];
129
+ writeBackSuggestions?: string[];
130
+ };
131
+ export type HybridValidationSuccess<T> = {
132
+ status: "accepted";
133
+ approvalClass: HybridApprovalClass;
134
+ value: T;
135
+ };
136
+ export type HybridValidationFailure = {
137
+ status: "rejected";
138
+ reason: "schema_invalid" | "missing_required_fields" | "trust_boundary_violation" | "policy_violation" | "approval_blocked";
139
+ detail: string;
140
+ };
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hybrid/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,5 @@
1
+ import type { ExplainDecisionWorkerOutput, HybridApprovalClass, HybridValidationFailure, HybridValidationSuccess, PostmortemReviewWorkerOutput } from "./types.js";
2
+ export declare const parsePostmortemReviewOutput: (value: unknown) => PostmortemReviewWorkerOutput | HybridValidationFailure;
3
+ export declare const classifyHybridApproval: (value: ExplainDecisionWorkerOutput | PostmortemReviewWorkerOutput) => HybridApprovalClass;
4
+ export declare const validateExplainDecisionOutput: (value: unknown) => HybridValidationSuccess<ExplainDecisionWorkerOutput> | HybridValidationFailure;
5
+ export declare const validatePostmortemReviewOutput: (value: unknown) => HybridValidationSuccess<PostmortemReviewWorkerOutput> | HybridValidationFailure;
@@ -0,0 +1,94 @@
1
+ import { z } from "zod";
2
+ const explainDecisionOutputSchema = z.object({
3
+ task: z.literal("explain_decision"),
4
+ decision: z.string().min(1),
5
+ reason: z.string().min(1),
6
+ confidence: z.enum(["high", "medium", "low"]),
7
+ evidence_summary: z.string().min(1).optional()
8
+ });
9
+ const postmortemReviewOutputSchema = z.object({
10
+ task: z.literal("postmortem_review"),
11
+ review_verdict: z.enum(["review_artifact", "policy_gated"]),
12
+ candidate_recommendation: z.enum(["capture", "reject", "observe"]),
13
+ feedback_followup_recommendation: z.enum(["none", "mark_helped", "mark_harmed", "review"]),
14
+ confidence: z.enum(["high", "medium", "low"]),
15
+ reason: z.string().min(1),
16
+ injected_node_reviews: z
17
+ .array(z.object({
18
+ node_id: z.string().min(1),
19
+ feedback_verdict: z.enum(["helped", "harmed", "uncertain"]),
20
+ confidence: z.enum(["high", "medium", "low"]),
21
+ delivery_recommendation: z.enum(["keep", "conservative_only", "quarantine", "review"]),
22
+ reason: z.string().min(1),
23
+ evidence_summary: z.string().min(1).optional()
24
+ }))
25
+ .optional(),
26
+ review_artifact: z
27
+ .object({
28
+ summary: z.string().min(1),
29
+ notes: z.array(z.string().min(1)).min(1)
30
+ })
31
+ .optional(),
32
+ suggestedFollowUps: z.array(z.string()).optional(),
33
+ candidateShapingSuggestions: z.array(z.string()).optional(),
34
+ governanceRecommendations: z.array(z.string()).optional(),
35
+ lifecycleSuggestions: z.array(z.string()).optional(),
36
+ writeBackSuggestions: z.array(z.string()).optional()
37
+ });
38
+ export const parsePostmortemReviewOutput = (value) => {
39
+ const parsed = postmortemReviewOutputSchema.safeParse(value);
40
+ if (!parsed.success) {
41
+ return rejected("schema_invalid", parsed.error.issues.map((issue) => issue.message).join("; "));
42
+ }
43
+ return parsed.data;
44
+ };
45
+ const isValidationFailure = (value) => "status" in value;
46
+ export const classifyHybridApproval = (value) => {
47
+ if (value.task === "explain_decision") {
48
+ return "advisory";
49
+ }
50
+ if ((value.lifecycleSuggestions?.length ?? 0) > 0 || (value.writeBackSuggestions?.length ?? 0) > 0) {
51
+ return "blocked";
52
+ }
53
+ if (value.review_verdict === "policy_gated"
54
+ || value.feedback_followup_recommendation !== "none"
55
+ || (value.injected_node_reviews?.length ?? 0) > 0
56
+ || (value.candidateShapingSuggestions?.length ?? 0) > 0
57
+ || (value.suggestedFollowUps?.length ?? 0) > 0
58
+ || (value.governanceRecommendations?.length ?? 0) > 0) {
59
+ return "policy_gated";
60
+ }
61
+ return "review_artifact";
62
+ };
63
+ const rejected = (reason, detail) => ({
64
+ status: "rejected",
65
+ reason,
66
+ detail
67
+ });
68
+ export const validateExplainDecisionOutput = (value) => {
69
+ const parsed = explainDecisionOutputSchema.safeParse(value);
70
+ if (!parsed.success) {
71
+ return rejected("schema_invalid", parsed.error.issues.map((issue) => issue.message).join("; "));
72
+ }
73
+ return {
74
+ status: "accepted",
75
+ approvalClass: "advisory",
76
+ value: parsed.data
77
+ };
78
+ };
79
+ export const validatePostmortemReviewOutput = (value) => {
80
+ const parsed = parsePostmortemReviewOutput(value);
81
+ if (isValidationFailure(parsed)) {
82
+ return parsed;
83
+ }
84
+ const approvalClass = classifyHybridApproval(parsed);
85
+ if (approvalClass === "blocked") {
86
+ return rejected("approval_blocked", "Phase 1 blocks lifecycle changes and write-back suggestions from worker outputs.");
87
+ }
88
+ return {
89
+ status: "accepted",
90
+ approvalClass,
91
+ value: parsed
92
+ };
93
+ };
94
+ //# sourceMappingURL=validators.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/hybrid/validators.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,61 @@
1
+ import type { ExplainDecisionCapsule, ExplainDecisionWorkerOutput, HybridValidationFailure, HybridValidationSuccess, PostmortemReviewCapsule, PostmortemReviewWorkerOutput } from "./types.js";
2
+ import type { DistillerEndpoint } from "../distillation/providers/types.js";
3
+ export type HybridExplainFallback = {
4
+ status: "fallback";
5
+ reason: "disabled" | "timeout" | "circuit_open" | "provider_unavailable";
6
+ } | {
7
+ status: "fallback";
8
+ reason: "validation_failed";
9
+ validation: HybridValidationFailure;
10
+ };
11
+ export type HybridExplainResult = HybridValidationSuccess<ExplainDecisionWorkerOutput> | HybridExplainFallback;
12
+ export type HybridPostmortemFallback = {
13
+ status: "fallback";
14
+ reason: "disabled" | "timeout" | "circuit_open" | "provider_unavailable";
15
+ } | {
16
+ status: "fallback";
17
+ reason: "validation_failed";
18
+ validation: HybridValidationFailure;
19
+ };
20
+ export type HybridPostmortemResult = HybridValidationSuccess<PostmortemReviewWorkerOutput> | HybridPostmortemFallback;
21
+ export type HybridWorkerClientOptions = {
22
+ explainDecisionEnabled?: boolean;
23
+ explainDecisionTimeoutMs?: number;
24
+ explainDecisionProviderTimeoutMs?: number;
25
+ explainDecisionExecutor?: (capsule: ExplainDecisionCapsule) => Promise<ExplainDecisionWorkerOutput> | ExplainDecisionWorkerOutput;
26
+ explainDecisionLlmEnabled?: boolean;
27
+ explainDecisionLlmExecutor?: (capsule: ExplainDecisionCapsule, endpoint: DistillerEndpoint) => Promise<ExplainDecisionWorkerOutput> | ExplainDecisionWorkerOutput;
28
+ postmortemReviewEnabled?: boolean;
29
+ postmortemReviewTimeoutMs?: number;
30
+ postmortemReviewProviderTimeoutMs?: number;
31
+ postmortemReviewExecutor?: (capsule: PostmortemReviewCapsule) => Promise<PostmortemReviewWorkerOutput> | PostmortemReviewWorkerOutput;
32
+ postmortemReviewLlmEnabled?: boolean;
33
+ postmortemReviewLlmExecutor?: (capsule: PostmortemReviewCapsule, endpoint: DistillerEndpoint) => Promise<PostmortemReviewWorkerOutput> | PostmortemReviewWorkerOutput;
34
+ timeoutCircuitThreshold?: number;
35
+ };
36
+ export declare class HybridWorkerClient {
37
+ private readonly explainDecisionEnabled;
38
+ private readonly explainDecisionTimeoutMs;
39
+ private readonly explainDecisionProviderTimeoutMs;
40
+ private readonly explainDecisionExecutor;
41
+ private readonly explainDecisionLlmEnabled;
42
+ private readonly explainDecisionLlmExecutor;
43
+ private readonly postmortemReviewEnabled;
44
+ private readonly postmortemReviewTimeoutMs;
45
+ private readonly postmortemReviewProviderTimeoutMs;
46
+ private readonly postmortemReviewExecutor;
47
+ private readonly postmortemReviewLlmEnabled;
48
+ private readonly postmortemReviewLlmExecutor;
49
+ private readonly timeoutCircuitThreshold;
50
+ private explainTimeoutStreak;
51
+ private postmortemTimeoutStreak;
52
+ constructor(options?: HybridWorkerClientOptions);
53
+ runExplainDecision(capsule: ExplainDecisionCapsule, options?: {
54
+ mode?: "deterministic" | "provider";
55
+ endpoint?: DistillerEndpoint;
56
+ }): Promise<HybridExplainResult>;
57
+ runPostmortemReview(capsule: PostmortemReviewCapsule, options?: {
58
+ mode?: "deterministic" | "provider";
59
+ endpoint?: DistillerEndpoint;
60
+ }): Promise<HybridPostmortemResult>;
61
+ }
@@ -0,0 +1,196 @@
1
+ import { validateExplainDecisionOutput, validatePostmortemReviewOutput } from "./validators.js";
2
+ import { runExplainDecisionWorker } from "./workers/explain-decision.js";
3
+ import { runExplainDecisionLlmWorker } from "./workers/explain-decision-llm.js";
4
+ import { runPostmortemReviewWorker } from "./workers/postmortem-review.js";
5
+ import { runPostmortemReviewLlmWorker } from "./workers/postmortem-review-llm.js";
6
+ const DEFAULT_TIMEOUT_MS = 150;
7
+ const DEFAULT_PROVIDER_TIMEOUT_MS = 5000;
8
+ const DEFAULT_POSTMORTEM_PROVIDER_TIMEOUT_MS = 15000;
9
+ const DEFAULT_CIRCUIT_THRESHOLD = 3;
10
+ export class HybridWorkerClient {
11
+ explainDecisionEnabled;
12
+ explainDecisionTimeoutMs;
13
+ explainDecisionProviderTimeoutMs;
14
+ explainDecisionExecutor;
15
+ explainDecisionLlmEnabled;
16
+ explainDecisionLlmExecutor;
17
+ postmortemReviewEnabled;
18
+ postmortemReviewTimeoutMs;
19
+ postmortemReviewProviderTimeoutMs;
20
+ postmortemReviewExecutor;
21
+ postmortemReviewLlmEnabled;
22
+ postmortemReviewLlmExecutor;
23
+ timeoutCircuitThreshold;
24
+ explainTimeoutStreak = 0;
25
+ postmortemTimeoutStreak = 0;
26
+ constructor(options = {}) {
27
+ this.explainDecisionEnabled = options.explainDecisionEnabled ?? true;
28
+ this.explainDecisionTimeoutMs = options.explainDecisionTimeoutMs ?? DEFAULT_TIMEOUT_MS;
29
+ this.explainDecisionProviderTimeoutMs =
30
+ options.explainDecisionProviderTimeoutMs ?? DEFAULT_PROVIDER_TIMEOUT_MS;
31
+ this.explainDecisionExecutor = options.explainDecisionExecutor ?? runExplainDecisionWorker;
32
+ this.explainDecisionLlmEnabled = options.explainDecisionLlmEnabled ?? false;
33
+ this.explainDecisionLlmExecutor =
34
+ options.explainDecisionLlmExecutor
35
+ ?? ((capsule, endpoint) => runExplainDecisionLlmWorker(capsule, { endpoint }));
36
+ this.postmortemReviewEnabled = options.postmortemReviewEnabled ?? true;
37
+ this.postmortemReviewTimeoutMs = options.postmortemReviewTimeoutMs ?? DEFAULT_TIMEOUT_MS;
38
+ this.postmortemReviewProviderTimeoutMs =
39
+ options.postmortemReviewProviderTimeoutMs ?? DEFAULT_POSTMORTEM_PROVIDER_TIMEOUT_MS;
40
+ this.postmortemReviewExecutor = options.postmortemReviewExecutor ?? runPostmortemReviewWorker;
41
+ this.postmortemReviewLlmEnabled = options.postmortemReviewLlmEnabled ?? false;
42
+ this.postmortemReviewLlmExecutor =
43
+ options.postmortemReviewLlmExecutor
44
+ ?? ((capsule, endpoint) => runPostmortemReviewLlmWorker(capsule, { endpoint }));
45
+ this.timeoutCircuitThreshold = options.timeoutCircuitThreshold ?? DEFAULT_CIRCUIT_THRESHOLD;
46
+ }
47
+ async runExplainDecision(capsule, options = {}) {
48
+ if (!this.explainDecisionEnabled) {
49
+ return {
50
+ status: "fallback",
51
+ reason: "disabled"
52
+ };
53
+ }
54
+ if (this.explainTimeoutStreak >= this.timeoutCircuitThreshold) {
55
+ return {
56
+ status: "fallback",
57
+ reason: "circuit_open"
58
+ };
59
+ }
60
+ let timer;
61
+ try {
62
+ const timeoutMs = options.mode === "provider" ? this.explainDecisionProviderTimeoutMs : this.explainDecisionTimeoutMs;
63
+ const run = options.mode === "provider"
64
+ ? () => {
65
+ if (!this.explainDecisionLlmEnabled || !options.endpoint) {
66
+ throw new Error("provider_disabled");
67
+ }
68
+ return this.explainDecisionLlmExecutor(capsule, options.endpoint);
69
+ }
70
+ : () => this.explainDecisionExecutor(capsule);
71
+ const result = await Promise.race([
72
+ Promise.resolve(run()),
73
+ new Promise((_, reject) => {
74
+ timer = setTimeout(() => reject(new Error("timeout")), timeoutMs);
75
+ })
76
+ ]);
77
+ const validated = validateExplainDecisionOutput(result);
78
+ if (validated.status === "rejected") {
79
+ this.explainTimeoutStreak = 0;
80
+ return {
81
+ status: "fallback",
82
+ reason: "validation_failed",
83
+ validation: validated
84
+ };
85
+ }
86
+ this.explainTimeoutStreak = 0;
87
+ return validated;
88
+ }
89
+ catch (error) {
90
+ if (error instanceof Error && error.message === "provider_disabled") {
91
+ this.explainTimeoutStreak = 0;
92
+ return {
93
+ status: "fallback",
94
+ reason: "disabled"
95
+ };
96
+ }
97
+ if (error instanceof Error && error.message === "timeout") {
98
+ this.explainTimeoutStreak += 1;
99
+ return {
100
+ status: "fallback",
101
+ reason: "timeout"
102
+ };
103
+ }
104
+ this.explainTimeoutStreak = 0;
105
+ return {
106
+ status: "fallback",
107
+ reason: "validation_failed",
108
+ validation: {
109
+ status: "rejected",
110
+ reason: "policy_violation",
111
+ detail: error instanceof Error ? error.message : String(error)
112
+ }
113
+ };
114
+ }
115
+ finally {
116
+ if (timer) {
117
+ clearTimeout(timer);
118
+ }
119
+ }
120
+ }
121
+ async runPostmortemReview(capsule, options = {}) {
122
+ if (!this.postmortemReviewEnabled) {
123
+ return {
124
+ status: "fallback",
125
+ reason: "disabled"
126
+ };
127
+ }
128
+ if (this.postmortemTimeoutStreak >= this.timeoutCircuitThreshold) {
129
+ return {
130
+ status: "fallback",
131
+ reason: "circuit_open"
132
+ };
133
+ }
134
+ let timer;
135
+ try {
136
+ const timeoutMs = options.mode === "provider" ? this.postmortemReviewProviderTimeoutMs : this.postmortemReviewTimeoutMs;
137
+ const run = options.mode === "provider"
138
+ ? () => {
139
+ if (!this.postmortemReviewLlmEnabled || !options.endpoint) {
140
+ throw new Error("provider_disabled");
141
+ }
142
+ return this.postmortemReviewLlmExecutor(capsule, options.endpoint);
143
+ }
144
+ : () => this.postmortemReviewExecutor(capsule);
145
+ const result = await Promise.race([
146
+ Promise.resolve(run()),
147
+ new Promise((_, reject) => {
148
+ timer = setTimeout(() => reject(new Error("timeout")), timeoutMs);
149
+ })
150
+ ]);
151
+ const validated = validatePostmortemReviewOutput(result);
152
+ if (validated.status === "rejected") {
153
+ this.postmortemTimeoutStreak = 0;
154
+ return {
155
+ status: "fallback",
156
+ reason: "validation_failed",
157
+ validation: validated
158
+ };
159
+ }
160
+ this.postmortemTimeoutStreak = 0;
161
+ return validated;
162
+ }
163
+ catch (error) {
164
+ if (error instanceof Error && error.message === "provider_disabled") {
165
+ this.postmortemTimeoutStreak = 0;
166
+ return {
167
+ status: "fallback",
168
+ reason: "provider_unavailable"
169
+ };
170
+ }
171
+ if (error instanceof Error && error.message === "timeout") {
172
+ this.postmortemTimeoutStreak += 1;
173
+ return {
174
+ status: "fallback",
175
+ reason: "timeout"
176
+ };
177
+ }
178
+ this.postmortemTimeoutStreak = 0;
179
+ return {
180
+ status: "fallback",
181
+ reason: "validation_failed",
182
+ validation: {
183
+ status: "rejected",
184
+ reason: "policy_violation",
185
+ detail: error instanceof Error ? error.message : String(error)
186
+ }
187
+ };
188
+ }
189
+ finally {
190
+ if (timer) {
191
+ clearTimeout(timer);
192
+ }
193
+ }
194
+ }
195
+ }
196
+ //# sourceMappingURL=worker-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker-client.js","sourceRoot":"","sources":["../../src/hybrid/worker-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { DistillerEndpoint } from "../../distillation/providers/types.js";
2
+ import type { ExplainDecisionCapsule, ExplainDecisionWorkerOutput } from "../types.js";
3
+ type ExplainDecisionLlmOptions = {
4
+ endpoint: DistillerEndpoint;
5
+ fetchImpl?: typeof fetch;
6
+ };
7
+ export declare const runExplainDecisionLlmWorker: (capsule: ExplainDecisionCapsule, options: ExplainDecisionLlmOptions) => Promise<ExplainDecisionWorkerOutput>;
8
+ export {};