@openai/codex-security 0.8.3 → 0.10.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 (658) hide show
  1. package/README.md +36 -746
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +7 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/baseline-auditor.md +18 -0
  26. package/_bundled_plugin/references/core-scan.md +5 -42
  27. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  28. package/_bundled_plugin/references/final-report.md +5 -3
  29. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  30. package/_bundled_plugin/references/focused-investigator.md +13 -0
  31. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  32. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  33. package/_bundled_plugin/references/scan-contract.md +27 -33
  34. package/_bundled_plugin/references/scan-prologue.md +2 -2
  35. package/_bundled_plugin/references/scan-runtime.md +4 -2
  36. package/_bundled_plugin/references/security-guidance.md +14 -1
  37. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  38. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  39. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  40. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  41. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  42. package/_bundled_plugin/scripts/deep_scan_workbench.py +192 -352
  43. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  44. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  45. package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
  46. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  47. package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
  48. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  49. package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
  50. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  51. package/_bundled_plugin/scripts/report_projection.py +81 -43
  52. package/_bundled_plugin/scripts/review_state.py +8 -2
  53. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  54. package/_bundled_plugin/scripts/snapshot_sqlite.py +9 -2
  55. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  56. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  57. package/_bundled_plugin/scripts/windows_scan_local_files.py +582 -20
  58. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  59. package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
  60. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  61. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  62. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  63. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  64. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  65. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  66. package/_bundled_plugin/scripts/workbench/storage.py +91 -7
  67. package/_bundled_plugin/scripts/workbench_cli.py +54 -14
  68. package/_bundled_plugin/scripts/workbench_constants.py +12 -0
  69. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  70. package/_bundled_plugin/scripts/workbench_db.py +562 -303
  71. package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +238 -41
  75. package/_bundled_plugin/scripts/workbench_progress.py +169 -4
  76. package/_bundled_plugin/scripts/workbench_publication.py +16 -13
  77. package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
  82. package/_bundled_plugin/scripts/workbench_schema.py +258 -63
  83. package/_bundled_plugin/scripts/workbench_setup.py +14 -2
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  85. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  86. package/_bundled_plugin/scripts/workbench_target.py +594 -136
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
  88. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
  90. package/_bundled_plugin/shared/workbench-migrations.json +100 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  93. package/_bundled_plugin/skills/fix-finding/SKILL.md +2 -1
  94. package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
  95. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  96. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  97. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  98. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +409 -0
  99. package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
  100. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  104. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  105. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  106. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  107. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  108. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  110. package/bin/codex-security.mjs +2 -2
  111. package/dist/api.d.ts +45 -5
  112. package/dist/api.d.ts.map +1 -1
  113. package/dist/api.js +1192 -427
  114. package/dist/api.js.map +1 -1
  115. package/dist/armorcode-findings.d.ts +9 -0
  116. package/dist/armorcode-findings.d.ts.map +1 -0
  117. package/dist/armorcode-findings.js +145 -0
  118. package/dist/armorcode-findings.js.map +1 -0
  119. package/dist/artifact-export.d.ts +2 -0
  120. package/dist/artifact-export.d.ts.map +1 -1
  121. package/dist/artifact-export.js +29 -13
  122. package/dist/artifact-export.js.map +1 -1
  123. package/dist/auth.d.ts +6 -2
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +37 -18
  126. package/dist/auth.js.map +1 -1
  127. package/dist/batch-cost.d.ts +18 -0
  128. package/dist/batch-cost.d.ts.map +1 -0
  129. package/dist/batch-cost.js +41 -0
  130. package/dist/batch-cost.js.map +1 -0
  131. package/dist/bedrock-oss-pricing.d.ts +6 -0
  132. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  133. package/dist/bedrock-oss-pricing.js +58 -0
  134. package/dist/bedrock-oss-pricing.js.map +1 -0
  135. package/dist/bedrock-pricing.d.ts +15 -0
  136. package/dist/bedrock-pricing.d.ts.map +1 -0
  137. package/dist/bedrock-pricing.js +117 -0
  138. package/dist/bedrock-pricing.js.map +1 -0
  139. package/dist/blackduck-findings.d.ts +1 -1
  140. package/dist/blackduck-findings.d.ts.map +1 -1
  141. package/dist/blackduck-findings.js +24 -22
  142. package/dist/blackduck-findings.js.map +1 -1
  143. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  144. package/dist/bulk-scan-discovery.js +4 -4
  145. package/dist/bulk-scan-discovery.js.map +1 -1
  146. package/dist/bundled-plugin.d.ts +4 -0
  147. package/dist/bundled-plugin.d.ts.map +1 -0
  148. package/dist/bundled-plugin.js +23 -0
  149. package/dist/bundled-plugin.js.map +1 -0
  150. package/dist/checkmarx-evidence.d.ts +19 -0
  151. package/dist/checkmarx-evidence.d.ts.map +1 -0
  152. package/dist/checkmarx-evidence.js +36 -0
  153. package/dist/checkmarx-evidence.js.map +1 -0
  154. package/dist/checkmarx-findings.d.ts +4 -0
  155. package/dist/checkmarx-findings.d.ts.map +1 -0
  156. package/dist/checkmarx-findings.js +27 -0
  157. package/dist/checkmarx-findings.js.map +1 -0
  158. package/dist/checkmarx-one.d.ts +4 -0
  159. package/dist/checkmarx-one.d.ts.map +1 -0
  160. package/dist/checkmarx-one.js +53 -0
  161. package/dist/checkmarx-one.js.map +1 -0
  162. package/dist/checkmarx-repository.d.ts +12 -0
  163. package/dist/checkmarx-repository.d.ts.map +1 -0
  164. package/dist/checkmarx-repository.js +181 -0
  165. package/dist/checkmarx-repository.js.map +1 -0
  166. package/dist/checkmarx-xml.d.ts +12 -0
  167. package/dist/checkmarx-xml.d.ts.map +1 -0
  168. package/dist/checkmarx-xml.js +196 -0
  169. package/dist/checkmarx-xml.js.map +1 -0
  170. package/dist/classify-scan-severity.d.ts +1 -1
  171. package/dist/classify-scan-severity.d.ts.map +1 -1
  172. package/dist/classify-scan-severity.js +11 -3
  173. package/dist/classify-scan-severity.js.map +1 -1
  174. package/dist/classify-severity-records.d.ts +1 -9
  175. package/dist/classify-severity-records.d.ts.map +1 -1
  176. package/dist/classify-severity-records.js +3 -13
  177. package/dist/classify-severity-records.js.map +1 -1
  178. package/dist/classify-severity.d.ts.map +1 -1
  179. package/dist/classify-severity.js +11 -10
  180. package/dist/classify-severity.js.map +1 -1
  181. package/dist/cli-argument.d.ts +4 -0
  182. package/dist/cli-argument.d.ts.map +1 -0
  183. package/dist/cli-argument.js +17 -0
  184. package/dist/cli-argument.js.map +1 -0
  185. package/dist/cli-help.d.ts +1 -1
  186. package/dist/cli-help.d.ts.map +1 -1
  187. package/dist/cli-help.js +71 -29
  188. package/dist/cli-help.js.map +1 -1
  189. package/dist/cli-hook.d.ts +3 -0
  190. package/dist/cli-hook.d.ts.map +1 -0
  191. package/dist/cli-hook.js +87 -0
  192. package/dist/cli-hook.js.map +1 -0
  193. package/dist/cli-integrations.d.ts +13 -0
  194. package/dist/cli-integrations.d.ts.map +1 -0
  195. package/dist/cli-integrations.js +333 -0
  196. package/dist/cli-integrations.js.map +1 -0
  197. package/dist/cli-mcp.d.ts +15 -0
  198. package/dist/cli-mcp.d.ts.map +1 -0
  199. package/dist/cli-mcp.js +178 -0
  200. package/dist/cli-mcp.js.map +1 -0
  201. package/dist/cli-token-view.d.ts +10 -0
  202. package/dist/cli-token-view.d.ts.map +1 -0
  203. package/dist/cli-token-view.js +41 -0
  204. package/dist/cli-token-view.js.map +1 -0
  205. package/dist/cli.d.ts +16 -8
  206. package/dist/cli.d.ts.map +1 -1
  207. package/dist/cli.js +3382 -2017
  208. package/dist/cli.js.map +1 -1
  209. package/dist/cloud-publish.d.ts.map +1 -1
  210. package/dist/cloud-publish.js +35 -33
  211. package/dist/cloud-publish.js.map +1 -1
  212. package/dist/codex-sdk-environment.d.ts +6 -0
  213. package/dist/codex-sdk-environment.d.ts.map +1 -1
  214. package/dist/codex-sdk-environment.js +19 -0
  215. package/dist/codex-sdk-environment.js.map +1 -1
  216. package/dist/command-words.d.ts +3 -0
  217. package/dist/command-words.d.ts.map +1 -0
  218. package/dist/command-words.js +46 -0
  219. package/dist/command-words.js.map +1 -0
  220. package/dist/component-scan.d.ts +19 -4
  221. package/dist/component-scan.d.ts.map +1 -1
  222. package/dist/component-scan.js +67 -9
  223. package/dist/component-scan.js.map +1 -1
  224. package/dist/config.d.ts +1 -1
  225. package/dist/config.d.ts.map +1 -1
  226. package/dist/config.js +130 -67
  227. package/dist/config.js.map +1 -1
  228. package/dist/continuum-findings.d.ts +1 -1
  229. package/dist/continuum-findings.d.ts.map +1 -1
  230. package/dist/continuum-findings.js +149 -19
  231. package/dist/continuum-findings.js.map +1 -1
  232. package/dist/contract-values.d.ts +2 -0
  233. package/dist/contract-values.d.ts.map +1 -1
  234. package/dist/contract-values.js +12 -9
  235. package/dist/contract-values.js.map +1 -1
  236. package/dist/cost-model.d.ts +13 -1
  237. package/dist/cost-model.d.ts.map +1 -1
  238. package/dist/cost-model.js +66 -112
  239. package/dist/cost-model.js.map +1 -1
  240. package/dist/cost.d.ts +42 -3
  241. package/dist/cost.d.ts.map +1 -1
  242. package/dist/cost.js +484 -149
  243. package/dist/cost.js.map +1 -1
  244. package/dist/custom-publish.d.ts +4 -0
  245. package/dist/custom-publish.d.ts.map +1 -1
  246. package/dist/custom-publish.js +40 -3
  247. package/dist/custom-publish.js.map +1 -1
  248. package/dist/custom-validation-prompt.d.ts +1 -1
  249. package/dist/custom-validation-prompt.d.ts.map +1 -1
  250. package/dist/custom-validation-prompt.js +29 -19
  251. package/dist/custom-validation-prompt.js.map +1 -1
  252. package/dist/deduplication/local.d.ts +4 -2
  253. package/dist/deduplication/local.d.ts.map +1 -1
  254. package/dist/deduplication/local.js +9 -2
  255. package/dist/deduplication/local.js.map +1 -1
  256. package/dist/deduplication/refusal.d.ts.map +1 -1
  257. package/dist/deduplication/refusal.js +26 -5
  258. package/dist/deduplication/refusal.js.map +1 -1
  259. package/dist/deduplication/scan.d.ts +5 -0
  260. package/dist/deduplication/scan.d.ts.map +1 -1
  261. package/dist/deduplication/scan.js +24 -7
  262. package/dist/deduplication/scan.js.map +1 -1
  263. package/dist/deep-config.d.ts +0 -1
  264. package/dist/deep-config.d.ts.map +1 -1
  265. package/dist/deep-config.js +22 -33
  266. package/dist/deep-config.js.map +1 -1
  267. package/dist/deep-scan-defaults.d.ts +2 -0
  268. package/dist/deep-scan-defaults.d.ts.map +1 -1
  269. package/dist/deep-scan-defaults.js +28 -1
  270. package/dist/deep-scan-defaults.js.map +1 -1
  271. package/dist/deep-scan.d.ts +2 -0
  272. package/dist/deep-scan.d.ts.map +1 -1
  273. package/dist/deep-scan.js +44 -19
  274. package/dist/deep-scan.js.map +1 -1
  275. package/dist/default-severity-rubric.d.ts +1 -1
  276. package/dist/default-severity-rubric.d.ts.map +1 -1
  277. package/dist/default-severity-rubric.js +1 -1
  278. package/dist/default-severity-rubric.js.map +1 -1
  279. package/dist/endor-findings.d.ts +3 -1
  280. package/dist/endor-findings.d.ts.map +1 -1
  281. package/dist/endor-findings.js +86 -45
  282. package/dist/endor-findings.js.map +1 -1
  283. package/dist/errors.d.ts +4 -2
  284. package/dist/errors.d.ts.map +1 -1
  285. package/dist/errors.js +15 -4
  286. package/dist/errors.js.map +1 -1
  287. package/dist/executable-path.d.ts +3 -0
  288. package/dist/executable-path.d.ts.map +1 -1
  289. package/dist/executable-path.js +26 -0
  290. package/dist/executable-path.js.map +1 -1
  291. package/dist/external-findings-import.d.ts +5 -3
  292. package/dist/external-findings-import.d.ts.map +1 -1
  293. package/dist/external-findings-import.js +19 -7
  294. package/dist/external-findings-import.js.map +1 -1
  295. package/dist/external-findings-local.d.ts +69 -5
  296. package/dist/external-findings-local.d.ts.map +1 -1
  297. package/dist/external-findings-local.js +537 -108
  298. package/dist/external-findings-local.js.map +1 -1
  299. package/dist/external-findings-publish.d.ts +13 -6
  300. package/dist/external-findings-publish.d.ts.map +1 -1
  301. package/dist/external-findings-publish.js +895 -1142
  302. package/dist/external-findings-publish.js.map +1 -1
  303. package/dist/external-findings-read.d.ts +21 -2
  304. package/dist/external-findings-read.d.ts.map +1 -1
  305. package/dist/external-findings-read.js +130 -68
  306. package/dist/external-findings-read.js.map +1 -1
  307. package/dist/external-findings.d.ts +15 -3
  308. package/dist/external-findings.d.ts.map +1 -1
  309. package/dist/external-findings.js +54 -2
  310. package/dist/external-findings.js.map +1 -1
  311. package/dist/external-import-contract.d.ts +8 -12
  312. package/dist/external-import-contract.d.ts.map +1 -1
  313. package/dist/external-import-contract.js +51 -184
  314. package/dist/external-import-contract.js.map +1 -1
  315. package/dist/external-import-models.d.ts +1 -1
  316. package/dist/external-import-models.d.ts.map +1 -1
  317. package/dist/external-import-models.js.map +1 -1
  318. package/dist/feedback.d.ts.map +1 -1
  319. package/dist/feedback.js +5 -4
  320. package/dist/feedback.js.map +1 -1
  321. package/dist/finding-prompt.d.ts +5 -0
  322. package/dist/finding-prompt.d.ts.map +1 -0
  323. package/dist/finding-prompt.js +32 -0
  324. package/dist/finding-prompt.js.map +1 -0
  325. package/dist/findings-client.d.ts +1 -0
  326. package/dist/findings-client.d.ts.map +1 -1
  327. package/dist/findings-client.js +27 -3
  328. package/dist/findings-client.js.map +1 -1
  329. package/dist/github-advisories.d.ts.map +1 -1
  330. package/dist/github-advisories.js +0 -2
  331. package/dist/github-advisories.js.map +1 -1
  332. package/dist/github-dependabot-findings.d.ts.map +1 -1
  333. package/dist/github-dependabot-findings.js +18 -8
  334. package/dist/github-dependabot-findings.js.map +1 -1
  335. package/dist/github-findings.d.ts +4 -1
  336. package/dist/github-findings.d.ts.map +1 -1
  337. package/dist/github-findings.js +73 -316
  338. package/dist/github-findings.js.map +1 -1
  339. package/dist/hosted-git-remotes.d.ts +5 -0
  340. package/dist/hosted-git-remotes.d.ts.map +1 -0
  341. package/dist/hosted-git-remotes.js +285 -0
  342. package/dist/hosted-git-remotes.js.map +1 -0
  343. package/dist/hosted-git-repository.d.ts +28 -0
  344. package/dist/hosted-git-repository.d.ts.map +1 -0
  345. package/dist/hosted-git-repository.js +222 -0
  346. package/dist/hosted-git-repository.js.map +1 -0
  347. package/dist/hosted-remediation.d.ts +1 -0
  348. package/dist/hosted-remediation.d.ts.map +1 -1
  349. package/dist/hosted-remediation.js +23 -3
  350. package/dist/hosted-remediation.js.map +1 -1
  351. package/dist/hosted-scan-protocol.js +2 -2
  352. package/dist/hosted-scan-protocol.js.map +1 -1
  353. package/dist/hosted-scan.d.ts.map +1 -1
  354. package/dist/hosted-scan.js +16 -11
  355. package/dist/hosted-scan.js.map +1 -1
  356. package/dist/hosted-scanner-http.d.ts +21 -0
  357. package/dist/hosted-scanner-http.d.ts.map +1 -0
  358. package/dist/hosted-scanner-http.js +204 -0
  359. package/dist/hosted-scanner-http.js.map +1 -0
  360. package/dist/import-scan.d.ts.map +1 -1
  361. package/dist/import-scan.js +3 -0
  362. package/dist/import-scan.js.map +1 -1
  363. package/dist/index.d.ts +21 -9
  364. package/dist/index.d.ts.map +1 -1
  365. package/dist/index.js +12 -3
  366. package/dist/index.js.map +1 -1
  367. package/dist/inspector-findings.d.ts.map +1 -1
  368. package/dist/inspector-findings.js +52 -86
  369. package/dist/inspector-findings.js.map +1 -1
  370. package/dist/knowledge-base.d.ts +1 -1
  371. package/dist/knowledge-base.d.ts.map +1 -1
  372. package/dist/knowledge-base.js +102 -32
  373. package/dist/knowledge-base.js.map +1 -1
  374. package/dist/linear.d.ts +11 -0
  375. package/dist/linear.d.ts.map +1 -1
  376. package/dist/linear.js.map +1 -1
  377. package/dist/local-git-metadata.d.ts +5 -2
  378. package/dist/local-git-metadata.d.ts.map +1 -1
  379. package/dist/local-git-metadata.js +8 -5
  380. package/dist/local-git-metadata.js.map +1 -1
  381. package/dist/multiscan.d.ts +10 -4
  382. package/dist/multiscan.d.ts.map +1 -1
  383. package/dist/multiscan.js +217 -102
  384. package/dist/multiscan.js.map +1 -1
  385. package/dist/native-json-findings.d.ts +2 -1
  386. package/dist/native-json-findings.d.ts.map +1 -1
  387. package/dist/native-json-findings.js +12 -2
  388. package/dist/native-json-findings.js.map +1 -1
  389. package/dist/opengrep-findings.d.ts +5 -2
  390. package/dist/opengrep-findings.d.ts.map +1 -1
  391. package/dist/opengrep-findings.js +54 -33
  392. package/dist/opengrep-findings.js.map +1 -1
  393. package/dist/operation-telemetry.d.ts +104 -0
  394. package/dist/operation-telemetry.d.ts.map +1 -0
  395. package/dist/operation-telemetry.js +293 -0
  396. package/dist/operation-telemetry.js.map +1 -0
  397. package/dist/plugin-python-probe.d.ts +4 -0
  398. package/dist/plugin-python-probe.d.ts.map +1 -0
  399. package/dist/plugin-python-probe.js +10 -0
  400. package/dist/plugin-python-probe.js.map +1 -0
  401. package/dist/private-finding-import.d.ts +99 -9
  402. package/dist/private-finding-import.d.ts.map +1 -1
  403. package/dist/private-finding-import.js +116 -152
  404. package/dist/private-finding-import.js.map +1 -1
  405. package/dist/project-config.d.ts.map +1 -1
  406. package/dist/project-config.js +53 -13
  407. package/dist/project-config.js.map +1 -1
  408. package/dist/prompt-files.d.ts +7 -2
  409. package/dist/prompt-files.d.ts.map +1 -1
  410. package/dist/prompt-files.js +42 -20
  411. package/dist/prompt-files.js.map +1 -1
  412. package/dist/provider-profile.d.ts +1 -1
  413. package/dist/provider-profile.d.ts.map +1 -1
  414. package/dist/provider-profile.js +12 -10
  415. package/dist/provider-profile.js.map +1 -1
  416. package/dist/publication-telemetry.d.ts +45 -0
  417. package/dist/publication-telemetry.d.ts.map +1 -0
  418. package/dist/publication-telemetry.js +50 -0
  419. package/dist/publication-telemetry.js.map +1 -0
  420. package/dist/publication.d.ts +1 -1
  421. package/dist/publication.d.ts.map +1 -1
  422. package/dist/publication.js.map +1 -1
  423. package/dist/publish.d.ts +4 -0
  424. package/dist/publish.d.ts.map +1 -1
  425. package/dist/publish.js +42 -2
  426. package/dist/publish.js.map +1 -1
  427. package/dist/record.d.ts +1 -5
  428. package/dist/record.d.ts.map +1 -1
  429. package/dist/record.js +3 -51
  430. package/dist/record.js.map +1 -1
  431. package/dist/remediation.d.ts +1 -4
  432. package/dist/remediation.d.ts.map +1 -1
  433. package/dist/remediation.js +6 -8
  434. package/dist/remediation.js.map +1 -1
  435. package/dist/request-metadata.d.ts +3 -0
  436. package/dist/request-metadata.d.ts.map +1 -1
  437. package/dist/request-metadata.js +9 -0
  438. package/dist/request-metadata.js.map +1 -1
  439. package/dist/result.d.ts +4 -0
  440. package/dist/result.d.ts.map +1 -1
  441. package/dist/result.js +1 -1
  442. package/dist/result.js.map +1 -1
  443. package/dist/retry-windows-rename.d.ts +8 -0
  444. package/dist/retry-windows-rename.d.ts.map +1 -0
  445. package/dist/retry-windows-rename.js +24 -0
  446. package/dist/retry-windows-rename.js.map +1 -0
  447. package/dist/runtime.d.ts +54 -6
  448. package/dist/runtime.d.ts.map +1 -1
  449. package/dist/runtime.js +1084 -256
  450. package/dist/runtime.js.map +1 -1
  451. package/dist/saved-scan-bootstrap.d.ts +7 -1
  452. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  453. package/dist/saved-scan-bootstrap.js +269 -114
  454. package/dist/saved-scan-bootstrap.js.map +1 -1
  455. package/dist/scan-activity.d.ts.map +1 -1
  456. package/dist/scan-activity.js +141 -56
  457. package/dist/scan-activity.js.map +1 -1
  458. package/dist/scan-archive-path.d.ts +2 -0
  459. package/dist/scan-archive-path.d.ts.map +1 -0
  460. package/dist/scan-archive-path.js +5 -0
  461. package/dist/scan-archive-path.js.map +1 -0
  462. package/dist/scan-comparison.d.ts +10 -5
  463. package/dist/scan-comparison.d.ts.map +1 -1
  464. package/dist/scan-comparison.js +66 -17
  465. package/dist/scan-comparison.js.map +1 -1
  466. package/dist/scan-dashboard.d.ts +7 -6
  467. package/dist/scan-dashboard.d.ts.map +1 -1
  468. package/dist/scan-dashboard.js +92 -43
  469. package/dist/scan-dashboard.js.map +1 -1
  470. package/dist/scan-executor.d.ts +10 -1
  471. package/dist/scan-executor.d.ts.map +1 -1
  472. package/dist/scan-executor.js +24 -2
  473. package/dist/scan-executor.js.map +1 -1
  474. package/dist/scan-history-renderer.d.ts +1 -0
  475. package/dist/scan-history-renderer.d.ts.map +1 -1
  476. package/dist/scan-history-renderer.js +34 -28
  477. package/dist/scan-history-renderer.js.map +1 -1
  478. package/dist/scan-logs.d.ts +12 -0
  479. package/dist/scan-logs.d.ts.map +1 -1
  480. package/dist/scan-logs.js +131 -78
  481. package/dist/scan-logs.js.map +1 -1
  482. package/dist/scan-measurement.d.ts +26 -0
  483. package/dist/scan-measurement.d.ts.map +1 -0
  484. package/dist/scan-measurement.js +77 -0
  485. package/dist/scan-measurement.js.map +1 -0
  486. package/dist/scan-progress.d.ts +1 -0
  487. package/dist/scan-progress.d.ts.map +1 -1
  488. package/dist/scan-progress.js +3 -0
  489. package/dist/scan-progress.js.map +1 -1
  490. package/dist/scan-sessions.d.ts.map +1 -1
  491. package/dist/scan-sessions.js +4 -1
  492. package/dist/scan-sessions.js.map +1 -1
  493. package/dist/scan-settings.d.ts +1 -1
  494. package/dist/scan-settings.d.ts.map +1 -1
  495. package/dist/scan-settings.js +1 -24
  496. package/dist/scan-settings.js.map +1 -1
  497. package/dist/scanner-import.d.ts +25 -13
  498. package/dist/scanner-import.d.ts.map +1 -1
  499. package/dist/scanner-import.js +216 -97
  500. package/dist/scanner-import.js.map +1 -1
  501. package/dist/scanner-repository-url.d.ts +4 -1
  502. package/dist/scanner-repository-url.d.ts.map +1 -1
  503. package/dist/scanner-repository-url.js +10 -6
  504. package/dist/scanner-repository-url.js.map +1 -1
  505. package/dist/security-policy.d.ts +1 -1
  506. package/dist/security-policy.d.ts.map +1 -1
  507. package/dist/security-policy.js +26 -6
  508. package/dist/security-policy.js.map +1 -1
  509. package/dist/semgrep-findings.d.ts +6 -3
  510. package/dist/semgrep-findings.d.ts.map +1 -1
  511. package/dist/semgrep-findings.js +72 -42
  512. package/dist/semgrep-findings.js.map +1 -1
  513. package/dist/semgrep-guardian-findings.d.ts +38 -0
  514. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  515. package/dist/semgrep-guardian-findings.js +165 -0
  516. package/dist/semgrep-guardian-findings.js.map +1 -0
  517. package/dist/semgrep-platform-collector.d.ts +26 -0
  518. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  519. package/dist/semgrep-platform-collector.js +108 -0
  520. package/dist/semgrep-platform-collector.js.map +1 -0
  521. package/dist/semgrep-platform-findings.d.ts +157 -6
  522. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  523. package/dist/semgrep-platform-findings.js +766 -103
  524. package/dist/semgrep-platform-findings.js.map +1 -1
  525. package/dist/server/api.d.ts +1 -1
  526. package/dist/server/api.d.ts.map +1 -1
  527. package/dist/server/api.js.map +1 -1
  528. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  529. package/dist/server/embedding-tokenizer.d.ts +2 -0
  530. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  531. package/dist/server/embedding-tokenizer.js +322 -0
  532. package/dist/server/embedding-tokenizer.js.map +6 -0
  533. package/dist/server/embeddings.d.ts +16 -2
  534. package/dist/server/embeddings.d.ts.map +1 -1
  535. package/dist/server/embeddings.js +35 -5
  536. package/dist/server/embeddings.js.map +1 -1
  537. package/dist/session-lines.d.ts +5 -0
  538. package/dist/session-lines.d.ts.map +1 -0
  539. package/dist/session-lines.js +60 -0
  540. package/dist/session-lines.js.map +1 -0
  541. package/dist/severity-review.d.ts +3 -1
  542. package/dist/severity-review.d.ts.map +1 -1
  543. package/dist/severity-review.js +3 -2
  544. package/dist/severity-review.js.map +1 -1
  545. package/dist/skill-authentication.d.ts +1 -0
  546. package/dist/skill-authentication.d.ts.map +1 -1
  547. package/dist/skill-authentication.js +1 -0
  548. package/dist/skill-authentication.js.map +1 -1
  549. package/dist/snyk-findings.d.ts +9 -2
  550. package/dist/snyk-findings.d.ts.map +1 -1
  551. package/dist/snyk-findings.js +90 -70
  552. package/dist/snyk-findings.js.map +1 -1
  553. package/dist/snyk-rest-findings.d.ts +59 -0
  554. package/dist/snyk-rest-findings.d.ts.map +1 -0
  555. package/dist/snyk-rest-findings.js +879 -0
  556. package/dist/snyk-rest-findings.js.map +1 -0
  557. package/dist/snyk-token-origin.d.ts +4 -0
  558. package/dist/snyk-token-origin.d.ts.map +1 -0
  559. package/dist/snyk-token-origin.js +82 -0
  560. package/dist/snyk-token-origin.js.map +1 -0
  561. package/dist/sonar-collector.d.ts.map +1 -1
  562. package/dist/sonar-collector.js +0 -3
  563. package/dist/sonar-collector.js.map +1 -1
  564. package/dist/sonar-findings.d.ts +1 -1
  565. package/dist/sonar-findings.d.ts.map +1 -1
  566. package/dist/sonar-findings.js +2 -4
  567. package/dist/sonar-findings.js.map +1 -1
  568. package/dist/sonar-import.d.ts +3 -0
  569. package/dist/sonar-import.d.ts.map +1 -1
  570. package/dist/sonar-import.js +30 -34
  571. package/dist/sonar-import.js.map +1 -1
  572. package/dist/stored-finding-projection.d.ts +6 -0
  573. package/dist/stored-finding-projection.d.ts.map +1 -0
  574. package/dist/stored-finding-projection.js +104 -0
  575. package/dist/stored-finding-projection.js.map +1 -0
  576. package/dist/stored-findings-publication.d.ts +23 -0
  577. package/dist/stored-findings-publication.d.ts.map +1 -0
  578. package/dist/stored-findings-publication.js +169 -0
  579. package/dist/stored-findings-publication.js.map +1 -0
  580. package/dist/target-drift.d.ts +9 -0
  581. package/dist/target-drift.d.ts.map +1 -0
  582. package/dist/target-drift.js +27 -0
  583. package/dist/target-drift.js.map +1 -0
  584. package/dist/targets.d.ts +8 -1
  585. package/dist/targets.d.ts.map +1 -1
  586. package/dist/targets.js +131 -42
  587. package/dist/targets.js.map +1 -1
  588. package/dist/tenable-findings.d.ts +6 -0
  589. package/dist/tenable-findings.d.ts.map +1 -0
  590. package/dist/tenable-findings.js +122 -0
  591. package/dist/tenable-findings.js.map +1 -0
  592. package/dist/terminal-stream.d.ts +13 -0
  593. package/dist/terminal-stream.d.ts.map +1 -0
  594. package/dist/terminal-stream.js +35 -0
  595. package/dist/terminal-stream.js.map +1 -0
  596. package/dist/trivy-findings.d.ts +19 -0
  597. package/dist/trivy-findings.d.ts.map +1 -0
  598. package/dist/trivy-findings.js +424 -0
  599. package/dist/trivy-findings.js.map +1 -0
  600. package/dist/trivy-import.d.ts +19 -0
  601. package/dist/trivy-import.d.ts.map +1 -0
  602. package/dist/trivy-import.js +151 -0
  603. package/dist/trivy-import.js.map +1 -0
  604. package/dist/trusted-executable.d.ts +6 -0
  605. package/dist/trusted-executable.d.ts.map +1 -1
  606. package/dist/trusted-executable.js +140 -37
  607. package/dist/trusted-executable.js.map +1 -1
  608. package/dist/validation-records.js +1 -1
  609. package/dist/validation-records.js.map +1 -1
  610. package/dist/veracode-findings.d.ts +1 -1
  611. package/dist/veracode-findings.d.ts.map +1 -1
  612. package/dist/veracode-findings.js +19 -6
  613. package/dist/veracode-findings.js.map +1 -1
  614. package/dist/version.d.ts +3 -1
  615. package/dist/version.d.ts.map +1 -1
  616. package/dist/version.js +184 -32
  617. package/dist/version.js.map +1 -1
  618. package/dist/vertex-pricing.d.ts +8 -0
  619. package/dist/vertex-pricing.d.ts.map +1 -0
  620. package/dist/vertex-pricing.js +20 -0
  621. package/dist/vertex-pricing.js.map +1 -0
  622. package/dist/windows-path.d.ts +1 -0
  623. package/dist/windows-path.d.ts.map +1 -1
  624. package/dist/windows-path.js +26 -1
  625. package/dist/windows-path.js.map +1 -1
  626. package/dist/wiz-findings.d.ts +6 -2
  627. package/dist/wiz-findings.d.ts.map +1 -1
  628. package/dist/wiz-findings.js +65 -89
  629. package/dist/wiz-findings.js.map +1 -1
  630. package/docs/classify-severity-records.md +27 -12
  631. package/docs/cli.md +853 -639
  632. package/docs/dedupe-records.md +44 -24
  633. package/docs/findings-service.md +84 -44
  634. package/docs/hosted-remediation.md +27 -11
  635. package/docs/hosted-scans.md +50 -42
  636. package/docs/sdk.md +903 -0
  637. package/docs/telemetry.md +236 -0
  638. package/docs/validate-records.md +78 -44
  639. package/package.json +23 -16
  640. package/schemas/external-findings.schema.json +4 -1
  641. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  642. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  643. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  644. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  645. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  646. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  647. package/dist/external-imports-feature.d.ts +0 -6
  648. package/dist/external-imports-feature.d.ts.map +0 -1
  649. package/dist/external-imports-feature.js +0 -51
  650. package/dist/external-imports-feature.js.map +0 -1
  651. package/dist/finding-normalization.d.ts +0 -5
  652. package/dist/finding-normalization.d.ts.map +0 -1
  653. package/dist/finding-normalization.js +0 -155
  654. package/dist/finding-normalization.js.map +0 -1
  655. package/dist/reader-selection.d.ts +0 -13
  656. package/dist/reader-selection.d.ts.map +0 -1
  657. package/dist/reader-selection.js +0 -81
  658. package/dist/reader-selection.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,34 @@ 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(
1256
+ connection: sqlite3.Connection,
1257
+ scan_id: str,
1258
+ timestamp: str,
1259
+ scope_file_count: int | None = None,
1260
+ ) -> bool:
1261
+ updated = connection.execute(
1262
+ "UPDATE scan_progress SET updated_at = ?, scope_file_count = COALESCE(?, scope_file_count) "
1263
+ "WHERE scan_id = ?",
1264
+ (timestamp, scope_file_count, scan_id),
1265
+ )
1266
+ return updated.rowcount == 1
1267
+
1268
+
1243
1269
  def fail_scan(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1244
1270
  with db.scan_completion_lock(db.require_uuid(args.scan_id, "scan-id")):
1245
1271
  return fail_scan_locked(db, connection, args)
@@ -1248,13 +1274,25 @@ def fail_scan(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1248
1274
  def fail_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1249
1275
  scan_id = db.require_uuid(args.scan_id, "scan-id")
1250
1276
  cost_json = db.parse_scan_cost(args.cost_json)
1277
+ observed = db.require_scan(connection, scan_id)
1278
+ scope_file_count = None
1279
+ if observed["status"] == "running" and observed["mode"] == "standard":
1280
+ db.handoff.require_tokenless_scan_owner(
1281
+ connection, observed, getattr(args, "model_thread_id", None)
1282
+ )
1283
+ db.handoff.require_current_continuation(
1284
+ observed,
1285
+ args.claim_token,
1286
+ error_message="Scan failure is owned by another continuation.",
1287
+ )
1288
+ scope_file_count = db.progress.reported_scope_file_count(db, observed)
1251
1289
  connection.execute("BEGIN IMMEDIATE")
1252
1290
  with connection:
1253
1291
  timestamp = db.now()
1254
1292
  scan = db.require_scan(connection, scan_id)
1255
- if scan["status"] == "failed":
1256
- connection.commit()
1257
- return db.scan_context(connection, scan["id"])
1293
+ db.handoff.require_tokenless_scan_owner(
1294
+ connection, scan, getattr(args, "model_thread_id", None)
1295
+ )
1258
1296
  if scan["status"] == "complete":
1259
1297
  raise SystemExit("A completed scan cannot be marked failed.")
1260
1298
  db.handoff.require_current_continuation(
@@ -1262,25 +1300,22 @@ def fail_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1262
1300
  args.claim_token,
1263
1301
  error_message="Scan failure is owned by another continuation.",
1264
1302
  )
1303
+ if scan["status"] == "failed":
1304
+ connection.commit()
1305
+ record_stopped_scan_usage(db, connection, scan_id, cost_json)
1306
+ return db.scan_context(connection, scan["id"])
1265
1307
  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:
1308
+ if not mark_running_scan_failed(connection, scan_id, message, timestamp):
1276
1309
  raise SystemExit("Only a running scan can be marked failed.")
1277
1310
  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:
1311
+ if not touch_scan_progress(
1312
+ connection,
1313
+ scan_id,
1314
+ timestamp,
1315
+ scope_file_count if scan["scan_dir"] == observed["scan_dir"] else None,
1316
+ ):
1283
1317
  raise SystemExit("Codex Security scan progress not found.")
1318
+ record_stopped_scan_usage(db, connection, scan_id, cost_json)
1284
1319
  preserve_stopped_results_after_transition(db, connection, scan["id"])
1285
1320
  return db.scan_context(connection, scan["id"])
1286
1321
 
@@ -1290,44 +1325,100 @@ def cancel_scan(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1290
1325
  return cancel_scan_locked(db, connection, args)
1291
1326
 
1292
1327
 
1328
+ def require_cancel_owner(
1329
+ db: Any, connection: Any, scan: sqlite3.Row, thread_id: str | None
1330
+ ) -> None:
1331
+ workspace = db.require_workspace(connection, scan["workspace_id"])
1332
+ owning_thread_id = scan["continuation_thread_id"] or workspace["thread_id"]
1333
+ if thread_id is not None and owning_thread_id != thread_id:
1334
+ raise SystemExit("A scan can only be canceled from its owning Codex thread.")
1335
+
1336
+
1293
1337
  def cancel_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
1294
1338
  scan_id = db.require_uuid(args.scan_id, "scan-id")
1295
1339
  thread_id = db.optional_text(args.thread_id, maximum=512)
1340
+ observed = db.require_scan(connection, scan_id)
1341
+ scope_file_count = None
1342
+ if observed["status"] == "running" and observed["mode"] == "standard":
1343
+ require_cancel_owner(db, connection, observed, thread_id)
1344
+ scope_file_count = db.progress.reported_scope_file_count(db, observed)
1345
+ cost_json = db.parse_scan_cost(getattr(args, "cost_json", None))
1346
+ # The app displays the active scan. A conversation may only receive the scan it canceled.
1347
+ result_scan_id = scan_id if thread_id is not None else None
1296
1348
  connection.execute("BEGIN IMMEDIATE")
1297
1349
  with connection:
1298
1350
  timestamp = db.now()
1299
1351
  scan = db.require_scan(connection, scan_id)
1300
- workspace = db.require_workspace(connection, scan["workspace_id"])
1301
- owning_thread_id = scan["continuation_thread_id"] or workspace["thread_id"]
1302
- if thread_id is not None and owning_thread_id != thread_id:
1303
- raise SystemExit("A scan can only be canceled from its owning Codex thread.")
1352
+ require_cancel_owner(db, connection, scan, thread_id)
1304
1353
  if scan["canceled_at"] is not None:
1305
1354
  connection.commit()
1306
- return db.workspace_state(connection, scan["workspace_id"])
1355
+ record_stopped_scan_usage(db, connection, scan_id, cost_json)
1356
+ return {
1357
+ **db.workspace_state(
1358
+ connection, scan["workspace_id"], result_scan_id=result_scan_id
1359
+ ),
1360
+ "canceledScanId": scan["id"],
1361
+ }
1307
1362
  if scan["status"] != "running":
1308
1363
  raise SystemExit("Only a running scan can be canceled.")
1309
1364
  updated = connection.execute(
1310
1365
  """
1311
1366
  UPDATE scans
1312
- SET status = 'failed', canceled_at = ?, completed_at = ?, updated_at = ?
1367
+ SET status = 'failed', canceled_at = ?, completed_at = ?, updated_at = ?, log_completed_at = ?
1313
1368
  WHERE id = ? AND status = 'running'
1314
1369
  """,
1315
- (timestamp, timestamp, timestamp, scan["id"]),
1370
+ (timestamp, timestamp, timestamp, timestamp, scan["id"]),
1316
1371
  )
1317
1372
  if updated.rowcount != 1:
1318
1373
  raise SystemExit("Only a running scan can be canceled.")
1319
1374
  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:
1375
+ if not touch_scan_progress(
1376
+ connection,
1377
+ scan_id,
1378
+ timestamp,
1379
+ scope_file_count if scan["scan_dir"] == observed["scan_dir"] else None,
1380
+ ):
1325
1381
  raise SystemExit("Codex Security scan progress not found.")
1382
+ record_stopped_scan_usage(db, connection, scan_id, cost_json)
1326
1383
  preserve_stopped_results_after_transition(db, connection, scan["id"])
1327
- return db.workspace_state(connection, scan["workspace_id"])
1384
+ return {
1385
+ **db.workspace_state(connection, scan["workspace_id"], result_scan_id=result_scan_id),
1386
+ "canceledScanId": scan["id"],
1387
+ }
1388
+
1389
+
1390
+ def record_stopped_scan_usage(
1391
+ db: Any, connection: Any, scan_id: str, cost_json: str | None = None
1392
+ ) -> None:
1393
+ """Keep optional accounting independent of the already-persisted scan outcome."""
1394
+
1395
+ try:
1396
+ scan = db.require_scan(connection, scan_id)
1397
+ fields = db.scan_usage.merge_scan_usage_fields(
1398
+ db.scan_usage.stored_scan_cost_fields(scan["cost_json"]),
1399
+ db.scan_usage.stored_scan_cost_fields(cost_json),
1400
+ )
1401
+ fields = db.scan_usage.merge_scan_usage_fields(
1402
+ fields,
1403
+ {"usage": db.scan_usage.collect_scan_usage_safely(connection, scan)},
1404
+ )
1405
+ if fields:
1406
+ encoded = db.parse_scan_cost(json.dumps(fields))
1407
+ with connection:
1408
+ connection.execute(
1409
+ "UPDATE scans SET cost_json = ? WHERE id = ? AND status = 'failed'",
1410
+ (encoded, scan_id),
1411
+ )
1412
+ except (Exception, SystemExit) as exc:
1413
+ try:
1414
+ print(f"Could not save stopped scan token usage: {exc}", file=sys.stderr)
1415
+ except OSError:
1416
+ # A closed diagnostic stream must not alter the persisted scan outcome.
1417
+ pass
1328
1418
 
1329
1419
 
1330
1420
  def preserve_stopped_results_after_transition(db: Any, connection: Any, scan_id: str) -> None:
1421
+ """Try to publish saved evidence after stopping a scan and record a warning if publication fails."""
1331
1422
  try:
1332
1423
  published = preserve_scan_results_locked(db, connection, scan_id)
1333
1424
  except (ContractError, OSError, SystemExit, ValueError) as exc:
@@ -1468,11 +1559,15 @@ def budget_exhausted_draft(
1468
1559
  "surfaceIds": [surface_id],
1469
1560
  }
1470
1561
  )
1562
+ deferred_reason = "Validation was deferred because the scan reached its cost limit."
1563
+ limitations = manifest["scan"].setdefault("scope", {}).setdefault("limitations", [])
1564
+ if deferred_reason not in limitations:
1565
+ limitations.append(deferred_reason)
1471
1566
  if not any(
1472
1567
  isinstance(item, dict)
1473
1568
  and isinstance(reason := item.get("reason"), str)
1474
1569
  and (
1475
- reason == "Validation was deferred because the scan reached its cost limit."
1570
+ reason == deferred_reason
1476
1571
  or reason.startswith(
1477
1572
  "Validation was deferred because the scan reached its cost limit: "
1478
1573
  )
@@ -1482,7 +1577,7 @@ def budget_exhausted_draft(
1482
1577
  coverage["deferred"].append(
1483
1578
  {
1484
1579
  "id": "scan-cost-limit",
1485
- "reason": "Validation was deferred because the scan reached its cost limit.",
1580
+ "reason": deferred_reason,
1486
1581
  }
1487
1582
  )
1488
1583
  coverage.pop("completeness", None)