@openai/codex-security 0.2.0 → 0.3.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 (463) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +2 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
  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/permission-profile-preflight.mjs +563 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +2 -2
  25. package/_bundled_plugin/references/config-preflight.md +0 -4
  26. package/_bundled_plugin/references/core-scan.md +21 -9
  27. package/_bundled_plugin/references/final-report.md +10 -12
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +1 -2
  31. package/_bundled_plugin/references/scan-contract.md +9 -4
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +1 -1
  36. package/_bundled_plugin/schemas/coverage.schema.json +1 -47
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +71 -192
  40. package/_bundled_plugin/schemas/scan-manifest.schema.json +18 -45
  41. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  42. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  43. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  44. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  45. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  46. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  47. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  48. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  49. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  52. package/_bundled_plugin/scripts/finalize_scan_contract.py +315 -232
  53. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  54. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  55. package/_bundled_plugin/scripts/generate_rank_input.py +99 -829
  56. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  58. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  59. package/_bundled_plugin/scripts/report_projection.py +117 -172
  60. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  61. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  62. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  63. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  64. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  65. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  66. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  67. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  68. package/_bundled_plugin/scripts/workbench_cli.py +94 -179
  69. package/_bundled_plugin/scripts/workbench_db.py +427 -463
  70. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  71. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  72. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  73. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  75. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  76. package/_bundled_plugin/scripts/workbench_publication.py +33 -57
  77. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +23 -34
  82. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  83. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  84. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  85. package/_bundled_plugin/scripts/workbench_validation.py +16 -27
  86. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  87. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  88. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  89. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  90. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  91. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  93. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  94. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  95. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  96. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  97. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  98. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  99. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  100. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +1 -1
  101. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  102. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  103. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  104. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  105. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  106. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  107. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  108. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  110. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  111. package/bin/codex-security.mjs +9 -2
  112. package/dist/api.d.ts +60 -10
  113. package/dist/api.d.ts.map +1 -1
  114. package/dist/api.js +803 -380
  115. package/dist/api.js.map +1 -1
  116. package/dist/artifact-export.d.ts +1 -1
  117. package/dist/artifact-export.d.ts.map +1 -1
  118. package/dist/artifact-export.js +28 -13
  119. package/dist/artifact-export.js.map +1 -1
  120. package/dist/auth.d.ts +2 -6
  121. package/dist/auth.d.ts.map +1 -1
  122. package/dist/auth.js +19 -9
  123. package/dist/auth.js.map +1 -1
  124. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  125. package/dist/bulk-scan-discovery.js +1 -0
  126. package/dist/bulk-scan-discovery.js.map +1 -1
  127. package/dist/classify-severity.d.ts +26 -9
  128. package/dist/classify-severity.d.ts.map +1 -1
  129. package/dist/classify-severity.js +13 -30
  130. package/dist/classify-severity.js.map +1 -1
  131. package/dist/cli-help.d.ts.map +1 -1
  132. package/dist/cli-help.js +17 -13
  133. package/dist/cli-help.js.map +1 -1
  134. package/dist/cli-signals.d.ts +8 -0
  135. package/dist/cli-signals.d.ts.map +1 -0
  136. package/dist/cli-signals.js +28 -0
  137. package/dist/cli-signals.js.map +1 -0
  138. package/dist/cli.d.ts +4 -3
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1087 -900
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.d.ts.map +1 -1
  143. package/dist/cloud-publish.js +10 -9
  144. package/dist/cloud-publish.js.map +1 -1
  145. package/dist/codeowners.d.ts +19 -0
  146. package/dist/codeowners.d.ts.map +1 -0
  147. package/dist/codeowners.js +138 -0
  148. package/dist/codeowners.js.map +1 -0
  149. package/dist/codex-sdk-environment.d.ts +1 -0
  150. package/dist/codex-sdk-environment.d.ts.map +1 -1
  151. package/dist/codex-sdk-environment.js +40 -2
  152. package/dist/codex-sdk-environment.js.map +1 -1
  153. package/dist/component-plan.d.ts +2 -5
  154. package/dist/component-plan.d.ts.map +1 -1
  155. package/dist/component-plan.js +38 -30
  156. package/dist/component-plan.js.map +1 -1
  157. package/dist/component-scan.d.ts +6 -5
  158. package/dist/component-scan.d.ts.map +1 -1
  159. package/dist/component-scan.js +23 -35
  160. package/dist/component-scan.js.map +1 -1
  161. package/dist/config.d.ts.map +1 -1
  162. package/dist/config.js +64 -74
  163. package/dist/config.js.map +1 -1
  164. package/dist/contract.d.ts +15 -3
  165. package/dist/contract.d.ts.map +1 -1
  166. package/dist/contract.js +87 -252
  167. package/dist/contract.js.map +1 -1
  168. package/dist/cost-model.d.ts +13 -6
  169. package/dist/cost-model.d.ts.map +1 -1
  170. package/dist/cost-model.js +14 -4
  171. package/dist/cost-model.js.map +1 -1
  172. package/dist/cost.d.ts +10 -2
  173. package/dist/cost.d.ts.map +1 -1
  174. package/dist/cost.js +102 -104
  175. package/dist/cost.js.map +1 -1
  176. package/dist/custom-validation-prompt.d.ts.map +1 -1
  177. package/dist/custom-validation-prompt.js +6 -5
  178. package/dist/custom-validation-prompt.js.map +1 -1
  179. package/dist/custom-validation.d.ts +1 -2
  180. package/dist/custom-validation.d.ts.map +1 -1
  181. package/dist/custom-validation.js +9 -3
  182. package/dist/custom-validation.js.map +1 -1
  183. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  184. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  185. package/dist/deduplication/checkpointed-review.js +23 -9
  186. package/dist/deduplication/checkpointed-review.js.map +1 -1
  187. package/dist/deduplication/codex-review.d.ts +7 -1
  188. package/dist/deduplication/codex-review.d.ts.map +1 -1
  189. package/dist/deduplication/codex-review.js +126 -17
  190. package/dist/deduplication/codex-review.js.map +1 -1
  191. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  192. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  193. package/dist/deduplication/deduplication-prompts.js +18 -4
  194. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  195. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  196. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication-reviewer.js +57 -47
  198. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  199. package/dist/deduplication/deduplication.d.ts.map +1 -1
  200. package/dist/deduplication/deduplication.js +19 -51
  201. package/dist/deduplication/deduplication.js.map +1 -1
  202. package/dist/deduplication/diagnostics.d.ts +17 -0
  203. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  204. package/dist/deduplication/diagnostics.js +5 -0
  205. package/dist/deduplication/diagnostics.js.map +1 -0
  206. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  207. package/dist/deduplication/finding-schema.js +7 -1
  208. package/dist/deduplication/finding-schema.js.map +1 -1
  209. package/dist/deduplication/local.d.ts +31 -0
  210. package/dist/deduplication/local.d.ts.map +1 -0
  211. package/dist/deduplication/local.js +166 -0
  212. package/dist/deduplication/local.js.map +1 -0
  213. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  214. package/dist/deduplication/records-protocol.js +11 -24
  215. package/dist/deduplication/records-protocol.js.map +1 -1
  216. package/dist/deduplication/records.d.ts +186 -11
  217. package/dist/deduplication/records.d.ts.map +1 -1
  218. package/dist/deduplication/records.js +10 -18
  219. package/dist/deduplication/records.js.map +1 -1
  220. package/dist/deduplication/scan.d.ts +9 -3
  221. package/dist/deduplication/scan.d.ts.map +1 -1
  222. package/dist/deduplication/scan.js +158 -39
  223. package/dist/deduplication/scan.js.map +1 -1
  224. package/dist/deep-config.d.ts +2 -1
  225. package/dist/deep-config.d.ts.map +1 -1
  226. package/dist/deep-config.js +4 -4
  227. package/dist/deep-config.js.map +1 -1
  228. package/dist/deep-progress.d.ts +2 -0
  229. package/dist/deep-progress.d.ts.map +1 -1
  230. package/dist/deep-progress.js +13 -10
  231. package/dist/deep-progress.js.map +1 -1
  232. package/dist/deep-scan.d.ts +20 -0
  233. package/dist/deep-scan.d.ts.map +1 -0
  234. package/dist/deep-scan.js +113 -0
  235. package/dist/deep-scan.js.map +1 -0
  236. package/dist/errors.d.ts +2 -0
  237. package/dist/errors.d.ts.map +1 -1
  238. package/dist/errors.js +2 -0
  239. package/dist/errors.js.map +1 -1
  240. package/dist/feedback.d.ts.map +1 -1
  241. package/dist/feedback.js +53 -21
  242. package/dist/feedback.js.map +1 -1
  243. package/dist/finding-catalogue.d.ts.map +1 -1
  244. package/dist/finding-catalogue.js +4 -8
  245. package/dist/finding-catalogue.js.map +1 -1
  246. package/dist/finding-normalization.d.ts +5 -0
  247. package/dist/finding-normalization.d.ts.map +1 -0
  248. package/dist/finding-normalization.js +120 -0
  249. package/dist/finding-normalization.js.map +1 -0
  250. package/dist/finding-retrieval.d.ts +9 -0
  251. package/dist/finding-retrieval.d.ts.map +1 -1
  252. package/dist/finding-retrieval.js.map +1 -1
  253. package/dist/finding-workflow.d.ts +13 -8
  254. package/dist/finding-workflow.d.ts.map +1 -1
  255. package/dist/finding-workflow.js +14 -6
  256. package/dist/finding-workflow.js.map +1 -1
  257. package/dist/findings-client.d.ts +2 -1
  258. package/dist/findings-client.d.ts.map +1 -1
  259. package/dist/findings-client.js +36 -9
  260. package/dist/findings-client.js.map +1 -1
  261. package/dist/findings-errors.d.ts +16 -0
  262. package/dist/findings-errors.d.ts.map +1 -0
  263. package/dist/findings-errors.js +24 -0
  264. package/dist/findings-errors.js.map +1 -0
  265. package/dist/findings-import.d.ts +1 -1
  266. package/dist/findings-import.d.ts.map +1 -1
  267. package/dist/findings-import.js +12 -30
  268. package/dist/findings-import.js.map +1 -1
  269. package/dist/github.d.ts.map +1 -1
  270. package/dist/github.js +7 -1
  271. package/dist/github.js.map +1 -1
  272. package/dist/import-scan.d.ts.map +1 -1
  273. package/dist/import-scan.js +48 -38
  274. package/dist/import-scan.js.map +1 -1
  275. package/dist/index.d.ts +8 -4
  276. package/dist/index.d.ts.map +1 -1
  277. package/dist/index.js +1 -1
  278. package/dist/index.js.map +1 -1
  279. package/dist/knowledge-base.d.ts +7 -1
  280. package/dist/knowledge-base.d.ts.map +1 -1
  281. package/dist/knowledge-base.js +114 -46
  282. package/dist/knowledge-base.js.map +1 -1
  283. package/dist/linear.d.ts.map +1 -1
  284. package/dist/linear.js +2 -7
  285. package/dist/linear.js.map +1 -1
  286. package/dist/mock-scan.d.ts.map +1 -1
  287. package/dist/mock-scan.js +0 -1
  288. package/dist/mock-scan.js.map +1 -1
  289. package/dist/models.d.ts +0 -2
  290. package/dist/models.d.ts.map +1 -1
  291. package/dist/models.js.map +1 -1
  292. package/dist/multiscan.d.ts +9 -3
  293. package/dist/multiscan.d.ts.map +1 -1
  294. package/dist/multiscan.js +193 -126
  295. package/dist/multiscan.js.map +1 -1
  296. package/dist/owner-evidence.d.ts +10 -2
  297. package/dist/owner-evidence.d.ts.map +1 -1
  298. package/dist/owner-evidence.js +67 -8
  299. package/dist/owner-evidence.js.map +1 -1
  300. package/dist/patch-tui.d.ts.map +1 -1
  301. package/dist/patch-tui.js +3 -2
  302. package/dist/patch-tui.js.map +1 -1
  303. package/dist/project-config.js +3 -3
  304. package/dist/project-config.js.map +1 -1
  305. package/dist/provider-profile.d.ts +21 -0
  306. package/dist/provider-profile.d.ts.map +1 -0
  307. package/dist/provider-profile.js +133 -0
  308. package/dist/provider-profile.js.map +1 -0
  309. package/dist/publication-events.d.ts +6 -8
  310. package/dist/publication-events.d.ts.map +1 -1
  311. package/dist/publication-events.js +25 -50
  312. package/dist/publication-events.js.map +1 -1
  313. package/dist/publication-store.d.ts.map +1 -1
  314. package/dist/publication-store.js +40 -64
  315. package/dist/publication-store.js.map +1 -1
  316. package/dist/publication.d.ts +1 -2
  317. package/dist/publication.d.ts.map +1 -1
  318. package/dist/publication.js +2 -8
  319. package/dist/publication.js.map +1 -1
  320. package/dist/publish.d.ts +1 -5
  321. package/dist/publish.d.ts.map +1 -1
  322. package/dist/publish.js +109 -160
  323. package/dist/publish.js.map +1 -1
  324. package/dist/request-metadata.d.ts +9 -0
  325. package/dist/request-metadata.d.ts.map +1 -0
  326. package/dist/request-metadata.js +13 -0
  327. package/dist/request-metadata.js.map +1 -0
  328. package/dist/runtime.d.ts +15 -4
  329. package/dist/runtime.d.ts.map +1 -1
  330. package/dist/runtime.js +430 -138
  331. package/dist/runtime.js.map +1 -1
  332. package/dist/saved-scan-bootstrap.d.ts +14 -0
  333. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  334. package/dist/saved-scan-bootstrap.js +261 -0
  335. package/dist/saved-scan-bootstrap.js.map +1 -0
  336. package/dist/saved-scan.d.ts +1 -1
  337. package/dist/saved-scan.d.ts.map +1 -1
  338. package/dist/saved-scan.js +6 -12
  339. package/dist/saved-scan.js.map +1 -1
  340. package/dist/scan-activity.js +11 -8
  341. package/dist/scan-activity.js.map +1 -1
  342. package/dist/scan-comparison.d.ts +28 -15
  343. package/dist/scan-comparison.d.ts.map +1 -1
  344. package/dist/scan-comparison.js +276 -281
  345. package/dist/scan-comparison.js.map +1 -1
  346. package/dist/scan-dashboard.d.ts +3 -0
  347. package/dist/scan-dashboard.d.ts.map +1 -1
  348. package/dist/scan-dashboard.js +345 -77
  349. package/dist/scan-dashboard.js.map +1 -1
  350. package/dist/scan-history-renderer.d.ts.map +1 -1
  351. package/dist/scan-history-renderer.js +54 -13
  352. package/dist/scan-history-renderer.js.map +1 -1
  353. package/dist/scan-inputs.d.ts +6 -0
  354. package/dist/scan-inputs.d.ts.map +1 -0
  355. package/dist/scan-inputs.js +71 -0
  356. package/dist/scan-inputs.js.map +1 -0
  357. package/dist/scan-logs.d.ts +2 -3
  358. package/dist/scan-logs.d.ts.map +1 -1
  359. package/dist/scan-logs.js +12 -6
  360. package/dist/scan-logs.js.map +1 -1
  361. package/dist/scan-sessions.d.ts +4 -0
  362. package/dist/scan-sessions.d.ts.map +1 -1
  363. package/dist/scan-sessions.js +17 -0
  364. package/dist/scan-sessions.js.map +1 -1
  365. package/dist/scan-skill-paths.d.ts +8 -0
  366. package/dist/scan-skill-paths.d.ts.map +1 -0
  367. package/dist/scan-skill-paths.js +47 -0
  368. package/dist/scan-skill-paths.js.map +1 -0
  369. package/dist/security-policy-cli.d.ts.map +1 -1
  370. package/dist/security-policy-cli.js +7 -27
  371. package/dist/security-policy-cli.js.map +1 -1
  372. package/dist/security-policy.d.ts +9 -5
  373. package/dist/security-policy.d.ts.map +1 -1
  374. package/dist/security-policy.js +33 -14
  375. package/dist/security-policy.js.map +1 -1
  376. package/dist/server/api.d.ts +0 -1
  377. package/dist/server/api.d.ts.map +1 -1
  378. package/dist/server/api.js +0 -1
  379. package/dist/server/api.js.map +1 -1
  380. package/dist/server/embeddings.d.ts +3 -1
  381. package/dist/server/embeddings.d.ts.map +1 -1
  382. package/dist/server/embeddings.js +10 -3
  383. package/dist/server/embeddings.js.map +1 -1
  384. package/dist/server/errors.d.ts +5 -2
  385. package/dist/server/errors.d.ts.map +1 -1
  386. package/dist/server/errors.js +7 -0
  387. package/dist/server/errors.js.map +1 -1
  388. package/dist/server/sqlite-store.d.ts +0 -2
  389. package/dist/server/sqlite-store.d.ts.map +1 -1
  390. package/dist/server/sqlite-store.js +54 -44
  391. package/dist/server/sqlite-store.js.map +1 -1
  392. package/dist/server/storage.d.ts +0 -2
  393. package/dist/server/storage.d.ts.map +1 -1
  394. package/dist/server/storage.js.map +1 -1
  395. package/dist/severity-store.js +19 -24
  396. package/dist/severity-store.js.map +1 -1
  397. package/dist/standalone-validation-prompt.d.ts +2 -0
  398. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  399. package/dist/standalone-validation-prompt.js +10 -0
  400. package/dist/standalone-validation-prompt.js.map +1 -0
  401. package/dist/suggest-owners.d.ts +4 -2
  402. package/dist/suggest-owners.d.ts.map +1 -1
  403. package/dist/suggest-owners.js +11 -5
  404. package/dist/suggest-owners.js.map +1 -1
  405. package/dist/targets.d.ts +11 -0
  406. package/dist/targets.d.ts.map +1 -1
  407. package/dist/targets.js +106 -47
  408. package/dist/targets.js.map +1 -1
  409. package/dist/trusted-executable.d.ts +2 -2
  410. package/dist/trusted-executable.d.ts.map +1 -1
  411. package/dist/trusted-executable.js +8 -6
  412. package/dist/trusted-executable.js.map +1 -1
  413. package/dist/value.js +7 -0
  414. package/dist/value.js.map +1 -1
  415. package/dist/version.js.map +1 -1
  416. package/dist/workbench-arguments.d.ts +3 -0
  417. package/dist/workbench-arguments.d.ts.map +1 -0
  418. package/dist/workbench-arguments.js +15 -0
  419. package/dist/workbench-arguments.js.map +1 -0
  420. package/dist/worker-progress.d.ts +1 -0
  421. package/dist/worker-progress.d.ts.map +1 -1
  422. package/dist/worker-progress.js +27 -12
  423. package/dist/worker-progress.js.map +1 -1
  424. package/docs/cli.md +1778 -0
  425. package/docs/findings-service.md +402 -0
  426. package/package.json +18 -19
  427. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  428. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  429. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  430. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  431. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  432. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  433. package/dist/server/dashboard/app.css +0 -2
  434. package/dist/server/dashboard/app.js +0 -66
  435. package/dist/server/dashboard/index.html +0 -18
  436. package/dist/server/dashboard-types.d.ts +0 -48
  437. package/dist/server/dashboard-types.d.ts.map +0 -1
  438. package/dist/server/dashboard-types.js +0 -2
  439. package/dist/server/dashboard-types.js.map +0 -1
  440. package/dist/server/dashboard.d.ts +0 -6
  441. package/dist/server/dashboard.d.ts.map +0 -1
  442. package/dist/server/dashboard.js +0 -59
  443. package/dist/server/dashboard.js.map +0 -1
  444. package/dist/server/index.d.ts +0 -2
  445. package/dist/server/index.d.ts.map +0 -1
  446. package/dist/server/index.js +0 -6
  447. package/dist/server/index.js.map +0 -1
  448. package/dist/server/routes.d.ts +0 -7
  449. package/dist/server/routes.d.ts.map +0 -1
  450. package/dist/server/routes.js +0 -98
  451. package/dist/server/routes.js.map +0 -1
  452. package/dist/server/serve.d.ts +0 -2
  453. package/dist/server/serve.d.ts.map +0 -1
  454. package/dist/server/serve.js +0 -28
  455. package/dist/server/serve.js.map +0 -1
  456. package/dist/server/server.d.ts +0 -10
  457. package/dist/server/server.d.ts.map +0 -1
  458. package/dist/server/server.js +0 -16
  459. package/dist/server/server.js.map +0 -1
  460. package/dist/server/validation.d.ts +0 -17
  461. package/dist/server/validation.d.ts.map +0 -1
  462. package/dist/server/validation.js +0 -53
  463. package/dist/server/validation.js.map +0 -1
@@ -1,13 +1,18 @@
1
+ import { workbenchArgs } from "./workbench-arguments.js";
1
2
  import { existsSync } from "node:fs";
2
- import { homedir } from "node:os";
3
- import { join } from "node:path";
3
+ import { isRecord } from "./record.js";
4
+ import { notify } from "./value.js";
5
+ import { dirname, join } from "node:path";
4
6
  import { Codex, } from "@openai/codex-sdk";
5
- import { z } from "incur";
7
+ import { z } from "zod";
8
+ import { parse, stringify } from "smol-toml";
6
9
  import { accountStatus, configuredCodexHome, environmentEntry, readCodexHomeConfig, withoutOpenAiApiKeys, } from "./auth.js";
7
- import { deepMerge, hasCommandAuth, mergedCodexConfig, modelProviderConfigOverride, resolveCodexProfile, resolveCommandAuthConfig, scanCyberAccessConfig, scanModelConfiguration, scanModelProvider, } from "./config.js";
10
+ import { DEFAULT_CODEX_CONFIG, deepMerge, hasCommandAuth, inlineToml, mergedCodexConfig, normalizeLegacyWindowsSandboxOverride, resolveCodexProfile, resolveCommandAuthConfig, scanCyberAccessConfig, scanModelConfiguration, scanModelProvider, structuredCodexConfig, } from "./config.js";
8
11
  import { CodexSecurityError, ConfigurationError } from "./errors.js";
12
+ import { codexSecurityRequestMetadata } from "./request-metadata.js";
13
+ import { createProfileCodex, createProviderProfile, preflightReadOnlyProfileCodex, providerPreflightCommand, } from "./provider-profile.js";
9
14
  import { compactFinding, findingCatalogue, groupFindings, findingGroupRoots, } from "./finding-catalogue.js";
10
- import { codexSecurityCredentialHome, executablePathForSpawn, expandHome, prepareCodexSecurityCredentialHome, resolveCodexCommand, runCodexCommand, } from "./runtime.js";
15
+ import { codexSecurityCredentialHome, executablePathForSpawn, prepareCodexSecurityCredentialHome, resolveCodexCommand, runCodexCommand, } from "./runtime.js";
11
16
  import { CODEX_SECURITY_THREAD_SOURCES, } from "./thread-source.js";
12
17
  /** @internal */
13
18
  export { environmentEntry } from "./auth.js";
@@ -28,44 +33,34 @@ const reason = z
28
33
  .string()
29
34
  .min(1)
30
35
  .refine((value) => value.trim().length > 0);
31
- const findingPairSchema = z
32
- .object({
36
+ const findingPairSchema = z.strictObject({
33
37
  beforeOccurrenceId: z.string(),
34
38
  afterOccurrenceId: z.string(),
35
39
  reason,
36
- })
37
- .strict();
38
- const comparisonSchema = z
39
- .object({
40
- matches: z.array(z
41
- .object({
40
+ });
41
+ const comparisonSchema = z.strictObject({
42
+ matches: z.array(z.strictObject({
42
43
  beforeOccurrenceIds: z.array(z.string()).min(1),
43
44
  afterOccurrenceIds: z.array(z.string()).min(1),
44
45
  confidence: z.literal("high"),
45
46
  reason,
46
- })
47
- .strict()),
47
+ })),
48
48
  uncertain: z.array(findingPairSchema),
49
49
  related: z.array(findingPairSchema).optional(),
50
- })
51
- .strict();
52
- const evidenceRequestSchema = z
53
- .object({
50
+ });
51
+ const evidenceRequestSchema = z.strictObject({
54
52
  kind: z.literal("evidence"),
55
53
  beforeOccurrenceIds: z.array(z.string()),
56
54
  afterOccurrenceIds: z.array(z.string()),
57
55
  offset: z.number().int().nonnegative(),
58
- })
59
- .strict();
56
+ });
60
57
  const matchingTurnSchema = comparisonSchema.extend({
61
58
  request: z
62
59
  .union([
63
- z
64
- .object({
60
+ z.strictObject({
65
61
  kind: z.literal("catalogue"),
66
62
  page: z.number().int().nonnegative(),
67
- })
68
- .strict(),
63
+ }),
69
64
  evidenceRequestSchema,
70
65
  ])
71
66
  .nullable()
@@ -115,8 +110,9 @@ export async function matchScanFindingsInternal(input, options = {}, runtimeOpti
115
110
  }
116
111
  }
117
112
  }
118
- const thread = await startReadOnlyCodexThread(options, {
113
+ const { thread, cleanup } = await startReadOnlyCodexThread(options, {
119
114
  ...runtimeOptions,
115
+ command: "compare",
120
116
  threadSource: CODEX_SECURITY_THREAD_SOURCES.scanComparison,
121
117
  });
122
118
  const remainingPages = new Set(pages.keys());
@@ -127,18 +123,13 @@ export async function matchScanFindingsInternal(input, options = {}, runtimeOpti
127
123
  after: new Map(),
128
124
  };
129
125
  const progress = (phase, page) => {
130
- try {
131
- void Promise.resolve(options.onProgress?.({
132
- phase,
133
- beforeFindings: input.before.length,
134
- beforeIssues: catalogue.size,
135
- afterFindings: input.after.length,
136
- ...(page === undefined ? {} : { page, pages: pages.length }),
137
- })).catch(() => { });
138
- }
139
- catch {
140
- // Progress observers must not interrupt matching.
141
- }
126
+ notify(() => options.onProgress?.({
127
+ phase,
128
+ beforeFindings: input.before.length,
129
+ beforeIssues: catalogue.size,
130
+ afterFindings: input.after.length,
131
+ ...(page === undefined ? {} : { page, pages: pages.length }),
132
+ }));
142
133
  };
143
134
  const turnOptions = {
144
135
  // Native structured output requires every field; saved results can omit related.
@@ -150,134 +141,139 @@ export async function matchScanFindingsInternal(input, options = {}, runtimeOpti
150
141
  };
151
142
  let prompt = comparisonPrompt(pages[0], 0, pages.length);
152
143
  progress("catalogue", 1);
153
- for (;;) {
154
- options.signal?.throwIfAborted();
155
- const turn = await thread.run(prompt, turnOptions);
156
- let response;
157
- try {
158
- response = JSON.parse(turn.finalResponse);
159
- }
160
- catch (error) {
161
- throw new CodexSecurityError("Scan comparison returned invalid JSON.", {
162
- cause: error,
163
- });
164
- }
165
- const parsed = matchingTurnSchema.safeParse(response);
166
- if (!parsed.success) {
167
- throw new CodexSecurityError("Scan comparison returned an invalid match result.");
168
- }
169
- const { request: modelRequest, ...result } = parsed.data;
170
- let request = modelRequest;
171
- if (request == null) {
172
- const unseenPage = remainingPages.values().next().value;
173
- if (unseenPage !== undefined) {
174
- request = { kind: "catalogue", page: unseenPage };
144
+ try {
145
+ for (;;) {
146
+ options.signal?.throwIfAborted();
147
+ const turn = await thread.run(prompt, turnOptions);
148
+ let response;
149
+ try {
150
+ response = JSON.parse(turn.finalResponse);
175
151
  }
176
- else {
177
- validateComparison(initialCatalogue, result, options.allowHistoricalUncertainty ?? false);
178
- // Omitted descriptions need evidence even for a no-match decision.
179
- request = requiredEvidenceRequest(result.matches, omittedEvidence, requestedEvidence);
152
+ catch (error) {
153
+ throw new CodexSecurityError("Scan comparison returned invalid JSON.", {
154
+ cause: error,
155
+ });
180
156
  }
181
- }
182
- else if (result.matches.length > 0 ||
183
- result.uncertain.length > 0 ||
184
- (result.related?.length ?? 0) > 0) {
185
- throw new CodexSecurityError("Scan comparison cannot request evidence and finish at the same time.");
186
- }
187
- if (request != null) {
188
- if (runtimeOptions.singleTurn) {
189
- throw new CodexSecurityError(AUTOMATIC_MATCHING_LIMIT_MESSAGE);
157
+ const parsed = matchingTurnSchema.safeParse(response);
158
+ if (!parsed.success) {
159
+ throw new CodexSecurityError("Scan comparison returned an invalid match result.");
190
160
  }
191
- if (request.kind === "catalogue") {
192
- const page = pages[request.page];
193
- if (page === undefined) {
194
- throw new CodexSecurityError("Scan comparison requested an unknown catalogue page.");
161
+ const { request: modelRequest, ...result } = parsed.data;
162
+ let request = modelRequest;
163
+ if (request == null) {
164
+ const unseenPage = remainingPages.values().next().value;
165
+ if (unseenPage !== undefined) {
166
+ request = { kind: "catalogue", page: unseenPage };
195
167
  }
196
- if (!remainingPages.delete(request.page)) {
197
- throw new CodexSecurityError("Scan comparison repeated a request without making progress.");
168
+ else {
169
+ validateComparison(initialCatalogue, result, options.allowHistoricalUncertainty ?? false);
170
+ // Omitted descriptions need evidence even for a no-match decision.
171
+ request = requiredEvidenceRequest(result.matches, omittedEvidence, requestedEvidence);
198
172
  }
199
- prompt = comparisonPrompt(page, request.page, pages.length);
200
- progress("catalogue", request.page + 1);
201
173
  }
202
- else {
203
- request.beforeOccurrenceIds = [
204
- ...new Set(request.beforeOccurrenceIds),
205
- ].sort();
206
- request.afterOccurrenceIds = [
207
- ...new Set(request.afterOccurrenceIds),
208
- ].sort();
209
- if ((request.beforeOccurrenceIds.length === 0 &&
210
- request.afterOccurrenceIds.length === 0) ||
211
- request.beforeOccurrenceIds.some((id) => !catalogue.has(id)) ||
212
- request.afterOccurrenceIds.some((id) => !after.has(id))) {
213
- throw new CodexSecurityError("Scan comparison requested evidence outside its findings.");
174
+ else if (result.matches.length > 0 ||
175
+ result.uncertain.length > 0 ||
176
+ (result.related?.length ?? 0) > 0) {
177
+ throw new CodexSecurityError("Scan comparison cannot request evidence and finish at the same time.");
178
+ }
179
+ if (request != null) {
180
+ if (runtimeOptions.singleTurn) {
181
+ throw new CodexSecurityError(AUTOMATIC_MATCHING_LIMIT_MESSAGE);
214
182
  }
215
- const requestKey = JSON.stringify([
216
- request.beforeOccurrenceIds,
217
- request.afterOccurrenceIds,
218
- ]);
219
- const previous = evidenceCursors.get(requestKey);
220
- const expectedOffset = previous === undefined ? 0 : previous.nextOffset;
221
- if (request.offset !== expectedOffset) {
222
- throw new CodexSecurityError("Scan comparison requested an invalid evidence offset; start at 0 and follow nextOffset.");
183
+ if (request.kind === "catalogue") {
184
+ const page = pages[request.page];
185
+ if (page === undefined) {
186
+ throw new CodexSecurityError("Scan comparison requested an unknown catalogue page.");
187
+ }
188
+ if (!remainingPages.delete(request.page)) {
189
+ throw new CodexSecurityError("Scan comparison repeated a request without making progress.");
190
+ }
191
+ prompt = comparisonPrompt(page, request.page, pages.length);
192
+ progress("catalogue", request.page + 1);
223
193
  }
224
- let cursor = previous;
225
- if (cursor === undefined) {
226
- const beforeOccurrenceIds = request.beforeOccurrenceIds.filter((id) => !requestedEvidence.before.has(id));
227
- const afterOccurrenceIds = request.afterOccurrenceIds.filter((id) => !requestedEvidence.after.has(id));
228
- if (beforeOccurrenceIds.length === 0 &&
229
- afterOccurrenceIds.length === 0) {
230
- throw new CodexSecurityError("Scan comparison repeated evidence without making progress. Continue an unfinished selection with its returned IDs and nextOffset.");
194
+ else {
195
+ request.beforeOccurrenceIds = [
196
+ ...new Set(request.beforeOccurrenceIds),
197
+ ].sort();
198
+ request.afterOccurrenceIds = [
199
+ ...new Set(request.afterOccurrenceIds),
200
+ ].sort();
201
+ if ((request.beforeOccurrenceIds.length === 0 &&
202
+ request.afterOccurrenceIds.length === 0) ||
203
+ request.beforeOccurrenceIds.some((id) => !catalogue.has(id)) ||
204
+ request.afterOccurrenceIds.some((id) => !after.has(id))) {
205
+ throw new CodexSecurityError("Scan comparison requested evidence outside its findings.");
206
+ }
207
+ const requestKey = JSON.stringify([
208
+ request.beforeOccurrenceIds,
209
+ request.afterOccurrenceIds,
210
+ ]);
211
+ const previous = evidenceCursors.get(requestKey);
212
+ const expectedOffset = previous === undefined ? 0 : previous.nextOffset;
213
+ if (request.offset !== expectedOffset) {
214
+ throw new CodexSecurityError("Scan comparison requested an invalid evidence offset; start at 0 and follow nextOffset.");
215
+ }
216
+ let cursor = previous;
217
+ if (cursor === undefined) {
218
+ const beforeOccurrenceIds = request.beforeOccurrenceIds.filter((id) => !requestedEvidence.before.has(id));
219
+ const afterOccurrenceIds = request.afterOccurrenceIds.filter((id) => !requestedEvidence.after.has(id));
220
+ if (beforeOccurrenceIds.length === 0 &&
221
+ afterOccurrenceIds.length === 0) {
222
+ throw new CodexSecurityError("Scan comparison repeated evidence without making progress. Continue an unfinished selection with its returned IDs and nextOffset.");
223
+ }
224
+ cursor = {
225
+ beforeOccurrenceIds,
226
+ afterOccurrenceIds,
227
+ text: JSON.stringify({
228
+ before: beforeOccurrenceIds.flatMap((id) => catalogue.get(id).occurrences),
229
+ after: afterOccurrenceIds.map((id) => after.get(id)),
230
+ }),
231
+ utf16Offset: 0,
232
+ nextOffset: 0,
233
+ };
231
234
  }
232
- cursor = {
233
- beforeOccurrenceIds,
234
- afterOccurrenceIds,
235
- text: JSON.stringify({
236
- before: beforeOccurrenceIds.flatMap((id) => catalogue.get(id).occurrences),
237
- after: afterOccurrenceIds.map((id) => after.get(id)),
238
- }),
239
- utf16Offset: 0,
240
- nextOffset: 0,
241
- };
235
+ const page = evidencePage(cursor, request.offset);
236
+ cursor.nextOffset = page.nextOffset;
237
+ cursor.utf16Offset = page.nextUtf16Offset;
238
+ // Keep completed cursors to reject repeats, but release their evidence.
239
+ if (page.nextOffset === null)
240
+ cursor.text = "";
241
+ // Either the original selection or the returned fresh IDs can resume it.
242
+ evidenceCursors.set(requestKey, cursor);
243
+ evidenceCursors.set(JSON.stringify([
244
+ cursor.beforeOccurrenceIds,
245
+ cursor.afterOccurrenceIds,
246
+ ]), cursor);
247
+ for (const id of cursor.beforeOccurrenceIds)
248
+ requestedEvidence.before.set(id, cursor);
249
+ for (const id of cursor.afterOccurrenceIds)
250
+ requestedEvidence.after.set(id, cursor);
251
+ prompt = page.prompt;
252
+ progress("evidence");
242
253
  }
243
- const page = evidencePage(cursor, request.offset);
244
- cursor.nextOffset = page.nextOffset;
245
- cursor.utf16Offset = page.nextUtf16Offset;
246
- // Keep completed cursors to reject repeats, but release their evidence.
247
- if (page.nextOffset === null)
248
- cursor.text = "";
249
- // Either the original selection or the returned fresh IDs can resume it.
250
- evidenceCursors.set(requestKey, cursor);
251
- evidenceCursors.set(JSON.stringify([
252
- cursor.beforeOccurrenceIds,
253
- cursor.afterOccurrenceIds,
254
- ]), cursor);
255
- for (const id of cursor.beforeOccurrenceIds)
256
- requestedEvidence.before.set(id, cursor);
257
- for (const id of cursor.afterOccurrenceIds)
258
- requestedEvidence.after.set(id, cursor);
259
- prompt = page.prompt;
260
- progress("evidence");
254
+ continue;
261
255
  }
262
- continue;
256
+ const expandBefore = (id) => catalogue.get(id).occurrences.map(({ occurrenceId }) => occurrenceId);
257
+ const expandPairs = (pairs) => pairs.flatMap((pair) => expandBefore(pair.beforeOccurrenceId).map((beforeOccurrenceId) => ({
258
+ ...pair,
259
+ beforeOccurrenceId,
260
+ })));
261
+ const expanded = reconcileComparison(input, {
262
+ matches: result.matches.map((match) => ({
263
+ ...match,
264
+ beforeOccurrenceIds: match.beforeOccurrenceIds.flatMap(expandBefore),
265
+ })),
266
+ uncertain: expandPairs(result.uncertain),
267
+ ...(result.related === undefined
268
+ ? {}
269
+ : { related: expandPairs(result.related) }),
270
+ }, options.allowHistoricalUncertainty ?? false);
271
+ progress("complete");
272
+ return expanded.comparison;
263
273
  }
264
- const expandBefore = (id) => catalogue.get(id).occurrences.map(({ occurrenceId }) => occurrenceId);
265
- const expandPairs = (pairs) => pairs.flatMap((pair) => expandBefore(pair.beforeOccurrenceId).map((beforeOccurrenceId) => ({
266
- ...pair,
267
- beforeOccurrenceId,
268
- })));
269
- const expanded = reconcileComparison(input, {
270
- matches: result.matches.map((match) => ({
271
- ...match,
272
- beforeOccurrenceIds: match.beforeOccurrenceIds.flatMap(expandBefore),
273
- })),
274
- uncertain: expandPairs(result.uncertain),
275
- ...(result.related === undefined
276
- ? {}
277
- : { related: expandPairs(result.related) }),
278
- }, options.allowHistoricalUncertainty ?? false);
279
- progress("complete");
280
- return expanded.comparison;
274
+ }
275
+ finally {
276
+ await cleanup?.();
281
277
  }
282
278
  }
283
279
  async function startReadOnlyCodexThread(options, runtimeOptions) {
@@ -287,10 +283,31 @@ async function startReadOnlyCodexThread(options, runtimeOptions) {
287
283
  const configuredModel = config === undefined ? undefined : scanModelConfiguration(config);
288
284
  const model = options.model ?? configuredModel?.model;
289
285
  const reasoningEffort = options.reasoningEffort ?? configuredModel?.reasoningEffort ?? "medium";
286
+ const threadOptions = {
287
+ threadSource: runtimeOptions.threadSource,
288
+ ...(model === undefined ? {} : { model }),
289
+ // Native Codex accepts strings before the pinned SDK widens its effort type.
290
+ modelReasoningEffort: reasoningEffort,
291
+ sandboxMode: "read-only",
292
+ approvalPolicy: "never",
293
+ networkAccessEnabled: false,
294
+ webSearchMode: "disabled",
295
+ workingDirectory: options.workingDirectory ?? process.cwd(),
296
+ skipGitRepoCheck: true,
297
+ };
298
+ if (options.codex !== undefined) {
299
+ return { thread: options.codex.startThread(threadOptions) };
300
+ }
290
301
  const source = options.environment ?? process.env;
291
- const providerConfig = options.codex === undefined
292
- ? resolveCommandAuthConfig(deepMerge(await readCodexHomeConfig(source, options.signal), config ?? {}), configuredCodexHome(source))
293
- : {};
302
+ const homeConfig = await readCodexHomeConfig(source, options.signal);
303
+ const homeExecutionConfig = resolveCodexProfile(homeConfig);
304
+ normalizeLegacyWindowsSandboxOverride(homeExecutionConfig);
305
+ const providerConfig = resolveCommandAuthConfig(deepMerge(homeConfig, parse(stringify(config ?? {}))), configuredCodexHome(source));
306
+ const suppliedConfig = resolveCodexProfile(options.config?.codexOverrides ?? {});
307
+ normalizeLegacyWindowsSandboxOverride(suppliedConfig);
308
+ const windows = suppliedConfig["windows"] === undefined
309
+ ? (homeExecutionConfig["windows"] ?? DEFAULT_CODEX_CONFIG["windows"])
310
+ : resolveCodexProfile(config ?? {})["windows"];
294
311
  const commandAuth = hasCommandAuth(providerConfig);
295
312
  if (commandAuth &&
296
313
  options.auth !== undefined &&
@@ -300,74 +317,101 @@ async function startReadOnlyCodexThread(options, runtimeOptions) {
300
317
  throw new ConfigurationError(`Explicit ${options.auth} authentication conflicts with command authentication in the supplied Codex home. ` +
301
318
  "Remove the conflicting provider configuration or select command authentication through codexOverrides.");
302
319
  }
303
- const sdkConfig = { ...config };
304
- if (commandAuth)
305
- delete sdkConfig["model_providers"];
320
+ const sdkConfig = structuredCodexConfig(config);
321
+ const requestMetadata = {
322
+ ...homeExecutionConfig["responses_api_metadata"],
323
+ ...sdkConfig["responses_api_metadata"],
324
+ ...codexSecurityRequestMetadata(runtimeOptions.surface, runtimeOptions.command),
325
+ };
326
+ delete sdkConfig["responses_api_metadata"];
327
+ delete sdkConfig["default_permissions"];
328
+ const providerSettings = commandAuth ? providerConfig : (config ?? {});
306
329
  const effectiveFeatures = resolveCodexProfile(scanCyberAccessConfig(providerConfig, options.cyberAccessProgram))["features"];
307
- const environment = options.codex === undefined
308
- ? await comparisonEnvironment(options.environment, accountStatus, options.signal, undefined, providerConfig)
330
+ const environment = await comparisonEnvironment(options.environment, accountStatus, options.signal, undefined, providerConfig);
331
+ const command = resolveCodexCommand(environment);
332
+ const codexOptions = {
333
+ // A single table preserves literal keys that the SDK would split on dots.
334
+ configOverrides: [`responses_api_metadata=${inlineToml(requestMetadata)}`],
335
+ codexPathOverride: executablePathForSpawn(command.command),
336
+ env: environment,
337
+ // The SDK forwards its apiKey option as CODEX_API_KEY for Codex exec.
338
+ apiKey: environmentEntry(environment, "OPENAI_API_KEY")?.trim() ||
339
+ environmentEntry(environment, "CODEX_API_KEY")?.trim() ||
340
+ undefined,
341
+ config: {
342
+ ...sdkConfig,
343
+ windows,
344
+ mcp_servers: await disabledMcpServers(await providerPreflightCommand(command, providerSettings), config, environment, options),
345
+ allow_login_shell: false,
346
+ project_doc_max_bytes: 0,
347
+ features: {
348
+ api_key_cyber_access_programs: effectiveFeatures?.["api_key_cyber_access_programs"],
349
+ api_key_model_discovery: effectiveFeatures?.["api_key_model_discovery"],
350
+ apps: false,
351
+ code_mode: false,
352
+ code_mode_only: false,
353
+ js_repl: false,
354
+ multi_agent: false,
355
+ multi_agent_v2: false,
356
+ plugins: false,
357
+ shell_tool: false,
358
+ unified_exec: false,
359
+ },
360
+ shell_environment_policy: {
361
+ inherit: "core",
362
+ ignore_default_excludes: false,
363
+ exclude: ["CODEX_HOME", "*KEY*", "*SECRET*", "*TOKEN*"],
364
+ },
365
+ },
366
+ };
367
+ const providers = resolveCodexProfile(providerSettings)["model_providers"];
368
+ const ownProfile = options.nativeProfile === undefined &&
369
+ isRecord(providers) &&
370
+ Object.keys(providers).length > 0
371
+ ? await createProviderProfile(configuredCodexHome(environment), providerSettings)
309
372
  : undefined;
310
- const command = environment === undefined ? undefined : resolveCodexCommand(environment);
311
- const codex = options.codex ??
312
- new Codex({
313
- codexPathOverride: executablePathForSpawn(command.command),
314
- env: environment,
315
- // The SDK forwards its apiKey option as CODEX_API_KEY for Codex exec.
316
- apiKey: environmentEntry(environment, "OPENAI_API_KEY")?.trim() ||
317
- environmentEntry(environment, "CODEX_API_KEY")?.trim() ||
318
- undefined,
319
- ...(commandAuth
320
- ? { configOverrides: modelProviderConfigOverride(providerConfig) }
321
- : {}),
322
- config: {
323
- ...sdkConfig,
324
- mcp_servers: await disabledMcpServers(command, config, environment, options),
325
- allow_login_shell: false,
326
- project_doc_max_bytes: 0,
327
- responses_api_metadata: {
328
- codex_security_surface: runtimeOptions.surface,
329
- },
330
- features: {
331
- api_key_cyber_access_programs: effectiveFeatures?.["api_key_cyber_access_programs"],
332
- api_key_model_discovery: effectiveFeatures?.["api_key_model_discovery"],
333
- apps: false,
334
- code_mode: false,
335
- code_mode_only: false,
336
- js_repl: false,
337
- multi_agent: false,
338
- multi_agent_v2: false,
339
- plugins: false,
340
- shell_tool: false,
341
- unified_exec: false,
342
- },
343
- shell_environment_policy: {
344
- inherit: "core",
345
- ignore_default_excludes: false,
346
- exclude: ["CODEX_HOME", "*KEY*", "*SECRET*", "*TOKEN*"],
373
+ const profile = options.nativeProfile ?? ownProfile;
374
+ try {
375
+ let requestedPermissionProfile;
376
+ if (profile !== undefined) {
377
+ delete threadOptions.sandboxMode;
378
+ const permissions = await preflightReadOnlyProfileCodex(codexOptions, {
379
+ extends: ":read-only",
380
+ filesystem: {
381
+ ":root": "read",
382
+ [dirname(profile.path)]: { ".": "deny" },
347
383
  },
348
- },
349
- });
350
- return codex.startThread({
351
- threadSource: runtimeOptions.threadSource,
352
- ...(model === undefined ? {} : { model }),
353
- // Native Codex accepts strings before the pinned SDK widens its effort type.
354
- modelReasoningEffort: reasoningEffort,
355
- sandboxMode: "read-only",
356
- approvalPolicy: "never",
357
- networkAccessEnabled: false,
358
- webSearchMode: "disabled",
359
- workingDirectory: options.workingDirectory ?? process.cwd(),
360
- skipGitRepoCheck: true,
361
- });
384
+ network: { enabled: false },
385
+ }, providerSettings, threadOptions.workingDirectory, options.signal);
386
+ codexOptions.configOverrides = permissions.configOverrides;
387
+ requestedPermissionProfile = permissions.permissionProfileId;
388
+ }
389
+ const codex = profile === undefined
390
+ ? new Codex(codexOptions)
391
+ : await createProfileCodex(codexOptions, profile.name, requestedPermissionProfile);
392
+ return {
393
+ thread: codex.startThread(threadOptions),
394
+ ...(ownProfile === undefined ? {} : { cleanup: ownProfile.cleanup }),
395
+ };
396
+ }
397
+ catch (error) {
398
+ await ownProfile?.cleanup();
399
+ throw error;
400
+ }
362
401
  }
363
402
  export async function runReadOnlyCodex(prompt, outputSchema, options, runtimeOptions) {
364
- const thread = await startReadOnlyCodexThread(options, runtimeOptions);
365
- const turn = await thread.run(prompt, {
366
- outputSchema,
367
- cyberAccessProgram: options.cyberAccessProgram,
368
- signal: options.signal,
369
- });
370
- return turn.finalResponse;
403
+ const { thread, cleanup } = await startReadOnlyCodexThread(options, runtimeOptions);
404
+ try {
405
+ const turn = await thread.run(prompt, {
406
+ outputSchema,
407
+ cyberAccessProgram: options.cyberAccessProgram,
408
+ signal: options.signal,
409
+ });
410
+ return turn.finalResponse;
411
+ }
412
+ finally {
413
+ await cleanup?.();
414
+ }
371
415
  }
372
416
  export async function disabledMcpServers(command, config, environment, options) {
373
417
  const { success, stdout, stderr } = await runCodexCommand(command, [
@@ -423,9 +467,11 @@ export async function matchCompletedScan(options) {
423
467
  };
424
468
  const comparison = await (options.matchFindings ?? matchScanFindings)(input, {
425
469
  allowHistoricalUncertainty: true,
470
+ config: options.config,
426
471
  cyberAccessProgram: options.cyberAccessProgram,
427
472
  environment: options.environment,
428
473
  model: options.model,
474
+ nativeProfile: options.nativeProfile,
429
475
  signal: options.signal,
430
476
  workingDirectory: options.repository,
431
477
  });
@@ -435,14 +481,11 @@ export async function matchCompletedScan(options) {
435
481
  }));
436
482
  for (const { scanId, projected } of comparisons) {
437
483
  options.signal?.throwIfAborted();
438
- await options.workbench([
439
- "save-scan-comparison",
440
- "--before-scan-id",
441
- scanId,
442
- "--after-scan-id",
443
- options.scanId,
444
- "--matches-json-stdin",
445
- ], JSON.stringify(projected));
484
+ await options.workbench(workbenchArgs("save-scan-comparison", {
485
+ beforeScanId: scanId,
486
+ afterScanId: options.scanId,
487
+ matchesJsonStdin: true,
488
+ }), JSON.stringify(projected));
446
489
  }
447
490
  }
448
491
  function reconcileComparison(input, response, allowHistoricalUncertainty) {
@@ -497,7 +540,7 @@ function reconcileComparison(input, response, allowHistoricalUncertainty) {
497
540
  related: response.related.filter(isSeparateGroup),
498
541
  }),
499
542
  };
500
- validateComparison(input, comparison, allowHistoricalUncertainty, true);
543
+ validateComparison(input, comparison, allowHistoricalUncertainty);
501
544
  return { comparison, complete: matches.length === groups.length };
502
545
  }
503
546
  export function comparisonForScan(comparison, before) {
@@ -552,10 +595,7 @@ function comparisonPrompt(input, page, pages) {
552
595
  ].join("\n");
553
596
  }
554
597
  function characterCount(value) {
555
- let count = 0;
556
- for (const _character of value)
557
- count += 1;
558
- return count;
598
+ return value[Symbol.iterator]().reduce((count) => count + 1, 0);
559
599
  }
560
600
  function cataloguePages(input) {
561
601
  if (characterCount(comparisonPrompt(input, 0, 1)) <= MAX_CODEX_INPUT_CHARACTERS) {
@@ -721,15 +761,11 @@ export async function comparisonEnvironment(source = process.env, nativeAccountS
721
761
  }
722
762
  }
723
763
  storedEnvironment["CODEX_HOME"] = canonicalCredentialHome;
724
- const status = await nativeAccountStatus(resolveCodexCommand(source), storedEnvironment, signal);
764
+ const status = await nativeAccountStatus(await providerPreflightCommand(resolveCodexCommand(source), config ?? {}), storedEnvironment, signal);
725
765
  if (status.authenticated)
726
766
  return storedEnvironment;
727
767
  }
728
- const configuredHome = environmentEntry(environment, "CODEX_HOME")?.trim();
729
- const codexHome = configuredHome
730
- ? expandHome(configuredHome, environment)
731
- : join(homedir(), ".codex");
732
- if (existsSync(join(codexHome, "auth.json"))) {
768
+ if (existsSync(join(home, "auth.json"))) {
733
769
  return withoutOpenAiApiKeys(environment);
734
770
  }
735
771
  return environment;
@@ -747,10 +783,9 @@ function validateComparisonInput(input) {
747
783
  }
748
784
  }
749
785
  }
750
- function validateComparison(input, response, allowHistoricalUncertainty, enforceConfirmedIdentities = false) {
786
+ function validateComparison(input, response, allowHistoricalUncertainty) {
751
787
  const beforeIds = new Set(input.before.map(({ occurrenceId }) => occurrenceId));
752
788
  const afterIds = new Set(input.after.map(({ occurrenceId }) => occurrenceId));
753
- const findingIds = new Map([...input.before, ...input.after].flatMap(findingIdEntry));
754
789
  const matchedBefore = new Map();
755
790
  const matchedAfter = new Map();
756
791
  const uncertainPairs = new Set();
@@ -770,38 +805,10 @@ function validateComparison(input, response, allowHistoricalUncertainty, enforce
770
805
  }
771
806
  }
772
807
  }
773
- const confirmedGroups = unionFindingGroups([
774
- ...(input.knownFindingGroups ?? []),
775
- ...[...new Set(findingIds.values())].map((findingId) => [findingId]),
776
- ]);
777
- if (enforceConfirmedIdentities) {
778
- const occurrencesByFinding = Map.groupBy(findingIds.keys(), (occurrenceId) => findingIds.get(occurrenceId));
779
- for (const knownGroup of confirmedGroups) {
780
- const knownOccurrences = knownGroup.flatMap((findingId) => occurrencesByFinding.get(findingId) ?? []);
781
- const matchedGroups = new Set(knownOccurrences.flatMap((occurrenceId) => {
782
- const group = matchedBefore.get(occurrenceId) ?? matchedAfter.get(occurrenceId);
783
- return group === undefined ? [] : [group];
784
- }));
785
- if (matchedGroups.size > 1 ||
786
- (matchedGroups.size === 1 &&
787
- knownOccurrences.some((occurrenceId) => !matchedBefore.has(occurrenceId) &&
788
- !matchedAfter.has(occurrenceId))) ||
789
- (knownOccurrences.some((occurrenceId) => beforeIds.has(occurrenceId)) &&
790
- knownOccurrences.some((occurrenceId) => afterIds.has(occurrenceId)) &&
791
- matchedGroups.size === 0)) {
792
- throw new CodexSecurityError("Scan comparison contradicts previously confirmed finding groups.");
793
- }
794
- }
795
- }
796
808
  for (const candidate of response.uncertain) {
797
- const beforeFindingId = findingIds.get(candidate.beforeOccurrenceId);
798
- const afterFindingId = findingIds.get(candidate.afterOccurrenceId);
799
809
  if (!beforeIds.has(candidate.beforeOccurrenceId) ||
800
810
  matchedBefore.has(candidate.beforeOccurrenceId) ||
801
811
  !afterIds.has(candidate.afterOccurrenceId) ||
802
- (enforceConfirmedIdentities &&
803
- beforeFindingId !== undefined &&
804
- beforeFindingId === afterFindingId) ||
805
812
  (!allowHistoricalUncertainty &&
806
813
  matchedAfter.has(candidate.afterOccurrenceId))) {
807
814
  throw new CodexSecurityError("Scan comparison returned an invalid uncertain pair.");
@@ -815,18 +822,9 @@ function validateComparison(input, response, allowHistoricalUncertainty, enforce
815
822
  }
816
823
  uncertainPairs.add(pair);
817
824
  }
818
- const knownGroupByFindingId = new Map(confirmedGroups.flatMap((group, index) => group.map((findingId) => [findingId, index])));
819
825
  const relatedPairs = new Set();
820
826
  for (const candidate of response.related ?? []) {
821
827
  const beforeGroup = matchedBefore.get(candidate.beforeOccurrenceId);
822
- const beforeFindingId = findingIds.get(candidate.beforeOccurrenceId);
823
- const afterFindingId = findingIds.get(candidate.afterOccurrenceId);
824
- const knownBeforeGroup = beforeFindingId === undefined
825
- ? undefined
826
- : knownGroupByFindingId.get(beforeFindingId);
827
- const knownAfterGroup = afterFindingId === undefined
828
- ? undefined
829
- : knownGroupByFindingId.get(afterFindingId);
830
828
  const pair = JSON.stringify([
831
829
  candidate.beforeOccurrenceId,
832
830
  candidate.afterOccurrenceId,
@@ -835,9 +833,6 @@ function validateComparison(input, response, allowHistoricalUncertainty, enforce
835
833
  !afterIds.has(candidate.afterOccurrenceId) ||
836
834
  (beforeGroup !== undefined &&
837
835
  beforeGroup === matchedAfter.get(candidate.afterOccurrenceId)) ||
838
- (enforceConfirmedIdentities &&
839
- knownBeforeGroup !== undefined &&
840
- knownBeforeGroup === knownAfterGroup) ||
841
836
  uncertainPairs.has(pair) ||
842
837
  relatedPairs.has(pair)) {
843
838
  throw new CodexSecurityError("Scan comparison returned an invalid related pair.");