@agent-watch-ai/edge 0.2.5 → 0.4.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 (348) hide show
  1. package/CHANGELOG.md +558 -0
  2. package/README.md +222 -97
  3. package/SECURITY.md +72 -0
  4. package/dist/billing/session-billing.d.ts +19 -0
  5. package/dist/billing/session-billing.js +52 -0
  6. package/dist/cli/args.d.ts +10 -0
  7. package/dist/cli/args.js +20 -0
  8. package/dist/cli/constants/cli.constants.d.ts +52 -4
  9. package/dist/cli/constants/cli.constants.js +56 -5
  10. package/dist/cli/context.d.ts +33 -2
  11. package/dist/cli/context.js +84 -14
  12. package/dist/cli/doctor.js +321 -33
  13. package/dist/cli/hook-check.d.ts +23 -0
  14. package/dist/cli/hook-check.js +114 -0
  15. package/dist/cli/hook.js +118 -7
  16. package/dist/cli/index.d.ts +3 -1
  17. package/dist/cli/index.js +3 -1
  18. package/dist/cli/misc.d.ts +11 -0
  19. package/dist/cli/misc.js +80 -4
  20. package/dist/cli/npx-install.d.ts +37 -0
  21. package/dist/cli/npx-install.js +79 -0
  22. package/dist/cli/open-browser.d.ts +39 -0
  23. package/dist/cli/open-browser.js +62 -0
  24. package/dist/cli/setup.d.ts +17 -8
  25. package/dist/cli/setup.js +553 -103
  26. package/dist/cli/status.js +82 -13
  27. package/dist/cli/toggle.d.ts +9 -0
  28. package/dist/cli/toggle.js +117 -0
  29. package/dist/cli/types/cli.types.d.ts +43 -3
  30. package/dist/cli/ui.d.ts +7 -0
  31. package/dist/cli/ui.js +10 -1
  32. package/dist/cli/uninstall.js +39 -2
  33. package/dist/cli/update.d.ts +17 -0
  34. package/dist/cli/update.js +76 -0
  35. package/dist/cli.js +110 -12
  36. package/dist/config/config-store.d.ts +57 -0
  37. package/dist/config/config-store.js +250 -12
  38. package/dist/config/config.d.ts +53 -6
  39. package/dist/config/config.js +66 -6
  40. package/dist/config/constants/config.constants.d.ts +116 -6
  41. package/dist/config/constants/config.constants.js +131 -8
  42. package/dist/config/destination.d.ts +24 -0
  43. package/dist/config/destination.js +33 -0
  44. package/dist/config/index.d.ts +7 -4
  45. package/dist/config/index.js +5 -3
  46. package/dist/config/repo-config.d.ts +11 -7
  47. package/dist/config/repo-config.js +64 -15
  48. package/dist/config/root-config.d.ts +72 -0
  49. package/dist/config/root-config.js +170 -0
  50. package/dist/config/schemas/config.schema.d.ts +831 -84
  51. package/dist/config/schemas/config.schema.js +398 -16
  52. package/dist/config/types/config.types.d.ts +15 -1
  53. package/dist/config/types/destination.types.d.ts +8 -0
  54. package/dist/core/async.d.ts +36 -0
  55. package/dist/core/async.js +68 -0
  56. package/dist/core/index.d.ts +1 -1
  57. package/dist/core/index.js +1 -1
  58. package/dist/core/object.d.ts +5 -0
  59. package/dist/core/object.js +9 -4
  60. package/dist/core/pipe.d.ts +0 -13
  61. package/dist/core/pipe.js +1 -9
  62. package/dist/core/types/core.types.d.ts +9 -0
  63. package/dist/core/types/core.types.js +0 -3
  64. package/dist/core/which.d.ts +14 -0
  65. package/dist/core/which.js +43 -3
  66. package/dist/credentials/budget.d.ts +9 -0
  67. package/dist/credentials/budget.js +16 -0
  68. package/dist/credentials/command-runner.d.ts +16 -0
  69. package/dist/credentials/command-runner.js +37 -0
  70. package/dist/credentials/constants/credentials.constants.d.ts +119 -0
  71. package/dist/credentials/constants/credentials.constants.js +120 -0
  72. package/dist/credentials/credential-status.d.ts +14 -0
  73. package/dist/credentials/credential-status.js +38 -0
  74. package/dist/credentials/credentials.d.ts +86 -0
  75. package/dist/credentials/credentials.js +278 -0
  76. package/dist/credentials/device-api.d.ts +73 -0
  77. package/dist/credentials/device-api.js +161 -0
  78. package/dist/credentials/device-state.d.ts +31 -0
  79. package/dist/credentials/device-state.js +51 -0
  80. package/dist/credentials/identity.d.ts +73 -0
  81. package/dist/credentials/identity.js +101 -0
  82. package/dist/credentials/index.d.ts +7 -0
  83. package/dist/credentials/index.js +5 -0
  84. package/dist/credentials/migration.d.ts +46 -0
  85. package/dist/credentials/migration.js +164 -0
  86. package/dist/credentials/schemas/device-api.schema.d.ts +77 -0
  87. package/dist/credentials/schemas/device-api.schema.js +33 -0
  88. package/dist/credentials/schemas/device-state.schema.d.ts +51 -0
  89. package/dist/credentials/schemas/device-state.schema.js +20 -0
  90. package/dist/credentials/secret-store.d.ts +54 -0
  91. package/dist/credentials/secret-store.js +217 -0
  92. package/dist/credentials/sign-in.d.ts +31 -0
  93. package/dist/credentials/sign-in.js +105 -0
  94. package/dist/credentials/token-refresher.d.ts +39 -0
  95. package/dist/credentials/token-refresher.js +185 -0
  96. package/dist/credentials/types/credentials.types.d.ts +206 -0
  97. package/dist/credentials/types/credentials.types.js +1 -0
  98. package/dist/enforcement/constants/enforcement.constants.d.ts +47 -1
  99. package/dist/enforcement/constants/enforcement.constants.js +56 -0
  100. package/dist/enforcement/decision-cache.d.ts +20 -1
  101. package/dist/enforcement/decision-cache.js +65 -2
  102. package/dist/enforcement/decision-client.d.ts +9 -8
  103. package/dist/enforcement/decision-client.js +64 -17
  104. package/dist/enforcement/enforcement.d.ts +23 -2
  105. package/dist/enforcement/enforcement.js +107 -17
  106. package/dist/enforcement/index.d.ts +4 -3
  107. package/dist/enforcement/index.js +3 -2
  108. package/dist/enforcement/types/enforcement.types.d.ts +66 -2
  109. package/dist/enrollment/constants/enrollment.constants.d.ts +2 -6
  110. package/dist/enrollment/constants/enrollment.constants.js +2 -6
  111. package/dist/enrollment/enrollment.d.ts +16 -0
  112. package/dist/enrollment/enrollment.js +54 -0
  113. package/dist/enrollment/index.d.ts +3 -7
  114. package/dist/enrollment/index.js +1 -1
  115. package/dist/enrollment/types/enrollment.types.d.ts +9 -13
  116. package/dist/events/constants/enrich.constants.d.ts +15 -0
  117. package/dist/events/constants/enrich.constants.js +15 -0
  118. package/dist/events/constants/events.constants.d.ts +6 -2
  119. package/dist/events/constants/events.constants.js +5 -1
  120. package/dist/events/enrich.js +92 -10
  121. package/dist/events/event-id.d.ts +0 -8
  122. package/dist/events/event-id.js +0 -10
  123. package/dist/events/index.d.ts +2 -2
  124. package/dist/events/index.js +1 -1
  125. package/dist/events/product-event.d.ts +9 -6
  126. package/dist/events/types/repo-snapshot.types.d.ts +7 -0
  127. package/dist/events/types/session-billing.types.d.ts +16 -0
  128. package/dist/events/types/session-billing.types.js +1 -0
  129. package/dist/feature/constants/feature.constants.d.ts +7 -0
  130. package/dist/feature/constants/feature.constants.js +7 -0
  131. package/dist/feature/index.d.ts +1 -1
  132. package/dist/feature/index.js +1 -1
  133. package/dist/feature/ticket-candidates.d.ts +14 -0
  134. package/dist/feature/ticket-candidates.js +26 -8
  135. package/dist/git/blob-hash.d.ts +21 -0
  136. package/dist/git/blob-hash.js +69 -0
  137. package/dist/git/checkout-root.d.ts +27 -0
  138. package/dist/git/checkout-root.js +75 -0
  139. package/dist/git/constants/git.constants.d.ts +160 -0
  140. package/dist/git/constants/git.constants.js +181 -0
  141. package/dist/git/fingerprint.d.ts +74 -0
  142. package/dist/git/fingerprint.js +219 -0
  143. package/dist/git/gate-checkout.d.ts +44 -0
  144. package/dist/git/gate-checkout.js +201 -0
  145. package/dist/git/git-context.d.ts +45 -0
  146. package/dist/git/git-context.js +61 -3
  147. package/dist/git/index.d.ts +4 -2
  148. package/dist/git/index.js +2 -1
  149. package/dist/git/manifest-repository.d.ts +13 -0
  150. package/dist/git/manifest-repository.js +92 -0
  151. package/dist/git/repo-snapshot.d.ts +29 -3
  152. package/dist/git/repo-snapshot.js +110 -7
  153. package/dist/git/repository-root.d.ts +39 -0
  154. package/dist/git/repository-root.js +131 -0
  155. package/dist/git/types/git.types.d.ts +55 -0
  156. package/dist/git/types/repository-root.types.d.ts +11 -0
  157. package/dist/git/types/repository-root.types.js +1 -0
  158. package/dist/git/types/snapshot.types.d.ts +9 -0
  159. package/dist/pipeline/constants/pipeline.constants.d.ts +10 -0
  160. package/dist/pipeline/constants/pipeline.constants.js +10 -0
  161. package/dist/pipeline/hook-pipeline.js +410 -33
  162. package/dist/pipeline/types/pipeline.types.d.ts +39 -4
  163. package/dist/privacy/constants/privacy.constants.js +15 -1
  164. package/dist/privacy/index.d.ts +1 -0
  165. package/dist/privacy/index.js +1 -0
  166. package/dist/privacy/product-capture.d.ts +12 -0
  167. package/dist/privacy/product-capture.js +75 -0
  168. package/dist/privacy/sanitizer.d.ts +21 -3
  169. package/dist/privacy/sanitizer.js +52 -8
  170. package/dist/process/ancestors.d.ts +39 -0
  171. package/dist/process/ancestors.js +121 -0
  172. package/dist/process/constants/process.constants.d.ts +34 -0
  173. package/dist/process/constants/process.constants.js +34 -0
  174. package/dist/process/index.d.ts +7 -0
  175. package/dist/process/index.js +2 -0
  176. package/dist/process/types/process.types.d.ts +23 -0
  177. package/dist/process/types/process.types.js +1 -0
  178. package/dist/providers/antigravity/antigravity.adapter.d.ts +12 -1
  179. package/dist/providers/antigravity/antigravity.adapter.js +21 -3
  180. package/dist/providers/antigravity/antigravity.detect.d.ts +0 -9
  181. package/dist/providers/antigravity/antigravity.detect.js +1 -1
  182. package/dist/providers/antigravity/antigravity.provider.js +3 -2
  183. package/dist/providers/antigravity/constants/antigravity.constants.d.ts +2 -0
  184. package/dist/providers/antigravity/constants/antigravity.constants.js +2 -0
  185. package/dist/providers/claude/claude.adapter.d.ts +11 -1
  186. package/dist/providers/claude/claude.adapter.js +26 -5
  187. package/dist/providers/claude/claude.otel.d.ts +32 -18
  188. package/dist/providers/claude/claude.otel.js +81 -6
  189. package/dist/providers/claude/claude.provider.js +5 -2
  190. package/dist/providers/claude/constants/claude.constants.d.ts +2 -0
  191. package/dist/providers/claude/constants/claude.constants.js +2 -0
  192. package/dist/providers/claude/constants/claude.otel.constants.d.ts +4 -0
  193. package/dist/providers/claude/constants/claude.otel.constants.js +8 -0
  194. package/dist/providers/codex/codex.adapter.d.ts +15 -1
  195. package/dist/providers/codex/codex.adapter.js +29 -5
  196. package/dist/providers/codex/codex.otel.d.ts +36 -3
  197. package/dist/providers/codex/codex.otel.js +199 -32
  198. package/dist/providers/codex/codex.provider.js +5 -2
  199. package/dist/providers/codex/constants/codex.constants.d.ts +2 -0
  200. package/dist/providers/codex/constants/codex.constants.js +16 -0
  201. package/dist/providers/codex/constants/codex.otel.constants.d.ts +10 -0
  202. package/dist/providers/codex/constants/codex.otel.constants.js +10 -0
  203. package/dist/providers/constants/provider.constants.d.ts +8 -3
  204. package/dist/providers/constants/provider.constants.js +8 -3
  205. package/dist/providers/cursor/constants/cursor.constants.d.ts +9 -0
  206. package/dist/providers/cursor/constants/cursor.constants.js +9 -0
  207. package/dist/providers/cursor/cursor.adapter.d.ts +33 -1
  208. package/dist/providers/cursor/cursor.adapter.js +129 -4
  209. package/dist/providers/cursor/cursor.detect.d.ts +0 -7
  210. package/dist/providers/cursor/cursor.detect.js +1 -1
  211. package/dist/providers/cursor/cursor.provider.js +5 -2
  212. package/dist/providers/gemini/constants/gemini.constants.d.ts +9 -0
  213. package/dist/providers/gemini/constants/gemini.constants.js +9 -0
  214. package/dist/providers/gemini/constants/gemini.otel.constants.d.ts +9 -1
  215. package/dist/providers/gemini/constants/gemini.otel.constants.js +9 -0
  216. package/dist/providers/gemini/gemini.adapter.d.ts +14 -1
  217. package/dist/providers/gemini/gemini.adapter.js +25 -5
  218. package/dist/providers/gemini/gemini.detect.d.ts +0 -7
  219. package/dist/providers/gemini/gemini.detect.js +1 -1
  220. package/dist/providers/gemini/gemini.otel.d.ts +30 -21
  221. package/dist/providers/gemini/gemini.otel.js +166 -22
  222. package/dist/providers/gemini/gemini.provider.js +2 -1
  223. package/dist/providers/index.d.ts +1 -1
  224. package/dist/providers/index.js +1 -1
  225. package/dist/providers/loaders.d.ts +10 -0
  226. package/dist/providers/loaders.js +40 -0
  227. package/dist/providers/provider.d.ts +11 -0
  228. package/dist/providers/provider.js +1 -1
  229. package/dist/providers/registry.d.ts +11 -8
  230. package/dist/providers/registry.js +11 -15
  231. package/dist/providers/shared/bearer-rewrite.d.ts +19 -0
  232. package/dist/providers/shared/bearer-rewrite.js +46 -0
  233. package/dist/providers/shared/constants/hook-refusal.constants.d.ts +7 -0
  234. package/dist/providers/shared/constants/hook-refusal.constants.js +7 -0
  235. package/dist/providers/shared/constants/shell-directories.constants.d.ts +30 -0
  236. package/dist/providers/shared/constants/shell-directories.constants.js +39 -0
  237. package/dist/providers/shared/constants/tooling.constants.d.ts +24 -2
  238. package/dist/providers/shared/constants/tooling.constants.js +25 -3
  239. package/dist/providers/shared/event-builder.d.ts +12 -14
  240. package/dist/providers/shared/event-builder.js +20 -14
  241. package/dist/providers/shared/exporter-allowlist.d.ts +20 -0
  242. package/dist/providers/shared/exporter-allowlist.js +49 -0
  243. package/dist/providers/shared/hook-config.d.ts +2 -21
  244. package/dist/providers/shared/hook-config.js +5 -4
  245. package/dist/providers/shared/hook-refusal.d.ts +12 -0
  246. package/dist/providers/shared/hook-refusal.js +17 -1
  247. package/dist/providers/shared/install-record.d.ts +12 -2
  248. package/dist/providers/shared/install-record.js +5 -2
  249. package/dist/providers/shared/shell-directories.d.ts +24 -0
  250. package/dist/providers/shared/shell-directories.js +90 -0
  251. package/dist/providers/shared/tooling.d.ts +40 -1
  252. package/dist/providers/shared/tooling.js +70 -1
  253. package/dist/providers/shared/types/adapter.types.d.ts +1 -2
  254. package/dist/providers/types/provider.types.d.ts +81 -1
  255. package/dist/snapshot/constants/snapshot.constants.d.ts +32 -0
  256. package/dist/snapshot/constants/snapshot.constants.js +33 -0
  257. package/dist/snapshot/snapshot-event.js +52 -11
  258. package/dist/snapshot/snapshot-pipeline.js +1 -1
  259. package/dist/snapshot/types/snapshot.types.d.ts +2 -0
  260. package/dist/storage/atomic-file.d.ts +21 -0
  261. package/dist/storage/atomic-file.js +20 -1
  262. package/dist/storage/constants/storage.constants.d.ts +19 -0
  263. package/dist/storage/constants/storage.constants.js +19 -0
  264. package/dist/storage/disabled.d.ts +13 -0
  265. package/dist/storage/disabled.js +24 -0
  266. package/dist/storage/index.d.ts +2 -0
  267. package/dist/storage/index.js +2 -0
  268. package/dist/storage/paths.js +3 -2
  269. package/dist/storage/schemas/storage.schema.d.ts +72 -0
  270. package/dist/storage/schemas/storage.schema.js +6 -0
  271. package/dist/storage/sweep-marker.d.ts +19 -0
  272. package/dist/storage/sweep-marker.js +55 -0
  273. package/dist/storage/types/storage.types.d.ts +2 -0
  274. package/dist/storage/uninstalled.d.ts +58 -0
  275. package/dist/storage/uninstalled.js +107 -0
  276. package/dist/transport/auth-block.d.ts +66 -0
  277. package/dist/transport/auth-block.js +129 -0
  278. package/dist/transport/constants/transport.constants.d.ts +82 -3
  279. package/dist/transport/constants/transport.constants.js +83 -4
  280. package/dist/transport/cooldown.js +8 -1
  281. package/dist/transport/delivery.d.ts +14 -6
  282. package/dist/transport/delivery.js +80 -55
  283. package/dist/transport/http-transport.d.ts +1 -0
  284. package/dist/transport/http-transport.js +52 -10
  285. package/dist/transport/index.d.ts +6 -3
  286. package/dist/transport/index.js +3 -0
  287. package/dist/transport/queue-partition.d.ts +91 -0
  288. package/dist/transport/queue-partition.js +143 -0
  289. package/dist/transport/queue.d.ts +99 -20
  290. package/dist/transport/queue.js +210 -69
  291. package/dist/transport/response-body.d.ts +25 -0
  292. package/dist/transport/response-body.js +64 -0
  293. package/dist/transport/send.d.ts +11 -0
  294. package/dist/transport/send.js +17 -0
  295. package/dist/transport/types/delivery-flow.types.d.ts +19 -0
  296. package/dist/transport/types/delivery-flow.types.js +1 -0
  297. package/dist/transport/types/transport.types.d.ts +45 -0
  298. package/dist/turns/claude-transcript.d.ts +19 -1
  299. package/dist/turns/claude-transcript.js +46 -1
  300. package/dist/turns/codex-originator.d.ts +11 -0
  301. package/dist/turns/codex-originator.js +31 -0
  302. package/dist/turns/codex-transcript.d.ts +30 -0
  303. package/dist/turns/codex-transcript.js +88 -0
  304. package/dist/turns/constants/turns.constants.d.ts +141 -5
  305. package/dist/turns/constants/turns.constants.js +155 -5
  306. package/dist/turns/file-identity.d.ts +27 -0
  307. package/dist/turns/file-identity.js +48 -0
  308. package/dist/turns/gemini-transcript.d.ts +30 -0
  309. package/dist/turns/gemini-transcript.js +96 -0
  310. package/dist/turns/index.d.ts +3 -3
  311. package/dist/turns/index.js +1 -1
  312. package/dist/turns/inherited-checkout.d.ts +54 -0
  313. package/dist/turns/inherited-checkout.js +155 -0
  314. package/dist/turns/native-session-titles.d.ts +26 -0
  315. package/dist/turns/native-session-titles.js +102 -0
  316. package/dist/turns/transcript.d.ts +3 -2
  317. package/dist/turns/transcript.js +5 -1
  318. package/dist/turns/turn-state.d.ts +224 -3
  319. package/dist/turns/turn-state.js +456 -21
  320. package/dist/turns/turn-summary.d.ts +1 -14
  321. package/dist/turns/turn-summary.js +87 -51
  322. package/dist/turns/turn-tracker.d.ts +21 -2
  323. package/dist/turns/turn-tracker.js +379 -56
  324. package/dist/turns/types/transcript.types.d.ts +5 -0
  325. package/dist/turns/types/turn-state.types.d.ts +116 -5
  326. package/dist/turns/types/turn-summary.types.d.ts +64 -14
  327. package/dist/turns/types/turn-tracker.types.d.ts +27 -1
  328. package/dist/turns/work-checkout.d.ts +67 -0
  329. package/dist/turns/work-checkout.js +700 -0
  330. package/dist/untraced/constants/untraced.constants.d.ts +31 -0
  331. package/dist/untraced/constants/untraced.constants.js +63 -0
  332. package/dist/untraced/untraced.d.ts +35 -0
  333. package/dist/untraced/untraced.js +105 -0
  334. package/dist/update/constants/update.constants.d.ts +18 -0
  335. package/dist/update/constants/update.constants.js +20 -0
  336. package/dist/update/update-check.d.ts +52 -0
  337. package/dist/update/update-check.js +113 -0
  338. package/docs/AUDIT_PROMPT.md +129 -0
  339. package/docs/DATA_HANDLING.md +655 -0
  340. package/docs/ENTERPRISE_DEPLOYMENT.md +194 -0
  341. package/docs/PERFORMANCE.md +81 -0
  342. package/package.json +14 -4
  343. package/dist/enrollment/enrollment-provider.d.ts +0 -5
  344. package/dist/enrollment/manual-enrollment.d.ts +0 -32
  345. package/dist/enrollment/manual-enrollment.js +0 -72
  346. package/example/README.md +0 -43
  347. package/example/server.mjs +0 -240
  348. /package/dist/{enrollment/enrollment-provider.js → config/types/destination.types.js} +0 -0
@@ -1,8 +1,9 @@
1
1
  import { compact } from '../core/object.js';
2
+ import { FAIL_OPEN_REASONS } from '../enforcement/constants/enforcement.constants.js';
2
3
  import { deriveEventId, sha256Hex } from '../events/event-id.js';
3
4
  import { EVENT_SCHEMA_VERSION } from '../events/constants/events.constants.js';
4
- import { contentEvidence } from '../providers/shared/tooling.js';
5
- import { MAX_TURN_FILES, PROMPT_JOIN_SEPARATOR, PROVIDER_LABELS, UNKNOWN_TOOL_NAME } from './constants/turns.constants.js';
5
+ import { sanitizeText } from '../privacy/sanitizer.js';
6
+ import { MAX_SESSION_TITLE_LENGTH, MAX_TURN_FILES, MAX_TURN_TOOL_INPUTS, PROVIDER_LABELS, UNKNOWN_TOOL_NAME } from './constants/turns.constants.js';
6
7
  /**
7
8
  * Flatten one turn's accumulated state into the single product record the hook
8
9
  * path emits.
@@ -16,7 +17,6 @@ import { MAX_TURN_FILES, PROMPT_JOIN_SEPARATOR, PROVIDER_LABELS, UNKNOWN_TOOL_NA
16
17
  */
17
18
  export function buildTurnSummary(input) {
18
19
  const files = collectToolUsage(input.tools);
19
- const promptText = joinPrompts(input.prompts);
20
20
  const startedAt = input.prompts[0]?.at;
21
21
  const turnId = input.turnId ?? input.prompts.find((prompt) => prompt.turnId)?.turnId;
22
22
  const jiraIds = ticketValues(input.featureCandidates);
@@ -41,17 +41,27 @@ export function buildTurnSummary(input) {
41
41
  session_id: input.sessionId,
42
42
  turn_id: turnId,
43
43
  developer_id: input.developerId,
44
+ developer_name: input.developerName,
44
45
  repository: input.git?.repository,
45
46
  branch: input.git?.branch,
46
47
  commit: input.git?.commit,
47
48
  jira_ids: jiraIds.length > 0 ? jiraIds : undefined,
49
+ prompt_jira_ids: input.promptJiraIds?.length ? input.promptJiraIds : undefined,
48
50
  files_changed: input.git?.changedFiles,
51
+ work_evidence: input.git?.repository ? input.workEvidence : undefined,
52
+ parent_session_id: input.parentSessionId,
53
+ content_hashes: input.contentHashes?.length ? input.contentHashes : undefined,
54
+ manifest_repository: input.manifestRepository,
49
55
  files_touched: files.filesTouched.length > 0 ? files.filesTouched : undefined,
50
56
  files_read: files.filesRead.length > 0 ? files.filesRead : undefined,
51
- prompt: promptText,
57
+ external_files_touched: files.externalTouched.length > 0 ? files.externalTouched : undefined,
58
+ external_files_read: files.externalRead.length > 0 ? files.externalRead : undefined,
52
59
  prompt_evidence: input.prompts[0]?.evidence,
53
- response: input.response?.text,
54
- response_evidence: input.response?.evidence,
60
+ prompt_text: input.prompts[0]?.text,
61
+ session_name: boundSessionTitle(input.sessionTitles?.custom),
62
+ session_title: boundSessionTitle(input.sessionTitles?.generated),
63
+ tool_inputs: files.toolInputs.length > 0 ? files.toolInputs : undefined,
64
+ response_evidence: input.response,
55
65
  tool_calls: input.tools.length,
56
66
  tools_used: files.toolsUsed,
57
67
  model: input.usage?.model ?? input.model,
@@ -62,60 +72,53 @@ export function buildTurnSummary(input) {
62
72
  cache_creation_input_tokens: input.usage?.cacheCreationInputTokens,
63
73
  output_tokens: input.usage?.outputTokens,
64
74
  usage_status: input.usage ? 'provisional' : 'pending',
75
+ enforcement_fail_open_reason: failOpenReasonOf(input.prompts, input.endedAt),
65
76
  started_at: startedAt,
66
77
  ended_at: input.endedAt
67
78
  });
68
79
  }
69
80
  /**
70
- * Recompute content evidence from the text that is actually transmitted.
81
+ * Tool call counts, the files the turn read versus modified, and its tool inputs.
71
82
  *
72
- * Evidence is captured before sanitization, but the sanitizer truncates and
73
- * redacts; a backend verifying length or hash against the received text would
74
- * then reject honest events. When the text is absent (capture disabled), the
75
- * capture-time evidence still describes the content the developer saw, and is
76
- * kept as the only description there is.
77
- *
78
- * @param summary - Summary about to be sent.
79
- * @returns A copy whose evidence matches its own text.
80
- */
81
- export function alignContentEvidence(summary) {
82
- return {
83
- ...summary,
84
- prompt_evidence: typeof summary.prompt === 'string' ? contentEvidence(summary.prompt) : summary.prompt_evidence,
85
- response_evidence: typeof summary.response === 'string' ? contentEvidence(summary.response) : summary.response_evidence
86
- };
87
- }
88
- /**
89
- * Tool call counts and the files the turn read versus modified.
90
- *
91
- * One pass over the records: tool counting and both file lists come from the
92
- * same iteration rather than three filter/map chains (STYLEGUIDE 3.3). Each
93
- * list stops growing at {@link MAX_TURN_FILES}, which is what keeps a
94
- * file-heavy turn a summary with a truncated list rather than a summary the
95
- * backend refuses whole.
83
+ * One pass over the records: tool counting, the file lists and the inputs come
84
+ * from the same iteration rather than chained filter/maps (STYLEGUIDE 3.3).
85
+ * Each list stops growing at its cap, which is what keeps a file-heavy turn a
86
+ * summary with a truncated list rather than a summary the backend refuses whole.
96
87
  *
97
88
  * @param tools - The turn's tool records.
98
- * @returns Per-tool counts and the two file lists.
89
+ * @returns Per-tool counts, the file lists and the inputs.
99
90
  */
100
91
  function collectToolUsage(tools) {
101
92
  const toolsUsed = {};
102
93
  const filesTouched = new Set();
103
94
  const filesRead = new Set();
95
+ const externalTouched = new Set();
96
+ const externalRead = new Set();
97
+ const toolInputs = [];
104
98
  for (const tool of tools) {
105
99
  const name = tool.tool ?? UNKNOWN_TOOL_NAME;
106
100
  toolsUsed[name] = (toolsUsed[name] ?? 0) + 1;
107
- if (!tool.filePath)
108
- continue;
101
+ if (tool.input && toolInputs.length < MAX_TURN_TOOL_INPUTS)
102
+ toolInputs.push(tool.input);
109
103
  // files_touched is documented as files the agent MODIFIED; pure reads get
110
104
  // their own list. Legacy records without an access marker stay in
111
105
  // files_touched (the historical behavior) rather than being dropped.
112
- if (tool.access === 'read') {
113
- addCapped(filesRead, tool.filePath);
114
- continue;
115
- }
116
- addCapped(filesTouched, tool.filePath);
106
+ const read = tool.access === 'read';
107
+ // A file outside every checkout keeps its bare basename in files_touched, as
108
+ // it always has, and adds its home-relative path to the external list.
109
+ if (tool.externalPath)
110
+ addCapped(read ? externalRead : externalTouched, tool.externalPath);
111
+ if (tool.filePath)
112
+ addCapped(read ? filesRead : filesTouched, tool.filePath);
117
113
  }
118
- return { toolsUsed, filesTouched: [...filesTouched], filesRead: [...filesRead] };
114
+ return {
115
+ toolsUsed,
116
+ filesTouched: [...filesTouched],
117
+ filesRead: [...filesRead],
118
+ externalTouched: [...externalTouched],
119
+ externalRead: [...externalRead],
120
+ toolInputs
121
+ };
119
122
  }
120
123
  /**
121
124
  * Record a path while the list still has room for one.
@@ -132,20 +135,53 @@ function addCapped(paths, filePath) {
132
135
  paths.add(filePath);
133
136
  }
134
137
  /**
135
- * The turn's prompt text, joining several submissions into one.
138
+ * A title fit to send: scrubbed whole, then cut.
139
+ *
140
+ * In that order, or a credential the cut runs through keeps a prefix no
141
+ * pattern matches. The cut stops before a code point that would cross the
142
+ * bound, so an emoji is never split into a lone surrogate.
143
+ *
144
+ * @param title - The title as the agent holds it.
145
+ * @returns The bounded title, or undefined when nothing is left.
146
+ */
147
+ function boundSessionTitle(title) {
148
+ const scrubbed = title === undefined ? '' : sanitizeText(title).trim();
149
+ if (scrubbed.length <= MAX_SESSION_TITLE_LENGTH)
150
+ return scrubbed || undefined;
151
+ let out = '';
152
+ for (const char of scrubbed) {
153
+ if (out.length + char.length > MAX_SESSION_TITLE_LENGTH)
154
+ break;
155
+ out += char;
156
+ }
157
+ return out.trimEnd() || undefined;
158
+ }
159
+ /**
160
+ * Why the turn ran unchecked, if the prompt that opened it did.
161
+ *
162
+ * The newest prompt submitted before this Stop, and only that one. Without a
163
+ * turn id a Stop collects every record the session left: one from a prompt
164
+ * interrupted before its own Stop, and one from the next prompt racing in
165
+ * before this close. Neither prompt's fail-open is a fact about this turn.
136
166
  *
137
- * @param prompts - The turn's prompt records.
138
- * @returns The joined text, or undefined when none was captured.
167
+ * Read back from a file on disk, so checked against the closed set rather than
168
+ * trusted: an unrecognised value is dropped, not sent. Sending nothing is the
169
+ * contract's word for "no reason known".
170
+ *
171
+ * @param prompts - The turn's prompt records, oldest first.
172
+ * @param endedAt - The Stop's timestamp; ISO strings, compared as the tracker sorts them.
173
+ * @returns The recognised reason, or undefined.
139
174
  */
140
- function joinPrompts(prompts) {
141
- const present = [];
142
- for (const prompt of prompts) {
143
- if (typeof prompt.text === 'string' && prompt.text.length > 0)
144
- present.push(prompt.text);
175
+ function failOpenReasonOf(prompts, endedAt) {
176
+ // A turn holds a prompt or two, so a reversed copy costs nothing.
177
+ for (const prompt of [...prompts].reverse()) {
178
+ if (prompt.at > endedAt)
179
+ continue;
180
+ if (prompt.failOpenReason === undefined || !FAIL_OPEN_REASONS.has(prompt.failOpenReason))
181
+ return undefined;
182
+ return prompt.failOpenReason;
145
183
  }
146
- if (present.length === 0)
147
- return undefined;
148
- return present.join(PROMPT_JOIN_SEPARATOR);
184
+ return undefined;
149
185
  }
150
186
  /**
151
187
  * Ticket keys out of mixed feature evidence.
@@ -1,6 +1,7 @@
1
+ import type { Env } from '../core/types/core.types.js';
1
2
  import type { TurnSummaryEvent } from './types/turn-summary.types.js';
2
- import type { TrackTurnOptions } from './types/turn-tracker.types.js';
3
- export type { TrackTurnOptions } from './types/turn-tracker.types.js';
3
+ import type { TrackTurnOptions, TurnOutcome } from './types/turn-tracker.types.js';
4
+ export type { TrackTurnOptions, TurnOutcome } from './types/turn-tracker.types.js';
4
5
  /**
5
6
  * Accumulate turn state across hook invocations and close the turn on
6
7
  * `generation.completed`, producing one flat summary.
@@ -12,3 +13,21 @@ export type { TrackTurnOptions } from './types/turn-tracker.types.js';
12
13
  * @returns The turn summary when this payload closed a turn.
13
14
  */
14
15
  export declare function trackTurn(options: TrackTurnOptions): Promise<TurnSummaryEvent | undefined>;
16
+ /**
17
+ * {@link trackTurn}, with the local root of the checkout the summary reported
18
+ * beside it: the pipeline takes the repository snapshot there. The root never
19
+ * goes on the summary.
20
+ *
21
+ * @param options - The payload's events, config, paths and clock.
22
+ * @returns The summary when this payload closed a turn, and its checkout's root.
23
+ */
24
+ export declare function trackTurnOutcome(options: TrackTurnOptions): Promise<TurnOutcome>;
25
+ /**
26
+ * Which surface the turn happened on.
27
+ *
28
+ * @param provider - Internal provider id.
29
+ * @param env - Environment; Claude Code reports its own entrypoint there.
30
+ * @param rawPayload - Hook payload; Codex only names its originator in the transcript it points at.
31
+ * @returns The surface label.
32
+ */
33
+ export declare function resolveSurface(provider: string, env: Env, rawPayload?: unknown): Promise<string>;