@openai/codex-security 0.1.31 → 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 (514) hide show
  1. package/README.md +442 -2434
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +3 -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 +7 -214
  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 +5 -5
  25. package/_bundled_plugin/references/config-preflight.md +1 -5
  26. package/_bundled_plugin/references/core-scan.md +34 -10
  27. package/_bundled_plugin/references/final-report.md +13 -13
  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 +3 -4
  31. package/_bundled_plugin/references/scan-contract.md +11 -6
  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 +2 -2
  36. package/_bundled_plugin/schemas/coverage.schema.json +23 -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 +83 -95
  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 +245 -356
  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 +29 -69
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +208 -363
  52. package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +733 -375
  54. package/_bundled_plugin/scripts/finding_preview.py +81 -91
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +48 -102
  56. package/_bundled_plugin/scripts/generate_rank_input.py +117 -888
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -6
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +43 -902
  60. package/_bundled_plugin/scripts/report_projection.py +143 -219
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +161 -0
  63. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  64. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  65. package/_bundled_plugin/scripts/windows_scan_local_files.py +59 -9
  66. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  67. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  68. package/_bundled_plugin/scripts/workbench/storage.py +21 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +99 -190
  70. package/_bundled_plugin/scripts/workbench_constants.py +6 -14
  71. package/_bundled_plugin/scripts/workbench_db.py +524 -672
  72. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  73. package/_bundled_plugin/scripts/workbench_finding_index.py +20 -7
  74. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  75. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  76. package/_bundled_plugin/scripts/workbench_native_indexes.py +28 -18
  77. package/_bundled_plugin/scripts/workbench_progress.py +26 -92
  78. package/_bundled_plugin/scripts/workbench_publication.py +77 -116
  79. package/_bundled_plugin/scripts/workbench_remediation.py +14 -20
  80. package/_bundled_plugin/scripts/workbench_saved_results.py +1402 -263
  81. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  82. package/_bundled_plugin/scripts/workbench_scan_start.py +109 -52
  83. package/_bundled_plugin/scripts/workbench_scan_usage.py +30 -49
  84. package/_bundled_plugin/scripts/workbench_schema.py +71 -1370
  85. package/_bundled_plugin/scripts/workbench_source_excerpt.py +16 -7
  86. package/_bundled_plugin/scripts/workbench_target.py +526 -150
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
  88. package/_bundled_plugin/scripts/workbench_validation.py +19 -44
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  90. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  91. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  92. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  93. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  94. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  95. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +6 -6
  96. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  97. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  98. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  99. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  100. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  104. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  105. package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
  106. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  107. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  108. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  109. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  110. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  111. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  112. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  113. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  114. package/bin/codex-security.mjs +9 -2
  115. package/dist/api.d.ts +63 -15
  116. package/dist/api.d.ts.map +1 -1
  117. package/dist/api.js +970 -553
  118. package/dist/api.js.map +1 -1
  119. package/dist/artifact-export.d.ts +70 -0
  120. package/dist/artifact-export.d.ts.map +1 -0
  121. package/dist/artifact-export.js +292 -0
  122. package/dist/artifact-export.js.map +1 -0
  123. package/dist/auth.d.ts +2 -6
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +27 -12
  126. package/dist/auth.js.map +1 -1
  127. package/dist/bulk-scan-discovery.d.ts +1 -0
  128. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  129. package/dist/bulk-scan-discovery.js +9 -9
  130. package/dist/bulk-scan-discovery.js.map +1 -1
  131. package/dist/classify-scan-severity.d.ts.map +1 -1
  132. package/dist/classify-scan-severity.js +2 -5
  133. package/dist/classify-scan-severity.js.map +1 -1
  134. package/dist/classify-severity.d.ts +28 -17
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +16 -35
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli-help.d.ts +3 -0
  139. package/dist/cli-help.d.ts.map +1 -0
  140. package/dist/cli-help.js +285 -0
  141. package/dist/cli-help.js.map +1 -0
  142. package/dist/cli-signals.d.ts +8 -0
  143. package/dist/cli-signals.d.ts.map +1 -0
  144. package/dist/cli-signals.js +28 -0
  145. package/dist/cli-signals.js.map +1 -0
  146. package/dist/cli.d.ts +22 -24
  147. package/dist/cli.d.ts.map +1 -1
  148. package/dist/cli.js +1660 -1556
  149. package/dist/cli.js.map +1 -1
  150. package/dist/cloud-publish.d.ts.map +1 -1
  151. package/dist/cloud-publish.js +11 -17
  152. package/dist/cloud-publish.js.map +1 -1
  153. package/dist/codeowners.d.ts +19 -0
  154. package/dist/codeowners.d.ts.map +1 -0
  155. package/dist/codeowners.js +138 -0
  156. package/dist/codeowners.js.map +1 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +1 -2
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/codex-sdk-environment.d.ts +3 -0
  161. package/dist/codex-sdk-environment.d.ts.map +1 -0
  162. package/dist/codex-sdk-environment.js +68 -0
  163. package/dist/codex-sdk-environment.js.map +1 -0
  164. package/dist/component-plan.d.ts +2 -5
  165. package/dist/component-plan.d.ts.map +1 -1
  166. package/dist/component-plan.js +38 -34
  167. package/dist/component-plan.js.map +1 -1
  168. package/dist/component-scan.d.ts +7 -5
  169. package/dist/component-scan.d.ts.map +1 -1
  170. package/dist/component-scan.js +54 -44
  171. package/dist/component-scan.js.map +1 -1
  172. package/dist/config.d.ts.map +1 -1
  173. package/dist/config.js +93 -104
  174. package/dist/config.js.map +1 -1
  175. package/dist/contract.d.ts +15 -2
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +124 -348
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost-model.d.ts +13 -6
  180. package/dist/cost-model.d.ts.map +1 -1
  181. package/dist/cost-model.js +75 -34
  182. package/dist/cost-model.js.map +1 -1
  183. package/dist/cost.d.ts +10 -2
  184. package/dist/cost.d.ts.map +1 -1
  185. package/dist/cost.js +116 -134
  186. package/dist/cost.js.map +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +7 -6
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/custom-validation.d.ts +1 -2
  191. package/dist/custom-validation.d.ts.map +1 -1
  192. package/dist/custom-validation.js +23 -16
  193. package/dist/custom-validation.js.map +1 -1
  194. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  195. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  196. package/dist/deduplication/checkpointed-review.js +33 -20
  197. package/dist/deduplication/checkpointed-review.js.map +1 -1
  198. package/dist/deduplication/codex-review.d.ts +9 -1
  199. package/dist/deduplication/codex-review.d.ts.map +1 -1
  200. package/dist/deduplication/codex-review.js +129 -20
  201. package/dist/deduplication/codex-review.js.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  203. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  204. package/dist/deduplication/deduplication-prompts.js +18 -4
  205. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  207. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  208. package/dist/deduplication/deduplication-reviewer.js +59 -47
  209. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  210. package/dist/deduplication/deduplication.d.ts.map +1 -1
  211. package/dist/deduplication/deduplication.js +59 -113
  212. package/dist/deduplication/deduplication.js.map +1 -1
  213. package/dist/deduplication/diagnostics.d.ts +17 -0
  214. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  215. package/dist/deduplication/diagnostics.js +5 -0
  216. package/dist/deduplication/diagnostics.js.map +1 -0
  217. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  218. package/dist/deduplication/finding-schema.js +7 -1
  219. package/dist/deduplication/finding-schema.js.map +1 -1
  220. package/dist/deduplication/local.d.ts +31 -0
  221. package/dist/deduplication/local.d.ts.map +1 -0
  222. package/dist/deduplication/local.js +166 -0
  223. package/dist/deduplication/local.js.map +1 -0
  224. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  225. package/dist/deduplication/records-protocol.js +12 -28
  226. package/dist/deduplication/records-protocol.js.map +1 -1
  227. package/dist/deduplication/records.d.ts +188 -12
  228. package/dist/deduplication/records.d.ts.map +1 -1
  229. package/dist/deduplication/records.js +34 -24
  230. package/dist/deduplication/records.js.map +1 -1
  231. package/dist/deduplication/review.d.ts +7 -0
  232. package/dist/deduplication/review.d.ts.map +1 -1
  233. package/dist/deduplication/review.js.map +1 -1
  234. package/dist/deduplication/scan.d.ts +9 -3
  235. package/dist/deduplication/scan.d.ts.map +1 -1
  236. package/dist/deduplication/scan.js +159 -44
  237. package/dist/deduplication/scan.js.map +1 -1
  238. package/dist/deep-config.d.ts +2 -1
  239. package/dist/deep-config.d.ts.map +1 -1
  240. package/dist/deep-config.js +7 -23
  241. package/dist/deep-config.js.map +1 -1
  242. package/dist/deep-progress.d.ts +2 -1
  243. package/dist/deep-progress.d.ts.map +1 -1
  244. package/dist/deep-progress.js +32 -47
  245. package/dist/deep-progress.js.map +1 -1
  246. package/dist/deep-scan.d.ts +20 -0
  247. package/dist/deep-scan.d.ts.map +1 -0
  248. package/dist/deep-scan.js +113 -0
  249. package/dist/deep-scan.js.map +1 -0
  250. package/dist/errors.d.ts +5 -2
  251. package/dist/errors.d.ts.map +1 -1
  252. package/dist/errors.js +7 -7
  253. package/dist/errors.js.map +1 -1
  254. package/dist/feedback.d.ts.map +1 -1
  255. package/dist/feedback.js +53 -21
  256. package/dist/feedback.js.map +1 -1
  257. package/dist/finding-catalogue.d.ts.map +1 -1
  258. package/dist/finding-catalogue.js +26 -30
  259. package/dist/finding-catalogue.js.map +1 -1
  260. package/dist/finding-normalization.d.ts +5 -0
  261. package/dist/finding-normalization.d.ts.map +1 -0
  262. package/dist/finding-normalization.js +120 -0
  263. package/dist/finding-normalization.js.map +1 -0
  264. package/dist/finding-retrieval.d.ts +9 -0
  265. package/dist/finding-retrieval.d.ts.map +1 -1
  266. package/dist/finding-retrieval.js.map +1 -1
  267. package/dist/finding-workflow.d.ts +13 -8
  268. package/dist/finding-workflow.d.ts.map +1 -1
  269. package/dist/finding-workflow.js +18 -13
  270. package/dist/finding-workflow.js.map +1 -1
  271. package/dist/findings-client.d.ts +2 -1
  272. package/dist/findings-client.d.ts.map +1 -1
  273. package/dist/findings-client.js +36 -9
  274. package/dist/findings-client.js.map +1 -1
  275. package/dist/findings-errors.d.ts +16 -0
  276. package/dist/findings-errors.d.ts.map +1 -0
  277. package/dist/findings-errors.js +24 -0
  278. package/dist/findings-errors.js.map +1 -0
  279. package/dist/findings-import.d.ts +1 -1
  280. package/dist/findings-import.d.ts.map +1 -1
  281. package/dist/findings-import.js +16 -44
  282. package/dist/findings-import.js.map +1 -1
  283. package/dist/github.d.ts.map +1 -1
  284. package/dist/github.js +9 -4
  285. package/dist/github.js.map +1 -1
  286. package/dist/import-scan.d.ts.map +1 -1
  287. package/dist/import-scan.js +49 -39
  288. package/dist/import-scan.js.map +1 -1
  289. package/dist/index.d.ts +11 -5
  290. package/dist/index.d.ts.map +1 -1
  291. package/dist/index.js +2 -1
  292. package/dist/index.js.map +1 -1
  293. package/dist/knowledge-base.d.ts +7 -1
  294. package/dist/knowledge-base.d.ts.map +1 -1
  295. package/dist/knowledge-base.js +115 -47
  296. package/dist/knowledge-base.js.map +1 -1
  297. package/dist/linear.d.ts.map +1 -1
  298. package/dist/linear.js +4 -10
  299. package/dist/linear.js.map +1 -1
  300. package/dist/mock-scan.d.ts.map +1 -1
  301. package/dist/mock-scan.js +0 -1
  302. package/dist/mock-scan.js.map +1 -1
  303. package/dist/models.d.ts +24 -2
  304. package/dist/models.d.ts.map +1 -1
  305. package/dist/models.js.map +1 -1
  306. package/dist/multiscan.d.ts +9 -3
  307. package/dist/multiscan.d.ts.map +1 -1
  308. package/dist/multiscan.js +225 -153
  309. package/dist/multiscan.js.map +1 -1
  310. package/dist/owner-evidence.d.ts +10 -2
  311. package/dist/owner-evidence.d.ts.map +1 -1
  312. package/dist/owner-evidence.js +69 -14
  313. package/dist/owner-evidence.js.map +1 -1
  314. package/dist/patch-tui.d.ts.map +1 -1
  315. package/dist/patch-tui.js +5 -6
  316. package/dist/patch-tui.js.map +1 -1
  317. package/dist/project-config-schema.d.ts +10 -0
  318. package/dist/project-config-schema.d.ts.map +1 -1
  319. package/dist/project-config-schema.js +1 -0
  320. package/dist/project-config-schema.js.map +1 -1
  321. package/dist/project-config.d.ts +1 -0
  322. package/dist/project-config.d.ts.map +1 -1
  323. package/dist/project-config.js +5 -3
  324. package/dist/project-config.js.map +1 -1
  325. package/dist/prompt-files.d.ts +0 -1
  326. package/dist/prompt-files.d.ts.map +1 -1
  327. package/dist/prompt-files.js +2 -4
  328. package/dist/prompt-files.js.map +1 -1
  329. package/dist/provider-profile.d.ts +21 -0
  330. package/dist/provider-profile.d.ts.map +1 -0
  331. package/dist/provider-profile.js +133 -0
  332. package/dist/provider-profile.js.map +1 -0
  333. package/dist/publication-events.d.ts +6 -8
  334. package/dist/publication-events.d.ts.map +1 -1
  335. package/dist/publication-events.js +40 -79
  336. package/dist/publication-events.js.map +1 -1
  337. package/dist/publication-store.d.ts.map +1 -1
  338. package/dist/publication-store.js +48 -76
  339. package/dist/publication-store.js.map +1 -1
  340. package/dist/publication.d.ts +1 -2
  341. package/dist/publication.d.ts.map +1 -1
  342. package/dist/publication.js +7 -16
  343. package/dist/publication.js.map +1 -1
  344. package/dist/publish.d.ts +1 -5
  345. package/dist/publish.d.ts.map +1 -1
  346. package/dist/publish.js +138 -199
  347. package/dist/publish.js.map +1 -1
  348. package/dist/record.d.ts +2 -0
  349. package/dist/record.d.ts.map +1 -0
  350. package/dist/record.js +4 -0
  351. package/dist/record.js.map +1 -0
  352. package/dist/request-metadata.d.ts +9 -0
  353. package/dist/request-metadata.d.ts.map +1 -0
  354. package/dist/request-metadata.js +13 -0
  355. package/dist/request-metadata.js.map +1 -0
  356. package/dist/result.d.ts +4 -1
  357. package/dist/result.d.ts.map +1 -1
  358. package/dist/result.js +7 -0
  359. package/dist/result.js.map +1 -1
  360. package/dist/runtime.d.ts +25 -17
  361. package/dist/runtime.d.ts.map +1 -1
  362. package/dist/runtime.js +619 -255
  363. package/dist/runtime.js.map +1 -1
  364. package/dist/saved-scan-bootstrap.d.ts +14 -0
  365. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  366. package/dist/saved-scan-bootstrap.js +261 -0
  367. package/dist/saved-scan-bootstrap.js.map +1 -0
  368. package/dist/saved-scan.d.ts +1 -1
  369. package/dist/saved-scan.d.ts.map +1 -1
  370. package/dist/saved-scan.js +16 -32
  371. package/dist/saved-scan.js.map +1 -1
  372. package/dist/scan-activity.d.ts.map +1 -1
  373. package/dist/scan-activity.js +19 -30
  374. package/dist/scan-activity.js.map +1 -1
  375. package/dist/scan-comparison.d.ts +31 -18
  376. package/dist/scan-comparison.d.ts.map +1 -1
  377. package/dist/scan-comparison.js +307 -347
  378. package/dist/scan-comparison.js.map +1 -1
  379. package/dist/scan-dashboard.d.ts +3 -1
  380. package/dist/scan-dashboard.d.ts.map +1 -1
  381. package/dist/scan-dashboard.js +351 -92
  382. package/dist/scan-dashboard.js.map +1 -1
  383. package/dist/scan-history-renderer.d.ts.map +1 -1
  384. package/dist/scan-history-renderer.js +55 -15
  385. package/dist/scan-history-renderer.js.map +1 -1
  386. package/dist/scan-inputs.d.ts +6 -0
  387. package/dist/scan-inputs.d.ts.map +1 -0
  388. package/dist/scan-inputs.js +71 -0
  389. package/dist/scan-inputs.js.map +1 -0
  390. package/dist/scan-logs.d.ts +2 -3
  391. package/dist/scan-logs.d.ts.map +1 -1
  392. package/dist/scan-logs.js +14 -12
  393. package/dist/scan-logs.js.map +1 -1
  394. package/dist/scan-sessions.d.ts +4 -0
  395. package/dist/scan-sessions.d.ts.map +1 -1
  396. package/dist/scan-sessions.js +18 -3
  397. package/dist/scan-sessions.js.map +1 -1
  398. package/dist/scan-settings.d.ts +5 -0
  399. package/dist/scan-settings.d.ts.map +1 -1
  400. package/dist/scan-settings.js +4 -0
  401. package/dist/scan-settings.js.map +1 -1
  402. package/dist/scan-skill-paths.d.ts +8 -0
  403. package/dist/scan-skill-paths.d.ts.map +1 -0
  404. package/dist/scan-skill-paths.js +47 -0
  405. package/dist/scan-skill-paths.js.map +1 -0
  406. package/dist/security-policy-cli.d.ts.map +1 -1
  407. package/dist/security-policy-cli.js +15 -33
  408. package/dist/security-policy-cli.js.map +1 -1
  409. package/dist/security-policy.d.ts +17 -9
  410. package/dist/security-policy.d.ts.map +1 -1
  411. package/dist/security-policy.js +131 -98
  412. package/dist/security-policy.js.map +1 -1
  413. package/dist/server/api.d.ts +0 -1
  414. package/dist/server/api.d.ts.map +1 -1
  415. package/dist/server/api.js +0 -1
  416. package/dist/server/api.js.map +1 -1
  417. package/dist/server/embeddings.d.ts +3 -1
  418. package/dist/server/embeddings.d.ts.map +1 -1
  419. package/dist/server/embeddings.js +11 -3
  420. package/dist/server/embeddings.js.map +1 -1
  421. package/dist/server/errors.d.ts +5 -2
  422. package/dist/server/errors.d.ts.map +1 -1
  423. package/dist/server/errors.js +7 -0
  424. package/dist/server/errors.js.map +1 -1
  425. package/dist/server/sqlite-store.d.ts +0 -2
  426. package/dist/server/sqlite-store.d.ts.map +1 -1
  427. package/dist/server/sqlite-store.js +55 -55
  428. package/dist/server/sqlite-store.js.map +1 -1
  429. package/dist/server/storage.d.ts +0 -2
  430. package/dist/server/storage.d.ts.map +1 -1
  431. package/dist/server/storage.js.map +1 -1
  432. package/dist/severity-store.js +20 -32
  433. package/dist/severity-store.js.map +1 -1
  434. package/dist/standalone-validation-prompt.d.ts +2 -0
  435. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  436. package/dist/standalone-validation-prompt.js +10 -0
  437. package/dist/standalone-validation-prompt.js.map +1 -0
  438. package/dist/suggest-owners.d.ts +6 -5
  439. package/dist/suggest-owners.d.ts.map +1 -1
  440. package/dist/suggest-owners.js +15 -10
  441. package/dist/suggest-owners.js.map +1 -1
  442. package/dist/targets.d.ts +12 -0
  443. package/dist/targets.d.ts.map +1 -1
  444. package/dist/targets.js +124 -62
  445. package/dist/targets.js.map +1 -1
  446. package/dist/trusted-executable.d.ts +6 -1
  447. package/dist/trusted-executable.d.ts.map +1 -1
  448. package/dist/trusted-executable.js +28 -9
  449. package/dist/trusted-executable.js.map +1 -1
  450. package/dist/value.d.ts +2 -0
  451. package/dist/value.d.ts.map +1 -0
  452. package/dist/value.js +27 -0
  453. package/dist/value.js.map +1 -0
  454. package/dist/version.d.ts.map +1 -1
  455. package/dist/version.js +3 -6
  456. package/dist/version.js.map +1 -1
  457. package/dist/windows-path.d.ts.map +1 -1
  458. package/dist/windows-path.js +1 -2
  459. package/dist/windows-path.js.map +1 -1
  460. package/dist/workbench-arguments.d.ts +3 -0
  461. package/dist/workbench-arguments.d.ts.map +1 -0
  462. package/dist/workbench-arguments.js +15 -0
  463. package/dist/workbench-arguments.js.map +1 -0
  464. package/dist/worker-progress.d.ts +2 -0
  465. package/dist/worker-progress.d.ts.map +1 -1
  466. package/dist/worker-progress.js +40 -46
  467. package/dist/worker-progress.js.map +1 -1
  468. package/docs/cli.md +1778 -0
  469. package/docs/dedupe-records.md +24 -0
  470. package/docs/findings-service.md +402 -0
  471. package/package.json +23 -23
  472. package/schemas/project-config.schema.json +5 -0
  473. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  474. package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
  475. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  476. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  477. package/_bundled_plugin/scripts/workbench_severity.py +0 -119
  478. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  479. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  480. package/dist/server/dashboard/app.css +0 -2
  481. package/dist/server/dashboard/app.js +0 -66
  482. package/dist/server/dashboard/index.html +0 -18
  483. package/dist/server/dashboard-types.d.ts +0 -48
  484. package/dist/server/dashboard-types.d.ts.map +0 -1
  485. package/dist/server/dashboard-types.js +0 -2
  486. package/dist/server/dashboard-types.js.map +0 -1
  487. package/dist/server/dashboard.d.ts +0 -6
  488. package/dist/server/dashboard.d.ts.map +0 -1
  489. package/dist/server/dashboard.js +0 -59
  490. package/dist/server/dashboard.js.map +0 -1
  491. package/dist/server/findings-service.d.ts +0 -20
  492. package/dist/server/findings-service.d.ts.map +0 -1
  493. package/dist/server/findings-service.js +0 -31
  494. package/dist/server/findings-service.js.map +0 -1
  495. package/dist/server/index.d.ts +0 -2
  496. package/dist/server/index.d.ts.map +0 -1
  497. package/dist/server/index.js +0 -6
  498. package/dist/server/index.js.map +0 -1
  499. package/dist/server/routes.d.ts +0 -6
  500. package/dist/server/routes.d.ts.map +0 -1
  501. package/dist/server/routes.js +0 -86
  502. package/dist/server/routes.js.map +0 -1
  503. package/dist/server/serve.d.ts +0 -2
  504. package/dist/server/serve.d.ts.map +0 -1
  505. package/dist/server/serve.js +0 -28
  506. package/dist/server/serve.js.map +0 -1
  507. package/dist/server/server.d.ts +0 -10
  508. package/dist/server/server.d.ts.map +0 -1
  509. package/dist/server/server.js +0 -17
  510. package/dist/server/server.js.map +0 -1
  511. package/dist/server/validation.d.ts +0 -17
  512. package/dist/server/validation.d.ts.map +0 -1
  513. package/dist/server/validation.js +0 -53
  514. package/dist/server/validation.js.map +0 -1
@@ -0,0 +1,70 @@
1
+ import type { JsonObject } from "./config.js";
2
+ export type ArtifactOutput = Pick<NodeJS.WriteStream, "write">;
3
+ export declare const ARTIFACT_EXPORT_FILENAMES: {
4
+ readonly csv: "findings.csv";
5
+ readonly json: "findings.json";
6
+ readonly sarif: "results.sarif";
7
+ readonly md: "threatmodel.md";
8
+ };
9
+ export type ExportFormat = keyof typeof ARTIFACT_EXPORT_FILENAMES;
10
+ export type ExportArtifactKind = "findings" | "threat-model";
11
+ export interface ArtifactExportArguments {
12
+ scanDir: string;
13
+ artifact?: ExportArtifactKind;
14
+ format: ExportFormat;
15
+ output: string;
16
+ sourceRoot?: string;
17
+ pythonPath?: string;
18
+ signal?: AbortSignal;
19
+ includeMetadata?: boolean;
20
+ }
21
+ export type ExportArtifactOptions = {
22
+ source: {
23
+ directory: string;
24
+ scanId?: never;
25
+ } | {
26
+ scanId: string;
27
+ directory?: never;
28
+ };
29
+ output: string;
30
+ pythonPath?: string;
31
+ signal?: AbortSignal;
32
+ } & ({
33
+ artifact: "threat-model";
34
+ format?: "md";
35
+ sourceRoot?: never;
36
+ } | {
37
+ artifact?: "findings";
38
+ format?: "csv" | "json" | "sarif";
39
+ sourceRoot?: string;
40
+ });
41
+ export interface ArtifactExportResult {
42
+ path: string | null;
43
+ provenance: JsonObject | null;
44
+ }
45
+ interface HelperOptions {
46
+ pythonPath?: string;
47
+ protectedRoot?: string;
48
+ pluginRoot?: string;
49
+ signal?: AbortSignal;
50
+ output?: ArtifactOutput;
51
+ failureMessage?: string;
52
+ }
53
+ export declare function resolveArtifactFormat(artifact: ExportArtifactKind, format?: ExportFormat): ExportFormat;
54
+ export declare function runArtifactHelper(args: readonly string[], options?: HelperOptions): Promise<{
55
+ stdout: string;
56
+ stderr: string;
57
+ }>;
58
+ export declare function writeThreatModel(directory: string, options?: HelperOptions): Promise<string>;
59
+ /** Read the current document path without making an optional projection required. */
60
+ export declare function readThreatModelPath(directory: string, options?: HelperOptions): Promise<string | null>;
61
+ export declare function runArtifactExport(arguments_: ArtifactExportArguments, output?: ArtifactOutput): Promise<string | undefined>;
62
+ export declare function resolveArtifactExportOutput(arguments_: ArtifactExportArguments, currentDirectory: string): Promise<ArtifactExportArguments>;
63
+ /** Resolve saved artifacts after the workbench validates their recorded identity. */
64
+ export declare function resolveSavedArtifactDirectory(scanId: string, artifact: ExportArtifactKind, format: ExportFormat, workbench: (args: readonly string[]) => Promise<JsonObject>): Promise<string>;
65
+ /** Export saved artifacts without authenticating or starting Codex. */
66
+ export declare function exportArtifact(options: ExportArtifactOptions): Promise<ArtifactExportResult>;
67
+ export declare function writeArtifactOutput(output: ArtifactOutput, value: string | Uint8Array | AsyncIterable<Uint8Array>): Promise<void>;
68
+ export declare function exportEnvironment(environment?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
69
+ export {};
70
+ //# sourceMappingURL=artifact-export.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"artifact-export.d.ts","sourceRoot":"","sources":["../src/artifact-export.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,292 @@
1
+ import { workbenchArgs } from "./workbench-arguments.js";
2
+ import { spawn } from "node:child_process";
3
+ import { lstat, realpath } from "node:fs/promises";
4
+ import { basename, dirname, join, relative, resolve } from "node:path";
5
+ import { Writable as NodeWritable } from "node:stream";
6
+ import { pipeline } from "node:stream/promises";
7
+ import { CodexSecurityError } from "./errors.js";
8
+ import { relativePathIsOutside as isOutsidePath } from "./targets.js";
9
+ import { bundledPluginRoot, codexSecurityStateDirectory, expandHome, pythonUtf8Environment, resolvePluginPython, runWorkbench, } from "./runtime.js";
10
+ export const ARTIFACT_EXPORT_FILENAMES = {
11
+ csv: "findings.csv",
12
+ json: "findings.json",
13
+ sarif: "results.sarif",
14
+ md: "threatmodel.md",
15
+ };
16
+ export function resolveArtifactFormat(artifact, format) {
17
+ const selected = format ?? (artifact === "threat-model" ? "md" : "sarif");
18
+ if ((artifact === "threat-model") !== (selected === "md")) {
19
+ throw new CodexSecurityError(artifact === "threat-model"
20
+ ? "Threat-model exports only support --export-format md."
21
+ : "Findings exports support --export-format csv, json, or sarif.");
22
+ }
23
+ return selected;
24
+ }
25
+ export async function runArtifactHelper(args, options = {}) {
26
+ const environment = exportEnvironment();
27
+ const python = await resolvePluginPython({
28
+ configuredPath: options.pythonPath,
29
+ environment,
30
+ protectedRoot: options.protectedRoot,
31
+ signal: options.signal,
32
+ });
33
+ const plugin = options.pluginRoot ?? (await bundledPluginRoot());
34
+ const invocation = spawn(python, [
35
+ "-I",
36
+ "-X",
37
+ "utf8",
38
+ "-B",
39
+ join(plugin, "scripts", "finalize_scan_contract.py"),
40
+ ...args,
41
+ ], {
42
+ env: environment,
43
+ stdio: ["ignore", "pipe", "pipe"],
44
+ windowsHide: true,
45
+ signal: options.signal,
46
+ });
47
+ let stderr = "";
48
+ let stdout = "";
49
+ invocation.stderr.setEncoding("utf8");
50
+ invocation.stderr.on("data", (chunk) => {
51
+ stderr = `${stderr}${chunk}`.slice(-64 * 1024);
52
+ });
53
+ const forwarded = options.output === undefined
54
+ ? (async () => {
55
+ invocation.stdout.setEncoding("utf8");
56
+ for await (const chunk of invocation.stdout)
57
+ stdout += chunk;
58
+ })()
59
+ : writeArtifactOutput(options.output, invocation.stdout);
60
+ let status;
61
+ try {
62
+ [status] = await Promise.all([
63
+ new Promise((resolve, reject) => {
64
+ invocation.once("error", reject);
65
+ invocation.once("close", (code, signal) => resolve(signal === null ? (code ?? 1) : 1));
66
+ }),
67
+ forwarded,
68
+ ]);
69
+ }
70
+ catch (error) {
71
+ invocation.stdout.destroy();
72
+ invocation.kill();
73
+ throw error;
74
+ }
75
+ if (status !== 0) {
76
+ const detail = stderr.trim().split("\n").at(-1);
77
+ throw new CodexSecurityError(detail?.replace(/^finalize_scan_contract\.py: error: /, "") ||
78
+ options.failureMessage ||
79
+ "Could not export Codex Security artifacts.");
80
+ }
81
+ return { stdout, stderr };
82
+ }
83
+ export async function writeThreatModel(directory, options = {}) {
84
+ const result = await runArtifactHelper(["--scan-dir", directory, "--write-threat-model"], options);
85
+ return result.stderr.trim().replace(/^codex-security: warning: /u, "");
86
+ }
87
+ /** Read the current document path without making an optional projection required. */
88
+ export async function readThreatModelPath(directory, options = {}) {
89
+ try {
90
+ options.signal?.throwIfAborted();
91
+ const result = await runArtifactHelper(["--scan-dir", directory, "--describe-threat-model"], options);
92
+ return JSON.parse(result.stdout).path;
93
+ }
94
+ catch {
95
+ options.signal?.throwIfAborted();
96
+ return null;
97
+ }
98
+ }
99
+ export async function runArtifactExport(arguments_, output) {
100
+ const artifact = arguments_.artifact ?? "findings";
101
+ resolveArtifactFormat(artifact, arguments_.format);
102
+ const result = await runArtifactHelper([
103
+ "--scan-dir",
104
+ arguments_.scanDir,
105
+ ...(artifact === "findings" ? [] : ["--export-artifact", artifact]),
106
+ "--export-format",
107
+ arguments_.format,
108
+ ...(arguments_.output === "-"
109
+ ? []
110
+ : ["--export-output", arguments_.output]),
111
+ ...(arguments_.sourceRoot === undefined
112
+ ? []
113
+ : ["--source-root", arguments_.sourceRoot]),
114
+ ...(arguments_.includeMetadata ? ["--export-metadata"] : []),
115
+ ], {
116
+ pythonPath: arguments_.pythonPath,
117
+ signal: arguments_.signal,
118
+ failureMessage: artifact === "findings"
119
+ ? `Could not export Codex Security findings as ${arguments_.format.toUpperCase()}.`
120
+ : "Could not export the saved threat model as Markdown.",
121
+ ...(arguments_.output === "-" && output !== undefined ? { output } : {}),
122
+ });
123
+ return (arguments_.output === "-" && output === undefined) ||
124
+ arguments_.includeMetadata
125
+ ? result.stdout
126
+ : undefined;
127
+ }
128
+ export async function resolveArtifactExportOutput(arguments_, currentDirectory) {
129
+ const canonicalScan = await realpath(arguments_.scanDir).catch(() => arguments_.scanDir);
130
+ const scanRelativeOutput = relative(arguments_.scanDir, arguments_.output);
131
+ const scanLocalOutput = join("exports", ARTIFACT_EXPORT_FILENAMES[arguments_.format]);
132
+ if (arguments_.output !== "-" &&
133
+ !isOutsidePath(scanRelativeOutput) &&
134
+ scanRelativeOutput !== scanLocalOutput) {
135
+ throw new CodexSecurityError("The export output path cannot overwrite a scan artifact.");
136
+ }
137
+ const outputPath = arguments_.output === "-"
138
+ ? "-"
139
+ : !isOutsidePath(scanRelativeOutput)
140
+ ? join(canonicalScan, scanRelativeOutput)
141
+ : join(await realpath(dirname(arguments_.output)).catch((error) => {
142
+ if (error.code === "ENOENT")
143
+ throw new CodexSecurityError(`Export output directory does not exist: ${dirname(arguments_.output)}. Create the directory and retry.`);
144
+ throw error;
145
+ }), basename(arguments_.output));
146
+ if (arguments_.output !== "-") {
147
+ const outputFromCurrent = relative(currentDirectory, arguments_.output);
148
+ if (outputFromCurrent !== "" && !isOutsidePath(outputFromCurrent)) {
149
+ let existingParent;
150
+ for (let directory = dirname(arguments_.output); relative(currentDirectory, directory) !== ""; directory = dirname(directory)) {
151
+ const metadata = await lstat(directory).catch((error) => {
152
+ if (error.code === "ENOENT")
153
+ return undefined;
154
+ throw error;
155
+ });
156
+ if (metadata?.isSymbolicLink()) {
157
+ throw new CodexSecurityError("The export output path cannot traverse a repository symlink.");
158
+ }
159
+ if (metadata !== undefined)
160
+ existingParent ??= directory;
161
+ }
162
+ const canonicalCurrent = await realpath(currentDirectory).catch(() => currentDirectory);
163
+ const expectedOutput = existingParent === undefined
164
+ ? resolve(canonicalCurrent, outputFromCurrent)
165
+ : resolve(await realpath(existingParent), relative(existingParent, arguments_.output));
166
+ if (isOutsidePath(relative(canonicalCurrent, outputPath)) ||
167
+ relative(expectedOutput, outputPath) !== "") {
168
+ throw new CodexSecurityError("The export output path cannot traverse a repository symlink.");
169
+ }
170
+ }
171
+ }
172
+ return { ...arguments_, scanDir: canonicalScan, output: outputPath };
173
+ }
174
+ /** Resolve saved artifacts after the workbench validates their recorded identity. */
175
+ export async function resolveSavedArtifactDirectory(scanId, artifact, format, workbench) {
176
+ // Reuse the workbench's recorded digest and scan binding checks without
177
+ // requiring a writable saved-scan directory for stdout or external exports.
178
+ const context = await workbench(workbenchArgs("export-findings", {
179
+ scanId,
180
+ artifact,
181
+ format,
182
+ validateOnly: true,
183
+ }));
184
+ const scan = context["scan"];
185
+ if (typeof scan?.["scanDir"] !== "string")
186
+ throw new CodexSecurityError(`Artifacts for scan ${scanId} are unavailable.`);
187
+ return resolve(expandHome(scan["scanDir"]));
188
+ }
189
+ /** Export saved artifacts without authenticating or starting Codex. */
190
+ export async function exportArtifact(options) {
191
+ const artifact = options.artifact ?? "findings";
192
+ const format = resolveArtifactFormat(artifact, options.format);
193
+ const environment = {
194
+ ...exportEnvironment(),
195
+ CODEX_SECURITY_STATE_DIR: codexSecurityStateDirectory(),
196
+ };
197
+ let directory;
198
+ if (options.source.directory !== undefined) {
199
+ directory = resolve(expandHome(options.source.directory));
200
+ }
201
+ else {
202
+ const python = await resolvePluginPython({
203
+ configuredPath: options.pythonPath,
204
+ environment,
205
+ signal: options.signal,
206
+ });
207
+ const pluginRoot = await bundledPluginRoot();
208
+ directory = await resolveSavedArtifactDirectory(options.source.scanId, artifact, format, (args) => runWorkbench({
209
+ python,
210
+ pluginRoot,
211
+ environment,
212
+ signal: options.signal,
213
+ failureMessage: "Could not export Codex Security scan artifacts",
214
+ }, args));
215
+ }
216
+ const arguments_ = await resolveArtifactExportOutput({
217
+ scanDir: directory,
218
+ artifact,
219
+ format,
220
+ output: options.output === "-" ? "-" : resolve(expandHome(options.output)),
221
+ pythonPath: options.pythonPath,
222
+ signal: options.signal,
223
+ includeMetadata: artifact === "threat-model" && options.output !== "-",
224
+ ...(options.sourceRoot === undefined
225
+ ? {}
226
+ : { sourceRoot: resolve(expandHome(options.sourceRoot)) }),
227
+ }, process.cwd());
228
+ const metadata = await runArtifactExport(arguments_, options.output === "-" ? process.stdout : undefined);
229
+ const description = metadata === undefined
230
+ ? null
231
+ : JSON.parse(metadata);
232
+ return {
233
+ path: arguments_.output === "-" ? null : arguments_.output,
234
+ provenance: description?.provenance ?? null,
235
+ };
236
+ }
237
+ export async function writeArtifactOutput(output, value) {
238
+ const destination = new NodeWritable({
239
+ write(chunk, _encoding, callback) {
240
+ try {
241
+ if (output instanceof NodeWritable) {
242
+ output.write(chunk, callback);
243
+ }
244
+ else if (output.write(chunk)) {
245
+ callback();
246
+ }
247
+ else {
248
+ callback(new CodexSecurityError("The export stdout stream cannot report backpressure safely."));
249
+ }
250
+ }
251
+ catch (error) {
252
+ callback(error instanceof Error ? error : new Error(String(error)));
253
+ }
254
+ },
255
+ });
256
+ const forwardError = (error) => {
257
+ destination.destroy(error);
258
+ };
259
+ if (output instanceof NodeWritable)
260
+ output.once("error", forwardError);
261
+ try {
262
+ await pipeline(typeof value === "string" || value instanceof Uint8Array
263
+ ? [value]
264
+ : value, destination);
265
+ }
266
+ finally {
267
+ if (output instanceof NodeWritable) {
268
+ output.removeListener("error", forwardError);
269
+ }
270
+ }
271
+ }
272
+ export function exportEnvironment(environment = process.env) {
273
+ return pythonUtf8Environment(Object.fromEntries([
274
+ "PATH",
275
+ "Path",
276
+ "PATHEXT",
277
+ "SystemRoot",
278
+ "SYSTEMROOT",
279
+ "WINDIR",
280
+ "TMP",
281
+ "TEMP",
282
+ "TMPDIR",
283
+ "PYTHON",
284
+ "XDG_CACHE_HOME",
285
+ "LANG",
286
+ "LC_ALL",
287
+ "LC_CTYPE",
288
+ ]
289
+ .filter((key) => environment[key] !== undefined)
290
+ .map((key) => [key, environment[key]])));
291
+ }
292
+ //# sourceMappingURL=artifact-export.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"artifact-export.js","sourceRoot":"","sources":["../src/artifact-export.ts"],"names":[],"mappings":"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","sourcesContent":["import { workbenchArgs } from \"./workbench-arguments.js\";\nimport { spawn } from \"node:child_process\";\nimport { lstat, realpath } from \"node:fs/promises\";\nimport { basename, dirname, join, relative, resolve } from \"node:path\";\nimport { Writable as NodeWritable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport type { JsonObject } from \"./config.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { relativePathIsOutside as isOutsidePath } from \"./targets.js\";\nimport {\n bundledPluginRoot,\n codexSecurityStateDirectory,\n expandHome,\n pythonUtf8Environment,\n resolvePluginPython,\n runWorkbench,\n} from \"./runtime.js\";\n\nexport type ArtifactOutput = Pick<NodeJS.WriteStream, \"write\">;\n\nexport const ARTIFACT_EXPORT_FILENAMES = {\n csv: \"findings.csv\",\n json: \"findings.json\",\n sarif: \"results.sarif\",\n md: \"threatmodel.md\",\n} as const;\nexport type ExportFormat = keyof typeof ARTIFACT_EXPORT_FILENAMES;\nexport type ExportArtifactKind = \"findings\" | \"threat-model\";\n\nexport interface ArtifactExportArguments {\n scanDir: string;\n artifact?: ExportArtifactKind;\n format: ExportFormat;\n output: string;\n sourceRoot?: string;\n pythonPath?: string;\n signal?: AbortSignal;\n includeMetadata?: boolean;\n}\n\nexport type ExportArtifactOptions = {\n source:\n | { directory: string; scanId?: never }\n | { scanId: string; directory?: never };\n output: string;\n pythonPath?: string;\n signal?: AbortSignal;\n} & (\n | { artifact: \"threat-model\"; format?: \"md\"; sourceRoot?: never }\n | {\n artifact?: \"findings\";\n format?: \"csv\" | \"json\" | \"sarif\";\n sourceRoot?: string;\n }\n);\n\nexport interface ArtifactExportResult {\n path: string | null;\n provenance: JsonObject | null;\n}\n\ninterface HelperOptions {\n pythonPath?: string;\n protectedRoot?: string;\n pluginRoot?: string;\n signal?: AbortSignal;\n output?: ArtifactOutput;\n failureMessage?: string;\n}\n\nexport function resolveArtifactFormat(\n artifact: ExportArtifactKind,\n format?: ExportFormat,\n): ExportFormat {\n const selected = format ?? (artifact === \"threat-model\" ? \"md\" : \"sarif\");\n if ((artifact === \"threat-model\") !== (selected === \"md\")) {\n throw new CodexSecurityError(\n artifact === \"threat-model\"\n ? \"Threat-model exports only support --export-format md.\"\n : \"Findings exports support --export-format csv, json, or sarif.\",\n );\n }\n return selected;\n}\n\nexport async function runArtifactHelper(\n args: readonly string[],\n options: HelperOptions = {},\n): Promise<{ stdout: string; stderr: string }> {\n const environment = exportEnvironment();\n const python = await resolvePluginPython({\n configuredPath: options.pythonPath,\n environment,\n protectedRoot: options.protectedRoot,\n signal: options.signal,\n });\n const plugin = options.pluginRoot ?? (await bundledPluginRoot());\n const invocation = spawn(\n python,\n [\n \"-I\",\n \"-X\",\n \"utf8\",\n \"-B\",\n join(plugin, \"scripts\", \"finalize_scan_contract.py\"),\n ...args,\n ],\n {\n env: environment,\n stdio: [\"ignore\", \"pipe\", \"pipe\"],\n windowsHide: true,\n signal: options.signal,\n },\n );\n let stderr = \"\";\n let stdout = \"\";\n invocation.stderr.setEncoding(\"utf8\");\n invocation.stderr.on(\"data\", (chunk: string) => {\n stderr = `${stderr}${chunk}`.slice(-64 * 1024);\n });\n const forwarded =\n options.output === undefined\n ? (async () => {\n invocation.stdout.setEncoding(\"utf8\");\n for await (const chunk of invocation.stdout) stdout += chunk;\n })()\n : writeArtifactOutput(options.output, invocation.stdout);\n let status: number;\n try {\n [status] = await Promise.all([\n new Promise<number>((resolve, reject) => {\n invocation.once(\"error\", reject);\n invocation.once(\"close\", (code, signal) =>\n resolve(signal === null ? (code ?? 1) : 1),\n );\n }),\n forwarded,\n ]);\n } catch (error) {\n invocation.stdout.destroy();\n invocation.kill();\n throw error;\n }\n if (status !== 0) {\n const detail = stderr.trim().split(\"\\n\").at(-1);\n throw new CodexSecurityError(\n detail?.replace(/^finalize_scan_contract\\.py: error: /, \"\") ||\n options.failureMessage ||\n \"Could not export Codex Security artifacts.\",\n );\n }\n return { stdout, stderr };\n}\n\nexport async function writeThreatModel(\n directory: string,\n options: HelperOptions = {},\n): Promise<string> {\n const result = await runArtifactHelper(\n [\"--scan-dir\", directory, \"--write-threat-model\"],\n options,\n );\n return result.stderr.trim().replace(/^codex-security: warning: /u, \"\");\n}\n\n/** Read the current document path without making an optional projection required. */\nexport async function readThreatModelPath(\n directory: string,\n options: HelperOptions = {},\n): Promise<string | null> {\n try {\n options.signal?.throwIfAborted();\n const result = await runArtifactHelper(\n [\"--scan-dir\", directory, \"--describe-threat-model\"],\n options,\n );\n return (JSON.parse(result.stdout) as ArtifactExportResult).path;\n } catch {\n options.signal?.throwIfAborted();\n return null;\n }\n}\n\nexport async function runArtifactExport(\n arguments_: ArtifactExportArguments,\n output?: ArtifactOutput,\n): Promise<string | undefined> {\n const artifact = arguments_.artifact ?? \"findings\";\n resolveArtifactFormat(artifact, arguments_.format);\n const result = await runArtifactHelper(\n [\n \"--scan-dir\",\n arguments_.scanDir,\n ...(artifact === \"findings\" ? [] : [\"--export-artifact\", artifact]),\n \"--export-format\",\n arguments_.format,\n ...(arguments_.output === \"-\"\n ? []\n : [\"--export-output\", arguments_.output]),\n ...(arguments_.sourceRoot === undefined\n ? []\n : [\"--source-root\", arguments_.sourceRoot]),\n ...(arguments_.includeMetadata ? [\"--export-metadata\"] : []),\n ],\n {\n pythonPath: arguments_.pythonPath,\n signal: arguments_.signal,\n failureMessage:\n artifact === \"findings\"\n ? `Could not export Codex Security findings as ${arguments_.format.toUpperCase()}.`\n : \"Could not export the saved threat model as Markdown.\",\n ...(arguments_.output === \"-\" && output !== undefined ? { output } : {}),\n },\n );\n return (arguments_.output === \"-\" && output === undefined) ||\n arguments_.includeMetadata\n ? result.stdout\n : undefined;\n}\n\nexport async function resolveArtifactExportOutput(\n arguments_: ArtifactExportArguments,\n currentDirectory: string,\n): Promise<ArtifactExportArguments> {\n const canonicalScan = await realpath(arguments_.scanDir).catch(\n () => arguments_.scanDir,\n );\n const scanRelativeOutput = relative(arguments_.scanDir, arguments_.output);\n const scanLocalOutput = join(\n \"exports\",\n ARTIFACT_EXPORT_FILENAMES[arguments_.format],\n );\n if (\n arguments_.output !== \"-\" &&\n !isOutsidePath(scanRelativeOutput) &&\n scanRelativeOutput !== scanLocalOutput\n ) {\n throw new CodexSecurityError(\n \"The export output path cannot overwrite a scan artifact.\",\n );\n }\n const outputPath =\n arguments_.output === \"-\"\n ? \"-\"\n : !isOutsidePath(scanRelativeOutput)\n ? join(canonicalScan, scanRelativeOutput)\n : join(\n await realpath(dirname(arguments_.output)).catch(\n (error: NodeJS.ErrnoException) => {\n if (error.code === \"ENOENT\")\n throw new CodexSecurityError(\n `Export output directory does not exist: ${dirname(arguments_.output)}. Create the directory and retry.`,\n );\n throw error;\n },\n ),\n basename(arguments_.output),\n );\n if (arguments_.output !== \"-\") {\n const outputFromCurrent = relative(currentDirectory, arguments_.output);\n if (outputFromCurrent !== \"\" && !isOutsidePath(outputFromCurrent)) {\n let existingParent: string | undefined;\n for (\n let directory = dirname(arguments_.output);\n relative(currentDirectory, directory) !== \"\";\n directory = dirname(directory)\n ) {\n const metadata = await lstat(directory).catch(\n (error: NodeJS.ErrnoException) => {\n if (error.code === \"ENOENT\") return undefined;\n throw error;\n },\n );\n if (metadata?.isSymbolicLink()) {\n throw new CodexSecurityError(\n \"The export output path cannot traverse a repository symlink.\",\n );\n }\n if (metadata !== undefined) existingParent ??= directory;\n }\n const canonicalCurrent = await realpath(currentDirectory).catch(\n () => currentDirectory,\n );\n const expectedOutput =\n existingParent === undefined\n ? resolve(canonicalCurrent, outputFromCurrent)\n : resolve(\n await realpath(existingParent),\n relative(existingParent, arguments_.output),\n );\n if (\n isOutsidePath(relative(canonicalCurrent, outputPath)) ||\n relative(expectedOutput, outputPath) !== \"\"\n ) {\n throw new CodexSecurityError(\n \"The export output path cannot traverse a repository symlink.\",\n );\n }\n }\n }\n return { ...arguments_, scanDir: canonicalScan, output: outputPath };\n}\n\n/** Resolve saved artifacts after the workbench validates their recorded identity. */\nexport async function resolveSavedArtifactDirectory(\n scanId: string,\n artifact: ExportArtifactKind,\n format: ExportFormat,\n workbench: (args: readonly string[]) => Promise<JsonObject>,\n): Promise<string> {\n // Reuse the workbench's recorded digest and scan binding checks without\n // requiring a writable saved-scan directory for stdout or external exports.\n const context = await workbench(\n workbenchArgs(\"export-findings\", {\n scanId,\n artifact,\n format,\n validateOnly: true,\n }),\n );\n const scan = context[\"scan\"] as JsonObject | undefined;\n if (typeof scan?.[\"scanDir\"] !== \"string\")\n throw new CodexSecurityError(\n `Artifacts for scan ${scanId} are unavailable.`,\n );\n return resolve(expandHome(scan[\"scanDir\"]));\n}\n\n/** Export saved artifacts without authenticating or starting Codex. */\nexport async function exportArtifact(\n options: ExportArtifactOptions,\n): Promise<ArtifactExportResult> {\n const artifact = options.artifact ?? \"findings\";\n const format = resolveArtifactFormat(artifact, options.format);\n const environment = {\n ...exportEnvironment(),\n CODEX_SECURITY_STATE_DIR: codexSecurityStateDirectory(),\n };\n let directory: string;\n if (options.source.directory !== undefined) {\n directory = resolve(expandHome(options.source.directory));\n } else {\n const python = await resolvePluginPython({\n configuredPath: options.pythonPath,\n environment,\n signal: options.signal,\n });\n const pluginRoot = await bundledPluginRoot();\n directory = await resolveSavedArtifactDirectory(\n options.source.scanId,\n artifact,\n format,\n (args) =>\n runWorkbench(\n {\n python,\n pluginRoot,\n environment,\n signal: options.signal,\n failureMessage: \"Could not export Codex Security scan artifacts\",\n },\n args,\n ),\n );\n }\n const arguments_ = await resolveArtifactExportOutput(\n {\n scanDir: directory,\n artifact,\n format,\n output:\n options.output === \"-\" ? \"-\" : resolve(expandHome(options.output)),\n pythonPath: options.pythonPath,\n signal: options.signal,\n includeMetadata: artifact === \"threat-model\" && options.output !== \"-\",\n ...(options.sourceRoot === undefined\n ? {}\n : { sourceRoot: resolve(expandHome(options.sourceRoot)) }),\n },\n process.cwd(),\n );\n const metadata = await runArtifactExport(\n arguments_,\n options.output === \"-\" ? process.stdout : undefined,\n );\n const description =\n metadata === undefined\n ? null\n : (JSON.parse(metadata) as ArtifactExportResult);\n return {\n path: arguments_.output === \"-\" ? null : arguments_.output,\n provenance: description?.provenance ?? null,\n };\n}\n\nexport async function writeArtifactOutput(\n output: ArtifactOutput,\n value: string | Uint8Array | AsyncIterable<Uint8Array>,\n): Promise<void> {\n const destination = new NodeWritable({\n write(chunk, _encoding, callback) {\n try {\n if (output instanceof NodeWritable) {\n output.write(chunk, callback);\n } else if (output.write(chunk)) {\n callback();\n } else {\n callback(\n new CodexSecurityError(\n \"The export stdout stream cannot report backpressure safely.\",\n ),\n );\n }\n } catch (error) {\n callback(error instanceof Error ? error : new Error(String(error)));\n }\n },\n });\n const forwardError = (error: Error): void => {\n destination.destroy(error);\n };\n if (output instanceof NodeWritable) output.once(\"error\", forwardError);\n try {\n await pipeline(\n typeof value === \"string\" || value instanceof Uint8Array\n ? [value]\n : value,\n destination,\n );\n } finally {\n if (output instanceof NodeWritable) {\n output.removeListener(\"error\", forwardError);\n }\n }\n}\n\nexport function exportEnvironment(\n environment: NodeJS.ProcessEnv = process.env,\n): NodeJS.ProcessEnv {\n return pythonUtf8Environment(\n Object.fromEntries(\n [\n \"PATH\",\n \"Path\",\n \"PATHEXT\",\n \"SystemRoot\",\n \"SYSTEMROOT\",\n \"WINDIR\",\n \"TMP\",\n \"TEMP\",\n \"TMPDIR\",\n \"PYTHON\",\n \"XDG_CACHE_HOME\",\n \"LANG\",\n \"LC_ALL\",\n \"LC_CTYPE\",\n ]\n .filter((key) => environment[key] !== undefined)\n .map((key) => [key, environment[key]]),\n ),\n );\n}\n"]}
package/dist/auth.d.ts CHANGED
@@ -1,9 +1,5 @@
1
- import { type CodexCommand, type ProcessEnvironment } from "./runtime.js";
2
- export interface LoginResult {
3
- success: boolean;
4
- exitCode: number | null;
5
- stdout: string;
6
- stderr: string;
1
+ import { runCodexCommand, type CodexCommand, type ProcessEnvironment } from "./runtime.js";
2
+ export interface LoginResult extends Awaited<ReturnType<typeof runCodexCommand>> {
7
3
  }
8
4
  export interface AccountStatus {
9
5
  authenticated: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAiDtB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAgB;;IAkB3B,YACE,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,WAAW,EAAE,kBAAkB,EAC/B,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EA+CtC;IAED,IAAW,OAAO,IAAI,IAAI,CAEzB;IAED,IAAW,OAAO,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,IAAW,eAAe,IAAI,MAAM,GAAG,IAAI,CAE1C;IAED,IAAW,QAAQ,IAAI,MAAM,GAAG,IAAI,CAEnC;IAEY,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAExC;IAEY,mBAAmB,CAC9B,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC,CAGf;IAEM,MAAM,IAAI,IAAI,CAcpB;CA2CF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED,wBAAsB,MAAM,CAC1B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAaf"}
1
+ {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AA8DtB,MAAM,WAAW,WAAY,SAAQ,OAAO,CAC1C,UAAU,CAAC,OAAO,eAAe,CAAC,CACnC;CAAG;AAEJ,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAgB;;IAkB3B,YACE,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,WAAW,EAAE,kBAAkB,EAC/B,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAqDtC;IAED,IAAW,OAAO,IAAI,IAAI,CAEzB;IAED,IAAW,OAAO,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,IAAW,eAAe,IAAI,MAAM,GAAG,IAAI,CAE1C;IAED,IAAW,QAAQ,IAAI,MAAM,GAAG,IAAI,CAEnC;IAEY,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAExC;IAEY,mBAAmB,CAC9B,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC,CAGf;IAEM,MAAM,IAAI,IAAI,CAoBpB;CA2CF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED,wBAAsB,MAAM,CAC1B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAaf"}
package/dist/auth.js CHANGED
@@ -4,7 +4,7 @@ import { readFile } from "node:fs/promises";
4
4
  import { homedir } from "node:os";
5
5
  import { join, resolve } from "node:path";
6
6
  import { parse } from "smol-toml";
7
- import { CodexSecurityError, PluginBootstrapError } from "./errors.js";
7
+ import { CodexSecurityError, PluginBootstrapError, errorMessage, } from "./errors.js";
8
8
  import { executablePathForSpawn, expandHome, runCodexCommand, } from "./runtime.js";
9
9
  const LOGIN_CHILD_TERMINATION_GRACE_MS = 1_000;
10
10
  /** @internal */
@@ -16,9 +16,13 @@ export function environmentEntry(environment, requested) {
16
16
  return Object.entries(environment).find(([name]) => name.toUpperCase() === upper)?.[1];
17
17
  }
18
18
  /** @internal */
19
+ export function withoutOpenAiApiKeys(environment) {
20
+ return Object.fromEntries(Object.entries(environment).filter(([name]) => !["OPENAI_API_KEY", "CODEX_API_KEY"].includes(name.toUpperCase())));
21
+ }
22
+ /** @internal */
19
23
  export function configuredCodexHome(environment) {
20
- return resolve(expandHome(environmentEntry(environment, "CODEX_HOME")?.trim() ||
21
- join(homedir(), ".codex"), environment));
24
+ const configured = environmentEntry(environment, "CODEX_HOME");
25
+ return resolve(expandHome(configured?.trim() ? configured : join(homedir(), ".codex"), environment));
22
26
  }
23
27
  /** @internal */
24
28
  export async function readCodexHomeConfig(environment, signal) {
@@ -32,7 +36,7 @@ export async function readCodexHomeConfig(environment, signal) {
32
36
  signal?.throwIfAborted();
33
37
  if (error.code === "ENOENT")
34
38
  return {};
35
- throw new CodexSecurityError("Could not read the configured Codex provider.");
39
+ throw new CodexSecurityError(`Could not read the configured Codex provider: ${errorMessage(error)}`, { cause: error });
36
40
  }
37
41
  }
38
42
  export class CodexLoginHandle {
@@ -55,7 +59,7 @@ export class CodexLoginHandle {
55
59
  constructor(command, args, environment, onSuccess) {
56
60
  void this.#urlReady.promise.catch(() => undefined);
57
61
  void this.#deviceReady.promise.catch(() => undefined);
58
- this.#child = spawn(executablePathForSpawn(command.command), [...args], {
62
+ this.#child = spawn(executablePathForSpawn(command.command), [...(command.args ?? []), ...args], {
59
63
  env: environment,
60
64
  stdio: ["pipe", "pipe", "pipe"],
61
65
  windowsHide: true,
@@ -82,7 +86,9 @@ export class CodexLoginHandle {
82
86
  };
83
87
  this.#settleInstructionWaiters(result);
84
88
  if (result.success) {
85
- Promise.resolve(onSuccess()).then(() => resolve(result), reject);
89
+ Promise.resolve()
90
+ .then(onSuccess)
91
+ .then(() => resolve(result), reject);
86
92
  }
87
93
  else {
88
94
  resolve(result);
@@ -121,8 +127,14 @@ export class CodexLoginHandle {
121
127
  }
122
128
  cancel() {
123
129
  this.#canceled = true;
124
- if (this.#child.exitCode !== null || this.#child.signalCode !== null)
130
+ if (this.#child.exitCode !== null || this.#child.signalCode !== null) {
131
+ // Descendants can retain inherited pipes after the login process exits.
132
+ // Cancellation must release those pipes so the close event can settle.
133
+ this.#child.stdin.destroy();
134
+ this.#child.stdout.destroy();
135
+ this.#child.stderr.destroy();
125
136
  return;
137
+ }
126
138
  this.#child.kill("SIGTERM");
127
139
  if (this.#forcedTermination !== undefined)
128
140
  return;
@@ -201,15 +213,18 @@ export const CODEX_AUTH_CONFIG_KEYS = [
201
213
  "forced_chatgpt_workspace_id",
202
214
  ];
203
215
  /** @internal Shared login recovery guidance for model commands. */
204
- export const NO_CREDENTIALS_MESSAGE = "No credentials were found. Run 'codex-security login', use " +
205
- "'codex-security login --device-auth' on a remote or headless machine, or set " +
206
- "OPENAI_API_KEY or CODEX_API_KEY for CI.";
216
+ export const NO_CREDENTIALS_MESSAGE = "No credentials were found. Run 'codex-security login'. On a remote or headless " +
217
+ "machine, use 'codex-security login --device-auth' if your workspace allows it. " +
218
+ "If device auth is disabled, see 'codex-security login --help' for browser login over SSH. " +
219
+ "For CI, set OPENAI_API_KEY or CODEX_API_KEY.";
207
220
  function preferredAuthUrl(value) {
208
221
  for (const match of plainTerminalText(value).matchAll(/https?:\/\/[^\s<>"']+/g)) {
209
222
  const url = match[0].replace(/[.,;:!?)\]}]+$/, "");
210
223
  try {
211
- const hostname = new URL(url).hostname.toLowerCase().replace(/\.$/, "");
212
- if (hostname !== "localhost" &&
224
+ const parsed = new URL(url);
225
+ const hostname = parsed.hostname.toLowerCase().replace(/\.$/, "");
226
+ if (parsed.protocol === "https:" &&
227
+ hostname !== "localhost" &&
213
228
  !hostname.endsWith(".localhost") &&
214
229
  !(isIP(hostname) === 4 && hostname.startsWith("127.")) &&
215
230
  hostname !== "0.0.0.0" &&