@punch-bot/agent 0.85.1 → 1.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 (367) hide show
  1. package/README.md +87 -40
  2. package/dist/agent-loop.d.ts +27 -2
  3. package/dist/agent-loop.d.ts.map +1 -1
  4. package/dist/agent-loop.js +154 -39
  5. package/dist/agent-loop.js.map +1 -1
  6. package/dist/agent.d.ts +21 -6
  7. package/dist/agent.d.ts.map +1 -1
  8. package/dist/agent.js +38 -23
  9. package/dist/agent.js.map +1 -1
  10. package/dist/index.d.ts +0 -22
  11. package/dist/index.d.ts.map +1 -1
  12. package/dist/index.js +0 -20
  13. package/dist/index.js.map +1 -1
  14. package/dist/proxy.d.ts +2 -5
  15. package/dist/proxy.d.ts.map +1 -1
  16. package/dist/proxy.js +2 -14
  17. package/dist/proxy.js.map +1 -1
  18. package/dist/stream-fn.d.ts.map +1 -1
  19. package/dist/stream-fn.js.map +1 -1
  20. package/dist/types.d.ts +108 -31
  21. package/dist/types.d.ts.map +1 -1
  22. package/dist/types.js.map +1 -1
  23. package/package.json +4 -43
  24. package/dist/harness/agent-harness.d.ts +0 -716
  25. package/dist/harness/agent-harness.d.ts.map +0 -1
  26. package/dist/harness/agent-harness.js +0 -6
  27. package/dist/harness/agent-harness.js.map +0 -1
  28. package/dist/harness/compaction/branch-summarization.d.ts +0 -68
  29. package/dist/harness/compaction/branch-summarization.d.ts.map +0 -1
  30. package/dist/harness/compaction/branch-summarization.js +0 -176
  31. package/dist/harness/compaction/branch-summarization.js.map +0 -1
  32. package/dist/harness/compaction/compaction.d.ts +0 -126
  33. package/dist/harness/compaction/compaction.d.ts.map +0 -1
  34. package/dist/harness/compaction/compaction.js +0 -560
  35. package/dist/harness/compaction/compaction.js.map +0 -1
  36. package/dist/harness/compaction/utils.d.ts +0 -25
  37. package/dist/harness/compaction/utils.d.ts.map +0 -1
  38. package/dist/harness/compaction/utils.js +0 -120
  39. package/dist/harness/compaction/utils.js.map +0 -1
  40. package/dist/harness/config.d.ts +0 -9
  41. package/dist/harness/config.d.ts.map +0 -1
  42. package/dist/harness/config.js +0 -35
  43. package/dist/harness/config.js.map +0 -1
  44. package/dist/harness/context.d.ts +0 -9
  45. package/dist/harness/context.d.ts.map +0 -1
  46. package/dist/harness/context.js +0 -13
  47. package/dist/harness/context.js.map +0 -1
  48. package/dist/harness/env/nodejs.d.ts +0 -43
  49. package/dist/harness/env/nodejs.d.ts.map +0 -1
  50. package/dist/harness/env/nodejs.js +0 -865
  51. package/dist/harness/env/nodejs.js.map +0 -1
  52. package/dist/harness/events.d.ts +0 -25
  53. package/dist/harness/events.d.ts.map +0 -1
  54. package/dist/harness/events.js +0 -250
  55. package/dist/harness/events.js.map +0 -1
  56. package/dist/harness/execution/assistant.d.ts +0 -42
  57. package/dist/harness/execution/assistant.d.ts.map +0 -1
  58. package/dist/harness/execution/assistant.js +0 -82
  59. package/dist/harness/execution/assistant.js.map +0 -1
  60. package/dist/harness/execution/effect-gate.d.ts +0 -22
  61. package/dist/harness/execution/effect-gate.d.ts.map +0 -1
  62. package/dist/harness/execution/effect-gate.js +0 -49
  63. package/dist/harness/execution/effect-gate.js.map +0 -1
  64. package/dist/harness/execution/tools.d.ts +0 -67
  65. package/dist/harness/execution/tools.d.ts.map +0 -1
  66. package/dist/harness/execution/tools.js +0 -121
  67. package/dist/harness/execution/tools.js.map +0 -1
  68. package/dist/harness/hooks.d.ts +0 -38
  69. package/dist/harness/hooks.d.ts.map +0 -1
  70. package/dist/harness/hooks.js +0 -406
  71. package/dist/harness/hooks.js.map +0 -1
  72. package/dist/harness/messages.d.ts +0 -51
  73. package/dist/harness/messages.d.ts.map +0 -1
  74. package/dist/harness/messages.js +0 -102
  75. package/dist/harness/messages.js.map +0 -1
  76. package/dist/harness/prompt-templates.d.ts +0 -49
  77. package/dist/harness/prompt-templates.d.ts.map +0 -1
  78. package/dist/harness/prompt-templates.js +0 -225
  79. package/dist/harness/prompt-templates.js.map +0 -1
  80. package/dist/harness/result.d.ts +0 -133
  81. package/dist/harness/result.d.ts.map +0 -1
  82. package/dist/harness/result.js +0 -81
  83. package/dist/harness/result.js.map +0 -1
  84. package/dist/harness/runtime/drive/boundary.d.ts +0 -28
  85. package/dist/harness/runtime/drive/boundary.d.ts.map +0 -1
  86. package/dist/harness/runtime/drive/boundary.js +0 -173
  87. package/dist/harness/runtime/drive/boundary.js.map +0 -1
  88. package/dist/harness/runtime/drive/checkpoint.d.ts +0 -8
  89. package/dist/harness/runtime/drive/checkpoint.d.ts.map +0 -1
  90. package/dist/harness/runtime/drive/checkpoint.js +0 -133
  91. package/dist/harness/runtime/drive/checkpoint.js.map +0 -1
  92. package/dist/harness/runtime/drive/deferred.d.ts +0 -15
  93. package/dist/harness/runtime/drive/deferred.d.ts.map +0 -1
  94. package/dist/harness/runtime/drive/deferred.js +0 -179
  95. package/dist/harness/runtime/drive/deferred.js.map +0 -1
  96. package/dist/harness/runtime/drive/generation.d.ts +0 -8
  97. package/dist/harness/runtime/drive/generation.d.ts.map +0 -1
  98. package/dist/harness/runtime/drive/generation.js +0 -205
  99. package/dist/harness/runtime/drive/generation.js.map +0 -1
  100. package/dist/harness/runtime/drive/reconcile.d.ts +0 -5
  101. package/dist/harness/runtime/drive/reconcile.d.ts.map +0 -1
  102. package/dist/harness/runtime/drive/reconcile.js +0 -140
  103. package/dist/harness/runtime/drive/reconcile.js.map +0 -1
  104. package/dist/harness/runtime/drive/recovery.d.ts +0 -8
  105. package/dist/harness/runtime/drive/recovery.d.ts.map +0 -1
  106. package/dist/harness/runtime/drive/recovery.js +0 -85
  107. package/dist/harness/runtime/drive/recovery.js.map +0 -1
  108. package/dist/harness/runtime/drive/response.d.ts +0 -23
  109. package/dist/harness/runtime/drive/response.d.ts.map +0 -1
  110. package/dist/harness/runtime/drive/response.js +0 -394
  111. package/dist/harness/runtime/drive/response.js.map +0 -1
  112. package/dist/harness/runtime/drive/retry.d.ts +0 -4
  113. package/dist/harness/runtime/drive/retry.d.ts.map +0 -1
  114. package/dist/harness/runtime/drive/retry.js +0 -34
  115. package/dist/harness/runtime/drive/retry.js.map +0 -1
  116. package/dist/harness/runtime/drive/structural.d.ts +0 -32
  117. package/dist/harness/runtime/drive/structural.d.ts.map +0 -1
  118. package/dist/harness/runtime/drive/structural.js +0 -929
  119. package/dist/harness/runtime/drive/structural.js.map +0 -1
  120. package/dist/harness/runtime/drive/terminal.d.ts +0 -7
  121. package/dist/harness/runtime/drive/terminal.d.ts.map +0 -1
  122. package/dist/harness/runtime/drive/terminal.js +0 -49
  123. package/dist/harness/runtime/drive/terminal.js.map +0 -1
  124. package/dist/harness/runtime/drive/tool-placement.d.ts +0 -14
  125. package/dist/harness/runtime/drive/tool-placement.d.ts.map +0 -1
  126. package/dist/harness/runtime/drive/tool-placement.js +0 -244
  127. package/dist/harness/runtime/drive/tool-placement.js.map +0 -1
  128. package/dist/harness/runtime/drive/tools.d.ts +0 -6
  129. package/dist/harness/runtime/drive/tools.d.ts.map +0 -1
  130. package/dist/harness/runtime/drive/tools.js +0 -449
  131. package/dist/harness/runtime/drive/tools.js.map +0 -1
  132. package/dist/harness/runtime/drive.d.ts +0 -6
  133. package/dist/harness/runtime/drive.d.ts.map +0 -1
  134. package/dist/harness/runtime/drive.js +0 -93
  135. package/dist/harness/runtime/drive.js.map +0 -1
  136. package/dist/harness/runtime/harness.d.ts +0 -59
  137. package/dist/harness/runtime/harness.d.ts.map +0 -1
  138. package/dist/harness/runtime/harness.js +0 -311
  139. package/dist/harness/runtime/harness.js.map +0 -1
  140. package/dist/harness/runtime/index.d.ts +0 -2
  141. package/dist/harness/runtime/index.d.ts.map +0 -1
  142. package/dist/harness/runtime/index.js +0 -2
  143. package/dist/harness/runtime/index.js.map +0 -1
  144. package/dist/harness/runtime/lane.d.ts +0 -101
  145. package/dist/harness/runtime/lane.d.ts.map +0 -1
  146. package/dist/harness/runtime/lane.js +0 -1575
  147. package/dist/harness/runtime/lane.js.map +0 -1
  148. package/dist/harness/runtime/progress.d.ts +0 -15
  149. package/dist/harness/runtime/progress.d.ts.map +0 -1
  150. package/dist/harness/runtime/progress.js +0 -66
  151. package/dist/harness/runtime/progress.js.map +0 -1
  152. package/dist/harness/runtime/reducer.d.ts +0 -5
  153. package/dist/harness/runtime/reducer.d.ts.map +0 -1
  154. package/dist/harness/runtime/reducer.js +0 -240
  155. package/dist/harness/runtime/reducer.js.map +0 -1
  156. package/dist/harness/runtime/restore.d.ts +0 -24
  157. package/dist/harness/runtime/restore.d.ts.map +0 -1
  158. package/dist/harness/runtime/restore.js +0 -117
  159. package/dist/harness/runtime/restore.js.map +0 -1
  160. package/dist/harness/runtime/transcript.d.ts +0 -21
  161. package/dist/harness/runtime/transcript.d.ts.map +0 -1
  162. package/dist/harness/runtime/transcript.js +0 -72
  163. package/dist/harness/runtime/transcript.js.map +0 -1
  164. package/dist/harness/runtime/types.d.ts +0 -105
  165. package/dist/harness/runtime/types.d.ts.map +0 -1
  166. package/dist/harness/runtime/types.js +0 -61
  167. package/dist/harness/runtime/types.js.map +0 -1
  168. package/dist/harness/session/commit.d.ts +0 -53
  169. package/dist/harness/session/commit.d.ts.map +0 -1
  170. package/dist/harness/session/commit.js +0 -57
  171. package/dist/harness/session/commit.js.map +0 -1
  172. package/dist/harness/session/context.d.ts +0 -10
  173. package/dist/harness/session/context.d.ts.map +0 -1
  174. package/dist/harness/session/context.js +0 -49
  175. package/dist/harness/session/context.js.map +0 -1
  176. package/dist/harness/session/fork-policy.d.ts +0 -21
  177. package/dist/harness/session/fork-policy.d.ts.map +0 -1
  178. package/dist/harness/session/fork-policy.js +0 -55
  179. package/dist/harness/session/fork-policy.js.map +0 -1
  180. package/dist/harness/session/fork.d.ts +0 -16
  181. package/dist/harness/session/fork.d.ts.map +0 -1
  182. package/dist/harness/session/fork.js +0 -79
  183. package/dist/harness/session/fork.js.map +0 -1
  184. package/dist/harness/session/in-memory-storage-state.d.ts +0 -39
  185. package/dist/harness/session/in-memory-storage-state.d.ts.map +0 -1
  186. package/dist/harness/session/in-memory-storage-state.js +0 -276
  187. package/dist/harness/session/in-memory-storage-state.js.map +0 -1
  188. package/dist/harness/session/index.d.ts +0 -11
  189. package/dist/harness/session/index.d.ts.map +0 -1
  190. package/dist/harness/session/index.js +0 -9
  191. package/dist/harness/session/index.js.map +0 -1
  192. package/dist/harness/session/jsonl/codec.d.ts +0 -21
  193. package/dist/harness/session/jsonl/codec.d.ts.map +0 -1
  194. package/dist/harness/session/jsonl/codec.js +0 -45
  195. package/dist/harness/session/jsonl/codec.js.map +0 -1
  196. package/dist/harness/session/jsonl/fork.d.ts +0 -38
  197. package/dist/harness/session/jsonl/fork.d.ts.map +0 -1
  198. package/dist/harness/session/jsonl/fork.js +0 -264
  199. package/dist/harness/session/jsonl/fork.js.map +0 -1
  200. package/dist/harness/session/jsonl/index.d.ts +0 -4
  201. package/dist/harness/session/jsonl/index.d.ts.map +0 -1
  202. package/dist/harness/session/jsonl/index.js +0 -4
  203. package/dist/harness/session/jsonl/index.js.map +0 -1
  204. package/dist/harness/session/jsonl/io.d.ts +0 -14
  205. package/dist/harness/session/jsonl/io.d.ts.map +0 -1
  206. package/dist/harness/session/jsonl/io.js +0 -86
  207. package/dist/harness/session/jsonl/io.js.map +0 -1
  208. package/dist/harness/session/jsonl/legacy-v3.d.ts +0 -43
  209. package/dist/harness/session/jsonl/legacy-v3.d.ts.map +0 -1
  210. package/dist/harness/session/jsonl/legacy-v3.js +0 -462
  211. package/dist/harness/session/jsonl/legacy-v3.js.map +0 -1
  212. package/dist/harness/session/jsonl/repo.d.ts +0 -35
  213. package/dist/harness/session/jsonl/repo.d.ts.map +0 -1
  214. package/dist/harness/session/jsonl/repo.js +0 -301
  215. package/dist/harness/session/jsonl/repo.js.map +0 -1
  216. package/dist/harness/session/jsonl/storage.d.ts +0 -40
  217. package/dist/harness/session/jsonl/storage.d.ts.map +0 -1
  218. package/dist/harness/session/jsonl/storage.js +0 -200
  219. package/dist/harness/session/jsonl/storage.js.map +0 -1
  220. package/dist/harness/session/jsonl/types.d.ts +0 -39
  221. package/dist/harness/session/jsonl/types.d.ts.map +0 -1
  222. package/dist/harness/session/jsonl/types.js +0 -3
  223. package/dist/harness/session/jsonl/types.js.map +0 -1
  224. package/dist/harness/session/memory.d.ts +0 -48
  225. package/dist/harness/session/memory.d.ts.map +0 -1
  226. package/dist/harness/session/memory.js +0 -369
  227. package/dist/harness/session/memory.js.map +0 -1
  228. package/dist/harness/session/mutation-line.d.ts +0 -8
  229. package/dist/harness/session/mutation-line.d.ts.map +0 -1
  230. package/dist/harness/session/mutation-line.js +0 -21
  231. package/dist/harness/session/mutation-line.js.map +0 -1
  232. package/dist/harness/session/session.d.ts +0 -82
  233. package/dist/harness/session/session.d.ts.map +0 -1
  234. package/dist/harness/session/session.js +0 -361
  235. package/dist/harness/session/session.js.map +0 -1
  236. package/dist/harness/session/testing/benchmark/datasets.d.ts +0 -12
  237. package/dist/harness/session/testing/benchmark/datasets.d.ts.map +0 -1
  238. package/dist/harness/session/testing/benchmark/datasets.js +0 -24
  239. package/dist/harness/session/testing/benchmark/datasets.js.map +0 -1
  240. package/dist/harness/session/testing/benchmark/session-repo.d.ts +0 -42
  241. package/dist/harness/session/testing/benchmark/session-repo.d.ts.map +0 -1
  242. package/dist/harness/session/testing/benchmark/session-repo.js +0 -127
  243. package/dist/harness/session/testing/benchmark/session-repo.js.map +0 -1
  244. package/dist/harness/session/testing/benchmark/storage.d.ts +0 -25
  245. package/dist/harness/session/testing/benchmark/storage.d.ts.map +0 -1
  246. package/dist/harness/session/testing/benchmark/storage.js +0 -114
  247. package/dist/harness/session/testing/benchmark/storage.js.map +0 -1
  248. package/dist/harness/session/testing/conformance/session-repo.d.ts +0 -23
  249. package/dist/harness/session/testing/conformance/session-repo.d.ts.map +0 -1
  250. package/dist/harness/session/testing/conformance/session-repo.js +0 -809
  251. package/dist/harness/session/testing/conformance/session-repo.js.map +0 -1
  252. package/dist/harness/session/testing/conformance/storage.d.ts +0 -4
  253. package/dist/harness/session/testing/conformance/storage.d.ts.map +0 -1
  254. package/dist/harness/session/testing/conformance/storage.js +0 -600
  255. package/dist/harness/session/testing/conformance/storage.js.map +0 -1
  256. package/dist/harness/session/testing/gating-storage.d.ts +0 -26
  257. package/dist/harness/session/testing/gating-storage.d.ts.map +0 -1
  258. package/dist/harness/session/testing/gating-storage.js +0 -100
  259. package/dist/harness/session/testing/gating-storage.js.map +0 -1
  260. package/dist/harness/session/testing/index.d.ts +0 -10
  261. package/dist/harness/session/testing/index.d.ts.map +0 -1
  262. package/dist/harness/session/testing/index.js +0 -9
  263. package/dist/harness/session/testing/index.js.map +0 -1
  264. package/dist/harness/session/testing/instrumented-storage.d.ts +0 -11
  265. package/dist/harness/session/testing/instrumented-storage.d.ts.map +0 -1
  266. package/dist/harness/session/testing/instrumented-storage.js +0 -16
  267. package/dist/harness/session/testing/instrumented-storage.js.map +0 -1
  268. package/dist/harness/session/testing/storage-decorator.d.ts +0 -20
  269. package/dist/harness/session/testing/storage-decorator.d.ts.map +0 -1
  270. package/dist/harness/session/testing/storage-decorator.js +0 -41
  271. package/dist/harness/session/testing/storage-decorator.js.map +0 -1
  272. package/dist/harness/session/testing/types.d.ts +0 -12
  273. package/dist/harness/session/testing/types.d.ts.map +0 -1
  274. package/dist/harness/session/testing/types.js +0 -2
  275. package/dist/harness/session/testing/types.js.map +0 -1
  276. package/dist/harness/session/types.d.ts +0 -512
  277. package/dist/harness/session/types.d.ts.map +0 -1
  278. package/dist/harness/session/types.js +0 -9
  279. package/dist/harness/session/types.js.map +0 -1
  280. package/dist/harness/session/values.d.ts +0 -95
  281. package/dist/harness/session/values.d.ts.map +0 -1
  282. package/dist/harness/session/values.js +0 -81
  283. package/dist/harness/session/values.js.map +0 -1
  284. package/dist/harness/skills.d.ts +0 -46
  285. package/dist/harness/skills.d.ts.map +0 -1
  286. package/dist/harness/skills.js +0 -326
  287. package/dist/harness/skills.js.map +0 -1
  288. package/dist/harness/system-prompt.d.ts +0 -3
  289. package/dist/harness/system-prompt.d.ts.map +0 -1
  290. package/dist/harness/system-prompt.js +0 -30
  291. package/dist/harness/system-prompt.js.map +0 -1
  292. package/dist/harness/telemetry.d.ts +0 -1242
  293. package/dist/harness/telemetry.d.ts.map +0 -1
  294. package/dist/harness/telemetry.js +0 -527
  295. package/dist/harness/telemetry.js.map +0 -1
  296. package/dist/harness/tools/bash.d.ts +0 -27
  297. package/dist/harness/tools/bash.d.ts.map +0 -1
  298. package/dist/harness/tools/bash.js +0 -105
  299. package/dist/harness/tools/bash.js.map +0 -1
  300. package/dist/harness/tools/edit-diff.d.ts +0 -89
  301. package/dist/harness/tools/edit-diff.d.ts.map +0 -1
  302. package/dist/harness/tools/edit-diff.js +0 -386
  303. package/dist/harness/tools/edit-diff.js.map +0 -1
  304. package/dist/harness/tools/edit.d.ts +0 -19
  305. package/dist/harness/tools/edit.d.ts.map +0 -1
  306. package/dist/harness/tools/edit.js +0 -108
  307. package/dist/harness/tools/edit.js.map +0 -1
  308. package/dist/harness/tools/file-mutation-queue.d.ts +0 -5
  309. package/dist/harness/tools/file-mutation-queue.d.ts.map +0 -1
  310. package/dist/harness/tools/file-mutation-queue.js +0 -46
  311. package/dist/harness/tools/file-mutation-queue.js.map +0 -1
  312. package/dist/harness/tools/image.d.ts +0 -3
  313. package/dist/harness/tools/image.d.ts.map +0 -1
  314. package/dist/harness/tools/image.js +0 -106
  315. package/dist/harness/tools/image.js.map +0 -1
  316. package/dist/harness/tools/index.d.ts +0 -6
  317. package/dist/harness/tools/index.d.ts.map +0 -1
  318. package/dist/harness/tools/index.js +0 -5
  319. package/dist/harness/tools/index.js.map +0 -1
  320. package/dist/harness/tools/path-utils.d.ts +0 -5
  321. package/dist/harness/tools/path-utils.d.ts.map +0 -1
  322. package/dist/harness/tools/path-utils.js +0 -26
  323. package/dist/harness/tools/path-utils.js.map +0 -1
  324. package/dist/harness/tools/read.d.ts +0 -35
  325. package/dist/harness/tools/read.d.ts.map +0 -1
  326. package/dist/harness/tools/read.js +0 -108
  327. package/dist/harness/tools/read.js.map +0 -1
  328. package/dist/harness/tools/tool-context.d.ts +0 -6
  329. package/dist/harness/tools/tool-context.d.ts.map +0 -1
  330. package/dist/harness/tools/tool-context.js +0 -2
  331. package/dist/harness/tools/tool-context.js.map +0 -1
  332. package/dist/harness/tools/write.d.ts +0 -11
  333. package/dist/harness/tools/write.d.ts.map +0 -1
  334. package/dist/harness/tools/write.js +0 -31
  335. package/dist/harness/tools/write.js.map +0 -1
  336. package/dist/harness/types.d.ts +0 -305
  337. package/dist/harness/types.d.ts.map +0 -1
  338. package/dist/harness/types.js +0 -75
  339. package/dist/harness/types.js.map +0 -1
  340. package/dist/harness/utils/adaptive-publisher.d.ts +0 -24
  341. package/dist/harness/utils/adaptive-publisher.d.ts.map +0 -1
  342. package/dist/harness/utils/adaptive-publisher.js +0 -79
  343. package/dist/harness/utils/adaptive-publisher.js.map +0 -1
  344. package/dist/harness/utils/output-capture.d.ts +0 -31
  345. package/dist/harness/utils/output-capture.d.ts.map +0 -1
  346. package/dist/harness/utils/output-capture.js +0 -217
  347. package/dist/harness/utils/output-capture.js.map +0 -1
  348. package/dist/harness/utils/shell-output.d.ts +0 -29
  349. package/dist/harness/utils/shell-output.d.ts.map +0 -1
  350. package/dist/harness/utils/shell-output.js +0 -71
  351. package/dist/harness/utils/shell-output.js.map +0 -1
  352. package/dist/harness/utils/truncate.d.ts +0 -71
  353. package/dist/harness/utils/truncate.d.ts.map +0 -1
  354. package/dist/harness/utils/truncate.js +0 -296
  355. package/dist/harness/utils/truncate.js.map +0 -1
  356. package/dist/harness/utils/usage.d.ts +0 -4
  357. package/dist/harness/utils/usage.d.ts.map +0 -1
  358. package/dist/harness/utils/usage.js +0 -33
  359. package/dist/harness/utils/usage.js.map +0 -1
  360. package/dist/node.d.ts +0 -3
  361. package/dist/node.d.ts.map +0 -1
  362. package/dist/node.js +0 -3
  363. package/dist/node.js.map +0 -1
  364. package/dist/search/index.d.ts +0 -29
  365. package/dist/search/index.d.ts.map +0 -1
  366. package/dist/search/index.js +0 -2
  367. package/dist/search/index.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/harness/telemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tExactTelemetryAttributes,\n\tSchemaTelemetrySpan,\n\tTelemetrySchemaDefinition,\n\tTelemetrySchemaSpanEndAttributes,\n\tTelemetrySchemaSpanEventAttributes,\n\tTelemetrySchemaSpanEventName,\n\tTelemetrySchemaSpanName,\n\tTelemetrySchemaSpanStartAttributes,\n\tTelemetrySchemaSpanUnion,\n\tTelemetrySpan,\n} from \"@punch-bot/telemetry\";\nimport { type Context, getTelemetryContext, withTelemetryContext } from \"./context.ts\";\n\nexport type {\n\tAttributeValue,\n\tExactTelemetryAttributes,\n\tSchemaTelemetrySpan,\n\tSpanAttributes,\n\tSpanOptions,\n\tSpanStatus,\n\tTelemetryAttributeDefinition,\n\tTelemetryAttributeMetadata,\n\tTelemetryAttributeType,\n\tTelemetryContext,\n\tTelemetryEventAttributeDefinition,\n\tTelemetryEventDefinition,\n\tTelemetryParentDefinition,\n\tTelemetrySchemaDefinition,\n\tTelemetrySchemaSpanEndAttributes,\n\tTelemetrySchemaSpanEventAttributes,\n\tTelemetrySchemaSpanEventName,\n\tTelemetrySchemaSpanName,\n\tTelemetrySchemaSpanStartAttributes,\n\tTelemetrySchemaSpanUnion,\n\tTelemetrySpan,\n\tTelemetrySpanDefinition,\n\tTelemetryStartAttributeDefinition,\n\tTypedSpanStarter,\n} from \"@punch-bot/telemetry\";\n\nexport const AI_TELEMETRY_SCHEMA = {\n\tversion: 1,\n\tspans: {\n\t\t\"pi.ai.request\": {\n\t\t\tdescription: \"One logical request to an AI provider\",\n\t\t\tparents: { kind: \"any\" },\n\t\t\tstartAttributes: {\n\t\t\t\t\"pi.ai.operation\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tvalues: [\"stream\", \"fetch_deferred\", \"cancel_deferred\", \"generate_images\"],\n\t\t\t\t\tdescription: \"Logical provider operation\",\n\t\t\t\t},\n\t\t\t\t\"pi.ai.provider\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"Selected provider id\",\n\t\t\t\t},\n\t\t\t\t\"pi.ai.model\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"Requested model id\",\n\t\t\t\t},\n\t\t\t\t\"pi.ai.api\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"Provider API id\",\n\t\t\t\t},\n\t\t\t\t\"pi.ai.streaming\": {\n\t\t\t\t\ttype: \"boolean\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"Whether this operation returns a stream\",\n\t\t\t\t},\n\t\t\t\t\"pi.ai.deferred\": {\n\t\t\t\t\ttype: \"boolean\",\n\t\t\t\t\trequired: false,\n\t\t\t\t\tdescription: \"Whether the operation requests or participates in deferred execution\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"pi.ai.response.model\": { type: \"string\", description: \"Concrete response model\" },\n\t\t\t\t\"pi.ai.response.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Provider response id\",\n\t\t\t\t},\n\t\t\t\t\"pi.ai.response.stop_reason\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tvalues: [\"stop\", \"length\", \"tool_use\", \"error\", \"aborted\", \"deferred\"],\n\t\t\t\t\tdescription: \"Normalized terminal response reason\",\n\t\t\t\t},\n\t\t\t\t\"pi.ai.http.status_code\": { type: \"number\", description: \"Final HTTP status\" },\n\t\t\t\t\"pi.ai.usage.input_tokens\": { type: \"number\", description: \"Reported input tokens\" },\n\t\t\t\t\"pi.ai.usage.output_tokens\": { type: \"number\", description: \"Reported output tokens\" },\n\t\t\t\t\"pi.ai.usage.cache_read_tokens\": { type: \"number\", description: \"Reported cache-read tokens\" },\n\t\t\t\t\"pi.ai.usage.cache_write_tokens\": {\n\t\t\t\t\ttype: \"number\",\n\t\t\t\t\tdescription: \"Reported cache-write tokens\",\n\t\t\t\t},\n\t\t\t\t\"pi.ai.usage.reasoning_tokens\": { type: \"number\", description: \"Reported reasoning tokens\" },\n\t\t\t\t\"pi.ai.usage.total_tokens\": { type: \"number\", description: \"Reported total tokens\" },\n\t\t\t\t\"pi.ai.usage.cost\": { type: \"number\", description: \"Reported total cost\" },\n\t\t\t\t\"pi.ai.stream.chunk_count\": { type: \"number\", description: \"Streamed update chunk count\" },\n\t\t\t\t\"pi.ai.stream.time_to_first_chunk_ms\": {\n\t\t\t\t\ttype: \"number\",\n\t\t\t\t\tdescription: \"Elapsed milliseconds to first update chunk\",\n\t\t\t\t},\n\t\t\t\t\"pi.ai.error.type\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tcardinality: \"low\",\n\t\t\t\t\tdescription: \"Provider or transport error class\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"The operation throws or returns an error result\" },\n\t\t},\n\t},\n} as const satisfies TelemetrySchemaDefinition;\n\nexport type AiSpanName = TelemetrySchemaSpanName<typeof AI_TELEMETRY_SCHEMA>;\nexport type AiSpanStartAttributes<Name extends AiSpanName> = TelemetrySchemaSpanStartAttributes<\n\ttypeof AI_TELEMETRY_SCHEMA,\n\tName\n>;\nexport type AiSpanEndAttributes<Name extends AiSpanName> = TelemetrySchemaSpanEndAttributes<\n\ttypeof AI_TELEMETRY_SCHEMA,\n\tName\n>;\nexport type AiSpanAttributes<Name extends AiSpanName> = AiSpanStartAttributes<Name> & AiSpanEndAttributes<Name>;\nexport type AiSpanEventName<Name extends AiSpanName> = TelemetrySchemaSpanEventName<typeof AI_TELEMETRY_SCHEMA, Name>;\nexport type AiSpanEventAttributes<\n\tName extends AiSpanName,\n\tEventName extends AiSpanEventName<Name>,\n> = TelemetrySchemaSpanEventAttributes<typeof AI_TELEMETRY_SCHEMA, Name, EventName>;\nexport type AiTelemetrySpan<Name extends AiSpanName> = SchemaTelemetrySpan<typeof AI_TELEMETRY_SCHEMA, Name>;\nexport type AiSpan = TelemetrySchemaSpanUnion<typeof AI_TELEMETRY_SCHEMA>;\n\nexport function startAiSpan<Name extends AiSpanName, const Attributes extends AiSpanStartAttributes<Name>, Result>(\n\tname: Name,\n\tattributes: ExactTelemetryAttributes<AiSpanStartAttributes<Name>, Attributes>,\n\tcallback: (span: AiTelemetrySpan<Name>, context: Context) => Result | Promise<Result>,\n\tcontext: Context,\n): Promise<Result> {\n\treturn getTelemetryContext(context).startSpan({ name, attributes }, (span) =>\n\t\tcallback(span as AiTelemetrySpan<Name>, withTelemetryContext(span, context)),\n\t);\n}\n\nconst HOOK_NAMES = [\n\t\"before_run\",\n\t\"before_drive\",\n\t\"before_run_end\",\n\t\"transform_context\",\n\t\"before_request\",\n\t\"before_payload\",\n\t\"after_response\",\n\t\"before_tool\",\n\t\"after_tool\",\n\t\"before_compaction\",\n\t\"before_navigation\",\n] as const;\n\nconst EVENT_TYPES = [\n\t\"run_start\",\n\t\"run_resume\",\n\t\"run_suspend\",\n\t\"operation_abort\",\n\t\"run_end\",\n\t\"fault\",\n\t\"handler_error\",\n\t\"turn_start\",\n\t\"turn_end\",\n\t\"retry_scheduled\",\n\t\"retry_start\",\n\t\"retry_end\",\n\t\"message_start\",\n\t\"message_update\",\n\t\"message_end\",\n\t\"tool_start\",\n\t\"tool_update\",\n\t\"tool_end\",\n\t\"entry_added\",\n\t\"queue_update\",\n\t\"value_update\",\n\t\"config_update\",\n\t\"compaction_start\",\n\t\"compaction_end\",\n\t\"navigation_start\",\n\t\"navigation_end\",\n\t\"lane_created\",\n\t\"usage\",\n] as const;\n\nconst operationStartAttributes = {\n\t\"pi.session.id\": {\n\t\ttype: \"string\",\n\t\trequired: true,\n\t\tcardinality: \"high\",\n\t\tdescription: \"Session id\",\n\t},\n\t\"pi.lane.name\": {\n\t\ttype: \"string\",\n\t\trequired: true,\n\t\tcardinality: \"high\",\n\t\tdescription: \"Lane name\",\n\t},\n\t\"pi.operation.id\": {\n\t\ttype: \"string\",\n\t\trequired: true,\n\t\tcardinality: \"high\",\n\t\tdescription: \"Durable operation id\",\n\t},\n\t\"pi.operation.recovery\": {\n\t\ttype: \"boolean\",\n\t\trequired: true,\n\t\tdescription: \"Whether this invocation resumes durable work\",\n\t},\n} as const;\n\nconst operationErrorAttributes = {\n\t\"pi.error.code\": {\n\t\ttype: \"string\",\n\t\tcardinality: \"low\",\n\t\tdescription: \"Stable operation error code\",\n\t},\n\t\"pi.error.type\": {\n\t\ttype: \"string\",\n\t\tcardinality: \"low\",\n\t\tdescription: \"Low-cardinality operation error class\",\n\t},\n} as const;\n\nexport const HARNESS_TELEMETRY_SCHEMA = {\n\tversion: 1,\n\tspans: {\n\t\t\"pi.harness.run\": {\n\t\t\tdescription: \"One admitted in-process run invocation\",\n\t\t\tparents: { kind: \"root_or_external\" },\n\t\t\tstartAttributes: {\n\t\t\t\t...operationStartAttributes,\n\t\t\t\t\"pi.operation.kind\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tvalues: [\"run\"],\n\t\t\t\t\tdescription: \"Run operation kind\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"pi.operation.outcome\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tvalues: [\"completed\", \"aborted\", \"failed\", \"suspended\"],\n\t\t\t\t\tdescription: \"Run invocation outcome\",\n\t\t\t\t},\n\t\t\t\t...operationErrorAttributes,\n\t\t\t},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"The run fails or throws\" },\n\t\t},\n\t\t\"pi.harness.compaction\": {\n\t\t\tdescription: \"One admitted in-process manual compaction invocation\",\n\t\t\tparents: { kind: \"root_or_external\" },\n\t\t\tstartAttributes: {\n\t\t\t\t...operationStartAttributes,\n\t\t\t\t\"pi.operation.kind\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tvalues: [\"compaction\"],\n\t\t\t\t\tdescription: \"Compaction operation kind\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"pi.operation.outcome\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tvalues: [\"completed\", \"declined\", \"aborted\", \"failed\"],\n\t\t\t\t\tdescription: \"Compaction invocation outcome\",\n\t\t\t\t},\n\t\t\t\t...operationErrorAttributes,\n\t\t\t},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"The compaction fails or throws\" },\n\t\t},\n\t\t\"pi.harness.navigation\": {\n\t\t\tdescription: \"One admitted in-process navigation invocation\",\n\t\t\tparents: { kind: \"root_or_external\" },\n\t\t\tstartAttributes: {\n\t\t\t\t...operationStartAttributes,\n\t\t\t\t\"pi.operation.kind\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tvalues: [\"navigation\"],\n\t\t\t\t\tdescription: \"Navigation operation kind\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"pi.operation.outcome\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tvalues: [\"completed\", \"declined\", \"aborted\", \"failed\"],\n\t\t\t\t\tdescription: \"Navigation invocation outcome\",\n\t\t\t\t},\n\t\t\t\t...operationErrorAttributes,\n\t\t\t},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"The navigation fails or throws\" },\n\t\t},\n\t\t\"pi.harness.checkpoint\": {\n\t\t\tdescription: \"One run checkpoint\",\n\t\t\tparents: { kind: \"spans\", spans: [\"pi.harness.run\"] },\n\t\t\tstartAttributes: {\n\t\t\t\t\"pi.lane.name\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Lane name\",\n\t\t\t\t},\n\t\t\t\t\"pi.operation.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Durable operation id\",\n\t\t\t\t},\n\t\t\t\t\"pi.checkpoint.kind\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tvalues: [\"normal\", \"abort_reconcile\"],\n\t\t\t\t\tdescription: \"Checkpoint purpose\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"Checkpoint work throws\" },\n\t\t},\n\t\t\"pi.harness.turn\": {\n\t\t\tdescription: \"One assistant response and its tool batch\",\n\t\t\tparents: { kind: \"spans\", spans: [\"pi.harness.run\"] },\n\t\t\tstartAttributes: {\n\t\t\t\t\"pi.lane.name\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Lane name\",\n\t\t\t\t},\n\t\t\t\t\"pi.operation.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Durable operation id\",\n\t\t\t\t},\n\t\t\t\t\"pi.turn.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Invocation-local turn id\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"Turn work throws\" },\n\t\t},\n\t\t\"pi.harness.step\": {\n\t\t\tdescription: \"One durable retry attempt\",\n\t\t\tparents: {\n\t\t\t\tkind: \"spans\",\n\t\t\t\tspans: [\"pi.harness.turn\", \"pi.harness.checkpoint\", \"pi.harness.compaction\", \"pi.harness.navigation\"],\n\t\t\t},\n\t\t\tstartAttributes: {\n\t\t\t\t\"pi.lane.name\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Lane name\",\n\t\t\t\t},\n\t\t\t\t\"pi.operation.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Durable operation id\",\n\t\t\t\t},\n\t\t\t\t\"pi.step.kind\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tvalues: [\"assistant\", \"compaction\", \"branch_summary\"],\n\t\t\t\t\tdescription: \"Retryable step kind\",\n\t\t\t\t},\n\t\t\t\t\"pi.step.attempt\": {\n\t\t\t\t\ttype: \"number\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"One-based durable attempt number\",\n\t\t\t\t},\n\t\t\t\t\"pi.compaction.reason\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: false,\n\t\t\t\t\tvalues: [\"manual\", \"threshold\", \"overflow\"],\n\t\t\t\t\tdescription: \"Compaction trigger\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"pi.step.outcome\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tvalues: [\"succeeded\", \"retry\", \"failed\", \"aborted\", \"deferred\", \"overflow\"],\n\t\t\t\t\tdescription: \"Attempt outcome\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"The attempt retries, fails, or throws\" },\n\t\t},\n\t\t\"pi.harness.tool\": {\n\t\t\tdescription: \"One raw phase-2 tool execution\",\n\t\t\tparents: { kind: \"spans\", spans: [\"pi.harness.turn\", \"pi.harness.run\"] },\n\t\t\tstartAttributes: {\n\t\t\t\t\"pi.lane.name\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Lane name\",\n\t\t\t\t},\n\t\t\t\t\"pi.operation.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Durable operation id\",\n\t\t\t\t},\n\t\t\t\t\"pi.turn.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: false,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Invocation-local live turn id\",\n\t\t\t\t},\n\t\t\t\t\"pi.tool.name\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"Tool name\",\n\t\t\t\t},\n\t\t\t\t\"pi.tool.call_id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Tool call id\",\n\t\t\t\t},\n\t\t\t\t\"pi.tool.replay\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tvalues: [\"never\", \"safe\"],\n\t\t\t\t\tdescription: \"Declared replay policy\",\n\t\t\t\t},\n\t\t\t\t\"pi.tool.recovery\": {\n\t\t\t\t\ttype: \"boolean\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"Whether this is recovery execution\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"pi.tool.is_error\": {\n\t\t\t\t\ttype: \"boolean\",\n\t\t\t\t\tdescription: \"Whether raw phase-2 execution returned an error\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"Raw phase-2 execution returns an error\" },\n\t\t},\n\t\t\"pi.harness.hook\": {\n\t\t\tdescription: \"One registered hook handler invocation\",\n\t\t\tparents: { kind: \"any\" },\n\t\t\tstartAttributes: {\n\t\t\t\t\"pi.lane.name\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Lane name\",\n\t\t\t\t},\n\t\t\t\t\"pi.operation.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: false,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Durable operation id when accepted\",\n\t\t\t\t},\n\t\t\t\t\"pi.hook.name\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tvalues: HOOK_NAMES,\n\t\t\t\t\tdescription: \"Hook name\",\n\t\t\t\t},\n\t\t\t\t\"pi.hook.registration_id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: false,\n\t\t\t\t\tdescription: \"Optional hook registration metadata\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"pi.hook.outcome\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tvalues: [\"completed\", \"skipped\", \"blocked\", \"failed\"],\n\t\t\t\t\tdescription: \"Handler outcome\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"The handler throws\" },\n\t\t},\n\t\t\"pi.harness.sleep\": {\n\t\t\tdescription: \"One retry delay\",\n\t\t\tparents: {\n\t\t\t\tkind: \"spans\",\n\t\t\t\tspans: [\n\t\t\t\t\t\"pi.harness.run\",\n\t\t\t\t\t\"pi.harness.compaction\",\n\t\t\t\t\t\"pi.harness.navigation\",\n\t\t\t\t\t\"pi.harness.turn\",\n\t\t\t\t\t\"pi.harness.checkpoint\",\n\t\t\t\t],\n\t\t\t},\n\t\t\tstartAttributes: {\n\t\t\t\t\"pi.operation.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Durable operation id\",\n\t\t\t\t},\n\t\t\t\t\"pi.sleep.delay_ms\": {\n\t\t\t\t\ttype: \"number\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"Requested delay in milliseconds\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"pi.sleep.outcome\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tvalues: [\"elapsed\", \"aborted\"],\n\t\t\t\t\tdescription: \"Delay outcome\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"Sleep work throws\" },\n\t\t},\n\t\t\"pi.harness.event_handler\": {\n\t\t\tdescription: \"One passive event listener invocation\",\n\t\t\tparents: { kind: \"any\" },\n\t\t\tstartAttributes: {\n\t\t\t\t\"pi.event.type\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"low\",\n\t\t\t\t\tvalues: EVENT_TYPES,\n\t\t\t\t\tdescription: \"Delivered harness event type\",\n\t\t\t\t},\n\t\t\t\t\"pi.lane.name\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: false,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Lane name for lane-scoped events\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"The listener throws\" },\n\t\t},\n\t\t\"pi.session.write\": {\n\t\t\tdescription: \"One committed session transaction\",\n\t\t\tparents: { kind: \"any\" },\n\t\t\tstartAttributes: {\n\t\t\t\t\"pi.session.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Session id\",\n\t\t\t\t},\n\t\t\t\t\"pi.lane.name\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: false,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Lane name when supplied by the caller\",\n\t\t\t\t},\n\t\t\t\t\"pi.operation.id\": {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\trequired: false,\n\t\t\t\t\tcardinality: \"high\",\n\t\t\t\t\tdescription: \"Durable operation id when supplied by the caller\",\n\t\t\t\t},\n\t\t\t\t\"pi.session.item_count\": {\n\t\t\t\t\ttype: \"number\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\tdescription: \"Number of writes in the transaction\",\n\t\t\t\t},\n\t\t\t\t\"pi.session.item_kinds\": {\n\t\t\t\t\ttype: \"string[]\",\n\t\t\t\t\trequired: true,\n\t\t\t\t\telementValues: [\"entry\", \"usage\", \"value\", \"list\"],\n\t\t\t\t\tdescription: \"Distinct write kinds in the transaction\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tendAttributes: {\n\t\t\t\t\"pi.session.first_seq\": {\n\t\t\t\t\ttype: \"number\",\n\t\t\t\t\tdescription: \"First committed sequence in the transaction\",\n\t\t\t\t},\n\t\t\t\t\"pi.session.last_seq\": {\n\t\t\t\t\ttype: \"number\",\n\t\t\t\t\tdescription: \"Last committed sequence in the transaction\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tstatus: { default: \"ok\", errorWhen: \"Storage rejects the transaction\" },\n\t\t},\n\t},\n} as const satisfies TelemetrySchemaDefinition;\n\n/** Combined typed span vocabulary for agent-owned AI-request and harness telemetry. */\nexport const AGENT_TELEMETRY_SCHEMAS = [AI_TELEMETRY_SCHEMA, HARNESS_TELEMETRY_SCHEMA] as const;\n\nexport type HarnessSpanName = TelemetrySchemaSpanName<typeof HARNESS_TELEMETRY_SCHEMA>;\nexport type HarnessSpanStartAttributes<Name extends HarnessSpanName> = TelemetrySchemaSpanStartAttributes<\n\ttypeof HARNESS_TELEMETRY_SCHEMA,\n\tName\n>;\nexport type HarnessSpanEndAttributes<Name extends HarnessSpanName> = TelemetrySchemaSpanEndAttributes<\n\ttypeof HARNESS_TELEMETRY_SCHEMA,\n\tName\n>;\nexport type HarnessSpanAttributes<Name extends HarnessSpanName> = HarnessSpanStartAttributes<Name> &\n\tHarnessSpanEndAttributes<Name>;\nexport type HarnessSpanEventName<Name extends HarnessSpanName> = TelemetrySchemaSpanEventName<\n\ttypeof HARNESS_TELEMETRY_SCHEMA,\n\tName\n>;\nexport type HarnessSpanEventAttributes<\n\tName extends HarnessSpanName,\n\tEventName extends HarnessSpanEventName<Name>,\n> = TelemetrySchemaSpanEventAttributes<typeof HARNESS_TELEMETRY_SCHEMA, Name, EventName>;\nexport type HarnessTelemetrySpan<Name extends HarnessSpanName> = SchemaTelemetrySpan<\n\ttypeof HARNESS_TELEMETRY_SCHEMA,\n\tName\n>;\nexport type HarnessSpan = TelemetrySchemaSpanUnion<typeof HARNESS_TELEMETRY_SCHEMA>;\n\nexport function startHarnessSpan<\n\tName extends HarnessSpanName,\n\tconst Attributes extends HarnessSpanStartAttributes<Name>,\n\tResult,\n>(\n\tname: Name,\n\tattributes: ExactTelemetryAttributes<HarnessSpanStartAttributes<Name>, Attributes>,\n\tcallback: (span: HarnessTelemetrySpan<Name>, context: Context) => Result | Promise<Result>,\n\tcontext: Context,\n): Promise<Result> {\n\treturn getTelemetryContext(context).startSpan({ name, attributes }, (span: TelemetrySpan) =>\n\t\tcallback(span as HarnessTelemetrySpan<Name>, withTelemetryContext(span, context)),\n\t);\n}\n"]}
@@ -1,527 +0,0 @@
1
- import { getTelemetryContext, withTelemetryContext } from "./context.js";
2
- export const AI_TELEMETRY_SCHEMA = {
3
- version: 1,
4
- spans: {
5
- "pi.ai.request": {
6
- description: "One logical request to an AI provider",
7
- parents: { kind: "any" },
8
- startAttributes: {
9
- "pi.ai.operation": {
10
- type: "string",
11
- required: true,
12
- values: ["stream", "fetch_deferred", "cancel_deferred", "generate_images"],
13
- description: "Logical provider operation",
14
- },
15
- "pi.ai.provider": {
16
- type: "string",
17
- required: true,
18
- description: "Selected provider id",
19
- },
20
- "pi.ai.model": {
21
- type: "string",
22
- required: true,
23
- description: "Requested model id",
24
- },
25
- "pi.ai.api": {
26
- type: "string",
27
- required: true,
28
- description: "Provider API id",
29
- },
30
- "pi.ai.streaming": {
31
- type: "boolean",
32
- required: true,
33
- description: "Whether this operation returns a stream",
34
- },
35
- "pi.ai.deferred": {
36
- type: "boolean",
37
- required: false,
38
- description: "Whether the operation requests or participates in deferred execution",
39
- },
40
- },
41
- endAttributes: {
42
- "pi.ai.response.model": { type: "string", description: "Concrete response model" },
43
- "pi.ai.response.id": {
44
- type: "string",
45
- cardinality: "high",
46
- description: "Provider response id",
47
- },
48
- "pi.ai.response.stop_reason": {
49
- type: "string",
50
- values: ["stop", "length", "tool_use", "error", "aborted", "deferred"],
51
- description: "Normalized terminal response reason",
52
- },
53
- "pi.ai.http.status_code": { type: "number", description: "Final HTTP status" },
54
- "pi.ai.usage.input_tokens": { type: "number", description: "Reported input tokens" },
55
- "pi.ai.usage.output_tokens": { type: "number", description: "Reported output tokens" },
56
- "pi.ai.usage.cache_read_tokens": { type: "number", description: "Reported cache-read tokens" },
57
- "pi.ai.usage.cache_write_tokens": {
58
- type: "number",
59
- description: "Reported cache-write tokens",
60
- },
61
- "pi.ai.usage.reasoning_tokens": { type: "number", description: "Reported reasoning tokens" },
62
- "pi.ai.usage.total_tokens": { type: "number", description: "Reported total tokens" },
63
- "pi.ai.usage.cost": { type: "number", description: "Reported total cost" },
64
- "pi.ai.stream.chunk_count": { type: "number", description: "Streamed update chunk count" },
65
- "pi.ai.stream.time_to_first_chunk_ms": {
66
- type: "number",
67
- description: "Elapsed milliseconds to first update chunk",
68
- },
69
- "pi.ai.error.type": {
70
- type: "string",
71
- cardinality: "low",
72
- description: "Provider or transport error class",
73
- },
74
- },
75
- status: { default: "ok", errorWhen: "The operation throws or returns an error result" },
76
- },
77
- },
78
- };
79
- export function startAiSpan(name, attributes, callback, context) {
80
- return getTelemetryContext(context).startSpan({ name, attributes }, (span) => callback(span, withTelemetryContext(span, context)));
81
- }
82
- const HOOK_NAMES = [
83
- "before_run",
84
- "before_drive",
85
- "before_run_end",
86
- "transform_context",
87
- "before_request",
88
- "before_payload",
89
- "after_response",
90
- "before_tool",
91
- "after_tool",
92
- "before_compaction",
93
- "before_navigation",
94
- ];
95
- const EVENT_TYPES = [
96
- "run_start",
97
- "run_resume",
98
- "run_suspend",
99
- "operation_abort",
100
- "run_end",
101
- "fault",
102
- "handler_error",
103
- "turn_start",
104
- "turn_end",
105
- "retry_scheduled",
106
- "retry_start",
107
- "retry_end",
108
- "message_start",
109
- "message_update",
110
- "message_end",
111
- "tool_start",
112
- "tool_update",
113
- "tool_end",
114
- "entry_added",
115
- "queue_update",
116
- "value_update",
117
- "config_update",
118
- "compaction_start",
119
- "compaction_end",
120
- "navigation_start",
121
- "navigation_end",
122
- "lane_created",
123
- "usage",
124
- ];
125
- const operationStartAttributes = {
126
- "pi.session.id": {
127
- type: "string",
128
- required: true,
129
- cardinality: "high",
130
- description: "Session id",
131
- },
132
- "pi.lane.name": {
133
- type: "string",
134
- required: true,
135
- cardinality: "high",
136
- description: "Lane name",
137
- },
138
- "pi.operation.id": {
139
- type: "string",
140
- required: true,
141
- cardinality: "high",
142
- description: "Durable operation id",
143
- },
144
- "pi.operation.recovery": {
145
- type: "boolean",
146
- required: true,
147
- description: "Whether this invocation resumes durable work",
148
- },
149
- };
150
- const operationErrorAttributes = {
151
- "pi.error.code": {
152
- type: "string",
153
- cardinality: "low",
154
- description: "Stable operation error code",
155
- },
156
- "pi.error.type": {
157
- type: "string",
158
- cardinality: "low",
159
- description: "Low-cardinality operation error class",
160
- },
161
- };
162
- export const HARNESS_TELEMETRY_SCHEMA = {
163
- version: 1,
164
- spans: {
165
- "pi.harness.run": {
166
- description: "One admitted in-process run invocation",
167
- parents: { kind: "root_or_external" },
168
- startAttributes: {
169
- ...operationStartAttributes,
170
- "pi.operation.kind": {
171
- type: "string",
172
- required: true,
173
- values: ["run"],
174
- description: "Run operation kind",
175
- },
176
- },
177
- endAttributes: {
178
- "pi.operation.outcome": {
179
- type: "string",
180
- values: ["completed", "aborted", "failed", "suspended"],
181
- description: "Run invocation outcome",
182
- },
183
- ...operationErrorAttributes,
184
- },
185
- status: { default: "ok", errorWhen: "The run fails or throws" },
186
- },
187
- "pi.harness.compaction": {
188
- description: "One admitted in-process manual compaction invocation",
189
- parents: { kind: "root_or_external" },
190
- startAttributes: {
191
- ...operationStartAttributes,
192
- "pi.operation.kind": {
193
- type: "string",
194
- required: true,
195
- values: ["compaction"],
196
- description: "Compaction operation kind",
197
- },
198
- },
199
- endAttributes: {
200
- "pi.operation.outcome": {
201
- type: "string",
202
- values: ["completed", "declined", "aborted", "failed"],
203
- description: "Compaction invocation outcome",
204
- },
205
- ...operationErrorAttributes,
206
- },
207
- status: { default: "ok", errorWhen: "The compaction fails or throws" },
208
- },
209
- "pi.harness.navigation": {
210
- description: "One admitted in-process navigation invocation",
211
- parents: { kind: "root_or_external" },
212
- startAttributes: {
213
- ...operationStartAttributes,
214
- "pi.operation.kind": {
215
- type: "string",
216
- required: true,
217
- values: ["navigation"],
218
- description: "Navigation operation kind",
219
- },
220
- },
221
- endAttributes: {
222
- "pi.operation.outcome": {
223
- type: "string",
224
- values: ["completed", "declined", "aborted", "failed"],
225
- description: "Navigation invocation outcome",
226
- },
227
- ...operationErrorAttributes,
228
- },
229
- status: { default: "ok", errorWhen: "The navigation fails or throws" },
230
- },
231
- "pi.harness.checkpoint": {
232
- description: "One run checkpoint",
233
- parents: { kind: "spans", spans: ["pi.harness.run"] },
234
- startAttributes: {
235
- "pi.lane.name": {
236
- type: "string",
237
- required: true,
238
- cardinality: "high",
239
- description: "Lane name",
240
- },
241
- "pi.operation.id": {
242
- type: "string",
243
- required: true,
244
- cardinality: "high",
245
- description: "Durable operation id",
246
- },
247
- "pi.checkpoint.kind": {
248
- type: "string",
249
- required: true,
250
- values: ["normal", "abort_reconcile"],
251
- description: "Checkpoint purpose",
252
- },
253
- },
254
- endAttributes: {},
255
- status: { default: "ok", errorWhen: "Checkpoint work throws" },
256
- },
257
- "pi.harness.turn": {
258
- description: "One assistant response and its tool batch",
259
- parents: { kind: "spans", spans: ["pi.harness.run"] },
260
- startAttributes: {
261
- "pi.lane.name": {
262
- type: "string",
263
- required: true,
264
- cardinality: "high",
265
- description: "Lane name",
266
- },
267
- "pi.operation.id": {
268
- type: "string",
269
- required: true,
270
- cardinality: "high",
271
- description: "Durable operation id",
272
- },
273
- "pi.turn.id": {
274
- type: "string",
275
- required: true,
276
- cardinality: "high",
277
- description: "Invocation-local turn id",
278
- },
279
- },
280
- endAttributes: {},
281
- status: { default: "ok", errorWhen: "Turn work throws" },
282
- },
283
- "pi.harness.step": {
284
- description: "One durable retry attempt",
285
- parents: {
286
- kind: "spans",
287
- spans: ["pi.harness.turn", "pi.harness.checkpoint", "pi.harness.compaction", "pi.harness.navigation"],
288
- },
289
- startAttributes: {
290
- "pi.lane.name": {
291
- type: "string",
292
- required: true,
293
- cardinality: "high",
294
- description: "Lane name",
295
- },
296
- "pi.operation.id": {
297
- type: "string",
298
- required: true,
299
- cardinality: "high",
300
- description: "Durable operation id",
301
- },
302
- "pi.step.kind": {
303
- type: "string",
304
- required: true,
305
- values: ["assistant", "compaction", "branch_summary"],
306
- description: "Retryable step kind",
307
- },
308
- "pi.step.attempt": {
309
- type: "number",
310
- required: true,
311
- description: "One-based durable attempt number",
312
- },
313
- "pi.compaction.reason": {
314
- type: "string",
315
- required: false,
316
- values: ["manual", "threshold", "overflow"],
317
- description: "Compaction trigger",
318
- },
319
- },
320
- endAttributes: {
321
- "pi.step.outcome": {
322
- type: "string",
323
- values: ["succeeded", "retry", "failed", "aborted", "deferred", "overflow"],
324
- description: "Attempt outcome",
325
- },
326
- },
327
- status: { default: "ok", errorWhen: "The attempt retries, fails, or throws" },
328
- },
329
- "pi.harness.tool": {
330
- description: "One raw phase-2 tool execution",
331
- parents: { kind: "spans", spans: ["pi.harness.turn", "pi.harness.run"] },
332
- startAttributes: {
333
- "pi.lane.name": {
334
- type: "string",
335
- required: true,
336
- cardinality: "high",
337
- description: "Lane name",
338
- },
339
- "pi.operation.id": {
340
- type: "string",
341
- required: true,
342
- cardinality: "high",
343
- description: "Durable operation id",
344
- },
345
- "pi.turn.id": {
346
- type: "string",
347
- required: false,
348
- cardinality: "high",
349
- description: "Invocation-local live turn id",
350
- },
351
- "pi.tool.name": {
352
- type: "string",
353
- required: true,
354
- description: "Tool name",
355
- },
356
- "pi.tool.call_id": {
357
- type: "string",
358
- required: true,
359
- cardinality: "high",
360
- description: "Tool call id",
361
- },
362
- "pi.tool.replay": {
363
- type: "string",
364
- required: true,
365
- values: ["never", "safe"],
366
- description: "Declared replay policy",
367
- },
368
- "pi.tool.recovery": {
369
- type: "boolean",
370
- required: true,
371
- description: "Whether this is recovery execution",
372
- },
373
- },
374
- endAttributes: {
375
- "pi.tool.is_error": {
376
- type: "boolean",
377
- description: "Whether raw phase-2 execution returned an error",
378
- },
379
- },
380
- status: { default: "ok", errorWhen: "Raw phase-2 execution returns an error" },
381
- },
382
- "pi.harness.hook": {
383
- description: "One registered hook handler invocation",
384
- parents: { kind: "any" },
385
- startAttributes: {
386
- "pi.lane.name": {
387
- type: "string",
388
- required: true,
389
- cardinality: "high",
390
- description: "Lane name",
391
- },
392
- "pi.operation.id": {
393
- type: "string",
394
- required: false,
395
- cardinality: "high",
396
- description: "Durable operation id when accepted",
397
- },
398
- "pi.hook.name": {
399
- type: "string",
400
- required: true,
401
- values: HOOK_NAMES,
402
- description: "Hook name",
403
- },
404
- "pi.hook.registration_id": {
405
- type: "string",
406
- required: false,
407
- description: "Optional hook registration metadata",
408
- },
409
- },
410
- endAttributes: {
411
- "pi.hook.outcome": {
412
- type: "string",
413
- values: ["completed", "skipped", "blocked", "failed"],
414
- description: "Handler outcome",
415
- },
416
- },
417
- status: { default: "ok", errorWhen: "The handler throws" },
418
- },
419
- "pi.harness.sleep": {
420
- description: "One retry delay",
421
- parents: {
422
- kind: "spans",
423
- spans: [
424
- "pi.harness.run",
425
- "pi.harness.compaction",
426
- "pi.harness.navigation",
427
- "pi.harness.turn",
428
- "pi.harness.checkpoint",
429
- ],
430
- },
431
- startAttributes: {
432
- "pi.operation.id": {
433
- type: "string",
434
- required: true,
435
- cardinality: "high",
436
- description: "Durable operation id",
437
- },
438
- "pi.sleep.delay_ms": {
439
- type: "number",
440
- required: true,
441
- description: "Requested delay in milliseconds",
442
- },
443
- },
444
- endAttributes: {
445
- "pi.sleep.outcome": {
446
- type: "string",
447
- values: ["elapsed", "aborted"],
448
- description: "Delay outcome",
449
- },
450
- },
451
- status: { default: "ok", errorWhen: "Sleep work throws" },
452
- },
453
- "pi.harness.event_handler": {
454
- description: "One passive event listener invocation",
455
- parents: { kind: "any" },
456
- startAttributes: {
457
- "pi.event.type": {
458
- type: "string",
459
- required: true,
460
- cardinality: "low",
461
- values: EVENT_TYPES,
462
- description: "Delivered harness event type",
463
- },
464
- "pi.lane.name": {
465
- type: "string",
466
- required: false,
467
- cardinality: "high",
468
- description: "Lane name for lane-scoped events",
469
- },
470
- },
471
- endAttributes: {},
472
- status: { default: "ok", errorWhen: "The listener throws" },
473
- },
474
- "pi.session.write": {
475
- description: "One committed session transaction",
476
- parents: { kind: "any" },
477
- startAttributes: {
478
- "pi.session.id": {
479
- type: "string",
480
- required: true,
481
- cardinality: "high",
482
- description: "Session id",
483
- },
484
- "pi.lane.name": {
485
- type: "string",
486
- required: false,
487
- cardinality: "high",
488
- description: "Lane name when supplied by the caller",
489
- },
490
- "pi.operation.id": {
491
- type: "string",
492
- required: false,
493
- cardinality: "high",
494
- description: "Durable operation id when supplied by the caller",
495
- },
496
- "pi.session.item_count": {
497
- type: "number",
498
- required: true,
499
- description: "Number of writes in the transaction",
500
- },
501
- "pi.session.item_kinds": {
502
- type: "string[]",
503
- required: true,
504
- elementValues: ["entry", "usage", "value", "list"],
505
- description: "Distinct write kinds in the transaction",
506
- },
507
- },
508
- endAttributes: {
509
- "pi.session.first_seq": {
510
- type: "number",
511
- description: "First committed sequence in the transaction",
512
- },
513
- "pi.session.last_seq": {
514
- type: "number",
515
- description: "Last committed sequence in the transaction",
516
- },
517
- },
518
- status: { default: "ok", errorWhen: "Storage rejects the transaction" },
519
- },
520
- },
521
- };
522
- /** Combined typed span vocabulary for agent-owned AI-request and harness telemetry. */
523
- export const AGENT_TELEMETRY_SCHEMAS = [AI_TELEMETRY_SCHEMA, HARNESS_TELEMETRY_SCHEMA];
524
- export function startHarnessSpan(name, attributes, callback, context) {
525
- return getTelemetryContext(context).startSpan({ name, attributes }, (span) => callback(span, withTelemetryContext(span, context)));
526
- }
527
- //# sourceMappingURL=telemetry.js.map