observability-toolkit-hooks 0.0.0-stage → 1.0.1

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 (306) hide show
  1. package/CONFIG.md +144 -0
  2. package/LICENSE +95 -0
  3. package/README.md +201 -2
  4. package/dist/handlers/compact.js +38 -0
  5. package/dist/handlers/mcp-status.js +66 -0
  6. package/dist/handlers/notification.js +45 -0
  7. package/dist/handlers/post-tool-agent.js +157 -0
  8. package/dist/handlers/post-tool-changelog-sync.js +148 -0
  9. package/dist/handlers/post-tool-code-structure.js +116 -0
  10. package/dist/handlers/post-tool-edit-ledger.js +15 -0
  11. package/dist/handlers/post-tool-failure.js +83 -0
  12. package/dist/handlers/post-tool-git.js +79 -0
  13. package/dist/handlers/post-tool-mcp.js +105 -0
  14. package/dist/handlers/post-tool-outcome.js +48 -0
  15. package/dist/handlers/post-tool-task-state.js +74 -0
  16. package/dist/handlers/post-tool.js +132 -0
  17. package/dist/handlers/pre-tool-agent.js +192 -0
  18. package/dist/handlers/pre-tool.js +218 -0
  19. package/dist/handlers/session-end.js +39 -0
  20. package/dist/handlers/session-start.js +262 -0
  21. package/dist/handlers/stop-error-reminder.js +195 -0
  22. package/dist/handlers/stop-quality-evaluation.js +58 -0
  23. package/dist/handlers/stop-session-summary.js +62 -0
  24. package/dist/handlers/stop-token-metrics.js +83 -0
  25. package/dist/handlers/stop.js +25 -0
  26. package/dist/handlers/subagent.js +105 -0
  27. package/dist/handlers/tool-event-router.js +39 -0
  28. package/dist/handlers/user-prompt.js +218 -0
  29. package/dist/hook-runner.js +10 -0
  30. package/dist/hook-runner.js.map +7 -0
  31. package/dist/lib/agent/agent-context.js +123 -0
  32. package/dist/lib/agent/agent-evaluations.js +155 -0
  33. package/dist/lib/agent/agent-file-budget.js +65 -0
  34. package/dist/lib/agent/agent-sources.js +165 -0
  35. package/dist/lib/agent/synth-spans.js +51 -0
  36. package/dist/lib/core/bounded-label.js +6 -0
  37. package/dist/lib/core/category-rules.js +11 -0
  38. package/dist/lib/core/child-result.js +19 -0
  39. package/dist/lib/core/config-dir-recovery.js +22 -0
  40. package/dist/lib/core/constants.js +171 -0
  41. package/dist/lib/core/detached-runner.js +55 -0
  42. package/dist/lib/core/file-utils.js +353 -0
  43. package/dist/lib/core/format-utils.js +51 -0
  44. package/dist/lib/core/http-utils.js +74 -0
  45. package/dist/lib/core/http1-fetch.js +14 -0
  46. package/dist/lib/core/identity-key-resolver.js +149 -0
  47. package/dist/lib/core/jsonl-tail.js +207 -0
  48. package/dist/lib/core/load-envrc.js +72 -0
  49. package/dist/lib/core/parsers.js +43 -0
  50. package/dist/lib/core/regex.js +27 -0
  51. package/dist/lib/core/settings-env.js +31 -0
  52. package/dist/lib/core/shell-command.js +122 -0
  53. package/dist/lib/core/units.js +97 -0
  54. package/dist/lib/git/git-cache.js +158 -0
  55. package/dist/lib/git/git-commit.js +189 -0
  56. package/dist/lib/git/git-exec.js +30 -0
  57. package/dist/lib/mcp/mcp-completeness.js +40 -0
  58. package/dist/lib/mcp/mcp-config.js +118 -0
  59. package/dist/lib/mcp/mcp-failure-latch.js +22 -0
  60. package/dist/lib/mcp/mcp-identity-launcher.js +43 -0
  61. package/dist/lib/otel/attributes.js +322 -0
  62. package/dist/lib/otel/evaluation-attrs.js +51 -0
  63. package/dist/lib/otel/file-exporters.js +169 -0
  64. package/dist/lib/otel/host-resource.js +61 -0
  65. package/dist/lib/otel/otel-headers-helper.js +26 -0
  66. package/dist/lib/otel/otel-monitor.js +181 -0
  67. package/dist/lib/otel/otel.js +235 -0
  68. package/dist/lib/otel/otlp-headers.js +101 -0
  69. package/dist/lib/otel/otlp-post.js +122 -0
  70. package/dist/lib/otel/otlp-serialize.js +142 -0
  71. package/dist/lib/otel/otlp-signal.js +2 -0
  72. package/dist/lib/otel/remote-spans.js +142 -0
  73. package/dist/lib/otel/service-identity.js +10 -0
  74. package/dist/lib/otel/telemetry-alerts.js +43 -0
  75. package/dist/lib/otel/token-metrics.js +122 -0
  76. package/dist/lib/otel/trace-context.js +81 -0
  77. package/dist/lib/quality/judge-meta-eval.js +70 -0
  78. package/dist/lib/quality/judge-prompts.js +104 -0
  79. package/dist/lib/quality/judge-providers.js +193 -0
  80. package/dist/lib/quality/judge-transport.js +93 -0
  81. package/dist/lib/quality/llm-judge.js +170 -0
  82. package/dist/lib/quality/quality-budget.js +99 -0
  83. package/dist/lib/quality/quality-degradation.js +156 -0
  84. package/dist/lib/quality/quality-eval-handoff.js +74 -0
  85. package/dist/lib/quality/quality-evaluator.js +178 -0
  86. package/dist/lib/quality/quality-sampler.js +43 -0
  87. package/dist/lib/quality/quality-signals.js +150 -0
  88. package/dist/lib/runtime/categorizers.js +101 -0
  89. package/dist/lib/runtime/hook-input.js +16 -0
  90. package/dist/lib/runtime/hook-output.js +50 -0
  91. package/dist/lib/runtime/output-analyzer.js +160 -0
  92. package/dist/lib/runtime/run-handlers.js +32 -0
  93. package/dist/lib/runtime/tool-input.js +111 -0
  94. package/dist/lib/runtime/tool-output.js +44 -0
  95. package/dist/lib/runtime/unknown-tool.js +32 -0
  96. package/dist/lib/session/edit-ledger.js +29 -0
  97. package/dist/lib/session/forked-skill.js +39 -0
  98. package/dist/lib/session/handoffs.js +77 -0
  99. package/dist/lib/session/session-state.js +169 -0
  100. package/dist/lib/session/skill-rules.js +196 -0
  101. package/dist/lib/session/task-tracker.js +83 -0
  102. package/dist/lib/shipper/shipper-credentials.js +38 -0
  103. package/dist/lib/shipper/shipper-cursor.js +89 -0
  104. package/dist/lib/shipper/shipper-status.js +174 -0
  105. package/dist/lib/shipper/span-shipper.js +272 -0
  106. package/dist/lib/shipper/telemetry-shipper.js +39 -0
  107. package/dist/lib/transcript/agent-transcript-metrics.js +34 -0
  108. package/dist/lib/transcript/context-breakdown.js +134 -0
  109. package/dist/lib/transcript/context-history.js +69 -0
  110. package/dist/lib/transcript/context-tracker.js +226 -0
  111. package/dist/lib/transcript/message-count.js +49 -0
  112. package/dist/lib/transcript/model-ids.js +36 -0
  113. package/dist/lib/transcript/model-pricing.js +153 -0
  114. package/dist/lib/transcript/token-metrics-checkpoint.js +152 -0
  115. package/dist/lib/transcript/tool-call-durations.js +64 -0
  116. package/dist/lib/transcript/transcript-entry.js +67 -0
  117. package/dist/lib/transcript/transcript-fold.js +130 -0
  118. package/dist/lib/transcript/transcript-layout.js +39 -0
  119. package/dist/lib/transcript/transcript-parser.js +117 -0
  120. package/dist/runner/agent-context-4XTCLMLZ.js +23 -0
  121. package/dist/runner/agent-context-4XTCLMLZ.js.map +7 -0
  122. package/dist/runner/agent-file-budget-Q33ESBBE.js +68 -0
  123. package/dist/runner/agent-file-budget-Q33ESBBE.js.map +7 -0
  124. package/dist/runner/agent-transcript-metrics-W5CZZFMI.js +39 -0
  125. package/dist/runner/agent-transcript-metrics-W5CZZFMI.js.map +7 -0
  126. package/dist/runner/chunk-2NTNAJZE.js +49 -0
  127. package/dist/runner/chunk-2NTNAJZE.js.map +7 -0
  128. package/dist/runner/chunk-4KWBQTTG.js +78 -0
  129. package/dist/runner/chunk-4KWBQTTG.js.map +7 -0
  130. package/dist/runner/chunk-52RY6LQT.js +699 -0
  131. package/dist/runner/chunk-52RY6LQT.js.map +7 -0
  132. package/dist/runner/chunk-7OM5CYES.js +8695 -0
  133. package/dist/runner/chunk-7OM5CYES.js.map +7 -0
  134. package/dist/runner/chunk-7PEOKGYR.js +1568 -0
  135. package/dist/runner/chunk-7PEOKGYR.js.map +7 -0
  136. package/dist/runner/chunk-AGSGKELQ.js +126 -0
  137. package/dist/runner/chunk-AGSGKELQ.js.map +7 -0
  138. package/dist/runner/chunk-AVM7PJFW.js +12 -0
  139. package/dist/runner/chunk-AVM7PJFW.js.map +7 -0
  140. package/dist/runner/chunk-C3WHUMU5.js +178 -0
  141. package/dist/runner/chunk-C3WHUMU5.js.map +7 -0
  142. package/dist/runner/chunk-DGB4NSSD.js +157 -0
  143. package/dist/runner/chunk-DGB4NSSD.js.map +7 -0
  144. package/dist/runner/chunk-DNSTWC26.js +151 -0
  145. package/dist/runner/chunk-DNSTWC26.js.map +7 -0
  146. package/dist/runner/chunk-FDJJ3TYU.js +449 -0
  147. package/dist/runner/chunk-FDJJ3TYU.js.map +7 -0
  148. package/dist/runner/chunk-FGKYDQHZ.js +137 -0
  149. package/dist/runner/chunk-FGKYDQHZ.js.map +7 -0
  150. package/dist/runner/chunk-GG2I4TGI.js +582 -0
  151. package/dist/runner/chunk-GG2I4TGI.js.map +7 -0
  152. package/dist/runner/chunk-GNNKUMRF.js +60 -0
  153. package/dist/runner/chunk-GNNKUMRF.js.map +7 -0
  154. package/dist/runner/chunk-I7TD2QVR.js +118 -0
  155. package/dist/runner/chunk-I7TD2QVR.js.map +7 -0
  156. package/dist/runner/chunk-IJ4SLUBV.js +78 -0
  157. package/dist/runner/chunk-IJ4SLUBV.js.map +7 -0
  158. package/dist/runner/chunk-IY7AP7NA.js +32 -0
  159. package/dist/runner/chunk-IY7AP7NA.js.map +7 -0
  160. package/dist/runner/chunk-J3F3Z3EQ.js +177 -0
  161. package/dist/runner/chunk-J3F3Z3EQ.js.map +7 -0
  162. package/dist/runner/chunk-JLEO5OHU.js +104 -0
  163. package/dist/runner/chunk-JLEO5OHU.js.map +7 -0
  164. package/dist/runner/chunk-JRNNLOPR.js +168 -0
  165. package/dist/runner/chunk-JRNNLOPR.js.map +7 -0
  166. package/dist/runner/chunk-KGSA5JYP.js +82 -0
  167. package/dist/runner/chunk-KGSA5JYP.js.map +7 -0
  168. package/dist/runner/chunk-LBCZAYFR.js +125 -0
  169. package/dist/runner/chunk-LBCZAYFR.js.map +7 -0
  170. package/dist/runner/chunk-LHWRXY2G.js +41 -0
  171. package/dist/runner/chunk-LHWRXY2G.js.map +7 -0
  172. package/dist/runner/chunk-LQ2LGUYJ.js +41 -0
  173. package/dist/runner/chunk-LQ2LGUYJ.js.map +7 -0
  174. package/dist/runner/chunk-LYY6RCIE.js +158 -0
  175. package/dist/runner/chunk-LYY6RCIE.js.map +7 -0
  176. package/dist/runner/chunk-M4R4QIQH.js +41 -0
  177. package/dist/runner/chunk-M4R4QIQH.js.map +7 -0
  178. package/dist/runner/chunk-MC75VXMX.js +207 -0
  179. package/dist/runner/chunk-MC75VXMX.js.map +7 -0
  180. package/dist/runner/chunk-NKZU4RRG.js +104 -0
  181. package/dist/runner/chunk-NKZU4RRG.js.map +7 -0
  182. package/dist/runner/chunk-PJHWHJ3K.js +56 -0
  183. package/dist/runner/chunk-PJHWHJ3K.js.map +7 -0
  184. package/dist/runner/chunk-RIGVYJ2O.js +114 -0
  185. package/dist/runner/chunk-RIGVYJ2O.js.map +7 -0
  186. package/dist/runner/chunk-RWRGC7ZK.js +93 -0
  187. package/dist/runner/chunk-RWRGC7ZK.js.map +7 -0
  188. package/dist/runner/chunk-SRMAJQMV.js +54 -0
  189. package/dist/runner/chunk-SRMAJQMV.js.map +7 -0
  190. package/dist/runner/chunk-TRMFD36J.js +47 -0
  191. package/dist/runner/chunk-TRMFD36J.js.map +7 -0
  192. package/dist/runner/chunk-U4IOZYQ3.js +21 -0
  193. package/dist/runner/chunk-U4IOZYQ3.js.map +7 -0
  194. package/dist/runner/chunk-UEXDE3WP.js +83 -0
  195. package/dist/runner/chunk-UEXDE3WP.js.map +7 -0
  196. package/dist/runner/chunk-UW3GQZSM.js +50 -0
  197. package/dist/runner/chunk-UW3GQZSM.js.map +7 -0
  198. package/dist/runner/chunk-V2GSP6VR.js +46 -0
  199. package/dist/runner/chunk-V2GSP6VR.js.map +7 -0
  200. package/dist/runner/chunk-VOV4Y5VU.js +81 -0
  201. package/dist/runner/chunk-VOV4Y5VU.js.map +7 -0
  202. package/dist/runner/chunk-VT5T6OEI.js +65 -0
  203. package/dist/runner/chunk-VT5T6OEI.js.map +7 -0
  204. package/dist/runner/chunk-VUYVFWIN.js +12 -0
  205. package/dist/runner/chunk-VUYVFWIN.js.map +7 -0
  206. package/dist/runner/chunk-VVGOPPEN.js +36 -0
  207. package/dist/runner/chunk-VVGOPPEN.js.map +7 -0
  208. package/dist/runner/chunk-VXFSLM6P.js +14 -0
  209. package/dist/runner/chunk-VXFSLM6P.js.map +7 -0
  210. package/dist/runner/chunk-W3EK7JUT.js +26125 -0
  211. package/dist/runner/chunk-W3EK7JUT.js.map +7 -0
  212. package/dist/runner/chunk-WJHNCOUF.js +52 -0
  213. package/dist/runner/chunk-WJHNCOUF.js.map +7 -0
  214. package/dist/runner/chunk-WU7ANGCW.js +269 -0
  215. package/dist/runner/chunk-WU7ANGCW.js.map +7 -0
  216. package/dist/runner/chunk-X7XLMSZX.js +44 -0
  217. package/dist/runner/chunk-X7XLMSZX.js.map +7 -0
  218. package/dist/runner/chunk-XSO3B4QN.js +124 -0
  219. package/dist/runner/chunk-XSO3B4QN.js.map +7 -0
  220. package/dist/runner/chunk-YGFN3LN2.js +174 -0
  221. package/dist/runner/chunk-YGFN3LN2.js.map +7 -0
  222. package/dist/runner/chunk-YHYDBLVB.js +33 -0
  223. package/dist/runner/chunk-YHYDBLVB.js.map +7 -0
  224. package/dist/runner/compact-36NP3PKT.js +60 -0
  225. package/dist/runner/compact-36NP3PKT.js.map +7 -0
  226. package/dist/runner/getMachineId-bsd-AGENNHN6.js +42 -0
  227. package/dist/runner/getMachineId-bsd-AGENNHN6.js.map +7 -0
  228. package/dist/runner/getMachineId-bsd-I5WZGCL4.js +33 -0
  229. package/dist/runner/getMachineId-bsd-I5WZGCL4.js.map +7 -0
  230. package/dist/runner/getMachineId-bsd-ZXK225P7.js +33 -0
  231. package/dist/runner/getMachineId-bsd-ZXK225P7.js.map +7 -0
  232. package/dist/runner/getMachineId-darwin-47GDLEXL.js +42 -0
  233. package/dist/runner/getMachineId-darwin-47GDLEXL.js.map +7 -0
  234. package/dist/runner/getMachineId-darwin-5CRLMDD6.js +33 -0
  235. package/dist/runner/getMachineId-darwin-5CRLMDD6.js.map +7 -0
  236. package/dist/runner/getMachineId-darwin-ADG4I32N.js +33 -0
  237. package/dist/runner/getMachineId-darwin-ADG4I32N.js.map +7 -0
  238. package/dist/runner/getMachineId-linux-5KVS3T2M.js +27 -0
  239. package/dist/runner/getMachineId-linux-5KVS3T2M.js.map +7 -0
  240. package/dist/runner/getMachineId-linux-GDFB5GSO.js +34 -0
  241. package/dist/runner/getMachineId-linux-GDFB5GSO.js.map +7 -0
  242. package/dist/runner/getMachineId-linux-NQMWCRO3.js +27 -0
  243. package/dist/runner/getMachineId-linux-NQMWCRO3.js.map +7 -0
  244. package/dist/runner/getMachineId-unsupported-5PFIGMVX.js +18 -0
  245. package/dist/runner/getMachineId-unsupported-5PFIGMVX.js.map +7 -0
  246. package/dist/runner/getMachineId-unsupported-DW27K3ZX.js +18 -0
  247. package/dist/runner/getMachineId-unsupported-DW27K3ZX.js.map +7 -0
  248. package/dist/runner/getMachineId-unsupported-XV3FHTHD.js +25 -0
  249. package/dist/runner/getMachineId-unsupported-XV3FHTHD.js.map +7 -0
  250. package/dist/runner/getMachineId-win-5JVMW3EI.js +44 -0
  251. package/dist/runner/getMachineId-win-5JVMW3EI.js.map +7 -0
  252. package/dist/runner/getMachineId-win-SNESQF7R.js +35 -0
  253. package/dist/runner/getMachineId-win-SNESQF7R.js.map +7 -0
  254. package/dist/runner/getMachineId-win-UJYHSBM2.js +35 -0
  255. package/dist/runner/getMachineId-win-UJYHSBM2.js.map +7 -0
  256. package/dist/runner/git-commit-BA53DOJQ.js +30 -0
  257. package/dist/runner/git-commit-BA53DOJQ.js.map +7 -0
  258. package/dist/runner/hook-runner-JHH6PGKE.js +220 -0
  259. package/dist/runner/hook-runner-JHH6PGKE.js.map +7 -0
  260. package/dist/runner/judge-transport-R4TF5LEH.js +91 -0
  261. package/dist/runner/judge-transport-R4TF5LEH.js.map +7 -0
  262. package/dist/runner/mcp-status-QEUH2KGX.js +89 -0
  263. package/dist/runner/mcp-status-QEUH2KGX.js.map +7 -0
  264. package/dist/runner/notification-FKMBCSXF.js +69 -0
  265. package/dist/runner/notification-FKMBCSXF.js.map +7 -0
  266. package/dist/runner/post-tool-3MRHTBKH.js +192 -0
  267. package/dist/runner/post-tool-3MRHTBKH.js.map +7 -0
  268. package/dist/runner/post-tool-agent-BB34MNHI.js +370 -0
  269. package/dist/runner/post-tool-agent-BB34MNHI.js.map +7 -0
  270. package/dist/runner/post-tool-changelog-sync-OP2TT2I7.js +147 -0
  271. package/dist/runner/post-tool-changelog-sync-OP2TT2I7.js.map +7 -0
  272. package/dist/runner/post-tool-code-structure-LE7J2SC2.js +130 -0
  273. package/dist/runner/post-tool-code-structure-LE7J2SC2.js.map +7 -0
  274. package/dist/runner/post-tool-edit-ledger-IJMEYHKF.js +30 -0
  275. package/dist/runner/post-tool-edit-ledger-IJMEYHKF.js.map +7 -0
  276. package/dist/runner/post-tool-failure-XTH2I2Z7.js +111 -0
  277. package/dist/runner/post-tool-failure-XTH2I2Z7.js.map +7 -0
  278. package/dist/runner/post-tool-git-E46HZGZO.js +94 -0
  279. package/dist/runner/post-tool-git-E46HZGZO.js.map +7 -0
  280. package/dist/runner/post-tool-mcp-AMCDY5GH.js +144 -0
  281. package/dist/runner/post-tool-mcp-AMCDY5GH.js.map +7 -0
  282. package/dist/runner/post-tool-task-state-TLDOI33H.js +100 -0
  283. package/dist/runner/post-tool-task-state-TLDOI33H.js.map +7 -0
  284. package/dist/runner/pre-tool-SQE2FZQO.js +245 -0
  285. package/dist/runner/pre-tool-SQE2FZQO.js.map +7 -0
  286. package/dist/runner/pre-tool-agent-OZUPVFUI.js +218 -0
  287. package/dist/runner/pre-tool-agent-OZUPVFUI.js.map +7 -0
  288. package/dist/runner/quality-evaluator-XYNDKDRG.js +901 -0
  289. package/dist/runner/quality-evaluator-XYNDKDRG.js.map +7 -0
  290. package/dist/runner/session-end-3MJTDLLA.js +57 -0
  291. package/dist/runner/session-end-3MJTDLLA.js.map +7 -0
  292. package/dist/runner/session-start-5ZMCLKBS.js +352 -0
  293. package/dist/runner/session-start-5ZMCLKBS.js.map +7 -0
  294. package/dist/runner/shipper-status-MADX6SPG.js +37 -0
  295. package/dist/runner/shipper-status-MADX6SPG.js.map +7 -0
  296. package/dist/runner/span-shipper-4HQDHC47.js +3408 -0
  297. package/dist/runner/span-shipper-4HQDHC47.js.map +7 -0
  298. package/dist/runner/stop-RTKSIYJV.js +596 -0
  299. package/dist/runner/stop-RTKSIYJV.js.map +7 -0
  300. package/dist/runner/subagent-CBCG4OLZ.js +116 -0
  301. package/dist/runner/subagent-CBCG4OLZ.js.map +7 -0
  302. package/dist/runner/token-metrics-AD2RAFGM.js +31 -0
  303. package/dist/runner/token-metrics-AD2RAFGM.js.map +7 -0
  304. package/dist/runner/user-prompt-T5NZ2UJD.js +376 -0
  305. package/dist/runner/user-prompt-T5NZ2UJD.js.map +7 -0
  306. package/package.json +70 -5
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../lib/core/shell-command.ts"],
4
+ "sourcesContent": ["/**\n * Just enough shell splitting for \"is X the command here\" heuristics.\n * Not a shell parser: `$(...)` inside double quotes is plain text, heredoc bodies\n * split like any line, redirections stay in argv. A wrong answer must cost an\n * extra check, never gate something that must not be missed.\n */\n\nimport { basename } from 'node:path';\nimport { SHELL_IDENTIFIER_SOURCE } from './regex.js';\n\nconst SINGLE_QUOTE = \"'\";\nconst DOUBLE_QUOTE = '\"';\nconst BACKSLASH = '\\\\';\nconst COMMAND_SUBSTITUTION_OPEN = '$(';\nconst OPTION_PREFIX = '-';\n\n/** Characters that end one simple command outside quotes. `&&`, `||` are two of these. */\nconst SEPARATOR_CHARS = new Set([';', '&', '|', '\\n', '(', ')', '`']);\nconst WORD_BREAK_CHARS = new Set([' ', '\\t', '\\r']);\n\n/** `FOO=bar git commit` \u2014 an assignment prefix, not the program. */\nconst ASSIGNMENT_PATTERN = new RegExp(`^${SHELL_IDENTIFIER_SOURCE}=`);\n\n/** Words that run the rest of the line as the command, when used without options. */\nconst PREFIX_WORDS = new Set(['env', 'command', 'exec', 'time', 'nohup', 'sudo', 'builtin', '{', '!']);\n\n/** Shells that resolve to what they run: a `-c` script's commands, else the script file. */\nconst SCRIPT_SHELLS = new Set(['bash', 'sh', 'zsh']);\n\n/** `-c`, and combined short flags that include it (`-lc`, `-ec`). */\nconst SCRIPT_FLAG_PATTERN = /^-[a-z]*c[a-z]*$/;\n\n/** Text between a pair of quotes, and the index where scanning resumes (the closing quote, or end of input). */\ninterface QuotedSpan {\n text: string;\n end: number;\n}\n\n/** Inside double quotes a backslash escapes the next character; a trailing one is kept as-is. Single quotes escape nothing. */\nfunction readQuoted(command: string, openIndex: number, quote: string): QuotedSpan {\n let text = '';\n let i = openIndex + 1;\n while (i < command.length && command[i] !== quote) {\n if (quote === DOUBLE_QUOTE && command[i] === BACKSLASH && i + 1 < command.length) i++;\n text += command[i];\n i++;\n }\n return { text, end: i };\n}\n\n/** Unquoted words of each simple command, in order; empty commands are dropped. */\nfunction splitSimpleCommands(command: string): string[][] {\n const commands: string[][] = [];\n let words: string[] = [];\n let word = '';\n let inWord = false;\n\n const appendToWord = (text: string): void => {\n word += text;\n inWord = true;\n };\n const endWord = (): void => {\n if (inWord) words.push(word);\n word = '';\n inWord = false;\n };\n const endCommand = (): void => {\n endWord();\n if (words.length > 0) commands.push(words);\n words = [];\n };\n\n for (let i = 0; i < command.length; i++) {\n const char = command.charAt(i);\n if (char === SINGLE_QUOTE || char === DOUBLE_QUOTE) {\n const span = readQuoted(command, i, char);\n appendToWord(span.text);\n i = span.end;\n } else if (char === BACKSLASH && i + 1 < command.length) {\n appendToWord(command.charAt(i + 1));\n i++;\n } else if (command.startsWith(COMMAND_SUBSTITUTION_OPEN, i)) {\n endCommand();\n i++;\n } else if (SEPARATOR_CHARS.has(char)) {\n endCommand();\n } else if (WORD_BREAK_CHARS.has(char)) {\n endWord();\n } else {\n appendToWord(char);\n }\n }\n endCommand();\n return commands;\n}\n\n/** Drops assignment prefixes and wrapper words, leaving the program first. */\nfunction stripPrefixes(words: string[]): string[] {\n const start = words.findIndex((word) => !ASSIGNMENT_PATTERN.test(word) && !PREFIX_WORDS.has(word));\n return start === -1 ? [] : words.slice(start);\n}\n\n/** The program an argv runs, without its directory (`/usr/bin/git` \u2192 `git`). */\nexport const programOf = (argv: string[]): string => basename(argv[0] ?? '');\n\n/** `-x` or `--flag`: an option rather than an operand. */\nexport const isOptionArg = (arg: string): boolean => arg.startsWith(OPTION_PREFIX);\n\n/**\n * The argv of every simple command, program first. A shell resolves to what it runs:\n * `bash -c <script>` contributes the script's commands, `bash [options] run.sh args`\n * contributes `run.sh args`. A nested `-c` script is always shorter than the command\n * holding it, so the recursion needs no depth guard.\n */\nexport function commandInvocations(command: string): string[][] {\n const invocations: string[][] = [];\n for (const words of splitSimpleCommands(command)) {\n const argv = stripPrefixes(words);\n if (argv.length === 0) continue;\n if (!SCRIPT_SHELLS.has(programOf(argv))) {\n invocations.push(argv);\n continue;\n }\n const scriptFlag = argv.findIndex((arg) => SCRIPT_FLAG_PATTERN.test(arg));\n const script = scriptFlag === -1 ? undefined : argv[scriptFlag + 1];\n if (script !== undefined) {\n invocations.push(...commandInvocations(script));\n continue;\n }\n const scriptFile = argv.findIndex((arg, i) => i > 0 && !isOptionArg(arg));\n invocations.push(scriptFile === -1 ? argv : argv.slice(scriptFile));\n }\n return invocations;\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,168 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ SHIPPER_CTX_DIRNAME
5
+ } from "./chunk-YGFN3LN2.js";
6
+ import {
7
+ AUTHORIZATION_HEADER,
8
+ BEARER_SCHEME,
9
+ bearerHeaders
10
+ } from "./chunk-IJ4SLUBV.js";
11
+ import {
12
+ OTLP_ENV
13
+ } from "./chunk-GG2I4TGI.js";
14
+ import {
15
+ loadJsonObject,
16
+ telemetryFileName,
17
+ telemetryFilePrefix,
18
+ writeJson
19
+ } from "./chunk-52RY6LQT.js";
20
+ import {
21
+ TIME_MS
22
+ } from "./chunk-RWRGC7ZK.js";
23
+
24
+ // lib/otel/otlp-signal.ts
25
+ var OTLP_SIGNALS = ["traces", "logs", "metrics"];
26
+
27
+ // lib/otel/otlp-headers.ts
28
+ var SIGNAL_HEADERS_ENV = {
29
+ traces: "OTEL_EXPORTER_OTLP_TRACES_HEADERS",
30
+ logs: "OTEL_EXPORTER_OTLP_LOGS_HEADERS",
31
+ metrics: "OTEL_EXPORTER_OTLP_METRICS_HEADERS"
32
+ };
33
+ var HEADER_ENV_VARS = [OTLP_ENV.HEADERS, ...Object.values(SIGNAL_HEADERS_ENV)];
34
+ var ITEMS_SEPARATOR = ",";
35
+ var PROPERTIES_SEPARATOR = ";";
36
+ var KEY_PAIR_SEPARATOR = "=";
37
+ function parseHeaderEntry(entry) {
38
+ const [pair = ""] = entry.split(PROPERTIES_SEPARATOR, 1);
39
+ const eq = pair.indexOf(KEY_PAIR_SEPARATOR);
40
+ if (eq <= 0) return null;
41
+ const rawKey = pair.slice(0, eq).trim();
42
+ const rawValue = pair.slice(eq + 1).trim();
43
+ if (!rawKey || !rawValue) return null;
44
+ try {
45
+ return [decodeURIComponent(rawKey), decodeURIComponent(rawValue)];
46
+ } catch {
47
+ return null;
48
+ }
49
+ }
50
+ var isHeaderEntry = (entry) => entry !== null;
51
+ function parseOtlpHeaders(raw) {
52
+ if (!raw) return {};
53
+ return Object.fromEntries(raw.split(ITEMS_SEPARATOR).map(parseHeaderEntry).filter(isHeaderEntry));
54
+ }
55
+ var SCHEME_TOKEN_CHARS = "A-Za-z0-9!#$%&'*+\\-.^_`|~";
56
+ var BARE_AUTH_SCHEME = new RegExp(`^[A-Za-z][${SCHEME_TOKEN_CHARS}]*$`);
57
+ function isUsableCredential(name, value) {
58
+ if (name.toLowerCase() !== AUTHORIZATION_HEADER.toLowerCase()) return true;
59
+ return !BARE_AUTH_SCHEME.test(value);
60
+ }
61
+ var BEARER_PREFIX = new RegExp(`^${BEARER_SCHEME}\\s+`, "i");
62
+ function headerBagBearerToken(raw) {
63
+ const token = parseOtlpHeaders(raw)[AUTHORIZATION_HEADER]?.replace(BEARER_PREFIX, "");
64
+ return token || void 0;
65
+ }
66
+ function otlpAuthHeaders(signal, env = process.env) {
67
+ const merged = {
68
+ ...parseOtlpHeaders(env[OTLP_ENV.HEADERS]),
69
+ ...parseOtlpHeaders(env[SIGNAL_HEADERS_ENV[signal]])
70
+ };
71
+ const headers = Object.fromEntries(
72
+ Object.entries(merged).filter(([name, value]) => isUsableCredential(name, value))
73
+ );
74
+ const apiKey = env[OTLP_ENV.API_KEY];
75
+ return apiKey ? { ...headers, ...bearerHeaders(apiKey) } : headers;
76
+ }
77
+ function hasOtlpAuth(env = process.env) {
78
+ if (env[OTLP_ENV.API_KEY]) return true;
79
+ return OTLP_SIGNALS.some((signal) => Object.keys(otlpAuthHeaders(signal, env)).length > 0);
80
+ }
81
+ function describeOtlpCredentialConflict(env = process.env) {
82
+ const apiKey = env[OTLP_ENV.API_KEY];
83
+ if (!apiKey) return void 0;
84
+ const disagrees = (varName) => {
85
+ const token = headerBagBearerToken(env[varName]);
86
+ return token !== void 0 && token !== apiKey;
87
+ };
88
+ const conflicting = HEADER_ENV_VARS.find(disagrees);
89
+ if (!conflicting) return void 0;
90
+ return `${conflicting} carries a different credential than ${OTLP_ENV.API_KEY}; ${OTLP_ENV.API_KEY} wins here, but SDK exporters read ${conflicting} and would use the other one`;
91
+ }
92
+
93
+ // lib/shipper/shipper-cursor.ts
94
+ import { statSync } from "node:fs";
95
+ import { join } from "node:path";
96
+ var CURSOR_FILENAME = "cursor.json";
97
+ var SHIP_DAYS = 2;
98
+ function cursorPath(telemetryDir) {
99
+ return join(telemetryDir, SHIPPER_CTX_DIRNAME, CURSOR_FILENAME);
100
+ }
101
+ function signalForFile(file) {
102
+ const prefix = telemetryFilePrefix(file);
103
+ return OTLP_SIGNALS.find((signal) => signal === prefix) ?? null;
104
+ }
105
+ function resumeOffset(size, offset) {
106
+ return size < offset ? 0 : offset;
107
+ }
108
+ function sizeOf(path) {
109
+ try {
110
+ return statSync(path).size;
111
+ } catch {
112
+ return void 0;
113
+ }
114
+ }
115
+ function candidateFiles(telemetryDir, cursor) {
116
+ const wanted = /* @__PURE__ */ new Map();
117
+ for (let i = 0; i < SHIP_DAYS; i++) {
118
+ const date = new Date(Date.now() - i * TIME_MS.DAY);
119
+ for (const prefix of OTLP_SIGNALS) {
120
+ wanted.set(telemetryFileName(prefix, date), prefix);
121
+ }
122
+ }
123
+ const candidates = [];
124
+ for (const [file, signal] of wanted) {
125
+ const size = sizeOf(join(telemetryDir, file));
126
+ if (size !== void 0) candidates.push({ file, signal, size, start: resumeOffset(size, cursor[file] ?? 0) });
127
+ }
128
+ for (const [file, offset] of Object.entries(cursor)) {
129
+ if (wanted.has(file)) continue;
130
+ const signal = signalForFile(file);
131
+ if (!signal) continue;
132
+ const size = sizeOf(join(telemetryDir, file));
133
+ if (size === void 0) continue;
134
+ const start = resumeOffset(size, offset);
135
+ if (size > start) candidates.push({ file, signal, size, start, aged: true });
136
+ }
137
+ return candidates;
138
+ }
139
+ function loadCursor(path) {
140
+ const cursor = {};
141
+ for (const [file, offset] of Object.entries(loadJsonObject(path) ?? {})) {
142
+ if (typeof offset === "number" && offset >= 0) cursor[file] = offset;
143
+ }
144
+ return cursor;
145
+ }
146
+ function saveCursor(path, cursor, listed) {
147
+ const pruned = {};
148
+ for (const { file } of listed) {
149
+ if (cursor[file] !== void 0) pruned[file] = cursor[file];
150
+ }
151
+ writeJson(path, pruned, false, { silent: true });
152
+ }
153
+ function hasUnshippedTelemetry(telemetryDir) {
154
+ const cursor = loadCursor(cursorPath(telemetryDir));
155
+ return candidateFiles(telemetryDir, cursor).some(({ size, start }) => size > start);
156
+ }
157
+
158
+ export {
159
+ otlpAuthHeaders,
160
+ hasOtlpAuth,
161
+ describeOtlpCredentialConflict,
162
+ cursorPath,
163
+ candidateFiles,
164
+ loadCursor,
165
+ saveCursor,
166
+ hasUnshippedTelemetry
167
+ };
168
+ //# sourceMappingURL=chunk-JRNNLOPR.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../lib/otel/otlp-signal.ts", "../../../lib/otel/otlp-headers.ts", "../../../lib/shipper/shipper-cursor.ts"],
4
+ "sourcesContent": ["/** The three OTLP signals; shared by exporters, shipper, and header resolution. */\n\nexport type OtlpSignal = 'traces' | 'logs' | 'metrics';\n\nexport const OTLP_SIGNALS: readonly OtlpSignal[] = ['traces', 'logs', 'metrics'];\n", "/**\n * `OTEL_EXPORTER_OTLP_*_HEADERS` resolution, mirroring otlp-exporter-base's\n * `parsePairKeyValue` deliberately: a divergence is a bug. The whole bag is\n * carried, not just `Authorization`, since vendor schemes (`api-key=`) are credentials too.\n */\n\nimport { AUTHORIZATION_HEADER, BEARER_SCHEME, bearerHeaders } from '../core/http-utils.js';\nimport { OTLP_ENV } from '../core/settings-env.js';\nimport { OTLP_SIGNALS, type OtlpSignal } from './otlp-signal.js';\n\n// ==================== Signals and environment ====================\n\nconst SIGNAL_HEADERS_ENV: Record<OtlpSignal, string> = {\n traces: 'OTEL_EXPORTER_OTLP_TRACES_HEADERS',\n logs: 'OTEL_EXPORTER_OTLP_LOGS_HEADERS',\n metrics: 'OTEL_EXPORTER_OTLP_METRICS_HEADERS',\n};\n\n/** Generic first, so a conflict present in both is reported against the generic var. */\nconst HEADER_ENV_VARS = [OTLP_ENV.HEADERS, ...Object.values(SIGNAL_HEADERS_ENV)];\n\n// ==================== Header-bag parsing ====================\n\nconst ITEMS_SEPARATOR = ',';\nconst PROPERTIES_SEPARATOR = ';';\nconst KEY_PAIR_SEPARATOR = '=';\n\ntype HeaderEntry = [name: string, value: string];\n\n/** `key=value[;metadata]`; null wherever the reference drops the entry. `<= 0` rejects a missing `=` and an empty key alike. */\nfunction parseHeaderEntry(entry: string): HeaderEntry | null {\n const [pair = ''] = entry.split(PROPERTIES_SEPARATOR, 1);\n const eq = pair.indexOf(KEY_PAIR_SEPARATOR);\n if (eq <= 0) return null;\n\n const rawKey = pair.slice(0, eq).trim();\n const rawValue = pair.slice(eq + 1).trim();\n if (!rawKey || !rawValue) return null;\n\n try {\n return [decodeURIComponent(rawKey), decodeURIComponent(rawValue)];\n } catch {\n return null;\n }\n}\n\nconst isHeaderEntry = (entry: HeaderEntry | null): entry is HeaderEntry => entry !== null;\n\n/** Last duplicate wins. Undecodable entries are dropped like the reference: a raw fallback once put a wrong credential on the wire as an unexplained 401. */\nexport function parseOtlpHeaders(raw: string | undefined): Record<string, string> {\n if (!raw) return {};\n return Object.fromEntries(raw.split(ITEMS_SEPARATOR).map(parseHeaderEntry).filter(isHeaderEntry));\n}\n\n/** Inverse of `parseOtlpHeaders`: percent-encodes each key and value so the bag round-trips cleanly. A `%` in a value that is not encoded would throw on decode. */\nexport function formatOtlpHeaders(headers: Record<string, string>): string {\n return Object.entries(headers)\n .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)\n .join(ITEMS_SEPARATOR);\n}\n\n// ==================== Credential rules ====================\n\n/**\n * A bare `Bearer`, which `export Authorization=Bearer ${OBTOOL_API_KEY}` yields when the\n * key is unset; counting it as a credential made the shipper spawn and 401 on every\n * flush. Only `Authorization` has a grammar to check; vendor headers are opaque.\n */\nconst SCHEME_TOKEN_CHARS = \"A-Za-z0-9!#$%&'*+\\\\-.^_`|~\";\nconst BARE_AUTH_SCHEME = new RegExp(`^[A-Za-z][${SCHEME_TOKEN_CHARS}]*$`);\n\nfunction isUsableCredential(name: string, value: string): boolean {\n if (name.toLowerCase() !== AUTHORIZATION_HEADER.toLowerCase()) return true;\n return !BARE_AUTH_SCHEME.test(value);\n}\n\nconst BEARER_PREFIX = new RegExp(`^${BEARER_SCHEME}\\\\s+`, 'i');\n\nfunction headerBagBearerToken(raw: string | undefined): string | undefined {\n const token = parseOtlpHeaders(raw)[AUTHORIZATION_HEADER]?.replace(BEARER_PREFIX, '');\n return token || undefined;\n}\n\n// ==================== Resolution ====================\n\n/** `OBTOOL_API_KEY` outranks both env bags. */\nexport function otlpAuthHeaders(\n signal: OtlpSignal,\n env: NodeJS.ProcessEnv = process.env\n): Record<string, string> {\n const merged = {\n ...parseOtlpHeaders(env[OTLP_ENV.HEADERS]),\n ...parseOtlpHeaders(env[SIGNAL_HEADERS_ENV[signal]]),\n };\n const headers = Object.fromEntries(\n Object.entries(merged).filter(([name, value]) => isUsableCredential(name, value))\n );\n const apiKey = env[OTLP_ENV.API_KEY];\n return apiKey ? { ...headers, ...bearerHeaders(apiKey) } : headers;\n}\n\n/** Shared by the shipper's spawn and run guards, which drifted when each encoded it. Any header counts: the credential's name is vendor-specific. */\nexport function hasOtlpAuth(env: NodeJS.ProcessEnv = process.env): boolean {\n if (env[OTLP_ENV.API_KEY]) return true;\n return OTLP_SIGNALS.some((signal) => Object.keys(otlpAuthHeaders(signal, env)).length > 0);\n}\n\n/** Precedence hides a disagreeing env-bag credential here, but SDK exporters read only the env bag and 401 without explanation. */\nexport function describeOtlpCredentialConflict(\n env: NodeJS.ProcessEnv = process.env\n): string | undefined {\n const apiKey = env[OTLP_ENV.API_KEY];\n if (!apiKey) return undefined;\n\n const disagrees = (varName: string): boolean => {\n const token = headerBagBearerToken(env[varName]);\n return token !== undefined && token !== apiKey;\n };\n const conflicting = HEADER_ENV_VARS.find(disagrees);\n if (!conflicting) return undefined;\n\n // Only the names, never the credentials.\n return `${conflicting} carries a different credential than ${OTLP_ENV.API_KEY}; ` +\n `${OTLP_ENV.API_KEY} wins here, but SDK exporters read ${conflicting} and would use the other one`;\n}\n", "/**\n * The shipper's cursor and file window without the shipper (HDF2): the spawn\n * guard answers \"anything to ship?\" without the protobuf import graph, and the\n * shipper reads the same listing so the two cannot disagree.\n */\n\nimport { statSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { loadJsonObject, writeJson } from '../core/file-utils.js';\nimport { telemetryFileName, telemetryFilePrefix } from '../core/format-utils.js';\nimport { TIME_MS } from '../core/units.js';\nimport { OTLP_SIGNALS, type OtlpSignal } from '../otel/otlp-signal.js';\nimport { SHIPPER_CTX_DIRNAME } from './shipper-status.js';\n\nconst CURSOR_FILENAME = 'cursor.json';\n\n/** Ship today's and yesterday's files (FileExporter names by UTC date). */\nconst SHIP_DAYS = 2;\n\n/** Byte offset already shipped, per telemetry filename. */\nexport type CursorMap = Record<string, number>;\n\nexport interface CandidateFile {\n file: string;\n signal: OtlpSignal;\n /** Bytes on disk when the file was listed. */\n size: number;\n /** Byte offset reading resumes at; a file with no cursor entry starts at 0. */\n start: number;\n /** Outside the SHIP_DAYS window, kept only by its cursor entry. */\n aged?: true;\n}\n\nexport function cursorPath(telemetryDir: string): string {\n return join(telemetryDir, SHIPPER_CTX_DIRNAME, CURSOR_FILENAME);\n}\n\n/** The signal a telemetry filename belongs to, or null for any other file. */\nfunction signalForFile(file: string): OtlpSignal | null {\n const prefix = telemetryFilePrefix(file);\n return OTLP_SIGNALS.find((signal) => signal === prefix) ?? null;\n}\n\n/** Where reading resumes: the cursor, or 0 once the file was truncated below it, since re-delivering a surviving prefix beats dropping the rest of the day. */\nfunction resumeOffset(size: number, offset: number): number {\n return size < offset ? 0 : offset;\n}\n\nfunction sizeOf(path: string): number | undefined {\n try {\n return statSync(path).size;\n } catch {\n return undefined;\n }\n}\n\n/** The SHIP_DAYS window plus older files with an undelivered backlog, which saveCursor's pruning would otherwise age out. */\nexport function candidateFiles(telemetryDir: string, cursor: CursorMap): CandidateFile[] {\n const wanted = new Map<string, OtlpSignal>();\n for (let i = 0; i < SHIP_DAYS; i++) {\n const date = new Date(Date.now() - i * TIME_MS.DAY);\n for (const prefix of OTLP_SIGNALS) {\n wanted.set(telemetryFileName(prefix, date), prefix);\n }\n }\n\n // Stat known names rather than listing a directory of thousands of files.\n const candidates: CandidateFile[] = [];\n for (const [file, signal] of wanted) {\n const size = sizeOf(join(telemetryDir, file));\n if (size !== undefined) candidates.push({ file, signal, size, start: resumeOffset(size, cursor[file] ?? 0) });\n }\n\n for (const [file, offset] of Object.entries(cursor)) {\n if (wanted.has(file)) continue;\n const signal = signalForFile(file);\n if (!signal) continue;\n const size = sizeOf(join(telemetryDir, file));\n if (size === undefined) continue;\n const start = resumeOffset(size, offset);\n if (size > start) candidates.push({ file, signal, size, start, aged: true });\n }\n\n return candidates;\n}\n\n/** The cursor, empty when missing or unusable, so every listed file reads from 0. */\nexport function loadCursor(path: string): CursorMap {\n const cursor: CursorMap = {};\n for (const [file, offset] of Object.entries(loadJsonObject(path) ?? {})) {\n if (typeof offset === 'number' && offset >= 0) cursor[file] = offset;\n }\n return cursor;\n}\n\n/** Keeps only the listed files' entries, so a file that leaves the listing loses its cursor. */\nexport function saveCursor(path: string, cursor: CursorMap, listed: readonly CandidateFile[]): void {\n const pruned: CursorMap = {};\n for (const { file } of listed) {\n if (cursor[file] !== undefined) pruned[file] = cursor[file];\n }\n writeJson(path, pruned, false, { silent: true });\n}\n\n/** Whether any listed file holds bytes past its resume offset, so first runs and held cursors answer yes. */\nexport function hasUnshippedTelemetry(telemetryDir: string): boolean {\n const cursor = loadCursor(cursorPath(telemetryDir));\n return candidateFiles(telemetryDir, cursor).some(({ size, start }) => size > start);\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,82 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ sessionStateDir
5
+ } from "./chunk-DNSTWC26.js";
6
+ import {
7
+ isJsonObject,
8
+ loadJson,
9
+ withFileLock,
10
+ writeJson
11
+ } from "./chunk-52RY6LQT.js";
12
+
13
+ // lib/session/task-tracker.ts
14
+ import { randomUUID } from "node:crypto";
15
+ import { join } from "node:path";
16
+ var TASK_STATE_FILE = "tasks.json";
17
+ var AUTO_ID_LENGTH = 8;
18
+ var TASK_STATUSES = ["pending", "in_progress", "completed", "deleted"];
19
+ function isTaskStatus(value) {
20
+ return typeof value === "string" && TASK_STATUSES.includes(value);
21
+ }
22
+ function getFilePath(sessionId) {
23
+ return join(sessionStateDir(sessionId), TASK_STATE_FILE);
24
+ }
25
+ function saveTaskState(sessionId, tasks) {
26
+ return writeJson(getFilePath(sessionId), {
27
+ sessionId,
28
+ timestamp: Date.now(),
29
+ tasks
30
+ });
31
+ }
32
+ function loadTaskState(sessionId) {
33
+ return loadJson(getFilePath(sessionId));
34
+ }
35
+ function getActiveTasks(tasks) {
36
+ return tasks.filter((t) => t.status !== "deleted");
37
+ }
38
+ function calculateTaskCompletion(tasks) {
39
+ const active = getActiveTasks(tasks);
40
+ if (active.length === 0) return 1;
41
+ return active.filter((t) => t.status === "completed").length / active.length;
42
+ }
43
+ function activeTaskCompletion(sessionId) {
44
+ const taskState = loadTaskState(sessionId);
45
+ if (!taskState) return null;
46
+ const active = getActiveTasks(taskState.tasks);
47
+ if (active.length === 0) return null;
48
+ return { active, ratio: calculateTaskCompletion(taskState.tasks) };
49
+ }
50
+ function generateTaskId() {
51
+ return `auto-${randomUUID().slice(0, AUTO_ID_LENGTH)}`;
52
+ }
53
+ function structuredTaskId(toolResponse) {
54
+ if (!isJsonObject(toolResponse)) return void 0;
55
+ const created = toolResponse.task;
56
+ if (!isJsonObject(created)) return void 0;
57
+ const id = created.id;
58
+ if (typeof id === "number") return String(id);
59
+ return typeof id === "string" && id.trim() ? id.trim() : void 0;
60
+ }
61
+ function createdTaskId(toolResponse, outputText) {
62
+ return structuredTaskId(toolResponse) ?? outputText.match(/Task #(\d+)/)?.[1] ?? generateTaskId();
63
+ }
64
+ function upsertTask(sessionId, task) {
65
+ return withFileLock(getFilePath(sessionId), () => {
66
+ const tasks = loadTaskState(sessionId)?.tasks ?? [];
67
+ const idx = tasks.findIndex((t) => t.id === task.id);
68
+ const existing = tasks[idx];
69
+ if (existing) tasks[idx] = { ...task, name: task.name || existing.name, createdAt: existing.createdAt };
70
+ else tasks.push(task);
71
+ return saveTaskState(sessionId, tasks);
72
+ });
73
+ }
74
+
75
+ export {
76
+ isTaskStatus,
77
+ loadTaskState,
78
+ activeTaskCompletion,
79
+ createdTaskId,
80
+ upsertTask
81
+ };
82
+ //# sourceMappingURL=chunk-KGSA5JYP.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../lib/session/task-tracker.ts"],
4
+ "sourcesContent": ["/** Persists task state to `session-state/<sessionId>/tasks.json` so it survives compaction. */\n\nimport { randomUUID } from 'node:crypto';\nimport { join } from 'node:path';\nimport { isJsonObject, loadJson, writeJson, withFileLock } from '../core/file-utils.js';\nimport { sessionStateDir } from './session-state.js';\n\n/** One JSON file per session, inside the session's state directory. */\nconst TASK_STATE_FILE = 'tasks.json';\n\n/** Length of the random suffix on an auto-assigned task id. */\nconst AUTO_ID_LENGTH = 8;\n\n/** The status vocabulary, once \u2014 the type and the runtime guard cannot drift. */\nconst TASK_STATUSES = ['pending', 'in_progress', 'completed', 'deleted'] as const;\n\nexport type TaskStatus = (typeof TASK_STATUSES)[number];\n\nexport function isTaskStatus(value: unknown): value is TaskStatus {\n return typeof value === 'string' && (TASK_STATUSES as readonly string[]).includes(value);\n}\n\nexport interface TaskState {\n id: string;\n name: string;\n status: TaskStatus;\n createdAt: string;\n updatedAt: string;\n}\n\ninterface SessionTaskState {\n sessionId: string;\n timestamp: number;\n tasks: TaskState[];\n}\n\nfunction getFilePath(sessionId: string): string {\n return join(sessionStateDir(sessionId), TASK_STATE_FILE);\n}\n\nfunction saveTaskState(sessionId: string, tasks: TaskState[]): boolean {\n return writeJson(getFilePath(sessionId), {\n sessionId,\n timestamp: Date.now(),\n tasks,\n });\n}\n\nexport function loadTaskState(sessionId: string): SessionTaskState | null {\n return loadJson<SessionTaskState>(getFilePath(sessionId));\n}\n\n/** Active (non-deleted) tasks; the one owner of the predicate. */\nexport function getActiveTasks(tasks: TaskState[]): TaskState[] {\n return tasks.filter(t => t.status !== 'deleted');\n}\n\n/** Completion ratio over active tasks; an empty set is complete. */\nexport function calculateTaskCompletion(tasks: TaskState[]): number {\n const active = getActiveTasks(tasks);\n if (active.length === 0) return 1;\n return active.filter(t => t.status === 'completed').length / active.length;\n}\n\n/** Active tasks and completion ratio, or null when there are none. */\nexport function activeTaskCompletion(sessionId: string): { active: TaskState[]; ratio: number } | null {\n const taskState = loadTaskState(sessionId);\n if (!taskState) return null;\n const active = getActiveTasks(taskState.tasks);\n if (active.length === 0) return null;\n return { active, ratio: calculateTaskCompletion(taskState.tasks) };\n}\n\n/** Auto-assigned task id. */\nexport function generateTaskId(): string {\n return `auto-${randomUUID().slice(0, AUTO_ID_LENGTH)}`;\n}\n\nfunction structuredTaskId(toolResponse: unknown): string | undefined {\n if (!isJsonObject(toolResponse)) return undefined;\n const created = toolResponse.task;\n if (!isJsonObject(created)) return undefined;\n const id = created.id;\n if (typeof id === 'number') return String(id);\n return typeof id === 'string' && id.trim() ? id.trim() : undefined;\n}\n\n/**\n * The id TaskCreate assigned, the key later TaskUpdate calls use: `tool_response.task.id`\n * as hooks receive it, else \"Task #N\" in the text form, else auto-generated (PT3, PT15).\n */\nexport function createdTaskId(toolResponse: unknown, outputText: string): string {\n return structuredTaskId(toolResponse) ?? outputText.match(/Task #(\\d+)/)?.[1] ?? generateTaskId();\n}\n\n/** Upsert one task under the advisory file lock. A known id keeps its creation time, and its name when the write carries none (a TaskUpdate has no subject). */\nexport function upsertTask(sessionId: string, task: TaskState): boolean {\n return withFileLock(getFilePath(sessionId), () => {\n const tasks = loadTaskState(sessionId)?.tasks ?? [];\n\n const idx = tasks.findIndex(t => t.id === task.id);\n const existing = tasks[idx];\n if (existing) tasks[idx] = { ...task, name: task.name || existing.name, createdAt: existing.createdAt };\n else tasks.push(task);\n\n return saveTaskState(sessionId, tasks);\n });\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;AAEA,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AAKrB,IAAM,kBAAkB;AAGxB,IAAM,iBAAiB;AAGvB,IAAM,gBAAgB,CAAC,WAAW,eAAe,aAAa,SAAS;AAIhE,SAAS,aAAa,OAAqC;AAChE,SAAO,OAAO,UAAU,YAAa,cAAoC,SAAS,KAAK;AACzF;AAgBA,SAAS,YAAY,WAA2B;AAC9C,SAAO,KAAK,gBAAgB,SAAS,GAAG,eAAe;AACzD;AAEA,SAAS,cAAc,WAAmB,OAA6B;AACrE,SAAO,UAAU,YAAY,SAAS,GAAG;AAAA,IACvC;AAAA,IACA,WAAW,KAAK,IAAI;AAAA,IACpB;AAAA,EACF,CAAC;AACH;AAEO,SAAS,cAAc,WAA4C;AACxE,SAAO,SAA2B,YAAY,SAAS,CAAC;AAC1D;AAGO,SAAS,eAAe,OAAiC;AAC9D,SAAO,MAAM,OAAO,OAAK,EAAE,WAAW,SAAS;AACjD;AAGO,SAAS,wBAAwB,OAA4B;AAClE,QAAM,SAAS,eAAe,KAAK;AACnC,MAAI,OAAO,WAAW,EAAG,QAAO;AAChC,SAAO,OAAO,OAAO,OAAK,EAAE,WAAW,WAAW,EAAE,SAAS,OAAO;AACtE;AAGO,SAAS,qBAAqB,WAAkE;AACrG,QAAM,YAAY,cAAc,SAAS;AACzC,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,SAAS,eAAe,UAAU,KAAK;AAC7C,MAAI,OAAO,WAAW,EAAG,QAAO;AAChC,SAAO,EAAE,QAAQ,OAAO,wBAAwB,UAAU,KAAK,EAAE;AACnE;AAGO,SAAS,iBAAyB;AACvC,SAAO,QAAQ,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC;AACtD;AAEA,SAAS,iBAAiB,cAA2C;AACnE,MAAI,CAAC,aAAa,YAAY,EAAG,QAAO;AACxC,QAAM,UAAU,aAAa;AAC7B,MAAI,CAAC,aAAa,OAAO,EAAG,QAAO;AACnC,QAAM,KAAK,QAAQ;AACnB,MAAI,OAAO,OAAO,SAAU,QAAO,OAAO,EAAE;AAC5C,SAAO,OAAO,OAAO,YAAY,GAAG,KAAK,IAAI,GAAG,KAAK,IAAI;AAC3D;AAMO,SAAS,cAAc,cAAuB,YAA4B;AAC/E,SAAO,iBAAiB,YAAY,KAAK,WAAW,MAAM,aAAa,IAAI,CAAC,KAAK,eAAe;AAClG;AAGO,SAAS,WAAW,WAAmB,MAA0B;AACtE,SAAO,aAAa,YAAY,SAAS,GAAG,MAAM;AAChD,UAAM,QAAQ,cAAc,SAAS,GAAG,SAAS,CAAC;AAElD,UAAM,MAAM,MAAM,UAAU,OAAK,EAAE,OAAO,KAAK,EAAE;AACjD,UAAM,WAAW,MAAM,GAAG;AAC1B,QAAI,SAAU,OAAM,GAAG,IAAI,EAAE,GAAG,MAAM,MAAM,KAAK,QAAQ,SAAS,MAAM,WAAW,SAAS,UAAU;AAAA,QACjG,OAAM,KAAK,IAAI;AAEpB,WAAO,cAAc,WAAW,KAAK;AAAA,EACvC,CAAC;AACH;",
6
+ "names": []
7
+ }
@@ -0,0 +1,125 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ OTHER_LABEL
5
+ } from "./chunk-VXFSLM6P.js";
6
+ import {
7
+ AGENT_ATTRS,
8
+ GENAI_TOOL_NAME_ATTR,
9
+ TOOL_ATTRS
10
+ } from "./chunk-7OM5CYES.js";
11
+ import {
12
+ JS_EXTENSIONS,
13
+ TS_EXTENSIONS,
14
+ alternation,
15
+ fileExtensionPattern
16
+ } from "./chunk-YHYDBLVB.js";
17
+ import {
18
+ BUILTIN_TOOLS_BY_CATEGORY,
19
+ UNKNOWN_TOOL_CATEGORY
20
+ } from "./chunk-52RY6LQT.js";
21
+
22
+ // lib/core/category-rules.ts
23
+ function matchCategory(value, rules, fallback) {
24
+ for (const rule of rules) {
25
+ if (rule.substrings.some((s) => value.includes(s))) return rule.category;
26
+ if (rule.pattern?.test(value)) return rule.category;
27
+ }
28
+ return fallback;
29
+ }
30
+
31
+ // lib/runtime/categorizers.ts
32
+ var SKILL_CATEGORY_RULES = [
33
+ // otel-* before report/review.
34
+ { category: "observability", substrings: ["otel", "telemetry", "observ"] },
35
+ { category: "reporting", substrings: ["report", "summary", "dashboard"] },
36
+ { category: "content", substrings: ["content", "blog"] },
37
+ { category: "development", substrings: ["dev", "code", "refactor", "backlog", "implement"] },
38
+ { category: "testing", substrings: ["test", "debug", "bugfix"] },
39
+ { category: "documentation", substrings: ["doc", "readme"] },
40
+ { category: "version-control", substrings: ["git", "commit"], pattern: /^pr-|-pr-|-pr$/ },
41
+ { category: "devops", substrings: ["build", "deploy", "cicd"] },
42
+ { category: "security", substrings: ["auth", "security"] },
43
+ { category: "api", substrings: ["api", "route"] },
44
+ { category: "frontend", substrings: ["ui", "frontend", "design"] },
45
+ { category: "database", substrings: ["db", "database", "redis"] },
46
+ { category: "error-handling", substrings: ["error", "sentry", "bug"] },
47
+ // After domain-specific rows (pr-reviewer→version-control, security-audit→security).
48
+ { category: "review", substrings: ["review", "audit", "improv"] }
49
+ ];
50
+ function categorizeSkill(skillName) {
51
+ return matchCategory(skillName.toLowerCase(), SKILL_CATEGORY_RULES, "general");
52
+ }
53
+ var AGENT_CATEGORY_RULES = [
54
+ // agent-auditor is review, not security: it must precede the `audit` row.
55
+ { category: "review", substrings: ["review", "agent-auditor"] },
56
+ { category: "scraping", substrings: ["webscraping", "scraper", "scraping"] },
57
+ { category: "research", substrings: ["web-research"] },
58
+ { category: "error-handling", substrings: ["error", "resolver"] },
59
+ { category: "observability", substrings: ["quality-monitor", "telemetry", "observability", "splunk"] },
60
+ { category: "code", substrings: ["code", "refactor"] },
61
+ { category: "testing", substrings: ["test", "debug", "bugfix"] },
62
+ { category: "documentation", substrings: ["doc", "architecture"] },
63
+ { category: "security", substrings: ["security", "auth", "audit"] },
64
+ { category: "shell", substrings: ["bash", "shell"] },
65
+ { category: "cache", substrings: ["redis", "cache"] },
66
+ { category: "web", substrings: ["html", "seo"] },
67
+ { category: "exploration", substrings: ["explore", "research"] },
68
+ { category: "planning", substrings: ["plan"] },
69
+ { category: "design", substrings: ["ui", "ux", "design"] },
70
+ { category: "routing", substrings: ["route"] },
71
+ { category: "quality", substrings: ["typo", "spelling"] },
72
+ { category: "guidance", substrings: ["guide", "expert"] }
73
+ ];
74
+ function categorizeAgent(agentType) {
75
+ return matchCategory(agentType.toLowerCase(), AGENT_CATEGORY_RULES, "general");
76
+ }
77
+ function agentTypeLabels(agentType) {
78
+ return { [AGENT_ATTRS.TYPE]: agentType, [AGENT_ATTRS.CATEGORY]: categorizeAgent(agentType) };
79
+ }
80
+ var BUILTIN_TOOL_CATEGORY = new Map(
81
+ Object.entries(BUILTIN_TOOLS_BY_CATEGORY).flatMap(
82
+ ([category, tools]) => tools.map((tool) => [tool, category])
83
+ )
84
+ );
85
+ function categorizeBuiltinTool(toolName) {
86
+ return BUILTIN_TOOL_CATEGORY.get(toolName) ?? UNKNOWN_TOOL_CATEGORY;
87
+ }
88
+ function builtinToolLabels(toolName) {
89
+ return { [GENAI_TOOL_NAME_ATTR]: toolName, [TOOL_ATTRS.CATEGORY]: categorizeBuiltinTool(toolName) };
90
+ }
91
+ var ESCALATING_LEVEL = { ERROR: "error", WARNING: "warning" };
92
+ var FAILED_TASK_SUFFIX = " failed";
93
+ function classifyNotification(level, message) {
94
+ if (level === ESCALATING_LEVEL.ERROR || message.trimEnd().toLowerCase().endsWith(FAILED_TASK_SUFFIX)) return "error";
95
+ if (level === ESCALATING_LEVEL.WARNING) return "warning";
96
+ return "info";
97
+ }
98
+ var FILE_CATEGORY_RULES = [
99
+ { category: "hooks-handler", substrings: ["/hooks/handlers/"] },
100
+ { category: "hooks-lib", substrings: ["/hooks/lib/"] },
101
+ { category: "scripts", substrings: ["/scripts/"] }
102
+ ];
103
+ function getFileCategory(filePath) {
104
+ return matchCategory(filePath, FILE_CATEGORY_RULES, OTHER_LABEL);
105
+ }
106
+ var JS_TS_EXTENSIONS = [...TS_EXTENSIONS, ...JS_EXTENSIONS];
107
+ var JS_TS_FILE = fileExtensionPattern(JS_TS_EXTENSIONS);
108
+ var JS_TS_NON_SOURCE_FILE = new RegExp(`\\.(test|spec|config|d)\\.${alternation(JS_TS_EXTENSIONS)}$`);
109
+ function isJsTsFile(filePath) {
110
+ return JS_TS_FILE.test(filePath);
111
+ }
112
+ function isJsTsNonSourceFile(filePath) {
113
+ return JS_TS_NON_SOURCE_FILE.test(filePath);
114
+ }
115
+
116
+ export {
117
+ categorizeSkill,
118
+ agentTypeLabels,
119
+ builtinToolLabels,
120
+ classifyNotification,
121
+ getFileCategory,
122
+ isJsTsFile,
123
+ isJsTsNonSourceFile
124
+ };
125
+ //# sourceMappingURL=chunk-LBCZAYFR.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../lib/core/category-rules.ts", "../../../lib/runtime/categorizers.ts"],
4
+ "sourcesContent": ["/** First-match-wins rule tables. Imports nothing, so hot-path modules can use it. */\n\nexport interface CategoryRule<C extends string> {\n readonly category: C;\n /** Matches anywhere in the value. */\n readonly substrings: readonly string[];\n /** Anchored or positional shapes `substrings` cannot express. */\n readonly pattern?: RegExp;\n}\n\n/** First rule with a matching substring or pattern wins; `fallback` if none match. */\nexport function matchCategory<C extends string, F extends string>(\n value: string,\n rules: ReadonlyArray<CategoryRule<C>>,\n fallback: F,\n): C | F {\n for (const rule of rules) {\n if (rule.substrings.some(s => value.includes(s))) return rule.category;\n if (rule.pattern?.test(value)) return rule.category;\n }\n return fallback;\n}\n", "/**\n * Categorizers as ordered first-match-wins rule tables. `categorizeBuiltinTool`\n * is an exact-name lookup whose table is `BUILTIN_TOOLS_BY_CATEGORY` in\n * constants.ts, so membership and category cannot drift (CCH7).\n */\n\nimport { OTHER_LABEL } from '../core/bounded-label.js';\nimport { matchCategory, type CategoryRule } from '../core/category-rules.js';\nimport { BUILTIN_TOOLS_BY_CATEGORY, UNKNOWN_TOOL_CATEGORY } from '../core/constants.js';\nimport { JS_EXTENSIONS, TS_EXTENSIONS, alternation, fileExtensionPattern } from '../core/regex.js';\nimport { AGENT_ATTRS, GENAI_TOOL_NAME_ATTR, TOOL_ATTRS } from '../otel/attributes.js';\n\nconst SKILL_CATEGORY_RULES = [\n // otel-* before report/review.\n { category: 'observability', substrings: ['otel', 'telemetry', 'observ'] },\n { category: 'reporting', substrings: ['report', 'summary', 'dashboard'] },\n { category: 'content', substrings: ['content', 'blog'] },\n { category: 'development', substrings: ['dev', 'code', 'refactor', 'backlog', 'implement'] },\n { category: 'testing', substrings: ['test', 'debug', 'bugfix'] },\n { category: 'documentation', substrings: ['doc', 'readme'] },\n { category: 'version-control', substrings: ['git', 'commit'], pattern: /^pr-|-pr-|-pr$/ },\n { category: 'devops', substrings: ['build', 'deploy', 'cicd'] },\n { category: 'security', substrings: ['auth', 'security'] },\n { category: 'api', substrings: ['api', 'route'] },\n { category: 'frontend', substrings: ['ui', 'frontend', 'design'] },\n { category: 'database', substrings: ['db', 'database', 'redis'] },\n { category: 'error-handling', substrings: ['error', 'sentry', 'bug'] },\n // After domain-specific rows (pr-reviewer\u2192version-control, security-audit\u2192security).\n { category: 'review', substrings: ['review', 'audit', 'improv'] },\n] as const satisfies ReadonlyArray<CategoryRule<string>>;\n\ntype SkillCategory = (typeof SKILL_CATEGORY_RULES)[number]['category'] | 'general';\n\nexport function categorizeSkill(skillName: string): SkillCategory {\n return matchCategory(skillName.toLowerCase(), SKILL_CATEGORY_RULES, 'general');\n}\n\nconst AGENT_CATEGORY_RULES = [\n // agent-auditor is review, not security: it must precede the `audit` row.\n { category: 'review', substrings: ['review', 'agent-auditor'] },\n { category: 'scraping', substrings: ['webscraping', 'scraper', 'scraping'] },\n { category: 'research', substrings: ['web-research'] },\n { category: 'error-handling', substrings: ['error', 'resolver'] },\n { category: 'observability', substrings: ['quality-monitor', 'telemetry', 'observability', 'splunk'] },\n { category: 'code', substrings: ['code', 'refactor'] },\n { category: 'testing', substrings: ['test', 'debug', 'bugfix'] },\n { category: 'documentation', substrings: ['doc', 'architecture'] },\n { category: 'security', substrings: ['security', 'auth', 'audit'] },\n { category: 'shell', substrings: ['bash', 'shell'] },\n { category: 'cache', substrings: ['redis', 'cache'] },\n { category: 'web', substrings: ['html', 'seo'] },\n { category: 'exploration', substrings: ['explore', 'research'] },\n { category: 'planning', substrings: ['plan'] },\n { category: 'design', substrings: ['ui', 'ux', 'design'] },\n { category: 'routing', substrings: ['route'] },\n { category: 'quality', substrings: ['typo', 'spelling'] },\n { category: 'guidance', substrings: ['guide', 'expert'] },\n] as const satisfies ReadonlyArray<CategoryRule<string>>;\n\ntype AgentCategory = (typeof AGENT_CATEGORY_RULES)[number]['category'] | 'general';\n\nexport function categorizeAgent(agentType: string): AgentCategory {\n return matchCategory(agentType.toLowerCase(), AGENT_CATEGORY_RULES, 'general');\n}\n\nexport type AgentTypeLabels = Record<typeof AGENT_ATTRS.TYPE | typeof AGENT_ATTRS.CATEGORY, string>;\n\n/** Low-cardinality (registry name or `skill:<name>`), so safe as metric labels. */\nexport function agentTypeLabels(agentType: string): AgentTypeLabels {\n return { [AGENT_ATTRS.TYPE]: agentType, [AGENT_ATTRS.CATEGORY]: categorizeAgent(agentType) };\n}\n\ntype BuiltinToolCategory = keyof typeof BUILTIN_TOOLS_BY_CATEGORY | typeof UNKNOWN_TOOL_CATEGORY;\n\nconst BUILTIN_TOOL_CATEGORY = new Map<string, BuiltinToolCategory>(\n Object.entries(BUILTIN_TOOLS_BY_CATEGORY).flatMap(\n ([category, tools]) => tools.map(tool => [tool, category as BuiltinToolCategory] as const),\n ),\n);\n\nexport function categorizeBuiltinTool(toolName: string): BuiltinToolCategory {\n return BUILTIN_TOOL_CATEGORY.get(toolName) ?? UNKNOWN_TOOL_CATEGORY;\n}\n\n/** Name and category labels shared by the builtin pre- and post-tool series. */\nexport function builtinToolLabels(toolName: string): Record<typeof GENAI_TOOL_NAME_ATTR | typeof TOOL_ATTRS.CATEGORY, string> {\n return { [GENAI_TOOL_NAME_ATTR]: toolName, [TOOL_ATTRS.CATEGORY]: categorizeBuiltinTool(toolName) };\n}\n\ntype NotificationSeverity = 'error' | 'warning' | 'info';\n\n/** Notification `level` values that escalate on their own. */\nconst ESCALATING_LEVEL = { ERROR: 'error', WARNING: 'warning' } as const;\n\n/** How the harness titles a background task that ended in failure: `<task title> failed`. */\nconst FAILED_TASK_SUFFIX = ' failed';\n\n/**\n * Severity comes from `level`, plus the harness's failed-task title. The rest of a\n * message quotes session text (\"X needs your input: \u2026\"), so a keyword scan over it\n * turned prompts that mention an error into error notifications.\n */\nexport function classifyNotification(level: string, message: string): NotificationSeverity {\n if (level === ESCALATING_LEVEL.ERROR || message.trimEnd().toLowerCase().endsWith(FAILED_TASK_SUFFIX)) return 'error';\n if (level === ESCALATING_LEVEL.WARNING) return 'warning';\n return 'info';\n}\n\nconst FILE_CATEGORY_RULES = [\n { category: 'hooks-handler', substrings: ['/hooks/handlers/'] },\n { category: 'hooks-lib', substrings: ['/hooks/lib/'] },\n { category: 'scripts', substrings: ['/scripts/'] },\n] as const satisfies ReadonlyArray<CategoryRule<string>>;\n\nexport type FileCategory = (typeof FILE_CATEGORY_RULES)[number]['category'] | typeof OTHER_LABEL;\n\nexport function getFileCategory(filePath: string): FileCategory {\n return matchCategory(filePath, FILE_CATEGORY_RULES, OTHER_LABEL);\n}\n\nconst JS_TS_EXTENSIONS = [...TS_EXTENSIONS, ...JS_EXTENSIONS];\nconst JS_TS_FILE = fileExtensionPattern(JS_TS_EXTENSIONS);\n/** Tests, config and declaration files: JS/TS by extension, not hand-written source */\nconst JS_TS_NON_SOURCE_FILE = new RegExp(`\\\\.(test|spec|config|d)\\\\.${alternation(JS_TS_EXTENSIONS)}$`);\n\nexport function isJsTsFile(filePath: string): boolean {\n return JS_TS_FILE.test(filePath);\n}\n\nexport function isJsTsNonSourceFile(filePath: string): boolean {\n return JS_TS_NON_SOURCE_FILE.test(filePath);\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;;;;;AAWO,SAAS,cACd,OACA,OACA,UACO;AACP,aAAW,QAAQ,OAAO;AACxB,QAAI,KAAK,WAAW,KAAK,OAAK,MAAM,SAAS,CAAC,CAAC,EAAG,QAAO,KAAK;AAC9D,QAAI,KAAK,SAAS,KAAK,KAAK,EAAG,QAAO,KAAK;AAAA,EAC7C;AACA,SAAO;AACT;;;ACTA,IAAM,uBAAuB;AAAA;AAAA,EAE3B,EAAE,UAAU,iBAAiB,YAAY,CAAC,QAAQ,aAAa,QAAQ,EAAE;AAAA,EACzE,EAAE,UAAU,aAAa,YAAY,CAAC,UAAU,WAAW,WAAW,EAAE;AAAA,EACxE,EAAE,UAAU,WAAW,YAAY,CAAC,WAAW,MAAM,EAAE;AAAA,EACvD,EAAE,UAAU,eAAe,YAAY,CAAC,OAAO,QAAQ,YAAY,WAAW,WAAW,EAAE;AAAA,EAC3F,EAAE,UAAU,WAAW,YAAY,CAAC,QAAQ,SAAS,QAAQ,EAAE;AAAA,EAC/D,EAAE,UAAU,iBAAiB,YAAY,CAAC,OAAO,QAAQ,EAAE;AAAA,EAC3D,EAAE,UAAU,mBAAmB,YAAY,CAAC,OAAO,QAAQ,GAAG,SAAS,iBAAiB;AAAA,EACxF,EAAE,UAAU,UAAU,YAAY,CAAC,SAAS,UAAU,MAAM,EAAE;AAAA,EAC9D,EAAE,UAAU,YAAY,YAAY,CAAC,QAAQ,UAAU,EAAE;AAAA,EACzD,EAAE,UAAU,OAAO,YAAY,CAAC,OAAO,OAAO,EAAE;AAAA,EAChD,EAAE,UAAU,YAAY,YAAY,CAAC,MAAM,YAAY,QAAQ,EAAE;AAAA,EACjE,EAAE,UAAU,YAAY,YAAY,CAAC,MAAM,YAAY,OAAO,EAAE;AAAA,EAChE,EAAE,UAAU,kBAAkB,YAAY,CAAC,SAAS,UAAU,KAAK,EAAE;AAAA;AAAA,EAErE,EAAE,UAAU,UAAU,YAAY,CAAC,UAAU,SAAS,QAAQ,EAAE;AAClE;AAIO,SAAS,gBAAgB,WAAkC;AAChE,SAAO,cAAc,UAAU,YAAY,GAAG,sBAAsB,SAAS;AAC/E;AAEA,IAAM,uBAAuB;AAAA;AAAA,EAE3B,EAAE,UAAU,UAAU,YAAY,CAAC,UAAU,eAAe,EAAE;AAAA,EAC9D,EAAE,UAAU,YAAY,YAAY,CAAC,eAAe,WAAW,UAAU,EAAE;AAAA,EAC3E,EAAE,UAAU,YAAY,YAAY,CAAC,cAAc,EAAE;AAAA,EACrD,EAAE,UAAU,kBAAkB,YAAY,CAAC,SAAS,UAAU,EAAE;AAAA,EAChE,EAAE,UAAU,iBAAiB,YAAY,CAAC,mBAAmB,aAAa,iBAAiB,QAAQ,EAAE;AAAA,EACrG,EAAE,UAAU,QAAQ,YAAY,CAAC,QAAQ,UAAU,EAAE;AAAA,EACrD,EAAE,UAAU,WAAW,YAAY,CAAC,QAAQ,SAAS,QAAQ,EAAE;AAAA,EAC/D,EAAE,UAAU,iBAAiB,YAAY,CAAC,OAAO,cAAc,EAAE;AAAA,EACjE,EAAE,UAAU,YAAY,YAAY,CAAC,YAAY,QAAQ,OAAO,EAAE;AAAA,EAClE,EAAE,UAAU,SAAS,YAAY,CAAC,QAAQ,OAAO,EAAE;AAAA,EACnD,EAAE,UAAU,SAAS,YAAY,CAAC,SAAS,OAAO,EAAE;AAAA,EACpD,EAAE,UAAU,OAAO,YAAY,CAAC,QAAQ,KAAK,EAAE;AAAA,EAC/C,EAAE,UAAU,eAAe,YAAY,CAAC,WAAW,UAAU,EAAE;AAAA,EAC/D,EAAE,UAAU,YAAY,YAAY,CAAC,MAAM,EAAE;AAAA,EAC7C,EAAE,UAAU,UAAU,YAAY,CAAC,MAAM,MAAM,QAAQ,EAAE;AAAA,EACzD,EAAE,UAAU,WAAW,YAAY,CAAC,OAAO,EAAE;AAAA,EAC7C,EAAE,UAAU,WAAW,YAAY,CAAC,QAAQ,UAAU,EAAE;AAAA,EACxD,EAAE,UAAU,YAAY,YAAY,CAAC,SAAS,QAAQ,EAAE;AAC1D;AAIO,SAAS,gBAAgB,WAAkC;AAChE,SAAO,cAAc,UAAU,YAAY,GAAG,sBAAsB,SAAS;AAC/E;AAKO,SAAS,gBAAgB,WAAoC;AAClE,SAAO,EAAE,CAAC,YAAY,IAAI,GAAG,WAAW,CAAC,YAAY,QAAQ,GAAG,gBAAgB,SAAS,EAAE;AAC7F;AAIA,IAAM,wBAAwB,IAAI;AAAA,EAChC,OAAO,QAAQ,yBAAyB,EAAE;AAAA,IACxC,CAAC,CAAC,UAAU,KAAK,MAAM,MAAM,IAAI,UAAQ,CAAC,MAAM,QAA+B,CAAU;AAAA,EAC3F;AACF;AAEO,SAAS,sBAAsB,UAAuC;AAC3E,SAAO,sBAAsB,IAAI,QAAQ,KAAK;AAChD;AAGO,SAAS,kBAAkB,UAA4F;AAC5H,SAAO,EAAE,CAAC,oBAAoB,GAAG,UAAU,CAAC,WAAW,QAAQ,GAAG,sBAAsB,QAAQ,EAAE;AACpG;AAKA,IAAM,mBAAmB,EAAE,OAAO,SAAS,SAAS,UAAU;AAG9D,IAAM,qBAAqB;AAOpB,SAAS,qBAAqB,OAAe,SAAuC;AACzF,MAAI,UAAU,iBAAiB,SAAS,QAAQ,QAAQ,EAAE,YAAY,EAAE,SAAS,kBAAkB,EAAG,QAAO;AAC7G,MAAI,UAAU,iBAAiB,QAAS,QAAO;AAC/C,SAAO;AACT;AAEA,IAAM,sBAAsB;AAAA,EAC1B,EAAE,UAAU,iBAAiB,YAAY,CAAC,kBAAkB,EAAE;AAAA,EAC9D,EAAE,UAAU,aAAa,YAAY,CAAC,aAAa,EAAE;AAAA,EACrD,EAAE,UAAU,WAAW,YAAY,CAAC,WAAW,EAAE;AACnD;AAIO,SAAS,gBAAgB,UAAgC;AAC9D,SAAO,cAAc,UAAU,qBAAqB,WAAW;AACjE;AAEA,IAAM,mBAAmB,CAAC,GAAG,eAAe,GAAG,aAAa;AAC5D,IAAM,aAAa,qBAAqB,gBAAgB;AAExD,IAAM,wBAAwB,IAAI,OAAO,6BAA6B,YAAY,gBAAgB,CAAC,GAAG;AAE/F,SAAS,WAAW,UAA2B;AACpD,SAAO,WAAW,KAAK,QAAQ;AACjC;AAEO,SAAS,oBAAoB,UAA2B;AAC7D,SAAO,sBAAsB,KAAK,QAAQ;AAC5C;",
6
+ "names": []
7
+ }
@@ -0,0 +1,41 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ AGENT_FILE_PREFIX,
5
+ projectDirPaths,
6
+ subagentsDir
7
+ } from "./chunk-LQ2LGUYJ.js";
8
+ import {
9
+ CLAUDE_HOME,
10
+ loadJson
11
+ } from "./chunk-52RY6LQT.js";
12
+
13
+ // lib/session/forked-skill.ts
14
+ import { dirname, join } from "node:path";
15
+ var SKILL_AGENT_PREFIX = "skill:";
16
+ var FORKED_SKILL_SUFFIX = ".forked-skill.json";
17
+ function readForkedSkillName(agentsDir, agentId) {
18
+ const skillName = loadJson(
19
+ join(agentsDir, `${AGENT_FILE_PREFIX}${agentId}${FORKED_SKILL_SUFFIX}`)
20
+ )?.skillName;
21
+ return typeof skillName === "string" && skillName ? skillName : void 0;
22
+ }
23
+ function forkedSkillName(sessionId, agentId, transcriptPath, home) {
24
+ const dirs = transcriptPath ? [dirname(transcriptPath)] : projectDirPaths(home);
25
+ for (const dir of dirs) {
26
+ const skillName = readForkedSkillName(subagentsDir(dir, sessionId), agentId);
27
+ if (skillName) return skillName;
28
+ }
29
+ return void 0;
30
+ }
31
+ function resolveAgentName(input, home = CLAUDE_HOME) {
32
+ const { agent_type: agentType, agent_id: agentId, session_id: sessionId, transcript_path: transcriptPath } = input;
33
+ if (!agentType) return void 0;
34
+ const skill = agentId && sessionId ? forkedSkillName(sessionId, agentId, transcriptPath, home) : void 0;
35
+ return skill ? `${SKILL_AGENT_PREFIX}${skill}` : agentType;
36
+ }
37
+
38
+ export {
39
+ resolveAgentName
40
+ };
41
+ //# sourceMappingURL=chunk-LHWRXY2G.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../lib/session/forked-skill.ts"],
4
+ "sourcesContent": ["/**\n * Forked-skill attribution (CSV1). A forked skill runs as `general-purpose`, so\n * `agent_type` alone cannot tell it from a plain subagent; the skill name comes\n * from the `subagents/agent-<id>.forked-skill.json` record Claude Code writes at\n * spawn, beside the session transcript.\n */\n\nimport { dirname, join } from 'node:path';\n\nimport { CLAUDE_HOME } from '../core/constants.js';\nimport { loadJson } from '../core/file-utils.js';\nimport type { HookInput } from '../runtime/hook-input.js';\nimport { AGENT_FILE_PREFIX, projectDirPaths, subagentsDir } from '../transcript/transcript-layout.js';\n\n/** Agent-name prefix for a forked skill, so a skill never collides with a same-named agent. */\nconst SKILL_AGENT_PREFIX = 'skill:';\nexport const FORKED_SKILL_SUFFIX = '.forked-skill.json';\n\n/** The fields that identify a subagent; every hook event that runs inside one carries them. */\nexport type AgentIdentityInput = Pick<HookInput, 'agent_type' | 'agent_id' | 'session_id' | 'transcript_path'>;\n\n/** The skill an agent in `agentsDir` was forked for; undefined for a missing, torn or foreign record. */\nexport function readForkedSkillName(agentsDir: string, agentId: string): string | undefined {\n const skillName = loadJson<{ skillName?: unknown }>(\n join(agentsDir, `${AGENT_FILE_PREFIX}${agentId}${FORKED_SKILL_SUFFIX}`),\n )?.skillName;\n return typeof skillName === 'string' && skillName ? skillName : undefined;\n}\n\nfunction forkedSkillName(sessionId: string, agentId: string, transcriptPath: string | undefined, home: string): string | undefined {\n const dirs = transcriptPath ? [dirname(transcriptPath)] : projectDirPaths(home);\n for (const dir of dirs) {\n const skillName = readForkedSkillName(subagentsDir(dir, sessionId), agentId);\n if (skillName) return skillName;\n }\n return undefined;\n}\n\n/**\n * The name a subagent is attributed to: `skill:<name>` for a forked skill, else\n * its agent type; undefined on the main loop. With no transcript path, every\n * project directory is searched.\n */\nexport function resolveAgentName(input: AgentIdentityInput, home: string = CLAUDE_HOME): string | undefined {\n const { agent_type: agentType, agent_id: agentId, session_id: sessionId, transcript_path: transcriptPath } = input;\n if (!agentType) return undefined;\n const skill = agentId && sessionId ? forkedSkillName(sessionId, agentId, transcriptPath, home) : undefined;\n return skill ? `${SKILL_AGENT_PREFIX}${skill}` : agentType;\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;AAOA,SAAS,SAAS,YAAY;AAQ9B,IAAM,qBAAqB;AACpB,IAAM,sBAAsB;AAM5B,SAAS,oBAAoB,WAAmB,SAAqC;AAC1F,QAAM,YAAY;AAAA,IAChB,KAAK,WAAW,GAAG,iBAAiB,GAAG,OAAO,GAAG,mBAAmB,EAAE;AAAA,EACxE,GAAG;AACH,SAAO,OAAO,cAAc,YAAY,YAAY,YAAY;AAClE;AAEA,SAAS,gBAAgB,WAAmB,SAAiB,gBAAoC,MAAkC;AACjI,QAAM,OAAO,iBAAiB,CAAC,QAAQ,cAAc,CAAC,IAAI,gBAAgB,IAAI;AAC9E,aAAW,OAAO,MAAM;AACtB,UAAM,YAAY,oBAAoB,aAAa,KAAK,SAAS,GAAG,OAAO;AAC3E,QAAI,UAAW,QAAO;AAAA,EACxB;AACA,SAAO;AACT;AAOO,SAAS,iBAAiB,OAA2B,OAAe,aAAiC;AAC1G,QAAM,EAAE,YAAY,WAAW,UAAU,SAAS,YAAY,WAAW,iBAAiB,eAAe,IAAI;AAC7G,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,QAAQ,WAAW,YAAY,gBAAgB,WAAW,SAAS,gBAAgB,IAAI,IAAI;AACjG,SAAO,QAAQ,GAAG,kBAAkB,GAAG,KAAK,KAAK;AACnD;",
6
+ "names": []
7
+ }
@@ -0,0 +1,41 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ SESSION_ID_PATTERN
5
+ } from "./chunk-YHYDBLVB.js";
6
+ import {
7
+ CLAUDE_HOME,
8
+ readdirOrEmpty
9
+ } from "./chunk-52RY6LQT.js";
10
+
11
+ // lib/transcript/transcript-layout.ts
12
+ import { existsSync } from "node:fs";
13
+ import { join } from "node:path";
14
+ function projectsDir(home = CLAUDE_HOME) {
15
+ return join(home, "projects");
16
+ }
17
+ function projectDirPaths(home = CLAUDE_HOME) {
18
+ const root = projectsDir(home);
19
+ return readdirOrEmpty(root).map((project) => join(root, project));
20
+ }
21
+ var SUBAGENTS_DIR = "subagents";
22
+ var AGENT_FILE_PREFIX = "agent-";
23
+ function subagentsDir(projectDir, sessionId) {
24
+ return join(projectDir, sessionId, SUBAGENTS_DIR);
25
+ }
26
+ function findTranscriptPath(sessionId, home = CLAUDE_HOME) {
27
+ if (!SESSION_ID_PATTERN.test(sessionId)) return void 0;
28
+ for (const dir of projectDirPaths(home)) {
29
+ const candidate = join(dir, `${sessionId}.jsonl`);
30
+ if (existsSync(candidate)) return candidate;
31
+ }
32
+ return void 0;
33
+ }
34
+
35
+ export {
36
+ projectDirPaths,
37
+ AGENT_FILE_PREFIX,
38
+ subagentsDir,
39
+ findTranscriptPath
40
+ };
41
+ //# sourceMappingURL=chunk-LQ2LGUYJ.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../lib/transcript/transcript-layout.ts"],
4
+ "sourcesContent": ["/**\n * Where Claude Code keeps a session's transcript: `projects/{slug}/{session-id}.jsonl`.\n * Deliberately exports no cwd-to-slug encoder: the slug algorithm is Claude Code's\n * private detail (`/` and `.` both map to `-`). Scanning for the session id is\n * verified truth. Prefer the payload's `transcript_path`.\n */\n\nimport { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { CLAUDE_HOME } from '../core/constants.js';\nimport { readdirOrEmpty } from '../core/file-utils.js';\nimport { SESSION_ID_PATTERN } from '../core/regex.js';\n\n/** Root holding one directory per project. */\nexport function projectsDir(home: string = CLAUDE_HOME): string {\n return join(home, 'projects');\n}\n\n/** Every project directory under {@link projectsDir}; empty when the root is missing. */\nexport function projectDirPaths(home: string = CLAUDE_HOME): string[] {\n const root = projectsDir(home);\n return readdirOrEmpty(root).map(project => join(root, project));\n}\n\nconst SUBAGENTS_DIR = 'subagents';\n/** Prefix of every per-agent file in {@link subagentsDir}: `agent-<id>.jsonl`, `.meta.json`, `.forked-skill.json`. */\nexport const AGENT_FILE_PREFIX = 'agent-';\n\n/** Where Claude Code writes a session's subagent files, beside its transcript in `projectDir`. */\nexport function subagentsDir(projectDir: string, sessionId: string): string {\n return join(projectDir, sessionId, SUBAGENTS_DIR);\n}\n\n/** Locate the transcript by scanning project directories; undefined when malformed or absent. */\nexport function findTranscriptPath(sessionId: string, home: string = CLAUDE_HOME): string | undefined {\n // Validate before the path join (path traversal).\n if (!SESSION_ID_PATTERN.test(sessionId)) return undefined;\n\n for (const dir of projectDirPaths(home)) {\n const candidate = join(dir, `${sessionId}.jsonl`);\n if (existsSync(candidate)) return candidate;\n }\n return undefined;\n}\n"],
5
+ "mappings": ";;;;;;;;;;;AAOA,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AAMd,SAAS,YAAY,OAAe,aAAqB;AAC9D,SAAO,KAAK,MAAM,UAAU;AAC9B;AAGO,SAAS,gBAAgB,OAAe,aAAuB;AACpE,QAAM,OAAO,YAAY,IAAI;AAC7B,SAAO,eAAe,IAAI,EAAE,IAAI,aAAW,KAAK,MAAM,OAAO,CAAC;AAChE;AAEA,IAAM,gBAAgB;AAEf,IAAM,oBAAoB;AAG1B,SAAS,aAAa,YAAoB,WAA2B;AAC1E,SAAO,KAAK,YAAY,WAAW,aAAa;AAClD;AAGO,SAAS,mBAAmB,WAAmB,OAAe,aAAiC;AAEpG,MAAI,CAAC,mBAAmB,KAAK,SAAS,EAAG,QAAO;AAEhD,aAAW,OAAO,gBAAgB,IAAI,GAAG;AACvC,UAAM,YAAY,KAAK,KAAK,GAAG,SAAS,QAAQ;AAChD,QAAI,WAAW,SAAS,EAAG,QAAO;AAAA,EACpC;AACA,SAAO;AACT;",
6
+ "names": []
7
+ }