@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,1242 +0,0 @@
1
- import type { ExactTelemetryAttributes, SchemaTelemetrySpan, TelemetrySchemaSpanEndAttributes, TelemetrySchemaSpanEventAttributes, TelemetrySchemaSpanEventName, TelemetrySchemaSpanName, TelemetrySchemaSpanStartAttributes, TelemetrySchemaSpanUnion } from "@punch-bot/telemetry";
2
- import { type Context } from "./context.ts";
3
- export type { AttributeValue, ExactTelemetryAttributes, SchemaTelemetrySpan, SpanAttributes, SpanOptions, SpanStatus, TelemetryAttributeDefinition, TelemetryAttributeMetadata, TelemetryAttributeType, TelemetryContext, TelemetryEventAttributeDefinition, TelemetryEventDefinition, TelemetryParentDefinition, TelemetrySchemaDefinition, TelemetrySchemaSpanEndAttributes, TelemetrySchemaSpanEventAttributes, TelemetrySchemaSpanEventName, TelemetrySchemaSpanName, TelemetrySchemaSpanStartAttributes, TelemetrySchemaSpanUnion, TelemetrySpan, TelemetrySpanDefinition, TelemetryStartAttributeDefinition, TypedSpanStarter, } from "@punch-bot/telemetry";
4
- export declare const AI_TELEMETRY_SCHEMA: {
5
- readonly version: 1;
6
- readonly spans: {
7
- readonly "pi.ai.request": {
8
- readonly description: "One logical request to an AI provider";
9
- readonly parents: {
10
- readonly kind: "any";
11
- };
12
- readonly startAttributes: {
13
- readonly "pi.ai.operation": {
14
- readonly type: "string";
15
- readonly required: true;
16
- readonly values: readonly ["stream", "fetch_deferred", "cancel_deferred", "generate_images"];
17
- readonly description: "Logical provider operation";
18
- };
19
- readonly "pi.ai.provider": {
20
- readonly type: "string";
21
- readonly required: true;
22
- readonly description: "Selected provider id";
23
- };
24
- readonly "pi.ai.model": {
25
- readonly type: "string";
26
- readonly required: true;
27
- readonly description: "Requested model id";
28
- };
29
- readonly "pi.ai.api": {
30
- readonly type: "string";
31
- readonly required: true;
32
- readonly description: "Provider API id";
33
- };
34
- readonly "pi.ai.streaming": {
35
- readonly type: "boolean";
36
- readonly required: true;
37
- readonly description: "Whether this operation returns a stream";
38
- };
39
- readonly "pi.ai.deferred": {
40
- readonly type: "boolean";
41
- readonly required: false;
42
- readonly description: "Whether the operation requests or participates in deferred execution";
43
- };
44
- };
45
- readonly endAttributes: {
46
- readonly "pi.ai.response.model": {
47
- readonly type: "string";
48
- readonly description: "Concrete response model";
49
- };
50
- readonly "pi.ai.response.id": {
51
- readonly type: "string";
52
- readonly cardinality: "high";
53
- readonly description: "Provider response id";
54
- };
55
- readonly "pi.ai.response.stop_reason": {
56
- readonly type: "string";
57
- readonly values: readonly ["stop", "length", "tool_use", "error", "aborted", "deferred"];
58
- readonly description: "Normalized terminal response reason";
59
- };
60
- readonly "pi.ai.http.status_code": {
61
- readonly type: "number";
62
- readonly description: "Final HTTP status";
63
- };
64
- readonly "pi.ai.usage.input_tokens": {
65
- readonly type: "number";
66
- readonly description: "Reported input tokens";
67
- };
68
- readonly "pi.ai.usage.output_tokens": {
69
- readonly type: "number";
70
- readonly description: "Reported output tokens";
71
- };
72
- readonly "pi.ai.usage.cache_read_tokens": {
73
- readonly type: "number";
74
- readonly description: "Reported cache-read tokens";
75
- };
76
- readonly "pi.ai.usage.cache_write_tokens": {
77
- readonly type: "number";
78
- readonly description: "Reported cache-write tokens";
79
- };
80
- readonly "pi.ai.usage.reasoning_tokens": {
81
- readonly type: "number";
82
- readonly description: "Reported reasoning tokens";
83
- };
84
- readonly "pi.ai.usage.total_tokens": {
85
- readonly type: "number";
86
- readonly description: "Reported total tokens";
87
- };
88
- readonly "pi.ai.usage.cost": {
89
- readonly type: "number";
90
- readonly description: "Reported total cost";
91
- };
92
- readonly "pi.ai.stream.chunk_count": {
93
- readonly type: "number";
94
- readonly description: "Streamed update chunk count";
95
- };
96
- readonly "pi.ai.stream.time_to_first_chunk_ms": {
97
- readonly type: "number";
98
- readonly description: "Elapsed milliseconds to first update chunk";
99
- };
100
- readonly "pi.ai.error.type": {
101
- readonly type: "string";
102
- readonly cardinality: "low";
103
- readonly description: "Provider or transport error class";
104
- };
105
- };
106
- readonly status: {
107
- readonly default: "ok";
108
- readonly errorWhen: "The operation throws or returns an error result";
109
- };
110
- };
111
- };
112
- };
113
- export type AiSpanName = TelemetrySchemaSpanName<typeof AI_TELEMETRY_SCHEMA>;
114
- export type AiSpanStartAttributes<Name extends AiSpanName> = TelemetrySchemaSpanStartAttributes<typeof AI_TELEMETRY_SCHEMA, Name>;
115
- export type AiSpanEndAttributes<Name extends AiSpanName> = TelemetrySchemaSpanEndAttributes<typeof AI_TELEMETRY_SCHEMA, Name>;
116
- export type AiSpanAttributes<Name extends AiSpanName> = AiSpanStartAttributes<Name> & AiSpanEndAttributes<Name>;
117
- export type AiSpanEventName<Name extends AiSpanName> = TelemetrySchemaSpanEventName<typeof AI_TELEMETRY_SCHEMA, Name>;
118
- export type AiSpanEventAttributes<Name extends AiSpanName, EventName extends AiSpanEventName<Name>> = TelemetrySchemaSpanEventAttributes<typeof AI_TELEMETRY_SCHEMA, Name, EventName>;
119
- export type AiTelemetrySpan<Name extends AiSpanName> = SchemaTelemetrySpan<typeof AI_TELEMETRY_SCHEMA, Name>;
120
- export type AiSpan = TelemetrySchemaSpanUnion<typeof AI_TELEMETRY_SCHEMA>;
121
- export declare function startAiSpan<Name extends AiSpanName, const Attributes extends AiSpanStartAttributes<Name>, Result>(name: Name, attributes: ExactTelemetryAttributes<AiSpanStartAttributes<Name>, Attributes>, callback: (span: AiTelemetrySpan<Name>, context: Context) => Result | Promise<Result>, context: Context): Promise<Result>;
122
- export declare const HARNESS_TELEMETRY_SCHEMA: {
123
- readonly version: 1;
124
- readonly spans: {
125
- readonly "pi.harness.run": {
126
- readonly description: "One admitted in-process run invocation";
127
- readonly parents: {
128
- readonly kind: "root_or_external";
129
- };
130
- readonly startAttributes: {
131
- readonly "pi.session.id": {
132
- readonly type: "string";
133
- readonly required: true;
134
- readonly cardinality: "high";
135
- readonly description: "Session id";
136
- };
137
- readonly "pi.lane.name": {
138
- readonly type: "string";
139
- readonly required: true;
140
- readonly cardinality: "high";
141
- readonly description: "Lane name";
142
- };
143
- readonly "pi.operation.id": {
144
- readonly type: "string";
145
- readonly required: true;
146
- readonly cardinality: "high";
147
- readonly description: "Durable operation id";
148
- };
149
- readonly "pi.operation.recovery": {
150
- readonly type: "boolean";
151
- readonly required: true;
152
- readonly description: "Whether this invocation resumes durable work";
153
- };
154
- readonly "pi.operation.kind": {
155
- readonly type: "string";
156
- readonly required: true;
157
- readonly values: readonly ["run"];
158
- readonly description: "Run operation kind";
159
- };
160
- };
161
- readonly endAttributes: {
162
- readonly "pi.error.code": {
163
- readonly type: "string";
164
- readonly cardinality: "low";
165
- readonly description: "Stable operation error code";
166
- };
167
- readonly "pi.error.type": {
168
- readonly type: "string";
169
- readonly cardinality: "low";
170
- readonly description: "Low-cardinality operation error class";
171
- };
172
- readonly "pi.operation.outcome": {
173
- readonly type: "string";
174
- readonly values: readonly ["completed", "aborted", "failed", "suspended"];
175
- readonly description: "Run invocation outcome";
176
- };
177
- };
178
- readonly status: {
179
- readonly default: "ok";
180
- readonly errorWhen: "The run fails or throws";
181
- };
182
- };
183
- readonly "pi.harness.compaction": {
184
- readonly description: "One admitted in-process manual compaction invocation";
185
- readonly parents: {
186
- readonly kind: "root_or_external";
187
- };
188
- readonly startAttributes: {
189
- readonly "pi.session.id": {
190
- readonly type: "string";
191
- readonly required: true;
192
- readonly cardinality: "high";
193
- readonly description: "Session id";
194
- };
195
- readonly "pi.lane.name": {
196
- readonly type: "string";
197
- readonly required: true;
198
- readonly cardinality: "high";
199
- readonly description: "Lane name";
200
- };
201
- readonly "pi.operation.id": {
202
- readonly type: "string";
203
- readonly required: true;
204
- readonly cardinality: "high";
205
- readonly description: "Durable operation id";
206
- };
207
- readonly "pi.operation.recovery": {
208
- readonly type: "boolean";
209
- readonly required: true;
210
- readonly description: "Whether this invocation resumes durable work";
211
- };
212
- readonly "pi.operation.kind": {
213
- readonly type: "string";
214
- readonly required: true;
215
- readonly values: readonly ["compaction"];
216
- readonly description: "Compaction operation kind";
217
- };
218
- };
219
- readonly endAttributes: {
220
- readonly "pi.error.code": {
221
- readonly type: "string";
222
- readonly cardinality: "low";
223
- readonly description: "Stable operation error code";
224
- };
225
- readonly "pi.error.type": {
226
- readonly type: "string";
227
- readonly cardinality: "low";
228
- readonly description: "Low-cardinality operation error class";
229
- };
230
- readonly "pi.operation.outcome": {
231
- readonly type: "string";
232
- readonly values: readonly ["completed", "declined", "aborted", "failed"];
233
- readonly description: "Compaction invocation outcome";
234
- };
235
- };
236
- readonly status: {
237
- readonly default: "ok";
238
- readonly errorWhen: "The compaction fails or throws";
239
- };
240
- };
241
- readonly "pi.harness.navigation": {
242
- readonly description: "One admitted in-process navigation invocation";
243
- readonly parents: {
244
- readonly kind: "root_or_external";
245
- };
246
- readonly startAttributes: {
247
- readonly "pi.session.id": {
248
- readonly type: "string";
249
- readonly required: true;
250
- readonly cardinality: "high";
251
- readonly description: "Session id";
252
- };
253
- readonly "pi.lane.name": {
254
- readonly type: "string";
255
- readonly required: true;
256
- readonly cardinality: "high";
257
- readonly description: "Lane name";
258
- };
259
- readonly "pi.operation.id": {
260
- readonly type: "string";
261
- readonly required: true;
262
- readonly cardinality: "high";
263
- readonly description: "Durable operation id";
264
- };
265
- readonly "pi.operation.recovery": {
266
- readonly type: "boolean";
267
- readonly required: true;
268
- readonly description: "Whether this invocation resumes durable work";
269
- };
270
- readonly "pi.operation.kind": {
271
- readonly type: "string";
272
- readonly required: true;
273
- readonly values: readonly ["navigation"];
274
- readonly description: "Navigation operation kind";
275
- };
276
- };
277
- readonly endAttributes: {
278
- readonly "pi.error.code": {
279
- readonly type: "string";
280
- readonly cardinality: "low";
281
- readonly description: "Stable operation error code";
282
- };
283
- readonly "pi.error.type": {
284
- readonly type: "string";
285
- readonly cardinality: "low";
286
- readonly description: "Low-cardinality operation error class";
287
- };
288
- readonly "pi.operation.outcome": {
289
- readonly type: "string";
290
- readonly values: readonly ["completed", "declined", "aborted", "failed"];
291
- readonly description: "Navigation invocation outcome";
292
- };
293
- };
294
- readonly status: {
295
- readonly default: "ok";
296
- readonly errorWhen: "The navigation fails or throws";
297
- };
298
- };
299
- readonly "pi.harness.checkpoint": {
300
- readonly description: "One run checkpoint";
301
- readonly parents: {
302
- readonly kind: "spans";
303
- readonly spans: readonly ["pi.harness.run"];
304
- };
305
- readonly startAttributes: {
306
- readonly "pi.lane.name": {
307
- readonly type: "string";
308
- readonly required: true;
309
- readonly cardinality: "high";
310
- readonly description: "Lane name";
311
- };
312
- readonly "pi.operation.id": {
313
- readonly type: "string";
314
- readonly required: true;
315
- readonly cardinality: "high";
316
- readonly description: "Durable operation id";
317
- };
318
- readonly "pi.checkpoint.kind": {
319
- readonly type: "string";
320
- readonly required: true;
321
- readonly values: readonly ["normal", "abort_reconcile"];
322
- readonly description: "Checkpoint purpose";
323
- };
324
- };
325
- readonly endAttributes: {};
326
- readonly status: {
327
- readonly default: "ok";
328
- readonly errorWhen: "Checkpoint work throws";
329
- };
330
- };
331
- readonly "pi.harness.turn": {
332
- readonly description: "One assistant response and its tool batch";
333
- readonly parents: {
334
- readonly kind: "spans";
335
- readonly spans: readonly ["pi.harness.run"];
336
- };
337
- readonly startAttributes: {
338
- readonly "pi.lane.name": {
339
- readonly type: "string";
340
- readonly required: true;
341
- readonly cardinality: "high";
342
- readonly description: "Lane name";
343
- };
344
- readonly "pi.operation.id": {
345
- readonly type: "string";
346
- readonly required: true;
347
- readonly cardinality: "high";
348
- readonly description: "Durable operation id";
349
- };
350
- readonly "pi.turn.id": {
351
- readonly type: "string";
352
- readonly required: true;
353
- readonly cardinality: "high";
354
- readonly description: "Invocation-local turn id";
355
- };
356
- };
357
- readonly endAttributes: {};
358
- readonly status: {
359
- readonly default: "ok";
360
- readonly errorWhen: "Turn work throws";
361
- };
362
- };
363
- readonly "pi.harness.step": {
364
- readonly description: "One durable retry attempt";
365
- readonly parents: {
366
- readonly kind: "spans";
367
- readonly spans: readonly ["pi.harness.turn", "pi.harness.checkpoint", "pi.harness.compaction", "pi.harness.navigation"];
368
- };
369
- readonly startAttributes: {
370
- readonly "pi.lane.name": {
371
- readonly type: "string";
372
- readonly required: true;
373
- readonly cardinality: "high";
374
- readonly description: "Lane name";
375
- };
376
- readonly "pi.operation.id": {
377
- readonly type: "string";
378
- readonly required: true;
379
- readonly cardinality: "high";
380
- readonly description: "Durable operation id";
381
- };
382
- readonly "pi.step.kind": {
383
- readonly type: "string";
384
- readonly required: true;
385
- readonly values: readonly ["assistant", "compaction", "branch_summary"];
386
- readonly description: "Retryable step kind";
387
- };
388
- readonly "pi.step.attempt": {
389
- readonly type: "number";
390
- readonly required: true;
391
- readonly description: "One-based durable attempt number";
392
- };
393
- readonly "pi.compaction.reason": {
394
- readonly type: "string";
395
- readonly required: false;
396
- readonly values: readonly ["manual", "threshold", "overflow"];
397
- readonly description: "Compaction trigger";
398
- };
399
- };
400
- readonly endAttributes: {
401
- readonly "pi.step.outcome": {
402
- readonly type: "string";
403
- readonly values: readonly ["succeeded", "retry", "failed", "aborted", "deferred", "overflow"];
404
- readonly description: "Attempt outcome";
405
- };
406
- };
407
- readonly status: {
408
- readonly default: "ok";
409
- readonly errorWhen: "The attempt retries, fails, or throws";
410
- };
411
- };
412
- readonly "pi.harness.tool": {
413
- readonly description: "One raw phase-2 tool execution";
414
- readonly parents: {
415
- readonly kind: "spans";
416
- readonly spans: readonly ["pi.harness.turn", "pi.harness.run"];
417
- };
418
- readonly startAttributes: {
419
- readonly "pi.lane.name": {
420
- readonly type: "string";
421
- readonly required: true;
422
- readonly cardinality: "high";
423
- readonly description: "Lane name";
424
- };
425
- readonly "pi.operation.id": {
426
- readonly type: "string";
427
- readonly required: true;
428
- readonly cardinality: "high";
429
- readonly description: "Durable operation id";
430
- };
431
- readonly "pi.turn.id": {
432
- readonly type: "string";
433
- readonly required: false;
434
- readonly cardinality: "high";
435
- readonly description: "Invocation-local live turn id";
436
- };
437
- readonly "pi.tool.name": {
438
- readonly type: "string";
439
- readonly required: true;
440
- readonly description: "Tool name";
441
- };
442
- readonly "pi.tool.call_id": {
443
- readonly type: "string";
444
- readonly required: true;
445
- readonly cardinality: "high";
446
- readonly description: "Tool call id";
447
- };
448
- readonly "pi.tool.replay": {
449
- readonly type: "string";
450
- readonly required: true;
451
- readonly values: readonly ["never", "safe"];
452
- readonly description: "Declared replay policy";
453
- };
454
- readonly "pi.tool.recovery": {
455
- readonly type: "boolean";
456
- readonly required: true;
457
- readonly description: "Whether this is recovery execution";
458
- };
459
- };
460
- readonly endAttributes: {
461
- readonly "pi.tool.is_error": {
462
- readonly type: "boolean";
463
- readonly description: "Whether raw phase-2 execution returned an error";
464
- };
465
- };
466
- readonly status: {
467
- readonly default: "ok";
468
- readonly errorWhen: "Raw phase-2 execution returns an error";
469
- };
470
- };
471
- readonly "pi.harness.hook": {
472
- readonly description: "One registered hook handler invocation";
473
- readonly parents: {
474
- readonly kind: "any";
475
- };
476
- readonly startAttributes: {
477
- readonly "pi.lane.name": {
478
- readonly type: "string";
479
- readonly required: true;
480
- readonly cardinality: "high";
481
- readonly description: "Lane name";
482
- };
483
- readonly "pi.operation.id": {
484
- readonly type: "string";
485
- readonly required: false;
486
- readonly cardinality: "high";
487
- readonly description: "Durable operation id when accepted";
488
- };
489
- readonly "pi.hook.name": {
490
- readonly type: "string";
491
- readonly required: true;
492
- readonly values: readonly ["before_run", "before_drive", "before_run_end", "transform_context", "before_request", "before_payload", "after_response", "before_tool", "after_tool", "before_compaction", "before_navigation"];
493
- readonly description: "Hook name";
494
- };
495
- readonly "pi.hook.registration_id": {
496
- readonly type: "string";
497
- readonly required: false;
498
- readonly description: "Optional hook registration metadata";
499
- };
500
- };
501
- readonly endAttributes: {
502
- readonly "pi.hook.outcome": {
503
- readonly type: "string";
504
- readonly values: readonly ["completed", "skipped", "blocked", "failed"];
505
- readonly description: "Handler outcome";
506
- };
507
- };
508
- readonly status: {
509
- readonly default: "ok";
510
- readonly errorWhen: "The handler throws";
511
- };
512
- };
513
- readonly "pi.harness.sleep": {
514
- readonly description: "One retry delay";
515
- readonly parents: {
516
- readonly kind: "spans";
517
- readonly spans: readonly ["pi.harness.run", "pi.harness.compaction", "pi.harness.navigation", "pi.harness.turn", "pi.harness.checkpoint"];
518
- };
519
- readonly startAttributes: {
520
- readonly "pi.operation.id": {
521
- readonly type: "string";
522
- readonly required: true;
523
- readonly cardinality: "high";
524
- readonly description: "Durable operation id";
525
- };
526
- readonly "pi.sleep.delay_ms": {
527
- readonly type: "number";
528
- readonly required: true;
529
- readonly description: "Requested delay in milliseconds";
530
- };
531
- };
532
- readonly endAttributes: {
533
- readonly "pi.sleep.outcome": {
534
- readonly type: "string";
535
- readonly values: readonly ["elapsed", "aborted"];
536
- readonly description: "Delay outcome";
537
- };
538
- };
539
- readonly status: {
540
- readonly default: "ok";
541
- readonly errorWhen: "Sleep work throws";
542
- };
543
- };
544
- readonly "pi.harness.event_handler": {
545
- readonly description: "One passive event listener invocation";
546
- readonly parents: {
547
- readonly kind: "any";
548
- };
549
- readonly startAttributes: {
550
- readonly "pi.event.type": {
551
- readonly type: "string";
552
- readonly required: true;
553
- readonly cardinality: "low";
554
- readonly values: readonly ["run_start", "run_resume", "run_suspend", "operation_abort", "run_end", "fault", "handler_error", "turn_start", "turn_end", "retry_scheduled", "retry_start", "retry_end", "message_start", "message_update", "message_end", "tool_start", "tool_update", "tool_end", "entry_added", "queue_update", "value_update", "config_update", "compaction_start", "compaction_end", "navigation_start", "navigation_end", "lane_created", "usage"];
555
- readonly description: "Delivered harness event type";
556
- };
557
- readonly "pi.lane.name": {
558
- readonly type: "string";
559
- readonly required: false;
560
- readonly cardinality: "high";
561
- readonly description: "Lane name for lane-scoped events";
562
- };
563
- };
564
- readonly endAttributes: {};
565
- readonly status: {
566
- readonly default: "ok";
567
- readonly errorWhen: "The listener throws";
568
- };
569
- };
570
- readonly "pi.session.write": {
571
- readonly description: "One committed session transaction";
572
- readonly parents: {
573
- readonly kind: "any";
574
- };
575
- readonly startAttributes: {
576
- readonly "pi.session.id": {
577
- readonly type: "string";
578
- readonly required: true;
579
- readonly cardinality: "high";
580
- readonly description: "Session id";
581
- };
582
- readonly "pi.lane.name": {
583
- readonly type: "string";
584
- readonly required: false;
585
- readonly cardinality: "high";
586
- readonly description: "Lane name when supplied by the caller";
587
- };
588
- readonly "pi.operation.id": {
589
- readonly type: "string";
590
- readonly required: false;
591
- readonly cardinality: "high";
592
- readonly description: "Durable operation id when supplied by the caller";
593
- };
594
- readonly "pi.session.item_count": {
595
- readonly type: "number";
596
- readonly required: true;
597
- readonly description: "Number of writes in the transaction";
598
- };
599
- readonly "pi.session.item_kinds": {
600
- readonly type: "string[]";
601
- readonly required: true;
602
- readonly elementValues: readonly ["entry", "usage", "value", "list"];
603
- readonly description: "Distinct write kinds in the transaction";
604
- };
605
- };
606
- readonly endAttributes: {
607
- readonly "pi.session.first_seq": {
608
- readonly type: "number";
609
- readonly description: "First committed sequence in the transaction";
610
- };
611
- readonly "pi.session.last_seq": {
612
- readonly type: "number";
613
- readonly description: "Last committed sequence in the transaction";
614
- };
615
- };
616
- readonly status: {
617
- readonly default: "ok";
618
- readonly errorWhen: "Storage rejects the transaction";
619
- };
620
- };
621
- };
622
- };
623
- /** Combined typed span vocabulary for agent-owned AI-request and harness telemetry. */
624
- export declare const AGENT_TELEMETRY_SCHEMAS: readonly [{
625
- readonly version: 1;
626
- readonly spans: {
627
- readonly "pi.ai.request": {
628
- readonly description: "One logical request to an AI provider";
629
- readonly parents: {
630
- readonly kind: "any";
631
- };
632
- readonly startAttributes: {
633
- readonly "pi.ai.operation": {
634
- readonly type: "string";
635
- readonly required: true;
636
- readonly values: readonly ["stream", "fetch_deferred", "cancel_deferred", "generate_images"];
637
- readonly description: "Logical provider operation";
638
- };
639
- readonly "pi.ai.provider": {
640
- readonly type: "string";
641
- readonly required: true;
642
- readonly description: "Selected provider id";
643
- };
644
- readonly "pi.ai.model": {
645
- readonly type: "string";
646
- readonly required: true;
647
- readonly description: "Requested model id";
648
- };
649
- readonly "pi.ai.api": {
650
- readonly type: "string";
651
- readonly required: true;
652
- readonly description: "Provider API id";
653
- };
654
- readonly "pi.ai.streaming": {
655
- readonly type: "boolean";
656
- readonly required: true;
657
- readonly description: "Whether this operation returns a stream";
658
- };
659
- readonly "pi.ai.deferred": {
660
- readonly type: "boolean";
661
- readonly required: false;
662
- readonly description: "Whether the operation requests or participates in deferred execution";
663
- };
664
- };
665
- readonly endAttributes: {
666
- readonly "pi.ai.response.model": {
667
- readonly type: "string";
668
- readonly description: "Concrete response model";
669
- };
670
- readonly "pi.ai.response.id": {
671
- readonly type: "string";
672
- readonly cardinality: "high";
673
- readonly description: "Provider response id";
674
- };
675
- readonly "pi.ai.response.stop_reason": {
676
- readonly type: "string";
677
- readonly values: readonly ["stop", "length", "tool_use", "error", "aborted", "deferred"];
678
- readonly description: "Normalized terminal response reason";
679
- };
680
- readonly "pi.ai.http.status_code": {
681
- readonly type: "number";
682
- readonly description: "Final HTTP status";
683
- };
684
- readonly "pi.ai.usage.input_tokens": {
685
- readonly type: "number";
686
- readonly description: "Reported input tokens";
687
- };
688
- readonly "pi.ai.usage.output_tokens": {
689
- readonly type: "number";
690
- readonly description: "Reported output tokens";
691
- };
692
- readonly "pi.ai.usage.cache_read_tokens": {
693
- readonly type: "number";
694
- readonly description: "Reported cache-read tokens";
695
- };
696
- readonly "pi.ai.usage.cache_write_tokens": {
697
- readonly type: "number";
698
- readonly description: "Reported cache-write tokens";
699
- };
700
- readonly "pi.ai.usage.reasoning_tokens": {
701
- readonly type: "number";
702
- readonly description: "Reported reasoning tokens";
703
- };
704
- readonly "pi.ai.usage.total_tokens": {
705
- readonly type: "number";
706
- readonly description: "Reported total tokens";
707
- };
708
- readonly "pi.ai.usage.cost": {
709
- readonly type: "number";
710
- readonly description: "Reported total cost";
711
- };
712
- readonly "pi.ai.stream.chunk_count": {
713
- readonly type: "number";
714
- readonly description: "Streamed update chunk count";
715
- };
716
- readonly "pi.ai.stream.time_to_first_chunk_ms": {
717
- readonly type: "number";
718
- readonly description: "Elapsed milliseconds to first update chunk";
719
- };
720
- readonly "pi.ai.error.type": {
721
- readonly type: "string";
722
- readonly cardinality: "low";
723
- readonly description: "Provider or transport error class";
724
- };
725
- };
726
- readonly status: {
727
- readonly default: "ok";
728
- readonly errorWhen: "The operation throws or returns an error result";
729
- };
730
- };
731
- };
732
- }, {
733
- readonly version: 1;
734
- readonly spans: {
735
- readonly "pi.harness.run": {
736
- readonly description: "One admitted in-process run invocation";
737
- readonly parents: {
738
- readonly kind: "root_or_external";
739
- };
740
- readonly startAttributes: {
741
- readonly "pi.session.id": {
742
- readonly type: "string";
743
- readonly required: true;
744
- readonly cardinality: "high";
745
- readonly description: "Session id";
746
- };
747
- readonly "pi.lane.name": {
748
- readonly type: "string";
749
- readonly required: true;
750
- readonly cardinality: "high";
751
- readonly description: "Lane name";
752
- };
753
- readonly "pi.operation.id": {
754
- readonly type: "string";
755
- readonly required: true;
756
- readonly cardinality: "high";
757
- readonly description: "Durable operation id";
758
- };
759
- readonly "pi.operation.recovery": {
760
- readonly type: "boolean";
761
- readonly required: true;
762
- readonly description: "Whether this invocation resumes durable work";
763
- };
764
- readonly "pi.operation.kind": {
765
- readonly type: "string";
766
- readonly required: true;
767
- readonly values: readonly ["run"];
768
- readonly description: "Run operation kind";
769
- };
770
- };
771
- readonly endAttributes: {
772
- readonly "pi.error.code": {
773
- readonly type: "string";
774
- readonly cardinality: "low";
775
- readonly description: "Stable operation error code";
776
- };
777
- readonly "pi.error.type": {
778
- readonly type: "string";
779
- readonly cardinality: "low";
780
- readonly description: "Low-cardinality operation error class";
781
- };
782
- readonly "pi.operation.outcome": {
783
- readonly type: "string";
784
- readonly values: readonly ["completed", "aborted", "failed", "suspended"];
785
- readonly description: "Run invocation outcome";
786
- };
787
- };
788
- readonly status: {
789
- readonly default: "ok";
790
- readonly errorWhen: "The run fails or throws";
791
- };
792
- };
793
- readonly "pi.harness.compaction": {
794
- readonly description: "One admitted in-process manual compaction invocation";
795
- readonly parents: {
796
- readonly kind: "root_or_external";
797
- };
798
- readonly startAttributes: {
799
- readonly "pi.session.id": {
800
- readonly type: "string";
801
- readonly required: true;
802
- readonly cardinality: "high";
803
- readonly description: "Session id";
804
- };
805
- readonly "pi.lane.name": {
806
- readonly type: "string";
807
- readonly required: true;
808
- readonly cardinality: "high";
809
- readonly description: "Lane name";
810
- };
811
- readonly "pi.operation.id": {
812
- readonly type: "string";
813
- readonly required: true;
814
- readonly cardinality: "high";
815
- readonly description: "Durable operation id";
816
- };
817
- readonly "pi.operation.recovery": {
818
- readonly type: "boolean";
819
- readonly required: true;
820
- readonly description: "Whether this invocation resumes durable work";
821
- };
822
- readonly "pi.operation.kind": {
823
- readonly type: "string";
824
- readonly required: true;
825
- readonly values: readonly ["compaction"];
826
- readonly description: "Compaction operation kind";
827
- };
828
- };
829
- readonly endAttributes: {
830
- readonly "pi.error.code": {
831
- readonly type: "string";
832
- readonly cardinality: "low";
833
- readonly description: "Stable operation error code";
834
- };
835
- readonly "pi.error.type": {
836
- readonly type: "string";
837
- readonly cardinality: "low";
838
- readonly description: "Low-cardinality operation error class";
839
- };
840
- readonly "pi.operation.outcome": {
841
- readonly type: "string";
842
- readonly values: readonly ["completed", "declined", "aborted", "failed"];
843
- readonly description: "Compaction invocation outcome";
844
- };
845
- };
846
- readonly status: {
847
- readonly default: "ok";
848
- readonly errorWhen: "The compaction fails or throws";
849
- };
850
- };
851
- readonly "pi.harness.navigation": {
852
- readonly description: "One admitted in-process navigation invocation";
853
- readonly parents: {
854
- readonly kind: "root_or_external";
855
- };
856
- readonly startAttributes: {
857
- readonly "pi.session.id": {
858
- readonly type: "string";
859
- readonly required: true;
860
- readonly cardinality: "high";
861
- readonly description: "Session id";
862
- };
863
- readonly "pi.lane.name": {
864
- readonly type: "string";
865
- readonly required: true;
866
- readonly cardinality: "high";
867
- readonly description: "Lane name";
868
- };
869
- readonly "pi.operation.id": {
870
- readonly type: "string";
871
- readonly required: true;
872
- readonly cardinality: "high";
873
- readonly description: "Durable operation id";
874
- };
875
- readonly "pi.operation.recovery": {
876
- readonly type: "boolean";
877
- readonly required: true;
878
- readonly description: "Whether this invocation resumes durable work";
879
- };
880
- readonly "pi.operation.kind": {
881
- readonly type: "string";
882
- readonly required: true;
883
- readonly values: readonly ["navigation"];
884
- readonly description: "Navigation operation kind";
885
- };
886
- };
887
- readonly endAttributes: {
888
- readonly "pi.error.code": {
889
- readonly type: "string";
890
- readonly cardinality: "low";
891
- readonly description: "Stable operation error code";
892
- };
893
- readonly "pi.error.type": {
894
- readonly type: "string";
895
- readonly cardinality: "low";
896
- readonly description: "Low-cardinality operation error class";
897
- };
898
- readonly "pi.operation.outcome": {
899
- readonly type: "string";
900
- readonly values: readonly ["completed", "declined", "aborted", "failed"];
901
- readonly description: "Navigation invocation outcome";
902
- };
903
- };
904
- readonly status: {
905
- readonly default: "ok";
906
- readonly errorWhen: "The navigation fails or throws";
907
- };
908
- };
909
- readonly "pi.harness.checkpoint": {
910
- readonly description: "One run checkpoint";
911
- readonly parents: {
912
- readonly kind: "spans";
913
- readonly spans: readonly ["pi.harness.run"];
914
- };
915
- readonly startAttributes: {
916
- readonly "pi.lane.name": {
917
- readonly type: "string";
918
- readonly required: true;
919
- readonly cardinality: "high";
920
- readonly description: "Lane name";
921
- };
922
- readonly "pi.operation.id": {
923
- readonly type: "string";
924
- readonly required: true;
925
- readonly cardinality: "high";
926
- readonly description: "Durable operation id";
927
- };
928
- readonly "pi.checkpoint.kind": {
929
- readonly type: "string";
930
- readonly required: true;
931
- readonly values: readonly ["normal", "abort_reconcile"];
932
- readonly description: "Checkpoint purpose";
933
- };
934
- };
935
- readonly endAttributes: {};
936
- readonly status: {
937
- readonly default: "ok";
938
- readonly errorWhen: "Checkpoint work throws";
939
- };
940
- };
941
- readonly "pi.harness.turn": {
942
- readonly description: "One assistant response and its tool batch";
943
- readonly parents: {
944
- readonly kind: "spans";
945
- readonly spans: readonly ["pi.harness.run"];
946
- };
947
- readonly startAttributes: {
948
- readonly "pi.lane.name": {
949
- readonly type: "string";
950
- readonly required: true;
951
- readonly cardinality: "high";
952
- readonly description: "Lane name";
953
- };
954
- readonly "pi.operation.id": {
955
- readonly type: "string";
956
- readonly required: true;
957
- readonly cardinality: "high";
958
- readonly description: "Durable operation id";
959
- };
960
- readonly "pi.turn.id": {
961
- readonly type: "string";
962
- readonly required: true;
963
- readonly cardinality: "high";
964
- readonly description: "Invocation-local turn id";
965
- };
966
- };
967
- readonly endAttributes: {};
968
- readonly status: {
969
- readonly default: "ok";
970
- readonly errorWhen: "Turn work throws";
971
- };
972
- };
973
- readonly "pi.harness.step": {
974
- readonly description: "One durable retry attempt";
975
- readonly parents: {
976
- readonly kind: "spans";
977
- readonly spans: readonly ["pi.harness.turn", "pi.harness.checkpoint", "pi.harness.compaction", "pi.harness.navigation"];
978
- };
979
- readonly startAttributes: {
980
- readonly "pi.lane.name": {
981
- readonly type: "string";
982
- readonly required: true;
983
- readonly cardinality: "high";
984
- readonly description: "Lane name";
985
- };
986
- readonly "pi.operation.id": {
987
- readonly type: "string";
988
- readonly required: true;
989
- readonly cardinality: "high";
990
- readonly description: "Durable operation id";
991
- };
992
- readonly "pi.step.kind": {
993
- readonly type: "string";
994
- readonly required: true;
995
- readonly values: readonly ["assistant", "compaction", "branch_summary"];
996
- readonly description: "Retryable step kind";
997
- };
998
- readonly "pi.step.attempt": {
999
- readonly type: "number";
1000
- readonly required: true;
1001
- readonly description: "One-based durable attempt number";
1002
- };
1003
- readonly "pi.compaction.reason": {
1004
- readonly type: "string";
1005
- readonly required: false;
1006
- readonly values: readonly ["manual", "threshold", "overflow"];
1007
- readonly description: "Compaction trigger";
1008
- };
1009
- };
1010
- readonly endAttributes: {
1011
- readonly "pi.step.outcome": {
1012
- readonly type: "string";
1013
- readonly values: readonly ["succeeded", "retry", "failed", "aborted", "deferred", "overflow"];
1014
- readonly description: "Attempt outcome";
1015
- };
1016
- };
1017
- readonly status: {
1018
- readonly default: "ok";
1019
- readonly errorWhen: "The attempt retries, fails, or throws";
1020
- };
1021
- };
1022
- readonly "pi.harness.tool": {
1023
- readonly description: "One raw phase-2 tool execution";
1024
- readonly parents: {
1025
- readonly kind: "spans";
1026
- readonly spans: readonly ["pi.harness.turn", "pi.harness.run"];
1027
- };
1028
- readonly startAttributes: {
1029
- readonly "pi.lane.name": {
1030
- readonly type: "string";
1031
- readonly required: true;
1032
- readonly cardinality: "high";
1033
- readonly description: "Lane name";
1034
- };
1035
- readonly "pi.operation.id": {
1036
- readonly type: "string";
1037
- readonly required: true;
1038
- readonly cardinality: "high";
1039
- readonly description: "Durable operation id";
1040
- };
1041
- readonly "pi.turn.id": {
1042
- readonly type: "string";
1043
- readonly required: false;
1044
- readonly cardinality: "high";
1045
- readonly description: "Invocation-local live turn id";
1046
- };
1047
- readonly "pi.tool.name": {
1048
- readonly type: "string";
1049
- readonly required: true;
1050
- readonly description: "Tool name";
1051
- };
1052
- readonly "pi.tool.call_id": {
1053
- readonly type: "string";
1054
- readonly required: true;
1055
- readonly cardinality: "high";
1056
- readonly description: "Tool call id";
1057
- };
1058
- readonly "pi.tool.replay": {
1059
- readonly type: "string";
1060
- readonly required: true;
1061
- readonly values: readonly ["never", "safe"];
1062
- readonly description: "Declared replay policy";
1063
- };
1064
- readonly "pi.tool.recovery": {
1065
- readonly type: "boolean";
1066
- readonly required: true;
1067
- readonly description: "Whether this is recovery execution";
1068
- };
1069
- };
1070
- readonly endAttributes: {
1071
- readonly "pi.tool.is_error": {
1072
- readonly type: "boolean";
1073
- readonly description: "Whether raw phase-2 execution returned an error";
1074
- };
1075
- };
1076
- readonly status: {
1077
- readonly default: "ok";
1078
- readonly errorWhen: "Raw phase-2 execution returns an error";
1079
- };
1080
- };
1081
- readonly "pi.harness.hook": {
1082
- readonly description: "One registered hook handler invocation";
1083
- readonly parents: {
1084
- readonly kind: "any";
1085
- };
1086
- readonly startAttributes: {
1087
- readonly "pi.lane.name": {
1088
- readonly type: "string";
1089
- readonly required: true;
1090
- readonly cardinality: "high";
1091
- readonly description: "Lane name";
1092
- };
1093
- readonly "pi.operation.id": {
1094
- readonly type: "string";
1095
- readonly required: false;
1096
- readonly cardinality: "high";
1097
- readonly description: "Durable operation id when accepted";
1098
- };
1099
- readonly "pi.hook.name": {
1100
- readonly type: "string";
1101
- readonly required: true;
1102
- readonly values: readonly ["before_run", "before_drive", "before_run_end", "transform_context", "before_request", "before_payload", "after_response", "before_tool", "after_tool", "before_compaction", "before_navigation"];
1103
- readonly description: "Hook name";
1104
- };
1105
- readonly "pi.hook.registration_id": {
1106
- readonly type: "string";
1107
- readonly required: false;
1108
- readonly description: "Optional hook registration metadata";
1109
- };
1110
- };
1111
- readonly endAttributes: {
1112
- readonly "pi.hook.outcome": {
1113
- readonly type: "string";
1114
- readonly values: readonly ["completed", "skipped", "blocked", "failed"];
1115
- readonly description: "Handler outcome";
1116
- };
1117
- };
1118
- readonly status: {
1119
- readonly default: "ok";
1120
- readonly errorWhen: "The handler throws";
1121
- };
1122
- };
1123
- readonly "pi.harness.sleep": {
1124
- readonly description: "One retry delay";
1125
- readonly parents: {
1126
- readonly kind: "spans";
1127
- readonly spans: readonly ["pi.harness.run", "pi.harness.compaction", "pi.harness.navigation", "pi.harness.turn", "pi.harness.checkpoint"];
1128
- };
1129
- readonly startAttributes: {
1130
- readonly "pi.operation.id": {
1131
- readonly type: "string";
1132
- readonly required: true;
1133
- readonly cardinality: "high";
1134
- readonly description: "Durable operation id";
1135
- };
1136
- readonly "pi.sleep.delay_ms": {
1137
- readonly type: "number";
1138
- readonly required: true;
1139
- readonly description: "Requested delay in milliseconds";
1140
- };
1141
- };
1142
- readonly endAttributes: {
1143
- readonly "pi.sleep.outcome": {
1144
- readonly type: "string";
1145
- readonly values: readonly ["elapsed", "aborted"];
1146
- readonly description: "Delay outcome";
1147
- };
1148
- };
1149
- readonly status: {
1150
- readonly default: "ok";
1151
- readonly errorWhen: "Sleep work throws";
1152
- };
1153
- };
1154
- readonly "pi.harness.event_handler": {
1155
- readonly description: "One passive event listener invocation";
1156
- readonly parents: {
1157
- readonly kind: "any";
1158
- };
1159
- readonly startAttributes: {
1160
- readonly "pi.event.type": {
1161
- readonly type: "string";
1162
- readonly required: true;
1163
- readonly cardinality: "low";
1164
- readonly values: readonly ["run_start", "run_resume", "run_suspend", "operation_abort", "run_end", "fault", "handler_error", "turn_start", "turn_end", "retry_scheduled", "retry_start", "retry_end", "message_start", "message_update", "message_end", "tool_start", "tool_update", "tool_end", "entry_added", "queue_update", "value_update", "config_update", "compaction_start", "compaction_end", "navigation_start", "navigation_end", "lane_created", "usage"];
1165
- readonly description: "Delivered harness event type";
1166
- };
1167
- readonly "pi.lane.name": {
1168
- readonly type: "string";
1169
- readonly required: false;
1170
- readonly cardinality: "high";
1171
- readonly description: "Lane name for lane-scoped events";
1172
- };
1173
- };
1174
- readonly endAttributes: {};
1175
- readonly status: {
1176
- readonly default: "ok";
1177
- readonly errorWhen: "The listener throws";
1178
- };
1179
- };
1180
- readonly "pi.session.write": {
1181
- readonly description: "One committed session transaction";
1182
- readonly parents: {
1183
- readonly kind: "any";
1184
- };
1185
- readonly startAttributes: {
1186
- readonly "pi.session.id": {
1187
- readonly type: "string";
1188
- readonly required: true;
1189
- readonly cardinality: "high";
1190
- readonly description: "Session id";
1191
- };
1192
- readonly "pi.lane.name": {
1193
- readonly type: "string";
1194
- readonly required: false;
1195
- readonly cardinality: "high";
1196
- readonly description: "Lane name when supplied by the caller";
1197
- };
1198
- readonly "pi.operation.id": {
1199
- readonly type: "string";
1200
- readonly required: false;
1201
- readonly cardinality: "high";
1202
- readonly description: "Durable operation id when supplied by the caller";
1203
- };
1204
- readonly "pi.session.item_count": {
1205
- readonly type: "number";
1206
- readonly required: true;
1207
- readonly description: "Number of writes in the transaction";
1208
- };
1209
- readonly "pi.session.item_kinds": {
1210
- readonly type: "string[]";
1211
- readonly required: true;
1212
- readonly elementValues: readonly ["entry", "usage", "value", "list"];
1213
- readonly description: "Distinct write kinds in the transaction";
1214
- };
1215
- };
1216
- readonly endAttributes: {
1217
- readonly "pi.session.first_seq": {
1218
- readonly type: "number";
1219
- readonly description: "First committed sequence in the transaction";
1220
- };
1221
- readonly "pi.session.last_seq": {
1222
- readonly type: "number";
1223
- readonly description: "Last committed sequence in the transaction";
1224
- };
1225
- };
1226
- readonly status: {
1227
- readonly default: "ok";
1228
- readonly errorWhen: "Storage rejects the transaction";
1229
- };
1230
- };
1231
- };
1232
- }];
1233
- export type HarnessSpanName = TelemetrySchemaSpanName<typeof HARNESS_TELEMETRY_SCHEMA>;
1234
- export type HarnessSpanStartAttributes<Name extends HarnessSpanName> = TelemetrySchemaSpanStartAttributes<typeof HARNESS_TELEMETRY_SCHEMA, Name>;
1235
- export type HarnessSpanEndAttributes<Name extends HarnessSpanName> = TelemetrySchemaSpanEndAttributes<typeof HARNESS_TELEMETRY_SCHEMA, Name>;
1236
- export type HarnessSpanAttributes<Name extends HarnessSpanName> = HarnessSpanStartAttributes<Name> & HarnessSpanEndAttributes<Name>;
1237
- export type HarnessSpanEventName<Name extends HarnessSpanName> = TelemetrySchemaSpanEventName<typeof HARNESS_TELEMETRY_SCHEMA, Name>;
1238
- export type HarnessSpanEventAttributes<Name extends HarnessSpanName, EventName extends HarnessSpanEventName<Name>> = TelemetrySchemaSpanEventAttributes<typeof HARNESS_TELEMETRY_SCHEMA, Name, EventName>;
1239
- export type HarnessTelemetrySpan<Name extends HarnessSpanName> = SchemaTelemetrySpan<typeof HARNESS_TELEMETRY_SCHEMA, Name>;
1240
- export type HarnessSpan = TelemetrySchemaSpanUnion<typeof HARNESS_TELEMETRY_SCHEMA>;
1241
- export declare function startHarnessSpan<Name extends HarnessSpanName, const Attributes extends HarnessSpanStartAttributes<Name>, Result>(name: Name, attributes: ExactTelemetryAttributes<HarnessSpanStartAttributes<Name>, Attributes>, callback: (span: HarnessTelemetrySpan<Name>, context: Context) => Result | Promise<Result>, context: Context): Promise<Result>;
1242
- //# sourceMappingURL=telemetry.d.ts.map