@openai/codex-security 0.8.3 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (534) hide show
  1. package/README.md +192 -151
  2. package/_bundled_plugin/.mcp.json +5 -1
  3. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  4. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  5. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  6. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  7. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  8. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  9. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  10. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/package.json +1 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  20. package/_bundled_plugin/mcp/server.mjs +2 -11
  21. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  22. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  23. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  24. package/_bundled_plugin/references/final-report.md +5 -3
  25. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  26. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  27. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  28. package/_bundled_plugin/references/scan-contract.md +27 -33
  29. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  30. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  31. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  32. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  33. package/_bundled_plugin/scripts/deep_scan_workbench.py +165 -342
  34. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  35. package/_bundled_plugin/scripts/finalize_scan_contract.py +153 -227
  36. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  37. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  38. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  39. package/_bundled_plugin/scripts/posix_scan_local_files.py +11 -0
  40. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  41. package/_bundled_plugin/scripts/report_projection.py +81 -43
  42. package/_bundled_plugin/scripts/review_state.py +8 -2
  43. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  44. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  45. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  46. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  47. package/_bundled_plugin/scripts/windows_scan_local_files.py +388 -17
  48. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  49. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  50. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  51. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  52. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  53. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  54. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  55. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  56. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  57. package/_bundled_plugin/scripts/workbench_cli.py +30 -12
  58. package/_bundled_plugin/scripts/workbench_constants.py +10 -0
  59. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  60. package/_bundled_plugin/scripts/workbench_db.py +369 -137
  61. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  62. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  63. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  64. package/_bundled_plugin/scripts/workbench_native_indexes.py +12 -12
  65. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  66. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  67. package/_bundled_plugin/scripts/workbench_remediation.py +13 -0
  68. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  69. package/_bundled_plugin/scripts/workbench_scan_history.py +117 -55
  70. package/_bundled_plugin/scripts/workbench_scan_start.py +83 -24
  71. package/_bundled_plugin/scripts/workbench_scan_usage.py +644 -68
  72. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  73. package/_bundled_plugin/scripts/workbench_setup.py +13 -1
  74. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  75. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  76. package/_bundled_plugin/scripts/workbench_target.py +127 -56
  77. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  78. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  79. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -23
  80. package/_bundled_plugin/shared/workbench-migrations.json +34 -0
  81. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  82. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  83. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -1
  84. package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -25
  85. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  86. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  87. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  88. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  89. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  90. package/dist/api.d.ts +39 -4
  91. package/dist/api.d.ts.map +1 -1
  92. package/dist/api.js +774 -292
  93. package/dist/api.js.map +1 -1
  94. package/dist/auth.d.ts.map +1 -1
  95. package/dist/auth.js +4 -6
  96. package/dist/auth.js.map +1 -1
  97. package/dist/bedrock-oss-pricing.d.ts +6 -0
  98. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  99. package/dist/bedrock-oss-pricing.js +58 -0
  100. package/dist/bedrock-oss-pricing.js.map +1 -0
  101. package/dist/bedrock-pricing.d.ts +15 -0
  102. package/dist/bedrock-pricing.d.ts.map +1 -0
  103. package/dist/bedrock-pricing.js +117 -0
  104. package/dist/bedrock-pricing.js.map +1 -0
  105. package/dist/blackduck-findings.d.ts.map +1 -1
  106. package/dist/blackduck-findings.js +35 -20
  107. package/dist/blackduck-findings.js.map +1 -1
  108. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  109. package/dist/bulk-scan-discovery.js +4 -4
  110. package/dist/bulk-scan-discovery.js.map +1 -1
  111. package/dist/checkmarx-evidence.d.ts +19 -0
  112. package/dist/checkmarx-evidence.d.ts.map +1 -0
  113. package/dist/checkmarx-evidence.js +36 -0
  114. package/dist/checkmarx-evidence.js.map +1 -0
  115. package/dist/checkmarx-findings.d.ts +4 -0
  116. package/dist/checkmarx-findings.d.ts.map +1 -0
  117. package/dist/checkmarx-findings.js +27 -0
  118. package/dist/checkmarx-findings.js.map +1 -0
  119. package/dist/checkmarx-one.d.ts +4 -0
  120. package/dist/checkmarx-one.d.ts.map +1 -0
  121. package/dist/checkmarx-one.js +53 -0
  122. package/dist/checkmarx-one.js.map +1 -0
  123. package/dist/checkmarx-repository.d.ts +12 -0
  124. package/dist/checkmarx-repository.d.ts.map +1 -0
  125. package/dist/checkmarx-repository.js +181 -0
  126. package/dist/checkmarx-repository.js.map +1 -0
  127. package/dist/checkmarx-xml.d.ts +12 -0
  128. package/dist/checkmarx-xml.d.ts.map +1 -0
  129. package/dist/checkmarx-xml.js +196 -0
  130. package/dist/checkmarx-xml.js.map +1 -0
  131. package/dist/classify-severity-records.d.ts +1 -9
  132. package/dist/classify-severity-records.d.ts.map +1 -1
  133. package/dist/classify-severity-records.js +3 -13
  134. package/dist/classify-severity-records.js.map +1 -1
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +2 -4
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli.d.ts +11 -5
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1734 -1238
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.js +2 -2
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/component-scan.d.ts +16 -3
  145. package/dist/component-scan.d.ts.map +1 -1
  146. package/dist/component-scan.js +27 -2
  147. package/dist/component-scan.js.map +1 -1
  148. package/dist/config.d.ts.map +1 -1
  149. package/dist/config.js +100 -66
  150. package/dist/config.js.map +1 -1
  151. package/dist/continuum-findings.d.ts.map +1 -1
  152. package/dist/continuum-findings.js +80 -12
  153. package/dist/continuum-findings.js.map +1 -1
  154. package/dist/contract-values.d.ts +2 -0
  155. package/dist/contract-values.d.ts.map +1 -1
  156. package/dist/contract-values.js +12 -9
  157. package/dist/contract-values.js.map +1 -1
  158. package/dist/cost-model.d.ts +13 -1
  159. package/dist/cost-model.d.ts.map +1 -1
  160. package/dist/cost-model.js +66 -112
  161. package/dist/cost-model.js.map +1 -1
  162. package/dist/cost.d.ts +42 -3
  163. package/dist/cost.d.ts.map +1 -1
  164. package/dist/cost.js +483 -104
  165. package/dist/cost.js.map +1 -1
  166. package/dist/custom-publish.d.ts +4 -0
  167. package/dist/custom-publish.d.ts.map +1 -1
  168. package/dist/custom-publish.js +40 -3
  169. package/dist/custom-publish.js.map +1 -1
  170. package/dist/deduplication/local.d.ts +2 -2
  171. package/dist/deduplication/local.d.ts.map +1 -1
  172. package/dist/deduplication/local.js +2 -2
  173. package/dist/deduplication/local.js.map +1 -1
  174. package/dist/deduplication/refusal.d.ts.map +1 -1
  175. package/dist/deduplication/refusal.js +25 -5
  176. package/dist/deduplication/refusal.js.map +1 -1
  177. package/dist/deduplication/scan.d.ts +3 -0
  178. package/dist/deduplication/scan.d.ts.map +1 -1
  179. package/dist/deduplication/scan.js +1 -1
  180. package/dist/deduplication/scan.js.map +1 -1
  181. package/dist/deep-config.d.ts +0 -1
  182. package/dist/deep-config.d.ts.map +1 -1
  183. package/dist/deep-config.js +22 -33
  184. package/dist/deep-config.js.map +1 -1
  185. package/dist/deep-scan-defaults.d.ts +2 -0
  186. package/dist/deep-scan-defaults.d.ts.map +1 -1
  187. package/dist/deep-scan-defaults.js +28 -1
  188. package/dist/deep-scan-defaults.js.map +1 -1
  189. package/dist/deep-scan.d.ts +2 -0
  190. package/dist/deep-scan.d.ts.map +1 -1
  191. package/dist/deep-scan.js +28 -4
  192. package/dist/deep-scan.js.map +1 -1
  193. package/dist/default-severity-rubric.d.ts +1 -1
  194. package/dist/default-severity-rubric.d.ts.map +1 -1
  195. package/dist/default-severity-rubric.js +1 -1
  196. package/dist/default-severity-rubric.js.map +1 -1
  197. package/dist/endor-findings.d.ts +3 -1
  198. package/dist/endor-findings.d.ts.map +1 -1
  199. package/dist/endor-findings.js +103 -45
  200. package/dist/endor-findings.js.map +1 -1
  201. package/dist/errors.d.ts +1 -1
  202. package/dist/errors.d.ts.map +1 -1
  203. package/dist/errors.js +8 -1
  204. package/dist/errors.js.map +1 -1
  205. package/dist/external-findings-import.d.ts +5 -3
  206. package/dist/external-findings-import.d.ts.map +1 -1
  207. package/dist/external-findings-import.js +7 -6
  208. package/dist/external-findings-import.js.map +1 -1
  209. package/dist/external-findings-local.d.ts +7 -5
  210. package/dist/external-findings-local.d.ts.map +1 -1
  211. package/dist/external-findings-local.js +337 -89
  212. package/dist/external-findings-local.js.map +1 -1
  213. package/dist/external-findings-publish.d.ts +8 -6
  214. package/dist/external-findings-publish.d.ts.map +1 -1
  215. package/dist/external-findings-publish.js +1318 -258
  216. package/dist/external-findings-publish.js.map +1 -1
  217. package/dist/external-findings-read.d.ts +20 -2
  218. package/dist/external-findings-read.d.ts.map +1 -1
  219. package/dist/external-findings-read.js +148 -66
  220. package/dist/external-findings-read.js.map +1 -1
  221. package/dist/external-findings.d.ts +15 -3
  222. package/dist/external-findings.d.ts.map +1 -1
  223. package/dist/external-findings.js +42 -1
  224. package/dist/external-findings.js.map +1 -1
  225. package/dist/external-import-contract.d.ts +5 -1
  226. package/dist/external-import-contract.d.ts.map +1 -1
  227. package/dist/external-import-contract.js +23 -9
  228. package/dist/external-import-contract.js.map +1 -1
  229. package/dist/external-import-models.d.ts +1 -1
  230. package/dist/external-import-models.d.ts.map +1 -1
  231. package/dist/external-import-models.js.map +1 -1
  232. package/dist/feedback.d.ts.map +1 -1
  233. package/dist/feedback.js +5 -4
  234. package/dist/feedback.js.map +1 -1
  235. package/dist/finding-prompt.d.ts +5 -0
  236. package/dist/finding-prompt.d.ts.map +1 -0
  237. package/dist/finding-prompt.js +32 -0
  238. package/dist/finding-prompt.js.map +1 -0
  239. package/dist/findings-client.d.ts +1 -0
  240. package/dist/findings-client.d.ts.map +1 -1
  241. package/dist/findings-client.js +27 -3
  242. package/dist/findings-client.js.map +1 -1
  243. package/dist/github-advisories.d.ts.map +1 -1
  244. package/dist/github-advisories.js +0 -2
  245. package/dist/github-advisories.js.map +1 -1
  246. package/dist/github-dependabot-findings.d.ts.map +1 -1
  247. package/dist/github-dependabot-findings.js +15 -4
  248. package/dist/github-dependabot-findings.js.map +1 -1
  249. package/dist/github-findings.d.ts +4 -1
  250. package/dist/github-findings.d.ts.map +1 -1
  251. package/dist/github-findings.js +55 -30
  252. package/dist/github-findings.js.map +1 -1
  253. package/dist/hosted-git-remotes.d.ts +5 -0
  254. package/dist/hosted-git-remotes.d.ts.map +1 -0
  255. package/dist/hosted-git-remotes.js +285 -0
  256. package/dist/hosted-git-remotes.js.map +1 -0
  257. package/dist/hosted-git-repository.d.ts +28 -0
  258. package/dist/hosted-git-repository.d.ts.map +1 -0
  259. package/dist/hosted-git-repository.js +222 -0
  260. package/dist/hosted-git-repository.js.map +1 -0
  261. package/dist/hosted-scan-protocol.js +2 -2
  262. package/dist/hosted-scan-protocol.js.map +1 -1
  263. package/dist/hosted-scan.d.ts.map +1 -1
  264. package/dist/hosted-scan.js +16 -11
  265. package/dist/hosted-scan.js.map +1 -1
  266. package/dist/hosted-scanner-http.d.ts +21 -0
  267. package/dist/hosted-scanner-http.d.ts.map +1 -0
  268. package/dist/hosted-scanner-http.js +204 -0
  269. package/dist/hosted-scanner-http.js.map +1 -0
  270. package/dist/hosted-scanner-v1.d.ts +6 -0
  271. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  272. package/dist/hosted-scanner-v1.js +60 -0
  273. package/dist/hosted-scanner-v1.js.map +1 -0
  274. package/dist/import-scan.d.ts.map +1 -1
  275. package/dist/import-scan.js +3 -0
  276. package/dist/import-scan.js.map +1 -1
  277. package/dist/index.d.ts +18 -7
  278. package/dist/index.d.ts.map +1 -1
  279. package/dist/index.js +10 -2
  280. package/dist/index.js.map +1 -1
  281. package/dist/inspector-findings.d.ts.map +1 -1
  282. package/dist/inspector-findings.js +47 -65
  283. package/dist/inspector-findings.js.map +1 -1
  284. package/dist/knowledge-base.d.ts.map +1 -1
  285. package/dist/knowledge-base.js +68 -5
  286. package/dist/knowledge-base.js.map +1 -1
  287. package/dist/local-git-metadata.d.ts +1 -1
  288. package/dist/local-git-metadata.d.ts.map +1 -1
  289. package/dist/local-git-metadata.js +1 -2
  290. package/dist/local-git-metadata.js.map +1 -1
  291. package/dist/multiscan.d.ts +6 -4
  292. package/dist/multiscan.d.ts.map +1 -1
  293. package/dist/multiscan.js +138 -65
  294. package/dist/multiscan.js.map +1 -1
  295. package/dist/native-json-findings.d.ts +2 -1
  296. package/dist/native-json-findings.d.ts.map +1 -1
  297. package/dist/native-json-findings.js +12 -2
  298. package/dist/native-json-findings.js.map +1 -1
  299. package/dist/opengrep-findings.d.ts +1 -0
  300. package/dist/opengrep-findings.d.ts.map +1 -1
  301. package/dist/opengrep-findings.js +17 -13
  302. package/dist/opengrep-findings.js.map +1 -1
  303. package/dist/operation-telemetry.d.ts +104 -0
  304. package/dist/operation-telemetry.d.ts.map +1 -0
  305. package/dist/operation-telemetry.js +293 -0
  306. package/dist/operation-telemetry.js.map +1 -0
  307. package/dist/plugin-python-probe.d.ts +4 -0
  308. package/dist/plugin-python-probe.d.ts.map +1 -0
  309. package/dist/plugin-python-probe.js +10 -0
  310. package/dist/plugin-python-probe.js.map +1 -0
  311. package/dist/private-finding-import.d.ts +97 -2
  312. package/dist/private-finding-import.d.ts.map +1 -1
  313. package/dist/private-finding-import.js +58 -34
  314. package/dist/private-finding-import.js.map +1 -1
  315. package/dist/provider-profile.d.ts +1 -1
  316. package/dist/provider-profile.d.ts.map +1 -1
  317. package/dist/provider-profile.js +8 -1
  318. package/dist/provider-profile.js.map +1 -1
  319. package/dist/publication-telemetry.d.ts +45 -0
  320. package/dist/publication-telemetry.d.ts.map +1 -0
  321. package/dist/publication-telemetry.js +50 -0
  322. package/dist/publication-telemetry.js.map +1 -0
  323. package/dist/publish.d.ts +4 -0
  324. package/dist/publish.d.ts.map +1 -1
  325. package/dist/publish.js +42 -2
  326. package/dist/publish.js.map +1 -1
  327. package/dist/reader-selection.d.ts +2 -0
  328. package/dist/reader-selection.d.ts.map +1 -1
  329. package/dist/reader-selection.js +8 -0
  330. package/dist/reader-selection.js.map +1 -1
  331. package/dist/remediation.d.ts +1 -4
  332. package/dist/remediation.d.ts.map +1 -1
  333. package/dist/remediation.js +3 -7
  334. package/dist/remediation.js.map +1 -1
  335. package/dist/request-metadata.d.ts +3 -0
  336. package/dist/request-metadata.d.ts.map +1 -1
  337. package/dist/request-metadata.js +9 -0
  338. package/dist/request-metadata.js.map +1 -1
  339. package/dist/result.d.ts +4 -0
  340. package/dist/result.d.ts.map +1 -1
  341. package/dist/result.js +1 -1
  342. package/dist/result.js.map +1 -1
  343. package/dist/retry-windows-rename.d.ts +8 -0
  344. package/dist/retry-windows-rename.d.ts.map +1 -0
  345. package/dist/retry-windows-rename.js +24 -0
  346. package/dist/retry-windows-rename.js.map +1 -0
  347. package/dist/runtime.d.ts +20 -0
  348. package/dist/runtime.d.ts.map +1 -1
  349. package/dist/runtime.js +313 -110
  350. package/dist/runtime.js.map +1 -1
  351. package/dist/saved-scan-bootstrap.d.ts +1 -0
  352. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  353. package/dist/saved-scan-bootstrap.js +18 -15
  354. package/dist/saved-scan-bootstrap.js.map +1 -1
  355. package/dist/scan-activity.d.ts.map +1 -1
  356. package/dist/scan-activity.js +141 -56
  357. package/dist/scan-activity.js.map +1 -1
  358. package/dist/scan-comparison.d.ts +10 -5
  359. package/dist/scan-comparison.d.ts.map +1 -1
  360. package/dist/scan-comparison.js +60 -15
  361. package/dist/scan-comparison.js.map +1 -1
  362. package/dist/scan-dashboard.d.ts +6 -6
  363. package/dist/scan-dashboard.d.ts.map +1 -1
  364. package/dist/scan-dashboard.js +75 -42
  365. package/dist/scan-dashboard.js.map +1 -1
  366. package/dist/scan-executor.d.ts +10 -1
  367. package/dist/scan-executor.d.ts.map +1 -1
  368. package/dist/scan-executor.js +22 -2
  369. package/dist/scan-executor.js.map +1 -1
  370. package/dist/scan-history-renderer.d.ts.map +1 -1
  371. package/dist/scan-history-renderer.js +9 -19
  372. package/dist/scan-history-renderer.js.map +1 -1
  373. package/dist/scan-logs.d.ts +12 -0
  374. package/dist/scan-logs.d.ts.map +1 -1
  375. package/dist/scan-logs.js +106 -77
  376. package/dist/scan-logs.js.map +1 -1
  377. package/dist/scan-measurement.d.ts +26 -0
  378. package/dist/scan-measurement.d.ts.map +1 -0
  379. package/dist/scan-measurement.js +77 -0
  380. package/dist/scan-measurement.js.map +1 -0
  381. package/dist/scan-progress.d.ts +1 -0
  382. package/dist/scan-progress.d.ts.map +1 -1
  383. package/dist/scan-progress.js +3 -0
  384. package/dist/scan-progress.js.map +1 -1
  385. package/dist/scan-sessions.d.ts.map +1 -1
  386. package/dist/scan-sessions.js +4 -1
  387. package/dist/scan-sessions.js.map +1 -1
  388. package/dist/scan-settings.d.ts +1 -1
  389. package/dist/scan-settings.d.ts.map +1 -1
  390. package/dist/scan-settings.js +1 -24
  391. package/dist/scan-settings.js.map +1 -1
  392. package/dist/scanner-import.d.ts +20 -2
  393. package/dist/scanner-import.d.ts.map +1 -1
  394. package/dist/scanner-import.js +200 -8
  395. package/dist/scanner-import.js.map +1 -1
  396. package/dist/scanner-repository-url.d.ts +4 -1
  397. package/dist/scanner-repository-url.d.ts.map +1 -1
  398. package/dist/scanner-repository-url.js +10 -6
  399. package/dist/scanner-repository-url.js.map +1 -1
  400. package/dist/security-policy.d.ts +1 -1
  401. package/dist/security-policy.d.ts.map +1 -1
  402. package/dist/security-policy.js.map +1 -1
  403. package/dist/semgrep-findings.d.ts +6 -3
  404. package/dist/semgrep-findings.d.ts.map +1 -1
  405. package/dist/semgrep-findings.js +107 -43
  406. package/dist/semgrep-findings.js.map +1 -1
  407. package/dist/semgrep-guardian-findings.d.ts +38 -0
  408. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  409. package/dist/semgrep-guardian-findings.js +165 -0
  410. package/dist/semgrep-guardian-findings.js.map +1 -0
  411. package/dist/semgrep-platform-collector.d.ts +26 -0
  412. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  413. package/dist/semgrep-platform-collector.js +108 -0
  414. package/dist/semgrep-platform-collector.js.map +1 -0
  415. package/dist/semgrep-platform-findings.d.ts +207 -6
  416. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  417. package/dist/semgrep-platform-findings.js +983 -103
  418. package/dist/semgrep-platform-findings.js.map +1 -1
  419. package/dist/semgrep-platform-v1.d.ts +6 -0
  420. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  421. package/dist/semgrep-platform-v1.js +83 -0
  422. package/dist/semgrep-platform-v1.js.map +1 -0
  423. package/dist/server/api.d.ts +1 -1
  424. package/dist/server/api.d.ts.map +1 -1
  425. package/dist/server/api.js.map +1 -1
  426. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  427. package/dist/server/embedding-tokenizer.d.ts +2 -0
  428. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  429. package/dist/server/embedding-tokenizer.js +322 -0
  430. package/dist/server/embedding-tokenizer.js.map +6 -0
  431. package/dist/server/embeddings.d.ts +16 -2
  432. package/dist/server/embeddings.d.ts.map +1 -1
  433. package/dist/server/embeddings.js +35 -5
  434. package/dist/server/embeddings.js.map +1 -1
  435. package/dist/session-lines.d.ts +5 -0
  436. package/dist/session-lines.d.ts.map +1 -0
  437. package/dist/session-lines.js +60 -0
  438. package/dist/session-lines.js.map +1 -0
  439. package/dist/severity-review.d.ts +3 -1
  440. package/dist/severity-review.d.ts.map +1 -1
  441. package/dist/severity-review.js +3 -2
  442. package/dist/severity-review.js.map +1 -1
  443. package/dist/skill-authentication.d.ts +1 -0
  444. package/dist/skill-authentication.d.ts.map +1 -1
  445. package/dist/skill-authentication.js +1 -0
  446. package/dist/skill-authentication.js.map +1 -1
  447. package/dist/snyk-findings.d.ts +7 -2
  448. package/dist/snyk-findings.d.ts.map +1 -1
  449. package/dist/snyk-findings.js +93 -70
  450. package/dist/snyk-findings.js.map +1 -1
  451. package/dist/snyk-rest-findings.d.ts +76 -0
  452. package/dist/snyk-rest-findings.d.ts.map +1 -0
  453. package/dist/snyk-rest-findings.js +1051 -0
  454. package/dist/snyk-rest-findings.js.map +1 -0
  455. package/dist/snyk-rest-v1.d.ts +28 -0
  456. package/dist/snyk-rest-v1.d.ts.map +1 -0
  457. package/dist/snyk-rest-v1.js +132 -0
  458. package/dist/snyk-rest-v1.js.map +1 -0
  459. package/dist/snyk-token-origin.d.ts +4 -0
  460. package/dist/snyk-token-origin.d.ts.map +1 -0
  461. package/dist/snyk-token-origin.js +82 -0
  462. package/dist/snyk-token-origin.js.map +1 -0
  463. package/dist/sonar-collector.d.ts.map +1 -1
  464. package/dist/sonar-collector.js +0 -3
  465. package/dist/sonar-collector.js.map +1 -1
  466. package/dist/sonar-import.d.ts.map +1 -1
  467. package/dist/sonar-import.js +2 -4
  468. package/dist/sonar-import.js.map +1 -1
  469. package/dist/target-drift.d.ts +9 -0
  470. package/dist/target-drift.d.ts.map +1 -0
  471. package/dist/target-drift.js +27 -0
  472. package/dist/target-drift.js.map +1 -0
  473. package/dist/targets.d.ts +2 -0
  474. package/dist/targets.d.ts.map +1 -1
  475. package/dist/targets.js +56 -20
  476. package/dist/targets.js.map +1 -1
  477. package/dist/tenable-findings.d.ts +9 -0
  478. package/dist/tenable-findings.d.ts.map +1 -0
  479. package/dist/tenable-findings.js +122 -0
  480. package/dist/tenable-findings.js.map +1 -0
  481. package/dist/terminal-stream.d.ts +13 -0
  482. package/dist/terminal-stream.d.ts.map +1 -0
  483. package/dist/terminal-stream.js +35 -0
  484. package/dist/terminal-stream.js.map +1 -0
  485. package/dist/trivy-findings.d.ts +19 -0
  486. package/dist/trivy-findings.d.ts.map +1 -0
  487. package/dist/trivy-findings.js +435 -0
  488. package/dist/trivy-findings.js.map +1 -0
  489. package/dist/trivy-import.d.ts +19 -0
  490. package/dist/trivy-import.d.ts.map +1 -0
  491. package/dist/trivy-import.js +151 -0
  492. package/dist/trivy-import.js.map +1 -0
  493. package/dist/validation-records.js +1 -1
  494. package/dist/validation-records.js.map +1 -1
  495. package/dist/veracode-findings.d.ts +2 -0
  496. package/dist/veracode-findings.d.ts.map +1 -1
  497. package/dist/veracode-findings.js +49 -11
  498. package/dist/veracode-findings.js.map +1 -1
  499. package/dist/vertex-pricing.d.ts +8 -0
  500. package/dist/vertex-pricing.d.ts.map +1 -0
  501. package/dist/vertex-pricing.js +20 -0
  502. package/dist/vertex-pricing.js.map +1 -0
  503. package/dist/windows-path.d.ts +1 -0
  504. package/dist/windows-path.d.ts.map +1 -1
  505. package/dist/windows-path.js +26 -1
  506. package/dist/windows-path.js.map +1 -1
  507. package/dist/wiz-findings.d.ts +4 -0
  508. package/dist/wiz-findings.d.ts.map +1 -1
  509. package/dist/wiz-findings.js +57 -3
  510. package/dist/wiz-findings.js.map +1 -1
  511. package/docs/classify-severity-records.md +27 -12
  512. package/docs/cli.md +497 -550
  513. package/docs/dedupe-records.md +44 -24
  514. package/docs/findings-service.md +66 -39
  515. package/docs/hosted-remediation.md +14 -7
  516. package/docs/hosted-scans.md +50 -42
  517. package/docs/telemetry.md +236 -0
  518. package/docs/validate-records.md +78 -44
  519. package/package.json +18 -15
  520. package/schemas/external-findings.schema.json +3 -1
  521. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  522. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  523. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  524. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  525. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  526. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  527. package/dist/external-imports-feature.d.ts +0 -6
  528. package/dist/external-imports-feature.d.ts.map +0 -1
  529. package/dist/external-imports-feature.js +0 -51
  530. package/dist/external-imports-feature.js.map +0 -1
  531. package/dist/finding-normalization.d.ts +0 -5
  532. package/dist/finding-normalization.d.ts.map +0 -1
  533. package/dist/finding-normalization.js +0 -155
  534. package/dist/finding-normalization.js.map +0 -1
@@ -70,6 +70,7 @@ from workbench.saved_sources import (
70
70
  from workbench.saved_sources import (
71
71
  _digest as _digest,
72
72
  )
73
+ from workbench.storage import saved_deep_workers
73
74
  from workbench_constants import PHASES
74
75
  from workbench_coverage_receipts import (
75
76
  _generic_surface_updates as _generic_surface_updates,
@@ -84,6 +85,7 @@ _RESERVED_ARTIFACT_PATHS = json.loads(
84
85
 
85
86
 
86
87
  def threat_model_fields(db: Any, scan: sqlite3.Row) -> dict[str, Any]:
88
+ """Return availability and provenance for a saved threat model, reporting it as unavailable when verification fails."""
87
89
  scan_dir = Path(scan["scan_dir"])
88
90
  fields: dict[str, Any] = {"threatModelAvailable": False}
89
91
  try:
@@ -142,11 +144,7 @@ def _saved_results_changed(db: Any, connection: Any, scan: Any) -> bool:
142
144
  try:
143
145
  scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
144
146
  manifest_path = db.artifact_path(scan_dir, db.ARTIFACTS["manifest"], required=False)
145
- workers = connection.execute(
146
- "SELECT id, kind, status, completed_at, artifact_dir, result_manifest_path "
147
- "FROM deep_scan_workers WHERE scan_id = ?",
148
- (scan["id"],),
149
- ).fetchall()
147
+ workers = saved_deep_workers(connection, scan)
150
148
  paths = dict(_saved_result_paths(scan_dir, workers))
151
149
  frozen_sources = scan["retained_source_digests_json"]
152
150
 
@@ -161,7 +159,7 @@ def _saved_results_changed(db: Any, connection: Any, scan: Any) -> bool:
161
159
 
162
160
  if manifest_path is None:
163
161
  if frozen_sources is not None:
164
- return bool(_retained_source_state(json.loads(frozen_sources))[0])
162
+ return bool(_retained_source_state(frozen_sources)["sources"])
165
163
  return has_saved_source()
166
164
  if scan["seal_manifest_digest"] is None:
167
165
  try:
@@ -235,24 +233,24 @@ def _recovery_source_digests(
235
233
  db: Any, connection: Any, scan: Any
236
234
  ) -> tuple[dict[str, str], bool, dict[str, str | None]]:
237
235
  scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
238
- frozen_sources: dict[str, str] | None = None
239
- include_parent = True
240
- raw_frozen_sources = scan["retained_source_digests_json"]
241
- if raw_frozen_sources is not None:
242
- retained = json.loads(raw_frozen_sources)
243
- frozen_sources, model_source = _retained_source_state(retained)
244
- if isinstance(retained.get("sources"), dict) and retained.get("sourceTimes") is not None:
245
- _restore_frozen_model_capture(
246
- scan_dir, scan["id"], frozen_sources, retained["sourceTimes"], model_source
247
- )
248
- _freeze_source_times(
249
- scan_dir,
250
- scan["id"],
251
- frozen_sources,
252
- retained["sourceTimes"],
253
- retained.get("parentContext"),
254
- )
255
- include_parent = False
236
+ retained = _retained_source_state(scan["retained_source_digests_json"])
237
+ frozen_sources = retained.get("sources")
238
+ include_parent = frozen_sources is None
239
+ if retained.get("sourceTimes") is not None:
240
+ _restore_frozen_model_capture(
241
+ scan_dir,
242
+ scan["id"],
243
+ frozen_sources,
244
+ retained["sourceTimes"],
245
+ retained.get("threatModelSource"),
246
+ )
247
+ _freeze_source_times(
248
+ scan_dir,
249
+ scan["id"],
250
+ frozen_sources,
251
+ retained["sourceTimes"],
252
+ retained.get("parentContext"),
253
+ )
256
254
  checkpoint_heads, pending_recovery = _retained_checkpoint_state(scan)
257
255
  if pending_recovery:
258
256
  return frozen_sources, False, checkpoint_heads
@@ -285,11 +283,7 @@ def _recovery_source_digests(
285
283
  else:
286
284
  include_parent = True
287
285
 
288
- workers = connection.execute(
289
- "SELECT id, kind, status, completed_at, artifact_dir, result_manifest_path "
290
- "FROM deep_scan_workers WHERE scan_id = ?",
291
- (scan["id"],),
292
- ).fetchall()
286
+ workers = saved_deep_workers(connection, scan)
293
287
  previous_heads = checkpoint_heads
294
288
  if previous_heads is None:
295
289
  previous_heads = _frozen_checkpoint_heads(scan_dir, scan["id"], frozen_sources or {})
@@ -359,6 +353,7 @@ def _recovery_source_digests(
359
353
 
360
354
 
361
355
  def scan_results_recovery_needed(db: Any, connection: Any, scan: Any) -> bool:
356
+ """Return whether a failed, uncanceled scan has a publication error or saved evidence to recover."""
362
357
  if scan["status"] != "failed" or scan["canceled_at"] is not None:
363
358
  return False
364
359
  warnings = json.loads(scan["completion_warnings_json"])
@@ -416,6 +411,7 @@ def preserve_parent_head_on_error(scan_dir: Path) -> Iterator[None]:
416
411
 
417
412
 
418
413
  def coverage_for_comparison(db: Any, scan: Any) -> dict[str, Any]:
414
+ """Return coverage from the verified, sealed scan or raise SystemExit if the stored scan cannot be matched."""
419
415
  if scan["seal_manifest_digest"] is None:
420
416
  raise SystemExit("Only sealed scans can be compared.")
421
417
  scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
@@ -441,10 +437,7 @@ def preserve_deep_deadline_draft(
441
437
  scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
442
438
  warnings = json.loads(scan["completion_warnings_json"])
443
439
  binding = db.workbench_completion_binding(scan, db.now())
444
- workers = connection.execute(
445
- "SELECT * FROM deep_scan_workers WHERE scan_id = ? ORDER BY created_at, id",
446
- (scan["id"],),
447
- ).fetchall()
440
+ workers = saved_deep_workers(connection, scan)
448
441
  if preserve_reduction:
449
442
  # Completed reviews already went through reduction. Only add evidence
450
443
  # from unfinished reviews; raw accepted drafts must not undo that result.
@@ -581,19 +574,13 @@ def preserve_scan_results_locked(
581
574
  scan = db.require_scan(connection, scan_id)
582
575
  if scan["status"] != "failed":
583
576
  return False
584
- frozen_source_digests: dict[str, str] | None = None
585
577
  checkpoint_heads, pending_recovery = _retained_checkpoint_state(scan)
586
- model_source: list[str] = []
587
- saved_model_source: str | None = None
588
578
  raw_frozen_sources = scan["retained_source_digests_json"]
589
- frozen_source_times = None
590
- if raw_frozen_sources is not None:
591
- retained = json.loads(raw_frozen_sources)
592
- frozen_source_digests, saved_model_source = _retained_source_state(retained)
593
- if isinstance(retained.get("sources"), dict):
594
- frozen_source_times = retained.get("sourceTimes")
595
- if saved_model_source is not None:
596
- model_source.append(saved_model_source)
579
+ retained = _retained_source_state(raw_frozen_sources)
580
+ frozen_source_digests = retained.get("sources")
581
+ saved_model_source = retained.get("threatModelSource")
582
+ model_source = [saved_model_source] if saved_model_source is not None else []
583
+ frozen_source_times = retained.get("sourceTimes")
597
584
  canonical_sources = frozen_source_digests
598
585
  if recovery_source_digests is not None:
599
586
  frozen_source_digests = recovery_source_digests
@@ -771,10 +758,7 @@ def preserve_scan_results_locked(
771
758
  scan_dir,
772
759
  scan_id,
773
760
  binding,
774
- connection.execute(
775
- "SELECT * FROM deep_scan_workers WHERE scan_id = ? ORDER BY created_at, id",
776
- (scan_id,),
777
- ).fetchall(),
761
+ saved_deep_workers(connection, scan),
778
762
  warnings,
779
763
  stopped=True,
780
764
  scan_mode=scan["mode"],
@@ -907,6 +891,7 @@ def preserve_scan_results_locked(
907
891
 
908
892
 
909
893
  def recover_scan_results(db: Any, connection: Any, args: Any) -> dict[str, Any]:
894
+ """Recover terminal results from saved checkpoints under the completion lock for a failed, uncanceled scan."""
910
895
  scan_id = db.require_uuid(args.scan_id, "scan-id")
911
896
  with db.scan_completion_lock(scan_id):
912
897
  scan = db.require_scan(connection, scan_id)
@@ -939,6 +924,7 @@ def recover_scan_results(db: Any, connection: Any, args: Any) -> dict[str, Any]:
939
924
 
940
925
 
941
926
  def preserve_scan_results(db: Any, connection: Any, args: Any) -> dict[str, Any]:
927
+ """Publish results for a stopped scan under its completion lock and return the updated scan context."""
942
928
  scan_id = db.require_uuid(args.scan_id, "scan-id")
943
929
  with db.scan_completion_lock(scan_id):
944
930
  scan = db.require_scan(connection, scan_id)
@@ -988,6 +974,9 @@ def save_scan_artifact(db: Any, connection: Any, args: Any) -> dict[str, Any]:
988
974
  scan_id = db.require_uuid(args.scan_id, "scan-id")
989
975
  with db.scan_completion_lock(scan_id):
990
976
  scan = db.require_scan(connection, scan_id)
977
+ db.handoff.require_tokenless_scan_owner(
978
+ connection, scan, getattr(args, "model_thread_id", None)
979
+ )
991
980
  db.handoff.require_current_continuation(
992
981
  scan,
993
982
  args.claim_token,
@@ -1016,9 +1005,18 @@ def save_scan_artifact(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1016
1005
 
1017
1006
 
1018
1007
  def write_scan_draft(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1008
+ """Publish a staged draft for the current continuation of a running, unsealed scan.
1009
+
1010
+ Read the draft from its registered scan directory and bind it to the scan
1011
+ before publishing it under the completion lock. Return the scan ID, the
1012
+ draft_written status, and any warning about the optional threat model.
1013
+ """
1019
1014
  scan_id = db.require_uuid(args.scan_id, "scan-id")
1020
1015
  with db.scan_completion_lock(scan_id):
1021
1016
  scan = db.require_scan(connection, scan_id)
1017
+ db.handoff.require_tokenless_scan_owner(
1018
+ connection, scan, getattr(args, "model_thread_id", None)
1019
+ )
1022
1020
  db.handoff.require_current_continuation(
1023
1021
  scan, args.claim_token, error_message="Scan draft is owned by another continuation."
1024
1022
  )
@@ -1240,6 +1238,27 @@ def _scan_draft_contents_digest(documents: dict[str, bytes | None]) -> str:
1240
1238
  return digest.hexdigest()
1241
1239
 
1242
1240
 
1241
+ def mark_running_scan_failed(
1242
+ connection: sqlite3.Connection, scan_id: str, message: str | None, timestamp: str
1243
+ ) -> bool:
1244
+ updated = connection.execute(
1245
+ """
1246
+ UPDATE scans SET status = 'failed', failure_message = ?, completed_at = ?, updated_at = ?,
1247
+ log_completed_at = ?
1248
+ WHERE id = ? AND status = 'running'
1249
+ """,
1250
+ (message, timestamp, timestamp, timestamp, scan_id),
1251
+ )
1252
+ return updated.rowcount == 1
1253
+
1254
+
1255
+ def touch_scan_progress(connection: sqlite3.Connection, scan_id: str, timestamp: str) -> bool:
1256
+ updated = connection.execute(
1257
+ "UPDATE scan_progress SET updated_at = ? WHERE scan_id = ?", (timestamp, scan_id)
1258
+ )
1259
+ return updated.rowcount == 1
1260
+
1261
+
1243
1262
  def fail_scan(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1244
1263
  with db.scan_completion_lock(db.require_uuid(args.scan_id, "scan-id")):
1245
1264
  return fail_scan_locked(db, connection, args)
@@ -1252,9 +1271,9 @@ def fail_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1252
1271
  with connection:
1253
1272
  timestamp = db.now()
1254
1273
  scan = db.require_scan(connection, scan_id)
1255
- if scan["status"] == "failed":
1256
- connection.commit()
1257
- return db.scan_context(connection, scan["id"])
1274
+ db.handoff.require_tokenless_scan_owner(
1275
+ connection, scan, getattr(args, "model_thread_id", None)
1276
+ )
1258
1277
  if scan["status"] == "complete":
1259
1278
  raise SystemExit("A completed scan cannot be marked failed.")
1260
1279
  db.handoff.require_current_continuation(
@@ -1262,25 +1281,17 @@ def fail_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1262
1281
  args.claim_token,
1263
1282
  error_message="Scan failure is owned by another continuation.",
1264
1283
  )
1284
+ if scan["status"] == "failed":
1285
+ connection.commit()
1286
+ record_stopped_scan_usage(db, connection, scan_id, cost_json)
1287
+ return db.scan_context(connection, scan["id"])
1265
1288
  message = db.optional_text(args.message)
1266
- updated = connection.execute(
1267
- """
1268
- UPDATE scans
1269
- SET status = 'failed', failure_message = ?, completed_at = ?, updated_at = ?,
1270
- cost_json = ?
1271
- WHERE id = ? AND status = 'running'
1272
- """,
1273
- (message, timestamp, timestamp, cost_json, scan["id"]),
1274
- )
1275
- if updated.rowcount != 1:
1289
+ if not mark_running_scan_failed(connection, scan_id, message, timestamp):
1276
1290
  raise SystemExit("Only a running scan can be marked failed.")
1277
1291
  db.deep_scan.fail_from_parent_scan(connection, scan["id"], message, timestamp)
1278
- progress_updated = connection.execute(
1279
- "UPDATE scan_progress SET updated_at = ? WHERE scan_id = ?",
1280
- (timestamp, scan["id"]),
1281
- )
1282
- if progress_updated.rowcount != 1:
1292
+ if not touch_scan_progress(connection, scan_id, timestamp):
1283
1293
  raise SystemExit("Codex Security scan progress not found.")
1294
+ record_stopped_scan_usage(db, connection, scan_id, cost_json)
1284
1295
  preserve_stopped_results_after_transition(db, connection, scan["id"])
1285
1296
  return db.scan_context(connection, scan["id"])
1286
1297
 
@@ -1293,6 +1304,9 @@ def cancel_scan(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1293
1304
  def cancel_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1294
1305
  scan_id = db.require_uuid(args.scan_id, "scan-id")
1295
1306
  thread_id = db.optional_text(args.thread_id, maximum=512)
1307
+ cost_json = db.parse_scan_cost(getattr(args, "cost_json", None))
1308
+ # The app displays the active scan. A conversation may only receive the scan it canceled.
1309
+ result_scan_id = scan_id if thread_id is not None else None
1296
1310
  connection.execute("BEGIN IMMEDIATE")
1297
1311
  with connection:
1298
1312
  timestamp = db.now()
@@ -1303,31 +1317,68 @@ def cancel_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1303
1317
  raise SystemExit("A scan can only be canceled from its owning Codex thread.")
1304
1318
  if scan["canceled_at"] is not None:
1305
1319
  connection.commit()
1306
- return db.workspace_state(connection, scan["workspace_id"])
1320
+ record_stopped_scan_usage(db, connection, scan_id, cost_json)
1321
+ return {
1322
+ **db.workspace_state(
1323
+ connection, scan["workspace_id"], result_scan_id=result_scan_id
1324
+ ),
1325
+ "canceledScanId": scan["id"],
1326
+ }
1307
1327
  if scan["status"] != "running":
1308
1328
  raise SystemExit("Only a running scan can be canceled.")
1309
1329
  updated = connection.execute(
1310
1330
  """
1311
1331
  UPDATE scans
1312
- SET status = 'failed', canceled_at = ?, completed_at = ?, updated_at = ?
1332
+ SET status = 'failed', canceled_at = ?, completed_at = ?, updated_at = ?, log_completed_at = ?
1313
1333
  WHERE id = ? AND status = 'running'
1314
1334
  """,
1315
- (timestamp, timestamp, timestamp, scan["id"]),
1335
+ (timestamp, timestamp, timestamp, timestamp, scan["id"]),
1316
1336
  )
1317
1337
  if updated.rowcount != 1:
1318
1338
  raise SystemExit("Only a running scan can be canceled.")
1319
1339
  db.deep_scan.cancel_from_parent_scan(connection, scan["id"], timestamp)
1320
- progress_updated = connection.execute(
1321
- "UPDATE scan_progress SET updated_at = ? WHERE scan_id = ?",
1322
- (timestamp, scan["id"]),
1323
- )
1324
- if progress_updated.rowcount != 1:
1340
+ if not touch_scan_progress(connection, scan_id, timestamp):
1325
1341
  raise SystemExit("Codex Security scan progress not found.")
1342
+ record_stopped_scan_usage(db, connection, scan_id, cost_json)
1326
1343
  preserve_stopped_results_after_transition(db, connection, scan["id"])
1327
- return db.workspace_state(connection, scan["workspace_id"])
1344
+ return {
1345
+ **db.workspace_state(connection, scan["workspace_id"], result_scan_id=result_scan_id),
1346
+ "canceledScanId": scan["id"],
1347
+ }
1348
+
1349
+
1350
+ def record_stopped_scan_usage(
1351
+ db: Any, connection: Any, scan_id: str, cost_json: str | None = None
1352
+ ) -> None:
1353
+ """Keep optional accounting independent of the already-persisted scan outcome."""
1354
+
1355
+ try:
1356
+ scan = db.require_scan(connection, scan_id)
1357
+ fields = db.scan_usage.merge_scan_usage_fields(
1358
+ db.scan_usage.stored_scan_cost_fields(scan["cost_json"]),
1359
+ db.scan_usage.stored_scan_cost_fields(cost_json),
1360
+ )
1361
+ fields = db.scan_usage.merge_scan_usage_fields(
1362
+ fields,
1363
+ {"usage": db.scan_usage.collect_scan_usage_safely(connection, scan)},
1364
+ )
1365
+ if fields:
1366
+ encoded = db.parse_scan_cost(json.dumps(fields))
1367
+ with connection:
1368
+ connection.execute(
1369
+ "UPDATE scans SET cost_json = ? WHERE id = ? AND status = 'failed'",
1370
+ (encoded, scan_id),
1371
+ )
1372
+ except (Exception, SystemExit) as exc:
1373
+ try:
1374
+ print(f"Could not save stopped scan token usage: {exc}", file=sys.stderr)
1375
+ except OSError:
1376
+ # A closed diagnostic stream must not alter the persisted scan outcome.
1377
+ pass
1328
1378
 
1329
1379
 
1330
1380
  def preserve_stopped_results_after_transition(db: Any, connection: Any, scan_id: str) -> None:
1381
+ """Try to publish saved evidence after stopping a scan and record a warning if publication fails."""
1331
1382
  try:
1332
1383
  published = preserve_scan_results_locked(db, connection, scan_id)
1333
1384
  except (ContractError, OSError, SystemExit, ValueError) as exc:
@@ -1468,11 +1519,15 @@ def budget_exhausted_draft(
1468
1519
  "surfaceIds": [surface_id],
1469
1520
  }
1470
1521
  )
1522
+ deferred_reason = "Validation was deferred because the scan reached its cost limit."
1523
+ limitations = manifest["scan"].setdefault("scope", {}).setdefault("limitations", [])
1524
+ if deferred_reason not in limitations:
1525
+ limitations.append(deferred_reason)
1471
1526
  if not any(
1472
1527
  isinstance(item, dict)
1473
1528
  and isinstance(reason := item.get("reason"), str)
1474
1529
  and (
1475
- reason == "Validation was deferred because the scan reached its cost limit."
1530
+ reason == deferred_reason
1476
1531
  or reason.startswith(
1477
1532
  "Validation was deferred because the scan reached its cost limit: "
1478
1533
  )
@@ -1482,7 +1537,7 @@ def budget_exhausted_draft(
1482
1537
  coverage["deferred"].append(
1483
1538
  {
1484
1539
  "id": "scan-cost-limit",
1485
- "reason": "Validation was deferred because the scan reached its cost limit.",
1540
+ "reason": deferred_reason,
1486
1541
  }
1487
1542
  )
1488
1543
  coverage.pop("completeness", None)