@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
@@ -0,0 +1,239 @@
1
+ import { spawn } from "node:child_process";
2
+ import { mkdtemp, rm, writeFile } from "node:fs/promises";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { createInterface } from "node:readline";
6
+
7
+ // Native startup needs provider identity and auth selection, while exec reads
8
+ // the full provider configuration from its private profile file.
9
+ export function preflightProviderDefinitions(providers) {
10
+ return Object.fromEntries(
11
+ Object.entries(providers)
12
+ .filter(([, provider]) => provider != null)
13
+ .map(([id, provider]) => [
14
+ id,
15
+ Object.fromEntries(
16
+ ["name", "wire_api", "requires_openai_auth"]
17
+ .filter((key) => Object.hasOwn(provider, key))
18
+ .map((key) => [key, provider[key]]),
19
+ ),
20
+ ]),
21
+ );
22
+ }
23
+
24
+ export function isPermissionProfileFallbackWarning(message, profileId) {
25
+ if (typeof message !== "string") return false;
26
+ const prefix =
27
+ "Configured value for `permission_profile` is disallowed by requirements; " +
28
+ `falling back from \`${profileId}\` to required value \``;
29
+ const warning = message.trim();
30
+ return warning.startsWith(prefix) && warning.endsWith("`.");
31
+ }
32
+
33
+ export function profileConfigOverrides(config) {
34
+ return Object.entries(config)
35
+ .filter(([, value]) => value != null)
36
+ .map(([key, value]) => `${key}=${toml(value)}`);
37
+ }
38
+
39
+ // Native profile files keep provider configuration off process arguments while
40
+ // retaining the existing CODEX_HOME credential store.
41
+ export function createCodexProfileClient(options) {
42
+ return {
43
+ startThread: (threadOptions = {}) =>
44
+ new ProfileThread(options, threadOptions),
45
+ resumeThread: (id, threadOptions = {}) =>
46
+ new ProfileThread(options, threadOptions, id),
47
+ };
48
+ }
49
+
50
+ class ProfileThread {
51
+ constructor(options, threadOptions, id = null) {
52
+ this.options = options;
53
+ this.threadOptions = threadOptions;
54
+ this.id = id;
55
+ }
56
+
57
+ async runStreamed(input, turnOptions = {}) {
58
+ return { events: this.events(input, turnOptions) };
59
+ }
60
+
61
+ async run(input, turnOptions = {}) {
62
+ const items = [];
63
+ let finalResponse = "";
64
+ let usage = null;
65
+ for await (const event of this.events(input, turnOptions)) {
66
+ if (event.type === "item.completed") {
67
+ items.push(event.item);
68
+ if (event.item.type === "agent_message")
69
+ finalResponse = event.item.text;
70
+ } else if (event.type === "turn.completed") {
71
+ usage = event.usage;
72
+ } else if (event.type === "turn.failed") {
73
+ throw new Error(event.error.message);
74
+ }
75
+ }
76
+ return { items, finalResponse, usage };
77
+ }
78
+
79
+ async *events(input, turnOptions) {
80
+ let schemaDirectory;
81
+ try {
82
+ let schemaPath;
83
+ if (turnOptions.outputSchema !== undefined) {
84
+ const schema = turnOptions.outputSchema;
85
+ if (
86
+ schema === null ||
87
+ typeof schema !== "object" ||
88
+ Array.isArray(schema)
89
+ ) {
90
+ throw new Error("outputSchema must be a plain JSON object");
91
+ }
92
+ schemaDirectory = await mkdtemp(join(tmpdir(), "codex-output-schema-"));
93
+ schemaPath = join(schemaDirectory, "schema.json");
94
+ await writeFile(schemaPath, JSON.stringify(schema), "utf8");
95
+ }
96
+ const args = nativeArguments(
97
+ this.options,
98
+ this.threadOptions,
99
+ this.id,
100
+ turnOptions,
101
+ schemaPath,
102
+ );
103
+ for await (const line of execute(
104
+ this.options,
105
+ args,
106
+ input,
107
+ turnOptions.signal,
108
+ )) {
109
+ let event;
110
+ try {
111
+ event = JSON.parse(line);
112
+ } catch (cause) {
113
+ throw new Error(`Failed to parse item: ${line}`, { cause });
114
+ }
115
+ const item = event.type === "item.completed" ? event.item : event;
116
+ if (
117
+ this.options.requestedPermissionProfile !== undefined &&
118
+ item.type === "error" &&
119
+ isPermissionProfileFallbackWarning(
120
+ item.message,
121
+ this.options.requestedPermissionProfile,
122
+ )
123
+ ) {
124
+ throw new Error(
125
+ "Read-only Codex helper stopped because organization policy changed its permission profile. Its results were discarded.\n" +
126
+ item.message,
127
+ );
128
+ }
129
+ if (event.type === "thread.started") this.id = event.thread_id;
130
+ if (event.type === "turn.completed" && event.usage != null)
131
+ event.usage.cache_write_input_tokens ??= 0;
132
+ yield event;
133
+ }
134
+ } finally {
135
+ if (schemaDirectory) {
136
+ await rm(schemaDirectory, { recursive: true, force: true }).catch(
137
+ () => {},
138
+ );
139
+ }
140
+ }
141
+ }
142
+ }
143
+
144
+ function nativeArguments(options, thread, id, turn, schemaPath) {
145
+ const args = [
146
+ "exec",
147
+ "--experimental-json",
148
+ "--profile",
149
+ options.profileName,
150
+ ];
151
+ const config = (key, value) => args.push("--config", `${key}=${toml(value)}`);
152
+ for (const override of profileConfigOverrides(options.config ?? {}))
153
+ args.push("--config", override);
154
+ for (const override of options.configOverrides ?? [])
155
+ args.push("--config", override);
156
+ if (options.baseUrl) config("openai_base_url", options.baseUrl);
157
+ if (thread.model) args.push("--model", thread.model);
158
+ if (thread.threadSource !== undefined && !id)
159
+ args.push("--thread-source", thread.threadSource);
160
+ if (thread.sandboxMode) args.push("--sandbox", thread.sandboxMode);
161
+ if (thread.workingDirectory) args.push("--cd", thread.workingDirectory);
162
+ for (const directory of thread.additionalDirectories ?? [])
163
+ args.push("--add-dir", directory);
164
+ if (thread.skipGitRepoCheck) args.push("--skip-git-repo-check");
165
+ if (schemaPath) args.push("--output-schema", schemaPath);
166
+ if (turn.cyberAccessProgram !== undefined)
167
+ args.push("--cyber-access-program", turn.cyberAccessProgram);
168
+ if (thread.modelReasoningEffort)
169
+ config("model_reasoning_effort", thread.modelReasoningEffort);
170
+ if (thread.networkAccessEnabled !== undefined)
171
+ config(
172
+ "sandbox_workspace_write.network_access",
173
+ thread.networkAccessEnabled,
174
+ );
175
+ if (thread.webSearchMode) config("web_search", thread.webSearchMode);
176
+ else if (thread.webSearchEnabled !== undefined)
177
+ config("web_search", thread.webSearchEnabled ? "live" : "disabled");
178
+ if (thread.approvalPolicy) config("approval_policy", thread.approvalPolicy);
179
+ if (id) args.push("resume", id);
180
+ return args;
181
+ }
182
+
183
+ function toml(value) {
184
+ if (typeof value === "string" || typeof value === "boolean")
185
+ return JSON.stringify(value).replace(/\u007f/g, "\\u007f");
186
+ if (typeof value === "number" && Number.isFinite(value)) return String(value);
187
+ if (Array.isArray(value)) return `[${value.map(toml).join(", ")}]`;
188
+ if (value !== null && typeof value === "object") {
189
+ return `{${Object.entries(value)
190
+ .filter(([, child]) => child != null)
191
+ .map(
192
+ ([key, child]) =>
193
+ `${/^[A-Za-z0-9_-]+$/.test(key) ? key : toml(key)} = ${toml(child)}`,
194
+ )
195
+ .join(", ")}}`;
196
+ }
197
+ throw new Error("Codex config overrides must contain finite TOML values");
198
+ }
199
+
200
+ async function* execute(options, args, input, signal) {
201
+ const env = { ...(options.env ?? process.env) };
202
+ env.CODEX_INTERNAL_ORIGINATOR_OVERRIDE ||= "codex_sdk_ts";
203
+ if (options.apiKey) env.CODEX_API_KEY = options.apiKey;
204
+ const child = spawn(options.codexPathOverride, args, {
205
+ env,
206
+ signal,
207
+ windowsHide: true,
208
+ });
209
+ let processError;
210
+ let inputError;
211
+ child.on("error", (error) => {
212
+ processError = error;
213
+ });
214
+ child.stdin.on("error", (error) => {
215
+ inputError = error;
216
+ });
217
+ const closed = new Promise((resolve) => {
218
+ child.once("close", (code, exitSignal) => resolve({ code, exitSignal }));
219
+ });
220
+ const stderr = [];
221
+ child.stderr.on("data", (chunk) => stderr.push(chunk));
222
+ const lines = createInterface({ input: child.stdout, crlfDelay: Infinity });
223
+ child.stdin.end(input);
224
+ try {
225
+ for await (const line of lines) yield line;
226
+ const { code, exitSignal } = await closed;
227
+ if (processError) throw processError;
228
+ if (code !== 0 || exitSignal) {
229
+ const detail = exitSignal ? `signal ${exitSignal}` : `code ${code ?? 1}`;
230
+ throw new Error(
231
+ `Codex Exec exited with ${detail}: ${Buffer.concat(stderr).toString("utf8")}`,
232
+ );
233
+ }
234
+ if (inputError) throw inputError;
235
+ } finally {
236
+ lines.close();
237
+ if (child.exitCode === null && child.signalCode === null) child.kill();
238
+ }
239
+ }
@@ -0,0 +1,53 @@
1
+ /** Reduce a single stream; callers retain error, retry and acceptance policy. */
2
+ export async function readCodexSessionTurn(options) {
3
+ let threadId = options.thread.id;
4
+ let status = "in_progress";
5
+ let finalResponse = "";
6
+ let usage = null;
7
+ let lastStreamError = null;
8
+ for await (const event of eventsWithOptionalUsage(options.events)) {
9
+ await options.onEvent(event);
10
+ if (
11
+ event.type === "thread.started" &&
12
+ typeof event["thread_id"] === "string"
13
+ ) {
14
+ threadId = event["thread_id"];
15
+ } else if (
16
+ event.type === "item.completed" &&
17
+ isRecord(event["item"]) &&
18
+ event["item"]["type"] === "agent_message" &&
19
+ typeof event["item"]["text"] === "string"
20
+ ) {
21
+ finalResponse = event["item"]["text"];
22
+ } else if (event.type === "turn.completed") {
23
+ status = "completed";
24
+ usage = event["usage"] ?? null;
25
+ if (options.stopOnCompletion) break;
26
+ } else if (event.type === "error" && typeof event["message"] === "string") {
27
+ lastStreamError = event["message"];
28
+ }
29
+ }
30
+ return { threadId, status, finalResponse, usage, lastStreamError };
31
+ }
32
+
33
+ async function* eventsWithOptionalUsage(events) {
34
+ try {
35
+ yield* events;
36
+ } catch (error) {
37
+ // The pinned SDK accesses this field before yielding a completion with
38
+ // absent usage. Preserve completion without inventing a zero-token receipt.
39
+ if (
40
+ error instanceof TypeError &&
41
+ /\b(?:null|undefined)\b/u.test(error.message) &&
42
+ /\bcache_write_input_tokens\b/u.test(error.message)
43
+ ) {
44
+ yield { type: "turn.completed", usage: null };
45
+ return;
46
+ }
47
+ throw error;
48
+ }
49
+ }
50
+
51
+ function isRecord(value) {
52
+ return typeof value === "object" && value !== null;
53
+ }
@@ -12,18 +12,16 @@ from collections.abc import Iterator
12
12
  from pathlib import Path
13
13
  from typing import Any
14
14
 
15
- try:
16
- import tomllib
17
- except ModuleNotFoundError: # pragma: no cover - Python 3.10 only
18
- import tomli as tomllib
19
-
20
15
  # Some plugin hosts launch Python with safe-path isolation enabled.
21
16
  sys.path.insert(0, str(Path(__file__).resolve().parent))
17
+ from workbench.runtime_toml import tomllib
22
18
  from workbench_constants import positive_int
23
19
 
24
20
  PLUGIN_ROOT = Path(__file__).resolve().parents[1]
25
21
  DEFAULT_REGISTRY = PLUGIN_ROOT / "preflight" / "capability-profiles.toml"
26
- DEFAULT_CODEX_HOME = Path(os.environ.get("CODEX_HOME", "~/.codex")).expanduser()
22
+ DEFAULT_CODEX_HOME = Path(
23
+ os.environ["CODEX_HOME"] if os.environ.get("CODEX_HOME", "").strip() else "~/.codex"
24
+ ).expanduser()
27
25
 
28
26
 
29
27
  def default_system_config() -> Path:
@@ -270,12 +268,10 @@ def project_trust_level(
270
268
 
271
269
  def project_config_paths(project_root: Path, cwd: Path) -> list[Path]:
272
270
  relative = cwd.relative_to(project_root)
273
- directories = [project_root]
274
- current = project_root
275
- for part in relative.parts:
276
- current /= part
277
- directories.append(current)
278
- return [directory / ".codex" / "config.toml" for directory in directories]
271
+ return [
272
+ project_root / directory / ".codex" / "config.toml"
273
+ for directory in reversed((relative, *relative.parents))
274
+ ]
279
275
 
280
276
 
281
277
  def discover_config_paths(
@@ -374,28 +370,6 @@ def config_profile_layer_path(profile: str | None) -> Path | None:
374
370
  return path if path.is_file() else None
375
371
 
376
372
 
377
- def parse_multi_agent_v2_enabled(feature_config: Any) -> bool | None:
378
- if isinstance(feature_config, bool):
379
- return feature_config
380
- if not isinstance(feature_config, dict):
381
- raise ValueError("features.multi_agent_v2 must be a boolean or table")
382
- if "enabled" not in feature_config:
383
- return None
384
- enabled = feature_config["enabled"]
385
- if not isinstance(enabled, bool):
386
- raise ValueError("features.multi_agent_v2.enabled must be a boolean")
387
- return enabled
388
-
389
-
390
- def merge_toml_value(base: Any, overlay: Any) -> Any:
391
- if isinstance(base, dict) and isinstance(overlay, dict):
392
- merged = dict(base)
393
- for key, value in overlay.items():
394
- merged[key] = merge_toml_value(merged[key], value) if key in merged else value
395
- return merged
396
- return overlay
397
-
398
-
399
373
  def lookup_multi_agent_v2_enabled(
400
374
  *,
401
375
  config_layers: list[tuple[Path, dict[str, Any]]],
@@ -409,38 +383,28 @@ def lookup_multi_agent_v2_enabled(
409
383
  return True, enabled, "effective-config"
410
384
 
411
385
  v2_configs = []
412
- config_views = list(iter_config_views(config_layers, config_profile))
413
- for source, config in reversed(config_views):
386
+ if "features.multi_agent_v2" in effective_config:
387
+ v2_configs.append(("effective-config", effective_config["features.multi_agent_v2"]))
388
+ for source, config in iter_config_views(config_layers, config_profile):
414
389
  found, feature_config = lookup_dotted(config, "features.multi_agent_v2")
415
390
  if found:
416
391
  v2_configs.append((source, feature_config))
417
392
 
418
- if "features.multi_agent_v2" in effective_config:
419
- v2_configs.append(("effective-config", effective_config["features.multi_agent_v2"]))
420
-
421
- if not v2_configs:
422
- return False, None, None
423
-
424
- merged_v2_config: Any = None
425
- enabled_source: str | None = None
426
- for index, (source, feature_config) in enumerate(v2_configs):
427
- tables_merge = isinstance(merged_v2_config, dict) and isinstance(feature_config, dict)
428
- if index and not tables_merge:
429
- enabled_source = None
430
- merged_v2_config = (
431
- merge_toml_value(merged_v2_config, feature_config) if index else feature_config
432
- )
433
- if isinstance(feature_config, bool) or (
434
- isinstance(feature_config, dict) and "enabled" in feature_config
435
- ):
436
- enabled_source = source
437
-
438
- enabled = parse_multi_agent_v2_enabled(merged_v2_config)
439
- return (
440
- (True, enabled, enabled_source)
441
- if enabled is not None
442
- else (True, False, "documented-default")
443
- )
393
+ table_override = False
394
+ for source, feature_config in v2_configs:
395
+ if table_override and not isinstance(feature_config, (dict, bool)):
396
+ break
397
+ if isinstance(feature_config, bool):
398
+ return True, feature_config, source
399
+ if not isinstance(feature_config, dict):
400
+ raise ValueError("features.multi_agent_v2 must be a boolean or table")
401
+ if "enabled" in feature_config:
402
+ enabled = feature_config["enabled"]
403
+ if not isinstance(enabled, bool):
404
+ raise ValueError("features.multi_agent_v2.enabled must be a boolean")
405
+ return True, enabled, source
406
+ table_override = True
407
+ return (True, False, "documented-default") if table_override else (False, None, None)
444
408
 
445
409
 
446
410
  def resolve_multi_agent_context(
@@ -4,15 +4,13 @@ from __future__ import annotations
4
4
 
5
5
  import argparse
6
6
  import json
7
- import math
8
7
  import os
8
+ import sys
9
9
  from pathlib import Path
10
10
  from typing import Any
11
11
 
12
- try:
13
- import tomllib
14
- except ModuleNotFoundError: # pragma: no cover - Python 3.10 only
15
- import tomli as tomllib
12
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
13
+ from workbench.runtime_toml import tomllib
16
14
 
17
15
  DEFAULTS = json.loads(
18
16
  Path(__file__).with_name("deep_scan_defaults.json").read_text(encoding="utf-8")
@@ -35,7 +33,9 @@ CONFIG_KEYS = {
35
33
 
36
34
 
37
35
  def codex_home() -> Path:
38
- return Path(os.environ.get("CODEX_HOME", "~/.codex")).expanduser()
36
+ return Path(
37
+ os.environ["CODEX_HOME"] if os.environ.get("CODEX_HOME", "").strip() else "~/.codex"
38
+ ).expanduser()
39
39
 
40
40
 
41
41
  def config_path() -> Path:
@@ -106,6 +106,8 @@ def resolve_deep_scan_config(available_parallelism: int) -> dict[str, int | floa
106
106
 
107
107
 
108
108
  def require_integer(value: object, label: str, *, minimum: int) -> int:
109
+ if isinstance(value, float) and value.is_integer():
110
+ value = int(value)
109
111
  if isinstance(value, bool) or not isinstance(value, int) or value < minimum:
110
112
  qualifier = (
111
113
  "a non-negative integer"
@@ -121,11 +123,7 @@ def require_integer(value: object, label: str, *, minimum: int) -> int:
121
123
  def require_positive_number(value: object, label: str) -> int | float:
122
124
  if isinstance(value, bool) or not isinstance(value, (int, float)):
123
125
  raise SystemExit(f"{label} must be a positive finite number no greater than 96.")
124
- try:
125
- finite = math.isfinite(value)
126
- except OverflowError:
127
- finite = False
128
- if not finite or value <= 0 or value > MAX_TIME_HOURS:
126
+ if not 0 < value <= MAX_TIME_HOURS:
129
127
  raise SystemExit(f"{label} must be a positive finite number no greater than 96.")
130
128
  return value
131
129